跳到主内容

dsh-TUI 使用指南

DeepSeek Harness 的 Claude Code 风格终端前端，含流式 Markdown、工具卡、`/resume`、会话 fork 与全屏渲染。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

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

快速上手

dsh-TUI

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @deepseek-harness-tui/dsh-tui

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

— 源: plugins.install

关键要点

    • 终端原生交互：流式 Markdown、结构化工具卡、命令与文件补全、@ 文件引用
    • 可观察的 Agent 状态：实时工作状态、上下文分段进度、TPS、缓存命中率、
    • 完整会话工作流：/resume、/new、/compact、/export、/btw 侧问、
    • DSH 官方能力接入：Agent preset、Skills、MCP、Goals、Todos、子代理、
    • 为长会话设计：事件驱动投影、差分终端输出、消息虚拟化、回放合并与有界缓存，

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这插件和官方 web 端是什么关系？会冲突吗？

不冲突。dsh-TUI 是 Cordis bundle 插件，挂在 dsh-base 之上，使用同一份 Agent、模型、会话和工具服务；官方 dsh-web-app 也能挂同一个 profile，session/event 是共享真源，TUI 与 web 读同一份会话日志。

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

不会。dsh-TUI 是纯插件挂载（README.md:21），不修改 DeepSeek Harness 核心；卸载后 core 仍保持未改动状态。TUI 自身的偏好（主题/语言/preset 等）继续保存在 ~/.dsh-tui/ 下，可手动删除。

需要哪些环境变量才能跑起来？

必需 DEEPSEEK_API_KEY；自定义兼容端点时再设 DEEPSEEK_BASE_URL（cordis.patch.yml:28-30）。可选有 DSH_TUI_LANG（zh/en）、DSH_TUI_THEME、DSH_TUI_PERSONA、DSH_TUI_PRESET、DSH_PERMISSION_MODE 等，详见配置参考。

启动时提示"找不到 dsh"或"找不到 pnpm"怎么办？

dsh-tui 启动器会先探测 dsh --version，找不到就退出并提示 npm install -g @deepseek-ai/dsh；首次进入 profile 还要探测 pnpm，缺则提示 npm install -g pnpm（bin/dsh-tui.js:46-54 / docs/getting-started.md:228-231）。pnpm 9 会因依赖提升问题导致立即退出，请升 pnpm 10+。

为什么我启动器（全局安装）和 profile 里的 dsh-tui 版本错位就拒绝启动？

这是 issue #183（bin/dsh-tui.js:84-98）：当全局启动器比 profile 内包新一个 minor 版本时，CLI 会把启动器的 bundle patch 套到旧包上，子路径导出可能解析不到，启动必然崩溃。修正：dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui@<启动器版本> 让两者对齐。

切换 /model 时当前会话怎么办？

/model 通过 session fork 续聊实现，不原位替换。旧会话完整保留在 /resume 列表里，新会话路由到你选的新模型（docs/architecture.md:122-123）。选择持久化在 ~/.dsh-tui/model.json，重启与 /new 沿用。

终端用复制选区怎么用？支持鼠标吗？

在 fullscreen: true（默认关、被 profile patch 打开）下，拖拽选区即选即复制（OSC 52 + wl-copy/xclip/xsel 兜底，tmux 走 load-buffer -w），复制后自动取消选区并提示字符数；可设 DSH_TUI_DISABLE_MOUSE 临时关闭（src/utils/fullscreen.ts:5-10）。

Windows 上能跑吗？有什么坑？

能，但有两处差异：剪贴板粘贴走 PowerShell Get-Clipboard，图片附件以临时文件路径插入而不是内嵌块；当前没有 Windows sandbox 后端，因此 profile 在 Windows 上默认 danger-full-access 且不弹审批，敏感环境启动前请先确认 patch（docs/architecture.md:108-111）。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6+
  • Node: ^22.19.0 || >=24.0.0
  • Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则

dsh-TUI 使用指南