内容
证据地图
[](https://github.com/mattdweigand-sketch/evidence-map/actions/workflows/ci.yml)
证据地图使工作交付成果在交付前可被审查。
它不是一个演示文稿、 工作簿或报告生成器。构件可以来自 PowerPoint、Excel、ChatGPT、Claude、RFP 工具或人工草稿。证据地图围绕该构件构建控制层：源库存、冲突日志、假设、构件规范、证据地图、敌对验证和导出准备。
## 适用人群
任何 AI 生成或人工生成的文档需要提交给决策者的人：
- 运营人员提交季度审查，其数字来自四个导出和一个预测模型。
- 学生为其毕业设计进行辩护，委员会将询问每个数字的来源。
- 分析师向委员会提交模型，委员会将在分析师不在场的情况下转发模型。
如果您的文档中的声明或数字可能成为他人的决策依据，那么该工具将为您提供审查记录。
## 60 秒快速入门
存储库提供了一个示例：一个课程风格的毕业设计报告文件夹，包含干净的调查导出、一个带有故意问题的 工作簿、定性访谈笔记和两个冲突的注册导出。
```bash
npm --prefix .system install
npm --prefix .system run run -- --name "capstone-report" --kind document --input input/examples/capstone-report
```
打开 `deliverables/capstone-report03_verification/` 以查看验证结果。
## 验证结果示例
这是上述快速入门的实际（缩略）`verification-report.md`：
> **就绪状态：阻塞 阻塞问题：5，需要审查：10
>
> | | 位置 | 问题 |
---|---|---|
> | 必须修复 | workbook:enrollment-analysis.xlsx | 计算区域中出现硬编码数字。 |
> | 必须修复 | source:enrollment-analysis.xlsx | 带有数字的源没有源日期。 |
> | 建议修复 |enrollment-analysis.xlsx:Archive | 工作簿包含一个隐藏的工作 |
> | 建议修复 | workbook:enrollment-analysis.xlsx | 未检测到检查工作表。 |
必须修复 | source-conflict | 存在潜在的版本冲突：enrollment-figures-final.csv，enrollment-figures-old> | 必须修复 | | 声明没有源属性。 |
> | 建议修复:interview-notes.md | 源状态不明确。 |
文件夹中的干净`2026-04-12-survey-raw-export.csv`）任何问题：它有日期、可识别的角色和一致的结构所有内容都会被捕获。示例工作簿是使用 [exceljs](https://github.com/exceljs/exceljs) 生成的，并故意植入了问题：计算工作两个硬编码数字、一个隐藏工作表、没有检查选项卡以及任何地方都没有日期。
## MCP 设置
对于交互式代理工作流，以本地 stdio MCP 服务器的身份运行该工具：
```bash
npm --prefix .system run mcp
```
Claude 代码（`.mcp.json` 在您的项目中，或 `claude mcp add`）：
```json
{
"mcp {
"evidence-map": {
"command": "args": ["run", "mcp "cwd": "/absolute/path/to/evidence-map/.system"
}
}
```
相同的形状支持本地 stdio 服务器的客户端。公开的工具idencemap_inspect`、`evidencemapflow`、`evidencemap_status`、`evidenc_action`、`evidenc_verification_report`。保存在 `deliverables/evidence-map-store.json`。完整的 `.system/docs/mcp.md` 中记录。CLI 仍然烟测试、固定装置。
当前 v1 运行始终或需要审查，直到路线图 MCP 工具可以解决种子声明和发现。
## 这不是什么
前提是 AI 可以制作出看的文件，但在真正完成之前。图表可以混合实际数据和。工作簿可以包含的预测，而不是实时公式。演示文稿可以带有没有来源声明。证据地图在工件被批准之前公开声明层，这样底层内容是否真实、当前、批准和安全可重复使用之前，没有任何内容看起来精致。
库布局
根目录是操作员工作区：
input/`：源文件夹。为每个作业使用一个小写项目命名子文件夹。`input/examples/`存储库一起提供。
-iverables/`：源数据包、验证报告、审查工件和导出门控（gitignored）。
- `.system/`：实现、文档、测试、脚本、包清单和 MCP 服务器。
运行在iverables/<run-slug>/` 下进行。斜杠包括一个短运行 ID 后缀，以便重复名称不会覆盖先前的工
- `01_source/`：源库存、文件检查和冲突日志。
- `02-spec/`：演示文稿、工作簿、文档或混合规范。
- `03_verification/`：敌对审查发现绪报告。
- `04_export/`：已批准工件的门控。
CSV/TSV/text/Markdown 源直接检查。`.xlsx` 文件通过工作簿医生传递：工作表库存、隐藏工作表、标题、公式、硬编码、缺少检查和重复静态公式。、Word 和 PDF 文件在他们的器落地前仅限元数据 — 请参见路线图。
## 路线图、贡献、许可证
- 路线图ROADMAP.md`](ROADMAP.md)
- 贡献：[`ING.md`](CONTRIBUTING.md)
- 许可证：MIT [`LICENSE`](LICENSE)。
