@puyinkai/xiaobao-cli 0.1.10 → 0.2.1

package/README.md

@@ -1,9 +1,12 @@
 # @puyinkai/xiaobao-cli
 
 旺小宝 CLI —— [openclaw-xiaobao](https://github.com/puyinkai/openclaw-xiaobao)
-plugin 的 host-agnostic 等价物。14 个能力 1:1 映射为 14 个 CLI 子命令，**人类
-直接敲也好用，AI agent（Claude Code / Codex / Cursor / OpenClaw / 任何能 shell
-out 的 host）通过 stdout JSON 消费**。
+plugin 的 host-agnostic 等价物。业务数据 / 问数 / 来访总结 / 知识库 等能力映射为
+CLI 子命令，**人类直接敲也好用，AI agent（Claude Code / Codex / Cursor / OpenClaw /
+任何能 shell out 的 host）通过 stdout JSON 消费**。
+
+> 后端链路：CLI 调 `ai-open`（公网开放层 / OAuth 鉴权），ai-open 作为薄代理转发到内网
+> 业务层 `wang-ai-mcp`。命令用法对调用方透明。
 
 参考 [larksuite/cli](https://github.com/larksuite/cli) 范式，跟 OpenClaw plugin
 解耦：plugin 这条线（`@puyinkai/openclaw-xiaobao`）保持现状，本 CLI 走 npm，
@@ -30,7 +33,7 @@ xiaobao-cli audio list --from "2026-05-01 00:00:00" --to "2026-05-02 00:00:00" -
 > openclaw-xiaobao 老用户：CLI 默认从 `~/.openclaw/state/wangxiaobao/` fallback
 > 读 token + active-project，**零迁移开箱即用**。新写操作落到 `~/.xiaobao/`。
 
-## 14 个能力
+## 能力一览
 
 | 命令 | 对应 openclaw-xiaobao tool |
 | --- | --- |
@@ -46,12 +49,17 @@ xiaobao-cli audio list --from "2026-05-01 00:00:00" --to "2026-05-02 00:00:00" -
 | `visit list [--customer-id] [--from] [--to]` | `xiaobao_list_visits` |
 | `focus list [--visit-ids] [--category] ...` | `xiaobao_list_customer_focus` |
 | `resistance list [...]` | `xiaobao_list_customer_resistance` |
-| `qa <prompt> [--thread-id <id>]` | `xiaobao_quick_qa` |
+| `qa <prompt> [--thread-id <id>]` | `xiaobao_quick_qa`（底层已切 sql-agent） |
+| `visit summary [--customer-id] [--visit-id] [--template] [--from] [--to]` | 新增 · 来访接待总结 |
+| `kb search <query> [--k]` | 新增 · 知识库语义检索 |
+| `kb docs [--title]` | 新增 · 知识库文档列表 |
+| `kb doc <doc-id>` | 新增 · 知识库文档详情 |
+| `kb doc-content <doc-id> [--offset] [--limit]` | 新增 · 知识库文档正文分页 |
 | `api <METHOD> <path>` | `xiaobao_api` |
 
 ## 通用 flags
 
-- `--format json|toon|table` —— 默认 `json`（agent 友好）；`table` 人类友好；`toon` 给 LLM 上下文用
+- `--format toon|json|table` —— 默认 `toon`（省 token，适合 LLM 上下文）；`json` 严格 JSON、agent/人类友好；`table` 暂未实现（回退 JSON）
 - `--api-base <url>` / `--auth-base <url>` —— 覆盖默认（也可 env `XIAOBAO_API_BASE` / `XIAOBAO_AUTH_BASE`）
 
 ## 输出协议
@@ -73,8 +81,10 @@ xiaobao-cli audio list --from "2026-05-01 00:00:00" --to "2026-05-02 00:00:00" -
 
 ## skill 配套
 
-`skills/` 目录下 8 个 SKILL.md 跟 cli 同包发布，跟 openclaw-xiaobao 那边镜像，
-只是调用从 plugin tool invoke 改为 shell out `xiaobao-cli ...`。
+`skills/` 目录下的 SKILL.md 跟 cli 同包发布，跟 openclaw-xiaobao 那边镜像，
+只是调用从 plugin tool invoke 改为 shell out `xiaobao-cli ...`。本次新增
+`wangxiaobao-visit-summary-query`（来访接待总结）与 `wangxiaobao-knowledge-base`（知识库）
+两个 skill；`wangxiaobao-quick-qa` 的问数底层由 fast-responder 切换为 sql-agent。
 
 ## License
 

package/dist/{api-fsHHWWa3.mjs → api-DtFEKH3I.mjs}

@@ -2,7 +2,7 @@ import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
 import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { t as loadActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/api.ts
 /**
@@ -69,7 +69,7 @@ var api_default = defineCommand({
 		"auth-base": { type: "string" },
 		format: {
 			type: "string",
-			default: "json"
+			default: "toon"
 		}
 	},
 	async run({ args }) {

package/dist/{audio-CRSMqaKo.mjs → audio-DhEiStuy.mjs}

@@ -6,8 +6,8 @@ var audio_default = defineCommand({
 		description: "录音元数据分页 / 单条文本查询"
 	},
 	subCommands: {
-		list: () => import("./list-CnlQdzPp.mjs").then((m) => m.default),
-		text: () => import("./text-C3Ap6L5n.mjs").then((m) => m.default)
+		list: () => import("./list-CZVU6EVq.mjs").then((m) => m.default),
+		text: () => import("./text-bgoI1KC-.mjs").then((m) => m.default)
 	}
 });
 //#endregion

package/dist/{auth-B4Yeoxae.mjs → auth-BYWDBat3.mjs}

@@ -6,9 +6,9 @@ var auth_default = defineCommand({
 		description: "OAuth 登录 / 身份查询 / 登出（device flow）"
 	},
 	subCommands: {
-		login: () => import("./login-EtQi30zd.mjs").then((m) => m.default),
-		whoami: () => import("./whoami-z-76WaCP.mjs").then((m) => m.default),
-		logout: () => import("./logout-DP7REhCd.mjs").then((m) => m.default)
+		login: () => import("./login-B5e9tJbS.mjs").then((m) => m.default),
+		whoami: () => import("./whoami-BMAFa4es.mjs").then((m) => m.default),
+		logout: () => import("./logout-Dz_FFIRP.mjs").then((m) => m.default)
 	}
 });
 //#endregion

package/dist/cli.mjs

@@ -7,27 +7,29 @@ import { defineCommand, runMain } from "citty";
 /**
 * xiaobao-cli entrypoint.
 *
-* 14 capabilities mapped 1:1 from openclaw-xiaobao plugin tools to CLI
-* subcommands. See README for full command map.
+* Capabilities mapped from the openclaw-xiaobao plugin to CLI subcommands,
+* plus visit-summary and knowledge-base queries — all proxied through
+* ai-open → wang-ai-mcp. See README for the full command map.
 */
 const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
 runMain(defineCommand({
 	meta: {
 		name: "xiaobao-cli",
 		version: JSON.parse(readFileSync(pkgPath, "utf8")).version,
-		description: "旺小宝 CLI — host-agnostic 14 tools (openclaw-xiaobao plugin 的 CLI 等价物)"
+		description: "旺小宝 CLI — host-agnostic 业务数据 / 问数 / 来访总结 / 知识库 能力 (openclaw-xiaobao plugin 的 CLI 等价物)"
 	},
 	subCommands: {
-		auth: () => import("./auth-B4Yeoxae.mjs").then((m) => m.default),
-		project: () => import("./project-BD0g4oAW.mjs").then((m) => m.default),
-		consultant: () => import("./consultant-E33hTGUO.mjs").then((m) => m.default),
-		audio: () => import("./audio-CRSMqaKo.mjs").then((m) => m.default),
-		customer: () => import("./customer-DcQ83oKD.mjs").then((m) => m.default),
-		visit: () => import("./visit-DoeECi8w.mjs").then((m) => m.default),
-		focus: () => import("./focus-XMRxnHPw.mjs").then((m) => m.default),
-		resistance: () => import("./resistance-6_V6At3T.mjs").then((m) => m.default),
-		qa: () => import("./qa-CdMcxCE_.mjs").then((m) => m.default),
-		api: () => import("./api-fsHHWWa3.mjs").then((m) => m.default)
+		auth: () => import("./auth-BYWDBat3.mjs").then((m) => m.default),
+		project: () => import("./project-C2fvEuDl.mjs").then((m) => m.default),
+		consultant: () => import("./consultant-DvH6ezCT.mjs").then((m) => m.default),
+		audio: () => import("./audio-DhEiStuy.mjs").then((m) => m.default),
+		customer: () => import("./customer-BtAtJyM8.mjs").then((m) => m.default),
+		visit: () => import("./visit-LX3B_OgE.mjs").then((m) => m.default),
+		focus: () => import("./focus-BmLvFWII.mjs").then((m) => m.default),
+		resistance: () => import("./resistance-BxOZNWbb.mjs").then((m) => m.default),
+		qa: () => import("./qa-C2TSTS-m.mjs").then((m) => m.default),
+		kb: () => import("./kb-B9IY8-fu.mjs").then((m) => m.default),
+		api: () => import("./api-DtFEKH3I.mjs").then((m) => m.default)
 	}
 }));
 //#endregion

package/dist/{consultant-E33hTGUO.mjs → consultant-DvH6ezCT.mjs}

@@ -5,7 +5,7 @@ var consultant_default = defineCommand({
 		name: "consultant",
 		description: "查询有权限的置业顾问列表"
 	},
-	subCommands: { list: () => import("./list-dm9YaCG1.mjs").then((m) => m.default) }
+	subCommands: { list: () => import("./list-CiBpxZFs.mjs").then((m) => m.default) }
 });
 //#endregion
 export { consultant_default as default };

package/dist/{current-CfDExInT.mjs → current-gZDEGEmi.mjs}

@@ -1,5 +1,5 @@
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/project/current.ts
 /**
@@ -18,7 +18,7 @@ var current_default = defineCommand({
 	},
 	args: { format: {
 		type: "string",
-		default: "json"
+		default: "toon"
 	} },
 	async run({ args }) {
 		try {

package/dist/{customer-DcQ83oKD.mjs → customer-BtAtJyM8.mjs}

@@ -5,7 +5,7 @@ var customer_default = defineCommand({
 		name: "customer",
 		description: "客户画像分页查询"
 	},
-	subCommands: { list: () => import("./list-DFdDcHFq.mjs").then((m) => m.default) }
+	subCommands: { list: () => import("./list-DDGGG2p2.mjs").then((m) => m.default) }
 });
 //#endregion
 export { customer_default as default };

package/dist/doc--iAF-laM.mjs

@@ -0,0 +1,47 @@
+import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
+import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
+import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
+import { defineCommand } from "citty";
+//#region src/commands/kb/doc.ts
+/**
+* `xiaobao-cli kb doc <doc-id>` — knowledge-base document detail via
+* POST /ai-open/kb/docs/get. Fetched by docId. For the full body text use
+* `kb doc-content` (paged).
+*/
+var doc_default = defineCommand({
+	meta: {
+		name: "doc",
+		description: "知识库文档详情（按 docId 直取）"
+	},
+	args: {
+		"doc-id": {
+			type: "positional",
+			required: true,
+			description: "文档 ID"
+		},
+		"api-base": { type: "string" },
+		"auth-base": { type: "string" },
+		format: {
+			type: "string",
+			default: "toon"
+		}
+	},
+	async run({ args }) {
+		try {
+			writeResult(await xbApiFetch(resolveConfig({
+				apiBase: args["api-base"],
+				authBase: args["auth-base"]
+			}), "POST", "/ai-open/kb/docs/get", {
+				headers: tenantProjectHeaders(await requireActiveProject()),
+				body: { docId: Number(args["doc-id"]) }
+			}), args.format);
+		} catch (err) {
+			writeError(err, args.format);
+			process.exit(1);
+		}
+	}
+});
+//#endregion
+export { doc_default as default };

package/dist/doc-content-CqDVEgwX.mjs

@@ -0,0 +1,59 @@
+import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
+import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
+import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
+import { defineCommand } from "citty";
+//#region src/commands/kb/doc-content.ts
+/**
+* `xiaobao-cli kb doc-content <doc-id>` — paged knowledge-base document body
+* via POST /ai-open/kb/docs/content/query. Page through long documents with
+* `--offset`/`--limit`; use the `hasMore` flag in the response to keep going.
+*/
+var doc_content_default = defineCommand({
+	meta: {
+		name: "doc-content",
+		description: "知识库文档正文分页（offset/limit 翻页，hasMore 续翻）"
+	},
+	args: {
+		"doc-id": {
+			type: "positional",
+			required: true,
+			description: "文档 ID"
+		},
+		offset: {
+			type: "string",
+			description: "内容偏移，默认 0"
+		},
+		limit: {
+			type: "string",
+			description: "内容长度，默认 1000，最大 2000"
+		},
+		"api-base": { type: "string" },
+		"auth-base": { type: "string" },
+		format: {
+			type: "string",
+			default: "toon"
+		}
+	},
+	async run({ args }) {
+		try {
+			writeResult(await xbApiFetch(resolveConfig({
+				apiBase: args["api-base"],
+				authBase: args["auth-base"]
+			}), "POST", "/ai-open/kb/docs/content/query", {
+				headers: tenantProjectHeaders(await requireActiveProject()),
+				body: {
+					docId: Number(args["doc-id"]),
+					offset: args.offset != null ? Number(args.offset) : void 0,
+					limit: args.limit != null ? Number(args.limit) : void 0
+				}
+			}), args.format);
+		} catch (err) {
+			writeError(err, args.format);
+			process.exit(1);
+		}
+	}
+});
+//#endregion
+export { doc_content_default as default };

package/dist/docs-C_sC8m3F.mjs

@@ -0,0 +1,46 @@
+import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
+import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
+import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
+import { defineCommand } from "citty";
+//#region src/commands/kb/docs.ts
+/**
+* `xiaobao-cli kb docs` — list knowledge-base documents via
+* POST /ai-open/kb/docs/query. Scoped to the active project. Use `--title`
+* to filter by title keyword.
+*/
+var docs_default = defineCommand({
+	meta: {
+		name: "docs",
+		description: "知识库文档列表（按当前激活项目隔离）"
+	},
+	args: {
+		title: {
+			type: "string",
+			description: "标题关键字过滤（可选）"
+		},
+		"api-base": { type: "string" },
+		"auth-base": { type: "string" },
+		format: {
+			type: "string",
+			default: "toon"
+		}
+	},
+	async run({ args }) {
+		try {
+			writeResult(await xbApiFetch(resolveConfig({
+				apiBase: args["api-base"],
+				authBase: args["auth-base"]
+			}), "POST", "/ai-open/kb/docs/query", {
+				headers: tenantProjectHeaders(await requireActiveProject()),
+				body: { title: args.title }
+			}), args.format);
+		} catch (err) {
+			writeError(err, args.format);
+			process.exit(1);
+		}
+	}
+});
+//#endregion
+export { docs_default as default };

package/dist/{focus-XMRxnHPw.mjs → focus-BmLvFWII.mjs}

@@ -5,7 +5,7 @@ var focus_default = defineCommand({
 		name: "focus",
 		description: "客户关注点标签分页查询"
 	},
-	subCommands: { list: () => import("./list-CrMOrnS-.mjs").then((m) => m.default) }
+	subCommands: { list: () => import("./list-VJImXOzy.mjs").then((m) => m.default) }
 });
 //#endregion
 export { focus_default as default };

package/dist/{format-yjmxrbNm.mjs → format-CvKe7-yU.mjs}

@@ -560,21 +560,21 @@ function resolveOptions(options) {
 /**
 * Format a result payload to stdout in one of three flavours:
 *
-*   json   (default)   pretty JSON, agent-friendly and human-OK
-*   toon              TOON (Token-Oriented Object Notation) — ~30-50% fewer
+*   toon   (default)   TOON (Token-Oriented Object Notation) — ~30-50% fewer
 *                     tokens on uniform array-of-objects (LLM context optimization)
+*   json              pretty JSON, agent-friendly and human-OK
 *   table             not implemented in 0.1.0 — falls back to pretty JSON
 *                     (a v0.1.x target; pure cosmetic, doesn't affect agent flow)
 *
 * Errors / logs MUST NOT go through here — use stderr (console.error) so
 * agents parsing stdout don't break.
 */
-function writeResult(data, format = "json") {
+function writeResult(data, format = "toon") {
 	const text = normalize(format) === "toon" ? encode(data) : JSON.stringify(data, null, 2);
 	process.stdout.write(text + "\n");
 }
 /** Print an error structurally to stdout (still parseable) and human hint to stderr. */
-function writeError(error, format = "json") {
+function writeError(error, format = "toon") {
 	const payload = serializeError(error);
 	const text = normalize(format) === "toon" ? encode(payload) : JSON.stringify(payload, null, 2);
 	process.stdout.write(text + "\n");
@@ -585,9 +585,9 @@ function writeError(error, format = "json") {
 	if (err.hint) process.stderr.write(`hint:  ${err.hint}\n`);
 }
 function normalize(f) {
-	if (f === "toon") return "toon";
+	if (f === "json") return "json";
 	if (f === "table") return "table";
-	return "json";
+	return "toon";
 }
 function serializeError(error) {
 	if (error instanceof Error) {

package/dist/kb-B9IY8-fu.mjs

@@ -0,0 +1,16 @@
+import { defineCommand } from "citty";
+//#region src/commands/kb/index.ts
+var kb_default = defineCommand({
+	meta: {
+		name: "kb",
+		description: "项目知识库：语义检索 / 文档列表 / 文档详情 / 文档正文分页"
+	},
+	subCommands: {
+		search: () => import("./search-CBWh8yKE.mjs").then((m) => m.default),
+		docs: () => import("./docs-C_sC8m3F.mjs").then((m) => m.default),
+		doc: () => import("./doc--iAF-laM.mjs").then((m) => m.default),
+		"doc-content": () => import("./doc-content-CqDVEgwX.mjs").then((m) => m.default)
+	}
+});
+//#endregion
+export { kb_default as default };

package/dist/{list-CnlQdzPp.mjs → list-CZVU6EVq.mjs}

@@ -2,7 +2,7 @@ import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
 import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { n as mergeUserIds, r as toLocalDateTime, t as csvToArray } from "./util-CaPQBlNa.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/audio/list.ts
@@ -49,7 +49,7 @@ var list_default = defineCommand({
 		"auth-base": { type: "string" },
 		format: {
 			type: "string",
-			default: "json"
+			default: "toon"
 		}
 	},
 	async run({ args }) {

package/dist/{list-dm9YaCG1.mjs → list-CiBpxZFs.mjs}

@@ -2,7 +2,7 @@ import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
 import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/consultant/list.ts
 /**
@@ -22,7 +22,7 @@ var list_default = defineCommand({
 		"auth-base": { type: "string" },
 		format: {
 			type: "string",
-			default: "json"
+			default: "toon"
 		}
 	},
 	async run({ args }) {

package/dist/{list-DFdDcHFq.mjs → list-DDGGG2p2.mjs}

@@ -2,7 +2,7 @@ import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
 import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { r as toLocalDateTime } from "./util-CaPQBlNa.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/customer/list.ts
@@ -60,7 +60,7 @@ var list_default = defineCommand({
 		"auth-base": { type: "string" },
 		format: {
 			type: "string",
-			default: "json"
+			default: "toon"
 		}
 	},
 	async run({ args }) {

package/dist/{list-B3nN4pd2.mjs → list-DW4Sk-76.mjs}

@@ -1,6 +1,6 @@
 import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
 import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/project/list.ts
 /**
@@ -26,7 +26,7 @@ var list_default = defineCommand({
 		"auth-base": { type: "string" },
 		format: {
 			type: "string",
-			default: "json"
+			default: "toon"
 		}
 	},
 	async run({ args }) {

package/dist/{list-CXquxzex.mjs → list-DbReQZE2.mjs}

@@ -2,7 +2,7 @@ import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
 import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { r as toLocalDateTime } from "./util-CaPQBlNa.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/visit/list.ts
@@ -47,7 +47,7 @@ var list_default = defineCommand({
 		"auth-base": { type: "string" },
 		format: {
 			type: "string",
-			default: "json"
+			default: "toon"
 		}
 	},
 	async run({ args }) {

package/dist/{list-Cc4zcaNz.mjs → list-DmBz_8dR.mjs}

@@ -2,7 +2,7 @@ import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
 import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { r as toLocalDateTime, t as csvToArray } from "./util-CaPQBlNa.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/resistance/list.ts
@@ -59,7 +59,7 @@ var list_default = defineCommand({
 		"auth-base": { type: "string" },
 		format: {
 			type: "string",
-			default: "json"
+			default: "toon"
 		}
 	},
 	async run({ args }) {

package/dist/{list-CrMOrnS-.mjs → list-VJImXOzy.mjs}

@@ -2,7 +2,7 @@ import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
 import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { r as toLocalDateTime, t as csvToArray } from "./util-CaPQBlNa.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/focus/list.ts
@@ -59,7 +59,7 @@ var list_default = defineCommand({
 		"auth-base": { type: "string" },
 		format: {
 			type: "string",
-			default: "json"
+			default: "toon"
 		}
 	},
 	async run({ args }) {

package/dist/{login-EtQi30zd.mjs → login-B5e9tJbS.mjs}

@@ -1,6 +1,6 @@
 import { a as resolveConfig, n as pollForToken, r as refreshToken, t as initiateDeviceAuthorization } from "./device-flow-D6JVcEap.mjs";
 import { a as isAccessTokenValid, c as writePendingAuth, l as writeToken, n as clearPendingAuth, o as readPendingAuth, r as clearToken, s as readToken, t as NoPendingAuthError } from "./token-store-CXizLE2_.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/auth/login.ts
 /**
@@ -56,7 +56,7 @@ var login_default = defineCommand({
 		},
 		format: {
 			type: "string",
-			default: "json"
+			default: "toon"
 		}
 	},
 	async run({ args }) {

package/dist/{logout-DP7REhCd.mjs → logout-Dz_FFIRP.mjs}

@@ -1,6 +1,6 @@
 import { a as resolveConfig, i as revokeRefreshToken } from "./device-flow-D6JVcEap.mjs";
 import { n as clearPendingAuth, r as clearToken, s as readToken } from "./token-store-CXizLE2_.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/auth/logout.ts
 /**
@@ -23,7 +23,7 @@ var logout_default = defineCommand({
 		},
 		format: {
 			type: "string",
-			default: "json"
+			default: "toon"
 		}
 	},
 	async run({ args }) {

package/dist/{project-BD0g4oAW.mjs → project-C2fvEuDl.mjs}

@@ -6,9 +6,9 @@ var project_default = defineCommand({
 		description: "查询 / 切换激活项目"
 	},
 	subCommands: {
-		list: () => import("./list-B3nN4pd2.mjs").then((m) => m.default),
-		use: () => import("./use-BZES4FZC.mjs").then((m) => m.default),
-		current: () => import("./current-CfDExInT.mjs").then((m) => m.default)
+		list: () => import("./list-DW4Sk-76.mjs").then((m) => m.default),
+		use: () => import("./use-xbTXVwXb.mjs").then((m) => m.default),
+		current: () => import("./current-gZDEGEmi.mjs").then((m) => m.default)
 	}
 });
 //#endregion

package/dist/{qa-CdMcxCE_.mjs → qa-C2TSTS-m.mjs}

@@ -2,7 +2,7 @@ import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
 import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/qa.ts
 /**
@@ -11,6 +11,10 @@ import { defineCommand } from "citty";
 * Natural-language Q&A over the active project's data — customers / visits /
 * 挖需率 / 销冠 / 录音覆盖率 / KPIs. Wraps POST /ai-open/langchain/quick-qa/query.
 *
+* Backend note: ai-open now routes this endpoint to wang-ai-mcp's sql-agent
+* (natural-language → SQL), replacing the legacy fast-responder. The request
+* shape ({ prompt, thread_id }) and response are unchanged — transparent here.
+*
 * Multi-turn: pass back the `thread_id` from previous response via --thread-id
 * for follow-ups. Timeout 30 min (backend can run long multi-step data lookups).
 */
@@ -33,7 +37,7 @@ var qa_default = defineCommand({
 		"auth-base": { type: "string" },
 		format: {
 			type: "string",
-			default: "json"
+			default: "toon"
 		}
 	},
 	async run({ args }) {

package/dist/{resistance-6_V6At3T.mjs → resistance-BxOZNWbb.mjs}

@@ -5,7 +5,7 @@ var resistance_default = defineCommand({
 		name: "resistance",
 		description: "客户抗性点标签分页查询"
 	},
-	subCommands: { list: () => import("./list-Cc4zcaNz.mjs").then((m) => m.default) }
+	subCommands: { list: () => import("./list-DmBz_8dR.mjs").then((m) => m.default) }
 });
 //#endregion
 export { resistance_default as default };

package/dist/search-CBWh8yKE.mjs

@@ -0,0 +1,75 @@
+import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
+import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
+import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
+import { t as csvToArray } from "./util-CaPQBlNa.mjs";
+import { defineCommand } from "citty";
+//#region src/commands/kb/search.ts
+/**
+* `xiaobao-cli kb search <query>` — semantic knowledge-base retrieval via
+* POST /ai-open/kb/search. Returns ranked chunks (not full documents),
+* scoped to the active project.
+*/
+var search_default = defineCommand({
+	meta: {
+		name: "search",
+		description: "知识库语义检索（返回 chunk，按当前激活项目隔离）"
+	},
+	args: {
+		query: {
+			type: "positional",
+			required: true,
+			description: "检索 query"
+		},
+		k: {
+			type: "string",
+			description: "返回 chunk 数量，默认 5，最大 20"
+		},
+		"chunk-types": {
+			type: "string",
+			description: "CSV: chunk 类型过滤"
+		},
+		"doc-ids": {
+			type: "string",
+			description: "CSV: 文档 ID 过滤"
+		},
+		"enable-rerank": {
+			type: "boolean",
+			description: "是否启用 rerank"
+		},
+		"rerank-threshold": {
+			type: "string",
+			description: "rerank 阈值（小数）"
+		},
+		"api-base": { type: "string" },
+		"auth-base": { type: "string" },
+		format: {
+			type: "string",
+			default: "toon"
+		}
+	},
+	async run({ args }) {
+		try {
+			writeResult(await xbApiFetch(resolveConfig({
+				apiBase: args["api-base"],
+				authBase: args["auth-base"]
+			}), "POST", "/ai-open/kb/search", {
+				headers: tenantProjectHeaders(await requireActiveProject()),
+				body: {
+					query: String(args.query),
+					k: args.k != null ? Number(args.k) : void 0,
+					chunkTypes: csvToArray(args["chunk-types"]),
+					docIds: csvToArray(args["doc-ids"]),
+					enableRerank: args["enable-rerank"] ? true : void 0,
+					rerankThreshold: args["rerank-threshold"] != null ? Number(args["rerank-threshold"]) : void 0
+				}
+			}), args.format);
+		} catch (err) {
+			writeError(err, args.format);
+			process.exit(1);
+		}
+	}
+});
+//#endregion
+export { search_default as default };

package/dist/summary-CAm-WDNF.mjs

@@ -0,0 +1,84 @@
+import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
+import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
+import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
+import { r as toLocalDateTime } from "./util-CaPQBlNa.mjs";
+import { defineCommand } from "citty";
+//#region src/commands/visit/summary.ts
+/**
+* `xiaobao-cli visit summary` — page visit reception-summaries via
+* POST /ai-open/visits/summary.
+*
+* Returns customer × visit × template-summary nesting, paged by visit_id.
+* `--template` selects a specific reception-summary template (exact match on
+* the template name, not a free-text question). When `--visit-id` is omitted,
+* `--from`/`--to` are required and the window must be ≤ 7 days (enforced
+* downstream by wang-ai-mcp).
+*/
+var summary_default = defineCommand({
+	meta: {
+		name: "summary",
+		description: "来访接待总结分页查询（客户×来访×模板总结，按 visit_id 分页）"
+	},
+	args: {
+		"customer-id": {
+			type: "string",
+			description: "客户 ID（wang_id）精确过滤"
+		},
+		"visit-id": {
+			type: "string",
+			description: "来访 ID 精确过滤；传了它 from/to 可省略"
+		},
+		from: {
+			type: "string",
+			description: "来访时间下限（含）；visit-id 为空时必填"
+		},
+		to: {
+			type: "string",
+			description: "来访时间上限（不含）；visit-id 为空时必填"
+		},
+		template: {
+			type: "string",
+			description: "指定查询某个接待总结模板的结果（精确匹配模板名，非自由问句）"
+		},
+		page: {
+			type: "string",
+			default: "1"
+		},
+		size: {
+			type: "string",
+			default: "10"
+		},
+		"api-base": { type: "string" },
+		"auth-base": { type: "string" },
+		format: {
+			type: "string",
+			default: "toon"
+		}
+	},
+	async run({ args }) {
+		try {
+			writeResult(await xbApiFetch(resolveConfig({
+				apiBase: args["api-base"],
+				authBase: args["auth-base"]
+			}), "POST", "/ai-open/visits/summary", {
+				headers: tenantProjectHeaders(await requireActiveProject()),
+				body: {
+					wangId: args["customer-id"],
+					visitId: args["visit-id"],
+					fromDate: toLocalDateTime(args.from),
+					toDate: toLocalDateTime(args.to),
+					template: args.template,
+					page: Number(args.page),
+					size: Number(args.size)
+				}
+			}), args.format);
+		} catch (err) {
+			writeError(err, args.format);
+			process.exit(1);
+		}
+	}
+});
+//#endregion
+export { summary_default as default };

package/dist/{text-C3Ap6L5n.mjs → text-bgoI1KC-.mjs}

@@ -2,7 +2,7 @@ import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
 import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/audio/text.ts
 /**
@@ -27,7 +27,7 @@ var text_default = defineCommand({
 		"auth-base": { type: "string" },
 		format: {
 			type: "string",
-			default: "json"
+			default: "toon"
 		}
 	},
 	async run({ args }) {

package/dist/{use-BZES4FZC.mjs → use-xbTXVwXb.mjs}

@@ -1,5 +1,5 @@
 import { r as saveActiveProject } from "./project-store-CKVJa54T.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/project/use.ts
 /**
@@ -35,7 +35,7 @@ var use_default = defineCommand({
 		},
 		format: {
 			type: "string",
-			default: "json"
+			default: "toon"
 		}
 	},
 	async run({ args }) {

package/dist/visit-LX3B_OgE.mjs

@@ -0,0 +1,14 @@
+import { defineCommand } from "citty";
+//#region src/commands/visit/index.ts
+var visit_default = defineCommand({
+	meta: {
+		name: "visit",
+		description: "客户来访分页查询 / 来访接待总结"
+	},
+	subCommands: {
+		list: () => import("./list-DbReQZE2.mjs").then((m) => m.default),
+		summary: () => import("./summary-CAm-WDNF.mjs").then((m) => m.default)
+	}
+});
+//#endregion
+export { visit_default as default };

package/dist/{whoami-z-76WaCP.mjs → whoami-BMAFa4es.mjs}

@@ -1,5 +1,5 @@
 import { i as decodeJwtPayload, s as readToken } from "./token-store-CXizLE2_.mjs";
-import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/auth/whoami.ts
 /**
@@ -15,7 +15,7 @@ var whoami_default = defineCommand({
 	},
 	args: { format: {
 		type: "string",
-		default: "json"
+		default: "toon"
 	} },
 	async run({ args }) {
 		try {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@puyinkai/xiaobao-cli",
-  "version": "0.1.10",
-  "description": "旺小宝 CLI — host-agnostic 14 tools (openclaw-xiaobao plugin 的 CLI 等价物)",
+  "version": "0.2.1",
+  "description": "旺小宝 CLI — host-agnostic 业务数据 / 问数 / 来访总结 / 知识库 能力 (openclaw-xiaobao plugin 的 CLI 等价物)",
   "type": "module",
   "bin": {
     "xiaobao-cli": "./dist/cli.mjs"

package/skills/wangxiaobao-knowledge-base/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: wangxiaobao-knowledge-base
+version: 0.1.0
+description: "旺小宝项目知识库：语义检索项目知识 chunk（kb search）、列文档（kb docs）、看文档详情（kb doc）、分页读文档正文（kb doc-content）。search/docs 按当前激活项目隔离；doc/doc-content 按 docId 直取。只读、无副作用。高频命令: xiaobao-cli kb search '<query>' [--k N]; xiaobao-cli kb docs [--title <kw>]; xiaobao-cli kb doc <doc-id>; xiaobao-cli kb doc-content <doc-id> [--offset N] [--limit N]。何时用：用户问项目资料/楼盘知识/销售政策/户型文档/物料/知识库里有没有讲过X/某文档具体写了啥/帮我查下资料。注：search 返回 chunk 不是全文，要逐段读全文用 doc-content 翻页（看 hasMore 续翻）；k 默认 5 上限 20；"
+metadata:
+  requires:
+    bins: ["xiaobao-cli"]
+  cliHelp: "xiaobao-cli kb --help"
+---
+
+# 旺小宝项目知识库
+
+> **CRITICAL** —— 跑命令前 MUST 先用 Read tool 读取 [`../wangxiaobao-shared/SKILL.md`](../wangxiaobao-shared/SKILL.md)（一份共享文档讲清安装 / 登录 / 选项目 / 错误码 / 输出协议等所有 xiaobao-cli 命令通用的前置约定）。
+
+跑 `xiaobao-cli kb *` 检索 / 浏览当前激活项目的知识库（楼盘资料、政策、户型、物料等）。
+
+## 执行前必读
+
+- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录就走 `auth login --no-wait` split-flow（见 wangxiaobao-shared）
+- **必须有激活项目**：`kb search` / `kb docs` 按当前激活项目（estate）隔离知识；`kb doc` / `kb doc-content` 按 docId 直取（项目级而非顾问级隔离——任何登录用户按 docId 可读）
+- **只读**：不写文件、不出报告
+
+---
+
+## 快速索引：意图 → 工具
+
+| 用户意图 | 命令 | 关键参数 |
+| --- | --- | --- |
+| 知识库里有没有讲某主题 / 找答案 | `xiaobao-cli kb search` | `query` + `--k` |
+| 列项目有哪些文档 | `xiaobao-cli kb docs` | `--title 关键字`（可选） |
+| 看某文档的元信息 | `xiaobao-cli kb doc` | `<doc-id>` |
+| 逐段读某文档全文 | `xiaobao-cli kb doc-content` | `<doc-id>` + `--offset` / `--limit` |
+
+---
+
+## 核心约束
+
+### 1. search 返回 chunk，不是全文
+
+`kb search` 走语义检索，返回最相关的若干 **chunk（片段）**，用于快速回答"知识库里怎么说 X"。要读某篇文档的完整内容，先 `kb docs` 找到 `docId`，再 `kb doc-content` 翻页读全文。
+
+### 2. doc-content 用 offset/limit 翻页
+
+正文可能很长，`kb doc-content` 按 `offset`/`limit` 分页（limit 默认 1000、最大 2000）。响应里 `hasMore=true` 说明还有后续，把 `offset` 加上已读长度继续翻，直到 `hasMore=false`。
+
+### 3. k 默认 5，上限 20
+
+`kb search --k` 控制返回 chunk 数；默认 5，最大 20。问题宽泛时调大 k，精确查证时用小 k。
+
+### 4. 响应字段重点
+
+`kb search`：
+```jsonc
+{ "code": "0", "data": {
+  "query": "学区", "tenantId": "...", "estateId": "...",
+  "chunks": [
+    { "pageContent": "本项目对口 XX 小学...", "summary": "...", "sourceId": "123", "sourceType": "doc", "metadata": {...} }
+  ] } }
+```
+
+`kb docs`：`data.docs[]`，每项 `{ docId, title }`。
+
+`kb doc`：`data` = `{ id, title, fileName, description, enabled, parseStatus, createdAt, updatedAt }`。
+
+`kb doc-content`：`data` = `{ docId, offset, limit, totalLength, hasMore, content }`。
+
+CLI 都再包一层 → 实际读 `resp.data.data.*`。
+
+---
+
+## 使用场景示例
+
+### 场景 1：知识库里关于学区怎么说
+
+```bash
+xiaobao-cli kb search "学区 对口小学" --k 5
+```
+把命中的 `chunks[].pageContent` 综合成一段回答，必要时标注来源 `sourceId`。
+
+### 场景 2：找户型相关文档并读全文
+
+```bash
+# step 1: 找文档
+xiaobao-cli kb docs --title 户型
+# step 2: 假设 docId = 88，逐段读
+xiaobao-cli kb doc-content 88 --offset 0 --limit 2000
+# 若 hasMore=true，继续
+xiaobao-cli kb doc-content 88 --offset 2000 --limit 2000
+```
+
+### 场景 3：看某文档元信息
+
+```bash
+xiaobao-cli kb doc 88
+```
+
+---
+
+## 常见错误与排查
+
+- **`error: 'NO_ACTIVE_PROJECT'`** — 跑 `wangxiaobao-switch-project` skill（search/docs 需要激活项目）
+- **401 / token 过期** — 走 `auth login --no-wait --force` split-flow 重登
+- **search 命中为空 / chunks 为空** — 换关键词或调大 `--k`；该项目知识库可能尚未入库相关内容
+- **doc-content 读不全** — 看 `hasMore`，按 `offset` 继续翻页
+- **用户其实想问业务数据（客户/来访/业绩）** — 那是 `wangxiaobao-quick-qa`，不是知识库

package/skills/wangxiaobao-quick-qa/SKILL.md

@@ -15,6 +15,10 @@ metadata:
 跑 `xiaobao-cli qa` 用自然语言问当前激活项目的业务数据。
 零副作用，不写文件、不动 wiki，所以用错也没成本，鼓励放心调用。
 
+> **后端说明**：问数底层已由旧的 fast-responder 升级为 **sql-agent**（自然语言 → SQL，
+> 由 ai-open 代理到 wang-ai-mcp）。行为对调用方**透明**——请求 `{ prompt, thread_id }`
+> 与响应结构（含 `type: "quick-qa"`）都不变，多轮 `--thread-id` 续接照旧。
+
 ## 执行前必读
 
 - 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录 / 过期就走 `auth login --no-wait` split-flow（见 wangxiaobao-shared）

package/skills/wangxiaobao-shared/SKILL.md

@@ -87,7 +87,7 @@ xiaobao-cli project current   # 显示当前激活的 tenant/project + updatedAt
 
 | 流 | 内容 |
 | --- | --- |
-| **stdout** | 结果 / 错误对象，**JSON 格式**（默认）或 TOON 格式（`--format toon`），都是有效 JSON / 可机器解析 |
+| **stdout** | 结果 / 错误对象，默认 **TOON 格式**（省 token）；`--format json` 切回 JSON。均可机器解析 |
 | **stderr** | 进度 / 人类友好错误提示 / verification URL 等。Agent 一般忽略 |
 | **exit code** | 0 = 成功；非 0 = 失败（业务错误 / 参数错 / 网络错） |
 
@@ -97,8 +97,8 @@ Agent 消费时**只 parse stdout JSON**，stderr 是辅助。
 
 | 值 | 用途 |
 | --- | --- |
-| `json`（默认） | pretty JSON，agent / 人类都能读 |
-| `toon` | TOON 格式，uniform array of objects 省 30-50% token（LLM 上下文优化） |
+| `toon`（默认） | TOON 格式，uniform array of objects 省 30-50% token（LLM 上下文优化） |
+| `json` | pretty JSON，agent / 人类都能读；需要严格 JSON 时显式加 `--format json` |
 
 ## 错误对象结构
 
@@ -155,8 +155,8 @@ openclaw 的副本（保留 plugin session 完整性）。`auth logout` 例外
 
 ## 数据权限隔离
 
-`audio list` / `customer list` / `visit list` / `focus list` / `resistance list` /
-`consultant list` 所有业务命令的后端都按**当前登录用户的授权范围**过滤数据:
+`audio list` / `customer list` / `visit list` / `visit summary` / `focus list` /
+`resistance list` / `consultant list` / `qa` 所有业务命令的后端都按**当前登录用户的授权范围**过滤数据:
 
 - 普通顾问：只看自己名下
 - 团队长：看本团队
@@ -165,6 +165,13 @@ openclaw 的副本（保留 plugin session 完整性）。`auth logout` 例外
 `total: 0` 不一定是"没数据"，也可能是**当前账号无权访问**。看不到的客户 / 顾问
 不是 bug，是设计如此。要扩权限找管理员。
 
+**例外 —— `kb *`（知识库）是项目级隔离**：`kb search` / `kb docs` 按当前激活项目（estate）
+返回该项目知识，不按顾问授权范围细分；`kb doc` / `kb doc-content` 按 docId 直取。
+知识库面向全项目，不存在"看不到别人名下"的概念。
+
+> 后端链路：上述命令统一经 `ai-open`（公网开放层 / 鉴权）代理到内网业务层
+> `wang-ai-mcp`，对调用方透明，命令用法不变。
+
 ## 时间格式
 
 所有 `--from` / `--to` 用 `yyyy-MM-dd HH:mm:ss`（空格分隔，**不带时区**）。

package/skills/wangxiaobao-visit-summary-query/SKILL.md

@@ -0,0 +1,126 @@
+---
+name: wangxiaobao-visit-summary-query
+version: 0.1.0
+description: "旺小宝来访接待总结查询：按 客户ID(wang_id)/来访ID/时间窗(≤7天)/模板(template) 分页拉取每次来访的 AI 接待总结，按 客户×来访×总结项 三层嵌套（每个总结项 question=模板名、reply=该模板的总结答案）。--template 指定查询某个接待总结模板的结果（精确匹配模板名，非自由问句）。只读、不写文件、无副作用。高频命令: xiaobao-cli visit summary [--customer-id <id>] [--visit-id <id>] [--from <date>] [--to <date>] [--template <模板名>] [--page N] [--size N]。何时用：用户问某客户上次来访聊了啥/这次接待总结/接待要点/AI 怎么总结这次到访/某模板(如\"客户需求\"\"抗性分析\")的总结结果/最近来访的接待小结。注：visit-id 为空时 from/to 必填且窗口≤7天；customer-id 先用 xiaobao-cli customer list 反查 wang_id；要来访列表/录音走 visit-query；要录音原文走 audio-query。"
+metadata:
+  requires:
+    bins: ["xiaobao-cli"]
+  cliHelp: "xiaobao-cli visit summary --help"
+---
+
+# 旺小宝来访接待总结查询
+
+> **CRITICAL** —— 跑命令前 MUST 先用 Read tool 读取 [`../wangxiaobao-shared/SKILL.md`](../wangxiaobao-shared/SKILL.md)（一份共享文档讲清安装 / 登录 / 选项目 / 错误码 / 输出协议等所有 xiaobao-cli 命令通用的前置约定）。
+
+跑 `xiaobao-cli visit summary` 查当前激活项目里每次来访的 **AI 接待总结**（模板中心按模板生成的 question → reply）。
+
+## 执行前必读
+
+- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录就走 `auth login --no-wait` split-flow（见 wangxiaobao-shared）
+- **必须有激活项目**：命令内部自动读，缺失返回 `NO_ACTIVE_PROJECT`
+- **数据权限隔离**：跟来访接口一样，按当前用户授权可见顾问范围过滤
+- **时间窗 ≤ 7 天**：`visit-id` 为空时 `from`/`to` 必填，且窗口最长 7 天（超出后端自动截断为 to 往前 7 天）
+- LocalDateTime 格式：`yyyy-MM-dd HH:mm:ss`（空格分隔），CLI 自动转
+- **不要**写文件、出报告
+
+---
+
+## 快速索引：意图 → 工具
+
+| 用户意图 | 命令 | 关键参数 |
+| --- | --- | --- |
+| 看某次来访的接待总结 | `xiaobao-cli visit summary` | `--visit-id <id>`（from/to 可省） |
+| 看某客户近期来访总结 | `xiaobao-cli customer list` → `xiaobao-cli visit summary` | `--customer-id 反查的 wang_id` + 时间窗 |
+| 看某时间窗内全部接待总结 | `xiaobao-cli visit summary` | `--from` / `--to`（≤7 天） |
+| 只看某个模板的总结结果 | `xiaobao-cli visit summary` | `--template "客户需求"` |
+
+---
+
+## 核心约束
+
+### 1. visit-id 优先；无 visit-id 时时间窗必填且 ≤ 7 天
+
+- 已知具体某次来访 → `--visit-id`，可省略时间窗。
+- 否则 `--from`/`--to` 必填；窗口跨度超 7 天会被后端截断（只保留靠近 `to` 的最后 7 天）。
+
+| 用户说法 | fromDate / toDate |
+| --- | --- |
+| "今天来访总结" | 今天 00:00:00 / 明天 00:00:00 |
+| "本周接待小结" | 周一 00:00:00 / 今天 23:59:59 |
+| "最近一次来访" | 先 `visit list` 拿最近 visitId，再按 `--visit-id` 查 |
+
+### 2. 客户 ID 用 customer list 反查
+
+用户说"李女士上次来访聊了啥"——先 `xiaobao-cli customer list --customer-name 李女士` 反查 `wang_id`，再 `xiaobao-cli visit summary --customer-id <wang_id> --from ... --to ...`。
+
+### 3. --template 是模板名精确匹配
+
+`--template` 指定查询**某个接待总结模板**的结果（如 "客户需求"、"抗性分析"、"下一步跟进建议"），精确匹配模板名，不是自由问句。不传则返回该次来访的全部模板总结。要列出有哪些模板，先不带 `--template` 查一次，从返回的 `summaries[].question` 看模板名。
+
+### 4. 按 visit_id 分页
+
+`page` 从 1 开始，`size` 默认 10、**上限 100**。分页粒度是来访（visit_id），不是客户也不是总结条目。
+
+### 5. 响应字段重点
+
+```jsonc
+{
+  "code": "0",
+  "data": {
+    "page": 1, "size": 10, "total": 23,        // total = 命中的来访数
+    "content": [
+      {
+        "wangId": "1685535452481236993",          // 客户 ID
+        "visits": [
+          {
+            "visitId":  "...",
+            "visitTime": "2026-05-13 14:01:03",
+            "summaries": [                          // ★ 该次来访的模板总结列表
+              { "question": "客户需求", "reply": "关注三房、预算 300 万以内、看重学区..." },
+              { "question": "抗性分析", "reply": "对楼层和价格有顾虑..." }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+CLI 又包一层 → `resp.data.data.content`。每个总结项 `question` = 模板名、`reply` = 该模板的 AI 总结答案。展示给用户时按 客户 → 来访 → 模板 三层组织。
+
+---
+
+## 使用场景示例
+
+### 场景 1：看某次来访的接待总结
+
+```bash
+xiaobao-cli visit summary --visit-id 998877
+```
+
+### 场景 2：李女士本周来访都聊了什么
+
+```bash
+# step 1: 反查 wang_id
+xiaobao-cli customer list --customer-name 李女士 --size 20
+# step 2: 用 wang_id + 本周时间窗
+xiaobao-cli visit summary --customer-id 270072120829026305 --from "2026-05-12 00:00:00" --to "2026-05-16 23:59:59"
+```
+
+### 场景 3：只看"客户需求"模板的总结
+
+```bash
+xiaobao-cli visit summary --from "2026-05-13 00:00:00" --to "2026-05-14 00:00:00" --template "客户需求"
+```
+
+---
+
+## 常见错误与排查
+
+- **`error: 'NO_ACTIVE_PROJECT'`** — 跑 `wangxiaobao-switch-project` skill
+- **401 / token 过期** — 走 `auth login --no-wait --force` split-flow 重登
+- **`from 与 to 不能为空`** — 没传 `--visit-id` 时必须给时间窗
+- **`to 必须晚于 from`** — 时间窗方向反了
+- **`total: 0`** — 窗口内没有已完成分析的来访总结，或当前用户授权范围内无匹配
+- **想看录音原文 / 列来访** — 录音转录走 `wangxiaobao-audio-query`；来访列表 + 录音走 `wangxiaobao-visit-query`

package/dist/visit-DoeECi8w.mjs

@@ -1,11 +0,0 @@
-import { defineCommand } from "citty";
-//#region src/commands/visit/index.ts
-var visit_default = defineCommand({
-	meta: {
-		name: "visit",
-		description: "客户来访分页查询"
-	},
-	subCommands: { list: () => import("./list-CXquxzex.mjs").then((m) => m.default) }
-});
-//#endregion
-export { visit_default as default };