# home-wiki 跨库同步检查报告

**日期**: 2026-06-30  
**工具**: `tools/scripts/sync_home_wiki.py`  
**执行命令**: `--dry-run` + `--lint`

---

## 总体状态

- **同步健康度**: 良好（26 页全部同步，内容一致）
- **dry-run 结果**: 0 待更新，0 待新建，26 未变化 ✅
- **index 覆盖**: 所有同步概念/实体均已纳入 index 跨库章节 ✅
- **孤儿页面**: 0 个（每页都有入站链接）✅

---

## 待修复问题 🔴

### 1. 5 个页面 source 字段为空（硬性问题）

违反 AGENTS.md wiki 层规范：source 必须指向 raw 来源。

| 页面 | root cause |
|------|-----------|
| AI时代高等教育 | home-wiki 源文件缺 `sources:` 字段 |
| 教学过程核心模型 | 同上 |
| 顶级人生三重境 | 同上 |
| 教学过程核心模型-理论佐证研究 | 同上 |
| 教育研究核验提示词库 | 同上 |

**修复方案**：在 home-wiki 源文件的 frontmatter 中添加 `sources:` 字段，例如：
```yaml
sources:
  - "原始来源文件名或URL"
```
添加后重新运行 `sync_home_wiki.py`（非 dry-run）以更新 wiki 页面。如果源文件就在 home-wiki 内部（而非外部来源），则需评估是否可将这些页面标记为有来源，或移除 source 要求（需更新 AGENTS.md）。

### 2. 27 个断链（软性问题）

断链指向不存在的 `[[wikilink]]`，大部分是：
- **home-wiki 内部的交叉引用**（如 `[[矛盾论]]`, `[[具身智能]]` 等概念，尚未在 kepano wiki 中创建）
- **外部文档引用**（如 `[[陆奇新范式演讲-2024-云中江树整理]]`, `[[陈望道读书法-2024-善读书]]` 等原始资料）

**修复方案**：两大类路线：
- **可忽略** — 指向外部 raw 资料的断链（如 URL 类文件名）可等 ingest 时自然消解
- **待创建** — 缺失的概念页（如 `[[矛盾论]]`, `[[具身智能]]`, `[[复杂性]]`）可补充创建到 wiki/

建议对断链按 severity 分级，仅追踪概念级 cross-reference 的缺失。

### 3. index 综合报告表含重复或过时项（潜在问题）

综合报告表（手动维护区域）存在重复项：
- `[[人为中心AI教育]]` 出现了两次（第 97-98 行）
- `[[home-wiki/syntheses]]` 来源路径过于笼统（缺少具体文件名）

---

## 未发现的问题 ✅

| 检查项 | 结果 |
|--------|------|
| 孤儿页面（0 入站链接） | 0 个 ✅ |
| 未入 index | 0 个 ✅ |
| 文件内容一致性 | 26/26 一致 ✅ |
| 缓存完整性 | 26 条缓存 ✅ |
| home-wiki 源目录 | 存在 ✅ |

---

## 建议行动

1. **P0** 修复 5 个 source 空值 — 在 home-wiki 源文件中补充 `sources:` 字段后重新同步
2. **P1** 修复 index 综合报告表的重复行 — 删除重复的 `[[人为中心AI教育]]`
3. **P2** 定期处理断链中的概念级缺失页 — 按需创建新 wiki 页面
4. **P3** 从 `顶级人生三重境：道家驭势、佛家修心、儒家立身.md` 提取缩略名时确认 NAME_MAP 映射已生效

当前无需运行完整同步（内容已一致），仅在修复 source 空值后需重新执行。
