# Stigmergy CLI Multi-Agents

🚀 **Cross-CLI Collaboration System with Intelligent Adapters**

Stigmergy CLI Multi-Agents 是一个跨CLI工具的协作系统，支持多种AI工具之间的智能协作和记忆共享。系统通过智能适配器、环境信号和全局记忆实现无缝的CLI工具协作。

## ✨ 特性

- 🔍 **自动扫描和安装** - 自动检测本地CLI工具并按需安装
- 🤝 **跨CLI协作** - 支持Qwen、iFlow、Gemini、Copilot、Claude、Codex等多种CLI工具
- 🧠 **智能适配器** - Python/Node.js双适配器，自动选择最佳方案
- 🌍 **编码安全** - 完美解决Windows中文系统的GBK编码问题
- 📝 **全局记忆** - CLI工具间的调用模式和协作历史记录
- 🔧 **插件系统** - 可扩展的插件架构，支持自定义适配器
- 📊 **部署报告** - 详细的安装和配置报告

## 🛠️ 支持的CLI工具

| CLI工具 | 类型 | 安装命令 | 状态 |
|--------|------|----------|------|
| **Qwen CLI** | npm | `@qwen/cli` | ✅ 支持 |
| **iFlow CLI** | npm | `@iflow/cli` | ✅ 支持 |
| **Gemini CLI** | npm | `@google/generative-ai-cli` | ✅ 支持 |
| **Copilot CLI** | npm | `@github/copilot-cli` | ✅ 支持 |
| **Claude CLI** | python | `claude-cli` | ✅ 支持 |
| **Codex CLI** | npm | `@openai/codex-cli` | ✅ 支持 |

## 🚀 快速开始

### 1. 全局安装（推荐）

```bash
# 全局安装 - 自动完成所有配置
npm install -g stigmergy-cli-multi-agents

# 安装完成后会自动启动部署，无需额外操作
```

### 2. 本地安装

```bash
# 克隆仓库
git clone https://github.com/stigmergy-cli/multi-agents.git
cd stigmergy-cli-multi-agents

# 安装并自动部署
npm install

# 或手动部署
npm run setup
```

### 3. 快速验证

```bash
# 检查系统状态
stigmergy status

# 启动协作系统
stigmergy start

# 查看帮助
stigmergy help
```

## 📋 详细用法

### 部署命令

```bash
# 完整部署（推荐）
stigmergy deploy

# 仅扫描CLI工具
stigmergy scan

# 仅安装缺失的CLI
stigmergy install

# 仅复制插件扩展
stigmergy plugins

# 自动安装模式
stigmergy deploy --auto-install

# 强制重新安装
stigmergy deploy --force-reinstall
```

### 适配器命令

```bash
# 运行智能适配器
stigmergy adapter

# 指定运行模式
stigmergy adapter --mode hybrid      # 混合模式（推荐）
stigmergy adapter --mode python-only # 仅Python模式
stigmergy adapter --mode nodejs-only # 仅Node.js模式

# 运行演示
stigmergy adapter --demo

# 检查适配器状态
stigmergy adapter --check

# 使用自定义配置
stigmergy adapter --config /path/to/config.json
```

### 环境信号系统

```bash
# 启动环境信号系统
stigmergy env

# 监控模式
stigmergy env --watch

# 仅处理信号
stigmergy env --signals-only

# 仅处理历史记录
stigmergy env --history-only
```

## 🏗️ 系统架构

### 核心组件

1. **CLI Auto Scanner** (`cli_auto_scanner.js`)
   - 自动扫描本地CLI工具
   - 检测安装路径和版本
   - 支持多种包管理器（npm, yarn, pnpm, pip）

2. **Install Manager** (`cli_install_manager.js`)
   - 交互式CLI安装界面
   - 用户选择和确认机制
   - 批量安装和进度显示

3. **Plugin Extension Copier** (`plugin_extension_copier.js`)
   - 跨平台插件复制
   - GBK编码安全处理
   - 智能路径检测

4. **Smart Adapter System** (`smart_adapter_*.js`)
   - Python/Node.js智能适配
   - 自动环境检测
   - 优雅降级机制

5. **Environment Stigmergy System** (`environment_stigmergy_system.js`)
   - 环境信号处理
   - 协作历史记录
   - 全局记忆管理

### 协作机制

```
CLI A ──┐
        ├─→ 环境信号 ──→ 智能适配器 ──→ CLI B
CLI C ──┘                        │
                                   ├─→ 全局记忆
CLI D ──→ 环境信号 ──┘
```

## 🔧 配置文件

系统会在 `~/.stigmergy-cli/` 目录下创建配置文件：

- `deployment-report.md` - 部署报告
- `cli-call-patterns.md` - CLI调用模式
- `cli-installation-paths.md` - 安装路径记录
- `collaboration-config.md` - 协作配置
- `adapter-config.json` - 适配器配置
- `deployment.log` - 部署日志

## 🌍 编码支持

系统专门解决了Windows中文系统的GBK编码问题：

- **自动编码检测** - 智能识别文件编码
- **多级回退机制** - UTF-8 → GBK → UTF-8 BOM
- **安全文件操作** - 编码安全的读写操作
- **跨平台兼容** - Windows/macOS/Linux全平台支持

## 🎯 使用场景

### 1. 多AI协作编程
```bash
# 使用Qwen生成代码
qwen --prompt "创建一个React组件" --approval-mode yolo

# 系统自动记录调用，Claude可以访问结果
claude --prompt "优化刚才生成的React组件"
```

### 2. 工作流自动化
```bash
# iFlow创建工作流
iflow --prompt "创建数据处理工作流" --yolo

# Copilot自动执行并优化
copilot --prompt "执行工作流并生成报告" --auto-approve
```

### 3. 代码审查和重构
```bash
# Codex生成重构建议
codex "review this code and suggest improvements"

# Claude执行重构
claude --prompt "apply the refactoring suggestions"
```

## 🛠️ 开发指南

### 自动部署机制

Stigmergy CLI 使用 npm 的 `postinstall` 钩子实现自动部署：

1. **全局安装时** (`npm install -g`)：
   - 自动检测全局安装模式
   - 运行完整部署流程
   - 自动扫描和安装CLI工具
   - 复制插件扩展
   - 生成配置文件

2. **本地安装时** (`npm install`)：
   - 显示设置指导
   - 提供手动部署命令

### 本地开发

```bash
# 克隆仓库
git clone https://github.com/stigmergy-cli/multi-agents.git
cd stigmergy-cli-multi-agents

# 安装依赖
npm install

# 运行测试
npm test

# 启动开发模式
npm start
```

### 添加新的CLI适配器

1. 在 `cli_auto_scanner.js` 中添加CLI规格
2. 创建对应的适配器文件 (`{cli-name}-adapter.js`)
3. 更新插件映射配置
4. 测试安装和协作流程

### 贡献指南

1. Fork 项目
2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'Add amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 开启 Pull Request

## 🐛 故障排除

### 常见问题

**Q: 安装时出现GBK编码错误**
```bash
# 解决方案：使用自动安装模式
stigmergy deploy --auto-install --force-reinstall
```

**Q: CLI工具检测不到**
```bash
# 解决方案：重新扫描并复制插件
stigmergy scan
stigmergy plugins
```

**Q: 协作不工作**
```bash
# 解决方案：检查适配器状态
stigmergy adapter --check
stigmergy status
```

### 日志调试

查看详细日志：
```bash
# 部署日志
tail -f ~/.stigmergy-cli/deployment.log

# 系统状态
stigmergy status --verbose
```

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🤝 贡献者

感谢所有为 Stigmergy CLI Multi-Agents 做出贡献的开发者！

## 📞 支持

- 📧 Email: support@stigmergy-cli.dev
- 🐛 Issues: [GitHub Issues](https://github.com/stigmergy-cli/multi-agents/issues)
- 💬 Discussions: [GitHub Discussions](https://github.com/stigmergy-cli/multi-agents/discussions)

---

🌟 **如果这个项目对您有帮助，请给我们一个星标！**

[⬆ 回到顶部](#stigmergy-cli-multi-agents)