okooooooo/ccg-workflow
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
80 Commits 1 Branch 0 Tags
1237d2bfe0c324fe2ceeba3bbbc5dce210c955c9
Commit Graph
30 Commits
Author SHA1 Message Date
li beca0106ce fix: 修复 npm 全局安装用户的更新和卸载问题 (v1.7.11) 
**问题背景**：
- 用户通过 `npm install -g` 全局安装后，存在双重路径问题
- 卸载显示成功但命令仍可用（只删除了工作流文件，npm 包未移除）
- 更新显示成功但版本号不变（只更新了工作流文件，命令入口仍指向旧版本）

**核心修复**：
1. 新增 checkIfGlobalInstall() 函数检测 npm 全局安装
2. 更新功能：检测到全局安装时引导用户使用 npm 更新
3. 卸载功能：提示两步卸载流程，避免困惑

**修改文件**：
- src/commands/update.ts - 添加全局安装检测和更新引导
- src/commands/menu.ts - 添加卸载引导逻辑
- README.md - 完善卸载说明，区分 npx 和全局安装
- CHANGELOG.md - 记录本次修复
- CLAUDE.md - 更新版本号和变更记录
- package.json - 版本号 1.7.10 → 1.7.11

**用户价值**：
解决"全局安装 + npx 混用"导致的更新/卸载混乱问题
 2026-01-09 21:20:24 +08:00
li 90cee455f3 fix: Windows 兼容性修复 + 升级体验优化 (v1.7.10) 
解决的问题：

1. Windows 路径兼容性问题
   - 修复 Git Bash 环境下路径转义问题（C:\Users\... → C:Users...）
   - 新增 convertToGitBashPath 函数支持盘符转换（C: → /c/）
   - 影响所有调用 codeagent-wrapper 的命令

2. 配置迁移问题
   - update 命令新增自动迁移逻辑（~/.ccg → ~/.claude/.ccg）
   - 从 v1.3.x 升级时自动迁移配置文件和 prompts
   - 显示详细迁移日志

3. Windows npx 缓存问题
   - update 命令在 Windows 上自动清理 npx 缓存
   - 确保更新时拉取最新版本，而不是使用缓存的旧版本
   - 先尝试 npx clear-npx-cache，失败则手动删除 ~/.npm/_npx

4. 卸载与更新文档优化
   - 新增 npx 缓存清理说明
   - 提供交互式卸载 + 手动清理两种方式

修改文件：
- src/utils/installer.ts (路径转换)
- src/commands/update.ts (迁移逻辑 + npx 缓存清理)
- README.md, CHANGELOG.md, CLAUDE.md (文档)
- bin/* (重新编译所有平台二进制)

版本：1.7.9 → 1.7.10
 2026-01-09 19:51:15 +08:00
li 322a4d329e feat: Web UI 实时流式输出 + 自动打开浏览器 + 完成提示 
- 新增 Web UI 实时输出（SSE）
  - 随机端口分配，避免端口冲突
  - 单面板显示，按后端类型分色（Codex 绿/Gemini 紫/Claude 橙）
  - 短生命周期，随任务结束而关闭
- 新增自动打开浏览器功能（跨平台：macOS/Linux/Windows）
- 新增完成提示（✓ 完成 + 浏览器通知）
- 新增内容类型显示
  - 💭 思考过程（reasoning - 灰色斜体）
  - 💻 命令执行（command - 黄色代码块）
  - 📝 最终回复（message - 白色）
- 修复 Codex turn.completed 事件捕获
- 扩展 stderr 噪音过滤到所有后端
- 新增 /ccg:enhance 命令（Prompt 增强）

修改文件:
- codeagent-wrapper/server.go: Web UI 核心实现
- codeagent-wrapper/executor.go: WebServer 集成
- codeagent-wrapper/parser.go: turn.completed 支持 + 内容类型
- codeagent-wrapper/filter.go: 全后端噪音过滤
- templates/commands/enhance.md: 新增 Prompt 增强命令
- README.md: 更新功能列表（15 个命令）
- package.json: v1.7.3

版本: v1.7.3
 2026-01-09 04:27:10 +08:00
li ce9c69ea53 add 2026-01-08 17:18:53 +08:00
li 3f6fa128cb release: v1.7.0 - 大幅简化安装流程，固定模型路由 
主要变更：
- 🎯 简化安装流程：只需配置 MCP（可选），无需选择语言/模型/命令
- 🔧 固定模型路由：Gemini (前端) + Codex (后端)
- ✂️ 精简命令：从 17 个减少到 14 个
  - 删除 think（与 analyze 重叠）
  - 删除 bugfix（与 debug 重叠）
  - 删除 code（被 workflow 覆盖）
  - 删除 enhance（集成到 workflow）
- 📝 重写所有命令模板：统一 [模式：X] 标签系统，精简到 100-140 行
- 📦 新增平台支持：Linux ARM64 + Windows ARM64
 2026-01-07 23:59:27 +08:00
li 8c0fd802c1 docs: 重写 README 并添加 NPM 发布流程到 CLAUDE.md 
- 重写 README.md（591 行 → 406 行，精简 31%）
  - 删除过时的 v1.6.0 改进、Windows MCP 修复内容
  - 删除不准确的 Codex/Gemini GitHub 链接
  - 优化结构，突出核心命令（3 个）
  - 修正错误命令 `npx ccg config mcp` → `npx ccg-workflow`

- 添加 NPM 发布流程到 CLAUDE.md
  - 前置要求（npm 账户、token 配置）
  - 4 步发布流程
  - 验证命令和注意事项

- 删除其他项目的 CLAUDE.md（skills、myclaude、zcf）
  - 仅保留 skills-v2 项目文档
 2026-01-07 14:12:48 +08:00
li a2df905002 perf: 优化 dev 阶段 2，硬编码 codex/gemini 减少 token 消耗 
- 阶段 2 从调用 4 个模型减少到 2 个（codex + gemini）
- 删除动态获取模型的 jq 逻辑，直接硬编码
- dev.md 从 6.8kB 优化到 6.3kB（节省 500 字节）
- 避免不必要的重复调用（所有模型都使用 analyzer.md）
 2026-01-07 13:34:37 +08:00
li 69f07ee850 fix: readme文档不准确 2026-01-06 20:37:53 +08:00
li 9c7e629588 fix: 修复默认语言为中文 (v1.4.3) 
- 修改 CLI 默认语言从 en 改为 zh-CN
- 确保新用户安装时默认显示中文界面
- 与 v1.3.5 CHANGELOG 中的说明保持一致
 2026-01-06 16:20:25 +08:00
li fa23306653 docs: 重写 README 突出 v1.4.2 Windows MCP 自动修复 
- 突出 Windows MCP 自动修复功能（核心改进）
- 添加诊断工具说明 (npx ccg diagnose-mcp / fix-mcp)
- 更新版本信息到 v1.4.2
- 简化文档结构，提升可读性
- 在致谢中感谢 ZCF 项目的 MCP 跨平台逻辑
- 更新目录结构说明（v1.4.0+ 新位置）
 2026-01-06 16:02:24 +08:00
li bca0d444be feat: 添加跨平台 MCP 配置自动修复功能 (v1.4.2) 
从 ZCF 项目移植完整的跨平台 MCP 配置逻辑，彻底解决 Windows 用户 MCP 安装问题。

新增功能:
- 自动 Windows 命令包装 (cmd /c npx ...)
- MCP 配置自动备份 (~/.claude/backup/)
- 新增 `npx ccg diagnose-mcp` 诊断工具
- 新增 `npx ccg fix-mcp` 修复工具 (Windows)

新增文件:
- src/utils/platform.ts - 跨平台检测和命令包装
- src/utils/mcp.ts - MCP 配置管理和自动修复
- src/commands/diagnose-mcp.ts - MCP 诊断命令

优化内容:
- installAceTool() - 使用 buildMcpServerConfig() 和 fixWindowsMcpConfig()
- uninstallAceTool() - 添加自动备份功能
- 所有 MCP 配置操作支持自动备份和 Windows 兼容性

技术细节:
Windows 命令自动包装: npx → cmd /c npx
用户无需手动设置环境变量或修改配置
安装时自动应用，无需额外操作

升级说明:
- 新用户: npx ccg-workflow@latest init
- Windows 现有用户: npx ccg fix-mcp
- 验证配置: npx ccg diagnose-mcp
 2026-01-06 15:57:16 +08:00
li d15d550173 fix: 修复 Codex API 客户端认证问题 (v1.3.6) 
- 添加 CODEX_DISABLE_SKIP_GIT_CHECK 环境变量开关
- 允许用户禁用 --skip-git-repo-check 参数解决 403 认证错误
- 更新所有平台二进制文件 (darwin-amd64/arm64, linux-amd64, windows-amd64)
- 在 README 添加完整的 Codex 认证问题故障排除指南

修复问题:
- 部分用户使用 codeagent-wrapper 调用 Codex 时报错 "Client not allowed"
- 直接调用 codex CLI 正常，但通过 wrapper 调用失败
- 原因: --skip-git-repo-check 参数触发不同的认证逻辑

解决方案:
- 设置 export CODEX_DISABLE_SKIP_GIT_CHECK=true 即可解决
- 默认行为保持不变，向后兼容

相关文件:
- codeagent-wrapper/executor.go (添加环境变量检查)
- bin/codeagent-wrapper-* (重新编译所有平台)
- README.md (添加故障排除文档)
- package.json (版本 1.3.5 → 1.3.6)
 2026-01-05 21:33:14 +08:00
li 7953fc5432 docs: 优化 README 版本历史折叠显示 
- 将 v1.3.0 独立折叠，与最新版本分离
- 创建统一的历史版本折叠区域（v1.0.0 - v1.2.3）
- 简化历史版本描述，删除 emoji 和冗余细节
- 添加 CHANGELOG.md 完整记录链接

改进了文档的可读性和信息层次结构。
 2026-01-05 21:15:32 +08:00
li d32d878e1a docs: 更新常见问题链接为社区帖子 
变更:
- 将 POST_DRAFT.md 引用改为 linux.do 社区讨论帖链接
- 添加 GitHub Issues 链接作为问题反馈渠道

链接:
- linux.do: https://linux.do/t/topic/1405588
- GitHub Issues: https://github.com/fengshao1227/ccg-workflow/issues
 2026-01-05 21:08:14 +08:00
li 836a80d908 docs: 更新 README.md 到 v1.3.5 
变更:
- 更新最新版本信息为 v1.3.5
- 添加 v1.3.5（MCP 工具选择功能）更新说明
- 添加 v1.3.4（默认中文界面）更新说明
- v1.3.3 移入折叠区域

功能亮点:
- v1.3.5: MCP 工具选择菜单（ace-tool / auggie / 跳过）
- v1.3.4: 修复默认语言为英文的问题
 2026-01-05 21:04:19 +08:00
li d8a3ee2bfd fix: 修复默认语言为英文的问题 v1.3.4 
变更:
- src/i18n/index.ts: initI18n 默认语言从 'en' 改为 'zh-CN'
- package.json: 版本号 1.3.3 → 1.3.4
- src/utils/config.ts: 配置版本号更新到 1.3.4
- README.md: 添加 Codex CLI 和 Gemini CLI 徽章
- POST_DRAFT.md: 添加 Codex CLI 和 Gemini CLI 徽章，修正命令分类

问题:
- 用户反馈 npx ccg-workflow 默认显示英文界面
- 中文用户需要手动选择语言

解决方案:
- 将默认语言改为中文 (zh-CN)
- fallbackLng 保持英文，确保翻译缺失时有回退
 2026-01-05 20:54:47 +08:00
li 26fb88f3b5 fix: 修复 Windows PATH 配置安全问题 v1.3.3 
问题:
- Windows 使用 setx 配置 PATH 有 1024 字符限制
- 超长 PATH 会被截断，导致数据丢失
- 社区用户反馈中招过

修复:
- ✅ src/commands/init.ts: 改用安全追加方法
  - 使用 PowerShell GetEnvironmentVariable 先读取后追加
  - 支持最大 32767 字符（vs setx 的 1024）
  - 自动检测路径是否已存在（-notlike 判断）
  - 避免重复添加

新方法示例:
```powershell
$currentPath = [System.Environment]::GetEnvironmentVariable('PATH', 'User')
$newPath = 'C:\Users\xxx\.claude\bin'
if ($currentPath -notlike "*$newPath*") {
    [System.Environment]::SetEnvironmentVariable('PATH', "$currentPath;$newPath", 'User')
}
```

影响范围:
- 仅 Windows 用户
- 不影响 macOS/Linux 自动配置
- 向下兼容，不破坏现有配置

修改文件:
- src/commands/init.ts: Windows PATH 配置逻辑
- package.json: 版本号 1.3.2 → 1.3.3
- src/utils/config.ts: 配置版本号 1.3.3
- README.md: 添加 v1.3.3 更新说明
- POST_DRAFT.md: 更新头部和尾部版本号
- CHANGELOG.md: 详细记录修复过程和代码对比
 2026-01-05 20:27:57 +08:00
li b7e8cf0b6e docs: 添加 Q11 并完善常见问题部分 
更新内容:
- ✅ POST_DRAFT.md: 添加 Q11（Codex 超时问题）并修复链接格式
- ✅ POST_DRAFT.md: 确保开头版本号为 v1.3.2
- ✅ README.md: 新增"常见问题"章节
  - Q11: Codex 超时问题及解决方案
  - 更新、MCP 选择、codeagent-wrapper 等常见问题
  - 引用 POST_DRAFT.md 获取完整 Q&A

Q11 详细内容:
- 问题: Codex 思考时间过长导致超时
- 解决方案: 引用 linux.do 社区讨论链接
- 优化建议: 拆分任务、调整配置、切换后端

修改文件:
- README.md: 新增"常见问题"章节（66 行）
- POST_DRAFT.md: 更新 Q11 格式和开头版本号
 2026-01-05 20:22:15 +08:00
li eee626edce docs: 更新文档至 v1.3.2 
更新内容:
- ✅ README.md: 添加 v1.3.2 bug 修复说明，折叠 v1.3.1 历史
- ✅ POST_DRAFT.md: 更新帖子头部和尾部版本号到 v1.3.2
- ✅ CHANGELOG.md: 详细记录 v1.3.2 修复内容
  - 问题描述
  - 修复的类型定义和配置生成逻辑
  - 生成的配置结构示例
  - 修复影响说明

修改文件:
- README.md
- POST_DRAFT.md
- CHANGELOG.md
 2026-01-05 20:15:47 +08:00
li 65b434beb6 docs: update README to v1.3.1 2026-01-05 19:55:17 +08:00
li 1eaae49a1a docs: 澄清 auggie 也支持 Prompt 增强功能 
## 修改内容

### 文档更新
- README.md: 更新 v1.3.0 描述，说明 auggie 支持可选配置 Prompt 增强
- 配置示例：`prompt_enhance_auggie = ""` 改为注释"留空表示未配置，按教程配置后填入工具名"

### 命令模板更新
- commands/ccg/dev.md: 修改 Phase 0 说明，从"auggie 不支持"改为"未配置 Prompt 增强功能"
- commands/ccg/enhance.md: 修改提示信息，建议按教程配置或切换到 ace-tool

### 功能对比更新
- ace-tool: 开箱即用 Prompt 增强
- auggie: 可选配置 Prompt 增强（需按教程手动配置）

参考教程: https://linux.do/t/topic/1280612
 2026-01-05 19:49:55 +08:00
li c74c8c927b feat: 新增 MCP 动态选择系统 v1.3.0 
## 主要更新

### 1. MCP 动态选择
- ✨ 支持安装时选择 MCP 提供商（ace-tool 或 auggie）
- 🔧 自动生成 ~/.ccg/config.toml 配置文件
- 🔄 命令模板根据配置动态路由 MCP 工具

### 2. 命令模板简化
- 📝 移除外部文档引用（memorys/MCP_USAGE.md）
- 🎯 自包含配置读取说明，减少 50% 提示词长度
- 🔍 统一模式：读取 config → 获取 provider → 调用对应工具

### 3. 配置驱动架构
- 🗂️ 新增 [mcp.tools] 工具名称映射
- 🏷️ 参数名映射（query vs information_request）
- 🚫 优雅处理缺失功能（auggie 无 prompt enhancement）

### 4. 文件更改
- 修改: install.py（新增 MCP 选择逻辑）
- 修改: config.json（operation: install_mcp）
- 修改: 12 个命令模板（dev, enhance, code, analyze, etc.）
- 删除: SLASH_COMMAND_FORMAT.md, UPDATES.md（已合并到文档）
- 更新: CHANGELOG.md, README.md, CLAUDE.md

### 5. 兼容性
- ✅ 向后兼容：默认使用 ace-tool
- ✅ 支持跳过 MCP 安装
- ✅ 配置不存在时使用默认值

Breaking Changes: 无
 2026-01-05 19:42:44 +08:00
li 6786513cb8 fix: 修复 codeagent-wrapper 未安装到 PATH 的问题 
**问题描述**:
- npm 包虽然包含了 bin/ 目录下的 codeagent-wrapper 预编译二进制文件
- 但安装脚本没有将其复制到用户 PATH 中
- 导致命令模板调用 codeagent-wrapper 时报"未找到命令"错误

**解决方案**:
1. 扩展 InstallResult 类型，添加 binPath 和 binInstalled 字段
2. 在 installWorkflows 函数中：
   - 根据平台自动选择正确的二进制文件（darwin-arm64/amd64, linux-amd64, windows-amd64.exe）
   - 复制到 ~/.claude/bin/ 目录
   - Unix 系统自动添加可执行权限 (chmod 755)
3. 在 init 命令中显示安装结果和 PATH 配置提示：
   - 显示二进制文件安装路径
   - 提示用户添加到 shell 配置文件
   - 根据 shell 类型推荐配置文件 (~/.zshrc 或 ~/.bashrc)
4. 添加 i18n 翻译（中英文）

**影响文件**:
- src/types/index.ts
- src/utils/installer.ts
- src/commands/init.ts
- src/i18n/index.ts
- package.json (v1.1.1 → v1.1.2)

**测试**:
- ✅ TypeScript 类型检查通过
- ✅ 构建成功

**后续步骤**:
用户需要手动添加 ~/.claude/bin 到 PATH：
\`\`\`bash
echo 'export PATH="$HOME/.claude/bin:\$PATH"' >> ~/.zshrc
source ~/.zshrc
\`\`\`
 2026-01-05 18:20:39 +08:00
li f1a66ba1ba docs: 更新 README 添加智能更新功能说明 v1.1.1 
更新内容:
- 在「最新更新」部分新增 v1.1.0 智能更新系统说明
- 在「交互式菜单」部分详细说明更新功能
- 新增独立「更新」章节，包含更新步骤和强制修复说明
- 优化文档结构，便于用户快速找到更新方法

版本: 1.1.0 → 1.1.1 (文档更新)
 2026-01-05 17:58:41 +08:00
li d554587384 fix: 修复命令模板中的 MCP 工具参数缺失问题 
- 在所有命令模板中添加 mcp__ace-tool__search_context 完整参数说明
  - project_root_path: 项目根目录绝对路径
  - query: 自然语言描述
- 在 enhance/dev 模板中添加 mcp__ace-tool__enhance_prompt 参数说明
  - prompt: 原始 prompt
  - conversation_history: 最近对话历史(5-10轮)
  - project_root_path: 项目根目录(可选)
- 更新 _config.md 中的提示词路径引用为 ~/.claude/prompts/ccg/<model>/<role>.md
- 更新版本号 1.0.0 → 1.0.1

修改文件:
- templates/commands/{dev,enhance,analyze,backend,bugfix,code,debug,frontend,optimize,review,test,think}.md
- templates/commands/_config.md
- package.json
 2026-01-05 15:47:01 +08:00
li 53fcade330 feat: 新增 TypeScript CLI 安装系统，支持 npx 一键安装 
- 重构为 TypeScript + unbuild 构建系统
- 新增交互式安装菜单（初始化/更新/卸载）
- 支持 npx ccg-workflow 直接运行
- 已发布至 npm: ccg-workflow@1.0.0
- 新增 Claude 角色提示词（6个专家角色）
- 更新命令模板支持三模型协作（Claude + Codex + Gemini）
- 更新 README 文档
 2026-01-05 14:44:01 +08:00
li 9085200552 docs: 更新致谢，补充 myclaude 命令设计参考 
补充说明 /ccg:code, /ccg:debug, /ccg:test, /ccg:bugfix, /ccg:think, /ccg:optimize 命令的设计参考来源
 2026-01-05 02:22:08 +08:00
li 87dd43225d refactor: 重构提示词系统为多角色动态注入 
## 变更内容

### 新增角色文件 (12个)
- prompts/codex/: architect, analyzer, debugger, tester, reviewer, optimizer
- prompts/gemini/: frontend, analyzer, debugger, tester, reviewer, optimizer

### 更新命令文件
- 所有命令改用 `<ROLE>` + `<TASK>` 动态注入模式
- 根据任务类型引用对应的角色提示词文件
- 简化命令文件内容，避免重复的角色定义

### 删除旧文件
- prompts/codex.md (改为 prompts/codex/ 目录)
- prompts/gemini.md (改为 prompts/gemini/ 目录)

### 文档更新
- README.md 更新项目结构和角色文件说明
- 添加角色→命令映射表
 2026-01-05 02:08:30 +08:00
li 2bcac5447c feat: 新增6个多模型开发命令 
新增命令：
- /ccg:code - 多模型代码生成（智能路由）
- /ccg:debug - UltraThink 多模型调试
- /ccg:test - 多模型测试生成
- /ccg:bugfix - 质量门控修复（90%+ 通过）
- /ccg:think - 深度分析
- /ccg:optimize - 性能优化

特性：
- 双模型并行诊断和分析
- 质量门控循环验证机制
- 智能路由（前端→Gemini，后端→Codex）

更新：
- README.md 更新命令列表和使用示例
- install.py 更新安装摘要
- config.json 更新命令数量

现共17个命令
 2026-01-05 01:44:50 +08:00
li 6d5628977b feat: CCG 多模型协作系统 v1.0 
Claude Code + Codex + Gemini 多模型协作工作流系统

## 核心功能
- 6阶段开发工作流 (/ccg:dev)
- 智能路由：前端→Gemini，后端→Codex
- Prompt 增强 (Auggie MCP prompt-enhancer)
- 双模型代码审查和技术分析

## 命令列表
- /ccg:dev - 完整开发工作流
- /ccg:frontend - 前端任务
- /ccg:backend - 后端任务
- /ccg:review - 代码审查
- /ccg:analyze - 技术分析
- /ccg:enhance - Prompt 增强
- /ccg:commit - 智能提交
- /ccg:rollback - 交互式回滚
- /ccg:clean-branches - 清理分支
- /ccg:worktree - Worktree 管理
- /ccg:init - 项目初始化

## 特性
- 预编译二进制（无需 Go 环境）
- 专家系统提示词（Codex/Gemini）
- 一键安装脚本
 2026-01-05 01:28:10 +08:00