用 Tianshu TUI 管理 DSH 多会话、审批与 LSP 诊断

在 DeepSeek Harness(DSH)中安装 Tianshu TUI,配置多会话、工具审批、Slash 命令、LSP、成本统计和可选视觉问答。

可能过期已复核原始来源
DSH
0.1.0-rc.8
系统
Windows / macOS / Linux
风险
high
本页目录(11)
对应插件dsh-tianshu-tui

先查看功能、兼容性、权限和同类选择,再按本文操作。

查看插件详情 →

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 前怎样处理已装插件,见已装插件被停用。

依据:固定证据 1(外部链接,在新标签页打开)。

为 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 或官方登录流程。
  1. 安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本,并确认 pnpm 可用。
  2. 使用独立的 tui Profile 和可丢弃测试工作区,不直接连接生产目录。
  3. 备份当前 Profile 配置,并记录安装前的 --dump-config 输出。
  4. 核对固定来源中的外部服务、账号、运行时和平台限制。
  5. 需要凭据时只准备测试凭据;本页识别到的候选变量包括 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

安装后设置

  1. 以下是可自行执行的隔离验证步骤;52DSH 本轮没有安装或启动插件。
  2. 在测试 DSH_HOME 下安装到 tui Profile 后,先运行 --dump-config,确认只有一个 tui-runner 行。
  3. 需要关闭 LSP 时,在 $DSH_HOME/profiles/tui/cordis.patch.yml 写入上方覆盖,再导出配置确认生效。LSP 默认开启,TypeScript 语言服务会通过 npx -y 下载运行,其他语言服务按 PATH 探测。
  4. 在真实终端用同一版本启动 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
  1. 导出 tui Profile 的组合配置

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

    期望结果:出现 id: tui-runner、name 为 @huiliyi37/dsh-tianshu-tui 的一行,没有重复挂载;导出成功不代表 TUI 能启动。

  2. 在真实 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
  1. 退出 TUI 后在同一测试 DSH_HOME 下运行 npx --yes @deepseek-ai/[email protected] plugin --profile tui remove @huiliyi37/dsh-tianshu-tui,再导出配置确认 tui-runner 已消失。
  2. 需要时删除测试 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 复制过来。

固定来源证据

以下资料是本文配置结论的依据:

继续查看:返回 dsh-tianshu-tui 插件详情页,重新核对兼容性、权限、同类插件和来源状态。

来源与维护信息

本文根据以下原始资料整理。版本变化后,请以官方资料和页面标注的验证日期为准。

完成当前任务后

按结果继续,不要停在文章末尾

已成功

继续完成配置、验证或下一阶段任务。

继续下一步 →
仍未解决

保留现象和错误原文,再进入对应排障路径。

DSH 安装 Git 插件被 allowBuilds 阻止怎么办 →安装和管理 DeepSeek Harness(DSH)插件 →