前言¶
如果需要在终端里使用 DeepSeek Harness（DSH）的模型、Session、命令、审批、工具和 subagents，同时希望交互方式更接近 Claude Code，下面介绍 cogine-ai/dsh-claude-tui。
它是一个非官方的 DSH TUI 客户端，包描述为：
Unofficial, high-fidelity Claude Code-style TUI for DeepSeek Harness, verified against real PTY captures
先做本地安装，再进入终端界面，之后就可以用 DSH 的真实模型和 Session 继续工作。
这是什么¶
dsh-claude-tui 由 cogine-ai 维护，MIT 许可证，当前包版本为 0.1.5。
它解决的是一个比较具体的问题：把 DSH 的运行时能力放进一个终端界面里，让用户在命令行中完成模型选择、会话恢复、输入编辑、审批确认、工具观察和 subagents 管理。
需要注意：这是一个独立社区项目，不与 Anthropic 或 DeepSeek 有从属、背书或赞助关系。项目中的 “Claude Code” 用于标识版本固定的交互目标，不包含 Anthropic 源代码。
核心功能¶
终端界面¶
TUI 提供以下界面元素：
- Claude-shaped welcome panel
- prompt
- menus
- transcript
- status rows
- approvals
- questions
- Agent states
欢迎面板会显示实际运行时信息：
- TUI 版本
- Harness 版本
- bundled 或 system runtime
- DSH Home
- tool mode
DSH 运行时能力¶
这个 TUI 读取并展示 DSH 侧的能力，而不是把模型、effort、凭证或审批行为硬编码在界面里。
已核实的能力包括：
- DSH-owned models
- durable Sessions
- commands
- approval policies
- tools
- structured questions
- subagents
- Provider/model catalog
- advertised effort levels
- saved defaults
- masked API-key entry
- credential-source visibility
输入与执行信息¶
输入侧支持：
- Multiline editing
- image paste
- submit or steer
- cancellation
- history search
- slash completion
- bounded
@file mentions
执行侧可以看到：
- Reasoning and tool activity
- compact/expanded results
- cache hit rate
- token totals
- TTFT
- throughput
- turn outcome
Session 和 Agent 流程方面，支持：
- New or resumed Sessions
- graceful flush
- foreground/background subagents
- an active-agent roster
安装与启用¶
运行环境要求 Node.js 22.19+ 或 24+。
一次性启动：
npx --yes --legacy-peer-deps dsh-claude-tui
legacy-peer-deps 是一个临时的 npm 安装绕过，用于处理 rc2 的 dense upstream peer graph。
如果需要固定本次发布版本：
npx --yes --legacy-peer-deps dsh-claude-tui@0.1.5
反复使用时，可以全局安装：
npm install --global --legacy-peer-deps dsh-claude-tui@0.1.5
然后运行：
dshtui
典型用法¶
先启动 TUI：
npx --yes --legacy-peer-deps dsh-claude-tui
如果需要真实模型请求，需要先为选中的 DSH provider 提供凭证。
检查或输入凭证：
/provider
切换 DSH 暴露的模型和 effort levels：
/model
也可以使用快捷键：
Option+P
Alt+P
恢复 Session：
dshtui --resume
恢复指定 Session：
dshtui --resume <session-id>
切换 plan mode：
Shift+Tab
该快捷键会执行 DSH 的 /plan 或 /plan off 命令。
粘贴图片：
Ctrl+V
它会读取一张桌面剪贴板图片，并添加 Claude 的 [Image #N] composer marker。
图片提交路径会验证并持久化字节，写入 rc2 的：
ctx.attachments
并走 attachment-aware 的：
execute(agent, line, images, signal)
适用场景与注意¶
适合以下场景：
- 需要把 DSH 的模型、Session、工具和审批流程放进终端
- 需要熟悉 Claude Code 风格的输入、查看和执行反馈
- 需要在命令行中恢复 Session、查看 subagents、处理 approvals
- 希望在不脱离 DSH runtime 的前提下完成日常 agent 工作
使用前需要注意：
- 这是一个独立社区项目，不是 Anthropic 或 DeepSeek 官方项目。
- 它以当前 DSH 进程权限运行。安装前应检查源码、许可证和依赖锁定。
- 许可证为 MIT。
- 真实模型请求需要所选 DSH provider 的凭证。
- 本版本把 bundled runtime 固定到 DeepSeek Harness
0.1.1-rc.2，外部 runtime 要求为>=0.1.1-rc.2 <0.1.2。 - 不要对同一个
$DSH_HOME并发运行不同 Harness 版本。 - 除非 DeepSeek Harness 文档说明了支持的迁移路径，不要降级 Home。
结尾¶
dsh-claude-tui 的价值，是把 DSH 的模型、Session、命令、审批、工具和 subagents 放进一个更贴近 Claude Code 的终端工作流里。它不是官方客户端，也不是对 Claude 云服务的模拟，而是面向 DSH 运行时的非官方 TUI。
- GitHub：https://github.com/cogine-ai/dsh-claude-tui
- 插件目录页：https://www.skillhub.cn/plugins/cogine-ai/dsh-claude-tui
