@klarkxy/dsh-zhihu 0.1.0

package/lib/tools.js

@@ -0,0 +1,494 @@
+import { _ as reportExecuted, a as executeZhihuGlobalSearch, c as normalizeRecallScopes, d as renderZhihuHotList, f as renderZhihuKnowledgeSearch, i as executeZhihuAsk, l as renderZhihuAsk, m as renderZhihuSearch, n as ZHIHU_ASK_MODELS, o as executeZhihuHotList, p as executeZhihuSearch, r as ZHIHU_RECALL_SCOPES, s as executeZhihuKnowledgeSearch, t as ZHIHU_ASK_DEFAULT_MODEL, u as renderZhihuGlobalSearch } from "./operations.js";
+import { ZHIHU_ASK_TOOL_NAME, ZHIHU_GLOBAL_SEARCH_TOOL_NAME, ZHIHU_HOT_LIST_TOOL_NAME, ZHIHU_KNOWLEDGE_SEARCH_TOOL_NAME, ZHIHU_SEARCH_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
+		}
+	}
+};
+/** 包一层计量:成功报 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;
+	}
+}
+function createZhihuGlobalSearchTool(options = {}) {
+	const { onExecuted, ...client } = options;
+	return defineTool({
+		name: ZHIHU_GLOBAL_SEARCH_TOOL_NAME,
+		description: "调用知乎开放平台全网搜索（GET /api/v1/content/global_search）检索站外公开网页资料；结果仅作参考，不构成 canon，也不直接写入项目文件。",
+		parameters: {
+			query: {
+				type: "string",
+				required: true,
+				description: "搜索词，2-100 字符。"
+			},
+			count: {
+				type: "integer",
+				description: `返回条数，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
+								}
+							}
+						}
+					}
+				}
+			},
+			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: {
+				type: "string",
+				required: true,
+				description: "要问的问题。"
+			},
+			model: {
+				type: "string",
+				description: "zhida-thinking-1p5（默认，带思考过程）、zhida-fast-1p5（快，仅适合简单事实查询）或 zhida-agent（最慢最强，仅在明确要求时使用）。"
+			}
+		},
+		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。`
+			},
+			recallScopes: {
+				type: "array",
+				description: "召回范围：public（公开库，默认）、personal（个人库）、subscription（订阅库），可多选。",
+				items: {
+					type: "string",
+					enum: [...ZHIHU_RECALL_SCOPES]
+				}
+			}
+		},
+		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" }
+								}
+							}
+						}
+					}
+				}
+			},
+			render(_args, value) {
+				return [{
+					type: "text",
+					text: renderZhihuKnowledgeSearch(value)
+				}];
+			}
+		},
+		isConcurrencySafe() {
+			return true;
+		},
+		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);
+		}
+	});
+}
+//#endregion
+//#region src/tools.ts
+const name = "dsh-zhihu-tools";
+const inject = ["zhihu", "tools"];
+function apply(ctx) {
+	const host = ctx;
+	const options = host.zhihu.toolOptions;
+	for (const create of [
+		createZhihuSearchTool,
+		createZhihuGlobalSearchTool,
+		createZhihuHotListTool,
+		createZhihuAskTool,
+		createZhihuKnowledgeSearchTool
+	]) {
+		const tool = create(options);
+		const execute = tool.execute;
+		host.tools.register({
+			...tool,
+			execute: (args, exec) => host.zhihu.run((signal) => execute(args, {
+				...exec,
+				signal
+			}), exec.signal)
+		});
+	}
+}
+//#endregion
+export { apply, inject, name };
+
+//# sourceMappingURL=tools.js.map

package/lib/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","names":[],"sources":["../src/tool-definitions.ts","../src/tools.ts"],"sourcesContent":["import { defineTool } from '@deepseek-ai/dsh-tools'\nimport { reportExecuted, type ZhihuClientOptions } from './zhihu-client.ts'\nimport { ZHIHU_SEARCH_TOOL_NAME, ZHIHU_GLOBAL_SEARCH_TOOL_NAME, ZHIHU_HOT_LIST_TOOL_NAME, ZHIHU_ASK_TOOL_NAME, ZHIHU_KNOWLEDGE_SEARCH_TOOL_NAME } from './contracts.ts'\nimport { executeZhihuSearch, renderZhihuSearch, ZHIHU_SEARCH_DEFAULT_COUNT, ZHIHU_SEARCH_MAX_COUNT, type ZhihuSearchResult } from './search-api.ts'\nimport { ZHIHU_GLOBAL_SEARCH_VERSION, ZHIHU_GLOBAL_SEARCH_DEFAULT_COUNT, ZHIHU_GLOBAL_SEARCH_MAX_COUNT, ZHIHU_HOT_LIST_VERSION, ZHIHU_HOT_LIST_DEFAULT_LIMIT, ZHIHU_HOT_LIST_MAX_LIMIT, ZHIHU_ASK_VERSION, ZHIHU_ASK_TIMEOUT_MS, ZHIHU_KNOWLEDGE_SEARCH_VERSION, ZHIHU_KNOWLEDGE_SEARCH_DEFAULT_LIMIT, ZHIHU_KNOWLEDGE_SEARCH_MAX_LIMIT, ZHIHU_ASK_MODELS, ZhihuAskModel, ZHIHU_ASK_DEFAULT_MODEL, ZhihuToolOptions, ZhihuGlobalSearchDb, ZhihuGlobalSearchResult, executeZhihuGlobalSearch, renderZhihuGlobalSearch, ZhihuHotListItem, ZhihuHotListResult, executeZhihuHotList, renderZhihuHotList, ZhihuAskResult, executeZhihuAsk, renderZhihuAsk, ZhihuKnowledgeItem, ZhihuRecallScope, ZHIHU_RECALL_SCOPES, ZhihuKnowledgeSearchResult, normalizeRecallScopes, executeZhihuKnowledgeSearch, renderZhihuKnowledgeSearch } from './operations.ts'\nexport type CreateZhihuSearchToolOptions = ZhihuClientOptions & {\n  /** Best-effort metering hook; invoked after every execution, failures included. */\n  onExecuted?: (event: { ok: boolean; results: number }) => void\n}\n\nconst SEARCH_ITEM_SCHEMA = {\n  type: 'object',\n  additionalProperties: false,\n  properties: {\n    title: { type: 'string', required: true },\n    type: { type: 'string', required: true },\n    url: { type: 'string', required: true },\n    summary: { type: 'string', required: true },\n    votes: { type: 'integer', required: true },\n    comments: { type: 'integer', required: true },\n    author: { type: 'string', required: true },\n    authority: { type: 'string', required: true },\n    editTime: { type: 'string', required: true },\n  },\n} as const\n\nexport function createZhihuSearchTool(options: CreateZhihuSearchToolOptions = {}) {\n  const { onExecuted, ...client } = options\n  return defineTool({\n    name: ZHIHU_SEARCH_TOOL_NAME,\n    description: '调用知乎开放平台站内搜索（GET /api/v1/content/zhihu_search）拉取社区证据；结果仅作社区/读者反馈参考，不构成 canon，也不直接写入项目文件。',\n    parameters: {\n      query: { type: 'string', required: true, description: '搜索词，2-100 字符。' },\n      count: { type: 'integer', description: `返回条数，1-${ZHIHU_SEARCH_MAX_COUNT}，默认 ${ZHIHU_SEARCH_DEFAULT_COUNT}。` },\n    },\n    output: {\n      schema: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          version: { type: 'integer', required: true },\n          query: { type: 'string', required: true },\n          count: { type: 'integer', required: true },\n          items: {\n            type: 'array',\n            required: true,\n            items: SEARCH_ITEM_SCHEMA,\n          },\n          emptyReason: { type: 'string' },\n        },\n      },\n      render(_args, value) {\n        return [{ type: 'text' as const, text: renderZhihuSearch(value as ZhihuSearchResult) }]\n      },\n    },\n    isConcurrencySafe() { return true },\n    async execute(args, exec) {\n      const typed = args as { query: string; count?: number }\n      try {\n        const result = await executeZhihuSearch(typed.query, typed.count ?? ZHIHU_SEARCH_DEFAULT_COUNT, {\n          ...client,\n          signal: exec.signal,\n        })\n        reportExecuted(onExecuted, { ok: true, results: result.items.length })\n        return result\n      } catch (error) {\n        reportExecuted(onExecuted, { ok: false, results: 0 })\n        throw error\n      }\n    },\n  })\n}\n\nconst OTHER_SEARCH_ITEM_SCHEMA = {\n  type: 'object',\n  additionalProperties: false,\n  properties: {\n    title: { type: 'string', required: true },\n    type: { type: 'string', required: true },\n    url: { type: 'string', required: true },\n    summary: { type: 'string', required: true },\n    votes: { type: 'integer', required: true },\n    comments: { type: 'integer', required: true },\n    author: { type: 'string', required: true },\n    authority: { type: 'string', required: true },\n    editTime: { type: 'string', required: true },\n  },\n} as const\n\n/** 包一层计量:成功报 results,失败报 ok:false 再原样抛出。 */\nasync function metered<T>(onExecuted: ZhihuToolOptions['onExecuted'], run: () => Promise<T>, results: (value: T) => number): Promise<T> {\n  try {\n    const value = await run()\n    reportExecuted(onExecuted, { ok: true, results: results(value) })\n    return value\n  } catch (error) {\n    reportExecuted(onExecuted, { ok: false, results: 0 })\n    throw error\n  }\n}\n\nexport function createZhihuGlobalSearchTool(options: ZhihuToolOptions = {}) {\n  const { onExecuted, ...client } = options\n  return defineTool({\n    name: ZHIHU_GLOBAL_SEARCH_TOOL_NAME,\n    description: '调用知乎开放平台全网搜索（GET /api/v1/content/global_search）检索站外公开网页资料；结果仅作参考，不构成 canon，也不直接写入项目文件。',\n    parameters: {\n      query: { type: 'string', required: true, description: '搜索词，2-100 字符。' },\n      count: { type: 'integer', description: `返回条数，1-${ZHIHU_GLOBAL_SEARCH_MAX_COUNT}，默认 ${ZHIHU_GLOBAL_SEARCH_DEFAULT_COUNT}。` },\n      searchDb: { type: 'string', description: '检索库：all（默认）、realtime（实时）、static（静态）。' },\n    },\n    output: {\n      schema: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          version: { type: 'integer', required: true },\n          query: { type: 'string', required: true },\n          count: { type: 'integer', required: true },\n          searchDb: { type: 'string', required: true },\n          items: { type: 'array', required: true, items: OTHER_SEARCH_ITEM_SCHEMA },\n          emptyReason: { type: 'string' },\n        },\n      },\n      render(_args, value) {\n        return [{ type: 'text' as const, text: renderZhihuGlobalSearch(value as ZhihuGlobalSearchResult) }]\n      },\n    },\n    isConcurrencySafe() { return true },\n    async execute(args, exec) {\n      const typed = args as { query: string; count?: number; searchDb?: string }\n      const searchDb: ZhihuGlobalSearchDb = typed.searchDb === 'realtime' || typed.searchDb === 'static' ? typed.searchDb : 'all'\n      return await metered(onExecuted, () => executeZhihuGlobalSearch(\n        typed.query,\n        typed.count ?? ZHIHU_GLOBAL_SEARCH_DEFAULT_COUNT,\n        searchDb,\n        { ...client, signal: exec.signal },\n      ), (result) => result.items.length)\n    },\n  })\n}\n\nexport function createZhihuHotListTool(options: ZhihuToolOptions = {}) {\n  const { onExecuted, ...client } = options\n  return defineTool({\n    name: ZHIHU_HOT_LIST_TOOL_NAME,\n    description: '拉取知乎热榜（GET /api/v1/content/hot_list）了解当前社区热点；结果仅作题材与热点参考，不构成 canon，也不直接写入项目文件。',\n    parameters: {\n      limit: { type: 'integer', description: `返回条数，1-${ZHIHU_HOT_LIST_MAX_LIMIT}，默认 ${ZHIHU_HOT_LIST_DEFAULT_LIMIT}。` },\n    },\n    output: {\n      schema: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          version: { type: 'integer', required: true },\n          limit: { type: 'integer', required: true },\n          items: {\n            type: 'array',\n            required: true,\n            items: {\n              type: 'object',\n              additionalProperties: false,\n              properties: {\n                title: { type: 'string', required: true },\n                url: { type: 'string', required: true },\n                summary: { type: 'string', required: true },\n              },\n            },\n          },\n        },\n      },\n      render(_args, value) {\n        return [{ type: 'text' as const, text: renderZhihuHotList(value as ZhihuHotListResult) }]\n      },\n    },\n    isConcurrencySafe() { return true },\n    async execute(args, exec) {\n      const typed = args as { limit?: number }\n      return await metered(onExecuted, () => executeZhihuHotList(\n        typed.limit ?? ZHIHU_HOT_LIST_DEFAULT_LIMIT,\n        { ...client, signal: exec.signal },\n      ), (result) => result.items.length)\n    },\n  })\n}\n\nexport function createZhihuAskTool(options: ZhihuToolOptions = {}) {\n  const { onExecuted, ...client } = options\n  return defineTool({\n    name: ZHIHU_ASK_TOOL_NAME,\n    description: '调用知乎直答（POST /v1/chat/completions，OpenAI 兼容）基于知乎社区内容生成综合回答；适合考据与背景调研。结果仅作参考，不构成 canon，也不直接写入项目文件。',\n    parameters: {\n      query: { type: 'string', required: true, description: '要问的问题。' },\n      model: { type: 'string', description: 'zhida-thinking-1p5（默认，带思考过程）、zhida-fast-1p5（快，仅适合简单事实查询）或 zhida-agent（最慢最强，仅在明确要求时使用）。' },\n    },\n    output: {\n      schema: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          version: { type: 'integer', required: true },\n          query: { type: 'string', required: true },\n          model: { type: 'string', required: true },\n          content: { type: 'string', required: true },\n          reasoning: { type: 'string', required: true },\n        },\n      },\n      render(_args, value) {\n        return [{ type: 'text' as const, text: renderZhihuAsk(value as ZhihuAskResult) }]\n      },\n    },\n    isConcurrencySafe() { return true },\n    async execute(args, exec) {\n      const typed = args as { query: string; model?: string }\n      const model: ZhihuAskModel = (ZHIHU_ASK_MODELS as readonly string[]).includes(typed.model ?? '')\n        ? (typed.model as ZhihuAskModel)\n        : ZHIHU_ASK_DEFAULT_MODEL\n      return await metered(onExecuted, () => executeZhihuAsk(\n        typed.query,\n        model,\n        { ...client, signal: exec.signal },\n      ), (result) => (result.content ? 1 : 0))\n    },\n  })\n}\n\nexport function createZhihuKnowledgeSearchTool(options: ZhihuToolOptions = {}) {\n  const { onExecuted, ...client } = options\n  return defineTool({\n    name: ZHIHU_KNOWLEDGE_SEARCH_TOOL_NAME,\n    description: '检索知乎知识库（POST /api/v1/knowledge/search，RAG 片段），默认只查公开库；用户在知乎网页端上传过个人资料后可加 personal/subscription 召回。结果仅作背景参考，不构成 canon，也不直接写入项目文件。',\n    parameters: {\n      query: { type: 'string', required: true, description: '检索词。' },\n      limit: { type: 'integer', description: `返回条数，1-${ZHIHU_KNOWLEDGE_SEARCH_MAX_LIMIT}，默认 ${ZHIHU_KNOWLEDGE_SEARCH_DEFAULT_LIMIT}。` },\n      recallScopes: {\n        type: 'array',\n        description: '召回范围：public（公开库，默认）、personal（个人库）、subscription（订阅库），可多选。',\n        items: { type: 'string', enum: [...ZHIHU_RECALL_SCOPES] },\n      },\n    },\n    output: {\n      schema: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          version: { type: 'integer', required: true },\n          query: { type: 'string', required: true },\n          limit: { type: 'integer', required: true },\n          recallScopes: { type: 'array', required: true, items: { type: 'string' } },\n          items: {\n            type: 'array',\n            required: true,\n            items: {\n              type: 'object',\n              additionalProperties: false,\n              properties: {\n                docName: { type: 'string', required: true },\n                originUrl: { type: 'string', required: true },\n                snippets: { type: 'array', required: true, items: { type: 'string' } },\n              },\n            },\n          },\n        },\n      },\n      render(_args, value) {\n        return [{ type: 'text' as const, text: renderZhihuKnowledgeSearch(value as ZhihuKnowledgeSearchResult) }]\n      },\n    },\n    isConcurrencySafe() { return true },\n    async execute(args, exec) {\n      const typed = args as { query: string; limit?: number; recallScopes?: unknown }\n      return await metered(onExecuted, () => executeZhihuKnowledgeSearch(\n        typed.query,\n        typed.limit ?? ZHIHU_KNOWLEDGE_SEARCH_DEFAULT_LIMIT,\n        normalizeRecallScopes(typed.recallScopes),\n        { ...client, signal: exec.signal },\n      ), (result) => result.items.length)\n    },\n  })\n}\n","import type { Context } from '@deepseek-ai/cordis'\nimport type { ZhihuService } from './index.ts'\nimport { createZhihuSearchTool, createZhihuGlobalSearchTool, createZhihuHotListTool, createZhihuAskTool, createZhihuKnowledgeSearchTool } from './tool-definitions.ts'\nexport const name = 'dsh-zhihu-tools'\nexport const inject = ['zhihu', 'tools'] as const\nexport function apply(ctx: Context): void {\n  const host = ctx as Context & { zhihu: ZhihuService; tools: { register: (tool: unknown) => unknown } }\n  const options = host.zhihu.toolOptions\n  for (const create of [createZhihuSearchTool, createZhihuGlobalSearchTool, createZhihuHotListTool, createZhihuAskTool, createZhihuKnowledgeSearchTool]) {\n    const tool = create(options)\n    const execute = tool.execute as unknown as (args: unknown, exec: { signal: AbortSignal }) => Promise<unknown>\n    host.tools.register({ ...tool, execute: (args: unknown, exec: { signal: AbortSignal }) =>\n      host.zhihu.run(signal => execute(args, { ...exec, signal }), exec.signal) })\n  }\n}\n"],"mappings":"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"}

package/lib/usage.d.ts

@@ -0,0 +1,54 @@
+import { z } from "zod";
+//#region src/usage.d.ts
+declare class UsageInputError extends Error {
+  readonly code: string;
+  constructor(message: string, code: string);
+}
+declare function dayKey(now?: Date): string;
+declare function resolveDays(value: unknown): number;
+declare function recentDayKeys(count: number, now?: Date): string[];
+/** Daily counters for zhihu tool executions (search/global search/hot list/ask/knowledge). `results` accumulates returned items on successful calls. */
+type ZhihuDailyUsage = {
+  date: string;
+  calls: number;
+  failures: number;
+  results: number;
+};
+/** Metering payload emitted by novel tool hosts after each zhihu_search execution. */
+type ZhihuSearchEvent = {
+  ok: boolean;
+  results?: number;
+};
+declare const dailyRowSchema: z.ZodObject<{
+  date: z.ZodString;
+  calls: z.ZodNumber;
+  failures: z.ZodNumber;
+  results: z.ZodNumber;
+}, z.core.$strip>;
+declare const zhihuUsageDomainSpec: {
+  name: string;
+  version: number;
+  tables: {
+    daily: import("@deepseek-ai/dsh-storage-domain").DomainTableSpec<string, {
+      date: string;
+      calls: number;
+      failures: number;
+      results: number;
+    }>;
+  };
+};
+/** Fold one zhihu_search execution into a daily row. */
+declare function mergeZhihuUsage(day: ZhihuDailyUsage | undefined, event: ZhihuSearchEvent): ZhihuDailyUsage;
+interface ZhihuUsageTableLike {
+  get(key: string): z.infer<typeof dailyRowSchema> | undefined;
+  put(key: string, value: z.infer<typeof dailyRowSchema>): Promise<void>;
+}
+interface ZhihuUsageRecorder {
+  record(event: ZhihuSearchEvent): Promise<void>;
+  read(days: number): Promise<ZhihuDailyUsage[]>;
+}
+/** Read-modify-write adapter over a storage-domain table, mirroring `createUsageRecorder`. */
+declare function createZhihuUsageRecorder(table: ZhihuUsageTableLike): ZhihuUsageRecorder;
+//#endregion
+export { UsageInputError, ZhihuDailyUsage, ZhihuSearchEvent, ZhihuUsageRecorder, ZhihuUsageTableLike, createZhihuUsageRecorder, dayKey, mergeZhihuUsage, recentDayKeys, resolveDays, zhihuUsageDomainSpec };
+//# sourceMappingURL=usage.d.ts.map

package/lib/usage.js

@@ -0,0 +1,96 @@
+import { defineDomain, domainTable } from "@deepseek-ai/dsh-storage-domain";
+import { z } from "zod";
+//#region src/usage.ts
+var UsageInputError = class extends Error {
+	code;
+	constructor(message, code) {
+		super(message);
+		this.code = code;
+		this.name = "UsageInputError";
+	}
+};
+function dayKey(now = /* @__PURE__ */ new Date()) {
+	return [
+		now.getFullYear(),
+		String(now.getMonth() + 1).padStart(2, "0"),
+		String(now.getDate()).padStart(2, "0")
+	].join("-");
+}
+function resolveDays(value) {
+	const days = typeof value === "number" && Number.isFinite(value) ? Math.trunc(value) : 30;
+	if (days < 1) throw new UsageInputError("days must be at least 1", "DAYS_OUT_OF_RANGE");
+	if (days > 90) throw new UsageInputError("days must be no more than 90", "DAYS_OUT_OF_RANGE");
+	return days;
+}
+function recentDayKeys(count, now = /* @__PURE__ */ new Date()) {
+	const days = [];
+	const base = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+	for (let offset = count - 1; offset >= 0; offset -= 1) {
+		const cursor = new Date(base);
+		cursor.setDate(base.getDate() - offset);
+		days.push(dayKey(cursor));
+	}
+	return days;
+}
+const dailyRowSchema = z.object({
+	date: z.string(),
+	calls: z.number().int().nonnegative(),
+	failures: z.number().int().nonnegative(),
+	results: z.number().int().nonnegative()
+});
+const zhihuUsageDomainSpec = defineDomain({
+	name: "dsh_editor_zhihu_usage",
+	version: 1,
+	tables: { daily: domainTable(dailyRowSchema) }
+});
+function int(value) {
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.trunc(value) : 0;
+}
+function emptyDay(date) {
+	return {
+		date,
+		calls: 0,
+		failures: 0,
+		results: 0
+	};
+}
+/** Fold one zhihu_search execution into a daily row. */
+function mergeZhihuUsage(day, event) {
+	const next = day ? { ...day } : emptyDay("");
+	next.calls += 1;
+	if (event.ok) next.results += int(event.results);
+	else next.failures += 1;
+	return next;
+}
+/** Read-modify-write adapter over a storage-domain table, mirroring `createUsageRecorder`. */
+function createZhihuUsageRecorder(table) {
+	return {
+		async record(event) {
+			const date = dayKey();
+			let stored;
+			try {
+				stored = table.get(date);
+			} catch {
+				stored = void 0;
+			}
+			const merged = mergeZhihuUsage(stored, event);
+			await table.put(date, {
+				...merged,
+				date
+			});
+		},
+		async read(days) {
+			const keys = recentDayKeys(resolveDays(days));
+			const byDate = /* @__PURE__ */ new Map();
+			for (const key of keys) {
+				const row = table.get(key);
+				if (row) byDate.set(row.date, row);
+			}
+			return keys.map((date) => byDate.get(date) ?? emptyDay(date));
+		}
+	};
+}
+//#endregion
+export { UsageInputError, createZhihuUsageRecorder, dayKey, mergeZhihuUsage, recentDayKeys, resolveDays, zhihuUsageDomainSpec };
+
+//# sourceMappingURL=usage.js.map