本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-tianshu-tui

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @huiliyi37/dsh-tianshu-tui

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• Node.js ^22.19 || >=24
• PATH 上有 pnpm（dsh plugin 会转发给它）
• 输入框长文本性能 — 折行逐字符量宽走缓存（10 万字符草稿每次按键 ~1.3s → ~10ms）；粘贴可编辑阈值抬至 100 行/10000 字（此前 10 行即收成标记）；输入视窗 16 行上限（超出折叠「… 上/下 N 行」）；Home/End/Ctrl+U/K 以逻辑行为范围、PageUp/Down 翻页、↑↓ 按软折行移动；换行模式下粘贴并入草稿不提交
• Ctrl+C 连按退出无死角 — 窗口内第二次恒退出（有草稿时第一次清空、Ctrl+Z 可恢复）；打断中第二次直接退出不用等落定；vim normal 下 Esc 空操作不再误弹 rewind；Kitty 键盘协议 CSI u 完整解码（Ctrl+C=CSI 99;5u、release 事件去重）
• 活区卡片语言统一 — 工具卡/委派树/后台任务一套符号：进行中 ⠋、成功 ›、失败 ✗、正文 ⎿；终态行后退（muted）；正在跑的子代理和 build 终于长得像同类对象

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件和官方 web 端会冲突吗？能不能同时装？

不冲突。本插件是 Cordis bundle patch，挂在 dsh-base 之上，使用同一份 Agent、模型、会话和工具服务；与 dsh-web-app 可以装在同一 profile 下，session/event 共享同一份真源（README.md:78-83 / cordis.patch.yml:1-7）。

卸载插件会丢失已有会话吗？会改动 harness 核心吗？

不会。本插件不修改 DeepSeek Harness 核心代码，TUI 自身的偏好与输入历史保存在 ~/.dsh-tui/ 下，卸载后可手动删除（README.md:316-325 / docs/getting-started.md:32-50）。

启动时提示 ERR_FS_EISDIR / Path is a directory .../@deepseek-ai/dsh 怎么办？

这是 ~/.dsh/profiles/node_modules 里旧的安装 fallback 与官方 CLI 冲突。用干净 DSH_HOME 目录重装即可：DSH_HOME=/tmp/dsh-tianshu npx -y @deepseek-ai/[email protected] plugin --profile tui add @huiliyi37/dsh-tianshu-tui（README.md:67-72 / docs/getting-started.md:54-60）。

图片粘贴了但模型说看不见怎么办？

主模型不识图时需要装配视觉桥插件 dsh-vision-bridge（provide visionBridge 服务）或在装配方里显式注入 vision 配置；两者皆无则图片不发送并显示警告，这是有意的 fails loud（README.md:259 / docs/getting-started.md:68-70）。

LSP 诊断为什么只在 TUI 屏上显示，模型看不到？

本插件里的 LSP 桥是展示层本地桥：诊断只进工具卡徽标与 /lsp 面板，不注册到模型工具面；如需模型可调 lsp_goto_definition 等工具，再装 omdsh-dev/dsh-lsp（README.md:96 / docs/getting-started.md:72-74）。

怎么关闭启动时的 npm 更新检查？

设置环境变量 DSH_TUI_SKIP_UPDATE=1 即可跳过；github: 或 link: 安装的副本不会被改写成 npm 包（README.md:53 / docs/configuration.md:30-38）。

更新后一定要退出再手动重启吗？

0.1.2-rc.10 起，会话未开始工作时启动自更新落盘后会自动重启；会话非空白或关闭 autoRestartOnUpdate 时只提示，可手动输入 /restart（README.md:106 / src/index.ts:177-189）。

Windows 上能跑吗？需要注意什么？

能。Ctrl+C 打断会同时产生 0x03 字节与 SIGINT 信号，0.1.2-rc.10 已加 SIGINT 双注册与去重避免「输入框消失」（README.md:110 / src/index.ts:144-160）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.7+
• Node: ^22.19 || >=24
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则