dsh-repo-atlas

最大的风险不是 AI 编码代理读不懂代码，而是它把猜测当成事实、把未经验证的假设当成结论，在不熟悉的仓库里自信地编造理解。dsh-repo-atlas（RepoAtlas）正是为这个空白而生的 DeepSeek Harness 插件：在代理采取任何行动之前，先把仓库里"有什么"这件事锚定在文件级证据上。

插件沿着两条线工作。理解线在路径、内容、敏感文件和预算限制下扫描已确认的工作区，产出覆盖技术栈、入口、关键目录、测试和配置的结构化证据，并给出推荐阅读顺序；结论被严格区分为文件直接支持的文件观察与文本推断，不确定部分显式标记为 partial 或 unknown，而非静默补全。审阅线允许代理为仅限当前会话的变更提案定义明确目标和意图，在生命周期到达对应状态后审阅、导出并验证有界补丁，同时将 worktree 状态、commit 就绪、landing 关系、恢复建议和 release 就绪作为独立观察，确保"准备审阅"绝不与"已经应用"混为一谈。

安全是一级设计约束。默认路径只读：不会生成或应用补丁，不会 commit、merge、push、安装依赖、调用网络或上传代码。受控动作必须显式开启，并经过固定 recipe、显式审批、sandbox 强制和有界脱敏输出。所有证据缓存、提案注册表和 preflight 评估仅限当前会话，会话结束即消失。它适合希望编码代理先读后动、并在每次代码变更中保留人工审批位的开发者和维护者。