前言¶
在 DSH 的插件扩展方式里，终端交互经常要同时处理模型、上下文、工具活动、子代理、会话和主题。dsh-tui-pi 把这些终端侧能力集中到一个插件包里：它给 dsh 提供一套 pi-style terminal UI，包含 pi-tui look & feel、dsh slash commands、GitHub light/dark themes 和 powerline footer。
下面介绍它的定位、安装方式、典型用法和需要注意的地方。需要说明的是，社区目录是独立站点，不等同于官方应用商店。
这是什么¶
dsh-tui-pi 是一个面向 DeepSeek Harness（dsh）的插件。安装使用的包名是：
@aiwayds/dsh-tui-pi
已核实的版本与环境信息如下：
- 要求 dsh 版本不低于
0.1.2-rc.1 - alpha line 不再支持
package.json声明engines为node >=22.19.0- 许可证为
MIT
启动时会有一个 host 版本检查：如果当前 dsh 低于要求版本，插件会执行 startup guard 并干净退出。如果确实需要跳过这个检查，可以设置：
DSH_TUI_SKIP_HOST_CHECK=1
核心功能¶
下面列出已核实的功能点：
- Footer：底部显示 live session overview，包括
provider/model、context pressure和session cache-hit rate。 - Think & tool panels：提供 Think 面板和 tool 面板。
- Subagents：为运行中的 subagent 提供 status line，并支持 live steering。
- Ask User Question：模型可以暂停并提出结构化问题，回答过程不离开 TUI。
- Feishu integration：提供 Feishu 集成；可选插件为
@aiwayds/dsh-feishu。 - Dynamic context pruning (DCP)：提供动态上下文裁剪。
- Persistent context：提供持久化上下文。
- Model profiles & favorites：提供模型配置与收藏。
- Agent preset switching：提供 agent preset 切换。
- Sessions & resume：提供会话与恢复能力。
- Themes：提供 GitHub light/dark palettes，支持 hot-switchable；
auto会跟随 terminal。 - Search, selection & images：提供搜索、选择和图片相关能力。
- Slash commands：提供 slash commands。
- Startup plugin tree：启动时展示 plugin tree。
安装与启用¶
先确认环境满足要求：
dsh >= 0.1.2-rc.1
node >=22.19.0
alpha line 不支持
安装插件：
dsh plugin --profile tui add @aiwayds/dsh-tui-pi
启动对应的 TUI profile：
dsh --profile tui
如果已经安装过，并且插件升级后需要处理已有 profile，可以执行：
node scripts/dev-upgrade.mjs
也可以先预览升级计划：
node scripts/dev-upgrade.mjs 1.0.5 --dry-run
默认 companion plugins 会随包提供，但是否启用仍按 profile 的 bundles list 处理。
如果要额外安装 topics memory 插件，可以使用：
dsh plugin --profile tui add @aiwayds/dsh-topics-memory
典型用法¶
常用按键如下：
Tab：切换 agent presetsCtrl+Shift+F：transcript searchCtrl+G：打开 subagent pickerEsc：双击停止
按键映射可以通过配置文件调整：
~/.dsh/keybindings.json
也可以使用交互式 slash command：
/hotkeys
会话相关配置放在：
~/.dsh/settings.yaml
其中与 dsh-tui 命名空间相关的两个配置项是：
dsh-tui.retention：作为 startup janitor 处理~/.dsh/sessions，会删除旧日志。dsh-tui.resume：只隐藏 picker rows，不会删除。
适用场景与注意¶
适合以下场景：
- 已经在用 dsh，希望把终端交互集中到一个 TUI 里。
- 需要 footer、subagents、sessions、themes、slash commands 这些终端侧能力。
- 需要 Feishu integration，并愿意评估可选插件
@aiwayds/dsh-feishu。
使用前注意：
- 插件会以当前 dsh 进程权限运行。安装前建议检查源码与许可证。
- 该插件声明的许可证是
MIT。 - 它面向 dsh
0.1.2-rc.1及以上线，不支持 alpha line。 dsh-tui.retention有删除行为，启用前应确认~/.dsh/sessions中的内容。- 社区目录不是官方应用商店，与 DeepSeek / 幻方无官方从属关系。
相关链接¶
- 社区目录：
https://www.skillhub.cn/plugins/fan56/dsh-tui-pi - GitHub：
https://github.com/fan56/dsh-tui-pi
