XMoon/dsh-pi-tui
82最近提交 2026年8月16日
dsh-pi-tui DSH 插件
dsh-pi-tui 为 DeepSeek Harness 提供了完整的终端用户界面，支持会话管理、斜杠命令和快捷键。它基于分叉的 pi-tui 构建，作为 dsh 配置文件集成。该插件支持无头测试，需要 Node >= 22.19。
如何安装 dsh-pi-tui DSH 插件
dsh plugin --profile pi-tui -- add @xmoon76/dsh-pi-tui复制不会执行命令。安装 dsh-pi-tui DSH 插件前请核对仓库和版本。
dsh-pi-tui DSH 插件数据来源
dsh-pi-tui DSH 插件快照日期：2026年8月16日
discovered
dsh-pi-tui DSH 插件能做什么
- 完整的会话循环：输入、事件显示、审批、命令、会话切换和全文搜索。
- 斜杠命令：会话搜索、预设、模型、设置、导出等。
- 快捷键：Ctrl+F 搜索，Shift+Tab 切换权限预设，Ctrl+S 发送队列，Alt+↑ 撤回消息。
- 文件/文件夹引用：@ 加 Tab 补全，支持 fd 或内置递归回退。
- 后台任务管理：通过 Ctrl+T 查看子代理和任务浏览器。
- 并发保护：检测其他进程对同一会话的写入并阻止发送（可强制）。
dsh-pi-tui DSH 插件适合哪些场景
- 完全在终端中使用 DeepSeek Harness，无需浏览器。
- 管理多个会话，通过搜索即输和会话切换快速操作。
- 使用斜杠命令快速切换预设、模型和导出会话。
- 直接在 TUI 中管理排队消息和后台任务。
- 修复损坏的会话日志，内置修复脚本。
dsh-pi-tui DSH 插件适合谁
- 偏好终端工作流而非图形界面的开发者。
- 需要轻量级、键盘驱动交互模式的 DeepSeek Harness 用户。
dsh-pi-tui DSH 插件的限制
- 需要已安装 DeepSeek Harness 并支持配置文件（dsh 在 PATH 中）。
- 需要 Node >= 22.19；从源码运行需要 Node 原生 TypeScript 支持（>= 23.6）或 tsx 钩子。
- 不支持会话并发：两个 dsh 进程在同一会话上可能导致日志损坏；TUI 会检测并阻止，但无法完全避免。
- 插件处于早期开发阶段（状态：可用，但仅覆盖主会话循环）。
- 仅适用于终端环境，无浏览器回退。
dsh-pi-tui DSH 插件的仓库 README 摘录
以下文字摘自 dsh-pi-tui DSH 插件的上游仓库 XMoon/dsh-pi-tui 的 README，版权归原作者，仅作引用。
A third-party TUI mode for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh`), built on a vendored fork of [pi-tui](https://github.com/MoonshotAI/kimi-code/tree/main/packages/pi-tui). Run `dsh --profile pi-tui` for a terminal UI instead of the browser GUI (`dsh --profile web`) or one-shot mode (`dsh --profile headless`). > **Status: working.** The TUI covers the main session loop — input → session events, > approvals, commands, session switching and full-text search — plus presets, skills, > model/settings menus, and slash commands. Rendering and input routing are verified > by headless tests (`@xterm/headless`) with no TTY or model connection needed. ## Screenshot  ## Layout ``` packages/pi-tui/ Vendored @moonshot-ai/pi-tui fork, rescoped to @xmoon76/pi-tui. The exact upstream version and commit live in ONE place: packages/pi-tui/package.json `repository.note` (kept in sync on every re-vendor). The local divergence fixes and their guarding tests are listed in
阅读完整 README仓库许可: MIT
dsh-pi-tui DSH 插件常见问题
如何安装 dsh-pi-tui？
推荐从 npm 注册表安装：运行 `dsh plugin --profile pi-tui -- add @xmoon76/dsh-pi-tui`。该命令会创建配置文件（如果不存在）并安装自包含的包。也可以从源码安装：克隆仓库，构建后使用 `file:` 或 `link:` 说明符。
dsh-pi-tui 兼容所有版本的 DeepSeek Harness 吗？
插件需要支持配置文件（`dsh --profile` 选项）的 DeepSeek Harness 版本。如果你能运行 `dsh --profile web`，则说明你的 dsh 支持配置文件。请检查你的 dsh 版本。
能否同时使用 dsh-pi-tui 和网页界面？
不建议。同时使用两个界面（TUI 和网页）操作同一个会话可能导致日志损坏。TUI 包含并发保护机制，会检测并阻止其他写入，但最安全的方式是每个会话只使用一个界面。切换前请先关闭另一个会话。
需要什么版本的 Node.js？
需要 Node >= 22.19。如果从源码运行（而非 npm 包），需要原生支持 TypeScript 的 Node（>= 23.6）或使用 tsx ESM 钩子（`node --import tsx/esm`）。
如何更新插件？
对于注册表安装：运行 `dsh plugin --profile pi-tui -- update @xmoon76/dsh-pi-tui`。对于使用 `file:` 的源码安装：重新构建后重新添加：`pnpm build && dsh plugin --profile pi-tui -- add @xmoon76/dsh-pi-tui@file:$PWD/packages/dsh-pi-tui`。对于 `link:` 安装，只需重新构建，更改会自动生效。