dsh-tui 独立基线仓

目录内自包含启动方式（./scripts/dev.sh；Windows 用 node scripts/dev.mjs）、当前环境快照与踩坑记录见 docs/LOCAL-DEV.md。

本仓库是 dsh 公开版插件的独立基线仓，当前含两个独立插件： @huiliyi37/dsh-tianshu-tui（终端 UI，本仓根部）与 @deepseek-ai/dsh-vision-ask（视觉副驾： 会话图片注册表 + ask_image 工具，vision-ask/ 子目录，将来可整体拆独立仓）。

来源

• 代码源自 DeepSeek Harness 内部开发版 packages/tui/tui，经 P1 适配移植为公开版可插拔 bundle 形态（见 docs/PUBLISH-PLAN.md 与 git 历史首条提交）。
• 渲染核心移植自天枢 / Tianshu-Tui（Apache-2.0，公开上游），来源与修改声明见 SOURCE-MAP.md 与 NOTICE。
• vision-ask 移植自 opencode-tui 的 image-registry / ask-image / vision-service （Apache-2.0 上游），设计决策与溯源见 vision-ask/docs/ 与包内注释。

结构

src/                插件源码（tui-runner 入口见 src/index.ts）
tests/              vitest 测试套件（app.spec.ts 黑盒 + 装配测试等）
docs/               内部文档（RELEASE.md 发版手册；PUBLISH-PLAN.md 历史筹备；projection-layer.md 等）
cordis.patch.yml    bundle patch：`dsh plugin add` 装配层
package.json        包清单（@huiliyi37/dsh-tianshu-tui；发版见 docs/RELEASE.md）
tsdown.config.ts    打包配置（lib/types/*.js → lib/index.js + lib/invariant.js）
vision-ask/         独立插件 @deepseek-ai/dsh-vision-ask（自有 package.json/tsconfig/src/tests）
lsp/                独立插件源码（@deepseek-ai/dsh-lsp，已迁出为社区独立仓 omdsh-dev/dsh-lsp；
                    TUI 展示桥探测顺序：社区插件服务 → 官方 ctx.lsp seam（getDiagnostics
                    适配）→ 内置桥降级）

依赖前提

peerDependencies 指向 @deepseek-ai/*（^0.1.0-rc.6）与 @deepseek-ai/cordis（^4.0.1）。 官方核心包已在 npm next 标签发布；@deepseek-ai/dsh CLI 与 @deepseek-ai/dsh-workflow 仍未上架。pnpm install、tsc、vitest 可在能解析这些 peer 的环境运行（公开版 monorepo 工作区：pnpm exec tsc -b packages/tui/tui、pnpm vitest run packages/tui/tui/tests）。 vision-ask 的附件引用均为 type-only：行为测试可在任一解析 dsh-llm/dsh-tools 的 工作区运行（vitest run vision-ask/tests/）；类型面在公开版环境复核。

构建

npm run typecheck   # tsc --noEmit（src + tests）
npm run build       # 两段：tsc -p tsconfig.build.json（src → lib/types/*.js+.d.ts）→ tsdown（lib/types → lib/index.js + lib/invariant.js）
npm test            # vitest run tests/
# vision-ask（独立 tsconfig/打包）
tsc -p vision-ask/tsconfig.json --noEmit

不要只跑裸 tsdown：它的 entry 是 lib/types/*.js（tsc 产物），跳过 tsc 会把旧产物重新打包成新旧混合的 bundle（docs/PUBLISH-PLAN.md 已记录该坑）。

发布

发版按 docs/RELEASE.md（主仓 + omdsh-dev fork 双推、npm --tag latest）。

• 主仓：https://github.com/huiliyi37/dsh-tianshu-tui（remote github）
• 组织 fork：https://github.com/omdsh-dev/dsh-tianshu-tui（remote omdsh）
• origin 是本地 bundle，不要推

历史筹备清单：docs/PUBLISH-PLAN.md（已过期）。