- DSH
- 0.2.1-rc.5
- 系统
- Windows / macOS / Linux
- 风险
- high
本页目录(13)
先查看功能、兼容性、权限和同类选择,再按本文操作。
当前默认 DSH 0.2.2-rc.1 提醒(2026-11-06)
本页固定的 0.18.0 不兼容当前默认 DSH 0.2.2-rc.1:36 项 DSH peer 都是精确版本列表,最高只到 0.2.1-rc.5。 npm 默认版本已改为 0.2.2-rc.1,未锁版本的 npx @deepseek-ai/dsh 会取得它,并在安装或启动时拒绝本插件。下方命令继续固定 DSH 0.2.1-rc.5,这个组合仍按 B1 记录适用;2026-11-06 npm 上尚无 TUI 新版本。不要用版本豁免强装,等作者发布声明支持 0.2.2 的版本。升级宿主前先看0.2.2-rc.1 升级检查。依据:兼容判断实现(外部链接,在新标签页打开)。
B1 固定版本维护记录(2026-11-01)
本页从 0.12.0 升级至 0.18.0,安装目标与 DSH 命令已同步更新。此前 11-01 的候选暂缓记录保存在批次审核历史中;本轮补齐发行包绑定与配置/权限静态审阅后,转为带风险说明的 source_reviewed,不提升为运行验证。
重新取得 npm 精确版,SHA-512 与元数据一致;registry 的两条 ECDSA 签名验证通过。发行 tag 解引用与本页 40 位提交一致。provenance 声明的摘要与工作流提交已比对,但未验证完整 Sigstore 信任链,未独立重建产物。发行包不附带 src,静态 bundle 与源代码不能据此宣称可复现构建。
以上不是安全认证,也没有执行安装、登录、模型请求、迁移、终端、远程或更新流程。使用前按下文迁移与退出路径逐项核对。
依据:固定证据 1(外部链接,在新标签页打开)、固定证据 2(外部链接,在新标签页打开)。
DSH TUI 0.18.0 提供终端会话、模型与预设切换、扩展管理和独立 CLI;本页固定 DSH 0.2.1-rc.5,使用独立 dsh-tui Profile 与真实 TTY。
如果你的目标是在真实终端配置独立 TUI Profile、扩展授权与受控更新,本教程会说明如何在 DeepSeek Harness(DSH)中准备、安装、配置、验证和回退 dsh-TUI。本文锁定作者仓库提交 1d0d946f459d;已复核固定提交的原始资料,未进行运行实测。
对应插件:查看 dsh-TUI 的功能、权限与兼容性说明。先确认它适合你的工作流,再执行安装。
本次版本与使用入口
本站从 0.12.0 升至固定 0.18.0,配套命令改为 DSH 0.2.1-rc.5。下面使用独立 dsh-tui Profile;请在真实交互式终端运行 npx --yes @deepseek-ai/[email protected] --profile dsh-tui。全局启动器 dsh-tui / dst 是作者另一条入口,可能读取不同全局 DSH 和包版本,本页不要求全局安装。不要用 DSH Web 页面是否出现来判断 TUI 是否加载。
先确认是否适合你
- 分类:界面交互
- 风险等级:high
- 核验证据:source_reviewed
- 兼容性边界:2026-11-06 复查:本页固定的 0.18.0 不兼容当前默认 DSH 0.2.2-rc.1:36 项 DSH peer 都是精确版本列表,最高只到 0.2.1-rc.5;安装命令继续固定 DSH 0.2.1-rc.5,npm 上尚无更新版本。原声明:0.18.0 的 npm 包所声明 DSH peer 均接受 0.2.1-rc.5,已无 dsh-invariants 依赖。Node.js 要求 ^22.19 || >=24,需 pnpm 10+ 和真实 TTY;设置依赖配套 @deepseek-ai/schemastery >=3.18.3。以上为声明和源码静态复核,未验证加载、Windows、TTY、OAuth 或重启。
- 主要权限关注:安装或启用扩展可写 ~/.dsh-tui/extension-grants.json,按组件及 scope 授权,不能假定每项授权都会单独弹窗;该机制不隔离第三方 Node 代码。更新器可写 Profile 依赖、锁文件与 pnpm-workspace.yaml,并启动安装进程或重启;按实际宿主/后端核对 sandbox 与 approval。
如果你准备在重要工作区使用,先阅读插件详情页的权限和数据流说明;“源码已审阅”或“资料已整理”都不等于安全认证。
安装前准备
本页 DSH 命令版本: 0.2.1-rc.5。B1 已复核 0.18.0 固定发行包、声明与源码,本文命令固定 DSH 0.2.1-rc.5;只代表静态审阅,不是插件运行通过。旧组合 0.12.0 + 0.2.0-rc.2 仅用于识别备份,不与新版交叉混装。
- DSH 0.2.1-rc.5:0.18.0 的 npm 包所声明 DSH peer 均接受 0.2.1-rc.5,已无 dsh-invariants 依赖。Node.js 要求 ^22.19 || >=24,需 pnpm 10+ 和真实 TTY;设置依赖配套 @deepseek-ai/schemastery >=3.18.3。以上为声明和源码静态复核,未验证加载、Windows、TTY、OAuth 或重启。
- 独立环境与备份:使用独立 dsh-tui Profile、可丢弃工作区和受限系统账号,升级前保存依赖、锁文件、补丁和插件状态。
- 真实 TTY 与 pnpm 10+:使用真实交互式终端;本轮没有验证 Windows、TTY、pnpm 11 或便携版,Node.js 采用 ^22.19 或 >=24。
- 安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本,并确认
pnpm可用。 - 使用独立的
dsh-tuiProfile 和可丢弃测试工作区,不直接连接生产目录。 - 备份当前 Profile 配置,并记录安装前的
--dump-config输出。 - 核对固定来源中的外部服务、账号、运行时和平台限制。
- 需要凭据时只准备测试凭据;本页识别到的候选变量包括
DEEPSEEK_API_KEY、DEEPSEEK_BASE_URL、DSH_TELEMETRY_MODE。
安装 dsh-TUI
52DSH 使用目录中记录的精确安装目标,避免直接跟随可能变化的默认分支:
npx --yes @deepseek-ai/[email protected] plugin --profile dsh-tui add @deepseek-harness-tui/[email protected]
GitHub 源码插件如果被 pnpm 拦截构建脚本,先检查终端提示的具体包和脚本。只在 dsh-tui Profile 中放行确实需要的构建项,不要全局放行未知依赖。
插件专属配置
配置目标
$DSH_HOME/profiles/dsh-tui/cordis.patch.yml:用户覆盖层;与依赖清单、锁文件和 pnpm-workspace.yaml 一同备份。~/.dsh-tui/settings.json 与 extension-grants.json:前者保存各后端共用偏好,后者保存带 scope 的扩展授权;升级前一起备份。
环境变量
DEEPSEEK_API_KEY(可选),敏感:仅 deepseek-official API 路由需要;账号登录另走独立凭据路径。DEEPSEEK_BASE_URL(可选):覆盖 API 端点并影响余额查询接收方,改网关前确认数据流。DSH_TELEMETRY_MODE(可选):DISABLED 控制 OTel 会话日志通道,不会同时关闭 API 请求中的插件清单与会话日志元数据。
独立 TUI Profile 的模型与显示设置
证据:固定来源(外部链接,在新标签页打开)。按上方配置目标使用本段内容;如有占位符,替换为测试值。
- id: dsh-tui
config:
provider: deepseek-official
model: deepseek-flash
effort: max
fullscreen: false
安装后设置
- 以下为可自行执行的隔离验证步骤;52DSH 本轮未安装或启动插件。
- 停止旧进程后用固定版本安装命令更新,同一 Profile 不混用全局启动器与不同 DSH 版本。
- 在测试项目的真实终端启动同一 dsh-tui Profile;先查看 /permission 与 /preset status,检查实际 sandbox 和 approval。
- 不在本次最小任务中使用 /update、OAuth 登录、后端 SDK 安装或扩展安装。
从 0.12.0 迁移设置与授权
先停止 TUI,备份 Profile 的 package.json、锁文件、cordis.patch.yml、pnpm-workspace.yaml 以及 ~/.dsh-tui。0.18.0 的常规设置首次从 Profile 或旧 settings.yaml 导入 ~/.dsh-tui/settings.json,之后各后端共用;其他插件设置仍交给宿主。覆盖 Loader 行时 config 整块替换,不能把片段当深合并。
扩展安装/启用流程会按组件声明添加具名、带 scope 的授权;安装前可读声明时可能先写授权再加载,失败尽力回滚。npm 声明需安装后读取,流程另有授权步骤;不要据此保证所有路径逐项确认。旧字符串 grant 不再自动授权,旧 deny 保守保留;损坏或未知结构的授权文件会拒写并警告,安装不一定中止。授权文件不能充当 OS 沙箱。
0.18.0 的 bundle 继承官方 sandbox、approval 与遥测配置;旧版 Windows danger-full-access 和 never 风险应作为升级前检查背景,不是此版本所有平台的固定默认值。实际权限仍须查看当前 Profile、预设及所选后端。
配置验证与成功结果
先导出配置,再在真实 TTY 中启动同一 Profile 的终端界面:
npx --yes @deepseek-ai/[email protected] --profile dsh-tui --dump-config
npx --yes @deepseek-ai/[email protected] --profile dsh-tui
-
核对精确宿主、包版本和唯一挂载行;导出配置成功不算运行验证。
npx --yes @deepseek-ai/[email protected] --profile dsh-tui --dump-config期望结果:配置引用 @deepseek-harness-tui/[email protected] 对应包,未出现重复挂载;继续验证前先核对权限。
-
在真实 TTY 中启动同一 Profile,创建空会话,仅询问一句公开事实。
期望结果:终端显示 0.18.0,流式输出可见;未触发更新或文件修改。这是待执行的验证步骤。
第一次使用
- 用 /resume 查看测试会话,再用 /new 创建空会话;仅发送只读问题并检查模型与权限。
自更新和重启的写入范围
/update 会更新并重启,dsh-tui update 只做更新阶段;它们不承诺留在本文 0.18.0。更新器会改写 Profile 的 pnpm-workspace.yaml,补充 allowBuilds: false、异平台可选包过滤,并可能为目标/原版本写入 minimumReleaseAgeExclude,绕过对应包的新包等待期。还会调用安装器、处理失败残留并对齐全局启动器;便携版另走下载替换二进制的路径。本轮没有运行这些流程,也没有核对 Windows 便携安装器。
需要复现本页时使用上方精确版本命令。更新失败先停止,保存脱敏日志,恢复整套 Profile 备份;不要在安装进程未退出时再次更新或手工删包。Claude/Codex 后端、登录与 SDK 安装另行配置,不作为本页最小验证。
数据、权限与凭据
数据流: 会话与凭据由 DSH 及所选后端保存,TUI 偏好和扩展授权位于 ~/.dsh-tui;余额查询携带凭据访问配置的 API 端点。0.18.0 继承官方请求元数据与反馈遥测配置,不能再声称 TUI 默认禁用全部遥测;通知和渲染日志可能包含对话片段。
权限关注: 安装或启用扩展可写 ~/.dsh-tui/extension-grants.json,按组件及 scope 授权,不能假定每项授权都会单独弹窗;该机制不隔离第三方 Node 代码。更新器可写 Profile 依赖、锁文件与 pnpm-workspace.yaml,并启动安装进程或重启;按实际宿主/后端核对 sandbox 与 approval。
数据存储: TUI 设置、扩展授权、输入历史及重启日志位于 ~/.dsh-tui;会话、Provider 凭据和 OAuth 凭据分别由宿主及相关后端保存,凭据位置以固定配置为准。
真实 Token、API Key、Cookie 和账号 ID 不应写进 Git 仓库、网页截图或公开 Issue。测试结束后撤销临时凭据。
卸载、回退与清理
停止 DSH 后,从同一个 Profile 移除包:
npx --yes @deepseek-ai/[email protected] plugin --profile dsh-tui remove @deepseek-harness-tui/dsh-tui
- 停止同一 Profile 的 DSH,再运行 npx --yes @deepseek-ai/[email protected] plugin --profile dsh-tui remove @deepseek-harness-tui/dsh-tui;导出配置确认已移除。
- 恢复升级前整套 Profile 和插件状态备份,不混用新旧状态;卸载不会撤销文件修改、子会话或外部授权。
凭据、日志与上报边界
余额查询使用配置端点与凭据,切换网关前确认接收方。官方组合的插件清单、会话日志请求元数据及反馈 OTel 是不同通道;DSH_TELEMETRY_MODE=DISABLED 只控制 OTel,不能替代其他开关。系统通知可能携带最后回复片段,Windows 通知注册会写用户注册表。排障后清理渲染与重启日志,卸载不会自动撤销外部 OAuth 授权。
常见问题
TUI 没有出现或启动即退出
核对真实 TTY、Node.js、pnpm、实际 Profile 与 schemastery 版本,保存脱敏启动错误,不通过安装更多插件排查。
更新失败或全局启动器仍是旧版
停止更新流程并检查安装器是否退出,恢复 Profile 备份;全局启动器与 Profile 包需一致。不要用 /update 复现本文固定版本。
安装成功但页面或命令没有出现
先运行 --dump-config 确认 Bundle 已进入 dsh-tui Profile,再在真实 TTY 中启动同一 Profile,检查 Node.js、pnpm 与终端错误。不要通过反复扩大权限来解决加载问题。
插件运行后没有得到预期结果
把问题缩小到本页的最小验证任务,检查作者文档要求的变量、外部服务和平台限制。保存终端错误原文,并核对当前安装目标是否仍对应本页固定提交。
作者提供了独立故障文档,可从下方“固定来源证据”进入;本页没有把整份 README 复制过来。
固定来源证据
以下资料是本文配置结论的依据:
- README.md(外部链接,在新标签页打开)
- docs/configuration.md(外部链接,在新标签页打开)
- docs/README.md(外部链接,在新标签页打开)
- docs/configuration.en.md(外部链接,在新标签页打开)
- docs/getting-started.en.md(外部链接,在新标签页打开)
- docs/user-guide.en.md(外部链接,在新标签页打开)
继续查看:返回 dsh-TUI 插件详情页,重新核对兼容性、权限、同类插件和来源状态。
来源与维护信息
本文根据以下原始资料整理。版本变化后,请以官方资料和页面标注的验证日期为准。
- GitHub:ccch1mneyyy/dsh-TUI(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 package.json(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 LICENSE(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 cordis.patch.yml(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 README_ZH.md(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 configuration.md(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 getting-started.md(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 grant-file.ts(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 plugin-install.ts(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 plugin-manage.ts(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 grants.ts(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 update.ts(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 deepseekBalance.ts(外部链接,在新标签页打开)
- GitHub:deepseek-ai/deepseek-harness 固定提交 plugin-compatibility.ts(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 README.md(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 README.md(外部链接,在新标签页打开)
- GitHub:ccch1mneyyy/dsh-TUI 固定提交 configuration.en.md(外部链接,在新标签页打开)