Nanobot | ForeverYang's 博客

nanobot 0.3.5 个人知识库自动部署指令

mythstraw@msn.com (ForeverYang) — Mon, 05 Oct 2026 21:17:00 +0800

以下指令已适配 nanobot 0.3.5 版本，工作区路径为 D:\知识库\，配置目录为 D:\nanobot-config\。关键修正：会话存储（sessions）已移至 workspace 之外，避免触发 0.3.5 的路径校验错误。

配套阅读：LLM-Wiki 个人知识库搭建说明 —— 先看它了解整体设计，再按本文逐步执行。

0.3.5版本适配说明（关键约束）

nanobot 0.3.5 对会话存储位置引入了硬性校验，session storage 必须位于 agent workspace 之外，否则启动时会抛出 RuntimeError。

校验逻辑（nanobot/session/manager.py:551-563）：

canonical_workspace = Path(workspace).expanduser().resolve(strict=False)
root = Path(sessions_root).expanduser().resolve(strict=False)
if root == canonical_workspace or root.is_relative_to(canonical_workspace):
 raise RuntimeError("session storage must be outside the agent workspace; ...")

正确的路径关系：

数据项	存储位置	是否在 workspace 内
配置文件	`D:\nanobot-config\config.json`	❌ 否
Workspace	`D:\知识库\`	—
会话历史	`D:\nanobot-config\sessions\<workspace-id>\`	❌ 否
记忆	`D:\知识库\memory\`	✅ 是
技能	`D:\知识库\skills\`	✅ 是

核心原则：配置目录（含 sessions）与 workspace 平级，sessions 不落在 workspace 内。nanobot 0.3.5 首次启动时会自动迁移 workspace 内的旧会话文件，迁移是幂等的。

给 nanobot 的完整部署指令

你是一个自动化部署代理。请在 Windows 环境下完成以下部署任务。按顺序执行，遇到错误时尝试修复并记录。所有文件使用 UTF-8 编码保存。JSON 文件中的路径使用双反斜杠 \\，Markdown 文件中的路径使用正斜杠 /。

任务概述

部署一个适配 nanobot 0.3.5 的 LLM Wiki 个人知识库系统，包含：

完整目录结构（配置目录与 workspace 分离）
Agent 配置文件（config.json）
Skill 定义文件（llm-wiki/SKILL.md）
Wiki Schema（schema.md）
知识库使用手册
Agent 权限与操作规则
Obsidian Vault 结构

步骤 1：创建目录结构

# ============================================
# 路径定义
# ============================================
$base = "D:\知识库" # workspace 根
$configDir = "D:\nanobot-config" # 配置目录（在 workspace 外）
$vault = "$base\我的知识库" # Obsidian Vault

# ============================================
# 1. 创建配置目录（含 sessions，在 workspace 外）
# ============================================
New-Item -ItemType Directory -Force -Path `
 "$configDir\sessions", "$configDir\media" | Out-Null

Write-Host "✓ 配置目录创建完成：$configDir"
Write-Host " - sessions/ 存储在 workspace 外，满足 nanobot 0.3.5 校验要求"

# ============================================
# 2. 创建 workspace 目录（Agent 工作区）
# ============================================
New-Item -ItemType Directory -Force -Path `
 "$base\raw\sources", "$base\raw\articles", "$base\raw\papers", `
 "$base\raw\transcripts", "$base\raw\assets", `
 "$base\memory", "$base\skills\llm-wiki" | Out-Null

Write-Host "✓ workspace 目录创建完成：$base"

# ============================================
# 3. 创建 Obsidian Vault 目录
# ============================================
$domains = @("室内设计","3D打印","艺术","经济","科技","人文","其他")
foreach ($d in $domains) {
 New-Item -ItemType Directory -Force -Path "$vault\02_Areas(领域)\$d", "$vault\03_Resources(资源)\$d" | Out-Null
}

New-Item -ItemType Directory -Force -Path `
 "$vault\00_Inbox(灵感库)", "$vault\01_Projects", `
 "$vault\04_Archive(归档)\2025", "$vault\04_Archive\2026", `
 "$vault\05_Agent(智能体)\wiki\concepts", "$vault\05_Agent\wiki\entities", `
 "$vault\05_Agent(智能体)\wiki\sources", "$vault\05_Agent\wiki\comparisons", `
 "$vault\05_Agent(智能体)\wiki\queries", `
 "$vault\05_Agent(智能体)\wiki\queries", `
 "$vault\05_Agent(智能体)\wiki\candidates\concepts", 
"$vault\05_Agent(智能体)\wiki\candidates\entities", `
 "$vault\05_Agent(智能体)\wiki\candidates\sources",
 "$vault\05_Agent(智能体)\wiki\candidates\rejected", `
 "$vault\05_Agent(智能体)\annotations", `
 "$vault\06_Toolbox(工具箱)\scripts", "$vault\06_Toolbox(工具箱)\snippets", "$vault\06_Toolbox(工具箱)\packages", `
 "$vault\MOC(内容地图)", "$vault\Templates(模板)", "$vault\Attachments(附件)" | Out-Null

Write-Host "✓ Obsidian Vault 目录创建完成：$vault"
Write-Host ""
Write-Host "最终目录结构："
Write-Host " D:\nanobot-config\ ← 配置目录（workspace 外）"
Write-Host " ├── config.json"
Write-Host " ├── sessions\ ← 会话存储（workspace 外）"
Write-Host " └── media\"
Write-Host " D:\知识库\ ← workspace（Agent 工作区）"
Write-Host " ├── SOUL.md"
Write-Host " ├── USER.md"
Write-Host " ├── raw\"
Write-Host " ├── memory\"
Write-Host " ├── skills\"
Write-Host " └── 我的知识库\ ← Obsidian Vault"

步骤 2：写入 `D:\nanobot-config\config.json`

{
 "agents": {
 "defaults": {
 "workspace": "D:\\知识库",
 "model": "anthropic/claude-sonnet-4-6"
 }
 },
 "gateway": {
 "port": 18791
 },
 "tools": {
 "restrictToWorkspace": true
 }
}

说明：workspace 字段指向 D:\知识库。会话历史将自动存储在配置目录 D:\nanobot-config\sessions\<workspace-id>\ 下，该路径不在 workspace 内，满足 0.3.5 校验要求。

步骤 3：写入 `D:\知识库\SOUL.md`

# SOUL

你是一个知识库管理助手，负责维护“我的知识库”。

## 工作原则
- 所有结论必须能溯源到 `raw/` 中的原始素材。
- 如果资料中没有答案，明确说“资料未覆盖”，不要编造。
- Wiki 输出到 `我的知识库/05_Agent/wiki/`。
- 候选页面输出到 `我的知识库/05_Agent/wiki/candidates/`。
- 从 `我的知识库/00_Inbox/` 读取待处理内容。
- 处理 Inbox 和生成标注索引时，**必须参考** `我的知识库/知识库使用手册.md`。
- 处理权限相关任务时，**必须参考** `我的知识库/Agent 权限与操作规则.md`。
- 用中文回答，风格简洁准确。

## 会话存储说明（nanobot 0.3.5）
- 会话历史存储在 `D:\nanobot-config\sessions\<workspace-id>\` 下，**不在 workspace 内**。
- 你无法直接读取或修改会话文件，它们由 nanobot 运行时自动管理。
- workspace 内的 `.nanobot/workspace-id` 文件由 nanobot 自动维护，不要修改它。
- 如需回顾历史对话，使用 nanobot 提供的会话查询命令，不要尝试直接读写 sessions 目录。

## 领域分类
知识库按 7 个领域组织：室内设计、3D打印、艺术、经济、科技、人文、其他。
处理任何内容时，先判断它属于哪个领域，再放入对应目录。
跨领域内容同时标注多个领域标签。

## 审核原则
- LLM 生成的 Wiki 页面一律先进入 `candidates/`，状态为 `needs_review`。
- 只有 `approved` 和 `verified` 状态的页面参与检索。
- 审核由人工完成，不要自动批准。
- 人工区（01–04）默认不修改原文件，只生成标注索引到 `05_Agent(智能体)/annotations/`。

步骤 4：写入 `D:\知识库\USER.md`

# USER

- 知识库所有者：洋
- 主要领域：室内设计、3D打印、艺术、经济、科技、人文
- 工具链：Obsidian + nanobot + WorkBuddy

## 知识库规则
- 知识按 PARA + 领域细分组织。
- `00_Inbox(灵感库)` 是多工具协作入口，由 nanobot 自动读取和处理，
 处理后原文件移入 `raw/` 或 `04_Archive(归档)/`，保持 Inbox 为空。
- `01–04` 是人工主导区：
 - LLM 默认不修改原文件；
 - LLM 自动生成标注索引到 `05_Agent(智能体)/annotations/`，供检索使用；
 - 如需写入原文件 YAML，LLM 先建议，经我确认后再写入。
- Wiki 由 Agent 自动编译，但必须先进入 `candidates/`，经我审核后才能进入正式 Wiki。
- 如需 LLM 处理某篇手动笔记，我会主动将其放入 `00_Inbox(灵感库)/` 或
 `raw/sources/` 并明确指示。
- 所有目录职责和流转规则以 `我的知识库/知识库使用手册.md` 为准。

## nanobot 版本说明
- 当前使用 nanobot 0.3.5。
- 会话历史存储在 `D:\nanobot-config\sessions\` 下，与 workspace 分离。
- 升级时请先备份 `D:\nanobot-config\` 和 `D:\知识库\`，再停止旧进程，最后启动新版本。

步骤 5：写入 `D:\知识库\skills\llm-wiki\SKILL.md`

---
name: llm-wiki
description: |
 管理知识库 Wiki。当用户要求摄入素材、整理知识、查询 Wiki、
 检查质量、审核候选页面、处理 Inbox 时使用。
 触发词：wiki-ingest、wiki-lint、wiki-review、inbox-process、
 摄入资料、整理知识库、审核笔记、处理收件箱。
---

# LLM Wiki 技能

## 参考文档
处理任何任务前，先读取 `我的知识库/知识库使用手册.md`，按其中的目录职责和流转规则执行。
同时读取 `我的知识库/Agent 权限与操作规则.md`，遵守权限边界。

## 路径配置

- 原始素材目录：`raw/`
- Wiki 输出目录：`我的知识库/05_Agent(智能体)/wiki/`
- 候选页面目录：`我的知识库/05_Agent(智能体)/wiki/candidates/`
- Inbox 监听目录：`我的知识库/00_Inbox(灵感库)/`
- 标注索引目录：`我的知识库/05_Agent(智能体)/annotations/`
- 记忆目录：`memory/`
- 领域目录：`我的知识库/03_Resources(资源)/{领域}/`
- 标准定义目录：`我的知识库/05_Agent(智能体)/wiki/concepts/`

## 领域检索规则

按以下优先级检索：

1. **标准定义优先**：先在 `concepts/` 下查找 `type: definition` 且 `confidence: verified` 的页面。
2. **领域限定**：判断问题领域（室内设计/3D打印/艺术/经济/科技/人文/其他），优先检索：
 - `我的知识库/03_Resources(资源)/{领域}/`
 - `我的知识库/02_Areas(领域)/{领域}/`
 - `我的知识库/MOC(内容地图)/{领域} MOC.md`
1. **扩展检索**：结果不足时扩展到 `05_Agent(智能体)/wiki/` 全库。
2. **跨领域问题**：同时检索多个领域。

候选页面（`candidates/`）不参与检索，只有 `approved` 和 `verified` 状态参与。

## /inbox-process（处理收件箱）

1. 扫描 `我的知识库/00_Inbox(灵感库)/` 下的所有文件。
2. 对每个文件：
 - 读取内容，判断类型（笔记/PDF/剪藏/待办）和领域。
 - 参照 `知识库使用手册.md` 决定去向：
 - 需要编译成 Wiki → 复制到 `raw/sources/`，触发 `/wiki-ingest`
 - 参考资料 → 移动到 `raw/` 对应子目录
 - 无法判断 → 保留，标记 `status: needs_human`
 - 原文件从 Inbox 移走。
1. 记录处理日志到 `05_Agent(智能体)/wiki/log.md`。

## /wiki-ingest（摄入与编译）

1. 扫描 `raw/sources/` 下的新文件。
2. 计算 SHA256，对比 `memory/wiki_ingest_state.json`，跳过未修改文件。
3. 对每个新文件，调用 LLM 提取实体和概念，判断领域。
4. **生成候选页面**（不直接写入正式 Wiki）：
 - 概念页 → `candidates/concepts/`
 - 实体页 → `candidates/entities/`
 - 来源摘要 → `candidates/sources/`
5. 候选页面 YAML 必须包含：`status: needs_review`、`type`、`domain`、`source`、`created`。
6. 自动添加双链（指向已有 `approved` 页面）和领域标签。
7. 更新 `05_Agent(智能体)/wiki/log.md` 和摄入状态文件。

## /wiki-review（审核辅助）

1. 列出 `candidates/` 下所有 `status: needs_review` 的页面。
2. 逐个展示页面内容、来源、LLM 置信度。
3. 你决定：批准 / 修改后批准 / 拒绝。
4. 批准后，页面移入 `05_Agent(智能体)/wiki/{type}/`，`status` 改为 `approved`，更新相关双链和 MOC。

## /wiki-lint（质量检查）

检查并报告：
- 死链、孤立页面、元数据缺失
- 矛盾信息
- 候选积压（`candidates/` 超过 20 个待审核）
- 标准定义缺口
- 标注索引与实际文件不一致

## 人工区（01–04）标签处理规则

- 默认不修改 01–04 下的原文件。
- 定期扫描 01–04，生成标注索引到 `05_Agent(智能体)/annotations/{目录名}.md`。
- 标注索引包含：文件名、领域、标签、摘要、最后分析时间、状态。
- 当用户明确要求“给某篇笔记打标签”时，先建议标签，等用户确认后再写入原文件 YAML。
- 标注索引本身自动更新，不需要用户确认。

步骤 6：写入 `D:\知识库\我的知识库\知识库使用手册.md`

创建该文件，内容为完整的《知识库目录职责说明》，包含以下章节：

一、总原则：文件夹管状态，标签管主题，双链管关系
二、目录总览
三、逐目录详细说明：每个目录的放什么、不放什么、命名规范、元数据、流转规则、示例
四、笔记流转规则：从 Inbox 到最终归档的完整流程图
五、元数据字段速查：type、domain、status、created、source、confidence 等
六、判断速查表：面对不同情况时该放哪个目录

步骤 7：写入 `D:\知识库\我的知识库\Agent 权限与操作规则.md`

创建该文件，内容包含以下章节：

一、进入知识库的触发条件：可以主动进入的情况、不可以主动进入的情况
二、读取权限表：各目录能否读取及条件
三、写入权限矩阵：操作 / 目标目录 / 能否自动执行 / 是否需要确认
四、必须等用户确认的操作清单
五、定时任务权限表
六、其他 Agent 的权限表：WorkBuddy、通用 nanobot、外部工具
**七、冲突处理规则

步骤 8：写入 `D:\知识库\我的知识库\05_Agent\wiki\schema.md`

# Wiki Schema

## 页面类型
- concepts/：概念、理论、方法
- entities/：人物、组织、产品、工具
- sources/：来源摘要
- comparisons/：对比分析
- queries/：查询快照

## 标准定义层（Authoritative Definitions）

### 识别规则
标准定义页面的 YAML 必须包含：
- `type: definition`
- `confidence: verified`
- `source: <权威来源>`

### 检索优先级
1. `concepts/` 下 `type: definition` 且 `confidence: verified`（最高优先级）
2. `concepts/` 下其他页面
3. `entities/`、`sources/`、`comparisons/`
4. 手动区 `03_Resources(资源)/`

### 标准定义页面模板
---
type: definition
confidence: verified
source: <教材名/官方文档/论文>
domain: <领域>
created: {{date}}
tags: []
---

# <概念名>

## 权威定义
## 我的理解
## 常见误解
## 关联

## 元数据规范

### 所有页面必须包含
- `type`
- `domain`（室内设计/3D打印/艺术/经济/科技/人文/其他）
- `created`
- `status`（needs_review/approved/rejected/verified）

### 审核状态机

| 状态 | 含义 | 谁设置 |
| :--- | :--- | :--- |
| `needs_review` | LLM 生成的草稿，待审核 | LLM 自动 |
| `approved` | 人工已批准 | 你手动 |
| `rejected` | 审核未通过 | 你手动 |
| `verified` | 已审核且标注权威来源（仅限 definition） | 你手动 |

### 审核规则
- `needs_review` 页面存放于 `candidates/`
- 批准后移动到 `concepts/` 或 `entities/`，`status` 改为 `approved`
- 只有 `approved` 和 `verified` 参与检索
- `rejected` 页面移回 `candidates/rejected/`

## 标注索引（Annotations）

### 位置
`05_Agent/annotations/{01_Projects|02_Areas|03_Resources|04_Archive}.md`

### 每条记录格式
- 文件名
- 领域
- 标签
- 摘要（一句话）
- 最后分析时间
- 状态

### 更新规则
- 每次 `/wiki-ingest` 或 `/wiki-lint` 时同步更新
- 原文件未修改时不重复分析（SHA256）
- 原文件修改后重新分析并更新条目

## 链接规则
- 每个页面至少链接 2 个其他页面
- 同领域页面互相链接
- 标准定义页面必须链接到至少 1 个 `entities/` 页面

## 矛盾处理
不同来源冲突时，创建 `comparisons/` 页面并列展示，并标注来源。

步骤 9：创建 Wiki 索引和日志

D:\知识库\我的知识库\05_Agent\wiki\index.md：

# Wiki 索引

## 概念
（由 /wiki-ingest 自动填充）

## 实体
（由 /wiki-ingest 自动填充）

## 标准定义
（由人工审核后添加）

## 对比
（由 /wiki-ingest 自动填充）

D:\知识库\我的知识库\05_Agent\wiki\log.md：

# Wiki 日志

## 2026-09-24
- 知识库初始化完成（nanobot 0.3.5）
- 创建配置目录（D:\nanobot-config\）与 workspace（D:\知识库\）
- 会话存储已配置在 workspace 外

步骤 10：创建领域 MOC 文件

为每个领域创建 MOC 文件。模板：

# {领域} MOC

## 02_Areas(领域)
（待填充）

## 03_Resources(资源)
### 书籍
（待填充）
### 课程
（待填充）
### 文章
（待填充）

## 05_Agent(智能体)/wiki
（待填充）

## 06_Toolbox(工具箱)
（待填充）

需创建：室内设计、3D打印、艺术、经济、科技、人文、其他，共 7 个文件，放在 D:\知识库\我的知识库\MOC\ 下。

步骤 11：创建工具箱索引

D:\知识库\我的知识库\06_Toolbox(工具箱)\README.md：

# 工具箱索引

## scripts/
（待添加）

## snippets/
（待添加）

## packages/
（待添加）

步骤 12：创建标注索引占位文件

在 D:\知识库\我的知识库\05_Agent(智能体)\annotations\ 下创建：

01_Projects.md
02_Areas.md
03_Resources.md
04_Archive.md

每个文件初始内容：

# {目录名} 标注索引

（由 /wiki-lint 或 /wiki-ingest 自动填充）

步骤 13：验证

# ============================================
# 关键文件验证
# ============================================
Write-Host "=== 配置文件验证 ==="
Test-Path "D:\nanobot-config\config.json"
Test-Path "D:\nanobot-config\sessions"

Write-Host "`n=== Agent 文件验证 ==="
Test-Path "D:\知识库\SOUL.md"
Test-Path "D:\知识库\USER.md"
Test-Path "D:\知识库\skills\llm-wiki\SKILL.md"
Test-Path "D:\知识库\memory"

Write-Host "`n=== Vault 文件验证 ==="
Test-Path "D:\知识库\我的知识库\知识库使用手册.md"
Test-Path "D:\知识库\我的知识库\Agent 权限与操作规则.md"
Test-Path "D:\知识库\我的知识库\05_Agent(智能体)\wiki\schema.md"
Test-Path "D:\知识库\我的知识库\05_Agent(智能体)\wiki\candidates"
Test-Path "D:\知识库\我的知识库\05_Agent(智能体)\annotations"

Write-Host "`n=== 路径校验（关键） ==="
$ws = [System.IO.Path]::GetFullPath("D:\知识库")
$ss = [System.IO.Path]::GetFullPath("D:\nanobot-config\sessions")
Write-Host "workspace: $ws"
Write-Host "sessions: $ss"
if ($ss.StartsWith($ws)) {
 Write-Host "❌ 错误：sessions 在 workspace 内，启动将失败！" -ForegroundColor Red
} else {
 Write-Host "✅ 正确：sessions 在 workspace 外，校验通过" -ForegroundColor Green
}

Write-Host "`n=== 目录树 ==="
Get-ChildItem "D:\nanobot-config" -Recurse | Select-Object FullName
Get-ChildItem "D:\知识库" -Recurse -Directory | Select-Object FullName

步骤 14：启动知识库实例

nanobot gateway --config "D:\nanobot-config\config.json"

首次启动时会发生什么：

nanobot 检测到配置目录下的 sessions/ 目录，创建或确认 <workspace-id> 子目录。
如果 workspace 内存在旧版会话文件（D:\知识库\sessions\*.jsonl），自动迁移到 D:\nanobot-config\sessions\<workspace-id>\ 下，迁移前会验证副本完整性。
workspace 内生成 .nanobot/workspace-id 文件，仅包含一个不透明 ID。
迁移过程是幂等的，重复启动不会重复迁移。

预期输出：

✓ Loaded config from D:\nanobot-config\config.json
✓ Workspace: D:\知识库
✓ Sessions stored at D:\nanobot-config\sessions\<workspace-id>\
✓ Gateway listening on port 18791

步骤 15：启动后验证清单

检查项	命令	预期结果
配置文件	`Test-Path D:\nanobot-config\config.json`	`True`
会话根目录	`Test-Path D:\nanobot-config\sessions`	`True`
会话子目录	`Get-ChildItem D:\nanobot-config\sessions`	至少一个 `<workspace-id>` 目录
workspace 内无 sessions	`Test-Path D:\知识库\sessions`	`False`（旧版路径不应存在）
workspace-id 文件	`Test-Path D:\知识库\.nanobot\workspace-id`	`True`
Gateway 启动	观察启动输出	端口 18791 监听成功，无 RuntimeError

执行要求

每完成一个步骤，输出确认信息。
如果某个文件已存在，先备份为 .bak，再覆盖。
首次启动前，确保没有旧版 nanobot 进程正在写入同一个 workspace。
不要让旧版本和新版本同时写入同一个 workspace，否则会导致会话数据冲突。
全部完成后，输出完整的目录树和文件清单。

现在开始执行。

新旧版本关键差异对照

变更项	旧版（≤0.3.4）	nanobot 0.3.5
会话存储位置	`workspace/sessions/`	`<config-dir>/sessions/<workspace-id>/`
配置目录	可与 workspace 相同	必须与 workspace 分离
校验逻辑	无	`sessions_root` 不能在 workspace 内
会话迁移	无	首次启动自动迁移，幂等
SOUL.md	无会话说明	新增会话存储说明
降级方式	无	`nanobot sessions restore-workspace`

升级注意事项

如果你已经在旧版 nanobot 上部署了知识库，升级到 0.3.5 后需要遵循官方升级说明：

备份：先备份配置、workspace 和会话存储。
停止旧进程：停止所有旧版 nanobot 进程。
启动新版本：首次启动时 nanobot 会自动迁移旧会话文件。
不要并行写入：不要让旧版本和新版本同时写入同一个 workspace。
如需降级：停止 nanobot 后，使用 nanobot sessions restore-workspace --config <config.json> --workspace <workspace> 恢复会话到 workspace 内。

启动脚本（可选）

在桌面创建 启动知识库.bat：

@echo off
echo Starting Knowledge Base Nanobot...
nanobot gateway --config "D:\nanobot-config\config.json"
pause

以后双击即可启动。
也可以让nanobot把脚本修改成 wiki 命令来调用

这份部署指令已自包含，直接复制给 nanobot 即可执行。如果执行过程中遇到报错，把错误信息发给AI查看。

关联

配套文件：LLM-Wiki 个人知识库搭建说明
Wiki 概念：LLM Wiki 模式｜标准定义层｜审核状态机
Wiki 实体：llm-wiki Skill
来源摘要：个人知识库Agent自动搭建说明
规则文档：知识库使用手册｜ Agent 权限与操作规则
领域入口：科技 MOC

📄 延伸阅读：LLM-Wiki 个人知识库搭建说明 —— 概念、目录结构、日常维护与迁移。

LLM-Wiki 个人知识库搭建说明

mythstraw@msn.com (ForeverYang) — Mon, 05 Oct 2026 20:35:00 +0800

版本：1.0
适用：希望用 AI Agent 管理个人知识库的用户
默认工具链：nanobot + Obsidian + WorkBuddy（可选）

第一部分基础概念

1.1 什么是 LLM-Wiki

LLM-Wiki 是一种由 AI Agent 驱动的个人知识库构建范式。它的核心思想是：

让大语言模型担任“知识编译器”，把你提供的原始资料持续编译成结构化、可积累的 Markdown 维基（Wiki），而不是每次提问时临时检索。

LLM-Wiki 的工作方式是“摄入时编译”：LLM 通读原始资料，完成语义理解、要点提炼、知识分类，生成结构化 Wiki 页面。每个主题单独成页，页面自带摘要，并通过双链形成知识网络。知识被持久沉淀下来，实现复利增长。

核心比喻：

Obsidian 是 IDE
LLM 是程序员
Wiki 是代码库

1.2 什么是 RAG

RAG = Retrieval-Augmented Generation，检索增强生成。

它的基本流程：

用户提问
系统从知识库中检索相关内容
把检索结果作为上下文，交给大模型
大模型基于这些内容生成回答
最好附带引用来源

RAG 不是单纯搜索，也不是单纯大模型，而是 检索系统 + 大模型生成 + 知识库。

RAG 与 LLM-Wiki 的关系：

RAG 是让大模型使用知识库的检索增强机制
LLM-Wiki 是在 RAG 之上增加了一个“知识编译层”
两者互补：RAG 保证事实精度，LLM-Wiki 负责知识结构化与沉淀

第二部分知识库的作用

2.1 LLM-Wiki 知识管理

LLM-Wiki 知识管理的核心优势：

维度	传统 RAG	LLM-Wiki
存储	向量数据库（二进制）	纯 Markdown 文件
可读性	需要工具查看	用 Obsidian 直接打开
可编辑	需改代码	改 Markdown 即可
知识积累	查询时临时计算	摄入时编译，持久沉淀
版本控制	需自行配置	Git 自动提交，可回滚
与 Obsidian 集成	需桥接层	同一份文件，原生互通
隐私	取决于部署方式	完全本地，文件在你硬盘上

关键点：你的知识库就是一堆 Markdown 文件。即使 Agent 不再维护，你仍然可以用 Obsidian 打开、阅读、编辑它们。

RAG 适合固定知识检索查阅，比如中学生知识库，把教材教辅资料进行向量化处理放进数据库，通过大模型检索数据生成答案，本质上对资料文件做向量化拆分，匹配检索，生成答案。

Wiki 是知识管理系统，同样是中学生知识库，Wiki 是把资料先按 Wiki 的结构做拆分，方便检索和编辑，每一部分都可以自主编辑添加或者删除，对已有的知识进行维护查缺补漏，让知识更完善。

LLM-Wiki 结构：三层分离

一个标准的 LLM Wiki 系统通常分为三层：

原始素材层 (Raw Sources)：存放不可修改的原始文档（PDF、笔记、PR 记录等）。这一层只读，确保所有结论都能溯源回原始资料。
Wiki 结构化知识层 (Wiki Layer)：系统的核心产出，由 LLM 生成和维护。包含概念页、实体页、对比页、综合页等，全部为 Markdown 格式，页面间通过 [[wikilinks]] 相互链接。
规则定义层 (Schema Layer)：定义工作规则的“宪法”。包括文件夹结构、引用规则、摄入流程、问答行为规范等，用来指导 LLM 如何维护 Wiki。

⚙️ 关键操作流程

LLM Wiki 的日常运转依赖几个核心操作：

Ingest（摄入/编译）：将新资料放入原始素材层，LLM 会分析内容、提取实体与概念，并生成或更新对应的 Wiki 页面。这个过程通常采用“两步思维链”（先分析，再生成）来保证质量，并通过 SHA256 哈希增量缓存来避免重复处理未修改的文件，节省成本。
Query（查询）：用户提问时，系统直接基于已编译的 Wiki 页面进行回答，速度更快，且答案会引用 Wiki 页面，而非原始文档的碎片。
Lint（自检与回填）：LLM 定期或在触发时，检查知识库中的矛盾、知识空白，甚至可以通过“深度研究（Deep Research）”功能自动去外部填补这些空白。

Wiki 结构说明

LLM 编译的概念页（concepts/）：只负责把一个术语定义清楚
实体页（entities/）：只负责记录一个人、产品或工具的身份与立场
来源摘要页（sources/）：只负责把一组相关概念串起来，枢纽的作用
对比分析页（comparisons/）：只负责把两个易混的东西横向摆开
查询快照（queries/）：有价值的问答记录，是经过整理的“知识快照”
待定页 candidates/：wiki 草稿先进入这里，状态为 needs_review，需要人工审核

2.2 AI 笔记自动管理

AI Agent 可以自动完成：

Inbox 处理：读取 00_Inbox(灵感库)/ 根目录，判断类型（笔记/PDF/剪藏/待办）与领域，先报告判断与建议去向、等你裁决，裁决后才落位（编译 Wiki → 移动到 _nanobot/raw/sources/；参考资料 → 03_Resources(资源)/{领域}/；待办/项目 → 01_Projects(项目)/；归档 → 04_Archive(归档)/{年份}/）
Wiki 编译：读取原始素材，生成概念页、实体页、来源摘要页
候选审核辅助：生成候选页面到 candidates/，等待你审核
标注索引：扫描 01–04，生成标签、摘要、领域判断到 annotations/
质量检查：检测死链、孤立页面、元数据缺失、矛盾信息
知识检索：优先检索标准定义页和领域目录，减少幻觉

AI 自动管理笔记，对笔记做分类、打标签、做链接，通过 AI 自动管理笔记。

第三部分 AI 知识库用到的工具

3.1 Agent：nanobot（默认）

nanobot 是一个轻量级、本地优先的 AI Agent，适合管理个人知识库。

核心能力：

文件读写、Shell 执行、Skill 扩展
长期记忆（MEMORY.md）和事件日志（HISTORY.md）
Dream 后台固化：将对话中的知识沉淀到记忆和 Wiki
Local Triggers：响应文件系统变化，自动触发任务
多实例支持：不同实例物理隔离，互不干扰

其他可选 Agent：

WorkBuddy：腾讯云 AI 办公助手，适合与办公生态集成，可写入 Inbox
opencode：面向开发者的 AI 编程助手，适合 LLM-Wiki 编译模式

3.2 Obsidian

Obsidian 是基于 Markdown 的本地知识管理工具。

核心作用：

阅读和编辑知识库中的 Markdown 文件
双向链接、标签、图谱、MOC 导航
搜索、Dataview 查询
插件生态（Templates、Folder Bridge、BRAT 等）

Obsidian Vault 与 nanobot workspace 的关系：

Obsidian Vault 是知识资产，必须是一个独立、可自由移动的文件夹
nanobot workspace 指向 Vault 的父目录，Agent 文件放在 Vault 外
只有 Wiki 产出（05_Agent(智能体)/wiki/）在 Vault 内，参与 Obsidian 索引

第四部分开始搭建知识库

4.1 Agent 选择

默认使用 nanobot。如果你已经使用 WorkBuddy 或 opencode，也可以混合使用。

多工具协作原则：

WorkBuddy 只写入 00_Inbox(灵感库)/
知识库 nanobot 从 00_Inbox(灵感库)/ 读取并处理
通用 nanobot 处理电脑问题，不访问知识库
两个 nanobot 实例物理隔离，端口不同

4.2 确定知识库目录结构

推荐目录结构如下（以 D:\知识库\ 为例）：

D:\知识库\ ← 知识库实例的 workspace 根
│
├── _nanobot\ # ★ Agent 专用目录（Obsidian 不可见）
│ ├── config.json # 知识库实例配置
│ ├── SOUL.md # Agent 沟通风格
│ ├── USER.md # 用户画像
│ ├── raw\ # 原始素材层（只读）
│ │ ├── sources\
│ │ ├── articles\
│ │ ├── papers\
│ │ ├── transcripts\
│ │ └── assets\
│ ├── memory\ # 记忆与状态
│ │ ├── MEMORY.md
│ │ ├── HISTORY.md
│ │ └── wiki_ingest_state.json
│ └── skills\ # Agent 技能定义
│ └── llm-wiki\
│ └── SKILL.md
│
└── 我的知识库\ ← ★ Obsidian Vault 根
 ├── 00_Inbox(灵感库)\ # 快速捕获，多工具入口
 ├── 01_Projects(项目)\ # 有截止日期的项目
 ├── 02_Areas(领域)\ # 长期领域
 │ ├── 室内设计\
 │ ├── 3D打印\
 │ ├── 艺术\
 │ ├── 经济\
 │ ├── 科技\
 │ ├── 人文\
 │ └── 其他\
 ├── 03_Resources(资源)\ # 主题知识、参考资料
 │ ├── 室内设计\
 │ ├── 3D打印\
 │ ├── 艺术\
 │ ├── 经济\
 │ ├── 科技\
 │ ├── 人文\
 │ └── 其他\
 ├── 04_Archive(归档)\ # 归档
 │ ├── 2025\
 │ └── 2026\
 ├── 05_Agent(智能体)\ # Agent 自动管理区
 │ ├── wiki\ # LLM 编译的结构化知识
 │ │ ├── index.md
 │ │ ├── log.md
 │ │ ├── schema.md
 │ │ ├── concepts\
 │ │ ├── entities\
 │ │ ├── sources\
 │ │ ├── comparisons\
 │ │ ├── queries\
 │ │ └── candidates\ # 候选页面，待审核
 │ └── annotations\ # 标注索引
 ├── 06_Toolbox(工具箱)\ # 代码、脚本、工具包
 │ ├── README.md
 │ ├── scripts\
 │ ├── snippets\
 │ └── packages\
 ├── MOC(内容地图)\ # 领域入口页
 ├── Templates(模板)\ # 模板
 └── Attachments(附件)\ # 全局附件

各目录作用速查：

目录	作用	谁写入	Obsidian 索引
`00_Inbox(灵感库)/`	临时捕获，多工具入口	你 + WorkBuddy	✅
`01_Projects(项目)/`	有截止日期的项目	你	✅
`02_Areas(领域)/`	长期维护的领域	你	✅
`03_Resources(资源)/`	主题知识、参考资料	你	✅
`04_Archive(归档)/`	归档	你 + Agent 可移入	✅
`05_Agent(智能体)/wiki/`	LLM 编译的知识	Agent + 你审核	✅
`05_Agent(智能体)/annotations/`	标注索引	Agent	✅
`06_Toolbox(工具箱)/`	代码、脚本	你	可选
`_nanobot/raw/`	原始素材	你放入，Agent 只读	❌
`_nanobot/memory/`	Agent 记忆和状态	Agent	❌
`_nanobot/skills/`	Skill 定义	你编写	❌

4.3 Agent 自动搭建文档

将以下部署指令复制给 nanobot，它会自动创建所有目录、写入所有配置文件。

部署指令要点：

创建目录结构
写入 _nanobot/config.json
写入 _nanobot/SOUL.md
写入 _nanobot/USER.md
写入 _nanobot/skills/llm-wiki/SKILL.md
写入 我的知识库/知识库使用手册.md
写入 我的知识库/05_Agent(智能体)/wiki/schema.md
创建 Wiki 索引、日志、MOC、工具箱索引、标注索引占位文件
验证并启动

完整部署指令见 nanobot 0.3.5 个人知识库自动部署指令。

第五部分知识库测试优化

5.1 了解知识库系统，文件的作用，命令

核心文件：

文件	作用
`SOUL.md`	Agent 沟通风格和工作原则
`USER.md`	用户画像和偏好
`MEMORY.md`	长期事实，每次对话加载
`HISTORY.md`	事件日志，按需检索
`SKILL.md`	Agent 技能定义
`schema.md`	Wiki 结构规则
`知识库使用手册.md`	目录职责和流转规则
`Agent 权限与操作规则.md`	权限边界和触发条件

常用命令：

命令	作用
`/inbox-process`	处理 `00_Inbox(灵感库)/`（先报判断与建议去向，等你裁决后才落位）
`/wiki-ingest`	摄入 `raw/` 素材，生成候选页面
`/wiki-review`	审核候选页面
`/wiki-lint`	检查死链、孤立页面、元数据缺失
`/wiki-save-answer`	保存有价值的问答快照

5.2 知识库使用手册创建（作用）

文件位置：我的知识库/知识库使用手册.md

作用：

定义每个文件夹放什么、不放什么、命名规范、元数据要求
定义笔记在文件夹之间的流转规则
供你和 nanobot 共同参考
nanobot 在处理 Inbox、生成标注索引时，会读取此文件作为判断依据

核心内容：

总原则
目录总览
逐目录详细说明
笔记流转规则
元数据字段速查
判断速查表

5.3 Agent 权限与操作规则创建（作用）

文件位置：我的知识库/Agent 权限与操作规则.md

作用：

定义 Agent 什么时候可以进入知识库
定义进入后可以读取哪些内容
定义什么情况下可以写入、移动、归档或调用 Skill
定义哪些操作必须等用户确认
定义定时任务、其他 Agent 对话的权限

核心内容：

进入知识库的触发条件
读取权限表
写入权限矩阵
必须等用户确认的操作清单
定时任务权限表
其他 Agent 权限表
冲突处理规则

配置方式：

在 SOUL.md 中添加强制引用指令
在 SKILL.md 中添加参考文档引用
重启 nanobot 使配置生效

5.4 完整工作流

工作流 1：摄入新素材（`/wiki-ingest`）


你把 PDF/网页剪藏放入 raw/sources/
 ↓
执行 /wiki-ingest
 ↓
nanobot 读取 raw/ 内容，计算 SHA256 指纹
 ↓
对比 memory/wiki_ingest_state.json，跳过未修改的文件
 ↓
LLM 分析内容，提取实体与概念
 ↓
在 wiki/entities/ 和 wiki/concepts/ 下生成或更新 Markdown 页面
 ↓
自动添加双链、元数据（type, source, created）
 ↓
写入 wiki/log.md 记录本次摄入
 ↓
Git 自动提交变更

工作流 2：日常问答与知识沉淀


你提问
 ↓
nanobot 从 MEMORY.md + wiki/ 中检索相关内容（grep + 注入）
 ↓
LLM 基于检索结果生成回答
 ↓
如果对话中产生了新知识，Dream 后台任务会将其固化
 ↓
固化结果写入 MEMORY.md 或 wiki/
 ↓
你可以用 /wiki-save-answer 把有价值的问答快照保存到 wiki/queries/

工作流 3：定期维护（`/wiki-lint`）


执行 /wiki-lint
 ↓
nanobot 扫描 wiki/ 所有页面
 ↓
检测：矛盾信息、死链、孤立页面、元数据缺失、标题重复
 ↓
生成维护报告，写入 wiki/log.md
 ↓
你可以决定是否让 nanobot 自动修复

第六部分如何维护，知识库迁移

6.1 日常维护

频率	任务
每天	检查 `00_Inbox(灵感库)/`，让 nanobot 处理
每周	执行 `/wiki-lint`，审核候选页面，更新 MOC
每月	检查标注索引，整理标签，归档不再活跃的内容
每季度	备份知识库，检查 Agent 权限规则是否需要调整

维护原则：

原始素材放入 _nanobot/raw/ 后不再修改
Wiki 页面必须经过人工审核才能进入正式区域
人工区（01–04）由你主导，Agent 默认不改写
定期用 Git 提交变更，保留历史版本

6.2 知识库迁移

迁移目标：把知识库转移到新电脑，继续使用 WorkBuddy 或 Obsidian 编辑。

核心原则：

你的知识资产（Obsidian Vault）必须是一个独立的、可自由移动的文件夹。

迁移步骤：

备份 Vault：复制 我的知识库/ 文件夹到新电脑任意位置。
用 Obsidian 打开：在新电脑上安装 Obsidian，打开该文件夹。所有笔记、双链、图谱完整呈现，不需要安装 nanobot。
使用 WorkBuddy：启动 WorkBuddy，将 我的知识库/ 设置为工作目录或授权文件夹，即可继续编辑。
（可选）迁移 nanobot：如果需要在新电脑上使用 nanobot 管理知识库，复制 _nanobot/ 目录，修改 config.json 中的 workspace 路径，重新启动实例。

备份策略：

知识资产：定期复制 我的知识库/ 到其他硬盘或云盘
Agent 配置：_nanobot/ 目录可用 Git 管理，重要性低于知识资产
版本控制：整个 Vault 建议用 Git 版本化，_nanobot/memory/.git 自动提交记忆变更

说明书完。

关联

配套文件：nanobot 0.3.5 个人知识库自动部署指令
Wiki 概念：LLM Wiki 模式｜标准定义层｜审核状态机
Wiki 实体：llm-wiki Skill
来源摘要：个人知识库 Agent 自动搭建说明
规则文档：知识库使用手册｜ Agent 权限与操作规则
领域入口：科技 MOC

📄 延伸阅读：nanobot 0.3.5 个人知识库自动部署指令 —— 可直接复制给 Agent 的完整部署指令。