- DSH
- 0.1.0-rc.8
- 系统
- Windows / macOS / Linux
- 风险
- high
本页目录(11)
先查看功能、兼容性、权限和同类选择,再按本文操作。
DSH 0.2.0-rc.2 兼容提示(2026-10-02)
本页固定的天枢 TUI 0.1.2-rc.12 声明的 DSH 依赖范围只覆盖 0.1.x,DSH 0.2.0 起会拒绝安装或在启动时停用(外部链接,在新标签页打开)这个版本。
- 上游 1.0.0-rc.2 声明兼容 0.2.0,但它的 29 个依赖中有 21 个是作者自行分叉的 DSH 核心包(
@huiliyi37/cordis、dsh-agent、dsh-fs、dsh-llm等),并接管 Agent 的命令与文件工具;这些分叉的源码仓库无法访问(作者说明为闭源),本站无法审阅,暂不推荐(见 1.0.0-rc.2 的 package.json(外部链接,在新标签页打开))。 - 使用 DSH 0.2.0-rc.2 的用户:目前没有本站推荐的天枢 TUI 版本。
- 仍在 DSH 0.1.x 的用户:继续使用本页的组合,命令固定旧版 DSH。
- 本页已标记为待复核,依赖来源可以审阅后再更新。
升级 DSH 前怎样处理已装插件,见已装插件被停用。
为 DSH 提供交互式终端界面,支持流式 Markdown、工具与审批卡片、多会话标签、主题、Slash 命令、LSP 诊断、成本统计和可选视觉问答。
如果你的目标是在终端中组合 DSH 多会话、审批卡片、LSP 和成本统计,本教程会说明如何在 DeepSeek Harness(DSH)中准备、安装、配置、验证和回退 dsh-tianshu-tui。本文锁定作者仓库提交 1ff44e3dea8c;已复核固定提交的原始资料,未进行运行实测。
对应插件:查看 dsh-tianshu-tui 的功能、权限与兼容性说明。先确认它适合你的工作流,再执行安装。
先确认是否适合你
- 分类:界面交互
- 风险等级:high
- 核验证据:source_reviewed
- 兼容性边界:插件版本 0.1.2-rc.12,peer 依赖主要声明 DSH 0.1.0-rc.8 系列;本站完成固定提交静态审阅,未在真实 TTY、Windows、各类 LSP 或自动更新路径运行
- 主要权限关注:复用 DSH 会话、Agent、工具、审批、凭据和子 Agent 服务;可读取工作区内 @ 引用文件、系统剪贴板,启动外部编辑器与语言服务器,并在 npm 安装来源下自动更新和重启宿主
如果你准备在重要工作区使用,先阅读插件详情页的权限和数据流说明;“源码已审阅”或“资料已整理”都不等于安全认证。
安装前准备
本页 DSH 命令版本: 0.1.0-rc.8。G1 按固定提交复核:天枢 TUI 0.1.2-rc.12 的 15 个 DSH peer 均为 ^0.1.0-rc.8,作者 README 要求宿主 CLI 为 0.1.0-rc.8,本页命令统一固定该版本,不再混用 0.1.1-rc.2。只代表静态审阅,不是插件运行通过;DSH 0.2.x 用户见上方兼容提示。
- 独立 tui Profile 与测试 DSH_HOME:插件在 dsh-base 之上挂载 tui-runner,必须装进单独的 tui Profile,不要装进 web Profile。建议设置单独的 DSH_HOME 测试目录,与日常 ~/.dsh 和其他 TUI 插件隔离;作者也用这种方式绕开 ERR_FS_EISDIR。
- 真实 TTY、Node.js 与 pnpm:在真实交互式终端中运行;Node.js 需 ^22.19 或 >=24,PATH 上要有 pnpm(dsh plugin 会转发给它)。模型凭据可用 DEEPSEEK_API_KEY 或官方登录流程。
- 安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本,并确认
pnpm可用。 - 使用独立的
tuiProfile 和可丢弃测试工作区,不直接连接生产目录。 - 备份当前 Profile 配置,并记录安装前的
--dump-config输出。 - 核对固定来源中的外部服务、账号、运行时和平台限制。
- 需要凭据时只准备测试凭据;本页识别到的候选变量包括
DEEPSEEK_API_KEY、DSH_HOME、DSH_TUI_SKIP_UPDATE、DSH_TUI_UPDATE_REGISTRY、EDITOR。
安装 dsh-tianshu-tui
52DSH 使用目录中记录的精确安装目标,避免直接跟随可能变化的默认分支:
npx --yes @deepseek-ai/[email protected] plugin --profile tui add github:huiliyi37/dsh-tianshu-tui#1ff44e3dea8c
固定 Git 树已包含 lib/index.js,package.json 没有 prepare 或安装脚本,不需要放行构建,也不要运行作者的 build 或 npm test。pnpm 提示 peer missing 时按作者说明可忽略:peer 由同一 DSH 0.1.0-rc.8 宿主提供,不要另装 @deepseek-ai/* 包。只用本页带版本号的 npx 命令,不直接运行 PATH 上的 dsh。
插件专属配置
配置目标
$DSH_HOME/profiles/tui/cordis.patch.yml:Profile 用户覆盖层;覆盖已有 id: tui-runner 行的 config,不要重复 insert。patch 会整体替换该行 config。~/.dsh-tui/:prefs.json(主题、密度、面板显隐)、input-history.json(最多 1000 条输入原文)和 update-cache.json(npm 更新检查缓存);不随 DSH_HOME 变化。TUI 内 /config 面板:查看宿主设置、权限预设和凭据状态(只显示是否存在,不显示明文);/yolo 与 Shift+Tab 的 always-approve 会放行全部审批,测试时不要开启。
环境变量
DEEPSEEK_API_KEY(可选),敏感:模型 API Key;也可以改用官方 CLI 的登录流程。只用测试 Key,不写进命令历史或截图。DSH_HOME(可选):DSH 数据目录;指向单独的测试目录可以隔离 Profile、会话和旧安装残留。DSH_TUI_SKIP_UPDATE(可选):设为 1 时不执行自动升级。固定提交的实现会先查询 npm latest(缓存 1 小时)再判断该变量,因此它不能阻止这次联网查询。DSH_TUI_UPDATE_REGISTRY(可选):自更新检查的 registry 列表(逗号分隔),默认 registry.npmjs.org,超时回退 registry.npmmirror.com。EDITOR(可选):Ctrl+E 打开外部编辑器时使用的命令(也会读取 VISUAL),会启动本机程序。
可选:首次测试关闭 LSP 诊断与更新后自动重启
证据:固定来源(外部链接,在新标签页打开)。按上方配置目标使用本段内容;如有占位符,替换为测试值。
- id: tui-runner
config:
lsp:
enabled: false
autoRestartOnUpdate: false
安装后设置
- 以下是可自行执行的隔离验证步骤;52DSH 本轮没有安装或启动插件。
- 在测试 DSH_HOME 下安装到 tui Profile 后,先运行 --dump-config,确认只有一个 tui-runner 行。
- 需要关闭 LSP 时,在 $DSH_HOME/profiles/tui/cordis.patch.yml 写入上方覆盖,再导出配置确认生效。LSP 默认开启,TypeScript 语言服务会通过 npx -y 下载运行,其他语言服务按 PATH 探测。
- 在真实终端用同一版本启动 tui Profile,看到欢迎页品牌 dsh-tianshu-tui 后再提问;Ctrl+Q 或 /exit 退出。
配置验证与成功结果
先导出配置,再在真实 TTY 中启动同一 Profile 的终端界面:
npx --yes @deepseek-ai/[email protected] --profile tui --dump-config
npx --yes @deepseek-ai/[email protected] --profile tui
-
导出 tui Profile 的组合配置
npx --yes @deepseek-ai/[email protected] --profile tui --dump-config期望结果:出现 id: tui-runner、name 为 @huiliyi37/dsh-tianshu-tui 的一行,没有重复挂载;导出成功不代表 TUI 能启动。
-
在真实 TTY 中启动同一 Profile,只问一个不涉及文件写入的问题
npx --yes @deepseek-ai/[email protected] --profile tui期望结果:欢迎页显示 dsh-tianshu-tui、会话短 id 和环境检查行,回答以流式方式出现;这是待执行的验证步骤,本站未运行。
第一次使用
- 在测试工作区输入“只列出当前目录的文件名,不要读取或修改文件”,观察工具卡和审批卡;不开启 /yolo,不用 @ 引用敏感文件。
数据、权限与凭据
数据流: 终端输入、附件、工作区文件摘要与剪贴板 → Tianshu TUI 适配层 → DSH 会话、模型、工具、审批和可选视觉模型 → 流式结果与状态渲染回终端;主题和输入偏好写入 ~/.dsh-tui。
权限关注: 复用 DSH 会话、Agent、工具、审批、凭据和子 Agent 服务;可读取工作区内 @ 引用文件、系统剪贴板,启动外部编辑器与语言服务器,并在 npm 安装来源下自动更新和重启宿主
数据存储: 会话、Profile 与凭据由 DSH 宿主保存在 DSH_HOME(默认 ~/.dsh);TUI 自己在 ~/.dsh-tui 写入偏好、输入历史原文和更新检查缓存,不随 DSH_HOME 隔离。卸载插件不会删除这些文件。
真实 Token、API Key、Cookie 和账号 ID 不应写进 Git 仓库、网页截图或公开 Issue。测试结束后撤销临时凭据。
卸载、回退与清理
停止 DSH 后,从同一个 Profile 移除包:
npx --yes @deepseek-ai/[email protected] plugin --profile tui remove @huiliyi37/dsh-tianshu-tui
- 退出 TUI 后在同一测试 DSH_HOME 下运行 npx --yes @deepseek-ai/[email protected] plugin --profile tui remove @huiliyi37/dsh-tianshu-tui,再导出配置确认 tui-runner 已消失。
- 需要时删除测试 DSH_HOME 和 ~/.dsh-tui(含输入历史原文),并撤销测试 API Key;Agent 已改动的文件和已启动的语言服务不会因卸载回滚。
常见问题
ERR_FS_EISDIR 或 Path is a directory .../@deepseek-ai/dsh
这是错误码,不是环境变量。PATH 上旧的 dsh 或 ~/.dsh/profiles/node_modules 里的旧安装与 0.1.0-rc.8 冲突;改用本页带版本号的 npx 命令,并换一个干净的 DSH_HOME 重新安装。
在 DSH 0.1.1-rc.2 或 0.2.x 下使用
本版本只按 0.1.0-rc.8 审阅:0.1.1-rc.2 不在 peer 声明范围内,本站没有验证能否加载;0.2.0 起宿主会拒绝安装或停用。请在 0.1.0-rc.8 的独立 Profile 中使用,不要为兼容强行改 peer 或混装版本。
启动后提示插件已更新或自动重启
本页用固定 Git 提交安装,按固定源码不会被自动改写成 npm 版本;如果看到更新提示,先确认 Profile 的 package.json 仍是本页安装目标,没有被改成 npm 包。
安装成功但页面或命令没有出现
先运行 --dump-config 确认 Bundle 已进入 tui Profile,再在真实 TTY 中启动同一 Profile,检查 Node.js、pnpm 与终端错误。不要通过反复扩大权限来解决加载问题。
插件运行后没有得到预期结果
把问题缩小到本页的最小验证任务,检查作者文档要求的变量、外部服务和平台限制。保存终端错误原文,并核对当前安装目标是否仍对应本页固定提交。
作者提供了独立故障文档,可从下方“固定来源证据”进入;本页没有把整份 README 复制过来。
固定来源证据
以下资料是本文配置结论的依据:
- README.md(外部链接,在新标签页打开)
- docs/configuration.md(外部链接,在新标签页打开)
- README.en.md(外部链接,在新标签页打开)
- docs/getting-started.md(外部链接,在新标签页打开)
- vision-ask/README.md(外部链接,在新标签页打开)
- docs/getting-started.en.md(外部链接,在新标签页打开)
继续查看:返回 dsh-tianshu-tui 插件详情页,重新核对兼容性、权限、同类插件和来源状态。
来源与维护信息
本文根据以下原始资料整理。版本变化后,请以官方资料和页面标注的验证日期为准。
- GitHub:huiliyi37/dsh-tianshu-tui(外部链接,在新标签页打开)
- GitHub:huiliyi37/dsh-tianshu-tui 固定提交 package.json(外部链接,在新标签页打开)
- GitHub:huiliyi37/dsh-tianshu-tui 固定提交 README.md(外部链接,在新标签页打开)
- GitHub:deepseek-ai/deepseek-harness 固定提交 README.zh.md(外部链接,在新标签页打开)
- GitHub:huiliyi37/dsh-tianshu-tui 固定提交 configuration.md(外部链接,在新标签页打开)
- GitHub:huiliyi37/dsh-tianshu-tui 固定提交 README.en.md(外部链接,在新标签页打开)
- GitHub:huiliyi37/dsh-tianshu-tui 固定提交 getting-started.md(外部链接,在新标签页打开)