dsh-pi-tui

English | 简体中文

基于 Pi TUI 的 DeepSeek Harness 终端前端。

dsh-pi-tui 作为独立的 dsh bundle 安装到 profile 中，提供流式对话、工具调用、会话管理、Subagent、历史搜索、Shell、审批与设置等终端交互。模型、工具、Session、权限、Skills、Plan、Goal、Subagent 等运行时能力仍由 DeepSeek Harness 提供。

安装到 DSH Profile

Stable / latest

稳定版是普通用户的推荐渠道。请先安装 DSH，再将 TUI 添加到 pi-tui profile：

npm install -g --allow-scripts=@deepseek-ai/dsh-subprocess-local,koffi,node-pty @deepseek-ai/dsh@latest
dsh plugin --profile pi-tui -- add @xmoon76/dsh-pi-tui@latest
dsh --profile pi-tui

Next / npm 线（验证）

预览安装使用 DSH 的 alpha channel 与 TUI 的 next channel；安装 DSH 时需要显式允许其原生安装脚本：

npm install -g --allow-scripts=@deepseek-ai/dsh-subprocess-local,koffi,node-pty @deepseek-ai/dsh@alpha
dsh plugin --profile pi-tui -- add @xmoon76/dsh-pi-tui@next
dsh --profile pi-tui

这两个 channel 今天不构成可安装的兼容 pair。 它们只是通道指针：当前 @deepseek-ai/dsh@alpha 指向 0.2.1-alpha.5，而 @xmoon76/dsh-pi-tui@next 仍指向 0.5.2-rc.1（peer floor >=0.2.0-rc.2，npm semver 不接受不同 major.minor.patch tuple 的 prerelease）。请以下方版本对应表和 兼容性指南 的通用匹配原则为准；稳定版 0.5.3 发布在 @latest 而不是 @next，因此这两个移动 channel 上没有可安装的兼容组合。 本 checkout 的精确验证请使用 pnpm compat:dsh:npm。

隔离的 npm 驱动仍按本 checkout 声明的精确 DSH 版本运行，并执行完整的 build/test/package 路径：

pnpm compat:dsh:npm

具体的稳定版最低版本、next 兼容范围和回退路径见兼容性指南。

环境要求

• DeepSeek Harness
• Node.js ^22.19.0 || >=24

DSH 与 TUI 版本对应（重要）

TUI 包版本	对应的官方 DSH tags	说明
0.5.3（stable / @latest）	dsh-v0.2.1-rc.2、dsh-v0.2.1-rc.3	当前已发布稳定版；peer floor 仍是 0.2.1-rc.2，本仓库当前 checkout 的精确验证目标已前移到 0.2.1-rc.3
0.5.1（stable，历史）	dsh-v0.2.0-rc.2	上一稳定版；最低与精确验证目标均为 0.2.0-rc.2 family
0.5.2-rc.1（next 通道预览，已发布）	dsh-v0.2.0-rc.2	上一轮 next 预览：已发布到 npm next 通道（2026-10-17）；整套 peer floor 仍是 >=0.2.0-rc.2，不覆盖 0.2.1-rc.2
dsh-v0.2.1-rc.1（无配对 TUI）	无	该中间版本没有本矩阵宣称兼容的已发布 TUI；不要为它复用 0.5.3
0.5.0（stable，历史）	dsh-v0.1.7-rc.2、dsh-v0.2.0-rc.1	上一稳定版；最低 0.1.7-rc.2，精确验证目标 0.2.0-rc.1
0.4.9（stable，历史）	dsh-v0.1.7-rc.2	上一稳定版；0.1.7-rc.2 runtime 的兼容 TUI
0.4.8（stable，历史）	dsh-v0.1.7-rc.1	上一稳定版；0.1.7-rc.1 runtime 的兼容 TUI
0.4.6（stable，历史）	dsh-v0.1.5-rc.1、dsh-v0.1.5-rc.2	上一稳定版；0.1.5 runtime 的兼容 TUI
0.4.7-alpha.2（next，历史）	dsh-v0.1.6-alpha.2	上一条 next 线；0.1.6-alpha.2 runtime 的兼容 TUI

不要把稳定线与 @next 预发布线混装。0.5.3 是当前已发布稳定版：它的最低 DSH 版本（peer floor）仍是 0.2.1-rc.2 family，而已发布的 0.5.3 与后续的 0.2.1-rc.3 也已实测配对（官方 preset assembly 在 rc.3 下通过）；本仓库当前 checkout 的精确验证目标前移到 0.2.1-rc.3，这不改变 0.5.3 已发布包的身份与 floor。中间的 dsh-v0.2.1-rc.1 没有配对 TUI，0.5.2-rc.1 是上一轮已发布到 npm next 通道的 预览身份（配对 0.2.0-rc.2；它不覆盖 0.2.1-rc.2，因此新的稳定线使用 0.5.3 身份）。上一稳定版 0.5.1 继续配对 0.2.0-rc.2：它把整个 DSH peer floor 提升到 >=0.2.0-rc.2（Question 生命周期消费 rc.2 才发布的公开契约）。更早的 0.5.0 保持 >=0.1.7-rc.2 floor 不变（精确验证目标 0.2.0-rc.1）；旧 runtime 会在正常的 不兼容边界以非零状态失败，请按上表安装配对的 TUI 线。上方的版本对应表是已发布 线的摘要；通用版本匹配原则与回退/诊断流程见兼容性指南；要查看 @next 的最新集成 状态，请看 next 分支 README。

新的 Agent preset 使用当前 roster 中选定的 id。DSH 允许合法的自定义 code preset；只要当前 roster 存在它，显式输入和持久化状态都会保留 code。 DSH V3 migration 负责历史 session header/selection 的 code -> ptc 转换； 当前 projection 会原样保留合法的自定义 code。省略请求的 legacy settings default 不再做任何别名映射：当前 roster 没有声明就是无效偏好。

Profile management

…