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; ...")

# ============================================
# 路径定义
# ============================================
$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"

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

# 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/`。

# 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:\知识库\`，再停止旧进程，最后启动新版本。

---
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。
- 标注索引本身自动更新，不需要用户确认。

# 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/` 页面并列展示，并标注来源。

# Wiki 索引

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

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

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

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

# Wiki 日志

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

# {领域} MOC

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

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

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

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

# 工具箱索引

## scripts/
（待添加）

## snippets/
（待添加）

## packages/
（待添加）

# {目录名} 标注索引

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

# ============================================
# 关键文件验证
# ============================================
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

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

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