Evidoc — 面向 agentic repositories 的文档漂移控制
- TypeScript
- Node.js
- MCP
- GitHub Actions
- CLI
- Local Web UI
- Documentation Drift
- Agent Workflows
一个公开、本地优先的开发者工具，用于检查 README、docs、AGENTS.md、CLAUDE.md、examples、API notes 与源码绑定文档是否仍然描述当前真实 repo。它让人工审查、CI 与 coding agents 在信任或修复过期上下文前，使用同一份 repo-local evidence。
一眼看懂
角色 独立开发者 — 产品定位、CLI、MCP server、本地 Command Center、GitHub Action、Local Git Gate、release workflow
问题
Agentic repositories 很容易积累过期指令：README commands 与 package scripts 漂移，AGENTS.md 和 CLAUDE.md 保留旧路径，examples 不再匹配 API，而 coding agents 可能在检查源码前先信任这些说法。Evidoc 把这个信任问题转成一套本地 evidence workflow。
解法
我把信任检查包成一套本地工作流，覆盖 CLI、MCP server、本地 Web UI 与 GitHub Action。每个入口都先把文档主张对照 repo 证据，再提出修复建议或阻断 gate。
成果
公开 v0.3.2 · 已于 npm 以 @evidoc/evidoc 发布 · CLI、MCP server、Local Web UI、GitHub Action、Local Git Gate · CLI、core、dashboard、local app、MCP server、reports 与 review log package artifacts
我的工作
- CLI 工作流：检查 drift、运行 doctor diagnostics、生成 repo-local reports，并在命令行执行 local gates
- 面向 coding agents 的 MCP server，把 drift status、scans、diagnosis、doc-fix suggestions 与明确 review logging 作为受控 tools 暴露
- 双语 Evidoc Command Center / Local Web UI，用于 repository health、triage、repair prompts 与 local-gate visibility
- GitHub Action 支持 CI-side drift checks、PR feedback、changed-file focus，并能检测旧 DriftGuard action references 的兼容性
- v0.1.0 release 完成 DriftGuard -> Evidoc rename，覆盖 CLI、npm packages、.evidoc state、MCP、GitHub Action、local app 与 docs
- v0.3.x 以 npm scoped package @evidoc/evidoc 发布，承接 Evidoc namespace 迁移、topological npm publication 与 0.3.2 发布加固
技术证据
- Repo-local evidence model：先对照 commands、paths、symbols、package scripts、frontmatter source bindings、API surfaces 与 changed files，再信任文档 claims
- Agent-safe defaults：默认 read-only checks，review logs 与 repair proposals 有明确写入边界，且不依赖远端项目知识
- Repair workflow 把 evidence、diagnosis 与 patch suggestions 分开，使 generated fixes 保持可审查，而不是静默改写 repo truth
- Release hardening 覆盖 doctor readiness、scoped package artifacts、GitHub Action behavior，以及与当前 scoped npx 和 local GUI paths 对齐的 docs
为什么文档漂移重要
Coding agents 越来越常先读 repository instructions，再读 source files。如果这些 instructions 过期，agent 可能会很自信地执行已不存在的 commands、paths、policies 或 examples。
Evidoc 让文档信任变得明确：先扫描 repo、收集 evidence、标记 stale claims，再决定修文档、阻断 gate，或交给人工审查。
CLI、MCP、Command Center、CI
同一套 evidence workflow 覆盖多个入口：CLI 做本地检查，MCP server 服务 agent workflows，Local Web UI 用于 triage，GitHub Action 用于 pull-request feedback。
v0.1.0 release 把这些入口统一到 Evidoc 名称下，同时保留对旧 DriftGuard action references 的兼容性检测。
当前分发经由 npm scoped package @evidoc/evidoc，版本为 v0.3.2，承接 namespace 迁移与 release hardening。
受控修复，而不是盲目自动化
这个工具围绕可审查 evidence 设计，而不是静默 rewrite。它可以生成 fixes 与 prompts，但 diagnosis、proposal 与 accepted repository change 的边界保持可见。