MIT 的 DSH 插件，把外部 Agent CLI（Claude Code、Kimi、Codex、PI、OMP、OpenCode、CodeBuddy）注册成 ACP 模型提供方，并补上模型菜单、变更面板、worktree 与启动脚本。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-12
许可证
MIT
01它能帮你完成什么？
在 DSH 输入框里直接和 Claude Code / Codex / PI / OMP / OpenCode 会话
一条 ACP 会话：工具调用、审批和改动摘要都显示在 DSH 原生界面里，模型菜单列出该 CLI 真实可用的模型
已经买了某个 Agent CLI 订阅、想在一个 DSH 窗口里同时做规划和 CLI 执行的开发者
不离开 DSH 就审阅 CLI 改出来的代码，并开出隔离的 worktree
按已暂存 / 未暂存 / 未跟踪分组的变更面板（可暂存、撤销、提交、推拉、切分支，带行内 diff），以及从新分支、已有分支或 PR 创建的 Git worktree
希望在同一个侧边栏里审改动、开分支的 DSH 用户
02如何接入 DeepSeek Harness？
前置条件
- DSH `>=0.2.2-rc.1 <0.3.0`（README 快速开始里写明的版本范围）
- 至少一个已安装并登录的受支持 CLI；插件沿用 CLI 自己的登录状态，不接触 token
- 走命令行安装时，需要 PATH 上有 `dsh`，或用 DSH 桌面版内置的那个 `dsh`
安装步骤
- 01
点 DSH 左侧栏的「插件」，点右上角「添加插件」，输入 `dsh-ccgui` 后点「安装」
- 02
提示重启时用 Cmd+Q 完全退出再打开——README 明确说不要点「立即启用」，新旧代码混在一个进程里会启动失败
- 03
新建会话，点输入框 `+` 右边的 CLI 按钮选一个 CLI
- 04
命令行方式：`dsh plugin --profile web add dsh-ccgui@1.0.2`；桌面版用 `"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-ccgui@1.0.2`
$ dsh plugin --profile web add dsh-ccgui@1.0.2
验证接入成功
作者未说明
回滚
- 在同一条命令里把 `add …` 换成 `remove dsh-ccgui` 即可卸载
03DSH 适配与能力边界
把外部 Agent CLI 注册成 DSH 的模型提供方（ACP 会话），工具卡片、审批卡片与变更摘要仍走 DSH 原生界面
把外部 CLI 当成模型提供方
输入框旁菜单里选中的 CLI→一条 ACP 会话：工具全部由 CLI 自己执行，DSH 侧只做记录
每个打开的会话占一个 CLI 进程，直到会话关闭或 DSH 退出来自 ACP configOptions 的模型菜单
当前选中的 CLI→该 CLI 上报的模型列表，第一项是它自己的默认模型，超过 4 项可搜索
每次启动 DSH 后第一次用到某个 CLI 会短暂启动它询问模型；临时会话放在 `ccgui/model-probe`，OMP 每次会留下约 4KB 记录变更面板、启动脚本、文件与终端
当前工作区→带行内 diff 的暂存 / 撤销 / 提交 / 推拉 / 切分支，按工作目录记住的启动命令，文件树里插入 `@路径`，以及右侧栏终端
启动脚本在单独的终端标签里跑，再点一次会先关掉上一次的CC GUI 设置页
左侧栏底部的设置入口→CLI 菜单的顺序与开关、每项界面交互的单独开关，以及按版本分页的版本记录
设置保存在浏览器本地，不写进 profile
04适合谁？何时不该用？
适合
- 已经买了某个 Agent CLI 订阅、想在一个 DSH 窗口里同时做规划和 CLI 执行的开发者
- 希望在同一个侧边栏里审改动、开分支的 DSH 用户
不适合
- DSH 的沙箱管不到 CLI：每个 CLI 自己决定哪些操作要询问，它放行的操作不会弹 DSH 审批卡片。要拦住操作必须配置 CLI 自己的权限。
- 不支持 `/compact`、fork、回滚和运行中插话；运行中发的消息会排队到这一轮结束。
- README 面向 DSH `>=0.2.2-rc.1 <0.3.0`，其他宿主版本未声明支持。
- DSH 启动 CLI 时会去掉名字含 KEY、PASSWORD、SECRET、TOKEN 的环境变量，`ANTHROPIC_API_KEY` 这类变量要写在 agent 配置的 `env` 里。
- 默认的 Claude Code 项经 claude-agent-acp 与 Claude Agent SDK 运行；Anthropic 条款要求基于 Agent SDK 开发的产品使用 API Key，不允许代用户转发订阅凭据，分发带该默认项的版本前需自行确认。
05兼容性、维护与安全提示
- DSH 的沙箱管不到 CLI：每个 CLI 自己决定哪些操作要询问，它放行的操作不会弹 DSH 审批卡片。要拦住操作必须配置 CLI 自己的权限。
- 不支持 `/compact`、fork、回滚和运行中插话；运行中发的消息会排队到这一轮结束。
- README 面向 DSH `>=0.2.2-rc.1 <0.3.0`，其他宿主版本未声明支持。
- DSH 启动 CLI 时会去掉名字含 KEY、PASSWORD、SECRET、TOKEN 的环境变量，`ANTHROPIC_API_KEY` 这类变量要写在 agent 配置的 `env` 里。
- 默认的 Claude Code 项经 claude-agent-acp 与 Claude Agent SDK 运行；Anthropic 条款要求基于 Agent SDK 开发的产品使用 API Key，不允许代用户转发订阅凭据，分发带该默认项的版本前需自行确认。
MIT 源码；本文所有事实均来自记录提交处的仓库 README，未做独立安全审计。
06常见问题
在 DeepSeek Harness 里怎么装 dsh-ccgui？
点 DSH 左侧栏的「插件」→「添加插件」，输入 `dsh-ccgui` 后点「安装」；提示重启时用 Cmd+Q 完全退出再打开。README 特别说明不要点「立即启用」，否则新旧代码混在一个进程里会启动失败。命令行 profile 也可以用 `dsh plugin --profile web add dsh-ccgui@1.0.2`。
支持哪些 DSH 版本和哪些 CLI？
DSH `>=0.2.2-rc.1 <0.3.0`，外加至少一个已安装并登录的 CLI。README 覆盖 Claude Code、Kimi CLI、Codex CLI、PI CLI、OMP CLI、OpenCode 和 CodeBuddy——其中 CodeBuddy 尚未用真实账号验证，默认关闭。
DSH 的沙箱和审批卡片管得住 CLI 的工具调用吗？
管不住。README 明确写「DSH 的沙箱管不到 CLI」：每个 CLI 自己决定哪些操作要询问，它放行的操作不会弹 DSH 审批卡片。要拦住操作，得去配置 CLI 自己的权限。
会话中途能换 CLI 或换模型吗？
模型能换，菜单里列的是 CLI 真实上报的模型，切换后下一条消息生效；CLI 只能在发第一条消息前选，要换 CLI 得新建会话。
为什么 CLI 会话不显示 tok/s、token 用量和缓存命中？
ACP 每轮只给一个累计用量，换算不成 DSH 按单次请求统计的口径，插件宁可隐藏也不显示错数字。DSH 侧的上下文压缩（包括 billion-context 这类插件）对 CLI 会话同样不生效——历史存在 CLI 那边，由 CLI 自己压缩。
07相关的 DSH 工作流
archify
作者 tt-a1i
为编码智能体生成美观可验证的架构图、时序图与数据流图，输出自包含 HTML，支持动效与清晰导出。
openviking
作者 volcengine
为 AI 智能体打造的自进化上下文数据库，统一智能体记忆、知识 RAG 与技能。
aitoearn
作者 yikart
面向抖音、快手、小红书和视频号的 AI 内容发布工作流，提供相关平台与 MCP 工具集成。
learn-harness-engineering
作者 walkinglabs
Harness 工程新手教程，从 0 到 1 系统学习智能体工作流框架。
08数据与来源
在输入框旁选一个 CLI，就像用模型一样和它对话。工具调用、审批和改动摘要都走 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）的原生界面。
CLI 注册为 DSH 的模型提供方，不需要改 agent loop。一轮 CLI 回合跨越多个 DSH 步骤：每遇到工具调用就结束这一步，CLI 上报结果后下一步接着读。工具都由 CLI 自己执行，DSH 侧只做记录。
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-11-12。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。