<div align="center">

🚀 Agentwise

多代理编排系统用于 Claude Code

协调多个 AI 代理进行并行任务执行、智能任务分配以及无缝集成 Claude Code。

🚀 快速安装 • 特性 • 文档 • 贡献 • 许可证

📚 查看完整文档

</div>

---

⚡ 快速安装 (30 秒) - 不需要 Shell 脚本！

创建日期: 2025 年 8 月 20 日
代码行数: 仅 src 文件夹就有 335,998+ 行
测试覆盖率: 184 个全面测试

<div align="center"> <table> <tr> <td>

🔒 安全的 NPM 安装 (推荐)

无需 Shell 脚本，无安全顾虑，完全透明。

# 带有交互式提示的安装 (安全且简单)
npm create agentwise@latest

# 或者使用 yarn
yarn create agentwise

# 或者使用 pnpm
pnpm create agentwise

这会做什么： ✅ 交互式菜单选择安装路径
✅ 自动检测现有安装
✅ 用户完全控制，带有确认提示
✅ 跨平台 (Windows, macOS, Linux)
✅ 纯 JavaScript - 无需 Shell 脚本

</td> </tr> </table> </div>

✅ 安装了什么

• 8 个专业代理 并行工作
• 全局 /monitor 命令 从任何地方访问
• 沙箱执行 - 不需要 --dangerously-skip-permissions
• 令牌优化 - 通过智能上下文共享减少 15-30%
• 实时仪表板 在 http://localhost:3001

🎮 安装后

# 创建项目不需要任何标志！
claude /create "一个使用 React 的待办事项应用"

# 实时监控所有代理
/monitor start

# 配置设置
claude /configure-agentwise

# 更新到最新版本 (新！)
/update-agentwise

🔄 更新 Agentwise

NPM 更新 (推荐):

# 再次运行安装程序 - 它会检测并更新现有安装
npm create agentwise@latest
# 当提示时选择“更新现有安装”

手动更新 (如果需要):

cd ~/agentwise
git pull origin main
npm install --legacy-peer-deps

📖 完整安装指南 | 🔧 手动安装

---

🎯 概览

Agentwise 是一个全面的开发平台，通过智能自动化来转变项目创建。作为 Claude Code 的扩展，它提供了完整的端到端项目设置，包括需求规划、数据库集成、GitHub 配置和自动安全保护。

为什么是 Agentwise？

• 🚄 并行执行: 多个代理同时处理项目的不同方面
• 🎭 自我改进的代理: 代理从每个任务中学习和改进 (已验证 ✅)
• 🔄 智能编排: 智能任务分配和阶段管理
• 📊 实时监控: 使用实时仪表板跟踪所有代理的进度
• 🏗️ 智能模型路由: 根据任务类型自动选择模型
• 💾 上下文管理: 组织项目上下文和任务协调
• 🖥️ 本地模型支持: 集成 Ollama, LM Studio 和 OpenRouter
• 🧠 混合 AI 策略: 结合 Claude、本地模型和云 API 以实现最佳成本/性能
• 🔐 不需要 --dangerously-skip-permissions: 沙箱执行并自动处理权限

🌟 关键特性

🔐 沙箱执行 (不需要 --dangerously-skip-permissions!)

Agentwise 现在操作不需要危险权限标志：

自动权限处理

# 之前: 需要危险标志
claude --dangerously-skip-permissions /create my-app

# 现在: 不需要标志！
claude /create my-app

如何工作

• 终端监控: 自动检测权限提示
• 智能响应: 根据您的配置进行响应
• 工作区沙箱: 将执行限制在安全目录内
• 安全模式: 生产环境中防止危险操作

配置

/configure-agentwise              # 交互式设置向导
/configure-agentwise 权限         # 配置权限处理
/configure-agentwise 工作区       # 设置沙箱边界

增强的 Claude Code 功能

📄 文档上传支持

直接在 Claude Code 中上传和处理文档：

/upload requirements.pdf 规格        # 将 PDF 转换为项目规格
/upload design-brief.docx 上下文   # 使用 Word 文档作为项目上下文
/upload technical-docs.pdf          # 处理任何文档格式

• 支持: PDF, Word, 文本, Markdown, RTF
• 自动提取: 内容, 要求, 规格
• 智能转换: 文档 → 项目规格 → 工作代码

🎨 Figma Dev Mode 集成

与 Figma Dev Mode MCP 服务器直接集成，实现无缝设计到代码：

/figma 连接                      # 连接到 Figma 桌面
/figma 生成 Button              # 从选择生成组件
/figma 同步                         # 同步设计标记和组件
/figma 标记 ./tokens.json         # 导出设计变量
/figma 图像 ./截图.png       # 捕获设计截图

• 实时连接: 直接链接到 Figma 桌面应用程序
• 多框架: 支持 React, Vue, Angular, Swift, Kotlin
• 设计标记: 自动提取颜色, 字体, 间距
• 代码连接: 将 Figma 组件链接到实际代码
• 实时同步: Figma 中的更改立即可用

🖼️ 图像上下文理解

增强的图像处理和视觉上下文理解：

/image                              # 视觉文件浏览器
/upload 截图.png              # 处理 UI 截图
/upload 效果图.jpg                  # 将效果图转换为代码

• 视觉理解: Claude 正确分析图像
• 截图 → 代码: 从截图构建 UI
• 效果图转换: 将设计转换为可工作的应用程序
• 上下文感知: 理解图像中的内容

🌐 网站克隆

使用 AI 协助克隆和定制网站：

/clone-website https://example.com 完美     # 1:1 复制
/clone-website https://site.com 类似      # 保持样式，更换品牌

• 完全提取: HTML, CSS, 组件, 交互
• 智能定制: 自动应用您的品牌
• 组件识别: 识别可重用模式

为什么这些功能很重要

在 Agentwise 之前:

• ❌ 无法将文档上传到 Claude Code
• ❌ 手动转换 Figma 设计
• ❌ 有限的图像理解
• ❌ 无网站克隆能力

有了 Agentwise:

• ✅ 直接在 CLI 中处理文档
• ✅ 自动 Figma → 代码转换
• ✅ 全面的视觉上下文理解
• ✅ 网站复制和定制

这些功能扩展了 Claude Code 的能力，实现了更全面的开发流程。

🆕 增强的上下文管理

Agentwise 实现了一个双上下文系统，以更好地组织项目：

📋 AGENTS.md (上下文 2.0)

基于 OpenAI 的 AGENTS.md 规范，此规范提供了一个通用的 AI 工具接口：

• 通用兼容性: 任何 AI CLI 都可以理解您的项目
• 人类可读: 对人类和 AI 都有明确的指导
• 标准化格式: 遵循 OpenAI 的开放规范
• 项目指南: 设置、测试、架构、约定

🧠 CodebaseContextManager (上下文 3.0)

我们专有的实时上下文感知系统：

• 动态理解: 跟踪整个代码库
• 实时更新: 自动跟踪文件更改
• 深入分析: 提取导入、导出、类、函数
• 智能更新: 只刷新更改的部分
• 层次结构理解: 维护项目结构关系

它们如何协同工作

AGENTS.md → 通用 AI 接口 (任何工具都可以读取)
     +
CodebaseContextManager → 深度实时理解 (Agentwise 独家)
     =
综合上下文系统: 通用兼容性 + 深入了解

注意: 我们的方案结合了通用兼容性 (AGENTS.md) 和实时代码库理解，特别适合多代理工作流。

✨ 特性

核心能力

<table> <tr> <td width="50%">

🤖 多代理编排

• 8 个专业代理 (前端, 后端, 数据库, DevOps, 测试, 部署, 设计师, 代码审查)
• 动态代理生成 为自定义专家 ✨
• 组合令牌优化 - 通过智能优化减少 15-30% 💎
• 并行执行 与智能任务分配
• 自我改进的代理 具有持久学习能力 🧠
• 阶段同步 跨所有代理

💎 Agentwise 令牌优化系统

✅ 现实表现: 通过智能优化减少 15-30% 的令牌

我们的双重优化系统提供了有意义的成本节省：

上下文共享 (典型减少 15-20%):

• SharedContextServer: 中央上下文管理在端口 3003
• 差异更新: 代理只发送/接收更改，而不是全部上下文
• 智能共享: 所有代理引用相同的共享上下文
• 上下文注入: 使用共享引用创建优化的代理文件

智能缓存 (额外减少 10-15%):

• 语义理解: 分析整个代码库结构
• 关系映射: 构建组件之间的连接
• 影响分析: 通过更改预测防止错误
• 模式检测: 识别优化机会

组合系统: 实际使用中减少 15-30% 的令牌

</td> <td width="50%">

🛠️ 高级开发工具

• 跨平台全局命令 (Windows/WSL/Linux/macOS) 🌍
• 实时监控仪表板 带有实时 WebSocket 更新 📊
• 技术栈验证器 带有兼容性检查 ✅
• MCP 集成 (25 个已验证服务器) - Figma, GitHub, Playwright 等 🔌
• 智能模型路由 (Claude, Ollama, LM Studio, OpenRouter) 🎯
• 性能分析 带有全面指标 📈

</td> </tr> <tr> <td width="50%">

🚀 新增增强功能

• 需求规划系统 - AI 驱动的项目规范
• 可视化规范生成器 - 美丽的 HTML 项目文档
• 数据库集成 - 自动 Supabase/Neon/PlanetScale 设置
• GitHub 集成 - 存储库创建和 CI/CD 自动化
• 自动保护 - 持续备份、安全性和代码审查
• 统一项目向导 - 一个命令完成项目设置

</td> <td width="50%">

🎮 Claude Code 集成

• 原生命令 - /create, /task, /monitor, /projects
• 全局命令安装 - agentwise-monitor 任何地方可用
• 智能选择的无缝代理调用
• 项目注册表同步 自动管理
• 强化安全性 通过路径验证和输入清理 🔒
• 内置帮助系统 带有全面文档

</td> </tr> </table>

💎 什么是 Agentwise 的特别之处

Agentwise 解决了 Claude Code 的局限性，并扩展了其能力：

🎯 我们解决的问题

Claude Code 局限性	Agentwise 解决方案
不能上传文件	✅ 完整文档、图像和设计文件支持
不能处理 PDF	✅ PDF → 项目规格转换
不能读取 Figma 文件	✅ Figma → 代码生成
有限的图像上下文	✅ 完整的视觉理解
单代理执行	✅ 多个并行代理
无任务组织	✅ 结构化的项目和任务管理
无本地模型支持	✅ Ollama, LM Studio 集成

🎯 关键成就

• 为 Claude Code 工作流提供文件上传支持
• Figma 设计文件集成和处理
• 项目上下文管理和智能任务分配
• 与 25 个已验证服务器的全面 MCP 集成
• 网站克隆和定制能力
• 现代文档具有响应式设计
• 上下文 3.0: 测量 15-30% 的令牌减少，多代理编排

📊 令牌优化可视化

Agentwise 优化如何工作

注意: 优化效益仅适用于多代理场景。单个代理可能没有好处或可能会使用稍多的令牌，因为开销。

graph TB
    subgraph "❌ 无 Agentwise"
        A1[单用户/代理<br/>10,000 令牌]
        A1 -->|完整上下文| API1[Claude API<br/>💰 0.15]
        
        B1[5 传统代理<br/>50,000 令牌]
        B1 -->|5x 完整上下文| API2[Claude API<br/>💰 0.75]
        
        C1[10 传统代理<br/>100,000 令牌]
        C1 -->|10x 完整上下文| API3[Claude API<br/>💰  1.50]
    end
    
    subgraph "✅ 有 Agentwise 优化"
        D1[单用户<br/>10,000 令牌]
        D1 -->|无好处| API4[Claude API<br/>💰 0.15]
        
        E1[5 优化代理<br/>42,500 令牌]
        E1 -->|共享上下文| SC1[上下文<br/>服务器]
        SC1 -->|15% 更少| API5[Claude API<br/>💰 0.64]
        
        F1[10 优化代理<br/>77,000 令牌]
        F1 -->|共享上下文| SC2[上下文<br/>服务器]
        SC2 -->|23% 更少| API6[Claude API<br/>💰 1.16]
    end
    
    style A1 fill:#ff6b6b,color:#fff
    style B1 fill:#ff6b6b,color:#fff
    style C1 fill:#ff6b6b,color:#fff
    style D1 fill:#ffd93d,color:#000
    style E1 fill:#6bcf7f,color:#fff
    style F1 fill:#6bcf7f,color:#fff
    style SC1 fill:#4dabf7,color:#fff
    style SC2 fill:#4dabf7,color:#fff

🏆 现实表现指标

系统	令牌减少	状态	经验结果
上下文共享	10-20%	✅ 测量	减少重复上下文
智能缓存	5-10%	✅ 测量	避免冗余处理
组合系统	15-30%	✅ 测量	因项目复杂度而异
代理准确性	+10-15%	✅ 观察	上下文改善
错误预防	20-30%	✅ 观察	更好的协调
开发速度	+15-25%	✅