终端交互界面 agentforce314/dsh-ccTUI

dsh-ccTUI

面向 Deepseek-Harness 的 Claude Code 风格 TUI — 🐳 从 clawcodex 的 ui-tui 移植而来，并打包为 dsh 捆绑插件（npm 包 dsh-cctui）。

完整的 Claude-Code 风格外观、质感和交互 — 流式 markdown 记录、带 diff 卡片的工具轨迹、审批和提问提示、计划审查、会话切换与恢复、斜杠命令、模型选择器、上下文栏 — 在进程内针对 harness 服务运行（ctx.agents、session/event、审批瀑布流、ctx.userQuestions、ctx.commands）。

██████╗ ███████╗██╗ ██╗ ██████╗ ██████╗████████╗██╗ ██╗██╗
██╔══██╗██╔════╝██║ ██║ ██╔════╝██╔════╝╚══██╔══╝██║ ██║██║
██║ ██║███████╗███████║ █████╗ ██║ ██║ ██║ ██║ ██║██║
██║ ██║╚════██║██╔══██║ ╚════╝ ██║ ██║ ██║ ██║ ██║██║
██████╔╝███████║██║ ██║ ╚██████╗╚██████╗ ██║ ╚██████╔╝██║
╚═════╝ ╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═════╝ ╚═╝
🐳 Claude Code style TUI for Deepseek-Harness

╭─── dsh-ccTUI v0.3.0 ─────────────────────────────────────────────────────────────────────────╮
│ │
│ Welcome back, you │ ▾ Available Tools │
│ │ harness: bash, create_goal, edit, …+22 │ │ : ' : │ │ │ ___'_______ │ ▸ Available Skills (0) │ │ /' o \--. │ │ │ | ___\ │ ────────────────────────────────────────────── │ │ \____________/ \/ │ 25 tools · 0 skills · /help for commands │ │ \__/ \__/ │ │ │ │ │ │ ──────────── │ │ │ Model deepseek-v4-flash │ │ │ Path ~/workspace/dsh-ccTUI │ │ │ Perms Ask for approval · /permissions │ │ │ Session cctui-56b37bee-41fd-4feb-b270-5988… │ │ │ │ ╰──────────────────────────────────────────────────────────────────────────────────────────────╯

安装

需要 Node ≥ 22.19、npm、pnpm，以及 dsh CLI（npm install -g @deepseek-ai/dsh）。

git clone https://github.com/agentforce314/dsh-ccTUI.git
cd dsh-ccTUI
./install.sh # 构建，然后：dsh plugin --profile dsh-cctui add "$PWD"
dsh --profile dsh-cctui # 启动（或 ./bin/dsh-cctui.js）

模型/提供商配置来自你的 dsh 配置文件（agent-default-model 设置，或配置文件 cordis.patch.yml 中的 - id: cctui 配置覆盖：provider、model、 cwd、sessionId）。

API 密钥

TUI 不存储任何密钥；harness 会为每个请求解析一个密钥。将其写入托管存储 $DSH_HOME/.credentials.yaml（默认 ~/.dsh/.credentials.yaml）——一个凭据引用到值的 YAML 映射，除此之外别无他物：

DEEPSEEK_API_KEY: sk-…

对该文件执行 chmod 600，对 ~/.dsh 执行 chmod 700：dsh-credentials-local 拒绝读取带有任何组或其他权限位的文档，并会在启动时失败并指明修复方法。
该文档会被监视，因此在 TUI 运行时存储的密钥会在下一个请求时生效——首次运行是“浏览模型、存储密钥、再次提示”，中间无需重启。
在某个密钥解析成功之前，路由保持注册，/model 保持可浏览；失败的是请求，并会以 MISSING_CREDENTIAL 指明它查找过的每一个入口点。

启动环境优先于存储（DEEPSEEK_API_KEY=… dsh --profile dsh-cctui），并且从内部看是刻意只读的；存储又优先于 /.env 和 ~/.dsh/.env。将密钥本身排除在 cordis.patch.yml 之外——适配器配置只携带 apiKeyEnv，即要解析的引用。一个密钥同时覆盖对话和 web_search 工具。

模式 0600 阻止的是其他操作系统用户，而不是模型：harness 从不把该文档的路径交给它，也从不把值加载到环境中，但 bash 和文件系统工具以你的身份运行，且随附的策略限制的是写入而非读取。

亮点

- 对话循环：流式增量实时渲染；推理显示一两行，完整的思维链在 Ctrl+O 之后；忙碌动词和加载指示器；Esc 中断（Ctrl+C 从不杀死应用）。
- 工具：Claude 风格的 ⏺ Tool(args) / ⎿ result 轨迹——每次调用保留自己的一行，带有它打开的路径或它运行的命令，后面是返回内容的几行以及… +N lines (ctrl+o to expand)；失败的调用带有工具自身的消息，正在运行的调用带有自己的计时；写入/编辑差异渲染为结构化差异卡片；沙箱升级审批会弹出审批框（1 批准 / 2+Enter 拒绝）；待办列表固定在忙碌行下方。
- 子代理：一次委派显示为 ⏺ Subagent(Review the diff) / ⎿ Done (2 tool uses · 1.2k tokens · 11s)，其子项流入 /agents——目标、实时工具调用、 token、生成树。
- 会话：/sessions（Ctrl+X）列出活动会话和持久化会话；/resume 重放持久化记录，包括工具结果等；/new、/title、/rename。
- 命令：每个 harness ctx.commands 条目（例如 /plan、/goal）都会出现在补全菜单并通过 harness 进行分发；/model 打开由 llm 目录支持的选择器；/effort、/context、/usage、/help、/status。
- 模式：Shift+Tab 循环切换 default → plan → bypassPermissions（映射到 harness 的 plan-mode 控制器和审批策略）。

配置

环境开关使用 DSH_CCTUI_ 前缀——例如 DSH_CCTUI_INLINE=0（使用备用屏幕而非内联回滚缓冲区）、DSH_CCTUI_THEME=light|dark、DSH_CCTUI_HOME（数据目录，默认 ~/.dsh-cctui）、DSH_CCTUI_FPS=1。CLAUDE_CODE_SCROLL_SPEED 仍被支持，作为从 Claude Code 迁移过来的用户的回退选项。

开发

npm install
npm run typecheck && npm test # 149 files / ~1900 tests
npm run e2e # PTY e2e against a real dsh boot + scripted LLM
npm run e2e:install # the real dsh plugin add install path

工具行是最难用肉眼检查的表面，因此它们有自己的测试工具：
python3 scripts/tool-gallery.py [tool…] [--expand] 通过每个场景一个
harness 工具驱动真实的 dsh 启动（经由脚本化的 test/e2e/probe-llm.mjs），并打印其渲染出的轨迹——这就是用来与对 Claude Code 发起的相同调用进行对比的东西。

版本管理

每次发布的变更都会将 patch 位数字加一；它会一直递增到 99，然后进位到 minor 位：

0.2.0 → 0.2.1 → … → 0.2.13 → … → 0.2.99 → 0.3.0 → 0.3.1 → …

编写 patch 号时不要带前导零（0.3.1，而不是 0.3.01——后者不是有效的 semver，npm 会拒绝它）。在变更自身的提交中更新 package.json，然后在其合并后在 main 上打上 v 标签。

架构和移植细节：docs/ARCHITECTURE.md、 docs/PLAN.md、docs/PORTING-NOTES.md。适配器边界（src/harness/ 是唯一可以导入 @deepseek-ai/* 的地方）由 CI 把关。

来源与许可证

MIT。相当一部分内容移植自 MIT 许可的 clawcodex ui-tui（包括其分叉的 Ink 渲染器），并采用了 MIT 许可的 dsh-TUI 项目中的集成模式——详见 NOTICE.md。