# AI-LLM-Wiki

AI-LLM-Wiki 是一个由 LLM 持续维护的编译型知识库：真实资料以不可变原件保存在 `raw/`，LLM 将其编译为 `wiki/` 中可追溯、互相连接并持续更新的知识页面，最终产物单独放在 `output/`。

## 核心模型

```text
真实资料 -> raw/（不可变） -> ingest / query / lint -> wiki/（可重编译） -> output/（对外产物）
```

- `raw/` 是唯一事实来源层。已写入文件不得修改、覆盖、移动、重命名或删除。
- `wiki/` 是知识层。页面必须由真实 raw 资料支撑，并随新证据更新既有概念、实体、主题、综合分析和交叉链接。
- `output/` 是发布层。文章、报告和脚本可以引用 Wiki 与 raw，但不能反过来成为事实来源。
- `legacy-notes/` 保存重构前的项目内容，仅供审查，不自动视为已验证知识。

## 使用入口

1. 所有 Agent 先完整阅读 [AGENTS.md](AGENTS.md)。
2. 新资料放入合适的 `raw/` 子目录；不确定分类时放入 `raw/inbox/`。
3. 执行 ingest 时先查 [wiki/index.md](wiki/index.md)，更新已有 Wiki 页面并补充引用与交叉链接。
4. 每次 ingest、query 或 lint 都只在 [wiki/log.md](wiki/log.md) 末尾追加记录。
5. 当前仓库只包含框架，不包含任何模型虚构的知识页面。

## 目录概览

```text
AI-LLM-Wiki/
├── AGENTS.md
├── README.md
├── raw/
│   ├── inbox/
│   ├── articles/
│   ├── papers/
│   ├── company-docs/
│   ├── videos/
│   └── assets/
├── wiki/
│   ├── index.md
│   ├── log.md
│   ├── concepts/
│   ├── entities/
│   ├── topics/
│   ├── sources/
│   └── syntheses/
├── output/
│   ├── articles/
│   ├── reports/
│   └── scripts/
└── legacy-notes/
```

空目录中的 `.gitkeep` 仅用于让 Git 保留目录，不属于资料、Wiki 页面或事实来源。

## 首轮 Ingest 的最小完成标准

一次 ingest 只有同时满足以下条件才算完成：

1. 原始文件以原样副本写入 `raw/`，并记录 SHA-256。
2. 先检索现有 Wiki，再决定更新页面或新建页面；不机械生成单篇摘要。
3. 每项重要结论都有可解析的 raw 引用和页码、章节或时间戳。
4. `wiki/index.md` 已同步，`wiki/log.md` 已在末尾追加记录。
5. lint 未发现 raw 被改写、断链、孤立页或无来源结论。