dsh-apb

面向 DeepSeek Harness（DSH）的 Ask / Plan / Build 渐进编码扩展。项目由一个标准 profile bundle @songyanglin/dsh-apb 和一个独立 apb-coding agent preset 组成， 适配 DSH 0.1.5-rc.2。

Ask / Plan 只读并拒绝提权；Build 允许工作区写入，工作区外沿用宿主审批。每轮只 完成当前约定的模块或步骤并验证，然后等待用户继续。

当前状态：重构中，不建议作为可靠权限插件投入日常使用。 单一发布包、TypeScript 源码结构、模式状态机与权限映射已完成代码实现并通过类型检查；真实 DSH/浏览器 端到端验收、tarball 冷启动链路和沙箱拒写仍未闭环。详见项目状态 和已知问题。

文档入口

• 文档总览
• 安装、升级与卸载
• 本地开发与热更新使用说明
• 本地开发环境设计思路
• DSH 插件架构与模块关系
• 架构与运行链路
• 重构路线图

仓库组成

路径	作用
src/	TypeScript 源码：领域层、应用层、DSH 适配层、Client 层与统一契约
scripts/build.mjs	esbuild 构建 src/ → dist/，并生成类型声明
scripts/dev.mjs	隔离调试 Home 的启动、Client HMR 构建、Host 重启、状态与清理入口
scripts/verify-package.mjs	隔离 tarball 安装、升级、卸载与重装验证
scripts/runtime/	开发专用 DSH 定位、进程管理与 probe 适配器
presets/apb-coding/	agent preset（persona 与工具组合）
resources/persona.md	模式规则与产品提示词
cordis.patch.yml	bundle patch：插入 host/资源，preset root 指向包内 presets/

dist/ 只存放构建结果，不手工维护；host/lib、client/lib 等形似编译输出的 旧业务代码已移除。

本地开发

pnpm install
pnpm dev

pnpm dev 使用仓库忽略目录 .debug/development 下的独立 DSH Home 与专用 web Profile，复用本机已安装的 DSH，不修改日常用户目录。Client 变化走 DSH Client HMR， Host 变化在构建成功后自动重启 DSH，preset／契约／依赖／bundle 组合变化也触发重启； 当前不启用或追求 Host HMR。

开发与验证基线固定为 DSH 0.1.5-rc.2，不宣称兼容未验证版本。