@itradingai/aiwiki 0.2.10 → 0.2.12

package/README.md

@@ -1,201 +1,249 @@
-![AIWiki 宣传图](https://raw.githubusercontent.com/iTradingAI/aiwiki/refs/heads/main/docs/assets/aiwiki-hero.png)
+![AIWiki 宣传图](https://raw.githubusercontent.com/iTradingAI/aiwiki/main/docs/assets/aiwiki-hero.png)
 
 # AIWiki
 
-AIWiki 是一个开源的 Agent-first AI 知识库 CLI。你把文章链接、网页正文或本地文本交给宿主 Agent，宿主 Agent 负责读取内容，AIWiki 负责把结果稳定写进本地知识库，并生成适合 Obsidian 审阅的资料卡、主题、大纲和处理记录。
+AIWiki 是一个开源的 Agent-first 本地 LLM-wiki CLI。
 
-对外只有一个 AIWiki，公开页面不做软件分层。商业服务放在部署、陪跑和团队集成里，不放在软件版本层。
+你把文章链接、网页正文或本地文本交给宿主 Agent；宿主 Agent 负责读取和理解内容；AIWiki 负责把结果稳定写进本地 Markdown 知识库，并生成可追踪、可查询、可持续整理的 Wiki 条目。
+
+一句话说：AIWiki 不是网页抓取器，而是宿主 Agent 的本地 LLM-wiki 后端。
 
 ## 它解决什么
 
-- 收藏了很多链接，但最后都散在聊天记录里
-- 想用 AI 总结内容，却很难继续写作或复用
-- 想做选题、资料卡和大纲，但每次都得重新整理
-- 想让 Agent 帮忙收资料，但缺一个稳定的本地入库出口
+- 链接和资料散在聊天记录里，后续很难复用。
+- AI 总结过一次内容，但没有沉淀成可查询的知识条目。
+- 想把资料卡、选题、大纲、Wiki 条目放进同一个本地知识库。
+- 想让 Agent 负责理解内容，让 CLI 负责稳定落盘和追踪。
+
+## 工作流
+
+### Ingest：把资料写入本地 Wiki
+
+```text
+用户给 URL / 正文 / 文件
+  -> 宿主 Agent 读取内容并尽量生成 analysis / wiki_entry
+  -> aiwiki ingest-agent --stdin
+  -> AIWiki 写入 Raw / Source Card / Wiki Entry / Claim / Topic / Outline / Run Log
+```
+
+### Query：从 Wiki 调度知识
+
+```bash
+aiwiki context "AI Agent 出海机会"
+aiwiki query "AI Agent 出海机会"
+```
+
+`context` 返回 JSON，主要给宿主 Agent 用；`query` 使用同一套检索结果，输出给人看的摘要。第一版是本地关键词检索，不是向量检索。
+
+### Lint：检查知识库结构
 
-## 它会生成什么
+```bash
+aiwiki lint
+```
 
-- 原文记录
-- Source Card 资料卡
-- Claim 建议
-- 创意素材
-- 选题候选
-- 草稿大纲
-- 处理摘要
-- Obsidian 审阅入口
+`lint` 会检查缺失链接、重复来源、fallback Wiki 条目、enriched 条目缺字段等问题，并写入 `dashboards/Lint Report.md`。
 
-## 直接发给 AI 帮你安装
+## 快速开始
 
-如果你希望让 Codex、Claude Code、QClaw、OpenClaw 等 AI 直接帮你完成安装和配置，可以把下面这段话原样发给它，记得改成你自己的知识库路径：
+### 第一步：安装 AIWiki CLI
+
+让 AI 帮你安装时，可以把下面这段交给当前 Agent，改成自己的知识库路径：
 
 ```text
 请帮我安装并配置 AIWiki。
 安装命令：npm install -g @itradingai/aiwiki@latest
 我的知识库路径：F:\knowledges
 
-要求：
-1. 先检查本机 Node.js 是否满足 >=20。
-2. 如果还没安装 AIWiki，就安装最新版 `@itradingai/aiwiki`。
-3. 执行 `aiwiki setup --path "我的知识库路径" --yes`，帮我完成知识库初始化。
-4. 执行 `aiwiki agent list` 检查当前环境支持哪些宿主 Agent。
-5. 优先为当前 AI/Agent 安装 AIWiki 对接；如果能自动安装，就执行 `aiwiki agent install` 或对应的 `--agent` 命令。
-6. 如果当前 Agent 不支持自动安装，就执行 `aiwiki prompt agent`，然后把生成的对接协议整理好，告诉我应该粘贴到哪里。
-7. 完成后，再执行 `aiwiki doctor` 和 `aiwiki status`，确认安装和配置是否正常。
-8. 最后告诉我：
-   - 实际执行了哪些命令
-   - 知识库路径是什么
-   - Agent 对接是否完成
-   - 如果还差手动步骤，明确告诉我下一步怎么做
+请检查 Node.js >=20，执行 aiwiki setup --path "我的知识库路径" --yes，
+然后运行 aiwiki agent list / aiwiki agent install 完成宿主 Agent 对接。
+最后执行 aiwiki doctor 和 aiwiki status，告诉我实际执行了哪些命令和还差什么手动步骤。
 ```
 
-## 手动安装
+手动安装：
 
 ```bash
 npx @itradingai/aiwiki@latest setup
 aiwiki agent list
 aiwiki agent install
-aiwiki prompt agent
 ```
 
-然后把 `入库 <url>` 发给宿主 Agent。
-
-## 让宿主 Agent 直接安装 AIWiki
-
-初始化知识库后，先扫一遍本机支持的宿主 Agent：
+### 第二步：接入宿主 Agent
 
 ```bash
 aiwiki agent list
+aiwiki agent install
+aiwiki agent check
 ```
 
-再启动安装向导：
+也可以直接输出通用协议：
 
 ```bash
-aiwiki agent install
+aiwiki prompt agent
 ```
 
-也可以直接指定目标：
+### 第三步：第一次入库
 
-```bash
-aiwiki agent install --agent codex --yes
-aiwiki agent install --agent qclaw --yes
-aiwiki agent install --agent openclaw --yes
-aiwiki agent install --agent claude --yes
+对宿主 Agent 发送：
+
+```text
+入库 https://example.com/article
 ```
 
-如果当前宿主 Agent 暂不支持自动安装，可以输出通用对接协议：
+宿主 Agent 读取正文后调用 `aiwiki ingest-agent --stdin`。用户不需要手动保存 payload，也不需要每次输入 `--path`。
+
+### 第四步：从知识库提问
+
+对宿主 Agent 说：
+
+```text
+从 AIWiki 里帮我了解 xxx
+```
+
+宿主 Agent 应优先调用：
 
 ```bash
-aiwiki prompt agent
+aiwiki context "xxx"
 ```
 
-把输出内容安装成宿主 Agent 的 skill，或者粘贴到宿主 Agent 的项目说明里。
+人直接查询时可以运行：
+
+```bash
+aiwiki query "xxx"
+```
 
-## 日常入库
+## AIWiki 会生成什么
 
-完成 setup 和 Agent 安装后，对宿主 Agent 发送：
+成功入库会生成：
 
 ```text
-入库 https://mp.weixin.qq.com/s/5i9UJdBOhCB2a1EVp0lVXQ
+02-raw/articles/
+03-sources/article-cards/
+04-claims/_suggestions/
+05-wiki/source-knowledge/
+06-assets/_suggestions/
+07-topics/ready/
+08-outputs/outlines/
+09-runs/<run-id>/
 ```
 
-宿主 Agent 读取网页后，通过 `aiwiki ingest-agent --stdin` 把结构化内容交给 AIWiki CLI。用户不需要手动保存 payload，也不需要每次输入 `--path`。
+其中 `05-wiki/source-knowledge/<slug>.md` 是默认 Wiki Entry。
 
-典型流程：
+### Agent-Enriched Wiki Entry
 
-```text
-用户发送链接 -> 宿主 Agent 读取内容 -> Agent 调用 AIWiki -> AIWiki 写入本地知识库 -> Obsidian 审阅和沉淀
+如果宿主 Agent 在 payload 中提供了 `analysis` 或 `wiki_entry`，AIWiki 会把这些总结、核心观点、知识点、概念、选题等内容写入 Wiki Entry。
+
+frontmatter 会标记：
+
+```yaml
+generation_mode: "agent_enriched"
+quality: "enriched"
+generated_by: "host_agent"
+llm_enriched: true
+source_role: "input"
+represents_user_view: false
+```
+
+### Deterministic Fallback Wiki Entry
+
+如果宿主 Agent 只提供原文，AIWiki 仍会创建 Wiki Entry，但它只是可追溯脚手架，包含标题、来源、正文预览、反链和待补全区。
+
+frontmatter 会标记：
+
+```yaml
+generation_mode: "deterministic_fallback"
+quality: "scaffold"
+generated_by: "aiwiki_cli"
+llm_enriched: false
+source_role: "input"
+represents_user_view: false
 ```
 
+AIWiki CLI 本身不调用 LLM，所以不会在没有 Agent 分析字段时承诺高质量提炼。
+
 ## 设计边界
 
-AIWiki 不是通用网页抓取器。网页读取主要交给宿主 Agent，AIWiki 专注于把 Agent 已经读到的内容写成稳定、可追踪、可复用的本地知识资产。
+AIWiki 做：
 
-AIWiki 生成的 Markdown 和 frontmatter 默认面向 Obsidian + Dataview 审阅；如果你不装 Dataview，普通 Markdown、Properties、Backlinks、Search 和 Graph View 也能用。
+- 接收宿主 Agent payload。
+- 写入本地 Markdown。
+- 生成 frontmatter、wikilink、处理记录。
+- 生成 Wiki Entry 容器。
+- 支持 `context`、`query`、`next` 和 `lint`。
 
-当前范围：
+AIWiki 不做：
 
-- 只写入当前配置的知识库
-- 单次处理一条输入
-- 宿主 Agent 读取网页、附件或正文
-- CLI 写入本地文件和 Obsidian 友好的结构
-- 生成资料卡、素材建议、主题候选、草稿大纲、处理摘要
+- 通用网页抓取。
+- 微信公众号读取。
+- 伪造浏览器头。
+- 浏览器插件。
+- CLI 内置 LLM。
+- 自动高质量总结。
+- 默认人工审核流程。
+- 企业级 RBAC。
+- 多知识库。
+- 批量采集 / 定时采集 / RSS。
 
-当前不包含：
+## Obsidian / Dataview
 
-- CLI 内置通用网页抓取
-- 跨主题自动路由
-- 批处理
-- 定时或指定采集
-- 长流程状态机
-- 技术支持流程
+AIWiki 生成的是标准 Markdown 和 frontmatter，不强依赖 Obsidian。
 
-## 示例展示
+Obsidian 是推荐查看界面；Dataview 只是可选 dashboard 增强。AIWiki 不会自动安装 Dataview，也不会修改 `.obsidian`。
 
-想先看一次完整跑完会生成什么，可以看：
+Review Queue 可以保留为回看入口，但不是 AIWiki 的主流程。
 
-- [docs/SHOWCASE.md](docs/SHOWCASE.md)
+## 常见问题
+
+### AIWiki 会自己抓网页吗？
+
+不会。网页读取由宿主 Agent 完成，AIWiki 负责把 Agent 已经读到的内容写入本地知识库。
+
+### 为什么会生成 05-wiki？
+
+因为 AIWiki 的目标不是只保存资料，而是让资料进入可查询、可维护的 Wiki 知识层。
+
+### 05-wiki 是否代表我的观点？
+
+不一定。外部资料生成的 Wiki 条目默认代表“外部资料的结构化整理”，不代表你的个人观点。
+
+### 什么内容才代表我的观点？
+
+`source_role=output` 用于标记用户已发布文章、演讲稿、公众号文章等个人输出，并可配合 `represents_user_view: true`。外部资料默认是 `source_role: input`、`represents_user_view: false`。
+
+### Dataview 必须安装吗？
+
+不必须。没有 Dataview，也可以用普通 Markdown、Properties、Backlinks、Search 和 Graph View。
+
+### Review Queue 还需要吗？
+
+不是必需流程。它只适合低置信度、来源缺失、内容冲突、个人观点把关等回看场景。
 
 ## 文档
 
 - [docs/USAGE.md](docs/USAGE.md)
 - [docs/AGENT_HANDOFF.md](docs/AGENT_HANDOFF.md)
-- [docs/OBSIDIAN_DATAVIEW_PLAN.md](docs/OBSIDIAN_DATAVIEW_PLAN.md)
 - [docs/FAQ.md](docs/FAQ.md)
+- [docs/SHOWCASE.md](docs/SHOWCASE.md)
 - [docs/ROADMAP.md](docs/ROADMAP.md)
 - [docs/RELEASE.md](docs/RELEASE.md)
 - [CONTRIBUTING.md](CONTRIBUTING.md)
 - [SECURITY.md](SECURITY.md)
-- [docs/architecture.svg](docs/architecture.svg)
-
-## 参与与反馈
-
-如果你想提 bug、提需求，或者反馈宿主 Agent 对接问题，直接看：
-
-- [CONTRIBUTING.md](CONTRIBUTING.md)
-- [.github/ISSUE_TEMPLATE/bug_report.md](.github/ISSUE_TEMPLATE/bug_report.md)
-- [.github/ISSUE_TEMPLATE/feature_request.md](.github/ISSUE_TEMPLATE/feature_request.md)
-- [.github/ISSUE_TEMPLATE/agent_integration.md](.github/ISSUE_TEMPLATE/agent_integration.md)
-
-## 联系与交流
-
-项目专题介绍：[maxking.cc](https://maxking.cc/aiwiki)
-
-<table>
-  <tr>
-    <td align="center" width="50%">
-      <img src="https://raw.githubusercontent.com/iTradingAI/aiwiki/refs/heads/main/docs/assets/join-group.png" alt="扫码进群交流" width="360">
-      <br>
-      <strong>扫码进群</strong>
-    </td>
-    <td align="center" width="50%">
-      <img src="https://raw.githubusercontent.com/iTradingAI/aiwiki/refs/heads/main/docs/assets/wechat-official-account.png" alt="扫码关注公众号" width="360">
-      <br>
-      <strong>关注公众号</strong>
-    </td>
-  </tr>
-</table>
 
 ## 本地开发
 
 ```bash
 npm install
 npm run build
+npm test
 npm link
 aiwiki setup --path "F:\knowledge_data\aiwiki-test" --yes
-aiwiki prompt agent
 aiwiki doctor
+aiwiki ingest-agent --payload tests/fixtures/agent_payload.url.valid.json --path "F:\knowledge_data\aiwiki-test"
+aiwiki context "AI Agent" --path "F:\knowledge_data\aiwiki-test"
+aiwiki query "AI Agent" --path "F:\knowledge_data\aiwiki-test"
+aiwiki next --path "F:\knowledge_data\aiwiki-test"
+aiwiki lint --path "F:\knowledge_data\aiwiki-test"
 ```
 
-## 最新动态
-
-- `2026-05-13`：更新了本地 Markdown 导入的命名规则，明确优先使用文件标题或文件名生成外部文件名，不优先从正文反推标题，并调整了 README 中的入口顺序和手动安装说明。
-- `2026-05-12`：公开前口径收口，统一 README、npm 元数据和公开文档入口。
-- `2026-05-09`：完成 npm 公开发布准备，补齐发布前的 README 与交付信息，并让 CLI 版本号与 `package.json` / 发布包保持一致，便于安装、排查与版本确认。
-- `2026-05-08`：完成中文化体验收口，包括默认生成中文 prompt、中文状态输出、中文目标描述，以及 README 和使用文档的中文本地化。
-- `2026-05-08`：强化 Obsidian 工作流，把 Review Queue、Claims Review 等审阅队列提升为一等入口，方便在知识库里持续审阅和回看入库内容。
-- `2026-05-07`：新增 Codex skill 安装能力，并补上 Agent 协议安装引导，让宿主 Agent 在正式入库前更容易完成对接。
-- `2026-05-07`：持续打磨初始化体验，修复 setup 提示问题，避免静默套用默认值，并把首次使用流程改成交互式引导。
-
 ## License
 
 MIT. See [LICENSE](LICENSE).

package/dist/src/app.js

@@ -4,7 +4,9 @@ import path from "node:path";
 import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 import { flagBool, flagString, parseArgs } from "./args.js";
+import { buildContext } from "./context.js";
 import { deriveFileTitle, ingestFile, ingestPayload } from "./ingest.js";
+import { lintWorkspace, renderLintReport, writeLintReport } from "./lint.js";
 import { CliError, writeLine } from "./output.js";
 import { confirmInit, directorySummary, doctor, exists, initWorkspace, promptForSetup, promptForInitPath, readConfig, resolveWorkspace, setDefaultWorkspace, statusSummary } from "./workspace.js";
 export async function runCli(argv, streams = { stdout: process.stdout, stderr: process.stderr }) {
@@ -52,6 +54,10 @@ export async function runCli(argv, streams = { stdout: process.stdout, stderr: p
             }
             return 0;
         }
+        if (command === "agent" && subcommand === "check") {
+            await printAgentCheck(streams.stdout, await discoverAgentTargets());
+            return 0;
+        }
         if (command === "agent" && (subcommand === "list" || !subcommand)) {
             printAgentList(streams.stdout, await discoverAgentTargets());
             return 0;
@@ -122,6 +128,41 @@ export async function runCli(argv, streams = { stdout: process.stdout, stderr: p
             writeLine(streams.stdout, `处理次数: ${summary.runCount}`);
             writeLine(streams.stdout, `失败次数: ${summary.failedCount}`);
             writeLine(streams.stdout, `最近处理: ${summary.lastRunId ?? "无"}`);
+            await printStatusDetails(streams.stdout, root, summary.runCount);
+            return 0;
+        }
+        if (command === "context") {
+            const root = await resolveWorkspace(flagString(args, "path"));
+            const query = args.positional.slice(1).join(" ").trim();
+            if (!query) {
+                throw new CliError("请提供查询主题。");
+            }
+            writeLine(streams.stdout, JSON.stringify(await buildContext(root, query), null, 2));
+            return 0;
+        }
+        if (command === "query") {
+            const root = await resolveWorkspace(flagString(args, "path"));
+            const query = args.positional.slice(1).join(" ").trim();
+            if (!query) {
+                throw new CliError("请提供查询主题。");
+            }
+            writeLine(streams.stdout, renderQuery(await buildContext(root, query)));
+            return 0;
+        }
+        if (command === "next") {
+            const root = await resolveWorkspace(flagString(args, "path"));
+            const summary = await statusSummary(root);
+            const checks = await doctor(root);
+            const report = summary.runCount > 0 ? await lintWorkspace(root) : undefined;
+            await printNext(streams.stdout, root, summary.runCount, checks, await discoverAgentTargets(), report);
+            return 0;
+        }
+        if (command === "lint") {
+            const root = await resolveWorkspace(flagString(args, "path"));
+            const report = await lintWorkspace(root);
+            const reportPath = await writeLintReport(root, report);
+            writeLine(streams.stdout, renderLintReport(report));
+            writeLine(streams.stdout, `report: ${reportPath}`);
             return 0;
         }
         if (command === "ingest-agent") {
@@ -203,12 +244,17 @@ function printHelp(stream) {
     writeLine(stream, "  aiwiki prompt agent");
     writeLine(stream, "  aiwiki doctor");
     writeLine(stream, "  aiwiki status");
+    writeLine(stream, "  aiwiki context <query>");
+    writeLine(stream, "  aiwiki query <query>");
+    writeLine(stream, "  aiwiki next");
+    writeLine(stream, "  aiwiki lint");
     writeLine(stream, "  aiwiki ingest-agent --stdin");
     writeLine(stream, "  aiwiki ingest-file --file <file>");
     writeLine(stream, "  aiwiki init --path <path> --yes --set-default");
     writeLine(stream, "  aiwiki config show");
     writeLine(stream, "  aiwiki ingest-agent --payload <file>");
     writeLine(stream, "  aiwiki ingest-url <url> --content-file <file>");
+    writeLine(stream, "  aiwiki agent check");
 }
 async function discoverAgentTargets() {
     const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
@@ -288,6 +334,19 @@ function printAgentList(stream, targets) {
         }
     }
 }
+async function printAgentCheck(stream, targets) {
+    writeLine(stream, "AIWiki Agent 接入检查");
+    for (const target of targets) {
+        const installed = target.target ? await exists(target.target) : false;
+        writeLine(stream, `${target.id}: ${target.name} | detected=${target.detected ? "yes" : "no"} | installed=${installed ? "yes" : "no"} | installable=${target.installable ? "yes" : "no"}`);
+        if (target.detected && target.installable && !installed) {
+            writeLine(stream, `  建议: aiwiki agent install --agent ${target.id} --yes`);
+        }
+        else if (target.detected && !target.installable) {
+            writeLine(stream, "  建议: aiwiki prompt agent");
+        }
+    }
+}
 async function installAgentSkill(options) {
     const targets = await discoverAgentTargets();
     const installable = targets.filter((target) => target.detected && target.installable);
@@ -360,10 +419,134 @@ function printAgentPrompt(stream) {
     writeLine(stream, "");
     writeLine(stream, "如果当前会话被用户明确设定为 AIWiki 入库助手，则用户只发送 URL 也默认触发入库。普通会话中不要把所有 URL 都自动入库。");
     writeLine(stream, "");
-    writeLine(stream, "流程：读取网页正文；生成 aiwiki.agent_payload.v1；通过 stdin 调用 `aiwiki ingest-agent --stdin`；读取 CLI 输出；只向用户汇报 ingested、recorded、fit_score、fit_level、summary、run_dir、processing_summary、source_card、dashboard、review_queue。");
-    writeLine(stream, "回复措辞：成功时说“已加入 Obsidian 审阅队列”，并给出资料卡、处理记录、Obsidian 入口和待审队列。Dataview 是可选增强，不要替用户安装插件或修改 .obsidian。");
+    writeLine(stream, "流程：读取网页正文；尽量生成 analysis/wiki_entry；生成 aiwiki.agent_payload.v1；通过 stdin 调用 `aiwiki ingest-agent --stdin`；读取 CLI 输出；向用户汇报 ingested、summary、wiki_entry、wiki_entry_quality、source_card、processing_summary。");
+    writeLine(stream, "回复措辞：成功时说“AIWiki 已完成入库，并生成 Wiki 条目。” 如果 wiki_entry_quality=scaffold，说明该条目只是可追溯脚手架，仍需宿主 Agent 后续补全。Dataview 是可选增强，不要替用户安装插件或修改 .obsidian。");
+    writeLine(stream, "");
+    writeLine(stream, "查询：当用户要求从 AIWiki 里了解某个主题时，调用 `aiwiki context <主题>`。");
+    writeLine(stream, "整理：当用户要求检查或整理知识库时，调用 `aiwiki lint`。");
+    writeLine(stream, "");
+    writeLine(stream, "禁止：让用户保存 payload；让用户每次输入 --path；声称 AIWiki CLI 负责网页抓取；声称 AIWiki CLI 会在没有 Agent 分析字段时自动高质量总结。");
+}
+async function printStatusDetails(stream, root, runCount) {
+    const counts = await contentCounts(root);
+    const lintPath = path.join(root, "dashboards", "Lint Report.md");
+    writeLine(stream, "");
+    writeLine(stream, "内容统计:");
+    writeLine(stream, `Wiki 条目: ${counts.wikiEntries}`);
+    writeLine(stream, `资料卡: ${counts.sourceCards}`);
+    writeLine(stream, `原文: ${counts.rawFiles}`);
+    writeLine(stream, `选题: ${counts.topics}`);
+    writeLine(stream, `大纲: ${counts.outlines}`);
+    writeLine(stream, `最近 lint: ${await exists(lintPath) ? await relativeMtime(root, lintPath) : "无"}`);
     writeLine(stream, "");
-    writeLine(stream, "禁止：让用户保存 payload；让用户每次输入 --path；声称 AIWiki CLI 负责网页抓取。");
+    writeLine(stream, "下一步建议:");
+    writeLine(stream, runCount === 0 ? "运行 `aiwiki agent install` 接入宿主 Agent，然后发送 `入库 <url>`。" : "运行 `aiwiki query <主题>` 查询知识，或运行 `aiwiki lint` 检查结构。");
+}
+async function printNext(stream, root, runCount, checks, targets, report) {
+    const missing = checks.filter((check) => check.status !== "ok");
+    const installableMissing = [];
+    for (const target of targets) {
+        if (target.detected && target.installable && target.target && !(await exists(target.target))) {
+            installableMissing.push(target);
+        }
+    }
+    writeLine(stream, "AIWiki 下一步建议");
+    writeLine(stream, `知识库路径: ${root}`);
+    if (missing.length) {
+        writeLine(stream, "");
+        writeLine(stream, "先修复知识库结构:");
+        writeLine(stream, `- aiwiki setup --path "${root}" --yes`);
+        return;
+    }
+    if (runCount === 0) {
+        writeLine(stream, "");
+        writeLine(stream, "还没有入库记录。");
+        writeLine(stream, "- aiwiki agent install");
+        writeLine(stream, "- 然后向宿主 Agent 发送 `入库 <url>`");
+        writeLine(stream, "- CLI 不抓网页；网页正文由宿主 Agent 提供。");
+        return;
+    }
+    const actionableIssues = report?.issues.filter((issue) => issue.severity !== "info") ?? [];
+    if (actionableIssues.length) {
+        writeLine(stream, "");
+        writeLine(stream, `结构检查发现 ${actionableIssues.length} 个需要处理的问题。`);
+        writeLine(stream, "- aiwiki lint");
+        writeLine(stream, `- 查看报告: dashboards/Lint Report.md`);
+        writeLine(stream, "- 先处理 error / warning，再继续扩展查询或入库。");
+        return;
+    }
+    writeLine(stream, "");
+    writeLine(stream, "已有入库记录，可以继续：");
+    writeLine(stream, "- aiwiki query <主题>");
+    writeLine(stream, "- aiwiki lint");
+    if (installableMissing.length) {
+        writeLine(stream, "");
+        writeLine(stream, "可补充宿主 Agent 接入:");
+        for (const target of installableMissing) {
+            writeLine(stream, `- aiwiki agent install --agent ${target.id} --yes`);
+        }
+    }
+}
+function renderQuery(context) {
+    const lines = [`AIWiki 查询: ${context.query}`, ""];
+    appendQueryGroup(lines, "Wiki 条目", context.matches.wiki_entries);
+    appendQueryGroup(lines, "资料卡", context.matches.source_cards);
+    appendQueryGroup(lines, "选题", context.matches.topics);
+    appendQueryGroup(lines, "Claim 建议", context.matches.claims);
+    appendQueryGroup(lines, "大纲", context.matches.outlines);
+    appendQueryGroup(lines, "原文引用", context.matches.raw_refs);
+    if (context.warnings.length) {
+        lines.push("提示:", ...context.warnings.map((warning) => `- ${warning}`), "");
+    }
+    lines.push("Agent JSON:", `- aiwiki context "${context.query}"`);
+    return `${lines.join("\n")}\n`;
+}
+function appendQueryGroup(lines, label, items) {
+    lines.push(`${label}:`);
+    if (!items.length) {
+        lines.push("- 无", "");
+        return;
+    }
+    for (const item of items.slice(0, 5)) {
+        lines.push(`- ${item.title} (${item.path})`);
+        if (item.summary) {
+            lines.push(`  ${item.summary}`);
+        }
+        if (item.warnings.length) {
+            lines.push(`  提示: ${item.warnings.join("；")}`);
+        }
+    }
+    lines.push("");
+}
+async function contentCounts(root) {
+    return {
+        wikiEntries: await countMarkdownFiles(path.join(root, "05-wiki")),
+        sourceCards: await countMarkdownFiles(path.join(root, "03-sources", "article-cards")),
+        rawFiles: await countMarkdownFiles(path.join(root, "02-raw", "articles")),
+        topics: await countMarkdownFiles(path.join(root, "07-topics", "ready")),
+        outlines: await countMarkdownFiles(path.join(root, "08-outputs", "outlines"))
+    };
+}
+async function countMarkdownFiles(dir) {
+    if (!(await exists(dir))) {
+        return 0;
+    }
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    let count = 0;
+    for (const entry of entries) {
+        const target = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            count += await countMarkdownFiles(target);
+        }
+        else if (entry.isFile() && entry.name.toLowerCase().endsWith(".md")) {
+            count += 1;
+        }
+    }
+    return count;
+}
+async function relativeMtime(root, target) {
+    const stats = await fs.stat(target);
+    return `${path.relative(root, target).replace(/\\/g, "/")} (${stats.mtime.toISOString()})`;
 }
 function doctorStatusText(status) {
     if (status === "ok") {
@@ -389,6 +572,20 @@ function printIngestResult(stream, result) {
     writeLine(stream, `run_dir: ${result.runDir}`);
     writeLine(stream, `files: ${result.generatedFiles.length}`);
     writeLine(stream, `processing_summary: ${result.agentReport.keyFiles.processingSummary}`);
+    if (result.agentReport.keyFiles.wikiEntry) {
+        writeLine(stream, `wiki_entry: ${result.agentReport.keyFiles.wikiEntry}`);
+    }
+    if (result.agentReport.wikiEntryGenerationMode) {
+        writeLine(stream, `wiki_entry_generation_mode: ${result.agentReport.wikiEntryGenerationMode}`);
+    }
+    if (result.agentReport.wikiEntryQuality) {
+        writeLine(stream, `wiki_entry_quality: ${result.agentReport.wikiEntryQuality}`);
+    }
+    writeLine(stream, `grounding_evidence_available: ${result.agentReport.grounding.evidence_available ? "yes" : "no"}`);
+    writeLine(stream, `grounding_evidence_channel: ${result.agentReport.grounding.evidence_channel}`);
+    writeLine(stream, `grounding_needs_review: ${result.agentReport.grounding.needs_review ? "yes" : "no"}`);
+    writeLine(stream, `grounding_markers: ${result.agentReport.grounding.suspicion_markers.length ? result.agentReport.grounding.suspicion_markers.join(",") : "none"}`);
+    writeLine(stream, `grounding_claims_with_quotes: ${result.agentReport.grounding.claim_quote_count}/${result.agentReport.grounding.claim_count}`);
     if (result.agentReport.keyFiles.sourceCard) {
         writeLine(stream, `source_card: ${result.agentReport.keyFiles.sourceCard}`);
     }