dsh-anchored-standard的工程化体系：shared单一事实源、npm run sync物化与自包含模式目录

dsh-anchored-standard的工程化体系shared单一事实源、npm run sync物化与自包含模式目录【免费下载链接】dsh-anchored-standardTwo-phase DeepSeek Harness preset: Minimal-aligned bootstrap, then full Standard tools (Project2 98/99)项目地址: https://gitcode.com/gh_mirrors/ds/dsh-anchored-standarddsh-anchored-standard是一个面向 DeepSeek Harness 的实验性 Agent 预设preset集合先用 Minimal 条件锚定模型轨迹再晋升到完整的 Standard 工具目录。仓库里住着 7 个可独立安装的模式目录它们却共享同一批插件源码——这套「shared/ 单一事实源 npm run sync物化 自包含模式目录」的工程化体系是理解本仓库如何做到「改一处、全模式同步、复制即装」的关键。一、问题背景7 个模式、14 个共享插件 仓库提供 7 种锚定模式各自对应一个独立目录模式目录锚定机制Anchored Standard基础模式preset/Minimal 真实工具对bash str_replace_editorZero-Anchored Standardzero-anchored-standard/一轮零工具固定锚定消息Whoami Standardwhoami-standard/一轮「你是谁」自我介绍Prefab Anchored Standardprefab/内置成功轨迹种子Eternal Minimaleternal-minimal/全程 Minimal 对 dshx 网关Wire Think-Execute Standardwire-think-standard/线层 tool_choice: noneCombo Anchoredcombo-anchored/思考分离 深度闸门 深思滴灌其中大量插件被多个模式同时复用例如 shared/context-gate.mjs统一注入控制、shared/tool-bootstrap.mjs工具目录控制、shared/instruction-hint.mjs一次性指令提示、shared/dev-tool-search.mjs按需工具发现等共 14 个文件。如果每个模式各存一份改一个 bug 就要改 7 遍——这正是「单一事实源」要消灭的问题。二、shared/ 目录插件的单一事实源Single Source of Truth约定非常简单被 2 个及以上模式使用的插件源码只放在 shared/ 一次模式目录里的同名.mjs文件全部是生成出来的物化副本materialized copy且这些副本会提交进仓库永远只编辑shared/绝不直接改模式目录里的副本以 shared/compaction-epoch.mjs 为例它是纪元感知的晋升追踪器被context-gate、tool-bootstrap、instruction-hint三个插件通过本地 import 引用。修改它一次所有引用它的模式在同步后行为一致——不会出现「preset 模式和 whoami 模式对压缩边界compaction处理不一致」这类幽灵 bug。而 shared/custom-bash.mjsWindows 专用 bash 工具只在 Windows 平台挂载的行里出现它同样住在shared/由同步脚本决定分发到哪些模式。三、npm run sync一键物化插件副本同步逻辑全部集中在 scripts/sync-modes.mjs入口脚本定义在 package.json命令作用npm run sync把shared/插件重新物化覆盖写入到每个模式目录npm run check先做--check漂移校验再跑node --test全量测试npm test零依赖测试套件同步脚本的工作流程见 sync-modes.mjs 的MODES清单解析入口扫描每个模式agent.cordis.yml中所有name: ./xxx.mjs行得到该模式声明的本地插件清单计算闭包沿插件文件内的本地 import如from ./compaction-epoch.mjs做传递闭包把间接依赖也纳入——这就是为什么tool-bootstrap.mjs单独引用也能带上compaction-epoch.mjs校验一致性模式目录中出现未被清单收录的「陈旧.mjs」、引用了../外部文件、或引用了既不在shared/也不在模式目录的文件都会直接报错写入副本把shared/下对应文件原样写入模式目录并打印[sync] preset/context-gate.mjs - shared/context-gate.mjs之类的日志。 副本是已提交的所以安装某个模式时完全不需要执行任何构建命令——直接复制目录即可。四、漂移检查--check 与 CI 式守门--check模式只读不写逐字节比对模式目录内的副本与shared/源文件发现任何漂移drift就以退出码 1 失败并提示run: npm run sync。这条规则同时被测试套件把守——test/self-containment.test.mjs 会在npm test时实际 spawn 一次sync-modes.mjs --check任何人提交前跑一下npm run check「手改物化副本」这种事故就无法溜进仓库。这形成了完整闭环改shared/→npm run sync→ 提交两边。五、自包含模式目录复制即可安装 自包含self-contained是这套体系对用户的最大价值每个模式目录只允许引用./下的本地插件agent.cordis.yml中出现../会被同步脚本和测试双重拦截因此安装任何模式都只需一条命令例如基础模式cp -R preset $HOME/.dsh/.agent-presets/anchored-standardtest/self-containment.test.mjs 中的第一个测试专门断言7 个模式目录的agent.cordis.yml均无任何../向上引用。以基础模式 preset/ 为例物化后目录内包含 context-gate.mjs、tool-bootstrap.mjs、dev-tool-search.mjs 等副本以及仅本模式持有的 custom-bash.mjspreset/preset.yml 则声明了预设名称与描述。而prefab/模式除了共享插件还拥有自己的一组专属工具脚本install.mjs、instantiate.mjs、roll-prefab.mjs 等它们属于「模式自有文件」不参与共享。六、关键文件速查 文件说明shared/单一事实源14 个跨模式共享插件scripts/sync-modes.mjs物化/漂移检查脚本package.jsonsync/check/test三个 npm 脚本test/self-containment.test.mjs自包含 无漂移的双重守门测试preset/agent.cordis.yml基础模式插件装配清单含全部挂载顺序注释README.zh-CN.md中文说明模式总览、术语表、配置参考七、新手上手三步克隆仓库git clone https://gitcode.com/gh_mirrors/ds/dsh-anchored-standard验证工程体系运行npm test内部含sync --check确认物化副本与shared/零漂移安装模式把需要的模式目录如preset/整体复制到~/.dsh/.agent-presets/预设id重启 DeepSeek Harness 后在新会话中选择对应预设即可这套「单一事实源 物化 自包含」的三件套本质是把「7 份易失同步」压缩成「1 份源码 1 条命令」是插件型仓库里非常值得借鉴的工程化范式。【免费下载链接】dsh-anchored-standardTwo-phase DeepSeek Harness preset: Minimal-aligned bootstrap, then full Standard tools (Project2 98/99)项目地址: https://gitcode.com/gh_mirrors/ds/dsh-anchored-standard创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考