dsh-tianshu-tui

为 DSH 提供交互式终端界面,支持流式 Markdown、工具与审批卡片、多会话标签、主题、Slash 命令、LSP 诊断、成本统计和可选视觉问答。

快速判断

安装前先看这几项

配置资料
配置资料完整
配置难度
较高
适合新手
建议具备相关经验
兼容状态
声明兼容,尚未实测
验证状态
源码已审阅,未标记运行实测
你正在查找符合当前筛选条件的插件
← 返回原筛选结果
本页目录(9)
中文教程

按照固定来源完成安装、配置与验证

教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。

查看 dsh-tianshu-tui 安装与配置教程 →
功能

这个插件能做什么

为 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 中实际执行。

安装到
tui Profile
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。

  1. 01
    检查 Node.js 与 pnpm

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

    环境检查
    node --version && pnpm --version
  2. 02
    安装到独立终端 Profile

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

    GitHub 源码(锁定提交)
    npx --yes @deepseek-ai/[email protected] plugin --profile tui add github:huiliyi37/dsh-tianshu-tui#1ff44e3dea8c
  3. 03
    确认 Bundle 已进入配置

    先完成上方安装说明要求的准备或配置,再导出组合配置,不启动 Agent。输出中应能找到包名 @huiliyi37/dsh-tianshu-tui或对应 Bundle 层。

    检查配置
    npx --yes @deepseek-ai/[email protected] --profile tui --dump-config
  4. 04
    启动并完成最小验证

    在真实交互式终端(TTY)中启动同一 Profile,只测试一个只读任务;Web 页面是否出现不能作为 TUI 加载依据。

    在终端启动 DSH TUI
    npx --yes @deepseek-ai/[email protected] --profile tui
卸载与回退

测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。

从终端 Profile 移除
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。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。

复制 可选:首次测试关闭 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 退出。
验证

配置检查与成功结果

  1. 01
    导出 tui Profile 的组合配置
    复制验证命令
    npx --yes @deepseek-ai/[email protected] --profile tui --dump-config

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

  2. 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 包。
卸载后的清理步骤
  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 已改动的文件和已启动的语言服务不会因卸载回滚。
深入审计:兼容性、数据流与来源
证据

兼容性与审阅记录

兼容性说明

插件版本 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
中文资料
有完整中文配置资料