chatccc 0.2.261 → 0.2.263

package/README.md

@@ -1,8 +1,8 @@
 # ChatCCC
 
-**用飞书或微信聊天控制 Claude Code / Cursor / Codex / CCC Agent / DeepSeek Harness。**
+**用飞书或微信聊天控制 Claude Code / Cursor / Codex / CCC Agent / DeepSeek Harness。**
 
-ChatCCC 把本地 AI 编程工具接入即时通讯软件。你可以在手机上发消息，让 Claude Code、Cursor Agent、Codex、内置 CCC Agent 或 DeepSeek Harness 继续写代码、查问题、跑命令；不用一直守在电脑前。
+ChatCCC 把本地 AI 编程工具接入即时通讯软件。你可以在手机上发消息，让 Claude Code、Cursor Agent、Codex、内置 CCC Agent 或 DeepSeek Harness 继续写代码、查问题、跑命令；不用一直守在电脑前。
 
 飞书是推荐入口：直接私聊机器人即可持续使用同一个专属会话，需要并行任务时再用 `/new` 创建独立会话群；卡片能流式更新，体验完整。微信 iLink 更适合快速试用或临时使用：扫码即可接入，但只能走私聊文本模式。
 
@@ -21,7 +21,7 @@ ChatCCC 把本地 AI 编程工具接入即时通讯软件。你可以在手机
 - **手机上也能用 AI 编程工具**：在飞书或微信发消息，就像在终端给 Agent 下指令。
 - **飞书体验更完整**：私聊可持续对话，`/new` 创建的一群一会话支持多任务并行，CardKit 卡片可流式更新。
 - **微信接入更轻**：不用创建飞书应用，启动后扫码即可在微信私聊里使用。
-- **多 Agent 切换**：`/new` 使用默认 Agent，也可以用 `/new claude`、`/new cursor`、`/new codex`、`/new ccc`、`/new dsh` 指定工具。
+- **多 Agent 切换**：`/new` 使用默认 Agent，也可以用 `/new claude`、`/new cursor`、`/new codex`、`/new ccc`、`/new dsh` 指定工具。
 - **群里能跑 git**：`/git status`、`/git pull`、`/git log` 会在当前会话工作目录执行，并把输出发回聊天窗口。
 
 ## 飞书和微信的差异
@@ -216,7 +216,7 @@ chatccc
 
 ### 3. AI 工具配置
 
-Claude Code、Cursor 和 Codex 需要对应的本地工具；CCC Agent 内置于 ChatCCC，开箱即用，**模型接入不限于 DeepSeek**——它支持 OpenAI-compatible 和 Anthropic Messages 两种协议（详见下文 CCC Agent）。DeepSeek Harness（DSH）采用按需安装，不计入 ChatCCC 主包生产依赖。
+Claude Code、Cursor 和 Codex 需要对应的本地工具；CCC Agent 内置于 ChatCCC，开箱即用，**模型接入不限于 DeepSeek**——它支持 OpenAI-compatible 和 Anthropic Messages 两种协议（详见下文 CCC Agent）。DeepSeek Harness（DSH）采用按需安装，不计入 ChatCCC 主包生产依赖。
 
 #### CCC Agent
 
@@ -242,15 +242,15 @@ ChatCCC 会把 `ccc.DEEPSEEK_API_KEY`、`ccc.DEEPSEEK_BASE_URL`、模型和 effo
 
 #### Claude Code
 
-ChatCCC 通过 Anthropic Claude Agent SDK 调用 Claude Code 能力。SDK 引擎（含 Claude Code CLI 原生二进制，约 220MB）**按需下载**：在首次配置向导或 Web 管理页打开 Claude Code 开关，或点击一次安装按钮，页面会连续显示环境检查、下载、校验、Runtime 验证、原子切换和清理进度，不需要逐步确认。**只有启用 Claude Code 的用户才需要下载**，不使用 Claude Code 的安装不包含该引擎，chatccc 主包体积保持精简。
+ChatCCC 通过 Anthropic Claude Agent SDK 调用 Claude Code 能力。SDK 引擎（含 Claude Code CLI 原生二进制，约 220MB）**按需下载**：在首次配置向导或 Web 管理页打开 Claude Code 开关，或点击一次安装按钮，页面会连续显示环境检查、下载、校验、Runtime 验证、原子切换和清理进度，不需要逐步确认。**只有启用 Claude Code 的用户才需要下载**，不使用 Claude Code 的安装不包含该引擎，chatccc 主包体积保持精简。
 
-SDK 始终使用其内置的 Claude Code CLI（档位 b），不依赖用户自行安装的 `claude` 命令。本机完成 Claude Code 登录后即可使用（SDK 复用 `~/.claude` 登录态）；同时支持官方和第三方 Anthropic 兼容 API：使用官方服务无需额外配置，使用第三方 API 则填写 `claude.apiKey` 和 `claude.baseUrl`。`claude.model`、`claude.subagentModel`、`claude.effort`、`claude.apiKey`、`claude.baseUrl` 均为选填；`claude.maxTurn` 控制每次对话的最大轮数（默认 0，即无限制）。填写后会把对应配置传给 Claude Agent SDK；留空则以 `~/.claude/settings.json` 为准。
-
-#### DeepSeek Harness
-
-DeepSeek Harness 是可选 Agent。在首次配置向导或 Web 管理页打开 DSH 开关，ChatCCC 会一次点击完成环境检查、临时目录准备、精确版本下载、包校验、Runtime 握手、原子切换和旧版本清理，并在页面逐步显示进度。安装失败时不会替换当前可用版本；刷新页面后仍可恢复安装进度。当前固定安装 `0.1.0-rc.6`，要求 Node.js >= 22.19.0。
-
-DSH 引擎安装在 `~/.chatccc/engines/dsh/`，不加入 ChatCCC 的 `dependencies`。配置 `dsh.apiKey`、`dsh.baseUrl`、`dsh.model`、`dsh.provider` 和 `dsh.maxTokens` 后，可设为默认 Agent 或使用 `/new dsh` 新建会话。安装验证只做本地 JSON-RPC Runtime 握手，不会调用付费模型。
+SDK 始终使用其内置的 Claude Code CLI（档位 b），不依赖用户自行安装的 `claude` 命令。本机完成 Claude Code 登录后即可使用（SDK 复用 `~/.claude` 登录态）；同时支持官方和第三方 Anthropic 兼容 API：使用官方服务无需额外配置，使用第三方 API 则填写 `claude.apiKey` 和 `claude.baseUrl`。`claude.model`、`claude.subagentModel`、`claude.effort`、`claude.apiKey`、`claude.baseUrl` 均为选填；`claude.maxTurn` 控制每次对话的最大轮数（默认 0，即无限制）。填写后会把对应配置传给 Claude Agent SDK；留空则以 `~/.claude/settings.json` 为准。
+
+#### DeepSeek Harness
+
+DeepSeek Harness 是可选 Agent。在首次配置向导或 Web 管理页打开 DSH 开关，ChatCCC 会一次点击完成环境检查、临时目录准备、精确版本下载、包校验、Runtime 握手、原子切换和旧版本清理，并在页面逐步显示进度。安装失败时不会替换当前可用版本；刷新页面后仍可恢复安装进度。当前固定安装 `0.1.0-rc.6`，要求 Node.js >= 22.19.0。
+
+DSH 引擎安装在 `~/.chatccc/engines/dsh/`，不加入 ChatCCC 的 `dependencies`。配置 `dsh.apiKey`、`dsh.baseUrl`、`dsh.model`、`dsh.provider` 和 `dsh.maxTokens` 后，可设为默认 Agent 或使用 `/new dsh` 新建会话。安装验证只做本地 JSON-RPC Runtime 握手，不会调用付费模型。
 
 #### Cursor Agent CLI
 
@@ -375,20 +375,21 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | `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` 人工切换列表，不会自动故障转移 |
+| `cursor.alternativeModel` / `codex.alternativeModel` / `ccc.alternativeModel` / `dsh.alternativeModel` | 单个备选模型；加入 `/model` 人工切换列表，不会自动故障转移 |
 | `ccc.DEEPSEEK_API_KEY` / `ccc.DEEPSEEK_BASE_URL` | CCC Agent 的 API Key 和服务地址；**不限于 DeepSeek**——可填任意 OpenAI 兼容端点（OpenAI、Kimi、通义、智谱、Ollama 本地等） |
 | `ccc.model` | CCC Agent 默认模型 |
 | `ccc.subModel` | CCC Agent 子模型（选填）：用于内部轻量环节（压缩摘要生成、task 子代理任务）；留空跟随主模型 |
 | `ccc.compactionTimeoutMs` | CCC Agent 上下文压缩单轮超时（毫秒），默认 300000（5 分钟）；压缩超时会让整轮对话失败，建议保持默认或调大 |
-| `ccc.contextWindow` | CCC Agent 模型上下文窗口（token），默认 1048576（1M，DeepSeek V4 Pro/Flash 原生规格）；压缩阈值自动 = 窗口 × 80%；超过模型/服务端实际上限会被 API 拒绝，可在 Web UI 下拉选择或自定义（单位 k） |
-| `dsh.apiKey` / `dsh.baseUrl` | DeepSeek Harness 的 API Key 和官方 DeepSeek 服务地址 |
-| `dsh.model` / `dsh.provider` / `dsh.maxTokens` | DSH 默认模型、Runtime provider 和最大 token 数 |
+| `ccc.contextWindow` | CCC Agent 模型上下文窗口（token），默认 1048576（1M，DeepSeek V4 Pro/Flash 原生规格）；压缩阈值自动 = 窗口 × 80%；超过模型/服务端实际上限会被 API 拒绝，可在 Web UI 下拉选择或自定义（单位 k） |
+| `dsh.apiKey` / `dsh.baseUrl` | DeepSeek Harness 的 API Key 和官方 DeepSeek 服务地址 |
+| `dsh.model` / `dsh.provider` / `dsh.maxTokens` | DSH 默认模型、Runtime provider 和最大 token 数 |
+| `dsh.subModel` | DSH 子代理模型（选填）：用于 `subagent` 工具派生的子代理；留空跟随主模型（与 `ccc.subModel` 语义一致） |
 
 > **权限控制**：普通消息以 `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` 或 `/new dsh`，机器人会另外创建会话群。
+**飞书：** 找到机器人后直接发送普通消息，即可在当前私聊中创建并持续使用专属 AI 会话；私聊工作目录固定为运行 ChatCCC 的系统账号用户目录。默认 Agent 发生变化后，下一条私聊普通消息会触发切换并创建新的空会话；若旧 Agent 正在生成，该消息会先排队，待当前回复完成后再切换。命令不会触发自动切换。需要独立任务时，发送 `/new`、`/new claude`、`/new cursor`、`/new codex`、`/new ccc` 或 `/new dsh`，机器人会另外创建会话群。
 
 **微信：** 扫码登录后，在机器人私聊里发送 `/new` 或指定 Agent 的 `/new ...` 命令即可开始。功能与飞书基本一致，但展示为纯文本。
 
@@ -404,8 +405,8 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | `/new claude` | 创建 Claude Code 会话；飞书中会创建新群 |
 | `/new cursor` | 创建 Cursor 会话；飞书中会创建新群 |
 | `/new codex` | 创建 Codex 会话；飞书中会创建新群 |
-| `/new ccc` | 创建内置 CCC Agent 会话；飞书中会创建新群 |
-| `/new dsh` | 创建 DeepSeek Harness 会话；飞书中会创建新群 |
+| `/new ccc` | 创建内置 CCC Agent 会话；飞书中会创建新群 |
+| `/new dsh` | 创建 DeepSeek Harness 会话；飞书中会创建新群 |
 | `/forget` | 在当前聊天原地重置会话（忘掉上下文）；群聊保留工作目录，飞书私聊固定使用系统用户目录 |
 | `/model` | 查看或切换当前会话的模型 |
 | `/fast` | 查看当前 Codex 会话的 Fast 模式；使用 `/fast on` 或 `/fast off` 切换 |
@@ -415,7 +416,7 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | `/cd` | 查看或设置后续新建会话的默认工作目录，不改变当前会话；飞书私聊自身始终使用系统用户目录 |
 | `/sessions` | 查看所有会话状态 |
 | `/session <数字>` | 将当前群聊切换到 `/sessions` 列表中的指定会话；飞书私聊不支持切换 |
-| `/usage` | 查看当前会话对应 Agent 的用量；Codex 显示 5h/7天窗口，Cursor 显示当前周期用量，CCC Agent 和 DSH 仅在官方 DeepSeek 端点时显示账户余额（其他兼容端点自动跳过） |
+| `/usage` | 查看当前会话对应 Agent 的用量；Codex 显示 5h/7天窗口，Cursor 显示当前周期用量，CCC Agent 和 DSH 仅在官方 DeepSeek 端点时显示账户余额（其他兼容端点自动跳过） |
 | `/git <子命令>` | 在当前会话工作目录执行 `git ...` 并回传输出 |
 | `/abd<内容>` | 去掉 `/abd` 前缀后把内容发给 Agent，并在消息末尾追加第一性原理需求澄清提示 |
 | `/plan <内容>` | 只读计划模式：仅允许读文件和 stop-stuck-loop 请求，不执行任何写操作 |
@@ -426,7 +427,7 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 
 `/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`。
+> **模型切换**：`/model` 查看当前会话 Agent 的可选模型清单，`/model <名称>` 模糊匹配切换，`/model clear` 恢复默认。可选模型来自当前 Agent 的配置：Claude 使用 `claude.model` / `claude.subagentModel`；Cursor、Codex、CCC Agent 和 DSH 使用各自的 `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。
 
@@ -434,4 +435,4 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 
 ## 技术栈
 
-TypeScript（发布前编译为 JavaScript，tsx 仅用于开发）/ Node.js >= 20 / AI SDK / Anthropic Claude Agent SDK（按需下载）/ DeepSeek Harness SDK + JSON-RPC Runtime（按需下载，要求 Node.js >= 22.19.0）/ Cursor Agent CLI / Codex CLI / 飞书 WebSocket API / CardKit / 微信 iLink
+TypeScript（发布前编译为 JavaScript，tsx 仅用于开发）/ Node.js >= 20 / AI SDK / Anthropic Claude Agent SDK（按需下载）/ DeepSeek Harness SDK + JSON-RPC Runtime（按需下载，要求 Node.js >= 22.19.0）/ Cursor Agent CLI / Codex CLI / 飞书 WebSocket API / CardKit / 微信 iLink

package/config.sample.json

@@ -37,20 +37,20 @@
       "retentionDays": 7,
       "keepCompleted": false
     },
-    "ccc": {
-      "enabled": false,
-      "maxBytesPerTurn": 52428800,
-      "retentionDays": 7,
-      "keepCompleted": false
-    },
-    "dsh": {
-      "enabled": false,
-      "maxBytesPerTurn": 52428800,
-      "retentionDays": 7,
-      "keepCompleted": false
+    "ccc": {
+      "enabled": false,
+      "maxBytesPerTurn": 52428800,
+      "retentionDays": 7,
+      "keepCompleted": false
+    },
+    "dsh": {
+      "enabled": false,
+      "maxBytesPerTurn": 52428800,
+      "retentionDays": 7,
+      "keepCompleted": false
     }
   },
-  "ccc": {
+  "ccc": {
     "enabled": false,
     "defaultAgent": false,
     "DEEPSEEK_API_KEY": "",
@@ -61,17 +61,19 @@
     "effort": "",
     "provider": "",
     "compactionTimeoutMs": 300000,
-    "contextWindow": 1048576
-  },
-  "dsh": {
-    "enabled": false,
-    "defaultAgent": false,
-    "apiKey": "",
-    "baseUrl": "https://api.deepseek.com/v1",
-    "model": "deepseek-v4-flash",
-    "provider": "deepseek-official",
-    "maxTokens": 49152
-  },
+    "contextWindow": 1048576
+  },
+  "dsh": {
+    "enabled": false,
+    "defaultAgent": false,
+    "apiKey": "",
+    "baseUrl": "https://api.deepseek.com/v1",
+    "model": "deepseek-v4-flash",
+    "subModel": "",
+    "alternativeModel": "",
+    "provider": "deepseek-official",
+    "maxTokens": 49152
+  },
   "claude": {
     "enabled": false,
     "defaultAgent": true,

package/dist/src/adapters/dsh-adapter.js

@@ -50,6 +50,10 @@ export function createDshAdapter(options = {}) {
                         DSH_SESSION_ROOT: sessionRoot,
                         ...(options.apiKey ? { DEEPSEEK_API_KEY: options.apiKey } : {}),
                         ...(options.baseUrl ? { DEEPSEEK_BASE_URL: options.baseUrl } : {}),
+                        // 子代理模型：subModel 留空时跟随主模型（与 CCC 的 ccc.subModel 语义一致）
+                        DSH_SUBAGENT_PROVIDER: options.provider ?? "deepseek-official",
+                        DSH_SUBAGENT_MODEL: options.subModel || options.model || "deepseek-v4-flash",
+                        DSH_SUBAGENT_MAX_TOKENS: String(options.maxTokens ?? 49152),
                     },
                 },
                 cwd,

package/dist/src/config.js

@@ -60,6 +60,7 @@ export function getAllModelsForTool(tool, cfg = config) {
     }
     else if (tool === "dsh") {
         collect(cfg.dsh.model);
+        collect(cfg.dsh.alternativeModel);
     }
     return Array.from(seen).slice(0, 100);
 }
@@ -326,6 +327,8 @@ function loadConfig() {
             apiKey: "",
             baseUrl: DEFAULT_CCC_DEEPSEEK_BASE_URL,
             model: "deepseek-v4-flash",
+            subModel: "",
+            alternativeModel: "",
             provider: "deepseek-official",
             maxTokens: 49152,
         },
@@ -533,6 +536,8 @@ function loadConfig() {
             apiKey: normalizeOptionalConfigField(dshRaw.apiKey, { label: "dsh.apiKey" }),
             baseUrl: normalizeOptionalConfigField(dshRaw.baseUrl, { label: "dsh.baseUrl", fallback: DEFAULT_CCC_DEEPSEEK_BASE_URL }),
             model: normalizeOptionalConfigField(dshRaw.model, { label: "dsh.model", fallback: "deepseek-v4-flash" }),
+            subModel: normalizeOptionalConfigField(dshRaw.subModel, { label: "dsh.subModel" }),
+            alternativeModel: normalizeOptionalConfigField(dshRaw.alternativeModel, { label: "dsh.alternativeModel" }),
             provider: normalizeOptionalConfigField(dshRaw.provider, { label: "dsh.provider", fallback: "deepseek-official" }),
             maxTokens: normalizePositiveInteger(dshRaw.maxTokens, 49152),
         },

package/dist/src/engines/engine-specs.js

@@ -83,6 +83,10 @@ export const DSH_RUNTIME_CONFIG = `# Generated and owned by ChatCCC. Secrets are
     provider: spawn
     toolName: subagent
     enableRunInBackground: false
+    agentOptions:
+      provider: !!js process.env.DSH_SUBAGENT_PROVIDER ?? 'deepseek-official'
+      model: !!js process.env.DSH_SUBAGENT_MODEL ?? 'deepseek-v4-flash'
+      maxTokens: !!js Number(process.env.DSH_SUBAGENT_MAX_TOKENS ?? '49152')
 - id: tool-todo
   name: '@deepseek-ai/dsh-tool-todo'
   config:

package/dist/src/feishu-api.js

@@ -240,6 +240,7 @@ const AVATAR_BADGES = {
     claude: resolvePath(AVATAR_BADGE_DIR, "badge_claude.png"),
     cursor: resolvePath(AVATAR_BADGE_DIR, "badge_cursor.png"),
     codex: resolvePath(AVATAR_BADGE_DIR, "badge_codex.png"),
+    dsh: resolvePath(AVATAR_BADGE_DIR, "badge_dsh.png"),
 };
 const AVATAR_SIZE = 256;
 const AVATAR_BADGE_SIZE = 92;

package/dist/src/session.js

@@ -544,6 +544,7 @@ export function getAdapterForTool(tool, sessionId) {
             apiKey: config.dsh.apiKey,
             baseUrl: config.dsh.baseUrl,
             model: effectiveModel || config.dsh.model,
+            ...(config.dsh.subModel ? { subModel: config.dsh.subModel } : {}),
             provider: config.dsh.provider,
             maxTokens: config.dsh.maxTokens,
         });

package/dist/src/web-ui.js

@@ -523,6 +523,14 @@ export function unflattenConfig(flat) {
             result.dsh = result.dsh || {};
             result.dsh.model = val;
         }
+        else if (key === "CHATCCC_DSH_SUB_MODEL") {
+            result.dsh = result.dsh || {};
+            result.dsh.subModel = val;
+        }
+        else if (key === "CHATCCC_DSH_ALTERNATIVE_MODEL") {
+            result.dsh = result.dsh || {};
+            result.dsh.alternativeModel = val;
+        }
         else if (key === "CHATCCC_DSH_PROVIDER") {
             result.dsh = result.dsh || {};
             result.dsh.provider = val;
@@ -697,12 +705,12 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
 .btn-danger:hover{background:#dc2626}
 .btn-success{background:#16a34a;color:#fff}
 .btn-success:hover{background:#15803d}
-.btn:disabled{opacity:.5;cursor:not-allowed}
-.engine-status{font-size:13px;color:#64748b;margin-bottom:8px}
-.engine-steps{display:grid;gap:5px;margin:8px 0 10px}
-.engine-step{display:grid;grid-template-columns:18px 1fr auto;gap:7px;align-items:center;padding:5px 7px;border-radius:7px;background:#f8fafc;font-size:12px;color:#64748b}
-.engine-step.running{background:#eff6ff;color:#1d4ed8}.engine-step.completed{color:#15803d}.engine-step.failed{background:#fef2f2;color:#dc2626}
-.engine-step-icon{font-weight:700;text-align:center}.engine-step-percent{font-variant-numeric:tabular-nums;color:inherit}
+.btn:disabled{opacity:.5;cursor:not-allowed}
+.engine-status{font-size:13px;color:#64748b;margin-bottom:8px}
+.engine-steps{display:grid;gap:5px;margin:8px 0 10px}
+.engine-step{display:grid;grid-template-columns:18px 1fr auto;gap:7px;align-items:center;padding:5px 7px;border-radius:7px;background:#f8fafc;font-size:12px;color:#64748b}
+.engine-step.running{background:#eff6ff;color:#1d4ed8}.engine-step.completed{color:#15803d}.engine-step.failed{background:#fef2f2;color:#dc2626}
+.engine-step-icon{font-weight:700;text-align:center}.engine-step-percent{font-variant-numeric:tabular-nums;color:inherit}
 .btn-group{display:flex;gap:8px;flex-wrap:wrap}
 .agent-cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:12px;margin-bottom:16px}
 .agent-card{min-width:0}
@@ -933,41 +941,43 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
               <div class="hint">压缩阈值自动 = 窗口 × 80%（超出即把较早消息压缩为摘要）。⚠️ 超过模型/服务端实际上限时请求会被 API 直接拒绝（context length exceeded）；实际窗口以模型与所用服务端为准（如 litellm 代理的 max_input_tokens）。</div>
             </div>
           </fieldset>
-        </div>
-
-        <!-- DeepSeek Harness 卡片 -->
-        <div class="agent-card" id="agent-card-dsh">
-          <div class="agent-card-header">
-            <input type="checkbox" class="agent-toggle" id="agent-enable-dsh" onchange="onInstallableAgentToggle('dsh', this)">
-            <div class="meta">
-              <div class="name">DeepSeek Harness</div>
-              <div class="desc">DeepSeek 官方 Agent Harness<br>按需安装，独立于 CCC Agent</div>
-            </div>
-          </div>
-          <label class="agent-default-row">
-            <input type="checkbox" id="agent-default-dsh" onchange="onDefaultAgentToggle('dsh', this.checked)">
-            设为默认 Agent
-          </label>
-          <fieldset class="agent-body" id="agent-body-dsh" disabled>
-            <div class="form-group"><label>API Key</label><input type="password" id="field-CHATCCC_DSH_API_KEY" placeholder="DeepSeek API Key"></div>
-            <div class="form-group"><label>Base URL</label><input type="text" id="field-CHATCCC_DSH_BASE_URL" placeholder="https://api.deepseek.com/v1"></div>
-            <div class="form-group"><label>模型</label><input type="text" id="field-CHATCCC_DSH_MODEL" placeholder="deepseek-v4-flash"></div>
-            <div class="form-group"><label>Provider 路由</label><input type="text" id="field-CHATCCC_DSH_PROVIDER" placeholder="deepseek-official"></div>
-            <div class="form-group"><label>单次最大输出 Tokens</label><input type="number" id="field-CHATCCC_DSH_MAX_TOKENS" min="1" placeholder="49152"></div>
-            <div class="form-group" style="border-top:1px solid #e2e8f0;padding-top:12px;margin-top:4px">
-              <label>DeepSeek Harness 引擎</label>
-              <div id="dsh-engine-status" class="engine-status">检测中...</div>
-              <div id="dsh-engine-steps" class="engine-steps"></div>
-              <button type="button" class="btn btn-outline" id="dsh-engine-install-btn" onclick="installEngine('dsh')">安装并启用</button>
-              <div class="hint" style="margin-top:6px">一次点击自动完成环境检查、下载、校验、Runtime 握手和原子切换；页面刷新后仍可恢复进度。</div>
-            </div>
-          </fieldset>
-        </div>
-
-        <!-- Claude 卡片 -->
+        </div>
+
+        <!-- DeepSeek Harness 卡片 -->
+        <div class="agent-card" id="agent-card-dsh">
+          <div class="agent-card-header">
+            <input type="checkbox" class="agent-toggle" id="agent-enable-dsh" onchange="onInstallableAgentToggle('dsh', this)">
+            <div class="meta">
+              <div class="name">DeepSeek Harness</div>
+              <div class="desc">DeepSeek 官方 Agent Harness<br>按需安装，独立于 CCC Agent</div>
+            </div>
+          </div>
+          <label class="agent-default-row">
+            <input type="checkbox" id="agent-default-dsh" onchange="onDefaultAgentToggle('dsh', this.checked)">
+            设为默认 Agent
+          </label>
+          <fieldset class="agent-body" id="agent-body-dsh" disabled>
+            <div class="form-group"><label>API Key</label><input type="password" id="field-CHATCCC_DSH_API_KEY" placeholder="DeepSeek API Key"></div>
+            <div class="form-group"><label>Base URL</label><input type="text" id="field-CHATCCC_DSH_BASE_URL" placeholder="https://api.deepseek.com/v1"></div>
+            <div class="form-group"><label>模型</label><input type="text" id="field-CHATCCC_DSH_MODEL" placeholder="deepseek-v4-flash"></div>
+            <div class="form-group"><label>子模型（选填）</label><input type="text" id="field-CHATCCC_DSH_SUB_MODEL" placeholder="留空跟随主模型；用于 subagent 子代理任务"></div>
+            <div class="form-group"><label>备选模型（选填）</label><input type="text" id="field-CHATCCC_DSH_ALTERNATIVE_MODEL" placeholder="加入 /model 列表，便于会话内切换"></div>
+            <div class="form-group"><label>Provider 路由</label><input type="text" id="field-CHATCCC_DSH_PROVIDER" placeholder="deepseek-official"></div>
+            <div class="form-group"><label>单次最大输出 Tokens</label><input type="number" id="field-CHATCCC_DSH_MAX_TOKENS" min="1" placeholder="49152"></div>
+            <div class="form-group" style="border-top:1px solid #e2e8f0;padding-top:12px;margin-top:4px">
+              <label>DeepSeek Harness 引擎</label>
+              <div id="dsh-engine-status" class="engine-status">检测中...</div>
+              <div id="dsh-engine-steps" class="engine-steps"></div>
+              <button type="button" class="btn btn-outline" id="dsh-engine-install-btn" onclick="installEngine('dsh')">安装并启用</button>
+              <div class="hint" style="margin-top:6px">一次点击自动完成环境检查、下载、校验、Runtime 握手和原子切换；页面刷新后仍可恢复进度。</div>
+            </div>
+          </fieldset>
+        </div>
+
+        <!-- Claude 卡片 -->
         <div class="agent-card" id="agent-card-claude">
           <div class="agent-card-header">
-            <input type="checkbox" class="agent-toggle" id="agent-enable-claude" onchange="onInstallableAgentToggle('claude', this)">
+            <input type="checkbox" class="agent-toggle" id="agent-enable-claude" onchange="onInstallableAgentToggle('claude', this)">
             <div class="meta">
               <div class="name">Claude Code</div>
               <div class="desc">Anthropic Claude Code CLI<br>模型、effort 均为选填</div>
@@ -1000,9 +1010,9 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
             </div>
             <div class="form-group" style="border-top:1px solid #e2e8f0;padding-top:12px;margin-top:4px">
               <label>Claude Code 引擎（Agent SDK）</label>
-              <div id="claude-engine-status" class="engine-status">检测中...</div>
-              <div id="claude-engine-steps" class="engine-steps"></div>
-              <button type="button" class="btn btn-outline" id="claude-engine-install-btn" onclick="installEngine('claude')">安装并启用</button>
+              <div id="claude-engine-status" class="engine-status">检测中...</div>
+              <div id="claude-engine-steps" class="engine-steps"></div>
+              <button type="button" class="btn btn-outline" id="claude-engine-install-btn" onclick="installEngine('claude')">安装并启用</button>
               <div class="hint" style="margin-top:6px">ChatCCC 通过 Claude Agent SDK 调用 Claude Code；SDK 引擎按需下载到本机（仅启用 Claude Code 时需要），安装期间请保持网络畅通。</div>
             </div>
           </fieldset>
@@ -1180,7 +1190,7 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
       </div>
     </details>
 
-    <details class="card config-section" id="dash-claude">
+    <details class="card config-section" id="dash-claude">
       <summary>Claude Agent</summary>
       <div class="section-detail">
         <div class="config-row"><span class="key">模型</span><span class="val" id="cfg-ANTHROPIC_MODEL">-</span></div>
@@ -1193,24 +1203,26 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
         <div class="hint" style="margin-top:6px;line-height:1.6">生效范围：保存后下一条消息或下个新会话生效，当前生成不中断。</div>
         <button class="btn btn-outline" style="margin-top:8px" onclick="editSection('claude')">编辑</button>
       </div>
-    </details>
-
-    <details class="card config-section" id="dash-dsh">
-      <summary>DeepSeek Harness</summary>
-      <div class="section-detail">
-        <div class="config-row"><span class="key">API Key</span><span class="val" id="cfg-DSH_API_KEY">-</span></div>
-        <div class="config-row"><span class="key">Base URL</span><span class="val" id="cfg-DSH_BASE_URL">-</span></div>
-        <div class="config-row"><span class="key">模型</span><span class="val" id="cfg-DSH_MODEL">-</span></div>
-        <div class="config-row"><span class="key">Provider</span><span class="val" id="cfg-DSH_PROVIDER">-</span></div>
-        <div class="config-row"><span class="key">最大输出 Tokens</span><span class="val" id="cfg-DSH_MAX_TOKENS">-</span></div>
-        <div id="dsh-dashboard-engine-status" class="engine-status">检测中...</div>
-        <div id="dsh-dashboard-engine-steps" class="engine-steps"></div>
-        <button type="button" class="btn btn-outline" id="dsh-dashboard-engine-install-btn" onclick="installEngine('dsh')">安装或升级引擎</button>
-        <label class="agent-default-row" style="margin-top:10px"><input type="checkbox" id="dash-default-dsh" onchange="setDashboardDefaultAgent('dsh', this.checked)"> 设为默认 Agent</label>
-        <div class="hint" style="margin-top:6px;line-height:1.6">安装过程不调用付费模型；保存后下一条消息或下个新会话生效。</div>
-        <button class="btn btn-outline" style="margin-top:8px" onclick="editSection('dsh')">编辑</button>
-      </div>
-    </details>
+    </details>
+
+    <details class="card config-section" id="dash-dsh">
+      <summary>DeepSeek Harness</summary>
+      <div class="section-detail">
+        <div class="config-row"><span class="key">API Key</span><span class="val" id="cfg-DSH_API_KEY">-</span></div>
+        <div class="config-row"><span class="key">Base URL</span><span class="val" id="cfg-DSH_BASE_URL">-</span></div>
+        <div class="config-row"><span class="key">模型</span><span class="val" id="cfg-DSH_MODEL">-</span></div>
+        <div class="config-row"><span class="key">子模型</span><span class="val" id="cfg-DSH_SUB_MODEL">-</span></div>
+        <div class="config-row"><span class="key">备选模型</span><span class="val" id="cfg-DSH_ALTERNATIVE_MODEL">-</span></div>
+        <div class="config-row"><span class="key">Provider</span><span class="val" id="cfg-DSH_PROVIDER">-</span></div>
+        <div class="config-row"><span class="key">最大输出 Tokens</span><span class="val" id="cfg-DSH_MAX_TOKENS">-</span></div>
+        <div id="dsh-dashboard-engine-status" class="engine-status">检测中...</div>
+        <div id="dsh-dashboard-engine-steps" class="engine-steps"></div>
+        <button type="button" class="btn btn-outline" id="dsh-dashboard-engine-install-btn" onclick="installEngine('dsh')">安装或升级引擎</button>
+        <label class="agent-default-row" style="margin-top:10px"><input type="checkbox" id="dash-default-dsh" onchange="setDashboardDefaultAgent('dsh', this.checked)"> 设为默认 Agent</label>
+        <div class="hint" style="margin-top:6px;line-height:1.6">安装过程不调用付费模型；保存后下一条消息或下个新会话生效。</div>
+        <button class="btn btn-outline" style="margin-top:8px" onclick="editSection('dsh')">编辑</button>
+      </div>
+    </details>
 
     <details class="card config-section" id="dash-cursor">
       <summary>Cursor Agent</summary>
@@ -1281,8 +1293,8 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
 <script>
 let state = {
   view: 'loading',
-  // 五个 Agent 各自的启用开关；初始全 false，renderStep2() 会按已存在 config 自动打开
-  agentsEnabled: { claude: false, cursor: false, codex: false, ccc: false, dsh: false },
+  // 五个 Agent 各自的启用开关；初始全 false，renderStep2() 会按已存在 config 自动打开
+  agentsEnabled: { claude: false, cursor: false, codex: false, ccc: false, dsh: false },
   defaultAgent: 'claude',
   wizardStep: 1,
   config: {},
@@ -1299,8 +1311,8 @@ const AGENT_FIELDS = {
   claude: ['CHATCCC_ANTHROPIC_MODEL','CHATCCC_ANTHROPIC_SUBAGENT_MODEL','CHATCCC_ANTHROPIC_EFFORT','CHATCCC_ANTHROPIC_API_KEY','CHATCCC_ANTHROPIC_BASE_URL','CHATCCC_ANTHROPIC_MAX_TURN'],
   cursor: ['CHATCCC_CURSOR_PATH','CHATCCC_CURSOR_MODEL','CHATCCC_CURSOR_ALTERNATIVE_MODEL','CHATCCC_CURSOR_AVATAR_BATTERY_MODE','CHATCCC_CURSOR_ON_DEMAND_MONTHLY_BUDGET'],
   codex: ['CHATCCC_CODEX_PATH','CHATCCC_CODEX_MODEL','CHATCCC_CODEX_ALTERNATIVE_MODEL','CHATCCC_CODEX_EFFORT','CHATCCC_CODEX_FAST_MODE'],
-  ccc: ['CHATCCC_CCC_API_KEY','CHATCCC_CCC_BASE_URL','CHATCCC_CCC_MODEL','CHATCCC_CCC_SUB_MODEL','CHATCCC_CCC_ALTERNATIVE_MODEL','CHATCCC_CCC_EFFORT','CHATCCC_CCC_PROVIDER','CHATCCC_CCC_CONTEXT_WINDOW'],
-  dsh: ['CHATCCC_DSH_API_KEY','CHATCCC_DSH_BASE_URL','CHATCCC_DSH_MODEL','CHATCCC_DSH_PROVIDER','CHATCCC_DSH_MAX_TOKENS']
+  ccc: ['CHATCCC_CCC_API_KEY','CHATCCC_CCC_BASE_URL','CHATCCC_CCC_MODEL','CHATCCC_CCC_SUB_MODEL','CHATCCC_CCC_ALTERNATIVE_MODEL','CHATCCC_CCC_EFFORT','CHATCCC_CCC_PROVIDER','CHATCCC_CCC_CONTEXT_WINDOW'],
+  dsh: ['CHATCCC_DSH_API_KEY','CHATCCC_DSH_BASE_URL','CHATCCC_DSH_MODEL','CHATCCC_DSH_SUB_MODEL','CHATCCC_DSH_ALTERNATIVE_MODEL','CHATCCC_DSH_PROVIDER','CHATCCC_DSH_MAX_TOKENS']
 };
 const FEISHU_FIELDS = ['CHATCCC_APP_ID','CHATCCC_APP_SECRET'];
 const WEB_UI_FIELDS = ['CHATCCC_WEB_UI_OPEN_ON_START'];
@@ -1454,31 +1466,31 @@ function onAgentToggle(agent, enabled) {
   updateStep2NextBtn();
 }
 
-function firstEnabledAgent() {
+function firstEnabledAgent() {
   if (state.agentsEnabled.claude) return 'claude';
   if (state.agentsEnabled.cursor) return 'cursor';
   if (state.agentsEnabled.codex) return 'codex';
-  if (state.agentsEnabled.ccc) return 'ccc';
-  if (state.agentsEnabled.dsh) return 'dsh';
+  if (state.agentsEnabled.ccc) return 'ccc';
+  if (state.agentsEnabled.dsh) return 'dsh';
   return null;
 }
 
-function resolveDefaultAgentFromConfig(c, claudeOn, cursorOn, codexOn, cccOn, dshOn) {
+function resolveDefaultAgentFromConfig(c, claudeOn, cursorOn, codexOn, cccOn, dshOn) {
   if (claudeOn && c.claude && c.claude.defaultAgent === true) return 'claude';
   if (cursorOn && c.cursor && c.cursor.defaultAgent === true) return 'cursor';
   if (codexOn && c.codex && c.codex.defaultAgent === true) return 'codex';
-  if (cccOn && c.ccc && c.ccc.defaultAgent === true) return 'ccc';
-  if (dshOn && c.dsh && c.dsh.defaultAgent === true) return 'dsh';
+  if (cccOn && c.ccc && c.ccc.defaultAgent === true) return 'ccc';
+  if (dshOn && c.dsh && c.dsh.defaultAgent === true) return 'dsh';
   if (claudeOn) return 'claude';
   if (cursorOn) return 'cursor';
   if (codexOn) return 'codex';
-  if (cccOn) return 'ccc';
-  if (dshOn) return 'dsh';
+  if (cccOn) return 'ccc';
+  if (dshOn) return 'dsh';
   return 'claude';
 }
 
 function updateDefaultAgentToggles() {
-  ['claude','cursor','codex','ccc','dsh'].forEach(function(agent){
+  ['claude','cursor','codex','ccc','dsh'].forEach(function(agent){
     var el = document.getElementById('agent-default-' + agent);
     if (el) {
       el.checked = state.defaultAgent === agent;
@@ -1510,8 +1522,8 @@ function updateStep2NextBtn() {
   if (state.agentsEnabled.claude) validCount++;
   if (state.agentsEnabled.cursor) validCount++;
   if (state.agentsEnabled.codex) validCount++;
-  if (state.agentsEnabled.ccc) validCount++;
-  if (state.agentsEnabled.dsh) validCount++;
+  if (state.agentsEnabled.ccc) validCount++;
+  if (state.agentsEnabled.dsh) validCount++;
   if (validCount > 0 && !state.defaultAgent) {
     state.defaultAgent = firstEnabledAgent();
     updateDefaultAgentToggles();
@@ -1653,8 +1665,8 @@ var CLAUDE_FALLBACK_KEYS = ['model','subagentModel','effort','maxTurn'];
 var CURSOR_FALLBACK_KEYS = ['path','command','model','alternativeModel'];
 var CODEX_FALLBACK_KEYS = ['path','command','model','alternativeModel','effort','fastMode'];
 // 旧版 CCC 配置没有 enabled；只有 API Key 才表示用户实际完成了配置。
-var CCC_FALLBACK_KEYS = ['DEEPSEEK_API_KEY'];
-var DSH_FALLBACK_KEYS = ['apiKey'];
+var CCC_FALLBACK_KEYS = ['DEEPSEEK_API_KEY'];
+var DSH_FALLBACK_KEYS = ['apiKey'];
 
 function renderStep2() {
   var c = state.config || {};
@@ -1687,7 +1699,7 @@ function renderStep2() {
   }
   var codexFastModeEl = document.getElementById('field-CHATCCC_CODEX_FAST_MODE');
   if (codexFastModeEl) codexFastModeEl.checked = !!(c.codex && c.codex.fastMode === true);
-  if (c.ccc) {
+  if (c.ccc) {
     prefillNested('field-CHATCCC_CCC_API_KEY', c.ccc.DEEPSEEK_API_KEY);
     prefillNested('field-CHATCCC_CCC_BASE_URL', c.ccc.DEEPSEEK_BASE_URL);
     prefillNested('field-CHATCCC_CCC_PROVIDER', c.ccc.provider);
@@ -1695,37 +1707,39 @@ function renderStep2() {
     prefillNested('field-CHATCCC_CCC_SUB_MODEL', c.ccc.subModel);
     prefillNested('field-CHATCCC_CCC_ALTERNATIVE_MODEL', c.ccc.alternativeModel);
     prefillNested('field-CHATCCC_CCC_EFFORT', c.ccc.effort);
-    prefillContextWindow('field-', c.ccc.contextWindow);
-  }
-  if (c.dsh) {
-    prefillNested('field-CHATCCC_DSH_API_KEY', c.dsh.apiKey);
-    prefillNested('field-CHATCCC_DSH_BASE_URL', c.dsh.baseUrl);
-    prefillNested('field-CHATCCC_DSH_MODEL', c.dsh.model);
-    prefillNested('field-CHATCCC_DSH_PROVIDER', c.dsh.provider);
-    prefillNested('field-CHATCCC_DSH_MAX_TOKENS', c.dsh.maxTokens || 49152);
-  }
+    prefillContextWindow('field-', c.ccc.contextWindow);
+  }
+  if (c.dsh) {
+    prefillNested('field-CHATCCC_DSH_API_KEY', c.dsh.apiKey);
+    prefillNested('field-CHATCCC_DSH_BASE_URL', c.dsh.baseUrl);
+    prefillNested('field-CHATCCC_DSH_MODEL', c.dsh.model);
+    prefillNested('field-CHATCCC_DSH_SUB_MODEL', c.dsh.subModel);
+    prefillNested('field-CHATCCC_DSH_ALTERNATIVE_MODEL', c.dsh.alternativeModel);
+    prefillNested('field-CHATCCC_DSH_PROVIDER', c.dsh.provider);
+    prefillNested('field-CHATCCC_DSH_MAX_TOKENS', c.dsh.maxTokens || 49152);
+  }
 
   // 按已有 config 决定每个 Agent 默认是否开启：优先 enabled 字段，缺省时按"任一字段非空"
   var claudeOn = isAgentEnabled(c.claude, CLAUDE_FALLBACK_KEYS);
   var cursorOn = isAgentEnabled(c.cursor, CURSOR_FALLBACK_KEYS);
   var codexOn = isAgentEnabled(c.codex, CODEX_FALLBACK_KEYS);
-  var cccOn = isAgentEnabled(c.ccc, CCC_FALLBACK_KEYS);
-  var dshOn = isAgentEnabled(c.dsh, DSH_FALLBACK_KEYS);
-  // 全新用户：五个 Agent 均无启用/配置痕迹时，只默认勾选 DeepCCC（ccc），其余不勾
-  if (!claudeOn && !cursorOn && !codexOn && !cccOn && !dshOn) {
+  var cccOn = isAgentEnabled(c.ccc, CCC_FALLBACK_KEYS);
+  var dshOn = isAgentEnabled(c.dsh, DSH_FALLBACK_KEYS);
+  // 全新用户：五个 Agent 均无启用/配置痕迹时，只默认勾选 DeepCCC（ccc），其余不勾
+  if (!claudeOn && !cursorOn && !codexOn && !cccOn && !dshOn) {
     cccOn = true;
   }
-  state.defaultAgent = resolveDefaultAgentFromConfig(c, claudeOn, cursorOn, codexOn, cccOn, dshOn);
+  state.defaultAgent = resolveDefaultAgentFromConfig(c, claudeOn, cursorOn, codexOn, cccOn, dshOn);
   document.getElementById('agent-enable-claude').checked = claudeOn;
   document.getElementById('agent-enable-cursor').checked = cursorOn;
   document.getElementById('agent-enable-codex').checked = codexOn;
-  document.getElementById('agent-enable-ccc').checked = cccOn;
-  document.getElementById('agent-enable-dsh').checked = dshOn;
+  document.getElementById('agent-enable-ccc').checked = cccOn;
+  document.getElementById('agent-enable-dsh').checked = dshOn;
   onAgentToggle('claude', claudeOn);
   onAgentToggle('cursor', cursorOn);
   onAgentToggle('codex', codexOn);
-  onAgentToggle('ccc', cccOn);
-  onAgentToggle('dsh', dshOn);
+  onAgentToggle('ccc', cccOn);
+  onAgentToggle('dsh', dshOn);
   updateDefaultAgentToggles();
 
   // Cursor path placeholder/hint：把已探测到的路径显示为占位
@@ -1749,7 +1763,7 @@ function renderStep2() {
  * 收集"待落地到 config.json 的扁平 vars"。
  *
  * - 飞书字段始终收集
-  * - 五个 Agent 的 enabled 状态都显式下发，让 config.json 持久化用户的最新开关偏好
+  * - 五个 Agent 的 enabled 状态都显式下发，让 config.json 持久化用户的最新开关偏好
  * - Agent 字段仅在该 Agent 开关启用时收集；未启用的 Agent 不下发其它字段，
  *   服务端 deepMerge 会保留 config.json 中已有值（避免关闭开关时误清空旧配置）
  */
@@ -1775,16 +1789,16 @@ function collectAllFields() {
   vars.CHATCCC_CLAUDE_ENABLED = !!state.agentsEnabled.claude;
   vars.CHATCCC_CURSOR_ENABLED = !!state.agentsEnabled.cursor;
   vars.CHATCCC_CODEX_ENABLED = !!state.agentsEnabled.codex;
-  vars.CHATCCC_CCC_ENABLED = !!state.agentsEnabled.ccc;
-  vars.CHATCCC_DSH_ENABLED = !!state.agentsEnabled.dsh;
+  vars.CHATCCC_CCC_ENABLED = !!state.agentsEnabled.ccc;
+  vars.CHATCCC_DSH_ENABLED = !!state.agentsEnabled.dsh;
   if (!state.defaultAgent || !state.agentsEnabled[state.defaultAgent]) {
     state.defaultAgent = firstEnabledAgent();
   }
   vars.CHATCCC_CLAUDE_DEFAULT_AGENT = state.defaultAgent === 'claude';
   vars.CHATCCC_CURSOR_DEFAULT_AGENT = state.defaultAgent === 'cursor';
   vars.CHATCCC_CODEX_DEFAULT_AGENT = state.defaultAgent === 'codex';
-  vars.CHATCCC_CCC_DEFAULT_AGENT = state.defaultAgent === 'ccc';
-  vars.CHATCCC_DSH_DEFAULT_AGENT = state.defaultAgent === 'dsh';
+  vars.CHATCCC_CCC_DEFAULT_AGENT = state.defaultAgent === 'ccc';
+  vars.CHATCCC_DSH_DEFAULT_AGENT = state.defaultAgent === 'dsh';
   if (state.agentsEnabled.claude) {
     AGENT_FIELDS.claude.forEach(function(key){
       var el = document.getElementById('field-' + key);
@@ -1805,7 +1819,7 @@ function collectAllFields() {
       else if (el.value.trim()) vars[key] = el.value.trim();
     });
   }
-  if (state.agentsEnabled.ccc) {
+  if (state.agentsEnabled.ccc) {
     AGENT_FIELDS.ccc.forEach(function(key){
       if (key === 'CHATCCC_CCC_CONTEXT_WINDOW') {
         var cw = contextWindowToTokensValue('field-');
@@ -1815,13 +1829,13 @@ function collectAllFields() {
       var el = document.getElementById('field-' + key);
       if (el && el.value.trim()) vars[key] = el.value.trim();
     });
-  }
-  if (state.agentsEnabled.dsh) {
-    AGENT_FIELDS.dsh.forEach(function(key){
-      var el = document.getElementById('field-' + key);
-      if (el && el.value.trim()) vars[key] = el.value.trim();
-    });
-  }
+  }
+  if (state.agentsEnabled.dsh) {
+    AGENT_FIELDS.dsh.forEach(function(key){
+      var el = document.getElementById('field-' + key);
+      if (el && el.value.trim()) vars[key] = el.value.trim();
+    });
+  }
   return vars;
 }
 
@@ -1861,8 +1875,8 @@ function renderStep3() {
   if (state.agentsEnabled.claude) enabledList.push('claude');
   if (state.agentsEnabled.cursor) enabledList.push('cursor');
   if (state.agentsEnabled.codex) enabledList.push('codex');
-  if (state.agentsEnabled.ccc) enabledList.push('ccc');
-  if (state.agentsEnabled.dsh) enabledList.push('dsh');
+  if (state.agentsEnabled.ccc) enabledList.push('ccc');
+  if (state.agentsEnabled.dsh) enabledList.push('dsh');
   if (enabledList.length === 0) {
     lines.push('<div style="color:#ef4444">未启用任何 AI Agent</div>');
   } else {
@@ -1893,7 +1907,7 @@ function renderStep3() {
       lines.push('<div class="config-row"><span class="key">备选模型</span><span class="val">' + (vars.CHATCCC_CODEX_ALTERNATIVE_MODEL || '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">Effort</span><span class="val">' + (vars.CHATCCC_CODEX_EFFORT || '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">Fast 模式</span><span class="val">' + (vars.CHATCCC_CODEX_FAST_MODE ? '已启用' : '已禁用') + '</span></div>');
-    } else if (t === 'ccc') {
+    } else if (t === 'ccc') {
       lines.push('<h4 style="margin:10px 0 4px;color:#334155">CCC Agent</h4>');
       lines.push('<div class="config-row"><span class="key">API Key</span><span class="val">' + (vars.CHATCCC_CCC_API_KEY ? '***已设置***' : '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">Base URL</span><span class="val">' + (vars.CHATCCC_CCC_BASE_URL || '(留空)') + '</span></div>');
@@ -1901,12 +1915,12 @@ function renderStep3() {
       lines.push('<div class="config-row"><span class="key">子模型</span><span class="val">' + (vars.CHATCCC_CCC_SUB_MODEL || '(留空，跟随主模型)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">备选模型</span><span class="val">' + (vars.CHATCCC_CCC_ALTERNATIVE_MODEL || '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">Effort</span><span class="val">' + (vars.CHATCCC_CCC_EFFORT || '(留空)') + '</span></div>');
-      lines.push('<div class="config-row"><span class="key">上下文窗口</span><span class="val">' + contextWindowTokensLabel(vars.CHATCCC_CCC_CONTEXT_WINDOW || 1048576) + '</span></div>');
-    } else if (t === 'dsh') {
-      lines.push('<h4 style="margin:10px 0 4px;color:#334155">DeepSeek Harness</h4>');
-      lines.push('<div class="config-row"><span class="key">API Key</span><span class="val">' + (vars.CHATCCC_DSH_API_KEY ? '***已设置***' : '(留空)') + '</span></div>');
-      lines.push('<div class="config-row"><span class="key">Base URL</span><span class="val">' + (vars.CHATCCC_DSH_BASE_URL || '(默认)') + '</span></div>');
-      lines.push('<div class="config-row"><span class="key">模型</span><span class="val">' + (vars.CHATCCC_DSH_MODEL || 'deepseek-v4-flash') + '</span></div>');
+      lines.push('<div class="config-row"><span class="key">上下文窗口</span><span class="val">' + contextWindowTokensLabel(vars.CHATCCC_CCC_CONTEXT_WINDOW || 1048576) + '</span></div>');
+    } else if (t === 'dsh') {
+      lines.push('<h4 style="margin:10px 0 4px;color:#334155">DeepSeek Harness</h4>');
+      lines.push('<div class="config-row"><span class="key">API Key</span><span class="val">' + (vars.CHATCCC_DSH_API_KEY ? '***已设置***' : '(留空)') + '</span></div>');
+      lines.push('<div class="config-row"><span class="key">Base URL</span><span class="val">' + (vars.CHATCCC_DSH_BASE_URL || '(默认)') + '</span></div>');
+      lines.push('<div class="config-row"><span class="key">模型</span><span class="val">' + (vars.CHATCCC_DSH_MODEL || 'deepseek-v4-flash') + '</span></div>');
     }
   });
   document.getElementById('review-content').innerHTML = lines.join('');
@@ -1934,21 +1948,21 @@ async function setDashboardDefaultAgent(agent, enabled) {
     CHATCCC_CLAUDE_DEFAULT_AGENT: agent === 'claude',
     CHATCCC_CURSOR_DEFAULT_AGENT: agent === 'cursor',
     CHATCCC_CODEX_DEFAULT_AGENT: agent === 'codex',
-    CHATCCC_CCC_DEFAULT_AGENT: agent === 'ccc',
-    CHATCCC_DSH_DEFAULT_AGENT: agent === 'dsh'
+    CHATCCC_CCC_DEFAULT_AGENT: agent === 'ccc',
+    CHATCCC_DSH_DEFAULT_AGENT: agent === 'dsh'
   };
   var result = await api('/api/config', 'POST', { vars: vars });
   if (result.ok) {
     state.config.claude = state.config.claude || {};
     state.config.cursor = state.config.cursor || {};
     state.config.codex = state.config.codex || {};
-    state.config.ccc = state.config.ccc || {};
-    state.config.dsh = state.config.dsh || {};
+    state.config.ccc = state.config.ccc || {};
+    state.config.dsh = state.config.dsh || {};
     state.config.claude.defaultAgent = agent === 'claude';
     state.config.cursor.defaultAgent = agent === 'cursor';
     state.config.codex.defaultAgent = agent === 'codex';
-    state.config.ccc.defaultAgent = agent === 'ccc';
-    state.config.dsh.defaultAgent = agent === 'dsh';
+    state.config.ccc.defaultAgent = agent === 'ccc';
+    state.config.dsh.defaultAgent = agent === 'dsh';
     updateDefaultAgentToggles();
     toastConfigApplyResult(result, '默认 Agent 已更新');
   } else {
@@ -2065,10 +2079,10 @@ function updateDashboardUI() {
   var claudeOn = isAgentEnabled(c.claude, CLAUDE_FALLBACK_KEYS);
   var cursorOn = isAgentEnabled(c.cursor, CURSOR_FALLBACK_KEYS);
   var codexOn = isAgentEnabled(c.codex, CODEX_FALLBACK_KEYS);
-  var cccOn = isAgentEnabled(c.ccc, CCC_FALLBACK_KEYS);
-  var dshOn = isAgentEnabled(c.dsh, DSH_FALLBACK_KEYS);
-  state.agentsEnabled = { claude: claudeOn, cursor: cursorOn, codex: codexOn, ccc: cccOn, dsh: dshOn };
-  state.defaultAgent = resolveDefaultAgentFromConfig(c, claudeOn, cursorOn, codexOn, cccOn, dshOn);
+  var cccOn = isAgentEnabled(c.ccc, CCC_FALLBACK_KEYS);
+  var dshOn = isAgentEnabled(c.dsh, DSH_FALLBACK_KEYS);
+  state.agentsEnabled = { claude: claudeOn, cursor: cursorOn, codex: codexOn, ccc: cccOn, dsh: dshOn };
+  state.defaultAgent = resolveDefaultAgentFromConfig(c, claudeOn, cursorOn, codexOn, cccOn, dshOn);
 
   // 微信 iLink 平台开关：同步复选框和标签
   var ilinkEnabled = c.platforms && c.platforms.ilink ? c.platforms.ilink.enabled !== false : true;
@@ -2100,12 +2114,12 @@ function updateDashboardUI() {
   document.getElementById('dash-claude').style.display = claudeOn ? '' : 'none';
   document.getElementById('dash-cursor').style.display = cursorOn ? '' : 'none';
   document.getElementById('dash-codex').style.display = codexOn ? '' : 'none';
-  document.getElementById('dash-ccc').style.display = cccOn ? '' : 'none';
-  document.getElementById('dash-dsh').style.display = dshOn ? '' : 'none';
+  document.getElementById('dash-ccc').style.display = cccOn ? '' : 'none';
+  document.getElementById('dash-dsh').style.display = dshOn ? '' : 'none';
   updateDefaultAgentToggles();
-  // 五个都未启用时给一个空态提示，引导用户去配置向导启用
+  // 五个都未启用时给一个空态提示，引导用户去配置向导启用
   var emptyHint = document.getElementById('dash-no-agent-hint');
-  if (emptyHint) emptyHint.style.display = (!claudeOn && !cursorOn && !codexOn && !cccOn && !dshOn) ? '' : 'none';
+  if (emptyHint) emptyHint.style.display = (!claudeOn && !cursorOn && !codexOn && !cccOn && !dshOn) ? '' : 'none';
 
   document.getElementById('cfg-ANTHROPIC_MODEL').textContent = (c.claude && c.claude.model) || '(留空)';
   document.getElementById('cfg-ANTHROPIC_SUBAGENT_MODEL').textContent = (c.claude && c.claude.subagentModel) || '(留空)';
@@ -2131,13 +2145,15 @@ function updateDashboardUI() {
   document.getElementById('cfg-CCC_PROVIDER').textContent = (c.ccc && c.ccc.provider) ? c.ccc.provider : '(跟随 DeepCCC 内核配置)';
   document.getElementById('cfg-CCC_MODEL').textContent = (c.ccc && c.ccc.model) || '(留空)';
   document.getElementById('cfg-CCC_SUB_MODEL').textContent = (c.ccc && c.ccc.subModel) || '(留空，跟随主模型)';
-  document.getElementById('cfg-CCC_ALTERNATIVE_MODEL').textContent = (c.ccc && c.ccc.alternativeModel) || '(留空)';
-  document.getElementById('cfg-DSH_API_KEY').textContent = (c.dsh && c.dsh.apiKey) ? '***已设置***' : '(留空)';
-  document.getElementById('cfg-DSH_BASE_URL').textContent = (c.dsh && c.dsh.baseUrl) || 'https://api.deepseek.com/v1';
-  document.getElementById('cfg-DSH_MODEL').textContent = (c.dsh && c.dsh.model) || 'deepseek-v4-flash';
-  document.getElementById('cfg-DSH_PROVIDER').textContent = (c.dsh && c.dsh.provider) || 'deepseek-official';
-  document.getElementById('cfg-DSH_MAX_TOKENS').textContent = String((c.dsh && c.dsh.maxTokens) || 49152);
-  engineRefreshStatus('dsh');
+  document.getElementById('cfg-CCC_ALTERNATIVE_MODEL').textContent = (c.ccc && c.ccc.alternativeModel) || '(留空)';
+  document.getElementById('cfg-DSH_API_KEY').textContent = (c.dsh && c.dsh.apiKey) ? '***已设置***' : '(留空)';
+  document.getElementById('cfg-DSH_BASE_URL').textContent = (c.dsh && c.dsh.baseUrl) || 'https://api.deepseek.com/v1';
+  document.getElementById('cfg-DSH_MODEL').textContent = (c.dsh && c.dsh.model) || 'deepseek-v4-flash';
+  document.getElementById('cfg-DSH_SUB_MODEL').textContent = (c.dsh && c.dsh.subModel) || '(留空，跟随主模型)';
+  document.getElementById('cfg-DSH_ALTERNATIVE_MODEL').textContent = (c.dsh && c.dsh.alternativeModel) || '(留空)';
+  document.getElementById('cfg-DSH_PROVIDER').textContent = (c.dsh && c.dsh.provider) || 'deepseek-official';
+  document.getElementById('cfg-DSH_MAX_TOKENS').textContent = String((c.dsh && c.dsh.maxTokens) || 49152);
+  engineRefreshStatus('dsh');
 }
 
 function pollStatus() {
@@ -2193,7 +2209,7 @@ function editSection(section) {
   else if (section === 'chromeDevtools') fields = CHROME_DEVTOOLS_FIELDS;
   else fields = AGENT_FIELDS[section] || [];
 
-  var titleMap = { feishu: '飞书', webUi: 'Web UI', chromeDevtools: 'Chrome CDP', claude: 'Claude Agent', cursor: 'Cursor Agent', codex: 'Codex Agent', ccc: 'CCC Agent', dsh: 'DeepSeek Harness' };
+  var titleMap = { feishu: '飞书', webUi: 'Web UI', chromeDevtools: 'Chrome CDP', claude: 'Claude Agent', cursor: 'Cursor Agent', codex: 'Codex Agent', ccc: 'CCC Agent', dsh: 'DeepSeek Harness' };
   document.getElementById('edit-modal-title').textContent = '编辑 ' + (titleMap[section] || section);
 
   document.getElementById('edit-modal-effect').textContent = configEffectHint(section);
@@ -2214,8 +2230,8 @@ function editSection(section) {
     'CHATCCC_CODEX_FAST_MODE': 'Fast 模式',
     'CHATCCC_CCC_API_KEY': 'API Key', 'CHATCCC_CCC_BASE_URL': 'Base URL',
     'CHATCCC_CCC_PROVIDER': 'API 协议（选填）',
-    'CHATCCC_CCC_MODEL': '模型', 'CHATCCC_CCC_SUB_MODEL': '子模型', 'CHATCCC_CCC_ALTERNATIVE_MODEL': '备选模型', 'CHATCCC_CCC_EFFORT': 'Effort', 'CHATCCC_CCC_CONTEXT_WINDOW': '上下文窗口',
-    'CHATCCC_DSH_API_KEY': 'API Key', 'CHATCCC_DSH_BASE_URL': 'Base URL', 'CHATCCC_DSH_MODEL': '模型', 'CHATCCC_DSH_PROVIDER': 'Provider 路由', 'CHATCCC_DSH_MAX_TOKENS': '单次最大输出 Tokens'
+    'CHATCCC_CCC_MODEL': '模型', 'CHATCCC_CCC_SUB_MODEL': '子模型', 'CHATCCC_CCC_ALTERNATIVE_MODEL': '备选模型', 'CHATCCC_CCC_EFFORT': 'Effort', 'CHATCCC_CCC_CONTEXT_WINDOW': '上下文窗口',
+    'CHATCCC_DSH_API_KEY': 'API Key', 'CHATCCC_DSH_BASE_URL': 'Base URL', 'CHATCCC_DSH_MODEL': '模型', 'CHATCCC_DSH_SUB_MODEL': '子模型', 'CHATCCC_DSH_ALTERNATIVE_MODEL': '备选模型', 'CHATCCC_DSH_PROVIDER': 'Provider 路由', 'CHATCCC_DSH_MAX_TOKENS': '单次最大输出 Tokens'
   };
   var hintMap = {
     'CHATCCC_WEB_UI_OPEN_ON_START': '关闭后可继续手动访问 http://localhost:<端口>/；/restart、/update 和 Web UI 重启无论此项为何值都不会自动打开。',
@@ -2263,7 +2279,7 @@ function editSection(section) {
         else if (key === 'CHATCCC_CODEX_ALTERNATIVE_MODEL') val = state.config.codex.alternativeModel || '';
         else if (key === 'CHATCCC_CODEX_EFFORT') val = state.config.codex.effort || '';
         else if (key === 'CHATCCC_CODEX_FAST_MODE') val = state.config.codex.fastMode === true ? 'true' : 'false';
-      } else if (section === 'ccc' && state.config.ccc) {
+      } else if (section === 'ccc' && state.config.ccc) {
         if (key === 'CHATCCC_CCC_API_KEY') val = state.config.ccc.DEEPSEEK_API_KEY || '';
         else if (key === 'CHATCCC_CCC_BASE_URL') val = state.config.ccc.DEEPSEEK_BASE_URL || '';
         else if (key === 'CHATCCC_CCC_PROVIDER') val = state.config.ccc.provider || '';
@@ -2271,14 +2287,16 @@ function editSection(section) {
         else if (key === 'CHATCCC_CCC_SUB_MODEL') val = state.config.ccc.subModel || '';
         else if (key === 'CHATCCC_CCC_ALTERNATIVE_MODEL') val = state.config.ccc.alternativeModel || '';
         else if (key === 'CHATCCC_CCC_EFFORT') val = state.config.ccc.effort || '';
-        else if (key === 'CHATCCC_CCC_CONTEXT_WINDOW') val = state.config.ccc.contextWindow || '1048576';
-      } else if (section === 'dsh' && state.config.dsh) {
-        if (key === 'CHATCCC_DSH_API_KEY') val = state.config.dsh.apiKey || '';
-        else if (key === 'CHATCCC_DSH_BASE_URL') val = state.config.dsh.baseUrl || '';
-        else if (key === 'CHATCCC_DSH_MODEL') val = state.config.dsh.model || '';
-        else if (key === 'CHATCCC_DSH_PROVIDER') val = state.config.dsh.provider || '';
-        else if (key === 'CHATCCC_DSH_MAX_TOKENS') val = state.config.dsh.maxTokens || '49152';
-      }
+        else if (key === 'CHATCCC_CCC_CONTEXT_WINDOW') val = state.config.ccc.contextWindow || '1048576';
+      } else if (section === 'dsh' && state.config.dsh) {
+        if (key === 'CHATCCC_DSH_API_KEY') val = state.config.dsh.apiKey || '';
+        else if (key === 'CHATCCC_DSH_BASE_URL') val = state.config.dsh.baseUrl || '';
+        else if (key === 'CHATCCC_DSH_MODEL') val = state.config.dsh.model || '';
+        else if (key === 'CHATCCC_DSH_SUB_MODEL') val = state.config.dsh.subModel || '';
+        else if (key === 'CHATCCC_DSH_ALTERNATIVE_MODEL') val = state.config.dsh.alternativeModel || '';
+        else if (key === 'CHATCCC_DSH_PROVIDER') val = state.config.dsh.provider || '';
+        else if (key === 'CHATCCC_DSH_MAX_TOKENS') val = state.config.dsh.maxTokens || '49152';
+      }
     }
     var isSecret = key.includes('SECRET') || key.includes('API_KEY');
     if (key === 'CHATCCC_WEB_UI_OPEN_ON_START' || key === 'CHATCCC_CHROME_DEVTOOLS_ENABLED' || key === 'CHATCCC_CODEX_FAST_MODE') {
@@ -2428,95 +2446,95 @@ function validateCli(tool) {
   });
 }
 
-// ---- 通用 Agent 引擎：一次点击，后端自动执行全部原子安装步骤 ----
-var enginePollTimers = {};
-function escapeHtml(value) {
-  return String(value == null ? '' : value).replace(/[&<>"']/g, function(char){
-    return ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'})[char];
-  });
-}
-
-function onInstallableAgentToggle(engineId, el) {
-  if (!el.checked) { onAgentToggle(engineId, false); return; }
-  onAgentToggle(engineId, true);
-  api('/api/engines/' + encodeURIComponent(engineId) + '/status', 'GET').then(function(status){
-    renderEngineStatus(engineId, status);
-    if (!status.installed && !status.running) installEngine(engineId);
-    else if (status.running) scheduleEnginePoll(engineId);
-  }).catch(function(error){
-    el.checked = false;
-    onAgentToggle(engineId, false);
-    toast('引擎状态查询失败: ' + String(error), 'error');
-  });
-}
-
-function renderEngineStatus(engineId, status) {
-  var ids = [engineId + '-engine-status', engineId + '-dashboard-engine-status'];
-  var job = status.job;
-  var state = job && job.state;
-  var text = status.installed ? ('已安装 v' + (status.version || '未知版本')) : '未安装';
-  var color = status.installed ? '#15803d' : '#64748b';
-  if (state === 'running') { text = '安装中 ' + (job.percent || 0) + '%'; color = '#1d4ed8'; }
-  if (state === 'failed') { text = '安装失败'; color = '#dc2626'; }
-  ids.forEach(function(id){
-    var el = document.getElementById(id);
-    if (!el) return;
-    el.innerHTML = '<span style="color:' + color + '">' + text + '</span>' +
-      (job && job.error ? '<br><span style="color:#dc2626;font-size:12px">' + escapeHtml(job.error) + '</span>' : '');
-  });
-  [engineId + '-engine-steps', engineId + '-dashboard-engine-steps'].forEach(function(id){
-    var root = document.getElementById(id);
-    if (!root) return;
-    root.innerHTML = job && job.steps ? job.steps.map(function(step){
-      var icon = step.state === 'completed' ? '✓' : step.state === 'failed' ? '!' : step.state === 'running' ? '●' : '○';
-      return '<div class="engine-step ' + step.state + '"><span class="engine-step-icon">' + icon + '</span><span>' +
-        escapeHtml(step.label + (step.message && step.message !== '等待中' ? ' · ' + step.message : '')) +
-        '</span><span class="engine-step-percent">' + (step.state === 'running' ? step.percent + '%' : '') + '</span></div>';
-    }).join('') : '';
-  });
-  [engineId + '-engine-install-btn', engineId + '-dashboard-engine-install-btn'].forEach(function(id){
-    var button = document.getElementById(id);
-    if (!button) return;
-    button.disabled = state === 'running';
-    button.textContent = state === 'running' ? '自动安装中…' : state === 'failed' ? '重试' : status.installed ? '原子升级/重新安装' : '安装并启用';
-  });
-}
-
-function scheduleEnginePoll(engineId) {
-  if (enginePollTimers[engineId]) clearTimeout(enginePollTimers[engineId]);
-  enginePollTimers[engineId] = setTimeout(function(){ engineRefreshStatus(engineId); }, 800);
-}
-
-function engineRefreshStatus(engineId) {
-  return api('/api/engines/' + encodeURIComponent(engineId) + '/status', 'GET').then(function(status){
-    renderEngineStatus(engineId, status);
-    if (status.running || (status.job && status.job.state === 'running')) scheduleEnginePoll(engineId);
-    return status;
-  }).catch(function(){ scheduleEnginePoll(engineId); });
-}
-
-function installEngine(engineId) {
-  var toggle = document.getElementById('agent-enable-' + engineId);
-  if (toggle && !toggle.checked) {
-    toggle.checked = true;
-    onAgentToggle(engineId, true);
-  }
-  return api('/api/engines/' + encodeURIComponent(engineId) + '/install', 'POST').then(function(result){
-    if (!result.ok) throw new Error(result.error || '启动安装失败');
-    renderEngineStatus(engineId, { installed: false, running: true, job: result.job });
-    scheduleEnginePoll(engineId);
-    return result;
-  }).catch(function(error){
-    renderEngineStatus(engineId, { installed: false, running: false, job: { state: 'failed', error: String(error), steps: [] } });
-    toast('引擎安装失败: ' + String(error), 'error');
-  });
-}
+// ---- 通用 Agent 引擎：一次点击，后端自动执行全部原子安装步骤 ----
+var enginePollTimers = {};
+function escapeHtml(value) {
+  return String(value == null ? '' : value).replace(/[&<>"']/g, function(char){
+    return ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'})[char];
+  });
+}
+
+function onInstallableAgentToggle(engineId, el) {
+  if (!el.checked) { onAgentToggle(engineId, false); return; }
+  onAgentToggle(engineId, true);
+  api('/api/engines/' + encodeURIComponent(engineId) + '/status', 'GET').then(function(status){
+    renderEngineStatus(engineId, status);
+    if (!status.installed && !status.running) installEngine(engineId);
+    else if (status.running) scheduleEnginePoll(engineId);
+  }).catch(function(error){
+    el.checked = false;
+    onAgentToggle(engineId, false);
+    toast('引擎状态查询失败: ' + String(error), 'error');
+  });
+}
+
+function renderEngineStatus(engineId, status) {
+  var ids = [engineId + '-engine-status', engineId + '-dashboard-engine-status'];
+  var job = status.job;
+  var state = job && job.state;
+  var text = status.installed ? ('已安装 v' + (status.version || '未知版本')) : '未安装';
+  var color = status.installed ? '#15803d' : '#64748b';
+  if (state === 'running') { text = '安装中 ' + (job.percent || 0) + '%'; color = '#1d4ed8'; }
+  if (state === 'failed') { text = '安装失败'; color = '#dc2626'; }
+  ids.forEach(function(id){
+    var el = document.getElementById(id);
+    if (!el) return;
+    el.innerHTML = '<span style="color:' + color + '">' + text + '</span>' +
+      (job && job.error ? '<br><span style="color:#dc2626;font-size:12px">' + escapeHtml(job.error) + '</span>' : '');
+  });
+  [engineId + '-engine-steps', engineId + '-dashboard-engine-steps'].forEach(function(id){
+    var root = document.getElementById(id);
+    if (!root) return;
+    root.innerHTML = job && job.steps ? job.steps.map(function(step){
+      var icon = step.state === 'completed' ? '✓' : step.state === 'failed' ? '!' : step.state === 'running' ? '●' : '○';
+      return '<div class="engine-step ' + step.state + '"><span class="engine-step-icon">' + icon + '</span><span>' +
+        escapeHtml(step.label + (step.message && step.message !== '等待中' ? ' · ' + step.message : '')) +
+        '</span><span class="engine-step-percent">' + (step.state === 'running' ? step.percent + '%' : '') + '</span></div>';
+    }).join('') : '';
+  });
+  [engineId + '-engine-install-btn', engineId + '-dashboard-engine-install-btn'].forEach(function(id){
+    var button = document.getElementById(id);
+    if (!button) return;
+    button.disabled = state === 'running';
+    button.textContent = state === 'running' ? '自动安装中…' : state === 'failed' ? '重试' : status.installed ? '原子升级/重新安装' : '安装并启用';
+  });
+}
+
+function scheduleEnginePoll(engineId) {
+  if (enginePollTimers[engineId]) clearTimeout(enginePollTimers[engineId]);
+  enginePollTimers[engineId] = setTimeout(function(){ engineRefreshStatus(engineId); }, 800);
+}
+
+function engineRefreshStatus(engineId) {
+  return api('/api/engines/' + encodeURIComponent(engineId) + '/status', 'GET').then(function(status){
+    renderEngineStatus(engineId, status);
+    if (status.running || (status.job && status.job.state === 'running')) scheduleEnginePoll(engineId);
+    return status;
+  }).catch(function(){ scheduleEnginePoll(engineId); });
+}
+
+function installEngine(engineId) {
+  var toggle = document.getElementById('agent-enable-' + engineId);
+  if (toggle && !toggle.checked) {
+    toggle.checked = true;
+    onAgentToggle(engineId, true);
+  }
+  return api('/api/engines/' + encodeURIComponent(engineId) + '/install', 'POST').then(function(result){
+    if (!result.ok) throw new Error(result.error || '启动安装失败');
+    renderEngineStatus(engineId, { installed: false, running: true, job: result.job });
+    scheduleEnginePoll(engineId);
+    return result;
+  }).catch(function(error){
+    renderEngineStatus(engineId, { installed: false, running: false, job: { state: 'failed', error: String(error), steps: [] } });
+    toast('引擎安装失败: ' + String(error), 'error');
+  });
+}
 
 // ---- Start ----
 init();
 
-// 页面刷新后从持久化任务文件恢复每一步的安装进度。
-setTimeout(function(){ engineRefreshStatus('claude'); engineRefreshStatus('dsh'); }, 300);
+// 页面刷新后从持久化任务文件恢复每一步的安装进度。
+setTimeout(function(){ engineRefreshStatus('claude'); engineRefreshStatus('dsh'); }, 300);
 </script>
 </body>
 </html>`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.261",
+  "version": "0.2.263",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",