# LLM Wiki 工作约定

本目录是一个个人 LLM Wiki。目标不是简单保存资料，而是让 LLM 持续阅读、提炼、整合和维护一个结构化 Markdown 知识库。

## 目录结构

```text
raw/           # 原始资料，只读不改
assets/    # 图片、附件、截图等原始资源
wiki/          # LLM 生成和维护的知识库页面
wiki/index.md  # 全局索引
wiki/log.md    # 操作日志
```

## 核心原则

- `raw/` 是事实来源，导入后不要修改原始文件。
- `wiki/` 是经过整理的知识层，可以持续更新、合并、修订和交叉引用。
- 每次导入都要更新 `wiki/index.md` 和 `wiki/log.md`。
- 重要实体、概念、工作流应拆成独立页面，并使用 `[[wikilink]]` 建立双向关联。
- 新资料与旧资料冲突时，应明确标注矛盾，不要静默覆盖。
- 查询中产生的高价值综合结论，可以回写为新的 Wiki 页面。

## 页面命名

- 资料摘要：`source-{关键词}.md`
- 实体页：`{实体名}.md`
- 概念页：`{概念名}.md`
- 工作流页：`{场景}-workflow.md`

文件名优先使用小写英文、数字和连字符。中文主题可以使用拼音、英文关键词，或在确有必要时使用中文文件名。

## Frontmatter 模板

资料摘要页：

```yaml
---
tags: [source-summary]
type: source
source: "原文标题"
author: ""
date: YYYY-MM-DD
url: ""
created: YYYY-MM-DD
---
```

实体页：

```yaml
---
tags: [entity]
type: entity
created: YYYY-MM-DD
updated: YYYY-MM-DD
---
```

概念页：

```yaml
---
tags: [concept]
type: concept
created: YYYY-MM-DD
updated: YYYY-MM-DD
---
```

## Ingest 工作流

当用户要求“导入”“处理资料”“添加到知识库”时：

1. 读取 `raw/` 中的目标资料。
2. 提炼核心观点、关键事实、案例、数据和可复用方法。
3. 创建 `wiki/source-{关键词}.md` 摘要页。
4. 创建或更新相关实体页、概念页和工作流页。
5. 在相关页面底部添加来源链接，指回摘要页。
6. 更新 `wiki/index.md`。
7. 追加 `wiki/log.md`，记录新增和更新页面。
8. 标注与已有内容的共同主题、补充关系或矛盾。

## Query 工作流

当用户向知识库提问或要求分析时：

1. 先读取 `wiki/index.md` 定位相关页面。
2. 再读取具体 Wiki 页面和必要的原始资料。
3. 综合回答，并引用相关 Wiki 页面或原始资料。
4. 如果回答形成稳定结论，询问或直接回写到 Wiki 页面。

## Lint 工作流

当用户要求“检查知识库”“维护一下”“lint wiki”时：

1. 检查孤立页面和缺失入站链接。
2. 检查被提及但没有独立页面的重要实体或概念。
3. 检查相互矛盾或过时内容。
4. 检查 `wiki/index.md` 是否覆盖所有重要页面。
5. 给出修复建议，并在确认后执行整理。

## Obsidian 使用建议

- 用 Obsidian 打开本目录作为 Vault。
- 通过图谱视图观察页面连接。
- 用搜索和反向链接检查概念网络是否健康。
- 可以后续安装 Dataview 插件，用 frontmatter 生成动态列表。