ccg-workflow 1.3.4 → 1.3.6

package/README.md

@@ -6,7 +6,7 @@
 
 [![npm version](https://img.shields.io/npm/v/ccg-workflow.svg)](https://www.npmjs.com/package/ccg-workflow) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-green.svg)](https://claude.ai/code) [![Codex CLI](https://img.shields.io/badge/Codex%20CLI-Supported-orange.svg)](https://github.com/openai/openai-python) [![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Supported-purple.svg)](https://ai.google.dev/)
 
-> **最新版本 v1.3.3**：修复 Windows PATH 配置安全问题
+> **最新版本 v1.3.6**：修复 Codex API 客户端认证问题
 
 </div>
 
@@ -14,12 +14,33 @@
 
 ## 🎉 最新更新
 
-### v1.3.3 - Windows PATH 配置安全修复 🔒
+### v1.3.6 - Codex API 认证修复 🔧
+- ✅ **环境变量开关**：新增 `CODEX_DISABLE_SKIP_GIT_CHECK` 环境变量
+- ✅ **认证兼容**：修复部分用户 Codex API 返回 403 "Client not allowed" 错误
+- ✅ **灵活配置**：保持默认行为，允许用户按需禁用 `--skip-git-repo-check`
+- ✅ **故障排除**：README 添加完整的 Codex 认证问题解决方案
+
+### v1.3.5 - MCP 工具选择功能 🎯
+- ✅ **交互式选择**：新增 MCP 工具选择菜单（ace-tool / auggie / 跳过）
+- ✅ **ace-tool**：推荐选项，开箱即用含 Prompt 增强 + 代码检索
+- ✅ **auggie**：官方版本，代码检索 + 可选 Prompt 增强（提示配置教程）
+- ✅ **灵活配置**：允许跳过 MCP 配置，稍后手动配置
+- ✅ **智能保存**：用户选择自动保存到 `~/.ccg/config.toml`
+
+### v1.3.4 - 默认语言修复 🌏
+- ✅ **中文界面**：修复 `npx ccg-workflow` 默认显示英文的问题
+- ✅ **默认设置**：将默认语言改为中文（zh-CN）
+- ✅ **用户体验**：国内用户无需手动选择语言
+
+<details>
+<summary>v1.3.3 - Windows PATH 配置安全修复 (2026-01-05)</summary>
+
 - ✅ **安全修复**：Windows PATH 配置改用安全追加方法，避免 `setx` 1024 字符限制
 - ✅ **新方法**：使用 PowerShell `[System.Environment]::GetEnvironmentVariable` 先读取后追加
 - ✅ **重复检测**：自动检查路径是否已存在，避免重复添加
 - ✅ **无字符限制**：支持超长 PATH（最大 32767 字符）
 - ✅ **向下兼容**：不影响现有用户配置
+</details>
 
 <details>
 <summary>v1.3.2 - MCP 配置缺失修复 (2026-01-05)</summary>
@@ -39,46 +60,44 @@
 - ✅ **用户体验**：提供配置教程链接，不再误导用户认为 auggie 不支持 Prompt 增强
 </details>
 
-### v1.3.0 - MCP 动态选择系统 ⭐
+<details>
+<summary>v1.3.0 - MCP 动态选择系统 (2026-01-05)</summary>
+
 - ✅ **多 MCP 支持**：安装时可选 ace-tool（开箱即用Prompt增强+代码检索）或 auggie（官方原版，代码检索+可选Prompt增强）
 - ✅ **交互式选择**：友好的 MCP 选择界面，对比功能差异，支持跳过安装
 - ✅ **配置驱动**：生成 `~/.ccg/config.toml`，记录工具映射和参数名
 - ✅ **自包含模板**：命令模板减少 50% 提示词长度，直接读取配置无需外部文档
 - ✅ **完全兼容**：12个命令模板（dev, code, frontend, backend, review, analyze, enhance 等）支持动态 MCP 工具调用
 - ✅ **灵活配置**：auggie 可通过配置支持 Prompt 增强（参考 [配置教程](https://linux.do/t/topic/1280612)）
+</details>
+
+<details>
+<summary>查看历史版本 (v1.0.0 - v1.2.3)</summary>
 
 ### v1.2.3 - 安装体验优化
-- ✅ **二进制验证**：安装后自动验证 `codeagent-wrapper` 可用性
-- ✅ **错误显示**：安装失败时显示详细错误信息和解决方案
-- ✅ **文档清理**：删除过时提示，优化用户体验
+- 安装后自动验证 `codeagent-wrapper` 可用性
+- 安装失败时显示详细错误信息和解决方案
 
-### v1.2.0 - ROLE_FILE 动态注入 ⭐
-- ✅ **真正的动态注入**：`codeagent-wrapper` 自动识别 `ROLE_FILE:` 指令
-- ✅ **0 token 消耗**：Claude 无需先用 Read 工具读取提示词文件
-- ✅ **自动化管理**：一行 `ROLE_FILE:` 搞定，无需手动粘贴
-- ✅ **完整日志**：注入过程可追溯（文件路径、大小）
+### v1.2.0 - ROLE_FILE 动态注入
+- `codeagent-wrapper` 自动识别 `ROLE_FILE:` 指令
+- 专家提示词零 token 消耗，不占用主会话
 
 ### v1.1.3 - PATH 自动配置
-- ✅ **Mac/Linux**：自动添加到 `.zshrc` / `.bashrc`
-- ✅ **Windows**：详细手动配置指南 + PowerShell 一键命令
-- ✅ **智能检测**：避免重复配置
-- ✅ **开箱即用**：安装后直接可用 `codeagent-wrapper`
+- Mac/Linux 自动添加到 shell 配置文件
+- Windows 提供 PowerShell 一键命令
 
 ### v1.1.0 - 智能更新系统
-- ✅ **一键更新**：`npx ccg-workflow` 选择"更新工作流"
-- ✅ **自动版本检测**：自动对比当前版本与 npm 最新版本
-- ✅ **增量更新**：仅更新命令模板和提示词，保留用户配置
-- ✅ **强制修复**：支持强制重装，修复损坏的文件
-- ✅ **零权限**：无需 sudo，无需全局安装
+- 一键更新，无需卸载重装
+- 保留用户配置和 MCP 设置
 
 ### v1.0.0 - npm 首次发布
-- ✅ 从 Python 脚本重构为 **TypeScript + unbuild** 构建系统
-- ✅ 发布到 npm: **`npx ccg-workflow`** 一键安装
-- ✅ 交互式配置菜单（初始化/更新/卸载）
-- ✅ **三 CLI 协作**：Claude + Codex + Gemini
-- ✅ **18个专家提示词**：Codex 6个 + Gemini 6个 + Claude 6个
-- ✅ 配置文件从 `config.json` 迁移到 `~/.ccg/config.toml`
-- ✅ 支持 **smart/parallel/sequential** 三种协作模式
+- `npx ccg-workflow` 一键安装
+- 三模型协作（Claude + Codex + Gemini）
+- 18 个专家提示词
+
+**完整变更记录**: [CHANGELOG.md](https://github.com/fengshao1227/ccg-workflow/blob/main/CHANGELOG.md)
+
+</details>
 
 ---
 
@@ -612,6 +631,54 @@ EOF
 
 ## 常见问题
 
+<details>
+<summary><strong>Q: Codex API 返回 403 "Client not allowed" 错误</strong></summary>
+
+**问题描述**：
+```json
+{
+  "error": "Client not allowed",
+  "message": "Your client is not authorized to use this API key"
+}
+```
+
+**原因**：Codex API 对客户端验证有严格限制，`--skip-git-repo-check` 参数可能触发不同的认证逻辑。
+
+**解决方案 1：禁用 git-repo-check（推荐）**
+
+设置环境变量来禁用该参数：
+```bash
+# 临时禁用
+export CODEX_DISABLE_SKIP_GIT_CHECK=true
+/ccg:dev "your task"
+
+# 永久禁用（添加到 ~/.zshrc 或 ~/.bashrc）
+echo 'export CODEX_DISABLE_SKIP_GIT_CHECK=true' >> ~/.zshrc
+source ~/.zshrc
+```
+
+**解决方案 2：检查 Codex 配置**
+
+如果方案 1 无效，检查 Codex CLI 配置：
+```bash
+# 重新登录 Codex
+codex logout
+codex login
+
+# 验证直接调用是否正常
+codex e "test task"
+```
+
+**解决方案 3：更新 Codex CLI**
+
+```bash
+# 更新到最新版本
+pip install --upgrade codex-cli
+# 或
+npm install -g @codex/cli
+```
+</details>
+
 <details>
 <summary><strong>Q: codex 总是思考太久超时该怎么办？</strong></summary>
 
@@ -664,7 +731,9 @@ npx ccg-workflow
 <details>
 <summary><strong>更多问题？</strong></summary>
 
-查看完整 Q&A：[POST_DRAFT.md](POST_DRAFT.md) 包含 11 个常见问题的详细解答。
+查看完整讨论和 Q&A：
+- [linux.do 社区讨论帖](https://linux.do/t/topic/1405588) - 包含 11 个常见问题的详细解答
+- [GitHub Issues](https://github.com/fengshao1227/ccg-workflow/issues) - 提交问题和建议
 </details>
 
 ---

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { r as readCcgConfig, b as initI18n, s as showMainMenu, i as init, a as i18n } from './shared/ccg-workflow.B-YN9p9d.mjs';
+import { r as readCcgConfig, b as initI18n, s as showMainMenu, i as init, a as i18n } from './shared/ccg-workflow.D6FQGeQd.mjs';
 import 'inquirer';
 import 'node:os';
 import 'pathe';
@@ -13,7 +13,7 @@ import 'smol-toml';
 import 'node:child_process';
 import 'node:util';
 
-const version = "1.3.4";
+const version = "1.3.6";
 
 function customizeHelp(sections) {
   sections.unshift({

package/dist/index.d.mts

@@ -116,6 +116,7 @@ declare function createDefaultConfig(options: {
     language: SupportedLang;
     routing: ModelRouting;
     installedWorkflows: string[];
+    mcpProvider?: string;
 }): CcgConfig;
 declare function createDefaultRouting(): ModelRouting;
 

package/dist/index.d.ts

@@ -116,6 +116,7 @@ declare function createDefaultConfig(options: {
     language: SupportedLang;
     routing: ModelRouting;
     installedWorkflows: string[];
+    mcpProvider?: string;
 }): CcgConfig;
 declare function createDefaultRouting(): ModelRouting;
 

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { c as changeLanguage, q as checkForUpdates, t as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, o as getCurrentVersion, p as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, k as installWorkflows, r as readCcgConfig, s as showMainMenu, n as uninstallAceTool, m as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.B-YN9p9d.mjs';
+export { c as changeLanguage, q as checkForUpdates, t as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, o as getCurrentVersion, p as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, k as installWorkflows, r as readCcgConfig, s as showMainMenu, n as uninstallAceTool, m as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.D6FQGeQd.mjs';
 import 'ansis';
 import 'inquirer';
 import 'node:os';

package/dist/shared/{ccg-workflow.B-YN9p9d.mjs → ccg-workflow.D6FQGeQd.mjs}

@@ -381,7 +381,7 @@ async function writeCcgConfig(config) {
 function createDefaultConfig(options) {
   return {
     general: {
-      version: "1.3.4",
+      version: "1.3.5",
       language: options.language,
       createdAt: (/* @__PURE__ */ new Date()).toISOString()
     },
@@ -395,7 +395,7 @@ function createDefaultConfig(options) {
       backup: join(CCG_DIR, "backup")
     },
     mcp: {
-      provider: "ace-tool",
+      provider: options.mcpProvider || "ace-tool",
       setup_url: "https://linux.do/t/topic/284963",
       tools: {
         code_search_ace: "mcp__ace-tool__search_context",
@@ -1025,30 +1025,67 @@ async function init(options = {}) {
     }]);
     selectedWorkflows = selected;
   }
+  let mcpProvider = "ace-tool";
   let aceToolBaseUrl = "";
   let aceToolToken = "";
   if (!options.skipPrompt) {
     console.log();
-    console.log(ansis.cyan.bold(`  \u{1F527} ace-tool MCP`));
-    console.log(ansis.gray(`     ${i18n.t("init:aceTool.description")}`));
-    console.log(ansis.gray(`     ${i18n.t("init:aceTool.getToken")}: https://augmentcode.com/`));
+    console.log(ansis.cyan.bold(`  \u{1F527} MCP \u5DE5\u5177\u9009\u62E9`));
     console.log();
-    const aceAnswers = await inquirer.prompt([
-      {
-        type: "input",
-        name: "baseUrl",
-        message: `${i18n.t("init:aceTool.baseUrl")} ${ansis.gray("(Enter to skip)")}`,
-        default: ""
-      },
-      {
-        type: "password",
-        name: "token",
-        message: `${i18n.t("init:aceTool.token")} ${ansis.gray("(Enter to skip)")}`,
-        mask: "*"
-      }
-    ]);
-    aceToolBaseUrl = aceAnswers.baseUrl || "";
-    aceToolToken = aceAnswers.token || "";
+    const { selectedMcp } = await inquirer.prompt([{
+      type: "list",
+      name: "selectedMcp",
+      message: "\u9009\u62E9 MCP \u4EE3\u7801\u68C0\u7D22\u5DE5\u5177",
+      choices: [
+        {
+          name: `ace-tool ${ansis.gray("(\u63A8\u8350) - \u5F00\u7BB1\u5373\u7528\uFF0C\u542B Prompt \u589E\u5F3A + \u4EE3\u7801\u68C0\u7D22")}`,
+          value: "ace-tool"
+        },
+        {
+          name: `auggie ${ansis.gray("(\u5B98\u65B9) - \u4EE3\u7801\u68C0\u7D22 + \u53EF\u9009 Prompt \u589E\u5F3A\uFF08\u9700\u989D\u5916\u914D\u7F6E\uFF09")}`,
+          value: "auggie"
+        },
+        {
+          name: `\u8DF3\u8FC7 ${ansis.gray("- \u7A0D\u540E\u624B\u52A8\u914D\u7F6E")}`,
+          value: "skip"
+        }
+      ],
+      default: "ace-tool"
+    }]);
+    mcpProvider = selectedMcp;
+    if (selectedMcp === "ace-tool") {
+      console.log();
+      console.log(ansis.cyan.bold(`  \u{1F527} ace-tool MCP \u914D\u7F6E`));
+      console.log(ansis.gray(`     ${i18n.t("init:aceTool.description")}`));
+      console.log(ansis.gray(`     ${i18n.t("init:aceTool.getToken")}: https://augmentcode.com/`));
+      console.log();
+      const aceAnswers = await inquirer.prompt([
+        {
+          type: "input",
+          name: "baseUrl",
+          message: `${i18n.t("init:aceTool.baseUrl")} ${ansis.gray("(Enter to skip)")}`,
+          default: ""
+        },
+        {
+          type: "password",
+          name: "token",
+          message: `${i18n.t("init:aceTool.token")} ${ansis.gray("(Enter to skip)")}`,
+          mask: "*"
+        }
+      ]);
+      aceToolBaseUrl = aceAnswers.baseUrl || "";
+      aceToolToken = aceAnswers.token || "";
+    } else if (selectedMcp === "auggie") {
+      console.log();
+      console.log(ansis.yellow(`  \u2139\uFE0F  auggie \u5DF2\u9009\u62E9`));
+      console.log(ansis.gray(`     \u4EE3\u7801\u68C0\u7D22\u529F\u80FD\u5F00\u7BB1\u5373\u7528`));
+      console.log(ansis.gray(`     Prompt \u589E\u5F3A\u9700\u989D\u5916\u914D\u7F6E: https://linux.do/t/topic/1280612`));
+      console.log();
+    } else {
+      console.log();
+      console.log(ansis.yellow(`  \u2139\uFE0F  \u5DF2\u8DF3\u8FC7 MCP \u914D\u7F6E\uFF0C\u53EF\u7A0D\u540E\u624B\u52A8\u914D\u7F6E`));
+      console.log();
+    }
   }
   const routing = {
     frontend: {
@@ -1095,7 +1132,8 @@ async function init(options = {}) {
     const config = createDefaultConfig({
       language,
       routing,
-      installedWorkflows: selectedWorkflows
+      installedWorkflows: selectedWorkflows,
+      mcpProvider
     });
     await writeCcgConfig(config);
     const installDir = options.installDir || join(homedir(), ".claude");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "1.3.4",
+  "version": "1.3.6",
   "description": "Claude-Codex-Gemini 多模型协作系统 - 智能路由多模型开发工作流",
   "type": "module",
   "packageManager": "pnpm@10.17.1",