llm-wiki-compiler新鲜度机制检测过期页面并用refresh --stale自动修复知识完整教程【免费下载链接】llm-wiki-compilerThe knowledge compiler. Raw sources in, interlinked wiki out. Inspired by Karpathys LLM Wiki pattern.项目地址: https://gitcode.com/gh_mirrors/ll/llm-wiki-compilerllm-wiki-compiler 是一款知识编译器把原始文档Markdown、PDF、网页等编译成相互链接的 Wiki。它内置的**新鲜度机制source freshness**通过内容哈希自动检测过期页面stale pages和孤儿页面orphaned pages并可用一条llmwiki refresh --stale命令自动修复无需全量重编译。本文带你从零理解这套机制并手把手完成检测与修复 ️。环境准备如何快速安装并运行 llmwiki开始之前先花 1 分钟把环境搭好步骤命令说明1. 检查 Node 版本node --version需要Node.js ≥ 242. 全局安装npm install -g llm-wiki-compiler安装后即可使用llmwiki命令3. 配置密钥export ANTHROPIC_API_KEYsk-ant-...默认使用 Anthropic 提供商4. 编译你的第一个 Wikillmwiki quickstart ./notes.md一条命令完成摄入 编译下图是 llmwiki 从原始资料到可浏览 Wiki 的完整演示 新鲜度机制原理llmwiki 如何追踪知识是否过期核心思路非常轻巧只有两句话编译时记账每次llmwiki compile都会把每个来源文件的内容哈希和归属关系哪个来源生成了哪些页面写入.llmwiki/state.json。使用时对账之后任何需要检查新鲜度的命令都会重新读取磁盘上的sources/目录把当前哈希与记录逐一对比——不一致就说明页面过期了。整个过程按需计算、无后台守护进程没有常驻 watcher每次命令只对哈希计算一遍结果被 lint、status、查看器、MCP 工具等所有出口共享绝不重复计算。状态判定规则定义见 src/freshness/types.ts状态含义典型触发原因fresh页面与来源完全同步所有来源哈希一致stale页面可能不再准确来源内容被修改或部分来源被删除orphaned页面已无活着的来源全部来源文件被删除unverified无法验证.llmwiki/state.json缺失或损坏 小知识由llmwiki query --save保存的问答页面永远标记为unverified——它们是生成的答案不是来源的投影不参与新鲜度判定。如何快速定位过期页面5 个检测入口llmwiki 的新鲜度信号会自动扩散到所有输出面你不需要专门跑一个新鲜度检查命令1️⃣llmwiki lint——列出每一条stale-page/orphaned-page结果指明受影响页面和具体来源文件并计入llmwiki eval的健康分。2️⃣llmwiki status——最直观的体检报告示例输出! Stale: 3 page(s): transformer, self-attention, positional-encoding — run llmwiki refresh --stale ~ Pending changes: 2 source(s) awaiting compile — run llmwiki compile ! State: missing — no compile has run yet — run llmwiki compile3️⃣ 本地查看器llmwiki view——页面元数据栏显示 STALE / ORPHANED 徽章Concepts 列表用新鲜度圆点标记并支持按状态筛选顶部横幅报告全库结论见下方 Scientific Clay 主题效果4️⃣ MCP / JSON 导出——get_context_pack证据包和export --target json的每条页面记录都带freshnessStatus字段下游 Agent 知道哪些页面可能过期。5️⃣llmwiki next——当存在过期页面时它会主动推荐你运行llmwiki refresh --stale把修复动作推到你面前。refresh --stale 自动修复教程4 步把过期页面修回新鲜状态这是本文的重点。llmwiki refresh --stale是定向修复命令只做三件事只重编译变了的来源——只有拥有过期页面的变更来源会走两阶段 LLM 流水线新加入、从未编译的来源会被刻意跳过那种情况请运行llmwiki compile清理孤儿页面——所有来源都被删的页面直接从wiki/移除此过程零 LLM 调用、无需 API key不碰无关页面——来源没变的页面保持原样省钱省时间。第 1 步先看看哪些页面过期了llmwiki lint关注stale-page和orphaned-page两条规则的结果。第 2 步用 --dry-run 预览修复计划强烈推荐llmwiki refresh --stale --dry-rundry-run 会打印完整计划——哪些来源将被重编译、哪些孤儿页面将被删除——不发起任何 LLM 调用、不写任何文件。确认范围无误再动真格。第 3 步执行真正的修复llmwiki refresh --stale如果你的项目配置了审核策略.llmwiki/config.json中的review.holdrefresh 会像 compile 一样遵守它触发拦截条件的页面会进入.llmwiki/candidates/候选队列而不是直接写入wiki/——配置解析失败时直接中止绝不悄悄关闭策略fail-closed。第 4 步再次 lint 验证llmwiki lint确认没有 stale / orphaned 结果即修复完成。如果仍有残留检查是否混入了从未编译的新来源如有则运行一次llmwiki compile。常见问题状态文件损坏怎么办如果.llmwiki/state.json丢失或 JSON 无效llmwiki不会悄悄创建备份或回退到空状态而是明确报错lint和status报告stateStatus: missing或corrupt所有页面标记为unverified查看器顶部显示状态损坏横幅refresh --stale会报告损坏并拒绝继续。修复方式只有一条重新全量编译重建状态文件 llmwiki compile完成后新鲜度追踪自动恢复正常。⏱️防过期小贴士日常编辑时挂一个llmwiki watch即可——它监视sources/目录文件一保存就自动触发增量重编译让页面边写边新从源头避免过期积累。延伸阅读过期页面官方排障文档docs/troubleshooting/stale-pages.mdxcompile 与 refresh 完整 CLI 参考docs/cli/compile.mdxstatus 命令参考docs/cli/status.mdx新鲜度核心类型定义src/freshness/types.ts、src/freshness/index.ts工作原理详解docs/concepts/how-it-works.mdx【免费下载链接】llm-wiki-compilerThe knowledge compiler. Raw sources in, interlinked wiki out. Inspired by Karpathys LLM Wiki pattern.项目地址: https://gitcode.com/gh_mirrors/ll/llm-wiki-compiler创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考