强化文件协作

English: README.en.md

强化文件协作 是一个 DSH(DeepSeek Harness)插件:让多个(子)智能体并行编辑同一文件而不互相覆盖。

读取文件拿到版本号(rev),编辑必须携带 base_rev 提交——版本不符即被拒绝,并返回 CONFLICT 上下文(谁、改了什么、分类、备注),让你有据重做而非盲目重试或悄悄覆盖。 插件挂在 DSH 的 fs/observed 事件总线与 ctx.fs 服务上(与内置工具同等沙箱 / 原子写 / 工作区解析),复用 DSH 已有的每会话 CAS(fs-observation-policy + FS_STALE_VERSION), 不重造并发控制;补的是带分类备注的全局编辑日志、冲突上下文与撤销。

仓库标识(技术用):qianghua-wenjian-xiezuo(ASCII 包名 / repo 名 / preset-id)。

安装

pwsh preset/install.ps1                       # 基于 standard preset
pwsh preset/install.ps1 -BasePreset dshplug   # 或叠加到 DSHplug 之上

脚本会注册插件包(dsh plugin --profile web add file:…),并从 base preset 复制出 ~/.dsh/.agent-presets/qianghua-wenjian-xiezuo/ 新 preset,在其 agent.cordis.yml 末尾追加插件行(不改 shipped preset)。随后在 DSH GUI 新开会话选「强化文件协作」preset 即生效。

四个工具

• fileward_read — 读取文件内容并返回账本版本号 rev(作为下次编辑的 base_rev 传回)。
• fileward_edit — 带版本校验的 old_string→new_string 原子替换,必须附分类(category)与一句备注(note);base 过期返回 CONFLICT + 你 base 之后谁改了什么。
• fileward_history — 查询全局分类编辑日志(可按文件过滤、限最近 N 条),供父智能体复核子智能体的全部编辑。
• fileward_undo — 按 rev 回滚文件到历史版本(恢复 fileward_edit 存下的快照;回滚动作本身也记一条 rollback 日志)。

验证

node test/store.test.js                                  # 核心账本/日志/快照单测
node test/cas.test.js                                    # 每文件互斥锁 + 冲突信封单测
node acceptance/run.mjs                                  # 冲突矩阵验收(读→他改→再编辑=CONFLICT 带上下文)
node acceptance/mount_check.mjs ~/.dsh/profiles/web      # 已安装插件的挂载冒烟(需先装好插件)

文档

• INSTALL.md — 安装步骤、手动安装与真机冒烟
• TECH_DSH.md — 基于 DSH 源码勘查的深度耦合设计
• PLAN.md — 项目规划与验收标准

---

原名 FileWard,2026 重命名为「强化文件协作」。