dsh-code-reuse-firewall

在 AI 参与维护的代码库中，最昂贵的失效模式不是某段语法错误，而是同一能力被安静地写了第二遍——两份实现各自演化、渐行渐远，而没有任何静态检查器会在第二份诞生时发出警报。dsh-code-reuse-firewall 把干预点前移到代码还是一份计划、尚不是文件的瞬间。

核心能力是一个确定性、零 LLM 的写前复用检索通道：在 agent 调用写文件工具之前，基于函数名、docstring 词汇与字符串字面量三个通道（IDF 加权查询覆盖率）扫描目标 Python 仓库，返回最相似的已有实现及其路径、分数和逐通道证据。若候选文件被 frozen-JSON 溯源清单锁定，工具会显式标记 LOCKED 并提示导入而非复制修改。检索引擎纯 Python 3.10 标准库实现，中等规模项目扫描通常在秒级完成，不引入任何外部模型调用。

适合正在用 DeepSeek Harness 或类似 agent 工作流维护中等规模 Python 项目的团队：无需替换现有检查流水线，只需在每次写前多一步 reuse_check，就能在计划阶段看到仓库里已有实现的明确信号，把重复实现消灭在文件落盘之前。