dsh-opencode-tui
让 DeepSeek Harness (dsh) 使用 opencode 原版 TUI：直接复用 opencode 的终端界面（会话列表、消息流、工具卡片、 thinking 折叠、鼠标与主题全部由 opencode 原版提供），Agent/会话/工具/权限则由 dsh 驱动。
架构
opencode 的 TUI 是纯 HTTP 客户端：它通过一组 REST 端点（旧路径 /session、 /config/providers、/global/event 等 + v2 /api/*）与 SSE 事件流与 server 通信。 本仓库实现了一个 opencode server 协议兼容层，跑在 dsh 插件进程内，把 TUI 的 请求映射到 dsh 的 agent/会话；TUI 二进制则是 opencode 官方仓库（anomalyco/opencode， dev 分支）界面代码的精简版（tui/）：只保留 TUI 及其直接依赖 （tui/ui/plugin/sdk/core/schema/llm 等包），并裁剪 CLI 为仅直连模式；品牌已改为 DSH（首页 Logo、侧边栏、提示与退出画面）。
┌──────────────────────────────────────────────────────────┐
│ dsh --profile dsh-opencode-tui（Node 进程） │
│ 插件 plugin.ts： │
│ ├─ src/oc-server.ts（薄主类：HTTP 生命周期+路由分发） │
│ │ ├─ src/session-store.ts（会话存储/SSE/模型选择） │
│ │ ├─ src/event-mapper.ts（DSH 事件→opencode 事件） │
│ │ ├─ src/routes/（api.ts v2 / legacy.ts 旧协议） │
│ │ └─ src/{types,projection,oc-proto,http-util}.ts │
│ └─ src/agent.ts（AgentManager → dsh agent 会话） │
└──────────────────────┬─────────────────────────────────────┘
│ OPENCODE_URL=http://127.0.0.1:<port>
┌──────────────────────▼─────────────────────────────────────┐
│ tui/ lildax（opencode 界面精简版，DSH 品牌，直连兼容层） │
└────────────────────────────────────────────────────────────┘DSH 事件（session/event）→ opencode 事件（message.updated / message.part.updated / session.status）→ SSE 推给 TUI，驱动消息流、 thinking 折叠与工具卡片的实时渲染。
使用
# 唯一入口：dsh 标准启动方式
dsh --profile dsh-opencode-tui要求：
dsh-opencode-tuiprofile 已安装本包（dsh plugin --profile dsh-opencode-tui add <本仓库路径>）- opencode TUI 二进制：默认找
tui/packages/cli/dist/cli-linux-x64/bin/lildax
（本仓库）或 $DSH_HOME/tui/... 同路径，缺失时按报错提示构建： cd tui/packages/cli && bun run script/build.ts
配置（profile 的 config）：
binary：lildax 路径preset：agent preset id（默认 roster 默认）cwd：工作目录（默认进程 cwd）serverPort：兼容层端口（默认随机；可用环境变量DSH_OPENCODE_TUI_SERVER_PORT）args：透传给 TUI 的附加参数
会话与消息全部存在 DSH 的会话存储（DSH_OPENCODE_SESSION_ROOT 可重定向， 默认与 dsh web 互通）。Ctrl+C 退出对话框默认选 No（防误退），Tab 切到 Yes 后 Enter 退出——这是 opencode 原版行为。
兼容层协议要点
TUI 实测请求（fork dev lildax）：
- 启动（sync bootstrap，旧 + v2 混合）：
/path/project/current
/config/providers /provider /experimental/* /agent /config /session /global/event(SSE) /command /lsp /mcp /formatter /session/status /provider/auth /vcs + /api/health /api/location /api/agent /api/integration /api/model /api/provider /api/reference /api/command /api/skill
- 发送消息：
POST /session→POST /session/:id/message
（body {parts: [{type:"text", text}]}，响应 {info, parts}）
- 消息列表：
GET /session/:id/message（[{info, parts}]） - 事件流：
GET /global/event（SSE，data 为 v2 GlobalEvent 信封
{directory, payload: {type, properties}}；事件含 message.updated / message.part.updated / session.status / session.updated / permission.asked / permission.replied）
- 旧路径 404 时 TUI 用
gracefulFetch兜底（/config/providers/provider
/agent /config 有默认值），其余 404 按 TUI 容错处理
消息格式必须严格对齐旧 SDK 类型（UserMessage/AssistantMessage 无 content 字段，需要 agent/model/parentID/mode/path/cost/tokens 等），否则会话页渲染崩溃（TUI 弹崩溃对话框）。
启动时从 DSH 持久层重建历史会话（hydrate，ses_<sha1> 稳定 id），打开历史 会话发消息会 resume 原 DSH 会话继续。审批走 v2 PermissionRequest： DSH approval/request → permission.asked 事件 → TUI 权限对话框 →
POST /permission/:requestID/reply（{reply: "once"|"always"|"reject"}）。
测试
scripts/ 下的 pty 测试（python + term_responder 应答器）：
pty-test13.py：文本回复端到端（发送 → DSH agent 回复 → TUI 渲染）pty-test14.py：工具调用端到端（bash → 输出渲染）pty-test15.py/pty-test16.py：审批对话框（触发 → 对话框 → Enter 批准 → 工具执行）pty-test18.py：提问对话框完整流程（agent askUserQuestion → 选择 → DSH 收到答案）pty-test19.py：Tab 切换权限模式 agent（read-only / workspace-write / full-access）pty-test20.py：工具轮多思考块重启后保持独立（hydrate 回归）pty-test22.py：会话删除（DELETE /session/:id → 列表/磁盘工件移除）test-blocks-*.mjs/test-tool-state.mjs/test-user-dedup.mjs：兼容层单元测试term_responder.py：OpenTUI 终端查询应答（threaded=False时同步模式，
与捕获主循环共用 fd，避免多 reader 竞争死锁）
tools/：调试工具（miniterm 屏幕模拟、extract-visible 文本提取、record-server 等）
注意：
- 沙箱 pty 的渲染限制：侧边栏区域、部分 flex 布局不渲染 → 屏幕断言优先用
会话文件 / HTTP 响应（如 test20 用 GET /session/:id/message 验证 reasoning part）
- 兼容层请求日志走 stderr（
[oc-server] ...），诊断用