Wiki 参考

lint-report-2026-07-05

Created: 2026-07-05 Updated: 2026-07-05

2026-07-05 知识库全面审查报告

TL;DR

本次审查结论:结构健康,自动指标一致,raw 完整性通过;主要问题集中在启动缓存与目录上下文陈旧高源数大页继续膨胀近期未覆盖 raw 候选仍多三类。

后续已按本报告关闭主要问题:修复缓存漂移,摄入 07-05 高相关 raw,拆出 Agent 记忆/压缩/生命周期专页,低置信页给出维护属性或提升 confidence。raw/ 正文和路径未修改。

后续关闭状态(2026-07-05)

问题状态处理
启动核心事实缓存陈旧Donewiki/CRITICAL_FACTS.md 同步为 43 wiki 内容页、920 raw、最后审计 2026-07-05
references/syntheses _context.md 源数硬编码陈旧Done去掉易漂移源数,改为以 wiki/index.md / generated frontmatter 为准
07-05 高相关未覆盖 rawDone / Deferred6 篇已摄入;Karpathy 转述因缺少可核验原始 transcript 暂缓
低置信/草稿页DoneSEA 原则query-routing 标为内部规则/路由页;两个 entity 页提升到维护态 confidence 0.65
大页 WARNDone / Accepted exception已拆出 [[wiki/concepts/Agent 记忆、压缩与生命周期治理]];治理分水岭、矛盾页本轮接受为总纲/综合页例外;raw-主题索引 接受为 reference 长页例外

07-05 raw 候选处理表

raw落点状态说明
raw/2026-07-05/AI兴观点/Claude Code团队「四种循环」官方曝光!从手动到全自动,开发者工作流变天.md[[wiki/concepts/Loop Engineering]]Done作为 Claude Blog 国内转写来源补入四种循环、质量与 token 治理
raw/2026-07-05/Unknown/Claude Fable5 的 10 大神仙使用技巧,建议收藏.md[[wiki/concepts/Fable 5 使用方法]]Done补入 Fable 5 使用技巧来源
raw/2026-07-05/机器之心/Claude工程师终于交出Fable 5焚诀!教你打破和模型之间的信息差.md[[wiki/concepts/Fable 5 使用方法]]Done补入 Fable 5 工程使用来源
raw/2026-07-05/发现明日产品的/Codex 负责人谈 AI 时代唯一值钱的能力.md[[wiki/entities/Codex 与 Claude Code 集成]]Done补入 Codex home base、产品判断与实现成本下降
raw/2026-07-05/算法狗/蚂蚁面试官:claude code的-compact到底做了啥- 我说-自动总结-,他说我理解的太肤浅了.md[[wiki/concepts/Agent 记忆、压缩与生命周期治理]]Done补入 /compact 结构化摘要 + 客户端补偿机制
raw/2026-07-05/锦康/大模型应用开发-Bash工具实现和安全设计细节.md[[wiki/concepts/机制分层与工具设计]]Done补入 Bash 高权限工具 schema、streaming 输出与静态安全检查
raw/2026-07-05/你说的完全正确/Karpathy最新Agent观点:大厂并没有掌握智能体核心技术,个人开发者正称霸前沿.md暂无Deferred当前 raw 是公众号转述,且正文提示视频未直接提取;需原始 transcript 或一手来源后再摄入

大页 WARN 处理表

页面原问题动作剩余风险
[[wiki/concepts/Agent 原理、记忆与上下文工程]]Agent 原理、记忆、压缩、运行时混在一页拆出 [[wiki/concepts/Agent 记忆、压缩与生命周期治理]],原页保留总览与路由入口后续如果 Agent 协议/配置继续膨胀,可再拆运行时协议页
[[wiki/concepts/AI Agent 编程治理分水岭]]总纲页源数高Accepted exception总纲页保留;若超过 60 源或 TL;DR 失效,再拆专题页
[[wiki/references/raw-主题索引]]reference 页很长且含陈旧规模数字Accepted exception + Done已去掉 865 硬编码;长页属性接受,规模事实以 generated 页为准
[[wiki/syntheses/矛盾与视角差异]]综合矛盾页源数高Accepted exception暂保留综合入口;若新矛盾簇继续增加,按模型能力/工程治理/组织岗位/工具生态拆分

最终验证摘要

检查命令结果
raw catalog / coveragepython3 scripts/generate-raw-index.py920 raw;555 已覆盖;365 未覆盖
指标回写python3 scripts/kb-metrics.py回写拆分与新摄入后的 source_count / index 指标
指标漂移复查python3 scripts/kb-metrics.py --dry-runsource_count 修正 0 页;index 指标修正 0 行
raw checksum 刷新bash scripts/raw-integrity.sh generate生成 920 条 checksum
raw 完整性bash scripts/raw-integrity.sh verify总计 920;修改 0;缺失 0;新增 0;OK
wiki 结构健康python3 scripts/wiki-health.py0 ERROR / 3 WARN
diff 格式git diff --check通过

最终剩余 3 个 WARN 均为已记录例外:[[wiki/concepts/AI Agent 编程治理分水岭]][[wiki/references/raw-主题索引]][[wiki/syntheses/矛盾与视角差异]]

已执行检查

检查命令结果
wiki 结构健康python3 scripts/wiki-health.py0 ERROR / 4 WARN
指标漂移python3 scripts/kb-metrics.py --dry-runsource_count 修正 0 页;index 指标修正 0 行
raw 完整性bash scripts/raw-integrity.sh verify总计 917;修改 0;缺失 0;新增 0;OK
diff 格式git diff --check通过,无空白错误
raw coverage 抽样读取 wiki/references/raw-coverage.generated.md917 raw;549 已覆盖;368 未覆盖
目录上下文抽样读取 wiki/*/_context.md发现多处缓存数字陈旧
页面规模抽样统计 wiki/*/*.md 大小与 source_count42 内容页;24 verified / 16 reviewed / 2 draft

严重级别定义

  • P0:会破坏结构检查、导致断链、raw 缺失、指标漂移或启动事实错误。
  • P1:不会让脚本失败,但会误导查询路由、启动上下文或后续摄入决策。
  • P2:信息架构债务,建议排期清理,不阻塞日常使用。
  • 观察项:当前可接受,但后续 ingest 后应持续监控。

P0:阻塞级问题

无。

脚本层结果是健康的:wiki-health.py 没有 ERROR,kb-metrics.py --dry-run 没有待回写指标,raw-integrity.sh verify 确认 raw/ 当前 checksum 一致。

P1:高优先级问题

1. 启动核心事实缓存陈旧

wiki/CRITICAL_FACTS.md 仍写:

  • 当前规模:41 wiki 内容页,881 raw Markdown
  • 最后审计:2026-07-02

当前其它权威入口显示:

  • wiki/hot.md:42 wiki 内容页,917 raw Markdown,最后审计 2026-07-05
  • wiki/references/raw-coverage.generated.md:917 raw;549 已覆盖;368 未覆盖
  • 本次审查:42 内容页,917 raw,raw integrity 通过

影响:CRITICAL_FACTS.md 是启动清单第 1 步的快速事实文件,陈旧数字会污染新会话的第一印象。建议下一步只做小修:同步规模、raw 数和最后审计日期。

2. 目录 _context.md 中的规模数字陈旧

发现陈旧位置:

  • wiki/references/_context.md 仍写 raw-catalog.generated(865 源)raw-coverage.generated(865 源)raw-主题索引(865 源)后端系统与数据库基础设施(15 源)
  • wiki/syntheses/_context.md 仍写 AI 创业与 OPC(19 源)AI 学习方法、求职与认知升级(21 源)面试专题(32 源)微信同步选题流(11 源)矛盾与视角差异(48 源)

当前 wiki/index.md 中对应数字为:

  • raw-catalog.generated:917 源
  • raw-coverage.generated:917 源
  • raw-主题索引:456 源
  • 后端系统与数据库基础设施:17 源
  • AI 创业与 OPC:22 源
  • AI 学习方法、求职与认知升级:22 源
  • 面试专题:36 源
  • 微信同步选题流:13 源
  • 矛盾与视角差异:72 源

影响:_context.md 是进入子目录前的路由文件,数字陈旧会误导“是否需要深入读某页”和“某页是否已扩展”的判断。建议把 _context.md 中的源数改成“按 wiki/index.md 为准”,或减少硬编码数字,只保留路由策略。

P2:信息架构债务

3. 大页基线仍在,需要拆分评估

wiki-health.py 的 4 个 WARN:

  • wiki/concepts/AI Agent 编程治理分水岭.md:273 行,52 个独立 raw 引用
  • wiki/concepts/Agent 原理、记忆与上下文工程.md:468 行,43 个独立 raw 引用
  • wiki/references/raw-主题索引.md:726 行,456 个独立 raw 引用
  • wiki/syntheses/矛盾与视角差异.md:183 行,72 个独立 raw 引用

这些 WARN 与近期基线一致,不是新回归。建议优先级:

  1. 矛盾与视角差异:72 源且承担跨页冲突入口,建议按“模型能力叙事 / 工程治理叙事 / 组织与岗位叙事 / 工具生态叙事”拆分子页。
  2. Agent 原理、记忆与上下文工程:43 源且 468 行,建议拆出“记忆协议与上下文压缩”子页。
  3. AI Agent 编程治理分水岭:52 源但已是总纲页,建议先压缩为路由页,再把历史判断迁到专题页。
  4. raw-主题索引:属于 reference 页,长是预期现象;只要 generated coverage 已承担确定性目录,它可以保留人工主题落点,不必急拆。

4. 近期未覆盖 raw 仍有明显摄入候选

raw-coverage.generated.md 显示 917 raw 中 368 未覆盖。未覆盖本身不是错误,但 2026-07-05 仍有以下高相关候选未落到 wiki 正文:

  • raw/2026-07-05/AI兴观点/Claude Code团队「四种循环」官方曝光!从手动到全自动,开发者工作流变天.md
  • raw/2026-07-05/Unknown/Claude Fable5 的 10 大神仙使用技巧,建议收藏.md
  • raw/2026-07-05/你说的完全正确/Karpathy最新Agent观点:大厂并没有掌握智能体核心技术,个人开发者正称霸前沿.md
  • raw/2026-07-05/发现明日产品的/Codex 负责人谈 AI 时代唯一值钱的能力.md
  • raw/2026-07-05/机器之心/Claude工程师终于交出Fable 5焚诀!教你打破和模型之间的信息差.md
  • raw/2026-07-05/算法狗/蚂蚁面试官:claude code的-compact到底做了啥- 我说-自动总结-,他说我理解的太肤浅了.md
  • raw/2026-07-05/锦康/大模型应用开发-Bash工具实现和安全设计细节.md

建议后续走一次小批量 ingest,候选落点大致是:

  • Fable 5 使用方法
  • Claude Code 配置体系与扩展机制
  • Agent 原理、记忆与上下文工程
  • Codex 与 Claude Code 集成
  • 机制分层与工具设计

5. 低置信/草稿页需要明确维护策略

当前低置信或 draft 页面:

  • wiki/concepts/SEA 原则.md:source_count 1,confidence 0.4,lifecycle draft
  • wiki/references/query-routing.md:source_count 0,confidence 0.45,lifecycle draft
  • wiki/entities/Claude 创作连接器与专业软件集成.md:confidence 0.55
  • wiki/entities/异构模型接入与 DeepSeek 实践.md:confidence 0.55

判断:这不是结构错误。SEA 原则query-routing 更像仓库内生运维规则,低 source_count 合理;两个 entity 页则可能是真正的旧主题低覆盖。建议:

  • 对内生规则页允许 source_count: 0/1,但在页面里明确“这是维护规则/路由表,不是外部事实 synthesis”。
  • 对两个低置信 entity 页,后续 ingest 时优先补源或决定是否归档为历史页。

观察项

6. 无孤立页

抽样统计所有 wiki/subdir/Page 入链后,没有发现非 generated 的 0 入链页面。这说明当前页面至少都能从索引、路由页或相关页抵达。

7. outputs/ 只有一个文件

当前 outputs/ 下只看到 outputs/learning-site.html。这不违反规则,但与 outputs/reports/outputs/slides/outputs/figures/ 的目标结构相比,产出层仍偏轻。后续长文查询可以优先沉淀到 outputs/reports/

8. 工作区有大量既有未提交改动

审查开始前 git status --short 已显示大量改动和未跟踪文件,范围包括 .obsidian/CLAUDE.mdraw/scripts/kb-metrics.py、多篇 wiki/ 页面、generated references、outputs/raw/assets/ 等。

本次审查没有回滚或整理这些改动;报告只反映当前工作树状态。

建议执行顺序

  1. 先修缓存漂移:同步 wiki/CRITICAL_FACTS.mdwiki/references/_context.mdwiki/syntheses/_context.md,或把硬编码源数改为引用 wiki/index.md
  2. 再做 07-05 未覆盖候选 ingest:重点处理 Fable 5、Claude Code compact、Codex 能力、Bash 工具安全。
  3. 最后安排大页拆分:先从 矛盾与视角差异Agent 原理、记忆与上下文工程 开始,不建议和 ingest 同一批做。

验收状态

  • 结构脚本已运行
  • raw 完整性已验证
  • 指标漂移已检查
  • 目录上下文已抽样
  • 页面规模与生命周期已抽样
  • 未修改 raw/

输入关键词开始搜索