@itradingai/aiwiki 0.2.10 → 0.2.11

package/docs/AGENT_HANDOFF.md

@@ -15,33 +15,34 @@ Agent 应自动读取网页，生成 payload，通过 AIWiki CLI 写入本地知
 ## 职责边界
 
 ```text
-Agent 负责：读取网页、整理正文、生成 payload、调用 CLI、回复用户
-AIWiki CLI 负责：校验 payload、写本地文件、输出入库结果
+Agent 负责：读取网页、理解正文、尽量生成 analysis/wiki_entry、调用 CLI、回复用户
+AIWiki CLI 负责：校验 payload、写本地文件、生成 Wiki Entry、输出入库结果
 用户负责：提供链接或正文，最后审阅结果
 ```
 
-AIWiki CLI 不做通用网页抓取。网页读取失败时，Agent 仍然要调用 CLI 记录失败原因。
+AIWiki CLI 不做通用网页抓取，也不调用 LLM。网页读取失败时，Agent 仍然要调用 CLI 记录失败原因；高质量 Wiki 内容由宿主 Agent 提供。
 
 ## 标准流程
 
 1. 读取用户给的 URL、正文、附件或消息。
 2. 如果读取成功，生成 `fetch_status: "ok"` 的 payload。
-3. 如果读取失败，生成 `fetch_status: "failed"` 的 payload，并写清 `fetch_notes`。
-4. 不要让用户保存 payload。
-5. 不要让用户手动运行命令。
-6. 优先通过 stdin 调用：
+3. 尽量基于正文生成 `analysis` 或 `wiki_entry`。
+4. 如果读取失败，生成 `fetch_status: "failed"` 的 payload，并写清 `fetch_notes`。
+5. 不要让用户保存 payload。
+6. 不要让用户手动运行命令。
+7. 优先通过 stdin 调用：
 
 ```bash
 aiwiki ingest-agent --stdin
 ```
 
-7. 如果当前 shell、终端或宿主环境无法保证 stdin 是 UTF-8，先把 payload 写成 UTF-8 JSON 文件，再调用：
+8. 如果当前 shell、终端或宿主环境无法保证 stdin 是 UTF-8，先把 payload 写成 UTF-8 JSON 文件，再调用：
 
 ```bash
 aiwiki ingest-agent --payload <utf8-json-file>
 ```
 
-8. 读取 CLI 输出，向用户回复入库状态、契合度、摘要、资料卡、处理记录和 Obsidian 审阅入口。
+9. 读取 CLI 输出，向用户回复入库状态、摘要、Wiki 条目、质量模式、资料卡和处理记录。
 
 ## 编码要求
 
@@ -64,10 +65,21 @@ AIWiki 会修复常见 UTF-8 mojibake，但这只是兜底；宿主 Agent 仍应
     "fetch_status": "ok",
     "captured_at": "2026-05-07T10:00:00+08:00"
   },
+  "analysis": {
+    "summary": "一句话总结。",
+    "key_points": [
+      "核心观点 1",
+      "核心观点 2"
+    ],
+    "related_concepts": [
+      "概念 A"
+    ]
+  },
   "request": {
     "mode": "ingest",
     "outputs": [
       "source_card",
+      "wiki_entry",
       "creative_assets",
       "topics",
       "draft_outline",
@@ -108,6 +120,7 @@ AIWiki 会修复常见 UTF-8 mojibake，但这只是兜底；宿主 Agent 仍应
 - 不要让用户手动保存 payload。
 - 不要让用户每次输入 `--path`。
 - 不要声称网页抓取是 AIWiki CLI 的能力。
+- 不要声称 AIWiki CLI 会在没有 Agent 分析字段时自动高质量总结。
 - 不要在 `fetch_status: "failed"` 时塞入正文内容。
 - 不要替用户安装 Dataview。
 - 不要修改 `.obsidian`、`community-plugins.json` 或 Obsidian 插件配置。
@@ -123,13 +136,13 @@ Dataview 只是可选增强。用户自行在 Obsidian Community plugins 中安
 成功时：
 
 ```text
-已加入 Obsidian 审阅队列。
+AIWiki 已完成入库，并生成 Wiki 条目。
 契合度：<fit_score> / <fit_level>
 摘要：<summary>
+Wiki 条目：<wiki_entry>
+质量模式：<wiki_entry_quality> / <wiki_entry_generation_mode>
 资料卡：<source_card>
 处理记录：<processing_summary>
-Obsidian 入口：<dashboard>
-待审队列：<review_queue>
 ```
 
 失败但已记录时：
@@ -140,5 +153,20 @@ Obsidian 入口：<dashboard>
 记录目录：<run_dir>
 处理摘要：<processing_summary>
 Obsidian 入口：<dashboard>
-待审队列：<review_queue>
 ```
+
+## Query / Lint
+
+当用户说“从 AIWiki 里了解某个主题”时，调用：
+
+```bash
+aiwiki context "<主题>"
+```
+
+当用户说“整理 / 检查知识库”时，调用：
+
+```bash
+aiwiki lint
+```
+
+`context` 返回 JSON，注意其中的 `generation_mode`、`quality` 和 `warnings`。如果结果是 `deterministic_fallback` / `scaffold`，回复时要说明它只是可追溯脚手架，不是高质量知识提炼。

package/docs/FAQ.md

@@ -2,11 +2,28 @@
 
 ## AIWiki 是什么？
 
-AIWiki 是一个开源的 Agent-first AI 知识库 CLI。它把文章链接、网页正文和本地文本整理成本地知识资产，方便在 Obsidian 里继续审阅和写作。
+AIWiki 是一个开源的 Agent-first 本地 LLM-wiki CLI。宿主 Agent 负责读取和理解内容，AIWiki 负责把结果稳定写成本地 Markdown 知识库。
 
 ## AIWiki 是网页爬虫吗？
 
-不是。网页读取主要交给宿主 Agent，AIWiki 专注于校验结构化输入、写本地文件和生成审阅产物。
+不是。网页读取主要交给宿主 Agent，AIWiki 专注于校验结构化输入、写本地文件、生成 Wiki Entry、提供 context 和 lint。
+
+## AIWiki 会自动高质量总结吗？
+
+不会。AIWiki CLI 本身不调用 LLM。高质量 Wiki Entry 来自宿主 Agent 在 payload 中提供的 `analysis` 或 `wiki_entry`。
+
+## 为什么会生成 05-wiki？
+
+因为 AIWiki 的目标不是只保存资料，而是让资料进入可查询、可维护的 Wiki 知识层。成功入库会生成 `05-wiki/source-knowledge/<slug>.md`。
+
+## Wiki Entry 的两种质量模式是什么？
+
+- `agent_enriched` / `enriched`：宿主 Agent 提供了总结、核心观点、知识点等分析结果。
+- `deterministic_fallback` / `scaffold`：AIWiki 只生成标题、来源、正文预览、反链和待补全区。
+
+## 05-wiki 是否代表我的观点？
+
+不一定。外部资料生成的 Wiki Entry 默认代表外部资料的结构化整理，不代表用户个人观点。
 
 ## 一定要用 Obsidian 吗？
 
@@ -18,9 +35,9 @@ AIWiki 是一个开源的 Agent-first AI 知识库 CLI。它把文章链接、
 
 ## 宿主 Agent 和 AIWiki 各负责什么？
 
-- 宿主 Agent 负责读取网页、正文或附件，并组装 payload
-- AIWiki 负责校验 payload、写本地知识库、输出处理记录
-- 用户负责提供链接或正文，最后在 Obsidian 里审阅结果
+- 宿主 Agent 负责读取网页、正文或附件，并尽量生成 `analysis` / `wiki_entry`
+- AIWiki 负责校验 payload、写本地知识库、生成 Wiki Entry、输出处理记录
+- 用户负责提供链接或正文，并在需要时让 Agent 继续查询或补全
 
 ## 为什么要先让 Agent 学会 AIWiki？
 
@@ -45,3 +62,19 @@ aiwiki agent install
 - [USAGE.md](USAGE.md)
 - [SHOWCASE.md](SHOWCASE.md)
 - [AGENT_HANDOFF.md](AGENT_HANDOFF.md)
+
+## 怎么从知识库里查询？
+
+让宿主 Agent 调用：
+
+```bash
+aiwiki context "主题"
+```
+
+## 怎么检查知识库结构？
+
+运行：
+
+```bash
+aiwiki lint
+```

package/docs/SHOWCASE.md

@@ -13,7 +13,7 @@
 ### 宿主 Agent 做的事
 
 1. 读取网页正文或可访问内容。
-2. 组装 `aiwiki.agent_payload.v1`。
+2. 组装 `aiwiki.agent_payload.v1`，并尽量提供 `analysis` 或 `wiki_entry`。
 3. 调用 `aiwiki ingest-agent --stdin`。
 4. 把 AIWiki 的处理结果回复给用户。
 
@@ -23,6 +23,7 @@
 09-runs/<run-id>/payload.json
 09-runs/<run-id>/raw.md
 09-runs/<run-id>/source-card.md
+09-runs/<run-id>/wiki-entry.md
 09-runs/<run-id>/creative-assets.md
 09-runs/<run-id>/topics.md
 09-runs/<run-id>/draft-outline.md
@@ -35,6 +36,7 @@
 02-raw/articles/
 03-sources/article-cards/
 04-claims/_suggestions/
+05-wiki/source-knowledge/
 06-assets/_suggestions/
 07-topics/ready/
 08-outputs/outlines/
@@ -44,8 +46,9 @@ dashboards/
 ### 用户在 Obsidian 里怎么看
 
 - 打开 `dashboards/AIWiki Home.md`
-- 查看 `dashboards/Review Queue.md`
-- 从资料卡回到原文、选题、大纲和处理记录
+- 查看 `05-wiki/source-knowledge/<slug>.md`
+- 从 Wiki 条目回到资料卡、原文、选题、大纲和处理记录
+- 需要结构检查时运行 `aiwiki lint`
 
 ## 示例 2：网页没读到正文
 
@@ -74,5 +77,7 @@ dashboards/
 
 - AIWiki 不是网页爬虫本体
 - 宿主 Agent 负责读取内容
+- 宿主 Agent 负责高质量总结和知识提炼
 - AIWiki 负责稳定写入本地知识库
+- AIWiki 会创建 Wiki Entry；没有 Agent 分析字段时只生成可追溯脚手架
 - 结果始终可追踪、可复盘、可继续写作

package/docs/USAGE.md

@@ -8,6 +8,8 @@
 
 AIWiki CLI 不负责网页抓取。Qclaw、Codex、Claude Code、Cursor、Gemini CLI 等都只是宿主 Agent 的例子；这份文档面向的是通用宿主 Agent 协作。
 
+AIWiki CLI 也不调用 LLM。高质量 Wiki Entry 来自宿主 Agent 提供的 `analysis` 或 `wiki_entry`；如果没有这些字段，AIWiki 会生成可追溯的 deterministic fallback 条目，只包含来源、反链、正文预览和待补全区。
+
 ## 1. 一次性设置
 
 发布后直接运行交互式 setup：
@@ -118,8 +120,11 @@ source_url: https://example.com/article
 summary: 这里是文章前段摘要，方便 Agent 快速告诉用户文章大意。
 run_id: 20260507-153012-abc123
 run_dir: F:\knowledge_data\aiwiki\09-runs\20260507-153012-abc123
-files: 13
+files: 15
 processing_summary: 09-runs/20260507-153012-abc123/processing-summary.md
+wiki_entry: 05-wiki/source-knowledge/article-slug.md
+wiki_entry_generation_mode: agent_enriched
+wiki_entry_quality: enriched
 source_card: 03-sources/article-cards/article-slug.md
 draft_outline: 09-runs/20260507-153012-abc123/draft-outline.md
 dashboard: dashboards/AIWiki Home.md
@@ -130,13 +135,13 @@ warnings: 0
 宿主 Agent 回复用户时建议展示：
 
 ```text
-已加入 Obsidian 审阅队列。
+AIWiki 已完成入库，并生成 Wiki 条目。
 契合度：90 / high
 摘要：……
+Wiki 条目：……
+质量模式：enriched / agent_enriched
 资料卡：……
 处理记录：……
-Obsidian 入口：dashboards/AIWiki Home.md
-待审队列：dashboards/Review Queue.md
 ```
 
 网页读取失败但已记录原因时类似：
@@ -187,12 +192,18 @@ Obsidian 入口：dashboards/AIWiki Home.md
 02-raw/articles/
 03-sources/article-cards/
 04-claims/_suggestions/
+05-wiki/source-knowledge/
 06-assets/_suggestions/
 07-topics/ready/
 08-outputs/outlines/
 ```
 
-Obsidian 主要审阅长期目录；`09-runs` 用于追溯每次处理。
+`05-wiki/source-knowledge` 是默认知识层；`09-runs` 用于追溯每次处理。
+
+Wiki Entry 有两种质量模式：
+
+- `agent_enriched` / `enriched`：宿主 Agent 提供了 `analysis` 或 `wiki_entry`。
+- `deterministic_fallback` / `scaffold`：AIWiki 只生成来源、反链、正文预览和待补全区。
 
 ### Obsidian 链接规则
 
@@ -200,13 +211,14 @@ AIWiki 生成的 Markdown 按 Obsidian vault 内路径组织，文件正文会
 
 ```text
 [[03-sources/article-cards/article-slug|资料卡]]
+[[05-wiki/source-knowledge/article-slug|Wiki 条目]]
 [[02-raw/articles/article-slug|原文]]
 [[09-runs/20260507-153012-abc123/processing-summary|处理记录]]
 ```
 
 链接规则：
 - wikilink 使用 vault 相对路径，统一为 `/`，并去掉 `.md` 后缀。
-- `03-sources/article-cards` 是主要审阅入口，会链接到原文、Claim 建议、素材建议、选题、大纲和本次处理记录。
+- `05-wiki/source-knowledge` 是默认知识入口；`03-sources/article-cards` 会链接到 Wiki 条目、原文、Claim 建议、素材建议、选题、大纲和本次处理记录。
 - `02-raw/articles`、`04-claims/_suggestions`、`06-assets/_suggestions`、`07-topics/ready`、`08-outputs/outlines` 会回链到资料卡，Obsidian 的 Backlinks/Graph View 可以串起同一篇资料。
 - `09-runs/<run-id>/processing-summary.md` 会把本次生成的 Markdown 文件列成可点击 wikilink；`payload.json` 不是 Markdown，保留普通路径。
 - frontmatter 会写入 `aiwiki_id`、`type`、`status`、`slug`、`source_url`、`created_at`、`captured_at`、`run_id`、`source_card`、`raw_note`、`claims_note`、`assets_note`、`topics_note`、`outline_note`、`run_summary`、`tags` 等字段，便于后续用 Obsidian Search / Properties / Dataview 做筛选。
@@ -247,12 +259,29 @@ docs/AGENT_HANDOFF.md
 核心要求：
 
 - Agent 负责读取网页正文。
+- Agent 应尽量提供 `analysis` 或 `wiki_entry`，让 Wiki Entry 进入 enriched 模式。
 - Agent 不要让用户保存 payload。
 - Agent 不要让用户手动运行 `ingest-agent`。
 - Agent 生成 payload 后优先通过 stdin 调用 `aiwiki ingest-agent --stdin`。
-- Agent 最后只向用户汇报入库状态、契合度、摘要、资料卡、处理记录和 Obsidian 审阅入口。
+- Agent 最后向用户汇报入库状态、摘要、Wiki 条目、质量模式、资料卡和处理记录。
+
+## 7. 查询和整理
+
+从知识库调度内容：
+
+```bash
+aiwiki context "AI Agent"
+```
+
+检查知识库结构：
+
+```bash
+aiwiki lint
+```
+
+`context` 返回 JSON 给宿主 Agent 使用。`lint` 输出报告并写入 `dashboards/Lint Report.md`。
 
-## 7. 高级调试
+## 8. 高级调试
 
 如果 Agent 只能输出 JSON，才需要手动保存 payload：
 
@@ -285,7 +314,7 @@ aiwiki ingest-url "https://example.com/article" --content-file "F:\knowledge_dat
 
 注意：`ingest-url` 不会抓网页，只会读取 `--content-file`。
 
-## 8. 常见问题
+## 9. 常见问题
 
 ### 找不到 `aiwiki` 命令
 
@@ -317,7 +346,7 @@ aiwiki setup --path "F:\knowledge_data\aiwiki" --yes
 aiwiki setup --path "新的知识库路径" --yes
 ```
 
-## 9. 最小验收清单
+## 10. 最小验收清单
 
 完成一次 Agent 入库测试后，检查：
 
@@ -331,4 +360,5 @@ aiwiki status
 - `09-runs` 下出现新目录。
 - `processing-summary.md` 存在。
 - 成功读取时，`03-sources/article-cards` 下出现资料卡。
+- 成功读取时，`05-wiki/source-knowledge` 下出现 Wiki Entry。
 - 抓取失败时，`09-runs/<run-id>-fetch-failed` 下出现失败记录。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itradingai/aiwiki",
-  "version": "0.2.10",
+  "version": "0.2.11",
   "type": "module",
   "description": "Agent-first AI knowledge base CLI for turning articles, links and notes into Obsidian-ready source cards, topics, outlines and reusable knowledge assets.",
   "license": "MIT",

package/skill/LINT_PROTOCOL.md

@@ -0,0 +1,42 @@
+# AIWiki Lint Protocol
+
+Use this protocol when the user asks:
+
+- 整理一下 AIWiki
+- 检查知识库有没有问题
+- 看看 AIWiki 结构是否健康
+- lint AIWiki
+
+## Steps
+
+1. Call:
+
+```bash
+aiwiki lint
+```
+
+2. Read the terminal report.
+3. Mention the report path, usually:
+
+```text
+dashboards/Lint Report.md
+```
+
+4. Explain warnings and errors as structure-health feedback.
+5. Do not frame lint as "the user must manually audit every note".
+
+## Issue Meaning
+
+- `error`: broken structure such as a missing internal link.
+- `warning`: likely fix needed, such as missing source fields or stale fallback entries.
+- `info`: useful inventory, such as deterministic fallback count or duplicate titles.
+
+## Repair Guidance
+
+Prefer small, traceable fixes:
+
+- Regenerate or enrich missing Wiki Entries.
+- Fix broken wikilinks.
+- Add missing `source_card` or `raw_file` paths.
+- Ask the host Agent to provide `analysis` for scaffold entries.
+

package/skill/QUERY_PROTOCOL.md

@@ -0,0 +1,38 @@
+# AIWiki Query Protocol
+
+Use this protocol when the user asks:
+
+- 从 AIWiki 里了解某个主题
+- 基于 AIWiki 里的资料总结某个问题
+- AIWiki 里有没有关于某个主题的内容
+- 帮我用 AIWiki 写一篇文章大纲
+
+## Steps
+
+1. Identify the topic and expected output shape.
+2. Call:
+
+```bash
+aiwiki context "<topic>"
+```
+
+3. Read the JSON result.
+4. Prefer `matches.wiki_entries` before source cards, claims, topics, outlines, or raw refs.
+5. Pay attention to `generation_mode`, `quality`, and `warnings`.
+6. If the best Wiki Entry has `quality: "scaffold"`, tell the user that the entry is a traceable fallback and may need Agent enrichment.
+7. Do not scan `02-raw` by default unless:
+   - Wiki Entries are insufficient.
+   - The user asks to verify the original source.
+   - There is a source conflict.
+   - A precise quote or source check is needed.
+
+## Reply Shape
+
+Include:
+
+- Which Wiki Entries were found.
+- Main conclusions.
+- Source basis.
+- Known gaps or scaffold warnings.
+- Suggested next step.
+

package/skill/SKILL.md

@@ -1,21 +1,22 @@
 ---
 name: aiwiki
-description: Agent-first AIWiki workflow for turning one URL/body into local knowledge production files.
+description: Agent-first AIWiki workflow for turning one URL/body into local Wiki knowledge files.
 ---
 
 # AIWiki Skill
 
-Use this skill when the user asks an Agent to process one URL, article body, or local text file with the `aiwiki` keyword.
+Use this skill when the user asks an Agent to process one URL, article body, or local text file with the `aiwiki` keyword, or says phrases like `入库 <url>` / `收录 <url>` / `从 AIWiki 里了解 <topic>`.
 
-The host Agent reads the webpage or user-provided body, then passes structured content to the `aiwiki` CLI. The base CLI writes files and does not own webpage fetching stability.
+AIWiki CLI does not fetch webpages and does not call an LLM. The host Agent reads and understands the source; AIWiki validates, writes, links, tracks, queries, and lints local Markdown knowledge files.
 
-## Agent 对接流程
+## Ingest Flow
 
 1. Read the URL, message, attachment, or user-provided body.
 2. Build an `aiwiki.agent_payload.v1` payload with `source` and `request`.
-3. Do not include output paths in the payload. The CLI decides where files are written.
-4. If webpage reading fails, still build a payload with `source.fetch_status` set to `failed` and include `source.fetch_notes`.
-5. Prefer stdin so the user does not need to save a payload file:
+3. If you understand the source, also provide `analysis` and/or `wiki_entry`.
+4. Do not include output paths in the payload. The CLI decides where files are written.
+5. If webpage reading fails, still build a payload with `source.fetch_status` set to `failed` and include `source.fetch_notes`.
+6. Prefer stdin so the user does not need to save a payload file:
 
 ```bash
 aiwiki ingest-agent --stdin
@@ -33,43 +34,34 @@ For local files, call:
 aiwiki ingest-file --file <file>
 ```
 
-## 用户回复
+## Wiki Entry Generation Rules
 
-After the CLI runs, read the command output and report these fields to the user:
-
-- `ingested`: whether readable content was written into the knowledge base.
-- `recorded`: whether AIWiki wrote a run record.
-- `fetch_status`: whether the host Agent supplied readable content.
-- `fit_score` and `fit_level`: lightweight fit feedback for review priority.
-- `summary`: short content summary or fetch-failure note.
-- `run_dir` and `processing_summary`: local result entry points.
-- `source_card`: Obsidian source-card entry when ingestion succeeded.
-- `dashboard` and `review_queue`: Obsidian review database entry points.
-
-Recommended reply shape:
+AIWiki always creates a Wiki Entry for successful ingestion:
 
 ```text
-已加入 Obsidian 审阅队列。
-契合度：<fit_score> / <fit_level>
-摘要：<summary>
-资料卡：<source_card>
-处理记录：<processing_summary>
-Obsidian 入口：<dashboard>
-待审队列：<review_queue>
+05-wiki/source-knowledge/<slug>.md
 ```
 
-If `fetch_status` is `failed`, say that AIWiki recorded the failure reason but did not ingest readable content.
+There are two modes:
+
+- `agent_enriched` / `enriched`: you provided `analysis` or `wiki_entry`; AIWiki writes those results into the Wiki Entry.
+- `deterministic_fallback` / `scaffold`: you only provided source content; AIWiki writes title, source links, body preview, backlinks, and a "to be completed by Agent" section.
 
-## Obsidian + Dataview 边界
+Because AIWiki CLI does not call an LLM, high-quality summary and knowledge extraction are the host Agent's responsibility. When possible, provide:
 
-- AIWiki 默认使用中文提示和中文审阅流程。
-- AIWiki 可直接配合 Obsidian 原生 Markdown、Properties、Backlinks、Search 和 Graph View 使用。
-- Dataview 是可选增强，只用于渲染生成的 dashboards。
-- 不要替用户安装 Dataview。
-- 不要编辑 `.obsidian`、`community-plugins.json` 或 Obsidian 插件配置。
-- 如果用户问 Dataview，说明可以在 Obsidian Community plugins 中手动安装并启用，然后打开 `dashboards/AIWiki Home.md`。
+- `analysis.summary`
+- `analysis.key_points`
+- `analysis.reusable_knowledge`
+- `analysis.related_concepts`
+- `analysis.use_cases`
+- `analysis.topic_candidates`
+- `analysis.claims`
+- `analysis.outline`
+- `wiki_entry.title`
+- `wiki_entry.sections`
+- `wiki_entry.markdown`
 
-## 最小 Payload
+## Minimal Payload
 
 ```json
 {
@@ -84,10 +76,81 @@ If `fetch_status` is `failed`, say that AIWiki recorded the failure reason but d
     "fetch_status": "ok",
     "captured_at": "2026-05-07T10:00:00+08:00"
   },
+  "analysis": {
+    "summary": "One-sentence summary.",
+    "key_points": ["Key point 1", "Key point 2"],
+    "related_concepts": ["Concept A"]
+  },
   "request": {
     "mode": "ingest",
-    "outputs": ["source_card", "creative_assets", "topics", "draft_outline", "processing_summary"],
+    "outputs": ["source_card", "wiki_entry", "creative_assets", "topics", "draft_outline", "processing_summary"],
     "language": "zh-CN"
   }
 }
 ```
+
+## User Reply
+
+After the CLI runs, read the command output and report these fields:
+
+- `ingested`
+- `recorded`
+- `fetch_status`
+- `fit_score` and `fit_level`
+- `summary`
+- `wiki_entry`
+- `wiki_entry_generation_mode`
+- `wiki_entry_quality`
+- `source_card`
+- `processing_summary`
+- `run_dir`
+
+Recommended success reply:
+
+```text
+AIWiki 已完成入库，并生成 Wiki 条目。
+质量模式：<wiki_entry_quality> / <wiki_entry_generation_mode>
+摘要：<summary>
+Wiki 条目：<wiki_entry>
+资料卡：<source_card>
+处理记录：<processing_summary>
+```
+
+If `wiki_entry_quality` is `scaffold`, say clearly that this Wiki Entry is a traceable fallback and still needs Agent enrichment for high-quality knowledge extraction.
+
+If `fetch_status` is `failed`, say that AIWiki recorded the failure reason but did not ingest readable content.
+
+## Query Protocol
+
+When the user asks to understand a topic from AIWiki, call:
+
+```bash
+aiwiki context "<topic>"
+```
+
+Use the returned JSON to answer. Prefer Wiki Entries first. Do not scan `02-raw` by default unless the Wiki result is insufficient, the user asks to verify the original text, or sources conflict.
+
+## Lint Protocol
+
+When the user asks to整理 / 检查 / lint the knowledge base, call:
+
+```bash
+aiwiki lint
+```
+
+Explain warnings and errors as structure-health feedback. Do not frame lint as a requirement that the user manually review every item.
+
+## Obsidian + Dataview Boundary
+
+- AIWiki can be used with plain Markdown.
+- Obsidian is a useful viewing surface, not a hard dependency.
+- Dataview is optional and only enhances generated dashboards.
+- Do not install Dataview for the user.
+- Do not edit `.obsidian`, `community-plugins.json`, or Obsidian plugin configuration.
+
+## Prohibited
+
+- Do not ask the user to save payload files.
+- Do not ask the user to type `--path` every time.
+- Do not claim AIWiki CLI fetches webpages.
+- Do not claim AIWiki CLI automatically creates high-quality summaries without Agent-provided analysis.