dsh-pi-tui

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-pi-tui

[pi 的 TUI](https://github.com/earendil-works/pi/tree/main/packages/tui)（`@earendil-works/pi-tui`）驱动的 DeepSeek Harness 终端前端：界面是 pi 的观感（品牌蓝 prompt、流式 Markdown、thinking 折叠、工具调用卡片、微分渲染防闪烁），内核（模型路由、工具、会话持久化、slash 命令、审批）全部由 dsh 官方机制提供。

## 安装

前置：官方 [`dsh`](https://github.com/deepseek-ai/deepseek-harness) CLI（`npm i -g @deepseek-ai/dsh`）与 `pnpm`。

```sh
dsh plugin --profile pi-tui add dsh-pi-tui   # 自动初始化 profile 并挂为 bundle
dsh --profile pi-tui                          # 新会话
dsh --profile pi-tui --resume     # 恢复指定会话
dsh --profile pi-tui --resume                 # 从持久化会话列表中选择
```

会话与 web profile 共享 `~/.dsh/sessions` 持久化存储，两端互通。

## 键位

| 按键 | 功能 |
|---|---|
| `Enter` | 提交（`Shift+Enter` 换行） |
| `Esc` | 中断当前 turn / 取消自动补全 |
| `Ctrl+C` | 运行中→中断；有文字→清空；已空→再次按下退出 |
| `Ctrl+D` | 编辑器为空时退出（非空时删除字符） |
| `Ctrl+T` | 展开/折叠 thinking 块 |
| `Ctrl+O` | 展开/折叠工具完整输出 |
| `Ctrl+L` | 打开模型选择器 |
| `Shift+Tab` | 循环思考强度（off→high→max） |
| `Tab` | 自动补全（文件路径 / slash 命令） |
| `@` | 文件提及菜单（fuzzy 选择后插入相对路径） |

## 命令

| 命令 | 功能 |
|---|---|
| `/model [query]` | 切换模型（无参数弹选择器；下一步生效） |
| `/thinking off\|high\|max` | 设置思考强度（下一步生效） |
| `/skills` | 列出人类可调用技能 |
| `/hotkeys` | 显示键位表 |
| `/compact` `/goal` `/plan` `/feedback` | 官方 dsh 命令（自动发现） |

模型/思考强度切换通过官方 `installModelSelection` 链路（与 web/grok 客户端同款），无需 fork 会话；会话与 web profile 共享 `~/.dsh/sessions` 持久化存储。

## 功能

- 流式渲染：`assistant/chunk` 增量 → Markdown、thinking 折叠标签
- 工具调用卡片：运行/成功/失败三态 + 参数与结果预览
- slash 命令：`/compact` `/goal` `/plan` `/feedback` 等全部来自官方 `ctx.commands` 注册表（自动补全 + 动态发现）
- 权限审批弹窗（`approval/request`）与 `ask_user_question` 交互表单（选项/多选/自由文本）
- 会话管理：创建、恢复、选择器（官方持久化后端）
- 状态栏：provider/model、会话 id、token 统计（官方 token-meter 投影）、todo 进度（官方 todo 投影）
- 转场提示：compaction 检查点、turn 失败/中止/超长提示

## 支持矩阵

| dsh | node | 状态 |
|---|---|---|
| 0.1.0-rc.6 | >= 22.19（CI 跑 22/24） | ✅ 测试通过 |
| 其他 rc | — | 未验证，欢迎反馈 |

## 开发

```sh
npm install && npm run build && npm test
# 本地联调：profile 里是 link: 软链，重新 build 后直接重启即可
```

## License

MIT。改编自 pi coding-agent interactive mode 的组件逻辑保留原作者版权，见 [NOTICE](NOTICE)。