dsh-ccgui

# DSH 桌面版：先 Cmd+Q 完全退出，再用应用内置的 dsh 安装
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-ccgui@1.0.2

# DSH 命令行版（dsh web）
dsh plugin --profile web add dsh-ccgui@1.0.2

卸载把 add ... 换成 remove dsh-ccgui。

• 没安装的 CLI 也会列出来，发消息时提示无法启动。
• 选中 CLI 后插件才启动它询问模型，刚选中时菜单里只有它的名字，通常 1 秒左右换成真实列表；npx 启动的 CLI 第一次还要等下载。
• 费用和账号都走 CLI 自己的配置。比如 Codex 配了中转服务时，菜单里的模型不一定都能用，错误会原样显示。
• 标准模式和 PTC 模式都能用。PTC 模式只接受 run_code，所以 CLI 的每次工具调用会包成一个 run_code 程序，工具卡片显示为 run_code，不是终端或 diff 卡片。单次工具调用（包括等你审批的时间）受 PTC 运行时的超时上限约束，超时会取消 CLI 这一轮，跑很久的构建或测试建议切回标准模式。PTC 运行时不是 TypeScript 函数体格式时无法包装，会提示切回标准模式。

• 新分支从选定的 base 创建，不跟踪 base；base 是远程分支时先 fetch。已有的远程分支会在本地建同名分支并跟踪它。
• 「从 PR 创建」接受 123、#123 或 PR 链接，从 GitHub 发布的 refs/pull/<编号>/head 拉取，不需要 gh。有 upstream 远程时优先用它（fork 的 PR 在那里）；填链接时按链接里的仓库匹配远程。
• 分组按 Git 判断：一个工作区是某个仓库的 worktree、且这个仓库本身也是工作区时，就收进它的分组，在插件之外（比如命令行、CC GUI）建的 worktree 也一样。仓库本身没加成工作区的 worktree 照常显示在顶层。
• 每个 worktree 仍是一个独立的 DSH 工作区，标题是「仓库名 / 分支名」，输入框上方的工作区名显示的就是它。
• DSH 的侧边栏没有给工作区留嵌套的扩展点，分组是插件按侧边栏的结构插进去的。DSH 改了侧边栏结构的话，分组会消失，worktree 退回顶层显示，不影响使用。

• 入口在左侧栏底部的设置，排在「插件市场」后面。设置保存在浏览器本地。
• DeepSeek 是内置模型提供方，始终保留，不能关闭。关掉的 CLI 不再出现在菜单里，行内标出「已关闭」。
• 「界面交互」页签可分别关闭：右侧栏默认打开工作区文件、会话顶部的终端按钮、启动脚本。
• 「更多功能」页签列出还没开放的功能（会话自动命名、WorkTree、Git 信息自动生成、增强提示词、AI 账号限额提示），目前只有说明。
• 「版本记录」页签一个版本一页，翻页查看每个版本改了什么，当前运行的版本会标出来。
• CodeBuddy CLI 尚未用真实账号验证，默认关闭，需要时在这里打开。
• 列出的 CLI 来自打开过的会话，第一次使用前先打开任一会话。

Claude Code（项目的 .claude/settings.json，直接用 claude 时同样生效）：

{ "permissions": { "defaultMode": "default" } }

OpenCode（项目的 opencode.json）：

{ "permission": { "edit": "ask", "bash": "ask" } }

• /model 命令仍会列出所有提供方，包括 CLI。不要用它在同一会话里在 DeepSeek 和 CLI 之间切换：切到 CLI 时它没有之前的上下文，切出时压缩摘要可能失败。同一 CLI 内换模型没问题。
• 每次启动 DSH 后第一次用到某个 CLI，会短暂启动它询问模型。临时会话放在 DSH 主目录的 ccgui/model-probe；能删的会删掉，OMP 只支持关闭，每次会留下约 4KB 记录。
• CLI 启动的时间上限是 startTimeoutMs，默认 120 秒。Claude Code 的适配器连同依赖约 400MB，实测第一次启动约 100 秒，网速慢时要先调大。
• CodeBuddy CLI 要先登录或配好 API Key，否则提示 Authentication required。
• Kimi CLI 通过 npx 拉取 @moonshot-ai/kimi-code，需要 Node.js 22.19 或更高版本；要先在终端运行 npx @moonshot-ai/kimi-code@2.5.2（或已安装的 kimi），在里面用 /login 登录。
• “默认”后面的模型名按用户级配置询问得到，项目配置（比如 opencode.json）指定了别的模型时名字可能对不上，但实际仍按 CLI 的设置走。
• Codex 按停止后已启动的命令留在后台，DSH 退出时才清理，ACP 没有提供停止它们的办法。Claude Code 会把预计超过 10 分钟的命令放到后台，同样如此；它也拒绝单独的 sleep。
• 失败那一轮的消息不会自动补发（见工作原理），需要重新发送。
• CLI 的错误原文会显示并进入会话日志，可能带路径等信息。
• 折叠行显示内部名 cli_tool，状态文字仍是 DSH 的“深度求索中”。

• cli_tool 只负责记录，只对 CLI 的步骤开放，名字也不和任何真工具相同，不会把命令再执行一遍。
• Claude Code 不上报“运行中”。插件在命令的上报停下 1 秒后就显示它，否则长命令运行时界面一片空白。其他工具要等询问审批或完成时才显示，避免冻结一张没有 diff 的卡片。
• 模型列表来自 ACP 的 configOptions。它只在会话上报告，所以第一次选中某个 CLI 时插件会开一个临时会话询问，不发消息、不调用模型，清理放在后台。没选过的 CLI 不会被启动。换模型在每轮开始前用 session/set_config_option。
• 写死版本且已缓存的 npx 包直接运行；缓存不完整、版本不符、.npmrc 改过缓存目录或在 Windows 上时仍交给 npx。
• Windows 上 DSH 不经过命令行启动进程，起不来 npx、codebuddy 这类 .cmd 包装脚本。插件按 PATH 和 PATHEXT 找到实际文件：.exe 直接运行，npm / pnpm 生成的 .cmd 读出它要运行的脚本和解释器（node，或 OMP CLI 这类包用的 bun），直接用解释器启动；解释器本身也是 .cmd 时会继续往下找。其他批处理脚本无法这样启动，需要把 command 配成 .exe 或脚本解释器的完整路径。
• CLI 在协议开始前就退出时（常见于 npx 碰到一个上次没装完的缓存目录，npm 会以退出码 -4058 退出、不再重装），它的 stderr 是唯一写明原因的地方。插件收集 stderr 的末尾，随退出码一起显示；Windows 报出的无符号退出码会附上有符号值。输出里带有 _npx/<hash> 路径的安装不完整错误，会提示用户删除那个目录后重试。
• macOS 上从 Dock 打开的 DSH 只有系统默认的 PATH，看不到 nvm、fnm、Volta 装的 node，npx 系的 CLI 会以退出码 127 失败。插件启动时在后台向登录 shell 读一次 PATH；读到之前或读取失败时，在原 PATH 后补上 Homebrew、nvm、Volta、bun 等常见目录。agent 配置的 env 里写了 PATH 时以配置为准。
• 权限请求转给 DSH 审批界面。CLI 的会话 ID 存在会话日志里，重启后优先用 session/resume 接回。
• 一条用户消息最多发给 CLI 一次，重发可能让它重复做事，所以重试是关闭的。
• DSH 这一轮一结束（包括在两步之间按停止），插件就取消 CLI 的回合并丢弃剩余输出。

• 依赖：经 claude-agent-acp（Apache-2.0）运行，它基于 Claude Agent SDK。SDK 不是开源协议，本插件没有依赖或打包它，是 npx 在你机器上从 npm 下载的。
• 账号：登录订阅账号时，用量计入订阅额度。Anthropic 的条款要求基于 Agent SDK 开发产品的开发者使用 API Key，不允许代用户通过订阅凭据发送请求，并保留不经通知采取措施的权利。分发带这个默认项的版本前请先确认。
• 图标：Claude 图标和 CC GUI 相同，图形来自 lobe-icons。条款允许纯文本提及 Claude Code，其他方式使用 Anthropic 的名称和 Logo 需要书面许可，分发前请一并确认。

驱动真实的 DSH Web 界面，全程隔离在 /tmp 并关闭遥测。需要一份已构建的 DSH 源码（没有 .git 时构建要加 DSH_CLIENT_COMMIT_HASH=0000000）：

export DSH_REPO=/path/to/deepseek-harness
export CHROMIUM_PATH=/path/to/chromium   # Playwright 自带的浏览器版本不匹配时才需要

e2e/start-server.sh &             # 另开一个终端也可以
node e2e/fake-cli.mjs             # 脚本化的假 CLI，结果确定
node e2e/worktree.mjs             # 项目右键新建 Worktree（新分支、PR、嵌套分组、失败提示）

# 真实 CLI，会消耗对应账号的额度，只发几条短消息。选一个便宜的模型：
E2E_CLI='Claude Code' E2E_CLI_ID=claude E2E_MODEL='Haiku 5.5' node e2e/real-cli.mjs
E2E_CLI='Codex CLI' E2E_CLI_ID=codex E2E_KEEPS_BACKGROUND_COMMANDS=1 node e2e/real-cli.mjs
E2E_CLI='PI CLI' E2E_CLI_ID=pi E2E_MODEL='deepseek/DeepSeek V4.1 Flash' node e2e/real-cli.mjs
E2E_CLI='OMP CLI' E2E_CLI_ID=omp node e2e/real-cli.mjs
E2E_CLI=OpenCode E2E_CLI_ID=opencode E2E_MODEL='opencode/DeepSeek V4.1 Flash Free' node e2e/real-cli.mjs
E2E_CLI='CodeBuddy CLI' E2E_CLI_ID=codebuddy node e2e/real-cli.mjs   # 要先登录
E2E_CLI='Kimi CLI' E2E_CLI_ID=kimi node e2e/real-cli.mjs             # 要先登录

# 停掉服务后重启，验证恢复会话、且不重放失败的消息：
e2e/start-server.sh --keep &
E2E_CLI_ID=opencode node e2e/real-cli-resume.mjs   # 每个 CLI 各跑一次
node e2e/fake-cli-resume.mjs

真实 CLI 的测试会在它们各自的历史里留下几条工作目录在 /tmp 下的会话。

推送 v* 标签才会发版，合并到 main 不会。标签推上去后，Release 工作流会跑 pnpm check、发布到 npm、创建 GitHub Release。npm 用 Trusted Publishing 认这个仓库的 release.yml，不需要令牌。

# 1. 在开发分支上开发，分支名不要和标签同名（用 dev/1.0.2，不用 v1.0.2）
git checkout -b dev/1.0.2
git push -u origin dev/1.0.2
# 开 PR 合到 main，CI 通过后合并

# 2. 合并后在 main 上发版
git checkout main && git pull
npm version patch -m "chore: release v%s"   # 修复用 patch，新功能用 minor，不兼容改动用 major
git push --follow-tags

• npm version 会改 package.json 的版本号、提交并打标签，标签和版本号对不上时工作流会拒绝发布。
• 不要在 GitHub 网页上用「Draft a new release」发版：工作流最后创建 Release 时会因为它已存在而失败。
• npm 上发布过的版本号不能重发。某次发布中途失败，修好后重跑工作流即可，已在 npm 上的版本会跳过发布、只补建 Release。
• 新版本在 npm 上可能先显示 Validating，自动审核通过后才能安装。