🤖 Coorchat
已弃用：CoorChat已经发展成为 沉思 --一个用C#构建的分布式人工智能代理平台。NET 10，支持A2A协议、跨机器异构集群和多AI提供者抽象。此存储库已存档。所有新的开发都发生在Brood仓库中。
______________________________________________________________________
人工智能软件开发的多智能体协调系统
  ](https://nodejs.org/) 
*使专门的人工智能代理团队能够通过安全、实时的通信渠道协调共享的软件开发任务。*
______________________________________________________________________
🌟 什么是CoorChat？
CoorChat是一个 多智能体协调平台 这允许专门的人工智能代理（开发人员、测试人员、架构师、安全审计员等）像人类团队一样在软件开发任务上进行协作。
问题
独立工作的AI代理无法协调复杂的工作流程：
- ❌ 多个代理之间没有共享上下文
- ❌ 重复的工作或冲突的更改
- ❌ 无法了解其他代理正在做什么
- ❌ 手动任务分配和依赖关系管理
解决方案
CoorChat提供 安全协调层 有可能：
- ✅ 实时通信 专业代理之间
- ✅ 自动任务分配 基于代理能力
- ✅ 依赖追踪 冲突解决
- ✅ GitHub集成 用于无缝发布/PR同步
- ✅ 人为监督 通过监控和审计跟踪
______________________________________________________________________
✨ 主要特点
🔄 多智能体协调
具有不同专业（开发人员、测试人员、架构师、安全、基础设施、文档）的代理通过自动角色匹配和基于能力的分配在共享任务上协同工作。
🔐 安全通信
- 基于令牌的身份验证，具有定时安全比较功能
- HMAC消息签名用于完整性验证
- 对所有通道实施TLS/HTTPS
- 加密安全令牌生成
📡 多种通道类型
选择适合您基础设施的通信渠道：
- 瑞迪斯 -快速、可靠的发布/订阅（建议自托管）
- Discord 的中文翻译是“不和谐”或“纷争”。 -零设置，非常适合测试和小型团队
- 信号员 -企业级。NET分布式团队中继服务器
🔗 GitHub 集成
- 自动同步问题和拉取请求
- Webhook+轮询回退以提高可靠性
- 从GitHub事件创建任务
- 双向更新（代理操作→ GitHub评论）
🎯 智能任务管理
- 依赖追踪 具有循环检测功能
- 冲突解决 当多个代理声明同一任务时
- 优先级排队 （关键→ high → 中等→ low)
- 生命周期事件 （分配→ 开始→ 阻塞→ 进步→ 已完成）
👥 可扩展角色系统
8个预定义角色+自定义角色支持：
developer, tester, architect, frontend, backend,
infrastructure, security-auditor, documentation-writer📊 监测和可观察性
- 实时活动监控
- 结构化日志记录（JSON格式）
- 任务生命周期跟踪
- 代理超时检测
______________________________________________________________________
🏗️ 建筑
┌─────────────────────────────────────────────────────────────────┐
│ GitHub Issues/PRs │
└────────────────┬────────────────────────────────────────────────┘
│
▼
┌───────────────┐
│ GitHub Sync │ (Webhook + Polling)
│ Manager │
└───────┬───────┘
│
▼
┌───────────────┐
│ Task Queue │ ◄──── Priority, Dependencies
└───────┬───────┘
│
┌────────────┼────────────┐
│ │ │
▼ ▼ ▼
┌───────┐ ┌───────┐ ┌───────┐
│ Agent │ │ Agent │ │ Agent │ Developer, Tester, etc.
│ 1 │ │ 2 │ │ 3 │
└───┬───┘ └───┬───┘ └───┬───┘
│ │ │
└───────────┼───────────┘
│
▼
┌───────────────────────┐
│ Communication Layer │
│ (Redis/Discord/ │
│ SignalR) │
└───────────────────────┘组件
MCP服务器 (packages/mcp-server/)
- Types/Node.js协调客户端
- 通过MCP协议与Claude Desktop集成
- 处理代理注册、任务管理、消息传递
中继服务器 (packages/relay-server/)
- CNET ViewModel中心（可选）
- 分布式团队的企业级中继
- 令牌认证中间件
______________________________________________________________________
🚀 快速开始
先决条件
选项1：自动设置⚡ （推荐）
Linux/macOS：
git clone https://github.com/stuartf303/coorchat.git
cd coorchat
chmod +x quick-start.sh
./quick-start.shWindows（PowerShell）：
git clone https://github.com/stuartf303/coorchat.git
cd coorchat
.\quick-start.ps1这将：
- ✅ 安装所有依赖项
- ✅ 生成安全身份验证令牌
- ✅ 设置您选择的通道（Redis/Discord/Async）
- ✅ 运行测试套件（34个测试）
- ✅ 生成Claude桌面配置
选项2：手动安装
# 1. Clone and install
git clone https://github.com/stuartf303/coorchat.git
cd coorchat/packages/mcp-server
npm install
npm run build
# 2. Generate secure token
npm run cli -- token generate
# Output: cct_a3f8d9e2c1b4f7a6e8d2c9b1f4a7e3d2...
# 3. Start Redis (or use Discord/SignalR)
docker run -d --name coorchat-redis -p 6379:6379 redis:7-alpine
# 4. Configure environment
cat > .env # Validate token format
npm run cli -- token hash # SHA-256 hash
# Agent Control
npm run cli -- agent start --role developer
npm run cli -- agent start --id my-agent --role tester
npm run cli -- agent list # List active agents
# Role Management
npm run cli -- role list # Show all available roles
npm run cli -- role suggest testing security # Suggest roles by capability
# Configuration
npm run cli -- config show # Show current config
npm run cli -- config init --channel redis # Initialize config
# Monitoring
npm run cli -- monitor # Watch real-time coordination完整的CLI文档： CLI.md
______________________________________________________________________
📚 文档
入门指南
指南和示例
配置
发展
______________________________________________________________________
🏗️ 项目结构
coorchat/
├── packages/
│ ├── mcp-server/ # TypeScript/Node.js MCP Server
│ │ ├── src/
│ │ │ ├── agents/ # Agent registry, roles, capabilities
│ │ │ ├── channels/ # Discord, SignalR, Redis channels
│ │ │ ├── cli/ # Command-line interface
│ │ │ ├── config/ # Configuration, token generation
│ │ │ ├── github/ # GitHub integration (webhooks, polling)
│ │ │ ├── logging/ # Structured logging
│ │ │ ├── protocol/ # Message protocol, validation
│ │ │ └── tasks/ # Task queue, dependencies, conflicts
│ │ └── tests/
│ │ └── integration/ # Integration test suites
│ │
│ └── relay-server/ # C#/.NET SignalR Relay (optional)
│ └── src/
│ ├── Api/ # SignalR hub, middleware
│ └── Core/ # Authentication service
│
├── specs/ # Feature specifications
│ └── 001-multi-agent-coordination/
│ ├── spec.md # Feature specification
│ ├── plan.md # Implementation plan
│ ├── data-model.md # Entity models
│ ├── contracts/ # API contracts
│ └── tasks.md # Task breakdown
│
├── .github/ # CI/CD workflows
│ └── workflows/
│ ├── mcp-server-ci.yml # TypeScript tests
│ └── relay-server-ci.yml # C# tests
│
├── quick-start.sh # Automated setup (Bash)
├── quick-start.ps1 # Automated setup (PowerShell)
├── docker-compose.yml # Local development stack
├── INSTALL.md # Installation guide
├── SCENARIOS.md # Example workflows
└── README.md # This file______________________________________________________________________
🧪 测试
CoorChat包括全面的集成测试：
cd packages/mcp-server
# Run all tests
npm test
# Run with coverage
npm run test:coverage
# Run integration tests only
npm run test:integration测试套件
代理任务协调 （10次测试）
- 代理注册和发现
- 任务分配与角色匹配
- 依赖跟踪和自动解锁
- 冲突解决
- 生命周期事件处理
- 完成工作流程编排
安全通信 （24次测试）
- 令牌生成（熵、唯一性、格式）
- 令牌验证（格式、长度、字符）
- 令牌哈希（一致性、抗冲突性）
- 通道认证（拒绝、验证、定时安全）
- 消息安全（元数据、完整性、篡改检测）
- 安全最佳实践
- TLS/加密支持
- 边缘案例
当前状态： ✅ 34/34测试通过
______________________________________________________________________
🔒 安全功能
认证
- 基于令牌的身份验证 最少16+个字符
- 定时安全比较 防止定时攻击
- SHA-256令牌散列 用于安全存储
- 令牌前缀 （cct\_，cca\_）用于类型识别
消息安全
- HMAC-SHA256签名 Redis消息完整性
- 相关ID 用于请求/响应跟踪
- 时间戳验证 用于防止重放攻击
运输安全
- TLS强制 对于Redis（Redis://）
- HTTPS验证 用于ViewModel
- 基于环境的政策 （生产vs开发）
最佳实践
- 无明文令牌存储
- 安全随机生成 使用crypto.randomBytes（）
- 自动安全警告 对于不安全的配置
______________________________________________________________________
🎨 用例
软件开发团队
- 协调多个AI代理进行功能开发
- 自动化代码审查流程
- Bug分类和修复协调
- 文档生成
DevOps和基础设施
- 多阶段部署编排
- 基础设施即代码协调
- 自动化安全审计
- 合规检查
质量保证
- 自动生成测试
- 回归测试协调
- 覆盖率分析
- 性能测试
研究与实验
- 多智能体人工智能研究
- 协调算法测试
- 自定义工作流原型
- 代理能力实验
______________________________________________________________________
🗺️ 路线图
当前版本：MVP（v1.0）
- ✅ 多智能体协调
- ✅ 3种通道类型（Redis、Discord、ViewModel）
- ✅ GitHub集成
- ✅ 安全认证
- ✅ 任务相关性
- ✅ 冲突解决
- ✅ CLI工具
- ✅ 全面的文件
计划的功能
- 🔲 用于监控的Web仪表板
- 🔲 指标和分析
- 🔲 代理性能跟踪
- 🔲 高级冲突解决策略
- 🔲 多存储库协调
- 🔲 Slack/团队集成
- 🔲 插件系统
- 🔲 代理市场
______________________________________________________________________
🤝 贡献
我们欢迎捐款！CoorChat关注 指定工作流:
- 规格 -明确定义特征
- 澄清 -解决歧义
- 规划 -制定实施计划
- 任务生成 -分解为任务
- 实施 -执行计划
开发设置
# Clone and install
git clone https://github.com/stuartf303/coorchat.git
cd coorchat/packages/mcp-server
npm install
# Run tests
npm test
# Run in development mode
npm run dev
# Lint and format
npm run lint
npm run format拉取请求流程
- 从以下位置创建要素分支
main - 通过测试进行更改
- 确保所有测试通过(
npm test) - 根据需要更新文档
- 提交带有清晰描述的PR
- 等待CI/CD检查
- 处理审阅反馈
看 贡献.md 详细指南
______________________________________________________________________
📄 许可证
该项目根据 MIT许可证 -看看 许可证 文件以获取详细信息。
MIT License
Copyright (c) 2026 CoorChat Contributors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
[Full MIT License text...]______________________________________________________________________
🙏 致谢
- 克劳德（人类学） -AI结对编程伙伴
- 模型上下文协议（MCP） -代理集成框架
- 指定 -规范驱动的开发工作流程
- 开源社区 -对于这个项目中使用的令人惊叹的库
______________________________________________________________________
📞 支持与社区
______________________________________________________________________
⭐ 星迹
如果你觉得CoorChat有用，请考虑给它一颗星！ ⭐
______________________________________________________________________
由...制作❤️ 由开发者，为开发者