日语原生终端界面 mugi995/DSH-forJP-TUI

DSH-forJP-TUI

为 DeepSeek Harness (dsh) 打造的日语原生 TUI。

状态：Phase 0（走路骨架）已完成。渲染尚未着手。
自研 bundle 已挂到 DSH 的 Cordis 树上，从自有入口（C）启动；C 一旦损坏，就回退到 dsh --profile 子进程（B），并能捕获 session/event 的原始事件。
验证用 node scripts/verify-bundle.mjs（12 项检查）。

这是什么

自研 dsh 的 TUI 界面，把日语当作一等公民来处理。
参考现有 dsh-TUI，但不共享代码，渲染层从零自己设计。

目标

| # | 目标 | 设计要求 |
| P1 | 外观自己设计 | 渲染层自己掌控。默认不加装饰性演出 |
| P2 | 日语原生 | 文案从一开始就做成目录。不把日语赶进语言包 |
| P3 | 上游更新不易崩 | 尽量少依赖上游的非公开契约，并持续统计其数量 |
| P4 | UX 研究的地基 | 分离 UI 层与 harness 层，让 UI 的反复试错更便宜 |
| P5 | 将来连 harness 一起替换（作为理念保留） | 把 harness 边界收拢到一处 |
| P6 | harness 调优研究 | 保持 harness 行为可从外部替换 |

已确定的方针

- 如何挂到 DSH 上：in-process 的 Cordis bundle（dsh.bundle.patch）。要用人类对话的方式完成审批、用户提问、模型切换，除此之外没有别的路径（官方 SDK / ACP 没有审批通道）
- 启动：持有自研的完整 host-entry。但失败时必定回退到 dsh --profile 子进程
- 渲染层：fork 上游 Ink v8.0.0（commit 26d2c3f8），放到 src/ink/ 自行扩展。Ink 本体没有鼠标选择、命中测试、滚动固定，这些自己实现
- v0 范围：输入解析 / 差分渲染 / 全角宽度 / 输入框 / 流式显示 / 工具卡片 / 审批面板 / 用户提问面板 / 会话接线 / 中断与退出

文档

| 文档 | 内容 |
| docs/design/0001-architecture-and-roadmap.md | 设计书与路线图（决策日志 D1〜D9、Phase -1〜5、风险 R1〜R8） |
| docs/reports/2026-10-18-phase0-walking-skeleton.md | Phase 0 完成报告（达成项、改变设计的新发现、尚未做的事） |
| docs/research/2026-10-18-dsh-bundle-authoring.md | bundle／Cordis 插件的写法（从官方实物中提取） |
| docs/research/2026-10-18-dsh-headless-recipe.md | 从官方 dsh-headless 提取的智能体驱动步骤 |
| docs/research/2026-10-18-sandbox-and-dsh-home.md | 运行环境的限制与替换 DSH_HOME 的验证方法 |
| docs/research/2026-10-18-dsh-integration-surfaces.md | DSH 的集成面、bundle 契约、SDK 协议、Ink 反证 |
| docs/research/2026-10-18-dsh-core-public-surface.md | DSH 本体的公开接口 |
| docs/research/2026-10-18-dsh-tui-seam.md | 参考实现如何与 DSH 对接 |
| docs/research/2026-10-18-dsh-tui-feature-inventory.md | 参考实现的功能与 UX 盘点 |
| docs/research/2026-10-18-renderer-options.md | TypeScript TUI 渲染器基座比较 |
| docs/research/2026-10-18-dsh-third-party-tui-web.md | DSH 与第三方 TUI 的外部信息 |

调研笔记中依赖环境的本地绝对路径已做遮蔽（$HOME/<workspace>/...）。

开发

pnpm install
pnpm build
node scripts/verify-bundle.mjs # 结构检查（A〜D）
COMMANDCODE_API_KEY=... node scripts/verify-bundle.mjs # 一直到实模型执行（E）
验证过程绝不写入 $HOME/.dsh。把 DSH_HOME 指向工作区内的 .dsh-home/，让配置档与 bundle 解析都在这里完成（理由）。

入口是 lib/bin.js（dsh-forjp）。用环境变量切换行为：

| 变量 | 值 | 含义 |
| FORJP_ENTRY | auto（默认） | 先试 C，失败则回退到 B |
| | in-process | 只用 C。失败就异常退出 |
| | child | 强制用 B |
| FORJP_PROFILE | 默认 forjp | 配置档名 |
| DSH_FORJP_HOST_PACKAGE | 未设置 | 显式指定宿主 @deepseek-ai/dsh 的包目录 |

许可证

MIT（LICENSE）。

fork 来源 Ink 同样是 MIT，把 Ink 引入 src/ink/ 时一并附上 Ink 的许可证声明。