lint-report-2026-07-05
2026-07-05 知识库全面审查报告
TL;DR
本次审查结论:结构健康,自动指标一致,raw 完整性通过;主要问题集中在启动缓存与目录上下文陈旧、高源数大页继续膨胀、近期未覆盖 raw 候选仍多三类。
后续已按本报告关闭主要问题:修复缓存漂移,摄入 07-05 高相关 raw,拆出 Agent 记忆/压缩/生命周期专页,低置信页给出维护属性或提升 confidence。raw/ 正文和路径未修改。
后续关闭状态(2026-07-05)
| 问题 | 状态 | 处理 |
|---|---|---|
| 启动核心事实缓存陈旧 | Done | wiki/CRITICAL_FACTS.md 同步为 43 wiki 内容页、920 raw、最后审计 2026-07-05 |
references/syntheses _context.md 源数硬编码陈旧 | Done | 去掉易漂移源数,改为以 wiki/index.md / generated frontmatter 为准 |
| 07-05 高相关未覆盖 raw | Done / Deferred | 6 篇已摄入;Karpathy 转述因缺少可核验原始 transcript 暂缓 |
| 低置信/草稿页 | Done | SEA 原则、query-routing 标为内部规则/路由页;两个 entity 页提升到维护态 confidence 0.65 |
| 大页 WARN | Done / 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 / coverage | python3 scripts/generate-raw-index.py | 920 raw;555 已覆盖;365 未覆盖 |
| 指标回写 | python3 scripts/kb-metrics.py | 回写拆分与新摄入后的 source_count / index 指标 |
| 指标漂移复查 | python3 scripts/kb-metrics.py --dry-run | source_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.py | 0 ERROR / 3 WARN |
| diff 格式 | git diff --check | 通过 |
最终剩余 3 个 WARN 均为已记录例外:[[wiki/concepts/AI Agent 编程治理分水岭]]、[[wiki/references/raw-主题索引]]、[[wiki/syntheses/矛盾与视角差异]]。
已执行检查
| 检查 | 命令 | 结果 |
|---|---|---|
| wiki 结构健康 | python3 scripts/wiki-health.py | 0 ERROR / 4 WARN |
| 指标漂移 | python3 scripts/kb-metrics.py --dry-run | source_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.md | 917 raw;549 已覆盖;368 未覆盖 |
| 目录上下文抽样 | 读取 wiki/*/_context.md | 发现多处缓存数字陈旧 |
| 页面规模抽样 | 统计 wiki/*/*.md 大小与 source_count | 42 内容页;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-05wiki/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 与近期基线一致,不是新回归。建议优先级:
矛盾与视角差异:72 源且承担跨页冲突入口,建议按“模型能力叙事 / 工程治理叙事 / 组织与岗位叙事 / 工具生态叙事”拆分子页。Agent 原理、记忆与上下文工程:43 源且 468 行,建议拆出“记忆协议与上下文压缩”子页。AI Agent 编程治理分水岭:52 源但已是总纲页,建议先压缩为路由页,再把历史判断迁到专题页。raw-主题索引:属于 reference 页,长是预期现象;只要 generated coverage 已承担确定性目录,它可以保留人工主题落点,不必急拆。
4. 近期未覆盖 raw 仍有明显摄入候选
raw-coverage.generated.md 显示 917 raw 中 368 未覆盖。未覆盖本身不是错误,但 2026-07-05 仍有以下高相关候选未落到 wiki 正文:
raw/2026-07-05/AI兴观点/Claude Code团队「四种循环」官方曝光!从手动到全自动,开发者工作流变天.mdraw/2026-07-05/Unknown/Claude Fable5 的 10 大神仙使用技巧,建议收藏.mdraw/2026-07-05/你说的完全正确/Karpathy最新Agent观点:大厂并没有掌握智能体核心技术,个人开发者正称霸前沿.mdraw/2026-07-05/发现明日产品的/Codex 负责人谈 AI 时代唯一值钱的能力.mdraw/2026-07-05/机器之心/Claude工程师终于交出Fable 5焚诀!教你打破和模型之间的信息差.mdraw/2026-07-05/算法狗/蚂蚁面试官:claude code的-compact到底做了啥- 我说-自动总结-,他说我理解的太肤浅了.mdraw/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 draftwiki/references/query-routing.md:source_count 0,confidence 0.45,lifecycle draftwiki/entities/Claude 创作连接器与专业软件集成.md:confidence 0.55wiki/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.md、raw/、scripts/kb-metrics.py、多篇 wiki/ 页面、generated references、outputs/、raw/assets/ 等。
本次审查没有回滚或整理这些改动;报告只反映当前工作树状态。
建议执行顺序
- 先修缓存漂移:同步
wiki/CRITICAL_FACTS.md、wiki/references/_context.md、wiki/syntheses/_context.md,或把硬编码源数改为引用wiki/index.md。 - 再做 07-05 未覆盖候选 ingest:重点处理 Fable 5、Claude Code compact、Codex 能力、Bash 工具安全。
- 最后安排大页拆分:先从
矛盾与视角差异或Agent 原理、记忆与上下文工程开始,不建议和 ingest 同一批做。
验收状态
- 结构脚本已运行
- raw 完整性已验证
- 指标漂移已检查
- 目录上下文已抽样
- 页面规模与生命周期已抽样
- 未修改
raw/