LittleFishStars/dsh-opencode-tui

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:
┌──────────────────────▼─────────────────────────────────────┐
│ 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-tui profile 已安装本包（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_ 稳定 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] ...），诊断用