dsh-pi-tui

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

安装

前置：官方 dsh CLI（npm i -g @deepseek-ai/dsh）与 pnpm。

dsh plugin --profile pi-tui add dsh-pi-tui   # 自动初始化 profile 并挂为 bundle
dsh --profile pi-tui                          # 新会话
dsh --profile pi-tui --resume <session-id>    # 恢复指定会话
dsh --profile pi-tui --resume                 # 从持久化会话列表中选择
dsh --profile pi-tui --preset <id>            # 选择 agent preset（standard/minimal/code）
dsh --profile pi-tui --preset                 # 从 preset 列表中选择

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

键位

命令

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

功能

• 流式渲染：官方 agent/assistant-stream 增量帧 → Markdown、thinking 折叠标签（持久化日志里的 assistant/message 再做权威收敛，重放同样能看到 thinking）
• 工具调用卡片：运行/成功/失败三态 + 参数与结果预览；Ctrl+O 展开完整输出；write/edit 结果带彩色 diff 高亮（官方 meta.diffs）
• read_image 结果在 kitty/iTerm2 终端内联渲染图片（Ctrl+O 展开）
• slash 命令：/compact /goal /plan /feedback 等全部来自官方 ctx.commands 注册表（自动补全 + 动态发现）
• 权限审批弹窗（approval/request）与用户问答瀑布（user-questions/request；选项/多选/自由文本；plan-review 特化决策条，PgUp/PgDn 滚动 transcript 里的完整 plan）
• 会话管理：创建、恢复、fork、子代理树、选择器（官方持久化后端；resume 选择器显示官方自动标题，没有任何对话的会话标注为 (empty session)）。恢复失败会明确报错——比如目标会话仍被另一个 dsh 进程占用——而不是静默新建一个空会话，让人以为历史丢了
• 惰性建会话：启动、/new、!cmd 都不会真的创建会话——状态栏显示 new session，直到你第一次提问才落盘。所以「打开看一下就退出」不会在 store 里留下任何东西，也不会污染 resume 选择器
• 会话短 id：状态栏、选择器、提示里统一显示可辨识的 8 位（store 自造的 session-<uuid> 会跳过常量前缀，不再显示成一排 session-）
• 转录搜索：Ctrl+F 在 transcript 内搜索并跳转（输入即定位 + 高亮，↑/↓ 循环）；/retry 一键重发失败 turn；/copy 复制 assistant/工具结果/错误/id/resume 命令（OSC 52 三路剪贴板）
• 长会话折叠：消息超过阈值自动折叠旧消息（/expand-all 展开）
• 状态栏：provider/model、preset、plan 指示、goal 状态、上下文压力 ctx N%、会话 id、git 分支、token 统计、todo 进度、后台任务计数（全部来自官方 projection/jobs 服务）
• 转场提示：compaction 检查点、turn 失败/中止/超长提示
• 启动 banner：品牌蓝 ASCII 鲸鱼 + 会话信息 + 键位提示 + 持久化会话提示（boot 与会话切换时）
• 权限：官方 /permission <preset>（沙箱模式 + 审批策略捆绑切换），状态栏显示当前 preset

支持矩阵

dsh 在加载插件时会校验 peerDependencies；本版本只声明并验证 0.2.0-rc.2。

发布：npm 上的每次发版由 GitHub Actions 经 npm Trusted Publishers（OIDC）发布，带 provenance 签名——打 v* tag 即发布，无任何 token。

开发

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

代码规范（提交时 pre-commit hook 会自动对暂存文件跑 eslint --fix + prettier --write）：

npm run lint         # ESLint flat config，含 type-aware recommendedTypeChecked
npm run lint:fix     # 自动修复可修问题
npm run typecheck    # tsc 对 src + test 做类型检查
npm run format       # Prettier 统一格式
npm run format:check # 校验格式

CI 对每个 PR 跑 lint + typecheck + build + test。详细约定见 AGENTS.md。

License

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