安装前先看这几项
- 配置资料
- 配置资料完整
- 配置难度
- 较高
- 适合新手
- 建议具备相关经验
- 兼容状态
- 声明兼容,尚未实测
- 验证状态
- 源码已审阅,未标记运行实测
本页目录(9)
按照固定来源完成安装、配置与验证
教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。
这个插件能做什么
为 DSH 提供交互式终端界面,支持流式 Markdown、工具与审批卡片、多会话标签、主题、Slash 命令、LSP 诊断、成本统计和可选视觉问答。
需要OCR、截图识别、图片识别能力的用户。
该插件涉及较高配置难度或敏感权限,不建议在生产工作区直接试装。
安装前准备
- DSH 版本组合(必需):作者 README 要求宿主 CLI 为 @deepseek-ai/dsh 0.1.0-rc.8;15 个 DSH peer 均声明 ^0.1.0-rc.8,0.1.1-rc.2 等其他预发布版本按 npm semver 默认规则不满足。本页命令统一固定 0.1.0-rc.8;DSH 0.2.0 起会拒绝或停用本版本。只做固定提交静态复核,未安装或运行。
- 独立 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 或官方登录流程。
如何安装 dsh-tianshu-tui
本页命令固定使用 DSH 0.1.0-rc.8,与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录;新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。
下面的命令使用本站核验的 DSH 基线,并锁定插件版本或 Git commit,避免默认分支变化导致安装内容漂移。本站已核对安装目标,但尚未在你的系统和 Profile 中实际执行。
- 安装到
tuiProfile- DSH 基线
0.1.0-rc.8- 安装来源
- GitHub 源码(锁定提交)
- 固定目标
github:huiliyi37/dsh-tianshu-tui#1ff44e3dea8c
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 用户见上方兼容提示。
固定 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。
- 01检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上,并且
pnpm必须已在 PATH 中。先运行:环境检查node --version && pnpm --version - 02安装到独立终端 Profile
这条命令会把插件加入
tuiProfile,并在插件声明 DSH Bundle 时自动加入配置层。GitHub 源码(锁定提交)npx --yes @deepseek-ai/[email protected] plugin --profile tui add github:huiliyi37/dsh-tianshu-tui#1ff44e3dea8c - 03确认 Bundle 已进入配置
先完成上方安装说明要求的准备或配置,再导出组合配置,不启动 Agent。输出中应能找到包名 @huiliyi37/dsh-tianshu-tui或对应 Bundle 层。
检查配置npx --yes @deepseek-ai/[email protected] --profile tui --dump-config - 04启动并完成最小验证
在真实交互式终端(TTY)中启动同一 Profile,只测试一个只读任务;Web 页面是否出现不能作为 TUI 加载依据。
在终端启动 DSH TUInpx --yes @deepseek-ai/[email protected] --profile tui
测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。
npx --yes @deepseek-ai/[email protected] plugin --profile tui remove @huiliyi37/dsh-tianshu-tui插件专属配置
$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 诊断与更新后自动重启 · yaml。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。
- 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 退出。
配置检查与成功结果
- 01导出 tui Profile 的组合配置复制验证命令
npx --yes @deepseek-ai/[email protected] --profile tui --dump-config期望结果:出现 id: tui-runner、name 为 @huiliyi37/dsh-tianshu-tui 的一行,没有重复挂载;导出成功不代表 TUI 能启动。
- 02在真实 TTY 中启动同一 Profile,只问一个不涉及文件写入的问题复制验证命令
npx --yes @deepseek-ai/[email protected] --profile tui期望结果:欢迎页显示 dsh-tianshu-tui、会话短 id 和环境检查行,回答以流式方式出现;这是待执行的验证步骤,本站未运行。
第一次使用建议这样验证
- 在测试工作区输入“只列出当前目录的文件名,不要读取或修改文件”,观察工具卡和审批卡;不开启 /yolo,不用 @ 引用敏感文件。
它可能接触哪些数据和能力
复用 DSH 会话、Agent、工具、审批、凭据和子 Agent 服务;可读取工作区内 @ 引用文件、系统剪贴板,启动外部编辑器与语言服务器,并在 npm 安装来源下自动更新和重启宿主
数据存储:会话、Profile 与凭据由 DSH 宿主保存在 DSH_HOME(默认 ~/.dsh);TUI 自己在 ~/.dsh-tui 写入偏好、输入历史原文和更新检查缓存,不随 DSH_HOME 隔离。卸载插件不会删除这些文件。
请注意:“源码已审阅”说明本站检查到的证据范围,不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。
故障排查与数据清理
- 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 包。
- 退出 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 已改动的文件和已启动的语言服务不会因卸载回滚。
深入审计:兼容性、数据流与来源
兼容性与审阅记录
兼容性说明
插件版本 0.1.2-rc.12,peer 依赖主要声明 DSH 0.1.0-rc.8 系列;本站完成固定提交静态审阅,未在真实 TTY、Windows、各类 LSP 或自动更新路径运行
数据流
终端输入、附件、工作区文件摘要与剪贴板 → Tianshu TUI 适配层 → DSH 会话、模型、工具、审批和可选视觉模型 → 流式结果与状态渲染回终端;主题和输入偏好写入 ~/.dsh-tui。
源码审阅结论
已审阅固定提交的入口、会话适配、工作区引用、外部编辑器、剪贴板、LSP、自更新和重启实现。文件引用限制在 cwd 且摘要截断,但外部编辑器、剪贴板工具和 LSP 都会启动本机程序;TypeScript LSP 默认可通过 npx -y 获取。npm 安装版本还会在启动时查询 npm/npmmirror、执行包管理器升级并重启 DSH,可用 DSH_TUI_SKIP_UPDATE=1 关闭。
来源与维护信息
本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后,请重新核对作者说明。
- 来源快照
08f3df46cca1- 固定提交
1ff44e3dea8c- 许可证
- Apache-2.0
- 主要语言
- TypeScript
- 中文资料
- 有完整中文配置资料