# 2026-07-06 Wiki 操作日志

## [2026-07-06 16:05 UTC / 2026-07-07 04:05 NZST] Wiki Lint 健康检查（cron: 6bd77ae2 — 每 3 天）

**Cron**：Wiki Lint 每 3 天健康检查
**触发时间**：2026-07-07 04:05 NZST（2026-07-06 16:05 UTC）
**执行脚本**：`bash /home/node/.openclaw/workspace/knowledge/Miralce_knowledge/.lint.sh`
**检查工具**：`Miralce_knowledge/.lint.py`（Python）

### 检查结果汇总

| 检查项 | 状态 | 备注 |
|--------|------|------|
| 孤立页面（Orphan） | ⚠️ 2 处 | `*/index.md` 目录页（脚本误报，已连续 6 次） |
| 失效链接（Broken） | ❌ 2 处 | 与 2026-06-18、06-21、06-24、06-28、07-01、07-03 报告**完全一致**，已连续 **8 次**未处理 |
| 过期 library | ✅ 无 | — |
| 冲突记录 | ✅ 无 | — |

### 孤立页面详情

1. `wiki/entities/index.md`
2. `wiki/concepts/index.md`

> **分析**：这两个 `index.md` 是 LLM 生成的目录页（`<!-- openclaw:wiki:entities:index:start -->` 标记），本身**不应被任何页面链接引用**——它们是父级索引，引用方而不是被引用方。
>
> 这是 `.lint.py` 的**逻辑误报**：孤立检测应该跳过 `*/index.md`。
>
> **建议**：
> - **轻量**（推荐）：在 `.lint.py` 的孤立检测中加一行 `if fpath.name == 'index.md': continue`；
> - **保持原样**：当作用户对目录页存在感的提醒，不影响浏览与查询。

### 失效链接详情

> 与前 7 次 Lint 报告（06-18、06-21、06-24、06-28、07-01、07-03）**完全一致**，已连续 **8 次**报告未修复。

1. **`[[wiki/concepts/esp32-s3-features]]`**
   - 引用位置：`wiki/sources/unsafe-local-miralce-knowledge-d417a0dd-unsafe-local-miralce-knowledge-d417a0dd-esp32-s3-md-10b6da6c-md-00f24d39.md:71`（嵌套的 unsafe-local 源快照文件，原始实体页内容被代码围栏转义）
   - 缺失目标：`wiki/concepts/esp32-s3-features.md`
   - **重要观察**：当前**主体 wiki**（`wiki/entities/esp32-s3.md`）的 "相关概念" 段**已经没有这个失效链接**——之前日志建议的"改链到 espressif-chips"已在主体中完成。只是这条旧链接仍残留在某个历史 unsafe-local 源快照文件（嵌套归档）的代码围栏内。
   - **建议**：
     - **轻量**（推荐）：手动重跑 Ingest 让源快照同步，或下次 ingest 触发时自动刷新；
     - **临时**：把 `.lint.py` 中"来源=unsafe-local source 快照内嵌代码围栏"的命中排除掉（避免历史快照污染主报告）。

2. **`[[wiki/entities/gpt-5]]`**
   - 引用位置：`wiki/sources/unsafe-local-miralce-knowledge-d417a0dd-llmreadme-md-0ae41f20.md`（llmreadme.md 命名规范示例段，代码围栏内）
   - 缺失目标：`wiki/entities/gpt-5.md`
   - **建议**：保持原样，`gpt-5` 本就是 llmreadme.md 命名规范的示例占位，不应在 wiki 里真正建立实体；如要消除报告，可在 llmreadme.md 该示例外层再加一层 `\` 反引号，或让 `.lint.py` 跳过代码围栏内的 wikilink。

### 本轮相对上轮的状态差异

| 维度 | 2026-07-03 上轮 | 2026-07-06 本轮 | 变化 |
|------|---------------|---------------|------|
| 孤立页面 | 2 | 2 | = |
| 失效链接 | 2 | 2 | = |
| 过期 library | 0 | 0 | = |
| 冲突记录 | 0 | 0 | = |

> **关键差异**：本轮**核实确认**——失效链接的两处**当前都不在主体 wiki 页面中**，全部位于 unsafe-local 源快照（嵌套归档文件）的代码围栏内。
>
> 这意味着：
> - 当前 wiki 主体的浏览/查询链路**完全正常**（点击任何 wikilink 都能命中）；
> - 历史快照被脚本当作失效链接误报，连续 8 次未变。

### 近 7 日 Wiki 活动

| 日期 | 内容 |
|------|------|
| 2026-07-03 | 2026-07-03 Wiki 操作日志（含当轮 Lint 报告） |
| 2026-07-01 | 2026-07-01 Wiki 操作日志（含当轮 Lint 报告） |
| 2026-06-28 | 2026-06-28 Wiki 日志 |

> 自上次 Lint（07-03）以来**无新 Ingest 触发**、**无新 library/entities/concepts 写入**。源快照文件自 2026-06-30 后无变化。

### 健康度

- 总体健康度：**🟡 良好但长期误报**
- 主体 wiki 实际完整性：**4/4 项均通过**（用户视角下没有任何失效链接）
- 脚本误报：2/4 项（孤立 `*/index.md` + 历史快照嵌套 wikilink）

### 后续动作（待用户决策）

| 优先级 | 项目 | 建议动作 |
|--------|------|----------|
| 🟢 低 | `.lint.py` 孤立误报 | 在孤立检测中加 `if fpath.name == 'index.md': continue` |
| 🟢 低 | 源快照内嵌 wikilink 误报 | 增强 `.lint.py`：跳过 markdown 代码围栏（\`\`\`...\`\`\`）内的 wikilink 匹配 |
| 🟡 中 | 重跑 Ingest | 让 unsafe-local 源快照与当前主体 wiki 同步，自然消除历史快照中的失效引用 |
| 🟢 可选 | 永远清零 | 重跑 Lint 验证 4 项检查全部清零 |

> **强烈建议**：先做**前两项轻量代码修改**（一行 + 几行 Python），就能让 Lint 报告彻底归零。**不需要改动任何 wiki 主体**。

### 备注

本次 Lint 结果已通过 Telegram 发送给用户（chatId=798233405），本条日志为存档。