@klarkxy/dsh-zhihu 0.2.11 → 0.3.1

package/lib/tools.js

@@ -1,396 +1,93 @@
-import { _ as executeZhihuSearch, a as ZHIHU_ASK_DEFAULT_MODEL, c as executeZhihuAsk, d as executeZhihuKnowledgeSearch, f as normalizeRecallScopes, g as renderZhihuKnowledgeSearch, h as renderZhihuHotList, i as zhihuOpenPlatformResultCount, l as executeZhihuGlobalSearch, m as renderZhihuGlobalSearch, n as executeZhihuOpenPlatform, o as ZHIHU_ASK_MODELS, p as renderZhihuAsk, s as ZHIHU_RECALL_SCOPES, t as ZHIHU_OPEN_PLATFORM_APIS, u as executeZhihuHotList, v as renderZhihuSearch, x as reportExecuted } from "./open-platform.js";
-import { ZHIHU_ASK_TOOL_NAME, ZHIHU_CREATOR_ACCOUNT_STATS_TOOL_NAME, ZHIHU_CREATOR_CONTENT_STATS_TOOL_NAME, ZHIHU_GLOBAL_SEARCH_TOOL_NAME, ZHIHU_HOT_LIST_TOOL_NAME, ZHIHU_KNOWLEDGE_SEARCH_TOOL_NAME, ZHIHU_QUESTION_ANSWERS_TOOL_NAME, ZHIHU_QUESTION_RECOMMENDATIONS_TOOL_NAME, ZHIHU_QUOTA_IDS, ZHIHU_QUOTA_TOOL_NAME, ZHIHU_SEARCH_TOOL_NAME, ZHIHU_USER_CONTENT_COMMENTS_TOOL_NAME, ZHIHU_USER_CONTENT_DETAIL_TOOL_NAME } from "./contracts.js";
+import { _ as executeZhihuSearch, a as ZHIHU_ASK_DEFAULT_MODEL, c as executeZhihuAsk, d as executeZhihuKnowledgeSearch, f as normalizeRecallScopes, g as renderZhihuKnowledgeSearch, h as renderZhihuHotList, i as zhihuOpenPlatformResultCount, l as executeZhihuGlobalSearch, m as renderZhihuGlobalSearch, n as executeZhihuOpenPlatform, o as ZHIHU_ASK_MODELS, p as renderZhihuAsk, s as ZHIHU_RECALL_SCOPES, t as ZHIHU_OPEN_PLATFORM_APIS, u as executeZhihuHotList, v as renderZhihuSearch, x as reportExecuted, y as ZhihuSearchError } from "./open-platform.js";
+import { ZHIHU_ACCOUNT_TOOL_NAME, ZHIHU_QUOTA_IDS, ZHIHU_RESEARCH_TOOL_NAME } from "./contracts.js";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 //#region src/tool-definitions.ts
-const SEARCH_ITEM_SCHEMA = {
-	type: "object",
-	additionalProperties: false,
-	properties: {
-		title: {
-			type: "string",
-			required: true
-		},
-		type: {
-			type: "string",
-			required: true
-		},
-		url: {
-			type: "string",
-			required: true
-		},
-		summary: {
-			type: "string",
-			required: true
-		},
-		votes: {
-			type: "integer",
-			required: true
-		},
-		comments: {
-			type: "integer",
-			required: true
-		},
-		author: {
-			type: "string",
-			required: true
-		},
-		authority: {
-			type: "string",
-			required: true
-		},
-		editTime: {
-			type: "string",
-			required: true
-		}
-	}
-};
-function createZhihuSearchTool(options = {}) {
-	const { onExecuted, ...client } = options;
-	return defineTool({
-		name: ZHIHU_SEARCH_TOOL_NAME,
-		description: "知乎站内搜索（GET /api/v1/content/zhihu_search），取社区证据；仅作社区/读者反馈参考，不构成 canon，不写入项目文件。",
-		parameters: {
-			query: {
-				type: "string",
-				required: true,
-				description: "搜索词，2-100 字符。"
-			},
-			count: {
-				type: "integer",
-				description: `返回条数，1-10，默认 5。`
-			}
-		},
-		output: {
-			schema: {
-				type: "object",
-				additionalProperties: false,
-				properties: {
-					version: {
-						type: "integer",
-						required: true
-					},
-					query: {
-						type: "string",
-						required: true
-					},
-					count: {
-						type: "integer",
-						required: true
-					},
-					items: {
-						type: "array",
-						required: true,
-						items: SEARCH_ITEM_SCHEMA
-					},
-					emptyReason: { type: "string" }
-				}
-			},
-			render(_args, value) {
-				return [{
-					type: "text",
-					text: renderZhihuSearch(value)
-				}];
-			}
-		},
-		isConcurrencySafe() {
-			return true;
-		},
-		async execute(args, exec) {
-			const typed = args;
-			try {
-				const result = await executeZhihuSearch(typed.query, typed.count ?? 5, {
-					...client,
-					signal: exec.signal
-				});
-				reportExecuted(onExecuted, {
-					ok: true,
-					results: result.items.length
-				});
-				return result;
-			} catch (error) {
-				reportExecuted(onExecuted, {
-					ok: false,
-					results: 0
-				});
-				throw error;
-			}
-		}
-	});
-}
-const OTHER_SEARCH_ITEM_SCHEMA = {
-	type: "object",
-	additionalProperties: false,
-	properties: {
-		title: {
-			type: "string",
-			required: true
-		},
-		type: {
-			type: "string",
-			required: true
-		},
-		url: {
-			type: "string",
-			required: true
-		},
-		summary: {
-			type: "string",
-			required: true
-		},
-		votes: {
-			type: "integer",
-			required: true
-		},
-		comments: {
-			type: "integer",
-			required: true
-		},
-		author: {
-			type: "string",
-			required: true
-		},
-		authority: {
-			type: "string",
-			required: true
-		},
-		editTime: {
-			type: "string",
-			required: true
-		}
+const ZHIHU_RESEARCH_ACTIONS = [
+	"search",
+	"global_search",
+	"hot_list",
+	"ask",
+	"knowledge_search"
+];
+/** 合并前的五个检索工具各自执行逻辑不变，这里只按 action 分发。 */
+function executeResearch(action, args, client, signal) {
+	const options = {
+		...client,
+		signal
+	};
+	if (action === "search") return executeZhihuSearch(args.query, args.count ?? 5, options).then((result) => ({
+		result,
+		results: result.items.length
+	}));
+	if (action === "global_search") {
+		const searchDb = args.searchDb === "realtime" || args.searchDb === "static" ? args.searchDb : "all";
+		return executeZhihuGlobalSearch(args.query, args.count ?? 10, searchDb, options).then((result) => ({
+			result,
+			results: result.items.length
+		}));
 	}
-};
-/** 包一层计量:成功报 results,失败报 ok:false 再原样抛出。 */
-async function metered(onExecuted, run, results) {
-	try {
-		const value = await run();
-		reportExecuted(onExecuted, {
-			ok: true,
-			results: results(value)
-		});
-		return value;
-	} catch (error) {
-		reportExecuted(onExecuted, {
-			ok: false,
-			results: 0
-		});
-		throw error;
+	if (action === "hot_list") return executeZhihuHotList(args.limit ?? 10, options).then((result) => ({
+		result,
+		results: result.items.length
+	}));
+	if (action === "ask") {
+		const model = ZHIHU_ASK_MODELS.includes(args.model ?? "") ? args.model : ZHIHU_ASK_DEFAULT_MODEL;
+		return executeZhihuAsk(args.query, model, options).then((result) => ({
+			result,
+			results: result.content ? 1 : 0
+		}));
 	}
+	return executeZhihuKnowledgeSearch(args.query, args.limit ?? 5, normalizeRecallScopes(args.recallScopes), options).then((result) => ({
+		result,
+		results: result.items.length
+	}));
+}
+function renderResearch(action, value) {
+	if (action === "search") return renderZhihuSearch(value);
+	if (action === "global_search") return renderZhihuGlobalSearch(value);
+	if (action === "hot_list") return renderZhihuHotList(value);
+	if (action === "ask") return renderZhihuAsk(value);
+	return renderZhihuKnowledgeSearch(value);
 }
-function createZhihuGlobalSearchTool(options = {}) {
+function createZhihuResearchTool(options = {}) {
 	const { onExecuted, ...client } = options;
 	return defineTool({
-		name: ZHIHU_GLOBAL_SEARCH_TOOL_NAME,
-		description: "知乎开放平台全网搜索（GET /api/v1/content/global_search），检索站外公开网页资料；仅作参考，不构成 canon，不写入项目文件。",
+		name: ZHIHU_RESEARCH_TOOL_NAME,
+		description: "知乎调研检索与问答，结果仅作社区参考，不构成 canon，不写入项目文件。action：search 站内；global_search 站外；hot_list 热榜；ask 直答；knowledge_search 知识库。",
 		parameters: {
+			action: {
+				type: "string",
+				enum: ZHIHU_RESEARCH_ACTIONS,
+				required: true
+			},
 			query: {
 				type: "string",
-				required: true,
-				description: "搜索词，2-100 字符。"
+				description: "检索词，2-100 字符；除 hot_list 外必填。"
 			},
 			count: {
 				type: "integer",
-				description: `返回条数，1-20，默认 10。`
+				description: `search 1-10（默认 5）、global_search 1-20（默认 10）。`
 			},
-			searchDb: {
-				type: "string",
-				description: "检索库：all（默认）、realtime（实时）、static（静态）。"
-			}
-		},
-		output: {
-			schema: {
-				type: "object",
-				additionalProperties: false,
-				properties: {
-					version: {
-						type: "integer",
-						required: true
-					},
-					query: {
-						type: "string",
-						required: true
-					},
-					count: {
-						type: "integer",
-						required: true
-					},
-					searchDb: {
-						type: "string",
-						required: true
-					},
-					items: {
-						type: "array",
-						required: true,
-						items: OTHER_SEARCH_ITEM_SCHEMA
-					},
-					emptyReason: { type: "string" }
-				}
-			},
-			render(_args, value) {
-				return [{
-					type: "text",
-					text: renderZhihuGlobalSearch(value)
-				}];
-			}
-		},
-		isConcurrencySafe() {
-			return true;
-		},
-		async execute(args, exec) {
-			const typed = args;
-			const searchDb = typed.searchDb === "realtime" || typed.searchDb === "static" ? typed.searchDb : "all";
-			return await metered(onExecuted, () => executeZhihuGlobalSearch(typed.query, typed.count ?? 10, searchDb, {
-				...client,
-				signal: exec.signal
-			}), (result) => result.items.length);
-		}
-	});
-}
-function createZhihuHotListTool(options = {}) {
-	const { onExecuted, ...client } = options;
-	return defineTool({
-		name: ZHIHU_HOT_LIST_TOOL_NAME,
-		description: "知乎热榜（GET /api/v1/content/hot_list），了解当前社区热点；仅作题材参考，不构成 canon，不写入项目文件。",
-		parameters: { limit: {
-			type: "integer",
-			description: `返回条数，1-30，默认 10。`
-		} },
-		output: {
-			schema: {
-				type: "object",
-				additionalProperties: false,
-				properties: {
-					version: {
-						type: "integer",
-						required: true
-					},
-					limit: {
-						type: "integer",
-						required: true
-					},
-					items: {
-						type: "array",
-						required: true,
-						items: {
-							type: "object",
-							additionalProperties: false,
-							properties: {
-								title: {
-									type: "string",
-									required: true
-								},
-								url: {
-									type: "string",
-									required: true
-								},
-								summary: {
-									type: "string",
-									required: true
-								}
-							}
-						}
-					}
-				}
+			limit: {
+				type: "integer",
+				description: `hot_list 1-30（默认 10）、knowledge_search 1-10（默认 5）。`
 			},
-			render(_args, value) {
-				return [{
-					type: "text",
-					text: renderZhihuHotList(value)
-				}];
-			}
-		},
-		isConcurrencySafe() {
-			return true;
-		},
-		async execute(args, exec) {
-			const typed = args;
-			return await metered(onExecuted, () => executeZhihuHotList(typed.limit ?? 10, {
-				...client,
-				signal: exec.signal
-			}), (result) => result.items.length);
-		}
-	});
-}
-function createZhihuAskTool(options = {}) {
-	const { onExecuted, ...client } = options;
-	return defineTool({
-		name: ZHIHU_ASK_TOOL_NAME,
-		description: "知乎直答（POST /v1/chat/completions，OpenAI 兼容），基于社区内容生成综合回答，适合考据与背景调研；仅作参考，不构成 canon，不写入项目文件。",
-		parameters: {
-			query: {
+			searchDb: {
 				type: "string",
-				required: true,
-				description: "要问的问题。"
+				enum: [
+					"all",
+					"realtime",
+					"static"
+				],
+				description: "global_search 检索库，默认 all。"
 			},
 			model: {
 				type: "string",
-				description: "zhida-thinking-1p5（默认，带思考过程）、zhida-fast-1p5（快，仅适合简单事实查询）或 zhida-agent（最慢最强，仅在明确要求时使用）。fast/thinking 仅在免费额度足够时允许；付费模式拒绝未确认计费的模型。"
-			}
-		},
-		output: {
-			schema: {
-				type: "object",
-				additionalProperties: false,
-				properties: {
-					version: {
-						type: "integer",
-						required: true
-					},
-					query: {
-						type: "string",
-						required: true
-					},
-					model: {
-						type: "string",
-						required: true
-					},
-					content: {
-						type: "string",
-						required: true
-					},
-					reasoning: {
-						type: "string",
-						required: true
-					}
-				}
-			},
-			render(_args, value) {
-				return [{
-					type: "text",
-					text: renderZhihuAsk(value)
-				}];
-			}
-		},
-		isConcurrencySafe() {
-			return true;
-		},
-		async execute(args, exec) {
-			const typed = args;
-			const model = ZHIHU_ASK_MODELS.includes(typed.model ?? "") ? typed.model : ZHIHU_ASK_DEFAULT_MODEL;
-			return await metered(onExecuted, () => executeZhihuAsk(typed.query, model, {
-				...client,
-				signal: exec.signal
-			}), (result) => result.content ? 1 : 0);
-		}
-	});
-}
-function createZhihuKnowledgeSearchTool(options = {}) {
-	const { onExecuted, ...client } = options;
-	return defineTool({
-		name: ZHIHU_KNOWLEDGE_SEARCH_TOOL_NAME,
-		description: "知乎知识库检索（POST /api/v1/knowledge/search，RAG 片段），默认只查公开库；网页端上传过资料后可加 personal/subscription 召回；仅作背景参考，不构成 canon，不写入项目文件。",
-		parameters: {
-			query: {
-				type: "string",
-				required: true,
-				description: "检索词。"
-			},
-			limit: {
-				type: "integer",
-				description: `返回条数，1-10，默认 5。`
+				description: "ask 模型：zhida-thinking-1p5（默认，带思考）、zhida-fast-1p5（简单事实）、zhida-agent（最慢最强，仅明确要求时用）；免费额度不足被拒绝。"
 			},
 			recallScopes: {
 				type: "array",
-				description: "召回范围：public（公开库，默认）、personal（个人库）、subscription（订阅库），可多选。",
+				description: "knowledge_search 召回范围，默认 public；可加 personal/subscription。",
 				items: {
 					type: "string",
 					enum: [...ZHIHU_RECALL_SCOPES]
@@ -400,54 +97,13 @@ function createZhihuKnowledgeSearchTool(options = {}) {
 		output: {
 			schema: {
 				type: "object",
-				additionalProperties: false,
-				properties: {
-					version: {
-						type: "integer",
-						required: true
-					},
-					query: {
-						type: "string",
-						required: true
-					},
-					limit: {
-						type: "integer",
-						required: true
-					},
-					recallScopes: {
-						type: "array",
-						required: true,
-						items: { type: "string" }
-					},
-					items: {
-						type: "array",
-						required: true,
-						items: {
-							type: "object",
-							additionalProperties: false,
-							properties: {
-								docName: {
-									type: "string",
-									required: true
-								},
-								originUrl: {
-									type: "string",
-									required: true
-								},
-								snippets: {
-									type: "array",
-									required: true,
-									items: { type: "string" }
-								}
-							}
-						}
-					}
-				}
+				additionalProperties: true,
+				properties: {}
 			},
-			render(_args, value) {
+			render(args, value) {
 				return [{
 					type: "text",
-					text: renderZhihuKnowledgeSearch(value)
+					text: renderResearch(args.action, value)
 				}];
 			}
 		},
@@ -456,10 +112,21 @@ function createZhihuKnowledgeSearchTool(options = {}) {
 		},
 		async execute(args, exec) {
 			const typed = args;
-			return await metered(onExecuted, () => executeZhihuKnowledgeSearch(typed.query, typed.limit ?? 5, normalizeRecallScopes(typed.recallScopes), {
-				...client,
-				signal: exec.signal
-			}), (result) => result.items.length);
+			if (typed.action !== "hot_list" && (typeof typed.query !== "string" || !typed.query.trim())) throw new ZhihuSearchError("INVALID_ARGUMENTS", `action ${typed.action} 需要 query 参数。`);
+			try {
+				const { result, results } = await executeResearch(typed.action, typed, client, exec.signal);
+				reportExecuted(onExecuted, {
+					ok: true,
+					results
+				});
+				return result;
+			} catch (error) {
+				reportExecuted(onExecuted, {
+					ok: false,
+					results: 0
+				});
+				throw error;
+			}
 		}
 	});
 }
@@ -528,69 +195,59 @@ function renderZhihuOpenPlatform(result) {
 }
 //#endregion
 //#region src/open-platform-tools.ts
-const PAGE_PARAMETERS = {
-	offset: {
-		type: "string",
-		description: "非负 Int64 十进制字符串，默认 \"0\"。下一页只用 paging.nextOffset，不按条数推算，不接受不透明游标。"
-	},
-	limit: {
-		type: "integer",
-		description: "每页数量，1-50，默认 20。单页不足或为空不表示结束。"
-	}
-};
-const DATE_PARAMETERS = {
-	startDate: {
-		type: "string",
-		description: "YYYY-MM-DD，必须与 endDate 同时提供。省略两者使用上游默认范围，不猜测天数。"
-	},
-	endDate: {
-		type: "string",
-		description: "YYYY-MM-DD，不得早于 startDate。"
-	}
+const ZHIHU_ACCOUNT_ACTIONS = {
+	question_recommendations: "question.recommendations",
+	question_answers: "question.answers",
+	content_detail: "content.detail",
+	content_comments: "content.comments",
+	creator_account_stats: "creator.account.stats",
+	creator_content_stats: "creator.content.stats",
+	quota: "quota"
 };
-const CONTENT_URL = {
-	type: "string",
-	required: true,
-	description: "当前账号已发布内容的 HTTPS 知乎回答、专栏文章、想法或视频链接；不是任意网页抓取。"
+const REQUIRED = {
+	question_recommendations: "主题 query 可选；省略按画像推荐。",
+	question_answers: "questionUrl 必填。",
+	content_detail: "contentUrl 必填。",
+	content_comments: "contentUrl 必填。",
+	creator_account_stats: "contentType 与日期可选。",
+	creator_content_stats: "contentUrl 必填。",
+	quota: "apiIds 可选。"
 };
-const DEFINITIONS = {
-	"question.recommendations": {
-		name: ZHIHU_QUESTION_RECOMMENDATIONS_TOOL_NAME,
-		description: "推荐适合当前账号回答的问题；省略主题按画像推荐，条目可能少于 Count，不支持分页。使用 question_discovery 额度；免费模式须有足够额度，付费模式因计费未确认而阻止。",
+function createZhihuAccountTool(options = {}) {
+	const { onExecuted, ...client } = options;
+	return defineTool({
+		name: ZHIHU_ACCOUNT_TOOL_NAME,
+		description: "知乎账号数据（Access Secret 鉴权，拒绝 OAuth 切换；结果仅参考，不写入项目文件）。action：question_recommendations 问题推荐；question_answers 回答摘要；content_detail 创作全文；content_comments 评论；creator_account_stats 账号数据；creator_content_stats 单篇数据；quota 额度。",
 		parameters: {
+			action: {
+				type: "string",
+				enum: Object.keys(ZHIHU_ACCOUNT_ACTIONS),
+				required: true
+			},
 			query: {
 				type: "string",
-				description: "可选主题；不传才按画像推荐，空白字符串无效。"
+				description: "question_recommendations 主题；省略按画像推荐。"
 			},
 			count: {
 				type: "integer",
-				description: "推荐数量，1-20，默认 5。"
-			}
-		}
-	},
-	"question.answers": {
-		name: ZHIHU_QUESTION_ANSWERS_TOOL_NAME,
-		description: "读取问题下的回答摘要，非全文，也非新生成的 AI 摘要。一次一页，只有 paging.canContinue=true 时才用 nextOffset。使用 question_discovery 额度。",
-		parameters: {
+				description: "question_recommendations 数量，1-20，默认 5。"
+			},
 			questionUrl: {
 				type: "string",
-				required: true,
-				description: "https://www.zhihu.com/question/{id} 形式的问题链接。"
+				description: "question_answers 必填，https://www.zhihu.com/question/{id} 链接。"
+			},
+			contentUrl: {
+				type: "string",
+				description: "content_detail、content_comments、creator_content_stats 必填：本人已发布的 HTTPS 回答/专栏/想法/视频链接。"
+			},
+			offset: {
+				type: "string",
+				description: "question_answers、content_comments 分页，非负 Int64 字符串，默认 \"0\"；翻页只用 paging.nextOffset。"
+			},
+			limit: {
+				type: "integer",
+				description: "question_answers、content_comments 每页条数，1-50，默认 20。"
 			},
-			...PAGE_PARAMETERS
-		}
-	},
-	"content.detail": {
-		name: ZHIHU_USER_CONTENT_DETAIL_TOOL_NAME,
-		description: "读取当前账号已发布创作的全文。不能读其他账号全文；视频只给关联正文。空正文不能视为全文。使用 creator 额度。",
-		parameters: { contentUrl: CONTENT_URL }
-	},
-	"content.comments": {
-		name: ZHIHU_USER_CONTENT_COMMENTS_TOOL_NAME,
-		description: "读取当前账号创作下的根评论及附带 Children；子评论不保证完整。一次一页，只按 paging 翻页，不按条数判断结束。使用 creator 额度。",
-		parameters: {
-			contentUrl: CONTENT_URL,
-			...PAGE_PARAMETERS,
 			order: {
 				type: "string",
 				enum: [
@@ -598,14 +255,8 @@ const DEFINITIONS = {
 					"reverse",
 					"ascending"
 				],
-				description: "排序，默认 score。"
-			}
-		}
-	},
-	"creator.account.stats": {
-		name: ZHIHU_CREATOR_ACCOUNT_STATS_TOOL_NAME,
-		description: "读取当前账号创作数据。缺失指标不补零，比例保持原值，不换算百分比。使用 creator 额度。",
-		parameters: {
+				description: "content_comments 排序，默认 score。"
+			},
 			contentType: {
 				type: "string",
 				enum: [
@@ -615,76 +266,31 @@ const DEFINITIONS = {
 					"pin",
 					"zvideo"
 				],
-				description: "内容类型，默认 all，不支持 question。"
+				description: "creator_account_stats 内容类型，默认 all，不支持 question。"
 			},
-			...DATE_PARAMETERS
-		}
-	},
-	"creator.content.stats": {
-		name: ZHIHU_CREATOR_CONTENT_STATS_TOOL_NAME,
-		description: "读取当前账号单篇创作数据。空列表不代表零指标；缺失指标保持省略，比例保持上游原值。使用 creator 额度。",
-		parameters: {
-			contentUrl: CONTENT_URL,
-			...DATE_PARAMETERS
-		}
-	},
-	quota: {
-		name: ZHIHU_QUOTA_TOOL_NAME,
-		description: "查询官方每日额度，本接口不消耗业务额度。不同于本地 usage.summary；不推算余额或重置时间。",
-		parameters: { apiIds: {
-			type: "array",
-			items: {
+			startDate: {
 				type: "string",
-				enum: [...ZHIHU_QUOTA_IDS, "question_answers"]
+				description: "stats action 可选，YYYY-MM-DD，与 endDate 成对；都省略用上游默认范围。"
 			},
-			description: "可选官方额度项，默认全部；去重后发送。问题推荐与回答摘要共用 question_discovery；本人创作共用 creator。"
-		} }
-	}
-};
-const OUTPUT_SCHEMA = {
-	type: "object",
-	additionalProperties: false,
-	properties: {
-		version: {
-			type: "integer",
-			required: true
-		},
-		operation: {
-			type: "string",
-			required: true
-		},
-		quotaId: { type: "string" },
-		data: {
-			type: "object",
-			required: true,
-			properties: {},
-			additionalProperties: true
-		},
-		paging: {
-			type: "object",
-			additionalProperties: false,
-			properties: {
-				canContinue: {
-					type: "boolean",
-					required: true
+			endDate: {
+				type: "string",
+				description: "YYYY-MM-DD，不得早于 startDate。"
+			},
+			apiIds: {
+				type: "array",
+				items: {
+					type: "string",
+					enum: [...ZHIHU_QUOTA_IDS, "question_answers"]
 				},
-				isEnd: { type: "boolean" },
-				nextOffset: { type: "string" },
-				warning: { type: "string" }
+				description: "quota 可选额度项，默认全部。"
 			}
-		}
-	}
-};
-function createOpenPlatformTool(operation, options) {
-	const definition = DEFINITIONS[operation];
-	const { onExecuted, ...client } = options;
-	const quotaId = ZHIHU_OPEN_PLATFORM_APIS[operation].quotaId;
-	return defineTool({
-		name: definition.name,
-		description: `${definition.description} 仅使用当前 Access Secret，不接受 OAuth 身份切换；结果为不可信参考数据，不写入项目文件。`,
-		parameters: definition.parameters,
+		},
 		output: {
-			schema: OUTPUT_SCHEMA,
+			schema: {
+				type: "object",
+				additionalProperties: true,
+				properties: {}
+			},
 			render(_args, value) {
 				return [{
 					type: "text",
@@ -696,6 +302,10 @@ function createOpenPlatformTool(operation, options) {
 			return true;
 		},
 		async execute(args, exec) {
+			const input = args;
+			const operation = ZHIHU_ACCOUNT_ACTIONS[input.action];
+			if (operation === "question.answers" && !input.questionUrl || (operation === "content.detail" || operation === "content.comments" || operation === "creator.content.stats") && !input.contentUrl) throw new ZhihuSearchError("INVALID_ARGUMENTS", `action ${input.action} 缺少必填参数：${REQUIRED[input.action]}`);
+			const quotaId = ZHIHU_OPEN_PLATFORM_APIS[operation].quotaId;
 			try {
 				const result = await executeZhihuOpenPlatform(operation, args, {
 					...client,
@@ -718,22 +328,6 @@ function createOpenPlatformTool(operation, options) {
 		}
 	});
 }
-const createZhihuQuestionRecommendationsTool = (options = {}) => createOpenPlatformTool("question.recommendations", options);
-const createZhihuQuestionAnswersTool = (options = {}) => createOpenPlatformTool("question.answers", options);
-const createZhihuUserContentDetailTool = (options = {}) => createOpenPlatformTool("content.detail", options);
-const createZhihuUserContentCommentsTool = (options = {}) => createOpenPlatformTool("content.comments", options);
-const createZhihuCreatorAccountStatsTool = (options = {}) => createOpenPlatformTool("creator.account.stats", options);
-const createZhihuCreatorContentStatsTool = (options = {}) => createOpenPlatformTool("creator.content.stats", options);
-const createZhihuQuotaTool = (options = {}) => createOpenPlatformTool("quota", options);
-const ZHIHU_OPEN_PLATFORM_TOOL_FACTORIES = [
-	createZhihuQuestionRecommendationsTool,
-	createZhihuQuestionAnswersTool,
-	createZhihuUserContentDetailTool,
-	createZhihuUserContentCommentsTool,
-	createZhihuCreatorAccountStatsTool,
-	createZhihuCreatorContentStatsTool,
-	createZhihuQuotaTool
-];
 //#endregion
 //#region src/sync-tools.ts
 /** Publishing is a human confirmation action in the preview pane. The tool can
@@ -741,7 +335,7 @@ const ZHIHU_OPEN_PLATFORM_TOOL_FACTORIES = [
 function createZhihuSyncTool(service) {
 	return defineTool({
 		name: "zhihu_sync",
-		description: "管理知乎文章、提问和想法草稿，校验预览或上传配图。上传会将图片发送到知乎；实际发布需用户在预览界面确认，当前分支未提供发布界面。",
+		description: "管理知乎文章、提问、想法草稿，校验预览、上传配图（发送到知乎）。发布需在预览界面确认，当前分支未提供发布界面。",
 		parameters: {
 			action: {
 				type: "string",
@@ -756,7 +350,7 @@ function createZhihuSyncTool(service) {
 			},
 			offset: {
 				type: "integer",
-				description: "list 分页位置；省略从头读取，后续使用返回的 nextOffset。"
+				description: "list 分页位置；后续用返回的 nextOffset。"
 			},
 			id: {
 				type: "string",
@@ -764,11 +358,11 @@ function createZhihuSyncTool(service) {
 			},
 			expectedRevision: {
 				type: "integer",
-				description: "prepare 或更新时填写上次读取的 revision。"
+				description: "prepare 或更新时填写上次读到的 revision。"
 			},
 			image: {
 				type: "object",
-				description: "upload_image 时填写图片内容。",
+				description: "upload_image 的图片。",
 				properties: {
 					fileName: {
 						type: "string",
@@ -777,7 +371,7 @@ function createZhihuSyncTool(service) {
 					contentBase64: {
 						type: "string",
 						required: true,
-						description: "JPEG、PNG、GIF、WebP 或 BMP 的标准 base64。GIF最大15 MB，其他最大30 MB。"
+						description: "JPEG/PNG/GIF/WebP/BMP；GIF ≤15 MB，其他 ≤30 MB。"
 					},
 					scene: {
 						type: "string",
@@ -793,7 +387,7 @@ function createZhihuSyncTool(service) {
 			},
 			draft: {
 				type: "object",
-				description: "save 时提供完整草稿；只做格式适配，不自动删改正文。",
+				description: "save 的草稿；只适配格式，不改正文。",
 				properties: {
 					type: {
 						type: "string",
@@ -819,7 +413,7 @@ function createZhihuSyncTool(service) {
 					},
 					images: {
 						type: "array",
-						description: "已上传的知乎图片；本地图片请通过 upload_image 上传后引用。",
+						description: "upload_image 已上传的图片。",
 						items: {
 							type: "object",
 							properties: {
@@ -841,7 +435,7 @@ function createZhihuSyncTool(service) {
 					},
 					linkCard: {
 						type: "object",
-						description: "想法的独立链接卡片，与图片互斥。",
+						description: "想法的链接卡片（与图片互斥）。",
 						properties: {
 							url: {
 								type: "string",
@@ -880,11 +474,11 @@ function createZhihuSyncTool(service) {
 							topics: {
 								type: "array",
 								items: { type: "string" },
-								description: "用户提供的知乎话题链接，文章最多3个，提问最多5个。"
+								description: "话题链接，文章最多 3 个、提问最多 5 个。"
 							},
 							ring: {
 								type: "string",
-								description: "想法的知乎圈子链接。"
+								description: "想法的圈子链接。"
 							}
 						},
 						additionalProperties: false
@@ -929,14 +523,7 @@ function apply(ctx) {
 	const host = ctx;
 	const options = host.zhihu.toolOptions;
 	if (host.zhihu.syncCall) host.tools.register(createZhihuSyncTool(host.zhihu));
-	for (const create of [
-		createZhihuSearchTool,
-		createZhihuGlobalSearchTool,
-		createZhihuHotListTool,
-		createZhihuAskTool,
-		createZhihuKnowledgeSearchTool,
-		...ZHIHU_OPEN_PLATFORM_TOOL_FACTORIES
-	]) {
+	for (const create of [createZhihuResearchTool, createZhihuAccountTool]) {
 		const tool = create(options);
 		const execute = tool.execute;
 		host.tools.register({