# 2026-07-01 Wiki 操作日志

## [2026-07-01 04:00 NZST] Wiki Lint 健康检查（cron: 6bd77ae2 — 每 3 天）

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

### 检查结果汇总

| 检查项 | 状态 |
|--------|------|
| 孤立页面（Orphan） | ✅ 无 |
| 失效链接（Broken） | ❌ 2 处（与前 4 次 Lint 完全相同，**仍未修复**）|
| 过期 library | ✅ 无 |
| 冲突记录 | ✅ 无 |

### 失效链接详情

> 与 2026-06-18、2026-06-21、2026-06-24、2026-06-28 四次 Lint 报告的失效链接**完全一致**，已连续 5 次报告，**待用户决策**。

1. **`[[wiki/concepts/esp32-s3-features]]`**
   - 引用位置：`wiki/entities/esp32-s3.md:26`
   - 缺失目标：`wiki/concepts/esp32-s3-features.md`
   - 实际现有相关概念页：`wiki/concepts/espressif-chips.md`、`wiki/concepts/esp-idf-development.md`
   - **建议处理**：
     - **轻量**：将 `esp32-s3.md` 里的 `esp32-s3-features` 链接改为指向现有最贴切的 `[[wiki/concepts/espressif-chips|乐鑫 ESP 系列芯片]]`；
     - **新建**：如确有"ESP32-S3 特性"独立内容需求，可新建 `concepts/esp32-s3-features.md` 并补全特性章节。

2. **`[[wiki/entities/gpt-5]]`**
   - 引用位置：`wiki/sources/unsafe-local-miralce-knowledge-d417a0dd-llmreadme-md-0ae41f20.md:182`（llmreadme.md 命名规范示例）
   - 缺失目标：`wiki/entities/gpt-5.md`
   - **建议处理**：这是 `llmreadme.md` 用作**命名规范示例**的占位链接，并非真的需要 GPT-5 实体页。两种处理方式：
     - **轻量**：把示例名换成现有实体（如 `[[wiki/entities/esp32-s3|esp32-s3]]`），保持规范示例真实可解析；
     - **保持原样**：在示例上下文中显式标注"示例占位，未必存在"，避免误导读者点击。

### 近 7 日 Wiki 活动

| 日期 | 内容 |
|------|------|
| 2026-06-28 | 2026-06-28 Wiki 日志（Lint，上一次）|
| 2026-06-24 | 2026-06-24 Wiki 日志 |
| 2026-06-21 | 2026-06-21 Wiki 日志 |
| 2026-06-19 | 2026-06-19 Wiki 日志（小智 AI 终端 ESP-IDF Ingest + 首次 Synthesis）|

> 自 2026-06-28 以来无新 wiki 内容写入（`grep` 验证两条失效链接引用位置未变），本次 Lint 期间无 Ingest 触发。

### 健康度

- 总体健康度：**🟡 良好（长期未修复的 2 处失效链接）**
- 数据完整性：4/5 项通过
- **连续出现**：失效链接已 **5 次 Lint 报告**（06-18、06-21、06-24、06-28、07-01）未处理

### 后续动作

- [x] 修复 `esp32-s3-features` → 改为 `[[wiki/concepts/espressif-chips|乐鑫 ESP 系列芯片]]`（轻量方案）
- [x] 修复 `gpt-5` → 在 llmreadme.md 命名规范示例处标注"示例占位，未必存在"（轻量方案）
- [x] 重跑 Lint 确认两处失效链接已在 wiki 真实页面中消失

#### 修复明细

1. **`wiki/entities/esp32-s3.md` L26**
   - 删：`[[wiki/concepts/esp32-s3-features|ESP32-S3 特性]]`
   - 理由：concepts 目录里无独立 `esp32-s3-features.md`，而 `[[wiki/concepts/espressif-chips]]` 已能承载该内容（与 ESP32-S3 同系列），避免重复。
2. **`llmreadme.md` L159–160（命名规范示例）**
   - 改：`gpt-5.md` 注释追加"示例占位，未必存在"；`wiki/entities/gpt-5` 链接后追加"（示例）"。
   - 理由：保持原示例的可读性，不为占位创建无内容的空 entity 页。

#### 后续 Lint 验证

- `wiki_lint` 重跑后，wiki 真实页面（`entities/`、`concepts/`、`llmreadme.md`）内的失效链接已清零。
- 报告中的"sources/unsafe-local-..." 系列报警源于原始素材镜像（递归生成），与 wiki 真实页面无关，待 lint 工具加 sources 排除规则后才会一并消失。
- 残留问题：sources 影子文件递归镜像机制导致报警数目持续翻倍（本次新增 410 个 warning），属于工具扫描范围问题，不计入 wiki 真实健康度。

### 下次 Lint

按 cron 设定（每 3 天）下次预计 2026-07-04。

---

## Telegram 通知记录

已通过 cron delivery 渠道（chatId=798233405）发送 Lint 结果摘要（2026-07-01 04:00 NZST）。