vants.org 知识体系契约

本目录是 vants.org 网络分析公开站点的知识体系层，参照 llm-wiki 的工作方式持续从原始文章中编译概念、来源、关联和反向链接。

定位

• docs/articles/ 是公开原始文章展示层，保留旧站文章、插图、历史排版和评论语境。
• docs/.vitepress/wiki/raw/ 是知识编译用 raw 证据索引层，只保存来源引用、hash、缓存文本和抽取元数据。
• docs/.vitepress/wiki/source-summaries/ 是 source-summary 中间层，用于记录每篇文章进入知识体系的证据。
• docs/wiki/ 是 VitePress 发布的理解层，承载索引、概念页、反链和日志。

原则

1. 读写分离：compile 不修改 docs/articles/** 单篇文章正文。
2. 原文保真：精确事实、图片和历史语境以原始文章页为准。
3. 知识复利：每次 compile 都要更新概念来源、关联概念和反向链接。
4. 中文优先：页面标题、概念名和 wikilink 使用稳定中文短标题；公开 URL 使用英文 slug。
5. 可审计：抽取结果必须写入 JSON、source-summary 和日志。
6. 公开边界：本知识体系只编译 vants.org 公开文章，不混入三实内部知识库内容。

领域分类

• 网络分析基础
• 网络协议行为
• 抓包工具与路径
• 故障与性能案例
• 安全事件与异常流量
• 运维与服务质量

工作流

• npm run wiki:init：创建内部目录、契约、schema 和 qmd 入口。
• npm run wiki:ingest：扫描文章，生成 raw manifest 和纯文本缓存。
• npm run wiki:compile：生成 source-summary、概念页、索引、反链、侧栏和审计数据。
• npm run wiki:query -- "问题"：基于索引和缓存生成查询报告，不默认发布到站点。
• npm run wiki:lint：检查死链、孤立页、空来源、索引漂移、source-summary 和乱码。

生成页面模板

概念页必须包含：

• 定义
• 关键问题
• 来源文章
• 关联概念
• 反向链接
• 原始文章浏览入口

source-summary 必须包含：

• 来源元数据
• 原文入口
• 命中概念
• 核心术语
• 图片引用
• 编译状态

维护约束

• 自动管理概念页可以由 compile 覆盖。
• 核心枢纽页作为 managed: core，只由 schema 和可控渲染更新，不把临时查询内容写入核心页。
• 新增文章后先运行 ingest，再运行 compile 和 lint。
• 构建站点前建议运行：npm run wiki:compile && npm run wiki:lint && npm run build。