前言¶

DSH 插件生态里，终端前端需要同时处理流式文本、工具调用、会话恢复和权限审批。dsh-pi-tui 提供其中一个实现：界面交互基于 pi 的 TUI（@earendil-works/pi-tui），内核由 dsh 官方机制提供。

这是什么¶

dsh-pi-tui 是 DSH 插件，仓库路径为 lqhl/dsh-pi-tui，许可为 MIT。它把 pi TUI 的终端观感接到 dsh 官方机制上，适合作为 DSH agent 的交互式终端前端。

核心功能¶

• 流式渲染 assistant/chunk 增量 Markdown，并显示 thinking 折叠标签。
• 工具调用卡片：运行、成功、失败三态，附参数与结果预览。
• write/edit 结果带彩色 diff 高亮。
• read_image 结果可在 kitty/iTerm2 终端内联渲染图片。
• slash 命令自动补全与动态发现。
• 权限审批弹窗与 ask_user_question 交互表单。
• 会话管理：创建、恢复、fork、子代理树、选择器。
• 转录搜索、/retry 重发失败 turn、/copy 复制 assistant/工具结果/错误/id/resume 命令。
• 长会话折叠与 /expand-all 展开。
• 状态栏显示 provider/model、preset、plan、goal、上下文压力、会话 id、git 分支、token 统计、todo 进度、后台任务计数。
• 启动 banner 与官方 /permission preset 切换。

安装与启用¶

前置条件：官方 dsh CLI 与 pnpm。

先添加插件 profile，再启动：

dsh plugin --profile pi-tui add dsh-pi-tui
dsh --profile pi-tui
dsh --profile pi-tui --resume <session-id>
dsh --profile pi-tui --preset <id>

第一条命令添加 dsh-pi-tui 并初始化 pi-tui profile；后三条分别用于新会话、恢复指定会话、选择 agent preset。

典型用法¶

dsh --profile pi-tui
dsh --profile pi-tui --resume <session-id>
dsh --profile pi-tui --preset <id>

会话内常用操作：
- Enter 提交，Shift+Enter 换行。
- Ctrl+T 展开/折叠 thinking 块。
- Ctrl+F 在 transcript 内搜索。
- /model [query] 切换模型。
- /resume [query] 列出/恢复持久化会话。
- /permission [preset] 切换官方权限 preset。
- /retry 重发失败 turn。
- /copy 复制 assistant、工具结果、错误、id 或 resume 命令。
- /expand-all 切换长会话折叠。

适用场景与注意¶

适合已经使用 DSH、并希望在终端中处理流式输出、工具卡片、会话管理和权限审批的开发者。安装前建议检查源码与许可证；插件以当前 dsh 进程权限运行，切换 /permission [preset] 时应确认沙箱模式和审批策略是否符合预期。

版本支持以已测试范围为准：dsh 0.1.0-rc.6、node >= 22.19 测试通过，其他 rc 未验证。许可为 MIT；改编自 pi coding-agent interactive mode 的组件逻辑保留原作者版权。发布由 GitHub Actions 经 npm Trusted Publishers（OIDC）发布，带 provenance 签名，打 v* tag 即发布，无任何 token。

链接¶

• GitHub: https://github.com/lqhl/dsh-pi-tui
• 目录页线索：https://www.skillhub.cn/plugins/lqhl/dsh-pi-tui（来自提供线索，未在已抓取资料中验证）