AgentMeshOS 文档库事实审计（2026-09-26）
本报告是 P10-0 的文档治理证据，记录全量 Markdown 分类、当前 DNS 事实、已修正漂移和仍需人工确认的边界。报告不授权修改 DNS、Nginx、UFW、Headscale DERP Map、SSH、路由器或恢复脚本。
📌 结论摘要
P10-0 已把 docs/**/*.md 从人工记忆清单改为机器可读清单。P10 完成归档并把原 P11 占位页原地升级为当前计划后，当前共有 113 个 Markdown 文档；document-inventory.json 按唯一路径登记每个文件，Repository Guardrails 会在新增未分类文档或清单漂移时阻止提交。
DNS 现场与 P10 模型一致：edge.yohan.fun 保存静态 A/AAAA，业务域名使用 CNAME 跟随边缘身份，mail、sz、裸域和独立站点保留明确例外。控制台合法管理员会话下的 #docsPlans 回读已于 2026-09-26 12:47 CST 完成，P10 已归档；P11 已在本地完成网络可替换、告警治理、拓扑和 ClawBot 绑定链路，真实微信扫码与生产回读仍待完成。
🗂️ 目录
📚 全量分类
分类结果来自 python3 scripts/ci/agentmeshos-document-inventory-check.py --write，机器清单位于 document-inventory.json。published 表示页面已进入当前 MkDocs 导航；未发布文档仍必须登记，综合类不能被误当成当前实施计划。
| 分类 | 数量 | 处理口径 |
|---|---|---|
current |
5 | 当前 P11 摘要、状态源、全站索引和文档治理 |
architecture |
17 | 架构与工程规范，作为当前约束阅读 |
operations |
18 | 运行、接入、端口、恢复和脚本参考 |
active-plan |
5 | 与当前阶段并行但不等同当前阶段的工程计划 |
archive |
32 | P10 完成归档、历史基线和专题归档 |
compatibility |
13 | 旧 URL、旧阶段号和历史兼容入口 |
closed |
1 | P9 关闭记录 |
evidence |
19 | 剥离、恢复、迁移和验收证据 |
template |
1 | 新计划模板 |
roadmap |
1 | P12 后续路线 |
governance |
1 | 本审计报告 |
本次修正的计数漂移是：P10 正文原写“全部 114 个文档”，现场 find docs -type f -name '*.md' | wc -l 为 110。这不是功能故障，但会让审计范围失真；后续统一以机器清单为准，不再在正文复制易漂移的总数。
🌐 DNS 与入口冻结输入
dig +short A/AAAA/CNAME 只读回读显示，以下业务名称均为 CNAME -> edge.yohan.fun，并由 edge 的 A/AAAA 提供当前 IPv4/IPv6：
| 类型 | 名称 | 当前模型 | 处理边界 |
|---|---|---|---|
| 权威边缘 | edge.yohan.fun |
静态 A/AAAA | 换边缘时只更新该权威地址 |
| AgentMeshOS 业务 | mesh/cloud/auth/console/docs/status/api/omni/nomad/ai/disk/ota/6844 |
CNAME edge.yohan.fun |
不在各业务记录重复保存边缘 IP |
| Three Dogs 正式站点 | www.threedogs.vip |
跨厂商 CNAME edge.yohan.fun |
Dynadot 只写别名，不写 MM IP |
| Three Dogs 裸域 | threedogs.vip |
独立 A，Nginx 负责跳转 | 不把普通 CNAME 用于 apex |
| 邮件 | mail.yohan.fun |
独立 A 与邮件记录 | 不跟随 edge |
| NAS 例外 | sz.yohan.fun |
动态 AAAA | 只读核对，禁止修改或 CNAME 化 |
从 101 执行 curl -L 的当前结果是：mesh/cloud/docs/status/api/ai 最终为 200；auth 一跳进入登录页，console/nomad 进入 A-Auth 登录页，omni 进入自身登录页，最终均返回 200。该结果说明“302 到登录页再 200”是当前认证语义，不应被写成匿名可访问。
www.threedogs.vip 与 threedogs.vip 在 25 秒 curl 窗口内仍为零字节超时。P10-1 只能记录该事实，不能把 DNS 正确误写成站点健康恢复；需要转独立性能故障排查。
🕰️ 历史值与恢复边界
旧 MM 地址只允许保留在已明确标注历史值的迁移/审计文档和负向测试中。P10 的活跃方案、当前恢复脚本、DERP Map 和仓库硬编码门禁不保存旧公网地址。
docs/mm公网入口迁移.md 与 docs/plans/omniroute-search-image-audit-20260924.md 在机器清单中标记为 fact_state=historical、recovery_eligible=false。任何脚本、恢复流程或后续维护不得把这两页当作当前入口来源；需要恢复时应读取 P10 正文、运行时端点快照和实际权威 DNS。
🧪 验证命令
| 检查 | 命令 | 当前结果 |
|---|---|---|
| 文档分类完整性 | python3 scripts/ci/agentmeshos-document-inventory-check.py |
PASS，113 个文档唯一登记 |
| 分类负向回归 | python3 scripts/ci/tests/document-inventory-check-test.py |
PASS，缺项、重复和错误历史分类均被拒绝 |
| 活跃地址硬编码 | python3 scripts/ci/agentmeshos-edge-hardcode-check.py |
PASS，旧/当前 MM 地址不得进入活跃源 |
| 计划导航 | python3 scripts/ci/agentmeshos-plan-nav-check.py |
PASS，P11 当前入口与 P10 归档分区未混排 |
| 计划状态 | python3 scripts/ci/agentmeshos-plan-state-check.py |
PASS，状态源与公开计划一致 |
| 文档构建 | python3 -m mkdocs build --strict --config-file tools/docs-site/config/mkdocs.yml |
以本轮最终 CI 结果为准 |
| 控制台认证回读 | 真实浏览器 https://console.yohan.fun/#docsPlans |
PASS，管理员身份可见；部署后回读 docs.yohan.fun/plans/ 的 P10 归档和 P11 当前状态 |
⚠️ 未决项 / 需要用户决策
| 事项 | 当前事实 | 下一步 |
|---|---|---|
| P11 微信 ClawBot | OpenClaw 宿主、腾讯微信插件、Bridge、Runtime、Console 绑定链路、生产状态投影、模型 smoke 和受控重启恢复均已通过；真实微信出入站待外部消息触发 | 完成一次真实微信往返后完成 P11-6 的发布、观察和回退验收 |
| Three Dogs 性能 | DNS 与边缘别名正确，但两个入口 25 秒无响应 | 独立排查 MM 反代、RR 后端和 WooCommerce 资源 |
| IPv6 公网验收 | AAAA 解析已发布 | 从具备可用 IPv6 的节点验证 443、DERP 和回源 |
| 内部文档发布边界 | 21 个文档为内部或证据材料，不进入公开导航 | 保持内部可见性；若确需公开，再逐项评审敏感信息 |