dsh-TUI

为 DeepSeek Harness 提供 Claude Code 风格终端入口，支持流式状态、工具审批、会话管理、终端图片与公式、模型与 Preset 切换、Skills、MCP、子 Agent，以及内置订阅与 DeepSeek 账号登录。

• DSH 0.2.0-rc.2（必需）：0.12.0 的部分 peer 只接受 0.2.0-rc.1 或 rc.2，旧宿主会被安装门禁拒绝。
• Node.js 与 pnpm 10+（必需）：Node.js 需满足 ^22.19 或 >=24；pnpm 9 会导致 TUI 启动后立即退出。
• 交互式终端（必需）：必须在真实 TTY 中启动；由 DSH Web 等非终端宿主启动时 TUI 会自动跳过。
• 专用测试 Profile（必需）：作者默认使用 dsh-tui Profile；在已有 Profile 上安装前先备份用户 cordis.patch.yml。
• 测试模型凭据（必需）：只使用测试 Provider 或测试账号，不把密钥、token 写入仓库或截图。

本页命令固定使用 DSH 0.2.0-rc.2，与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录；新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到

web Profile

DSH 基线

0.2.0-rc.2

安装来源

npm 预构建包（锁定版本）

固定目标

@deepseek-harness-tui/[email protected]

0.12.0 的 DSH peer 覆盖 0.2.0-rc.1 与 0.2.0-rc.2，其中 dsh-deepseek-account、dsh-host-webserver 只接受 0.2.0 系列，本页固定 DSH 0.2.0-rc.2；DSH 0.1.x 用户继续使用 0.9.3。仅静态复核，未在本站运行验证。

• DSH 版本组合来源 1 ↗（外部链接，在新标签页打开）
• DSH 版本组合来源 2 ↗（外部链接，在新标签页打开）

1. 01
   检查 Node.js 与 pnpm

   DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：

   环境检查复制命令

   node --version && pnpm --version

2. 02
   安装到 Web Profile

   这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。

   npm 预构建包（锁定版本）复制命令

   npx --yes @deepseek-ai/[email protected] plugin --profile web add @deepseek-harness-tui/[email protected]

3. 03
   确认 Bundle 已进入配置

   安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 @deepseek-harness-tui/dsh-tui或对应 Bundle 层。

   检查配置复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

4. 04
   启动并完成最小验证

   启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。

   启动 DSH Web复制命令

   npx --yes @deepseek-ai/[email protected] web

npx --yes @deepseek-ai/[email protected] plugin --profile web remove @deepseek-harness-tui/dsh-tui

$DSH_HOME/profiles/web/cordis.patch.yml

用户覆盖层：调整 dsh-tui 行的模型、推理档位、全屏、图片预览与 Preset；按作者默认安装时对应 profiles/dsh-tui/。

dsh-tui-webserver 行（同一 cordis.patch.yml）

DeepSeek 账号登录的本地回调监听，默认 127.0.0.1 随机端口；SSH 场景可改固定端口。

dsh-tui-auth 行（同一 cordis.patch.yml）

内置订阅 OAuth 的 providers、credentialsFile 与 modelOverrides；覆盖时是整段替换。

- id: dsh-tui
  config:
    provider: deepseek-official
    model: deepseek-flash
    effort: max
    activity: true
    contextBar: true
    fullscreen: false
    terminalImages: true

- id: dsh-tui-webserver
  config:
    host: 127.0.0.1
    port: 43123

npx --yes @deepseek-ai/[email protected] plugin --profile web add @deepseek-harness-tui/[email protected]

1. 在测试项目目录的终端中运行 npx --yes @deepseek-ai/[email protected] --profile web 启动 TUI；按作者默认安装到 dsh-tui Profile 时改用 --profile dsh-tui。
2. 先运行 /preset status 与 /permission，确认实际 Preset、sandbox 和 approval。
3. Windows 用户在接触敏感目录前先收紧 danger-full-access 与 approval=never。
4. 如需 DeepSeek 账号登录，运行 /auth login deepseek-account，再用 /model 选择 deepseek-account 下的模型；它与需要 DEEPSEEK_API_KEY 的 deepseek-official 是不同路由。

1. 01
   确认组合配置中出现 dsh-tui、dsh-tui-auth 与 working-activity 行。

   复制验证命令复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

   期望结果：能看到 @deepseek-harness-tui/dsh-tui 及其补丁行，没有重复的 dsh-working-activity。

2. 02
   在空测试仓库启动 TUI 并发送一个只读问题。

   期望结果：流式输出正常，横幅显示 v0.12.0，状态行可见且没有文件变化。

3. 03
   在足够高的终端窗口里触发一个需要审批的低风险测试动作。

   期望结果：审批选项完整可见，行为符合当前 Profile；Windows 上不得假定存在沙箱。

• 用 /resume 查看测试工作区会话，再用 /new 创建空会话并确认模型和权限状态。
• 运行 /auth status 查看各账号登录状态，只在测试账号上尝试登录与退登。

复用所选 DSH Profile 的模型凭据、工具、文件、Shell、审批和会话存储，自身无沙箱；Windows 默认 danger-full-access 且 approval=never。新增内置 OAuth 保存长期 refresh token，DeepSeek 账号登录会在 127.0.0.1 启动本地回调监听；/update 会改写 profile 的 pnpm-workspace.yaml。

数据存储：会话写入 $DSH_HOME/sessions；TUI 偏好、输入历史、resume.txt 与 restart.log 写入 ~/.dsh-tui；/provider 添加的 API key 写入 ~/.dsh/.credentials.yaml；内置 OAuth 的 refresh token 写入 $DSH_HOME/dsh-auth/credentials.json；DeepSeek 账号凭据由宿主保存。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

安装被门禁拒绝并提示与 dsh 0.1.x 不兼容

0.12.0 只适配 DSH 0.2.0-rc.1/rc.2；升级宿主到 0.2.0-rc.2，或继续使用旧插件版本，不要用版本豁免强行安装。

用 GitHub 地址安装报 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 WORKSPACE_PKG_NOT_FOUND

作者不支持 Git URL 安装，改用 npm 包 @deepseek-harness-tui/[email protected]。

启动后权限过大

停止 TUI，检查 Profile 的 sandbox 与 approval；不要用功能测试代替权限核对。

全屏下看不到审批选项

放大终端窗口或在覆盖层把 fullscreen 设为 false；看不清命令全貌时选择拒绝。

/update 后新功能没有生效

若同时存在全局安装，DSH 可能仍读取旧全局补丁；同步把全局包对齐到同一版本后重启。

启动后立即退出且几乎没有报错

检查 pnpm 版本，升级到 10 及以上后重新安装插件。