Wiki Knowledge Base

从原始研究材料构建本地、兼容 Obsidian 的知识维基。采用概念-实体-对比-来源的架构，通过双链（[[slug]]）网络连接。

目录结构

<project-root>/
├── raw/                  # 不可变的原始资料（只读）
│   └── articles/         # 网页文章、报告（由 Obsidian Web Clipper → Markdown）
├── wiki/                 # 由 LLM 维护的知识页面
│   ├── index.md          # 主目录（每次操作后更新）
│   ├── log.md            # 追加式操作日志
│   ├── concepts/         # 抽象概念（AI Agent、MCP 协议等）
│   ├── entities/         # 具体产品/公司/工具（Smithery、Cursor 等）
│   ├── comparisons/      # 实体间对比分析表格
│   └── sources/          # 原始资料的结构化摘要
└── outputs/              # 生成的报告、lint 检查结果

页面格式

每个维基页面必须包含 YAML frontmatter：

---
title: 页面标题
type: concept | entity | source-summary | comparison
sources:
  - raw/articles/filename.md
related:
  - "[[related-slug]]"
created: YYYY-MM-DD
updated: YYYY-MM-DD
confidence: high | medium | low
---

命名规范

• 文件名：使用 kebab-case 格式（如 ai-agent.md、mcp-model-context-protocol.md）
• 双链引用：必须使用 slug 格式 [[slug]]，禁止使用中文文本或 PascalCase
• 来源引用：在 frontmatter 中以纯文本路径指向 raw/ 文件

四种页面类型

概念 vs 实体：概念 = “X 是什么？”（类别），实体 = “Y 具体是什么？”（实例）。避免重复——定义一次，处处引用。

三层提炼流程：raw/（完整文章，10,000+ 字）→ wiki/sources/（摘要，约 500 字）→ wiki/concepts/ + wiki/entities/（结构化知识）。

工作流：导入

当新资料进入 raw/ 目录时：

1. 读取 raw/ 中的新文件
2. 与用户讨论关键发现
3. 创建 wiki/sources/<slug>.md 摘要，并添加正确的 frontmatter
4. 创建或更新相关概念/实体页面，从来源中提取信息
5. 更新 wiki/index.md 添加新条目
6. 将操作追加至 wiki/log.md

工作流：查询

回答来自维基的问题时：

1. 读取 wiki/index.md 定位相关页面
2. 读取相关的概念/实体/对比页面
3. 使用 [[slug]] 引用合成答案
4. 若答案具有长期价值，建议保存为新的维基页面

工作流：Lint 检查

定期运行健康检查（或按需执行）：

1. 矛盾检测：发现跨页面冲突的陈述（如同一指标数值不同）
2. 孤立页面检测：发现无任何其他页面通过 [[双链]] 引用的页面（index.md 不计入）
3. 悬空链接：发现指向不存在文件的 [[链接]]
4. 模糊链接：发现使用中文或 PascalCase 而非 slug 格式的链接
5. 缺失概念：发现文本中提及但未建立独立页面的实体
6. 内容质量：标记 confidence: low 或内容过少（<100 字）的页面
7. 来源覆盖：检查概念/实体页面是否回链到其对应的源摘要

修复策略：

• 悬空链接：使用 sed 批量替换为正确 slug 格式
• 模糊链接：替换为正确 slug，或移除 []（如太泛泛，例如 [[AI]] → 改为纯文本）
• 孤立源页面：在对应的概念/实体页面正文中添加 [[source-slug]] 引用
• 矛盾问题：对照源页面验证，统一为权威数据

将 lint 报告保存至 outputs/lint-YYYY-MM-DD.md。

工作流：Git 操作

每次操作批次完成后：

git add -A && git commit -m "<type>: <description>"

提交消息格式：<type>: <description>，其中 type 为 ingest、lint、fix、create。