GuTianshuo/qianghua-wenjian-xiezuo

README 摘要

强化文件协作 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)。 安装 脚本会注册插件包( 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 日志)。 验证 文档 - INSTALL.md — 安装步骤、手动安装与真机冒烟 - TECH DSH.md — 基于 DSH 源码勘查的深度耦合设计 - PLAN.md — 项目规划与验收标准 原名 FileWard,2026 重命名为「强化文件协作」。

分类