@klarkxy/dsh-zhihu 0.2.7 → 0.2.9

package/README.md

@@ -4,7 +4,7 @@
 
 [简体中文](docs/README.zh-CN.md)
 
-Use Zhihu as a research source for the model: site search, web search, hot list, Zhida answers, knowledge bases, question discovery, and creator statistics. Every request uses your own Zhihu Access Secret; results are reference material, not conclusions.
+Use Zhihu as a research source for the model: site search, web search, hot list, Zhida answers, knowledge bases, question discovery, and creator statistics. The `zhihu_sync` tool also saves and validates article, question, or pin drafts and uploads images. Every request uses your own Zhihu Access Secret; results are reference material, not conclusions.
 
 ## Install
 
@@ -25,6 +25,10 @@ Open **Plugins → Zhihu** and enter your Access Secret under **Settings**. Othe
 
 With the Web Search plugin installed, Zhihu web search also appears in its provider list.
 
+## Drafts and media
+
+In **Plugins → Zhihu → Settings**, configure the publishing App Key and App Secret obtained from the [Zhihu publishing assistant](https://www.zhihu.com/playground/zhihu-publisher). These are separate from the search Access Secret. Zhihu’s authorization text can be pasted into the App Secret field when both credentials appear as `ZHIHU_OPENAPI_APP_KEY:"…"` and `ZHIHU_OPENAPI_APP_SECRET:"…"`; the plugin then keeps those two values only. The `zhihu_sync` tool then lets the model save, list, read, and validate drafts for articles, questions, or pins, and upload images for them. Drafts persist across DSH restarts. This version has no publishing interface: neither the model nor the plugin UI can publish a draft.
+
 ## Give the tools to the model
 
 These model tools are enabled by default; no agent preset changes needed:
@@ -38,10 +42,13 @@ These model tools are enabled by default; no agent preset changes needed:
 | `zhihu_user_content_detail`, `zhihu_user_content_comments` | Read your published content and its comments |
 | `zhihu_creator_account_stats`, `zhihu_creator_content_stats` | Your creator statistics |
 | `zhihu_quota` | Check official quota |
+| `zhihu_sync` | Save, list, read, and validate drafts or upload images |
+
+Site search and web search return an empty list when nothing matches, with an explanation when the service provides one.
 
 ## Cost protection
 
-By default the plugin uses only Zhihu's free allowance: before each request it checks the official quota and skips the request if none is left. It also stops after 100 requests per day (Beijing time). Both are configurable:
+By default research requests use only Zhihu's free allowance: before each request the plugin checks the official quota and skips the request if none is left. It also stops after 100 requests per day (Beijing time). Both are configurable:
 
 ```yaml
 config:
@@ -54,9 +61,11 @@ Paid use is allowed only when you set `allowPaid: true` yourself.
 ## Limits
 
 - Zero cost is not guaranteed: other clients on the same account can use up the free allowance first.
-- Uploaded files are stored on Zhihu's servers; do not upload unpublished manuscripts. Each file is limited to 20 MB.
+- Knowledge-base uploads are stored on Zhihu's servers and limited to 20 MB per file. Draft images are also uploaded to Zhihu.
+- Drafts support articles, questions, and pins, not answers or videos. Supported images: JPEG, PNG, GIF, WebP, and BMP; GIF is limited to 15 MB and other images to 30 MB. Convert HEIC/AVIF before uploading.
+- Draft and image operations use Zhihu's publishing authorization; search quota and paid-search settings do not govern them.
 - Requests are never retried automatically.
-- Not included: OAuth account switching, top-ups, or wallet queries.
+- Not included: publishing drafts, OAuth account switching, top-ups, or wallet queries.
 
 ## License
 

package/docs/README.zh-CN.md

@@ -4,7 +4,7 @@
 
 [English](../README.md)
 
-把知乎交给模型当调研信源：站内搜索、全网搜索、热榜、知乎直答、知识库、问题发现和创作数据。每次请求只用你自己的知乎 Access Secret；结果是参考资料，不是定论。
+把知乎交给模型当调研信源：站内搜索、全网搜索、热榜、知乎直答、知识库、问题发现和创作数据。`zhihu_sync` 工具还可以保存、校验文章、提问或想法草稿并上传配图。每次请求只用你自己的知乎 Access Secret；结果是参考资料，不是定论。
 
 ## 安装
 
@@ -25,6 +25,10 @@ dsh plugin --profile web add @klarkxy/dsh-zhihu
 
 安装网页搜索插件后，「知乎全网搜索」也会出现在它的服务列表中。
 
+## 草稿与配图
+
+在「插件 → 知乎 → 设置」填写发布用 App Key 和 App Secret，可从[知乎同步助手](https://www.zhihu.com/playground/zhihu-publisher)申请；它们与检索 Access Secret 分开配置。知乎的授权说明可以整段粘进 App Secret 输入框，条件是两项凭据都写成 `ZHIHU_OPENAPI_APP_KEY:"…"` 与 `ZHIHU_OPENAPI_APP_SECRET:"…"` 的形式；插件只保存其中的两项凭据。`zhihu_sync` 工具随后可让模型保存、列出、读取并校验文章、提问或想法草稿，并为其上传配图；草稿在重启 DSH 后仍可继续处理。本版本没有发布入口：模型与插件界面都不能发布草稿。
+
 ## 让模型使用
 
 以下模型工具默认启用，无需修改 Agent 预设：
@@ -38,10 +42,13 @@ dsh plugin --profile web add @klarkxy/dsh-zhihu
 | `zhihu_user_content_detail`、`zhihu_user_content_comments` | 读取自己已发布的内容及评论 |
 | `zhihu_creator_account_stats`、`zhihu_creator_content_stats` | 自己的创作数据 |
 | `zhihu_quota` | 查询官方额度 |
+| `zhihu_sync` | 保存、列出、读取并校验草稿，上传配图 |
+
+站内搜索和全网搜索没有匹配内容时返回空列表；服务提供原因时会一并显示。
 
 ## 费用保护
 
-默认只用知乎的免费额度：每次请求前先查官方额度，额度不足就不发送。另外每天（北京时间）最多 100 次请求。两项都可在插件配置中修改：
+检索与创作查询默认只用知乎的免费额度：每次请求前先查官方额度，额度不足就不发送。另外每天（北京时间）最多 100 次请求。两项都可在插件配置中修改：
 
 ```yaml
 config:
@@ -54,9 +61,11 @@ config:
 ## 限制
 
 - 不能保证绝对零费用：同一账号的其他客户端可能先用掉免费额度。
-- 上传的文件保存在知乎云端，请勿上传未发表手稿；单个文件最大 20 MB。
+- 知识库文件保存在知乎云端，单个文件最大 20 MB；草稿配图也会上传到知乎。
+- 草稿支持文章、提问和想法，不支持回答或视频。图片支持 JPEG、PNG、GIF、WebP、BMP；GIF 最大 15 MB，其他图片最大 30 MB。HEIC/AVIF 请先转换格式。
+- 草稿与图片操作使用知乎提供的发布授权；搜索额度与付费搜索开关不控制它们。
 - 所有请求都不会自动重试。
-- 不提供 OAuth 账号切换、充值或钱包查询。
+- 不提供草稿发布、OAuth 账号切换、充值或钱包查询。
 
 ## 许可证
 

package/lib/client.js

@@ -1723,6 +1723,358 @@ function ZhihuQuotaSection({ rpc }) {
 	});
 }
 //#endregion
+//#region src/client-sync-credentials.tsx
+/**
+* 知乎发布助手的应用凭据设置。
+*
+* 只有插件设置页（plugins.bundle.config）里才有这段表单：右侧栏工作台不发凭据，
+* 也不重复提供入口。凭据本身由宿主管理（remote.credentials），插件只读写引用。
+*/
+const ZHIHU_APP_KEY_REF = "ZHIHU_OPENAPI_APP_KEY";
+const ZHIHU_APP_SECRET_REF = "ZHIHU_OPENAPI_APP_SECRET";
+/** 申请发布助手应用凭据的官方入口。 */
+const ZHIHU_PUBLISHER_URL = "https://www.zhihu.com/playground/zhihu-publisher";
+/** 成对保存时的挂起标记；它与凭据引用名不同，不会撞上字段的「保存中…」。 */
+const PAIR_PENDING = "pair";
+const GRANT_KEY = /ZHIHU_OPENAPI_APP_KEY\s*[:=]\s*"([^"\r\n]+)"/;
+const GRANT_SECRET = /ZHIHU_OPENAPI_APP_SECRET\s*[:=]\s*"([^"\r\n]+)"/;
+const GRANT_MARKER = /ZHIHU_OPENAPI_APP_(?:KEY|SECRET)/;
+/**
+* 知乎发布助手把授权说明和两项凭据放在同一段文字里。只在两项都用引号写出时拆开；
+* 单独粘贴的 Key 或 Secret 保持原样，避免把普通文本误存成另一项。
+*/
+function parseZhihuPublisherGrant(value) {
+	const key = GRANT_KEY.exec(value);
+	const secret = GRANT_SECRET.exec(value);
+	if (!key || !secret) return null;
+	const appKey = key[1].trim();
+	const appSecret = secret[1].trim();
+	if (!appKey || !appSecret || appKey === appSecret) return null;
+	return {
+		appKey,
+		appSecret
+	};
+}
+/**
+* 文字里出现了凭据标记，但没能按受支持的格式读出两项凭据。这样的文本不能当凭据存：
+* 整段授权说明一旦落进密钥框，格式稍有出入就会变成一个坏凭据，而且要到发布时才报错。
+*/
+function looksLikeZhihuPublisherGrant(value) {
+	return GRANT_MARKER.test(value);
+}
+const FIELD_COPY = [{
+	ref: ZHIHU_APP_SECRET_REF,
+	label: "App Secret",
+	zh: "知乎发布助手的应用密钥",
+	en: "Publisher app secret",
+	hintZh: "知乎发布助手签发的应用密钥。整段授权说明粘贴在这里时，下面会自动填入用户名。",
+	hintEn: "The app secret issued by the Zhihu publisher. Pasting the authorization text here fills in the username below."
+}, {
+	ref: ZHIHU_APP_KEY_REF,
+	label: "App Key",
+	zh: "知乎主页用户名",
+	en: "Profile username",
+	hintZh: "知乎个人主页地址里的用户名，例如 www.zhihu.com/people/<你的用户名>。这不是密钥，以明文显示。",
+	hintEn: "The username in your Zhihu profile URL, e.g. www.zhihu.com/people/<your username>. This is not a secret and is shown in plain text.",
+	plain: true
+}];
+/** 只有 http(s) 可以成为链接；其余一律降级为文本。 */
+function safeUrl$1(url) {
+	return /^https?:\/\//i.test(url) ? url : null;
+}
+function PublisherLink(props) {
+	const url = safeUrl$1(props.url);
+	if (!url) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: props.children });
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
+		className: "zhihu-link",
+		href: url,
+		target: "_blank",
+		rel: "noreferrer noopener",
+		children: props.children
+	});
+}
+function ZhihuSyncCredentials(props) {
+	const t = useT();
+	const { credentials } = props;
+	const alive = (0, react.useRef)(false);
+	const [state, setState] = (0, react.useState)({ status: "loading" });
+	const [drafts, setDrafts] = (0, react.useState)({});
+	const [paired, setPaired] = (0, react.useState)(false);
+	const [pending, setPending] = (0, react.useState)(null);
+	const [confirmRef, setConfirmRef] = (0, react.useState)(null);
+	const [failure, setFailure] = (0, react.useState)("");
+	const [note, setNote] = (0, react.useState)("");
+	const views = state.status === "ready" ? state.credentials : {};
+	const writable = (ref) => views[ref]?.writable !== false;
+	(0, react.useEffect)(() => {
+		alive.current = true;
+		return () => {
+			alive.current = false;
+		};
+	}, []);
+	const load = (0, react.useCallback)(async () => {
+		setState((current) => current.status === "ready" ? current : { status: "loading" });
+		try {
+			const result = await credentials.describe({ refs: FIELD_COPY.map((field) => field.ref) });
+			if (!alive.current) return;
+			if (!result.ok) {
+				setState({
+					status: "error",
+					error: result.error.message
+				});
+				return;
+			}
+			setState({
+				status: "ready",
+				credentials: result.value.credentials
+			});
+		} catch (cause) {
+			if (!alive.current) return;
+			setState({
+				status: "error",
+				error: cause instanceof Error ? cause.message : String(cause)
+			});
+		}
+	}, [credentials]);
+	(0, react.useEffect)(() => {
+		load();
+	}, [load]);
+	const save = async (refs) => {
+		if (pending !== null) return;
+		const writes = refs.map((ref) => ({
+			ref,
+			value: (drafts[ref] ?? "").trim()
+		})).filter((item) => item.value && writable(item.ref));
+		if (!writes.length) return;
+		setPending(refs.length > 1 ? PAIR_PENDING : refs[0]);
+		setFailure("");
+		setNote("");
+		try {
+			for (const write of writes) {
+				const result = await credentials.set(write);
+				if (!alive.current) return;
+				if (!result.ok) {
+					setFailure(result.error.message);
+					return;
+				}
+			}
+			setDrafts((current) => {
+				const next = { ...current };
+				for (const write of writes) delete next[write.ref];
+				return next;
+			});
+			setPaired(false);
+			setNote(writes.length > 1 ? ["已保存用户名与密钥。", "Saved the username and the secret."] : ["已保存。", "Saved."]);
+			await load();
+		} catch (cause) {
+			if (!alive.current) return;
+			setFailure(cause instanceof Error ? cause.message : String(cause));
+		} finally {
+			if (alive.current) setPending(null);
+		}
+	};
+	const clear = async (ref) => {
+		setConfirmRef(null);
+		if (pending !== null) return;
+		setPending(ref);
+		setFailure("");
+		setNote("");
+		try {
+			const result = await credentials.unset({ ref });
+			if (!alive.current) return;
+			if (!result.ok) {
+				setFailure(result.error.message);
+				return;
+			}
+			setDrafts((current) => ({
+				...current,
+				[ref]: ""
+			}));
+			setPaired(false);
+			setNote(["已清除。", "Cleared."]);
+			await load();
+		} catch (cause) {
+			if (!alive.current) return;
+			setFailure(cause instanceof Error ? cause.message : String(cause));
+		} finally {
+			if (alive.current) setPending(null);
+		}
+	};
+	if (state.status === "loading") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("section", {
+		className: "dsh-ui-stack",
+		"aria-label": t("知乎发布助手凭据", "Zhihu publisher credentials"),
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+			className: "dsh-ui-loading",
+			role: "status",
+			children: t("正在读取凭据状态…", "Loading credential status…")
+		})
+	});
+	if (state.status === "error") return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+		className: "dsh-ui-stack",
+		"aria-label": t("知乎发布助手凭据", "Zhihu publisher credentials"),
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+			className: "dsh-ui-error",
+			role: "alert",
+			children: clientText(state.error, t)
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: "dsh-ui-actions",
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
+				onClick: () => void load(),
+				children: t("重试", "Retry")
+			})
+		})]
+	});
+	const confirmed = confirmRef ? FIELD_COPY.find((field) => field.ref === confirmRef) : void 0;
+	const pairReady = paired && (drafts["ZHIHU_OPENAPI_APP_KEY"] ?? "").trim() !== "" && (drafts["ZHIHU_OPENAPI_APP_SECRET"] ?? "").trim() !== "";
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+		className: "dsh-ui-stack",
+		"aria-label": t("知乎发布助手凭据", "Zhihu publisher credentials"),
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h4", {
+				className: "dsh-ui-heading",
+				children: t("知乎发布助手", "Zhihu publisher")
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+				className: "dsh-ui-help",
+				children: [
+					t("发布助手使用另一组应用凭据，与搜索用的 Access Secret 无关。把知乎给出的授权说明粘贴到上面的密钥框即可，两项凭据要写成 ZHIHU_OPENAPI_APP_KEY:\"…\" 与 ZHIHU_OPENAPI_APP_SECRET:\"…\" 的形式，用户名会自动填到下面。", "The publisher uses its own app credentials, separate from the search Access Secret. Paste Zhihu’s authorization text into the secret field above — both credentials must be written as ZHIHU_OPENAPI_APP_KEY:\"…\" and ZHIHU_OPENAPI_APP_SECRET:\"…\" — and the username fills in below."),
+					" ",
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(PublisherLink, {
+						url: ZHIHU_PUBLISHER_URL,
+						children: t("申请凭据", "Get credentials")
+					})
+				]
+			}),
+			paired ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "dsh-ui-hint",
+				children: t("这两项来自同一段授权说明，可以一起保存。", "These two came from the same authorization text and can be saved together.")
+			}) : null,
+			FIELD_COPY.map((field) => {
+				const view = state.credentials[field.ref];
+				const locked = view?.writable === false;
+				const configured = view?.configured === true;
+				const draft = drafts[field.ref] ?? "";
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dsh-ui-field",
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dsh-ui-label-row",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "dsh-ui-label",
+								id: `zhihu-sync-cred-${field.ref}`,
+								children: field.label
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "dsh-ui-row",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: locked ? "warning" : configured ? "done" : "idle" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "dsh-ui-meta",
+									children: locked ? t("由环境变量提供（只读）", "Provided by an environment variable (read-only)") : configured ? t("已保存", "Saved") : t("未配置", "Not set")
+								})]
+							})]
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: "dsh-ui-hint",
+							children: t(field.hintZh, field.hintEn)
+						}),
+						renderInput({
+							type: field.plain ? "text" : "password",
+							value: draft,
+							disabled: locked || pending !== null,
+							"aria-label": field.label,
+							"aria-describedby": `zhihu-sync-cred-${field.ref}`,
+							placeholder: locked ? t("由环境变量提供", "Set by an environment variable") : t("粘贴凭据", "Paste the credential"),
+							onChange: (value) => {
+								const grant = parseZhihuPublisherGrant(value);
+								if (grant) {
+									const next = {};
+									if (writable("ZHIHU_OPENAPI_APP_KEY")) next[ZHIHU_APP_KEY_REF] = grant.appKey;
+									if (writable("ZHIHU_OPENAPI_APP_SECRET")) next[ZHIHU_APP_SECRET_REF] = grant.appSecret;
+									setDrafts((current) => ({
+										...current,
+										...next
+									}));
+									setPaired(true);
+									setFailure("");
+									setNote(Object.keys(next).length === 2 ? ["已从授权说明读出用户名与密钥。", "Read the username and the secret from the authorization text."] : ["已从授权说明读出一项凭据；另一项当前是只读的，不会被改动。", "Read one credential from the authorization text; the other is read-only and is left alone."]);
+									return;
+								}
+								if (looksLikeZhihuPublisherGrant(value)) {
+									setFailure(["这段文字里有知乎凭据标记，但没能读出 App Key 与 App Secret。请确认两项都写成 ZHIHU_OPENAPI_APP_KEY:\"…\" 与 ZHIHU_OPENAPI_APP_SECRET:\"…\" 的形式。", "This text contains Zhihu credential markers, but no App Key and App Secret could be read from it. Both must be written as ZHIHU_OPENAPI_APP_KEY:\"…\" and ZHIHU_OPENAPI_APP_SECRET:\"…\"."]);
+									setNote("");
+									return;
+								}
+								setDrafts((current) => ({
+									...current,
+									[field.ref]: value
+								}));
+								if (!value.trim()) setPaired(false);
+								setFailure("");
+								setNote("");
+							}
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dsh-ui-actions",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
+								variant: "primary",
+								disabled: locked || pending !== null || draft.trim() === "",
+								onClick: () => void save([field.ref]),
+								children: pending === field.ref ? t("保存中…", "Saving…") : t("保存", "Save")
+							}), locked ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
+								variant: "danger",
+								disabled: pending !== null || !configured,
+								onClick: () => setConfirmRef(field.ref),
+								children: pending === field.ref ? t("清除中…", "Clearing…") : t("清除", "Clear")
+							})]
+						})
+					]
+				}, field.ref);
+			}),
+			pairReady ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "dsh-ui-actions",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
+					variant: "primary",
+					disabled: pending !== null,
+					onClick: () => void save([ZHIHU_APP_KEY_REF, ZHIHU_APP_SECRET_REF]),
+					children: pending === PAIR_PENDING ? t("保存中…", "Saving…") : t("保存两项", "Save both")
+				})
+			}) : null,
+			note ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "dsh-ui-notice",
+				role: "status",
+				children: clientText(note, t)
+			}) : null,
+			failure ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "dsh-ui-error",
+				role: "alert",
+				children: clientText(failure, t)
+			}) : null,
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Modal, {
+				open: confirmed !== void 0,
+				onClose: () => setConfirmRef(null),
+				title: t("清除发布助手凭据？", "Clear the publisher credentials?"),
+				closeLabel: t("关闭", "Close"),
+				className: "zhihu-panel",
+				footer: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dsh-ui-actions",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
+						onClick: () => setConfirmRef(null),
+						children: t("取消", "Cancel")
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
+						variant: "danger",
+						onClick: () => {
+							if (confirmed) clear(confirmed.ref);
+						},
+						children: t("清除", "Clear")
+					})]
+				}),
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "dsh-ui-help",
+					children: t("清除后，发布与预览会失败，直到重新填写凭据。", "Publishing and previewing fail until you enter the credentials again.")
+				})
+			})
+		]
+	});
+}
+//#endregion
 //#region src/client.tsx
 const name = "dsh-zhihu-client";
 const inject = [
@@ -3226,7 +3578,11 @@ function ZhihuSettings(props) {
 		"aria-label": t("知乎", "Zhihu"),
 		children: [
 			tablist,
-			panel("settings", /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsSection, { credentials }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuCallPolicySection, { rpc })] })),
+			panel("settings", /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsSection, { credentials }),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuSyncCredentials, { credentials }),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuCallPolicySection, { rpc })
+			] })),
 			panel("usage", /* @__PURE__ */ (0, react_jsx_runtime.jsx)(UsageSection, { rpc })),
 			panel("quota", /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuQuotaSection, { rpc })),
 			panel("knowledge", /* @__PURE__ */ (0, react_jsx_runtime.jsx)(KnowledgeSection, { rpc })),

package/lib/index.d.ts

@@ -58,6 +58,7 @@ type ZhihuService = {
   toolOptions: ZhihuClientOptions & {
     onExecuted: (event: ZhihuSearchExecuted) => void;
   };
+  syncCall?: (endpoint: string, payload: unknown, signal: AbortSignal, caller: 'ui' | 'tool') => Promise<unknown>;
 };
 /** One shared service for direct UI RPC and optional Tool wrappers. */
 declare function createZhihuService(options: ZhihuClientOptions, usage: ZhihuUsageRecorder, notify?: (event: ZhihuSearchExecuted) => void): ZhihuService;