chatccc 0.2.229 → 0.2.231

package/README.md

@@ -1,10 +1,10 @@
 # ChatCCC
 
-**用飞书或微信聊天控制 Claude Code / Cursor / Codex / CCC Agent。**
+**用飞书或微信聊天控制 Claude Code / Cursor / Codex / CCC Agent。**
 
-ChatCCC 把本地 AI 编程工具接入即时通讯软件。你可以在手机上发消息，让 Claude Code、Cursor Agent、Codex 或内置 CCC Agent 继续写代码、查问题、跑命令；不用一直守在电脑前。
+ChatCCC 把本地 AI 编程工具接入即时通讯软件。你可以在手机上发消息，让 Claude Code、Cursor Agent、Codex 或内置 CCC Agent 继续写代码、查问题、跑命令；不用一直守在电脑前。
 
-飞书是推荐入口：直接私聊机器人即可持续使用同一个专属会话，需要并行任务时再用 `/new` 创建独立会话群；卡片能流式更新，体验完整。微信 iLink 更适合快速试用或临时使用：扫码即可接入，但只能走私聊文本模式。
+飞书是推荐入口：直接私聊机器人即可持续使用同一个专属会话，需要并行任务时再用 `/new` 创建独立会话群；卡片能流式更新，体验完整。微信 iLink 更适合快速试用或临时使用：扫码即可接入，但只能走私聊文本模式。
 
 <p align="center">
   <img src="images/img_readme_messages.jpg" alt="飞书会话列表" width="220" align="top" />
@@ -19,9 +19,9 @@ ChatCCC 把本地 AI 编程工具接入即时通讯软件。你可以在手机
 ## 为什么用 ChatCCC
 
 - **手机上也能用 AI 编程工具**：在飞书或微信发消息，就像在终端给 Agent 下指令。
-- **飞书体验更完整**：私聊可持续对话，`/new` 创建的一群一会话支持多任务并行，CardKit 卡片可流式更新。
+- **飞书体验更完整**：私聊可持续对话，`/new` 创建的一群一会话支持多任务并行，CardKit 卡片可流式更新。
 - **微信接入更轻**：不用创建飞书应用，启动后扫码即可在微信私聊里使用。
-- **多 Agent 切换**：`/new` 使用默认 Agent，也可以用 `/new claude`、`/new cursor`、`/new codex`、`/new ccc` 指定工具。
+- **多 Agent 切换**：`/new` 使用默认 Agent，也可以用 `/new claude`、`/new cursor`、`/new codex`、`/new ccc` 指定工具。
 - **群里能跑 git**：`/git status`、`/git pull`、`/git log` 会在当前会话工作目录执行，并把输出发回聊天窗口。
 
 ## 飞书和微信的差异
@@ -29,7 +29,7 @@ ChatCCC 把本地 AI 编程工具接入即时通讯软件。你可以在手机
 | 项目 | 飞书（推荐） | 微信 iLink |
 | --- | --- | --- |
 | 使用场景 | 长期主力使用 | 快速试用、临时远程控制 |
-| 会话形态 | 私聊固定专属会话；`/new` 创建一群一会话 | 私聊，一对一 |
+| 会话形态 | 私聊固定专属会话；`/new` 创建一群一会话 | 私聊，一对一 |
 | 消息展示 | CardKit 卡片，流式更新 | 纯文本，增量推送 |
 | `/new` | 自动创建新群并绑定新会话 | 在当前私聊里创建新会话 |
 | 多会话并行 | 直接切换不同群 | 支持并行，使用切换指令后未完成的任务会继续在后台进行，但不如飞书直观方便 |
@@ -133,7 +133,7 @@ Write-Host ''
 chatccc
 ```
 
-如果一切顺利，系统默认浏览器会自动打开 `http://localhost:18080/` 的 Web 配置页面。按页面提示填入飞书 App ID / App Secret，点击"保存并启动"即可。
+如果一切顺利，系统默认浏览器会自动打开 `http://localhost:18080/` 的 Web 配置页面。按页面提示填入飞书 App ID / App Secret，点击"保存并启动"即可。
 
 > **只想装 ChatCCC 本体？** 如果你已经有 Node.js，直接 `npm install -g chatccc && chatccc` 即可，不需要跑上面的完整脚本。
 
@@ -151,7 +151,7 @@ chatccc
 
 旧版本留在仓库或包目录下的 `config.json`、`logs/`、`state/` 会在首次启动时自动迁移到用户目录。
 
-每次直接运行 `chatccc` 时，无论是否已经完成配置，ChatCCC 默认都会用系统默认浏览器打开本地 Web UI（默认 `http://localhost:18080/`，修改 `config.port` 后跟随实际端口）。可在首次配置向导或管理页的 **Web UI** 设置中关闭；关闭后从下一次直接启动起生效。由 `/restart`、`/update` 或 Web UI 发起的内部重启始终不会重复打开浏览器。Linux 服务器没有 `DISPLAY`/`WAYLAND_DISPLAY` 时会跳过打开，并在终端输出 SSH 隧道访问提示。主页顶部的 **Agent Team** 入口会跳转到独立的 `/agent-team` 页面。
+每次直接运行 `chatccc` 时，无论是否已经完成配置，ChatCCC 默认都会用系统默认浏览器打开本地 Web UI（默认 `http://localhost:18080/`，修改 `config.port` 后跟随实际端口）。可在首次配置向导或管理页的 **Web UI** 设置中关闭；关闭后从下一次直接启动起生效。由 `/restart`、`/update` 或 Web UI 发起的内部重启始终不会重复打开浏览器。Linux 服务器没有 `DISPLAY`/`WAYLAND_DISPLAY` 时会跳过打开，并在终端输出 SSH 隧道访问提示。主页顶部的 **Agent Team** 入口会跳转到独立的 `/agent-team` 页面。
 
 #### 从源码运行
 
@@ -164,11 +164,11 @@ npm run dev
 
 ### 2. 即时通讯软件配置
 
-#### 飞书（推荐）
-
-如果 Chrome 已登录飞书开放平台，也可以让 Codex、Claude 或 Cursor 使用项目内的 [`create-chatccc-feishu-app`](.agents/skills/create-chatccc-feishu-app/SKILL.md) Skill，通过 Chrome DevTools/CDP 自动创建并配置机器人（默认 CDP 端口为 `15166`）。创建应用、开通权限和正式发布属于外部变更，执行前仍需明确确认；不要把 App Secret 写入对话或仓库。
-
-1. 打开 [飞书开放平台](https://open.feishu.cn)，创建一个**企业自建应用**。
+#### 飞书（推荐）
+
+如果 Chrome 已登录飞书开放平台，也可以让 Codex、Claude 或 Cursor 使用项目内的 [`create-chatccc-feishu-app`](.agents/skills/create-chatccc-feishu-app/SKILL.md) Skill，通过 Chrome DevTools/CDP 自动创建并配置机器人（默认 CDP 端口为 `15166`）。创建应用、开通权限和正式发布属于外部变更，执行前仍需明确确认；不要把 App Secret 写入对话或仓库。
+
+1. 打开 [飞书开放平台](https://open.feishu.cn)，创建一个**企业自建应用**。
 2. 在「应用功能」里开启**机器人**能力。
 3. 在「权限管理」里开通 `im:` 和 `cardkit:` 前缀下的相关权限：
 
@@ -208,7 +208,7 @@ chatccc
 
 ### 3. AI 工具配置
 
-Claude Code、Cursor 和 Codex 需要对应的本地工具；CCC Agent 内置于 ChatCCC，只需配置 DeepSeek 兼容 API。
+Claude Code、Cursor 和 Codex 需要对应的本地工具；CCC Agent 内置于 ChatCCC，只需配置 DeepSeek 兼容 API。
 
 #### Claude Code
 
@@ -237,13 +237,13 @@ codex login
 codex --version
 ```
 
-Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理，也可以在 `config.json` 中覆盖。
-
-#### CCC Agent
-
-CCC Agent 是 ChatCCC 内置的编程 Agent，不需要额外安装 CLI。在首次配置向导或 Web 管理页中启用后，填写 DeepSeek 兼容 API Key、Base URL 和模型即可使用；它可以设为 `/new` 的默认 Agent，也可以通过 `/new ccc` 显式创建会话。
-
-`ccc.alternativeModel` 是单个备选模型，只会加入 `/model` 的人工切换列表，不会在请求失败时自动重试或切换，避免重复执行带副作用的工具调用。
+Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理，也可以在 `config.json` 中覆盖。
+
+#### CCC Agent
+
+CCC Agent 是 ChatCCC 内置的编程 Agent，不需要额外安装 CLI。在首次配置向导或 Web 管理页中启用后，填写 DeepSeek 兼容 API Key、Base URL 和模型即可使用；它可以设为 `/new` 的默认 Agent，也可以通过 `/new ccc` 显式创建会话。
+
+`ccc.alternativeModel` 是单个备选模型，只会加入 `/model` 的人工切换列表，不会在请求失败时自动重试或切换，避免重复执行带副作用的工具调用。
 
 #### 可选：Chrome CDP
 
@@ -266,14 +266,14 @@ CCC Agent 是 ChatCCC 内置的编程 Agent，不需要额外安装 CLI。在首
     "appId": "cli_xxxxxxxxxxxx",
     "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxx"
   },
-  "platforms": {
-    "feishu": { "enabled": true, "platformType": "feishu" },
-    "ilink": { "enabled": true, "reuseTokenOnStart": true }
-  },
-  "webUi": {
-    "openOnStart": true
-  },
-  "chromeDevtools": {
+  "platforms": {
+    "feishu": { "enabled": true, "platformType": "feishu" },
+    "ilink": { "enabled": true, "reuseTokenOnStart": true }
+  },
+  "webUi": {
+    "openOnStart": true
+  },
+  "chromeDevtools": {
     "enabled": false,
     "port": 15166,
     "chromePath": ""
@@ -291,32 +291,32 @@ CCC Agent 是 ChatCCC 内置的编程 Agent，不需要额外安装 CLI。在首
     "baseUrl": "",
     "maxTurn": 0
   },
-  "cursor": {
+  "cursor": {
     "enabled": false,
     "defaultAgent": false,
-    "path": "",
-    "model": "",
-    "alternativeModel": "",
-    "avatarBatteryMode": "apiPercent",
+    "path": "",
+    "model": "",
+    "alternativeModel": "",
+    "avatarBatteryMode": "apiPercent",
     "onDemandMonthlyBudget": 1000
   },
-  "codex": {
+  "codex": {
+    "enabled": false,
+    "defaultAgent": false,
+    "path": "",
+    "model": "",
+    "alternativeModel": "",
+    "effort": "",
+    "fastMode": false
+  },
+  "ccc": {
     "enabled": false,
-    "defaultAgent": false,
-    "path": "",
-    "model": "",
-    "alternativeModel": "",
-    "effort": "",
-    "fastMode": false
-  },
-  "ccc": {
-    "enabled": false,
-    "defaultAgent": false,
-    "DEEPSEEK_API_KEY": "",
-    "DEEPSEEK_BASE_URL": "https://api.deepseek.com/v1",
-    "model": "deepseek-v4-pro",
-    "alternativeModel": ""
-  }
+    "defaultAgent": false,
+    "DEEPSEEK_API_KEY": "",
+    "DEEPSEEK_BASE_URL": "https://api.deepseek.com/v1",
+    "model": "deepseek-v4-pro",
+    "alternativeModel": ""
+  }
 }
 ```
 
@@ -325,75 +325,75 @@ CCC Agent 是 ChatCCC 内置的编程 Agent，不需要额外安装 CLI。在首
 | `feishu.appId` / `feishu.appSecret` | 飞书应用凭证 |
 | `platforms.feishu.enabled` | 是否启用飞书 |
 | `platforms.feishu.platformType` | 飞书平台类型，默认 `feishu` |
-| `platforms.ilink.enabled` | 是否启用微信 iLink |
-| `platforms.ilink.reuseTokenOnStart` | 启动时是否复用已有微信登录 token |
-| `webUi.openOnStart` | 直接启动时是否打开系统默认浏览器；默认 true，内部重启始终跳过 |
-| `chromeDevtools.enabled` | 是否启用常驻 Chrome CDP；默认 false |
+| `platforms.ilink.enabled` | 是否启用微信 iLink |
+| `platforms.ilink.reuseTokenOnStart` | 启动时是否复用已有微信登录 token |
+| `webUi.openOnStart` | 直接启动时是否打开系统默认浏览器；默认 true，内部重启始终跳过 |
+| `chromeDevtools.enabled` | 是否启用常驻 Chrome CDP；默认 false |
 | `chromeDevtools.port` | Chrome CDP 端口；默认 15166 |
 | `chromeDevtools.chromePath` | Chrome 可执行文件路径；留空时自动探测 |
 | `port` | 本地 Web 配置面板和中继服务端口 |
 | `gitTimeoutSeconds` | `/git` 命令超时时间，默认 180 秒 |
 | `allowInterrupt` | 是否允许新消息中断正在运行的任务；默认 false |
 | `*.enabled` | 是否启用对应 AI Agent |
-| `*.defaultAgent` | `/new` 未指定 Agent 时使用哪个工具；飞书私聊会在下一条普通消息到达时跟随变化并创建新的空会话 |
-| `cursor.path` / `codex.path` | CLI 可执行文件路径；留空时自动探测或使用 PATH |
-| `codex.fastMode` | Codex Fast 模式的全局默认值；默认 `false`，每次调用都会显式覆盖 Codex CLI 的 service tier |
+| `*.defaultAgent` | `/new` 未指定 Agent 时使用哪个工具；飞书私聊会在下一条普通消息到达时跟随变化并创建新的空会话 |
+| `cursor.path` / `codex.path` | CLI 可执行文件路径；留空时自动探测或使用 PATH |
+| `codex.fastMode` | Codex Fast 模式的全局默认值；默认 `false`，每次调用都会显式覆盖 Codex CLI 的 service tier |
 | `cursor.avatarBatteryMode` | Cursor 头像电量显示来源：`apiPercent` 或 `onDemandUse` |
 | `cursor.onDemandMonthlyBudget` | `avatarBatteryMode=onDemandUse` 时用于计算电量的月预算 |
 | `claude.model` / `claude.subagentModel` / `claude.effort` | 选填；设置后传给 Claude Agent SDK，留空以 `~/.claude/settings.json` 为准 |
 | `claude.apiKey` / `claude.baseUrl` | 选填；设置后传给 Claude Agent SDK，留空以 `~/.claude/settings.json` 为准 |
-| `claude.maxTurn` | 选填；Claude 最大对话轮数，默认 0（无限制），可在 Web UI 编辑 |
-| `cursor.alternativeModel` / `codex.alternativeModel` / `ccc.alternativeModel` | 单个备选模型；加入 `/model` 人工切换列表，不会自动故障转移 |
-| `ccc.DEEPSEEK_API_KEY` / `ccc.DEEPSEEK_BASE_URL` | CCC Agent 使用的 DeepSeek 兼容 API 凭证和服务地址 |
-| `ccc.model` | CCC Agent 默认模型 |
+| `claude.maxTurn` | 选填；Claude 最大对话轮数，默认 0（无限制），可在 Web UI 编辑 |
+| `cursor.alternativeModel` / `codex.alternativeModel` / `ccc.alternativeModel` | 单个备选模型；加入 `/model` 人工切换列表，不会自动故障转移 |
+| `ccc.DEEPSEEK_API_KEY` / `ccc.DEEPSEEK_BASE_URL` | CCC Agent 使用的 DeepSeek 兼容 API 凭证和服务地址 |
+| `ccc.model` | CCC Agent 默认模型 |
 
 > **权限控制**：普通消息以 `bypassPermissions` 模式运行，跳过 Agent 操作确认。使用 `/plan` 或 `/ask` 前缀时，ChatCCC 自动切换为只读模式：Claude SDK 仅放行 Read + stop-stuck-loop 网络请求，Codex 使用 `--sandbox read-only`，Cursor 使用 `--mode plan/ask`。请只在可信环境中使用。
 
 ### 5. 开始使用
 
-**飞书：** 找到机器人后直接发送普通消息，即可在当前私聊中创建并持续使用专属 AI 会话；私聊工作目录固定为运行 ChatCCC 的系统账号用户目录。默认 Agent 发生变化后，下一条私聊普通消息会触发切换并创建新的空会话；若旧 Agent 正在生成，该消息会先排队，待当前回复完成后再切换。命令不会触发自动切换。需要独立任务时，发送 `/new`、`/new claude`、`/new cursor`、`/new codex` 或 `/new ccc`，机器人会另外创建会话群。
+**飞书：** 找到机器人后直接发送普通消息，即可在当前私聊中创建并持续使用专属 AI 会话；私聊工作目录固定为运行 ChatCCC 的系统账号用户目录。默认 Agent 发生变化后，下一条私聊普通消息会触发切换并创建新的空会话；若旧 Agent 正在生成，该消息会先排队，待当前回复完成后再切换。命令不会触发自动切换。需要独立任务时，发送 `/new`、`/new claude`、`/new cursor`、`/new codex` 或 `/new ccc`，机器人会另外创建会话群。
+
+**微信：** 扫码登录后，在机器人私聊里发送 `/new` 或指定 Agent 的 `/new ...` 命令即可开始。功能与飞书基本一致，但展示为纯文本。
+
+**会话停滞保护：** 只有 Agent 明确进入“生成回复中”后，连续 3 分钟没有新增回复字符且尚未报告权威终态，ChatCCC 才判定停滞、结束旧 CLI，并优先补发一次“完成了吗？如果没完成继续”；恢复轮再次发生相同停滞时不再递归续跑。启动、上下文压缩、思考、搜索和工具调用阶段不会触发这项回复停滞计时；其中 CCC Agent 会单独显示“压缩上下文中”，压缩最多等待 5 分钟，失败时直接报告具体原因且不自动重放。`/new claude` 和 `/new cursor` 等创建会话操作仍有独立的 init 超时，进程资源监控也继续负责识别真正僵死。Codex 只有 `turn.completed` 才算权威终态，阶段性的 `agent_message` 不算；任一 Agent 报告权威终态后若输出流仍超过 10 秒未关闭，ChatCCC 会强制清理该 CLI 并按正常完成收尾，不会重复询问 Agent。
 
-**微信：** 扫码登录后，在机器人私聊里发送 `/new` 或指定 Agent 的 `/new ...` 命令即可开始。功能与飞书基本一致，但展示为纯文本。
-
-**会话停滞保护：** 当 Agent 连续 3 分钟停在“正在启动 Agent”且没有任何事件，或停在“正在生成回复”且回复字符数没有变化，同时尚未报告权威终态时，ChatCCC 会结束旧 CLI，并优先补发一次“完成了吗？如果没完成继续”；恢复轮再次发生相同停滞时不再递归续跑。`/new claude` 和 `/new cursor` 在等待底层 init 事件时也使用 3 分钟超时并主动清理 SDK/CLI。思考、搜索和工具调用阶段不按回复字符数误判，由进程资源监控负责识别真正僵死。Codex 只有 `turn.completed` 才算权威终态，阶段性的 `agent_message` 不算；任一 Agent 报告权威终态后若输出流仍超过 10 秒未关闭，ChatCCC 会强制清理该 CLI 并按正常完成收尾，不会重复询问 Agent。
-
-**CCC Agent 代码搜索：** `search_code` 使用项目自带的跨平台 ripgrep，不要求系统另行安装 `rg`。如果当前平台没有可用的 bundled/system ripgrep，会自动降级为内置 Node 搜索，并继续支持常用正则、glob、结果上限、中止和超时控制。
-
-## 可用指令
+**CCC Agent 代码搜索：** `search_code` 使用项目自带的跨平台 ripgrep，不要求系统另行安装 `rg`。如果当前平台没有可用的 bundled/system ripgrep，会自动降级为内置 Node 搜索，并继续支持常用正则、glob、结果上限、中止和超时控制。
+
+## 可用指令
 
 | 指令 | 作用 |
 | --- | --- |
-| `/new` | 使用默认 Agent 创建新会话；飞书中会创建新群 |
-| `/new claude` | 创建 Claude Code 会话；飞书中会创建新群 |
-| `/new cursor` | 创建 Cursor 会话；飞书中会创建新群 |
-| `/new codex` | 创建 Codex 会话；飞书中会创建新群 |
-| `/new ccc` | 创建内置 CCC Agent 会话；飞书中会创建新群 |
-| `/newh` | 在当前聊天原地重置会话；群聊保留工作目录，飞书私聊固定使用系统用户目录 |
-| `/model` | 查看或切换当前会话的模型 |
-| `/fast` | 查看当前 Codex 会话的 Fast 模式；使用 `/fast on` 或 `/fast off` 切换 |
-| `/stop` | 停止当前回复 |
+| `/new` | 使用默认 Agent 创建新会话；飞书中会创建新群 |
+| `/new claude` | 创建 Claude Code 会话；飞书中会创建新群 |
+| `/new cursor` | 创建 Cursor 会话；飞书中会创建新群 |
+| `/new codex` | 创建 Codex 会话；飞书中会创建新群 |
+| `/new ccc` | 创建内置 CCC Agent 会话；飞书中会创建新群 |
+| `/newh` | 在当前聊天原地重置会话；群聊保留工作目录，飞书私聊固定使用系统用户目录 |
+| `/model` | 查看或切换当前会话的模型 |
+| `/fast` | 查看当前 Codex 会话的 Fast 模式；使用 `/fast on` 或 `/fast off` 切换 |
+| `/stop` | 停止当前回复 |
 | `/cancel` | 取消当前会话里排队等待处理的消息 |
 | `/state` | 查看当前会话状态 |
-| `/cd` | 查看或设置后续新建会话的默认工作目录，不改变当前会话；飞书私聊自身始终使用系统用户目录 |
+| `/cd` | 查看或设置后续新建会话的默认工作目录，不改变当前会话；飞书私聊自身始终使用系统用户目录 |
 | `/sessions` | 查看所有会话状态 |
-| `/session <数字>` | 将当前群聊切换到 `/sessions` 列表中的指定会话；飞书私聊不支持切换 |
-| `/usage` | 查看当前会话对应 Agent 的用量；Codex 显示 5h/7天窗口，Cursor 显示当前周期用量，使用官方 DeepSeek API 的 CCC Agent 显示账户余额 |
+| `/session <数字>` | 将当前群聊切换到 `/sessions` 列表中的指定会话；飞书私聊不支持切换 |
+| `/usage` | 查看当前会话对应 Agent 的用量；Codex 显示 5h/7天窗口，Cursor 显示当前周期用量，使用官方 DeepSeek API 的 CCC Agent 显示账户余额 |
 | `/git <子命令>` | 在当前会话工作目录执行 `git ...` 并回传输出 |
 | `/abd<内容>` | 去掉 `/abd` 前缀后把内容发给 Agent，并在消息末尾追加第一性原理需求澄清提示 |
 | `/plan <内容>` | 只读计划模式：仅允许读文件和 stop-stuck-loop 请求，不执行任何写操作 |
 | `/ask <内容>` | 只读问答模式：与 /plan 相同，仅允许读文件和 stop-stuck-loop 请求 |
 | `/restart` | 重启机器人进程 |
-| `/update` | 更新 npm 全局包并重启（仅限 `npm install -g chatccc` 安装的全局进程；同一飞书事件跨重启去重） |
-| `/deleteg` | 解散当前飞书会话群；Agent 会话记录保留 |
-
-`/update` 会在执行 npm 更新前把飞书消息或按钮事件 ID 原子写入 `~/.chatccc/state/update-command-guard.json`。同一 ID 跨重启重投时会静默忽略；用户主动发送的新 `/update` 因事件 ID 不同，仍可立即执行。该保护仅作用于 `/update`，普通消息与 `/restart` 的处理不变。
-
-> **模型切换**：`/model` 查看当前会话 Agent 的可选模型清单，`/model <名称>` 模糊匹配切换，`/model clear` 恢复默认。可选模型来自当前 Agent 的配置：Claude 使用 `claude.model` / `claude.subagentModel`；Cursor、Codex 和 CCC Agent 使用各自的 `model` / `alternativeModel`。
-
-> **Codex Fast 模式**：Web UI 中的“Fast 模式”设置新 Codex 会话的全局默认值，默认关闭。进入 Codex 会话后，`/fast` 查询当前状态，`/fast on` 和 `/fast off` 只覆盖当前会话并从下一条消息生效。ChatCCC 会显式向 Codex CLI 传入 `service_tier="fast"` 或 `service_tier="default"`，因此关闭时不会继承用户 `config.toml` 中可能开启的 Fast。
+| `/update` | 更新 npm 全局包并重启（仅限 `npm install -g chatccc` 安装的全局进程；同一飞书事件跨重启去重） |
+| `/deleteg` | 解散当前飞书会话群；Agent 会话记录保留 |
+
+`/update` 会在执行 npm 更新前把飞书消息或按钮事件 ID 原子写入 `~/.chatccc/state/update-command-guard.json`。同一 ID 跨重启重投时会静默忽略；用户主动发送的新 `/update` 因事件 ID 不同，仍可立即执行。该保护仅作用于 `/update`，普通消息与 `/restart` 的处理不变。
+
+> **模型切换**：`/model` 查看当前会话 Agent 的可选模型清单，`/model <名称>` 模糊匹配切换，`/model clear` 恢复默认。可选模型来自当前 Agent 的配置：Claude 使用 `claude.model` / `claude.subagentModel`；Cursor、Codex 和 CCC Agent 使用各自的 `model` / `alternativeModel`。
+
+> **Codex Fast 模式**：Web UI 中的“Fast 模式”设置新 Codex 会话的全局默认值，默认关闭。进入 Codex 会话后，`/fast` 查询当前状态，`/fast on` 和 `/fast off` 只覆盖当前会话并从下一条消息生效。ChatCCC 会显式向 Codex CLI 传入 `service_tier="fast"` 或 `service_tier="default"`，因此关闭时不会继承用户 `config.toml` 中可能开启的 Fast。
 
 ---
 
 ## 技术栈
 
-TypeScript / Node.js >= 20 / tsx / AI SDK / Anthropic Claude Agent SDK / Cursor Agent CLI / Codex CLI / 飞书 WebSocket API / CardKit / 微信 iLink
+TypeScript / Node.js >= 20 / tsx / AI SDK / Anthropic Claude Agent SDK / Cursor Agent CLI / Codex CLI / 飞书 WebSocket API / CardKit / 微信 iLink

package/agent-prompts/claude_specific.md

@@ -1,46 +1,46 @@
-## 重复成功命令保护
-
-通过 Claude Agent SDK 在本项目中工作时，重复成功的 shell 命令是完成信号，不应继续使用工具。
-
-以下条件**全部**满足时，视为相同命令：
-- 命令文本基本相同
-- 工作目录相同
-- 任务目标未变
-- 没有新的用户输入改变任务
-- 没有新的错误输出需要重新处理
-
-同一命令**连续成功两次**后，停止调用工具，直接给出最终回复。不要"再验证一次"。
-
-此规则适用于所有工具调用。
-
-## 硬停止规则
-
-同一命令在本项目中**不得成功执行三次**。若连续两次成功，第三次必须是最终回复。
-
-## 卡住自检
-
-如果你感觉任务已经完成，但发现自己陷入了循环（反复调用相同工具、输出 "stuck in a loop" 等），**立即**调用以下接口。
-
-**重要：必须用 heredoc 写临时文件再 curl，禁止在命令行参数中直接写中文 JSON。** Windows 下命令行参数传中文会变成 `?` 乱码。
-
-```bash
-cat > /tmp/stop_ccc.json << 'STOPJSON'
-{"session_id": "{{session_id}}", "final_reply": "<你给用户的最终回复，总结已完成的工作和结果>"}
-STOPJSON
-curl -s -X POST {{stop_stuck_url}} -H "Content-Type: application/json" -d @/tmp/stop_ccc.json
-```
-
-final_reply 注意事项：
-- 把 `<...>` 占位符替换为你的实际回复，不要包含双引号 `"` 和反斜杠 `\`
-- 不要包含换行，用空格代替
-- 保持简短（1-2 句话）
-
-调用后停止所有工具调用，直接输出最终回复即可。
-
-## 禁止 PushNotification
-
-**不要调用 PushNotification 工具。** 如果你认为当前会话已经完成任务需要结束，直接调用上述 stop-stuck-loop 接口，不要使用 PushNotification。
-
-## 计划/问答模式权限规则
-
+## 重复成功命令保护
+
+通过 Claude Agent SDK 在本项目中工作时，重复成功的 shell 命令是完成信号，不应继续使用工具。
+
+以下条件**全部**满足时，视为相同命令：
+- 命令文本基本相同
+- 工作目录相同
+- 任务目标未变
+- 没有新的用户输入改变任务
+- 没有新的错误输出需要重新处理
+
+同一命令**连续成功两次**后，停止调用工具，直接给出最终回复。不要"再验证一次"。
+
+此规则适用于所有工具调用。
+
+## 硬停止规则
+
+同一命令在本项目中**不得成功执行三次**。若连续两次成功，第三次必须是最终回复。
+
+## 卡住自检
+
+如果你感觉任务已经完成，但发现自己陷入了循环（反复调用相同工具、输出 "stuck in a loop" 等），**立即**调用以下接口。
+
+**重要：必须用 heredoc 写临时文件再 curl，禁止在命令行参数中直接写中文 JSON。** Windows 下命令行参数传中文会变成 `?` 乱码。
+
+```bash
+cat > /tmp/stop_ccc.json << 'STOPJSON'
+{"session_id": "{{session_id}}", "final_reply": "<你给用户的最终回复，总结已完成的工作和结果>"}
+STOPJSON
+curl -s -X POST {{stop_stuck_url}} -H "Content-Type: application/json" -d @/tmp/stop_ccc.json
+```
+
+final_reply 注意事项：
+- 把 `<...>` 占位符替换为你的实际回复，不要包含双引号 `"` 和反斜杠 `\`
+- 不要包含换行，用空格代替
+- 保持简短（1-2 句话）
+
+调用后停止所有工具调用，直接输出最终回复即可。
+
+## 禁止 PushNotification
+
+**不要调用 PushNotification 工具。** 如果你认为当前会话已经完成任务需要结束，直接调用上述 stop-stuck-loop 接口，不要使用 PushNotification。
+
+## 计划/问答模式权限规则
+
 如果用户消息以 `/plan` 或 `/ask` 开头，说明当前处于只读模式。**遇到任何需要用户同意的权限请求时，不要向用户申请权限，立即调用 stop-stuck-loop 接口提前结束本轮会话。**

package/agent-prompts/codex_specific.md

@@ -1,3 +1,3 @@
-## 计划/问答模式权限规则
-
+## 计划/问答模式权限规则
+
 如果用户消息以 `/plan` 或 `/ask` 开头，说明当前处于只读模式。**遇到任何需要用户同意的权限请求时，不要向用户申请权限，立即调用 stop-stuck-loop 接口提前结束本轮会话。**

package/agent-prompts/cursor_specific.md

@@ -1,14 +1,14 @@
-## 计划/问答模式权限规则
-
-如果用户消息以 `/plan` 或 `/ask` 开头，说明当前处于只读模式。**遇到任何需要用户同意的权限请求时，不要向用户申请权限，立即调用 stop-stuck-loop 接口提前结束本轮会话。**
-
-## 用户问题澄清规则
-
-当需要在开始实现前向用户确认问题、让用户做选择，或用户要求“从第一性原理出发挖掘真实需求 / 判断需求是否合理 / 开始实现前有什么问题要问我”时，**不要调用 `AskQuestion`、多选表单或任何结构化选择工具**。
-
-必须直接用普通文本回复用户：
-
-- 先简要说明你理解到的真实需求和你对合理性的判断。
-- 再列出需要用户确认的问题；如果有推荐选项，就用文本说明“我建议 X，原因是 Y”。
-- 问题数量尽量少，只问会影响实现边界、风险或不可逆决策的问题。
+## 计划/问答模式权限规则
+
+如果用户消息以 `/plan` 或 `/ask` 开头，说明当前处于只读模式。**遇到任何需要用户同意的权限请求时，不要向用户申请权限，立即调用 stop-stuck-loop 接口提前结束本轮会话。**
+
+## 用户问题澄清规则
+
+当需要在开始实现前向用户确认问题、让用户做选择，或用户要求“从第一性原理出发挖掘真实需求 / 判断需求是否合理 / 开始实现前有什么问题要问我”时，**不要调用 `AskQuestion`、多选表单或任何结构化选择工具**。
+
+必须直接用普通文本回复用户：
+
+- 先简要说明你理解到的真实需求和你对合理性的判断。
+- 再列出需要用户确认的问题；如果有推荐选项，就用文本说明“我建议 X，原因是 Y”。
+- 问题数量尽量少，只问会影响实现边界、风险或不可逆决策的问题。
 - 不要把这些问题放进工具调用参数里，也不要只在卡片/工具结果中呈现。

package/bin/cccagent.mjs

@@ -1,17 +1,17 @@
-#!/usr/bin/env node
-import { spawnSync } from "node:child_process";
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
-
-const require = createRequire(import.meta.url);
-const pkgRoot = dirname(require.resolve("../package.json"));
-const cliTs = join(pkgRoot, "src", "builtin", "cli.ts");
-const tsxCli = require.resolve("tsx/cli");
-
-const result = spawnSync(process.execPath, [tsxCli, cliTs, ...process.argv.slice(2)], {
-  stdio: "inherit",
-  cwd: process.cwd(),
-  env: process.env,
-});
-
-process.exit(result.status === null ? 1 : result.status);
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+
+const require = createRequire(import.meta.url);
+const pkgRoot = dirname(require.resolve("../package.json"));
+const cliTs = join(pkgRoot, "src", "builtin", "cli.ts");
+const tsxCli = require.resolve("tsx/cli");
+
+const result = spawnSync(process.execPath, [tsxCli, cliTs, ...process.argv.slice(2)], {
+  stdio: "inherit",
+  cwd: process.cwd(),
+  env: process.env,
+});
+
+process.exit(result.status === null ? 1 : result.status);

package/im-skills/feishu-skill/receive-send-file.md

@@ -1,64 +1,64 @@
-# Sending & Downloading Files/Videos
-
-## Send Files or Videos
-
-Videos are sent as regular files (not media), which looks cleaner in Feishu.
-
-**Use the node script below. Do NOT use curl or raw HTTP — the script correctly handles errors and exits non-zero on failure.**
-
-### Script
-
-```bash
-node "{{send_file_script}}" --url "{{send_file_url}}" --session-id "{{session_id}}" --path "<absolute file path>" --caption "<optional caption>"
-```
-
-### Rules
-
-- Use the node script above — never curl or raw HTTP.
-- Save or choose a local file first.
-- Use an absolute local path.
-- Max file size: 30MB.
-- Supported formats: .mp4 .mov .avi .mkv .webm .flv .mp3 .wav .ogg .aac .m4a .pdf .doc .docx .xls .xlsx .csv .ppt .pptx .txt .zip .tar .gz.
-- Only send a file/video when the user asked for one or when it materially helps the answer.
-- **If the script fails (non-zero exit), read stderr for the error. Do NOT retry with the same path. Either fix the problem (wrong extension, missing file, etc.) or tell the user what the error was. Never retry more than once.**
-
-### Video Compression (when file > 30MB)
-
-If the video exceeds 30MB, compress it with ffmpeg before sending.
-
-**Ensure ffmpeg is available** (install if missing):
-
-| OS | Install command |
-|----|----------------|
-| macOS | `brew install ffmpeg` |
-| Linux (Debian/Ubuntu) | `sudo apt install ffmpeg` |
-| Linux (RHEL/Fedora) | `sudo dnf install ffmpeg` |
-| Windows | `winget install Gyan.FFmpeg` |
-
-**Two-pass compression** (target ~28MB for 30s video, adjust `b:v` for other durations):
-
-```bash
-ffmpeg -y -i "<input>" -c:v libx264 -b:v <bitrate>k -pass 1 -f mp4 NUL
-ffmpeg -y -i "<input>" -c:v libx264 -b:v <bitrate>k -pass 2 -c:a aac -b:a 128k "<output>"
-```
-
-Bitrate formula: `bitrate = 28 × 8 × 1000 ÷ duration_seconds - 128` (target ~28MB, safe under 30MB).
-On Windows replace `NUL` with `NUL` (same); on Linux/macOS use `/dev/null`.
-
-If the compressed file still exceeds 30MB, explain to the user that automatic compression wasn't enough and suggest they manually trim or re-encode the source.
-
-## Download Files or Videos
-
-When the user sends a file or video to the bot, the message contains `message_id` and `file_key`. Download it with:
-
-```bash
-node "{{download_video_script}}" --message-id <message_id> --file-key <file_key> --name <file_name>
-```
-
-If only `chat_id` and `file_key` are available:
-
-```bash
-node "{{download_video_script}}" --chat-id <chat_id> --file-key <file_key> --name <file_name>
-```
-
+# Sending & Downloading Files/Videos
+
+## Send Files or Videos
+
+Videos are sent as regular files (not media), which looks cleaner in Feishu.
+
+**Use the node script below. Do NOT use curl or raw HTTP — the script correctly handles errors and exits non-zero on failure.**
+
+### Script
+
+```bash
+node "{{send_file_script}}" --url "{{send_file_url}}" --session-id "{{session_id}}" --path "<absolute file path>" --caption "<optional caption>"
+```
+
+### Rules
+
+- Use the node script above — never curl or raw HTTP.
+- Save or choose a local file first.
+- Use an absolute local path.
+- Max file size: 30MB.
+- Supported formats: .mp4 .mov .avi .mkv .webm .flv .mp3 .wav .ogg .aac .m4a .pdf .doc .docx .xls .xlsx .csv .ppt .pptx .txt .zip .tar .gz.
+- Only send a file/video when the user asked for one or when it materially helps the answer.
+- **If the script fails (non-zero exit), read stderr for the error. Do NOT retry with the same path. Either fix the problem (wrong extension, missing file, etc.) or tell the user what the error was. Never retry more than once.**
+
+### Video Compression (when file > 30MB)
+
+If the video exceeds 30MB, compress it with ffmpeg before sending.
+
+**Ensure ffmpeg is available** (install if missing):
+
+| OS | Install command |
+|----|----------------|
+| macOS | `brew install ffmpeg` |
+| Linux (Debian/Ubuntu) | `sudo apt install ffmpeg` |
+| Linux (RHEL/Fedora) | `sudo dnf install ffmpeg` |
+| Windows | `winget install Gyan.FFmpeg` |
+
+**Two-pass compression** (target ~28MB for 30s video, adjust `b:v` for other durations):
+
+```bash
+ffmpeg -y -i "<input>" -c:v libx264 -b:v <bitrate>k -pass 1 -f mp4 NUL
+ffmpeg -y -i "<input>" -c:v libx264 -b:v <bitrate>k -pass 2 -c:a aac -b:a 128k "<output>"
+```
+
+Bitrate formula: `bitrate = 28 × 8 × 1000 ÷ duration_seconds - 128` (target ~28MB, safe under 30MB).
+On Windows replace `NUL` with `NUL` (same); on Linux/macOS use `/dev/null`.
+
+If the compressed file still exceeds 30MB, explain to the user that automatic compression wasn't enough and suggest they manually trim or re-encode the source.
+
+## Download Files or Videos
+
+When the user sends a file or video to the bot, the message contains `message_id` and `file_key`. Download it with:
+
+```bash
+node "{{download_video_script}}" --message-id <message_id> --file-key <file_key> --name <file_name>
+```
+
+If only `chat_id` and `file_key` are available:
+
+```bash
+node "{{download_video_script}}" --chat-id <chat_id> --file-key <file_key> --name <file_name>
+```
+
 Downloads are saved under `~/.chatccc/videos/downloads/`.