@klarkxy/dsh-zhihu 0.1.7 → 0.1.9

package/lib/client.js

@@ -216,18 +216,15 @@ function createZhihuClientState() {
 //#region src/client-styles.ts
 const standaloneOutsideTheme = ":not(.radix-themes *)";
 const zhihuClientStyles = `
-.zhihu-dock {
-  position: var(--dsh-ext-dock-position, absolute);
-  right: var(--dsh-ext-dock-right, var(--space-4, 16px));
-  bottom: var(--dsh-ext-dock-bottom, calc(var(--space-4, 16px) + 44px));
-  pointer-events: auto;
-}
+
 .zhihu-settings-embed {
   font: 400 var(--font-size-2)/1.5 var(--default-font-family);
   color: var(--gray-12);
   display: flex;
   flex-direction: column;
   min-width: 0;
+  width: 100%;
+  max-width: 760px;
   min-height: 0;
   gap: 0;
 }
@@ -238,73 +235,19 @@ const zhihuClientStyles = `
   padding: var(--space-4) 0 0;
   overflow: visible;
 }
-.zhihu-toggle {
-  pointer-events: auto;
-  font: inherit;
-  font-family: var(--default-font-family);
-  font-size: var(--font-size-2);
-  min-height: var(--control-h, 34px);
-  color: var(--gray-11);
-  background: var(--color-panel-solid);
-  border: 1px solid var(--gray-6);
-  border-radius: 999px;
-  padding: 0 14px;
-  cursor: pointer;
-  box-shadow: var(--shadow-3);
-}
-.zhihu-toggle:hover { border-color: var(--accent-9); color: var(--accent-11); background: var(--gray-a3); }
-.zhihu-toggle:focus-visible,
 .zhihu-panel button:focus-visible,
 .zhihu-panel input:focus-visible,
 .zhihu-panel select:focus-visible,
 .zhihu-panel a:focus-visible {
   box-shadow: 0 0 0 2px var(--accent-a8);
 }
-.zhihu-dock .zhihu-panel {
-  position: absolute;
-  top: var(--dsh-ext-panel-top, auto);
-  right: 0;
-  bottom: var(--dsh-ext-panel-bottom, calc(100% + 6px));
-  z-index: 10;
-  width: min(440px, calc(100vw - 32px));
-  max-height: min(72vh, 620px);
-  display: flex;
-  flex-direction: column;
-  pointer-events: auto;
-  font-family: var(--default-font-family);
-  font-size: var(--font-size-2);
-  color: var(--gray-12);
-  background: var(--color-panel-solid);
-  border: 1px solid var(--gray-6);
-  border-radius: var(--radius-3);
-  box-shadow: var(--shadow-4);
-  overflow: hidden;
-}
+
 .zhihu-panel {
   font-family: var(--default-font-family);
   font-size: var(--font-size-2);
   color: var(--gray-12);
   background: var(--color-panel-solid);
 }
-.zhihu-panel-header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  padding: var(--space-2) var(--space-3);
-  border-bottom: 1px solid var(--gray-6);
-}
-.zhihu-panel-title {
-  margin: 0;
-  font-size: var(--font-size-2);
-  font-weight: var(--font-weight-medium);
-  font-family: var(--default-font-family);
-}
-.zhihu-panel-close {
-  font: inherit; font-size: var(--font-size-2); min-height: 32px; color: var(--gray-11); background: none; border: none;
-  border-radius: var(--radius-2); padding: 0 8px; cursor: pointer;
-}
-.zhihu-panel-close:hover { color: var(--gray-12); background: var(--gray-a3); }
-.zhihu-panel-close:disabled { opacity: 0.5; cursor: default; }
 .zhihu-tabs {
   display: inline-flex;
   gap: 2px;
@@ -500,17 +443,13 @@ const zhihuClientStyles = `
 .zhihu-dots i:nth-child(2) { animation-delay: .2s; }
 .zhihu-dots i:nth-child(3) { animation-delay: .4s; }
 @media (prefers-reduced-motion: reduce) {
-  .zhihu-dock, .zhihu-dock *, .zhihu-panel, .zhihu-panel * {
+  .zhihu-panel, .zhihu-panel * {
     animation: none !important; transition: none !important;
     transform: none !important; filter: none !important;
   }
   .zhihu-dots i { animation: none; }
 }
-/* Local tokens when this overlay is not under .radix-themes. Host Theme
-   and --dsh-ext-* rail overrides still win inside the Theme tree. Dark
-   follows body[data-ds-dark-theme] / :root[data-theme=dark], not OS scheme. */
-.zhihu-dock${standaloneOutsideTheme},
-.zhihu-toggle${standaloneOutsideTheme},
+/* Local tokens follow the host theme when the settings page is outside Radix. */
 .zhihu-panel${standaloneOutsideTheme} {
 
   --default-font-family: "Noto Sans SC", "PingFang SC", "Microsoft YaHei UI", system-ui, sans-serif;
@@ -572,11 +511,7 @@ const zhihuClientStyles = `
   --shadow-4: 0 0 0 1px #0000000f, 0 8px 40px rgba(0, 0, 0, 0.05), 0 12px 32px -16px #0000000f;
   color-scheme: light;
 }
-html:not([data-theme]) body[data-ds-dark-theme] .zhihu-dock${standaloneOutsideTheme},
-html:not([data-theme]) body[data-ds-dark-theme] .zhihu-toggle${standaloneOutsideTheme},
 html:not([data-theme]) body[data-ds-dark-theme] .zhihu-panel${standaloneOutsideTheme},
-:root[data-theme="dark"] .zhihu-dock${standaloneOutsideTheme},
-:root[data-theme="dark"] .zhihu-toggle${standaloneOutsideTheme},
 :root[data-theme="dark"] .zhihu-panel${standaloneOutsideTheme} {
 
   --default-font-family: "Noto Sans SC", "PingFang SC", "Microsoft YaHei UI", system-ui, sans-serif;
@@ -661,12 +596,6 @@ function zhihuQueryKeyDown(event, run) {
 		run.search();
 	}
 }
-function dockEscapeKeyDown(event, run) {
-	if (event.key !== "Escape") return;
-	event.stopPropagation();
-	if (run.loading) return;
-	run.close();
-}
 function hostComponentsFromRenderProps(props) {
 	if (!props || typeof props !== "object") return {};
 	const record = props;
@@ -711,10 +640,8 @@ function renderSelect(Select, props, className) {
 		}, option.value === "" ? "__empty" : option.value))
 	});
 }
-//#endregion
-//#region ../dsh-editor-seats/src/seat-button.tsx
-const SeatButton = (0, react.forwardRef)(function SeatButton(props, ref) {
-	const { host, variant, className, ...rest } = props;
+/** Prefer a structurally supplied host control; standalone Web needs no private UI package. */
+const ZhihuButton = (0, react.forwardRef)(function ZhihuButton({ host, variant, className, ...rest }, ref) {
 	if (host) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(host, {
 		ref,
 		variant,
@@ -737,9 +664,9 @@ const inject = [
 	"remote",
 	"remote.credentials"
 ];
-const SLOT_ID = "zhihu";
+const PACKAGE_NAME = "@klarkxy/dsh-zhihu";
 const SLOT_ORDER = 120;
-const SLOT_LABEL = "知乎资料";
+const SLOT_LABEL = "知乎";
 const activityDots = () => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 	className: "zhihu-dots",
 	"aria-hidden": "true",
@@ -1101,7 +1028,7 @@ function SettingsSection(props) {
 	if (state.status === "error") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsShell, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
 		className: "zhihu-error",
 		role: "alert",
-		children: [`读取失败：${state.error} `, /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
+		children: [`读取失败：${state.error} `, /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
 			host: props.Button,
 			className: "zhihu-button",
 			onClick: () => void load(),
@@ -1227,14 +1154,14 @@ function SettingsSection(props) {
 		}) : null,
 		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 			className: "zhihu-row",
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
 				host: props.Button,
 				variant: "danger",
 				className: "zhihu-button zhihu-button-danger",
 				disabled: busy || keyLocked || !configured,
 				onClick: () => void clear(),
 				children: busy ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [activityDots(), "处理中…"] }) : "清除"
-			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
 				host: props.Button,
 				variant: "primary",
 				className: "zhihu-button zhihu-button-primary",
@@ -1480,7 +1407,7 @@ function UsageSection(props) {
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
 			className: "zhihu-error",
 			role: "alert",
-			children: [`读取失败：${state.error} `, /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
+			children: [`读取失败：${state.error} `, /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
 				host: props.Button,
 				className: "zhihu-button",
 				onClick: () => void load(),
@@ -1737,7 +1664,7 @@ function KnowledgeSection(props) {
 			list.status === "error" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
 				className: "zhihu-error",
 				role: "alert",
-				children: [`${list.failure.text} `, list.failure.kind !== "credential" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
+				children: [`${list.failure.text} `, list.failure.kind !== "credential" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
 					host: props.Button,
 					className: "zhihu-button",
 					onClick: () => void load(),
@@ -1766,7 +1693,7 @@ function KnowledgeSection(props) {
 								value: base.id,
 								label: `${base.name}${base.isDefault ? "（默认）" : ""} · ${base.contentCount} 篇`
 							}))]
-						}, "zhihu-select"), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
+						}, "zhihu-select"), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
 							host: props.Button,
 							className: "zhihu-button",
 							disabled: busy,
@@ -1797,7 +1724,7 @@ function KnowledgeSection(props) {
 						disabled: busy,
 						onChange: (event) => setFile(event.target.files?.[0])
 					}, fileKey),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
 						host: props.Button,
 						className: "zhihu-button",
 						disabled: busy,
@@ -1812,7 +1739,7 @@ function KnowledgeSection(props) {
 			}) : null,
 			list.status === "ready" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "zhihu-row",
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
 					host: props.Button,
 					variant: "primary",
 					className: "zhihu-button zhihu-button-primary",
@@ -1840,31 +1767,18 @@ const TAB_LABEL = {
 	usage: "用量",
 	knowledge: "知识库"
 };
-const OVERLAY_TABS = [
-	"search",
-	"settings",
-	"usage",
-	"knowledge"
-];
 const SETTINGS_TABS = [
 	"settings",
 	"usage",
 	"knowledge",
 	"search"
 ];
-function tabLabel(tab, surface) {
-	if (tab === "search" && surface === "settings") return "连接测试";
-	return TAB_LABEL[tab];
-}
-function ZhihuDock(props) {
-	const { rpc, credentials, Select, Dialog, Button, Input } = props;
-	const surface = props.surface === "settings" ? "settings" : "overlay";
-	const tabs = surface === "settings" ? SETTINGS_TABS : OVERLAY_TABS;
+function ZhihuSettings(props) {
+	const { rpc, credentials, Select, Button, Input } = props;
 	const gateRef = (0, react.useRef)(null);
 	if (!gateRef.current) gateRef.current = createZhihuClientState();
 	const gate = gateRef.current;
-	const [open, setOpen] = (0, react.useState)(surface === "settings");
-	const [tab, setTab] = (0, react.useState)(surface === "settings" ? "settings" : "search");
+	const [tab, setTab] = (0, react.useState)("settings");
 	const [query, setQuery] = (0, react.useState)("");
 	const [mode, setMode] = (0, react.useState)("search");
 	const [askModel, setAskModel] = (0, react.useState)("zhida-thinking-1p5");
@@ -1874,23 +1788,7 @@ function ZhihuDock(props) {
 	const [outcome, setOutcome] = (0, react.useState)(null);
 	const [revision, setRevision] = (0, react.useState)(0);
 	const [resultRevision, setResultRevision] = (0, react.useState)(0);
-	const toggleRef = (0, react.useRef)(null);
 	const queryRef = (0, react.useRef)(null);
-	const wasOpen = (0, react.useRef)(false);
-	(0, react.useEffect)(() => {
-		if (Dialog || surface === "settings") return;
-		if (open) {
-			wasOpen.current = true;
-			queryRef.current?.focus();
-		} else if (wasOpen.current) {
-			wasOpen.current = false;
-			toggleRef.current?.focus();
-		}
-	}, [
-		open,
-		Dialog,
-		surface
-	]);
 	(0, react.useEffect)(() => () => gate.cancel(), [gate]);
 	const runSearch = (0, react.useCallback)(async () => {
 		if (mode !== "hot" && !query.trim()) return;
@@ -1980,17 +1878,6 @@ function ZhihuDock(props) {
 		setAskModel(next);
 		resetToIdle();
 	};
-	const closePanel = (0, react.useCallback)(() => {
-		gate.cancel();
-		setPhase("idle");
-		setOpen(false);
-	}, [gate]);
-	const onPanelKeyDown = (event) => {
-		dockEscapeKeyDown(event, {
-			loading: phase === "loading",
-			close: closePanel
-		});
-	};
 	const onQueryKeyDown = (event) => {
 		zhihuQueryKeyDown(event, {
 			disabled: isSearchDisabled(),
@@ -2021,7 +1908,7 @@ function ZhihuDock(props) {
 			buttons[next]?.focus();
 			buttons[next]?.click();
 		},
-		children: tabs.map((key) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
+		children: SETTINGS_TABS.map((key) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
 			host: Button,
 			type: "button",
 			role: "tab",
@@ -2029,7 +1916,7 @@ function ZhihuDock(props) {
 			tabIndex: tab === key ? 0 : -1,
 			className: "zhihu-tab",
 			onClick: () => onTabChange(key),
-			children: tabLabel(key, surface)
+			children: TAB_LABEL[key]
 		}, key))
 	}, "tabs");
 	const body = /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -2063,7 +1950,7 @@ function ZhihuDock(props) {
 						className: "zhihu-scopes",
 						role: "group",
 						"aria-label": "检索范围",
-						children: SCOPE_OPTIONS.map((scope) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
+						children: SCOPE_OPTIONS.map((scope) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
 							host: Button,
 							role: "checkbox",
 							"aria-checked": scopes.includes(scope.value),
@@ -2086,7 +1973,7 @@ function ZhihuDock(props) {
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: "zhihu-row",
-						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
 							host: Button,
 							variant: "primary",
 							className: "zhihu-button zhihu-button-primary",
@@ -2094,7 +1981,7 @@ function ZhihuDock(props) {
 							disabled: searchDisabled,
 							onClick: () => void runSearch(),
 							children: phase === "loading" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [activityDots(), "请求中…"] }) : mode === "hot" ? "获取热榜" : "搜索"
-						}), phase === "loading" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
+						}), phase === "loading" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
 							host: Button,
 							className: "zhihu-button",
 							onClick: () => {
@@ -2104,7 +1991,7 @@ function ZhihuDock(props) {
 							children: "取消"
 						}) : null]
 					}),
-					surface !== "settings" && phase === "idle" && mode !== "hot" && !query.trim() ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					phase === "idle" && mode !== "hot" && !query.trim() ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: "zhihu-status",
 						role: "status",
 						children: "输入关键词后搜索。"
@@ -2141,62 +2028,12 @@ function ZhihuDock(props) {
 			}) : null
 		]
 	}, "body");
-	const inner = [
-		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("header", {
-			className: "zhihu-panel-header",
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
-				className: "zhihu-panel-title",
-				children: "知乎资料"
-			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
-				host: Button,
-				className: "zhihu-panel-close",
-				disabled: phase === "loading",
-				onClick: closePanel,
-				children: "关闭"
-			})]
-		}, "header"),
-		tablist,
-		body
-	];
-	if (surface === "settings") return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-		className: "zhihu-settings-embed",
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+		className: "zhihu-panel zhihu-settings-embed",
 		"data-testid": "zhihu-settings-embed",
 		"aria-label": SLOT_LABEL,
 		children: [tablist, body]
 	});
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-		className: "zhihu-dock",
-		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeatButton, {
-			host: Button,
-			ref: toggleRef,
-			className: "zhihu-toggle",
-			"data-testid": "zhihu-open",
-			onClick: () => setOpen(true),
-			children: SLOT_LABEL
-		}), Dialog ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Dialog, {
-			open,
-			onOpenChange: (next) => {
-				if (!next) closePanel();
-				else setOpen(true);
-			},
-			title: "知乎资料",
-			className: "file-dialog zhihu-panel",
-			overlayClassName: "file-dialog-overlay",
-			dismissible: phase !== "loading",
-			initialFocusRef: queryRef,
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				"data-testid": "zhihu-panel",
-				className: "zhihu-panel-inner",
-				children: inner
-			})
-		}) : open ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("section", {
-			className: "zhihu-panel",
-			"data-testid": "zhihu-panel",
-			"aria-label": "知乎资料",
-			onKeyDown: onPanelKeyDown,
-			children: inner
-		}) : null]
-	});
 }
 function apply(ctx) {
 	ctx.effect(() => {
@@ -2204,33 +2041,17 @@ function apply(ctx) {
 		return () => style?.remove();
 	}, "zhihu.styles");
 	const client = ctx;
-	const overlayRender = (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuDock, {
+	const settingsRender = (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuSettings, {
 		rpc: client.connection.rpc,
 		credentials: wrapCredentials(client.remote.credentials),
-		surface: "overlay",
 		...hostComponentsFromRenderProps(props)
 	});
-	const settingsRender = (props) => {
-		const host = hostComponentsFromRenderProps(props);
-		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuDock, {
-			rpc: client.connection.rpc,
-			credentials: wrapCredentials(client.remote.credentials),
-			surface: "settings",
-			...host
-		});
-	};
-	client.slots.inject("shell.overlay", () => client.slots.register({
-		name: "shell.overlay",
-		id: SLOT_ID,
-		order: SLOT_ORDER,
-		label: SLOT_LABEL
-	}, overlayRender));
-	client.slots.inject("dsh-editor.settings.zhihu", () => client.slots.register({
-		name: "dsh-editor.settings.zhihu",
-		id: SLOT_ID,
+	ctx.effect(() => client.slots.inject("plugins.bundle.config", () => client.slots.register({
+		name: "plugins.bundle.config",
+		key: PACKAGE_NAME,
 		order: SLOT_ORDER,
 		label: SLOT_LABEL
-	}, settingsRender));
+	}, settingsRender)), "zhihu.settings");
 }
 //#endregion
 exports.apply = apply;

package/lib/contracts.d.ts

@@ -18,6 +18,16 @@ type ZhihuRpcResult<T = unknown> = {
     details: Record<string, unknown>;
   };
 };
+declare const ZHIHU_QUESTION_RECOMMENDATIONS_TOOL_NAME = "zhihu_question_recommendations";
+declare const ZHIHU_QUESTION_ANSWERS_TOOL_NAME = "zhihu_question_answers";
+declare const ZHIHU_USER_CONTENT_DETAIL_TOOL_NAME = "zhihu_user_content_detail";
+declare const ZHIHU_USER_CONTENT_COMMENTS_TOOL_NAME = "zhihu_user_content_comments";
+declare const ZHIHU_CREATOR_ACCOUNT_STATS_TOOL_NAME = "zhihu_creator_account_stats";
+declare const ZHIHU_CREATOR_CONTENT_STATS_TOOL_NAME = "zhihu_creator_content_stats";
+declare const ZHIHU_QUOTA_TOOL_NAME = "zhihu_quota";
+/** Official quota IDs, not local execution counters or predicted balances. */
+declare const ZHIHU_QUOTA_IDS: readonly ["global_search", "zhihu_search", "hot_list", "question_answers", "zhida_openai", "tools", "knowledge", "user_data", "creator"];
+type ZhihuQuotaId = typeof ZHIHU_QUOTA_IDS[number];
 //#endregion
-export { ZHIHU_ASK_TOOL_NAME, ZHIHU_CREDENTIAL_REF, ZHIHU_GLOBAL_SEARCH_TOOL_NAME, ZHIHU_HOT_LIST_TOOL_NAME, ZHIHU_KNOWLEDGE_SEARCH_TOOL_NAME, ZHIHU_RPC_CHANNEL, ZHIHU_SEARCH_EVENT, ZHIHU_SEARCH_TOOL_NAME, ZhihuRpcResult };
+export { ZHIHU_ASK_TOOL_NAME, ZHIHU_CREATOR_ACCOUNT_STATS_TOOL_NAME, ZHIHU_CREATOR_CONTENT_STATS_TOOL_NAME, ZHIHU_CREDENTIAL_REF, 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_RPC_CHANNEL, ZHIHU_SEARCH_EVENT, ZHIHU_SEARCH_TOOL_NAME, ZHIHU_USER_CONTENT_COMMENTS_TOOL_NAME, ZHIHU_USER_CONTENT_DETAIL_TOOL_NAME, ZhihuQuotaId, ZhihuRpcResult };
 //# sourceMappingURL=contracts.d.ts.map

package/lib/contracts.js

@@ -7,7 +7,26 @@ const ZHIHU_KNOWLEDGE_SEARCH_TOOL_NAME = "zhihu_knowledge_search";
 const ZHIHU_RPC_CHANNEL = "/zhihu";
 const ZHIHU_CREDENTIAL_REF = "ZHIHU_ACCESS_TOKEN";
 const ZHIHU_SEARCH_EVENT = "dsh-editor/zhihu-search";
+const ZHIHU_QUESTION_RECOMMENDATIONS_TOOL_NAME = "zhihu_question_recommendations";
+const ZHIHU_QUESTION_ANSWERS_TOOL_NAME = "zhihu_question_answers";
+const ZHIHU_USER_CONTENT_DETAIL_TOOL_NAME = "zhihu_user_content_detail";
+const ZHIHU_USER_CONTENT_COMMENTS_TOOL_NAME = "zhihu_user_content_comments";
+const ZHIHU_CREATOR_ACCOUNT_STATS_TOOL_NAME = "zhihu_creator_account_stats";
+const ZHIHU_CREATOR_CONTENT_STATS_TOOL_NAME = "zhihu_creator_content_stats";
+const ZHIHU_QUOTA_TOOL_NAME = "zhihu_quota";
+/** Official quota IDs, not local execution counters or predicted balances. */
+const ZHIHU_QUOTA_IDS = [
+	"global_search",
+	"zhihu_search",
+	"hot_list",
+	"question_answers",
+	"zhida_openai",
+	"tools",
+	"knowledge",
+	"user_data",
+	"creator"
+];
 //#endregion
-export { ZHIHU_ASK_TOOL_NAME, ZHIHU_CREDENTIAL_REF, ZHIHU_GLOBAL_SEARCH_TOOL_NAME, ZHIHU_HOT_LIST_TOOL_NAME, ZHIHU_KNOWLEDGE_SEARCH_TOOL_NAME, ZHIHU_RPC_CHANNEL, ZHIHU_SEARCH_EVENT, ZHIHU_SEARCH_TOOL_NAME };
+export { ZHIHU_ASK_TOOL_NAME, ZHIHU_CREATOR_ACCOUNT_STATS_TOOL_NAME, ZHIHU_CREATOR_CONTENT_STATS_TOOL_NAME, ZHIHU_CREDENTIAL_REF, 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_RPC_CHANNEL, ZHIHU_SEARCH_EVENT, ZHIHU_SEARCH_TOOL_NAME, ZHIHU_USER_CONTENT_COMMENTS_TOOL_NAME, ZHIHU_USER_CONTENT_DETAIL_TOOL_NAME };
 
 //# sourceMappingURL=contracts.js.map

package/lib/contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.js","names":[],"sources":["../src/contracts.ts"],"sourcesContent":["export const ZHIHU_SEARCH_TOOL_NAME = 'zhihu_search'\nexport const ZHIHU_GLOBAL_SEARCH_TOOL_NAME = 'zhihu_global_search'\nexport const ZHIHU_HOT_LIST_TOOL_NAME = 'zhihu_hot_list'\nexport const ZHIHU_ASK_TOOL_NAME = 'zhihu_ask'\nexport const ZHIHU_KNOWLEDGE_SEARCH_TOOL_NAME = 'zhihu_knowledge_search'\nexport const ZHIHU_RPC_CHANNEL = '/zhihu'\nexport const ZHIHU_CREDENTIAL_REF = 'ZHIHU_ACCESS_TOKEN'\nexport const ZHIHU_SEARCH_EVENT = 'dsh-editor/zhihu-search'\nexport type ZhihuRpcResult<T = unknown> = { ok: true; value: T } | { ok: false; error: { code: string; message: string; details: Record<string, unknown> } }\n"],"mappings":";AAAA,MAAa,yBAAyB;AACtC,MAAa,gCAAgC;AAC7C,MAAa,2BAA2B;AACxC,MAAa,sBAAsB;AACnC,MAAa,mCAAmC;AAChD,MAAa,oBAAoB;AACjC,MAAa,uBAAuB;AACpC,MAAa,qBAAqB"}
+{"version":3,"file":"contracts.js","names":[],"sources":["../src/contracts.ts"],"sourcesContent":["export const ZHIHU_SEARCH_TOOL_NAME = 'zhihu_search'\nexport const ZHIHU_GLOBAL_SEARCH_TOOL_NAME = 'zhihu_global_search'\nexport const ZHIHU_HOT_LIST_TOOL_NAME = 'zhihu_hot_list'\nexport const ZHIHU_ASK_TOOL_NAME = 'zhihu_ask'\nexport const ZHIHU_KNOWLEDGE_SEARCH_TOOL_NAME = 'zhihu_knowledge_search'\nexport const ZHIHU_RPC_CHANNEL = '/zhihu'\nexport const ZHIHU_CREDENTIAL_REF = 'ZHIHU_ACCESS_TOKEN'\nexport const ZHIHU_SEARCH_EVENT = 'dsh-editor/zhihu-search'\nexport type ZhihuRpcResult<T = unknown> = { ok: true; value: T } | { ok: false; error: { code: string; message: string; details: Record<string, unknown> } }\n\nexport const ZHIHU_QUESTION_RECOMMENDATIONS_TOOL_NAME = 'zhihu_question_recommendations'\nexport const ZHIHU_QUESTION_ANSWERS_TOOL_NAME = 'zhihu_question_answers'\nexport const ZHIHU_USER_CONTENT_DETAIL_TOOL_NAME = 'zhihu_user_content_detail'\nexport const ZHIHU_USER_CONTENT_COMMENTS_TOOL_NAME = 'zhihu_user_content_comments'\nexport const ZHIHU_CREATOR_ACCOUNT_STATS_TOOL_NAME = 'zhihu_creator_account_stats'\nexport const ZHIHU_CREATOR_CONTENT_STATS_TOOL_NAME = 'zhihu_creator_content_stats'\nexport const ZHIHU_QUOTA_TOOL_NAME = 'zhihu_quota'\n\n/** Official quota IDs, not local execution counters or predicted balances. */\nexport const ZHIHU_QUOTA_IDS = [\n  'global_search', 'zhihu_search', 'hot_list', 'question_answers',\n  'zhida_openai', 'tools', 'knowledge', 'user_data', 'creator',\n] as const\nexport type ZhihuQuotaId = typeof ZHIHU_QUOTA_IDS[number]\n"],"mappings":";AAAA,MAAa,yBAAyB;AACtC,MAAa,gCAAgC;AAC7C,MAAa,2BAA2B;AACxC,MAAa,sBAAsB;AACnC,MAAa,mCAAmC;AAChD,MAAa,oBAAoB;AACjC,MAAa,uBAAuB;AACpC,MAAa,qBAAqB;AAGlC,MAAa,2CAA2C;AACxD,MAAa,mCAAmC;AAChD,MAAa,sCAAsC;AACnD,MAAa,wCAAwC;AACrD,MAAa,wCAAwC;AACrD,MAAa,wCAAwC;AACrD,MAAa,wBAAwB;;AAGrC,MAAa,kBAAkB;CAC7B;CAAiB;CAAgB;CAAY;CAC7C;CAAgB;CAAS;CAAa;CAAa;AACrD"}

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-import { ZhihuRpcResult } from "./contracts.js";
+import { ZhihuQuotaId, ZhihuRpcResult } from "./contracts.js";
 import { ZhihuUsageRecorder } from "./usage.js";
 import { Context } from "@deepseek-ai/cordis";
 //#region src/zhihu-client.d.ts
@@ -10,6 +10,9 @@ type ZhihuSearchFetcher = (input: string, init?: {
 }) => Promise<{
   ok: boolean;
   status: number;
+  headers?: {
+    get(name: string): string | null;
+  };
   text(): Promise<string>;
   json(): Promise<unknown>;
 }>;
@@ -21,6 +24,7 @@ type ZhihuSearchResolveOptions = {
 type ZhihuSearchExecuted = {
   ok: boolean;
   results: number;
+  quotaId?: ZhihuQuotaId;
 };
 type ZhihuClientOptions = ZhihuSearchResolveOptions & {
   fetcher?: ZhihuSearchFetcher;

package/lib/index.js

@@ -1,4 +1,4 @@
-import { _ as reportExecuted, a as executeZhihuGlobalSearch, c as normalizeRecallScopes, g as parseZhihuEnvelope, h as ZhihuSearchError, i as executeZhihuAsk, n as ZHIHU_ASK_MODELS, o as executeZhihuHotList, p as executeZhihuSearch, s as executeZhihuKnowledgeSearch, t as ZHIHU_ASK_DEFAULT_MODEL, v as zhihuFetchJson } from "./operations.js";
+import { S as zhihuFetchJson, _ as executeZhihuSearch, a as ZHIHU_ASK_DEFAULT_MODEL, b as parseZhihuEnvelope, c as executeZhihuAsk, d as executeZhihuKnowledgeSearch, f as normalizeRecallScopes, i as zhihuOpenPlatformResultCount, l as executeZhihuGlobalSearch, n as executeZhihuOpenPlatform, o as ZHIHU_ASK_MODELS, r as resolveZhihuOpenPlatformOperation, t as ZHIHU_OPEN_PLATFORM_APIS, u as executeZhihuHotList, x as reportExecuted, y as ZhihuSearchError } from "./open-platform.js";
 import { ZHIHU_CREDENTIAL_REF, ZHIHU_RPC_CHANNEL, ZHIHU_SEARCH_EVENT } from "./contracts.js";
 import { createZhihuUsageRecorder, resolveDays, zhihuUsageDomainSpec } from "./usage.js";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
@@ -305,12 +305,12 @@ const inject = [
 	"storageDomain",
 	"webServer"
 ];
-const fail = (code, message) => ({
+const fail = (code, message, details = {}) => ({
 	ok: false,
 	error: {
 		code,
 		message,
-		details: {}
+		details
 	}
 });
 /** One shared service for direct UI RPC and optional Tool wrappers. */
@@ -350,6 +350,9 @@ function createZhihuService(options, usage, notify = () => {}) {
 				signal
 			};
 			let counted = false;
+			const operation = resolveZhihuOpenPlatformOperation(endpoint);
+			const quotaId = operation ? ZHIHU_OPEN_PLATFORM_APIS[operation].quotaId : void 0;
+			const metering = quotaId ? { quotaId } : {};
 			try {
 				if (endpoint === "usage.summary") {
 					await pendingUsage;
@@ -368,7 +371,12 @@ function createZhihuService(options, usage, notify = () => {}) {
 				let value;
 				let results = 0;
 				counted = true;
-				if (endpoint === "search") {
+				if (operation) {
+					counted = operation !== "quota";
+					const result = await executeZhihuOpenPlatform(operation, payload === void 0 ? {} : payload, client);
+					value = result;
+					results = zhihuOpenPlatformResultCount(result);
+				} else if (endpoint === "search") {
 					const result = await executeZhihuSearch(query, typeof body.count === "number" ? body.count : 5, client);
 					value = result;
 					results = result.items.length;
@@ -406,9 +414,10 @@ function createZhihuService(options, usage, notify = () => {}) {
 					counted = false;
 					return fail("bad-request", `unknown endpoint ${endpoint}`);
 				}
-				record({
+				if (counted) record({
 					ok: true,
-					results
+					results,
+					...metering
 				});
 				return {
 					ok: true,
@@ -417,11 +426,21 @@ function createZhihuService(options, usage, notify = () => {}) {
 			} catch (error) {
 				if (counted) record({
 					ok: false,
-					results: 0
+					results: 0,
+					...metering
 				});
 				if (signal.aborted) return fail("cancelled", "请求已取消");
 				const code = error instanceof ZhihuSearchError ? error.code.toLowerCase().replaceAll("_", "-") : "internal";
-				return fail(code, error instanceof Error ? error.message : "知乎请求失败");
+				const details = {};
+				if (error instanceof ZhihuSearchError) {
+					for (const key of [
+						"status",
+						"upstreamCode",
+						"retryAfter",
+						"retryable"
+					]) if (error[key] !== void 0) details[key] = error[key];
+				}
+				return fail(code, error instanceof Error ? error.message : "知乎请求失败", details);
 			}
 		}
 	};