@klarkxy/dsh-zhihu 0.1.10 → 0.2.1

package/lib/client.js

@@ -1,168 +1,7 @@
-function __createDshNodeShims() {
-  class EventEmitter {
-    constructor() {
-      this._e = Object.create(null)
-    }
-    on(type, fn) {
-      (this._e[type] ||= []).push(fn)
-      return this
-    }
-    addListener(type, fn) {
-      return this.on(type, fn)
-    }
-    once(type, fn) {
-      const wrap = (...args) => {
-        this.off(type, wrap)
-        fn(...args)
-      }
-      return this.on(type, wrap)
-    }
-    off(type, fn) {
-      const list = this._e[type]
-      if (list) this._e[type] = list.filter((item) => item !== fn)
-      return this
-    }
-    removeListener(type, fn) {
-      return this.off(type, fn)
-    }
-    emit(type, ...args) {
-      const list = this._e[type]
-      if (!list) return false
-      for (const fn of list.slice()) fn(...args)
-      return true
-    }
-    removeAllListeners(type) {
-      if (type) delete this._e[type]
-      else this._e = Object.create(null)
-      return this
-    }
-    listeners(type) {
-      return (this._e[type] || []).slice()
-    }
-    setMaxListeners() {
-      return this
-    }
-  }
-
-  class Buffer extends Uint8Array {
-    static from(value, encodingOrOffset, length) {
-      if (typeof value === 'string') return new Buffer(new TextEncoder().encode(value))
-      if (value instanceof ArrayBuffer) return new Buffer(new Uint8Array(value, encodingOrOffset, length))
-      if (ArrayBuffer.isView(value)) return new Buffer(new Uint8Array(value.buffer, value.byteOffset, value.byteLength))
-      if (Array.isArray(value) || value && typeof value.length === 'number') return new Buffer(Uint8Array.from(value))
-      return new Buffer(0)
-    }
-    static alloc(size, fill) {
-      const buf = new Buffer(size)
-      if (fill !== undefined && fill !== 0) {
-        if (typeof fill === 'string') {
-          const bytes = new TextEncoder().encode(fill)
-          for (let i = 0; i < size; i += 1) buf[i] = bytes[i % bytes.length]
-        } else buf.fill(fill)
-      }
-      return buf
-    }
-    static allocUnsafe(size) {
-      return new Buffer(size)
-    }
-    static allocUnsafeSlow(size) {
-      return new Buffer(size)
-    }
-    static concat(list, totalLength) {
-      const length = totalLength ?? list.reduce((sum, item) => sum + item.length, 0)
-      const out = new Buffer(length)
-      let offset = 0
-      for (const item of list) {
-        out.set(item, offset)
-        offset += item.length
-      }
-      return out
-    }
-    static isBuffer(value) {
-      return value instanceof Buffer
-    }
-    static byteLength(value) {
-      if (typeof value === 'string') return new TextEncoder().encode(value).length
-      return value?.byteLength ?? value?.length ?? 0
-    }
-    static isEncoding(encoding) {
-      return /^(utf8|utf-8|ascii|latin1|binary|hex|base64|base64url)$/i.test(String(encoding || ''))
-    }
-    toString(encoding) {
-      if (encoding === 'hex') return [...this].map((byte) => byte.toString(16).padStart(2, '0')).join('')
-      if (encoding === 'base64') {
-        let binary = ''
-        this.forEach((byte) => {
-          binary += String.fromCharCode(byte)
-        })
-        return btoa(binary)
-      }
-      return new TextDecoder().decode(this)
-    }
-    slice(start, end) {
-      return Buffer.from(super.subarray(start, end))
-    }
-    copy(target, targetStart = 0, start = 0, end = this.length) {
-      const sliced = this.subarray(start, end)
-      target.set(sliced, targetStart)
-      return sliced.length
-    }
-    write(string, offset = 0) {
-      const bytes = new TextEncoder().encode(string)
-      const written = Math.min(bytes.length, this.length - offset)
-      this.set(bytes.subarray(0, written), offset)
-      return written
-    }
-  }
-
-  function inherits(ctor, superCtor) {
-    ctor.super_ = superCtor
-    ctor.prototype = Object.create(superCtor.prototype, {
-      constructor: { value: ctor, writable: true, configurable: true },
-    })
-  }
-
-  if (!globalThis.Buffer) globalThis.Buffer = Buffer
-
-  return {
-    buffer: { Buffer, SlowBuffer: Buffer, INSPECT_MAX_BYTES: 50, kMaxLength: 0x7fffffff },
-    stream: {
-      Stream: EventEmitter,
-      Readable: EventEmitter,
-      Writable: EventEmitter,
-      Duplex: EventEmitter,
-      Transform: EventEmitter,
-      PassThrough: EventEmitter,
-    },
-    events: { EventEmitter },
-    util: {
-      deprecate(fn) {
-        return fn
-      },
-      inherits,
-      inspect() {
-        return ''
-      },
-      format(value) {
-        return String(value)
-      },
-      types: { isBuffer: Buffer.isBuffer },
-    },
-  }
-}
-
 window.__ModuleLoader__.load({
   id: "@klarkxy/dsh-zhihu",
   factory: (dshRequire) => {
-    var __nodeShims;
-    var process = globalThis.process || { env: {}, nextTick: function (fn) { var args = [].slice.call(arguments, 1); queueMicrotask(function () { fn.apply(null, args); }); } };
-    var require = function (id) {
-      if (id === 'buffer' || id === 'stream' || id === 'util' || id === 'events') {
-        if (!__nodeShims) __nodeShims = __createDshNodeShims();
-        return __nodeShims[id];
-      }
-      return dshRequire(id);
-    };
+    var require = dshRequire;
     var module = { exports: {} };
     var exports = module.exports;
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
@@ -170,6 +9,92 @@ let react = require("react");
 let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 let react_jsx_runtime = require("react/jsx-runtime");
 //#region src/client-locale.ts
+const responseErrors = {
+	"RPC 返回格式无效。": "Invalid RPC response format.",
+	"开放平台响应格式无效。": "Invalid Open Platform response format.",
+	"响应额度项无效。": "Invalid quota item in the response.",
+	"分页响应格式无效。": "Invalid paging response format.",
+	"请求已取消": "Request cancelled",
+	"查询不超过 4000 字符": "The query must be non-empty and no longer than 4,000 characters",
+	"缺少文件内容。": "File content is missing.",
+	"文件内容无效或超过 20 MB": "File content is invalid or exceeds 20 MB",
+	"搜索词不能为空。": "Search keywords cannot be empty.",
+	"知识库文件名不能为空。": "The knowledge base file name cannot be empty.",
+	"知识库文件名不能包含控制字符。": "The knowledge base file name cannot contain control characters.",
+	"知识库文件名不能超过 255 个 UTF-8 字节。": "The knowledge base file name cannot exceed 255 UTF-8 bytes.",
+	"知识库文件内容不能为空。": "The knowledge base file content cannot be empty.",
+	"知识库文件大小不能超过 20MB。": "The knowledge base file cannot exceed 20 MB.",
+	"当前环境没有可用的 fetch。": "No fetch implementation is available in this environment.",
+	"知乎响应缺少 {Code,Message,Data} 信封。": "The Zhihu response has no {Code,Message,Data} envelope.",
+	"知乎响应缺少有效的 Code 字段。": "The Zhihu response has no valid Code field.",
+	"知乎直答响应不是 OpenAI 兼容格式。": "The Zhihu direct answer response is not in an OpenAI-compatible format.",
+	"知乎直答返回为空。": "The Zhihu direct answer response is empty.",
+	"分页信息不完整：缺少有效的 Paging.IsEnd，请停止翻页。": "Paging is incomplete: no valid Paging.IsEnd. Stop paging.",
+	"分页信息不完整：NextOffset 缺失、无效或未前进，请停止翻页；不要按条数计算偏移。": "Paging is incomplete: NextOffset is missing, invalid or did not advance. Stop paging; do not calculate an offset from item counts.",
+	"只允许请求知乎开放平台。": "Only Zhihu Open Platform requests are allowed.",
+	"参数必须是对象。": "Parameters must be an object.",
+	"这些接口仅使用当前 Access Secret，不接受 token 参数或 OAuth 身份切换。": "These APIs use the current Access Secret only; token parameters and OAuth identity switching are not supported.",
+	"offset 超出 Int64 范围。": "offset exceeds the Int64 range.",
+	"questionUrl 不能为空。": "questionUrl cannot be empty.",
+	"contentUrl 不能为空。": "contentUrl cannot be empty.",
+	"知乎链接不能包含空白、控制字符或反斜线。": "Zhihu links cannot contain whitespace, control characters or backslashes.",
+	"不是有效的知乎 URL。": "Invalid Zhihu URL.",
+	"必须使用无账号密码、无非标准端口的 HTTPS 知乎链接。": "Use an HTTPS Zhihu link without credentials or a non-standard port.",
+	"questionUrl 仅支持 https://www.zhihu.com/question/{id}。": "questionUrl only supports https://www.zhihu.com/question/{id}.",
+	"contentUrl 仅支持知乎回答、专栏文章、想法或视频链接。": "contentUrl only supports Zhihu answer, article, pin or video links.",
+	"startDate 与 endDate 必须同时提供或同时省略。": "Provide both startDate and endDate, or omit both.",
+	"endDate 不得早于 startDate。": "endDate cannot be before startDate.",
+	"主题关键词不能为空；省略 query 才会按画像推荐。": "Topic keywords cannot be empty; omit query to get profile-based recommendations.",
+	"contentType 必须是 all、answer、article、pin 或 zvideo。": "contentType must be all, answer, article, pin or zvideo.",
+	"apiIds 包含未知官方额度项。": "apiIds contains unknown official quota items.",
+	"order 必须是 score、reverse 或 ascending。": "order must be score, reverse or ascending."
+};
+const operationLabels = {
+	"知乎搜索": "Zhihu search",
+	"知乎全网搜索": "Zhihu web search",
+	"知乎热榜": "Zhihu trending",
+	"知乎直答": "Zhihu direct answer",
+	"知乎知识库列表": "Zhihu knowledge base list",
+	"知乎知识库检索": "Zhihu knowledge base search",
+	"知乎知识库上传": "Zhihu knowledge base upload",
+	"适合回答的问题": "Questions to answer",
+	"问题回答摘要": "Answer summaries",
+	"本人创作全文": "My full content",
+	"本人创作评论": "Comments on my content",
+	"账号创作数据": "Account creator stats",
+	"单篇创作数据": "Per-post creator stats",
+	"官方每日额度": "Official daily quota"
+};
+function diagnosticText(text, t) {
+	if (responseErrors[text]) return t(text, responseErrors[text]);
+	const upstream = text.match(/^知乎开放平台返回错误（code=(\d+)）：(.*)$/s);
+	if (upstream) return t(text, `Zhihu Open Platform returned an error (code=${upstream[1]}): ${upstream[2]}`);
+	const blocked = text.match(/^知乎开放平台被风控拒绝：(.*)。请不要立即重试。$/s);
+	if (blocked) return t(text, `Zhihu Open Platform rejected the request through risk control: ${blocked[1]}. Do not retry immediately.`);
+	for (const [label, english] of Object.entries(operationLabels)) {
+		if (!text.startsWith(label)) continue;
+		const detail = text.slice(label.length);
+		const http = detail.match(/^返回 HTTP (\d{3})。$/);
+		if (http) return t(text, `${english} returned HTTP ${http[1]}.`);
+		const timeout = detail.match(/^超时（(\d+) 秒），请稍后再试。$/);
+		if (timeout) return t(text, `${english} timed out (${timeout[1]} seconds). Try again later.`);
+		if (detail === "响应不是合法 JSON。") return t(text, `${english} did not return valid JSON.`);
+		if (detail === "的 Data 必须是 JSON 对象。") return t(text, `${english} Data must be a JSON object.`);
+		if (detail.startsWith("失败：")) return t(text, `${english} failed: ${detail.slice(3)}`);
+		if (detail.startsWith("返回错误：")) return t(text, `${english} returned an error: ${detail.slice(5)}`);
+	}
+	return text;
+}
+function clientText(text, t) {
+	if (typeof text !== "string") return t(text[0], text[1]);
+	const separator = text.indexOf("：");
+	if (separator > 0 && /^[a-z-]+$/.test(text.slice(0, separator))) {
+		const code = text.slice(0, separator);
+		if (code === "token-missing") return t("未配置有效的知乎 Access Secret，请到设置页配置。", "A valid Zhihu Access Secret is missing. Configure it on the Settings tab.");
+		return `${code}: ${diagnosticText(text.slice(separator + 1), t)}`;
+	}
+	return diagnosticText(text, t);
+}
 function zhihuLocale(value) {
 	return String(value ?? "zh").startsWith("zh") ? "zh" : "en";
 }
@@ -203,13 +128,14 @@ const ZHIHU_QUOTA_IDS = [
 	"global_search",
 	"zhihu_search",
 	"hot_list",
-	"question_answers",
+	"question_discovery",
 	"zhida_openai",
 	"tools",
 	"knowledge",
 	"user_data",
 	"creator"
 ];
+const normalizeZhihuQuotaId = (value) => value === "question_answers" ? "question_discovery" : value;
 //#endregion
 //#region src/client-state.ts
 /**
@@ -548,7 +474,7 @@ ${scope} {
   border: 0.5px solid var(--dsw-alias-border-l3);
   border-radius: var(--dsw-radius-md);
   background: var(--dsw-alias-bg-layer-1);
-  font-family: var(--ds-font-family-code, ui-monospace, 'Cascadia Mono', Consolas, monospace);
+  font-family: var(--ds-font-family-code);
   font-size: 12px;
   line-height: 20px;
   color: var(--dsw-alias-label-secondary);
@@ -847,38 +773,14 @@ function zhihuQueryKeyDown(event, run) {
 		run.search();
 	}
 }
-function hostComponentsFromRenderProps(props) {
-	if (!props || typeof props !== "object") return {};
-	const record = props;
-	const sources = [record];
-	if (record.owner && typeof record.owner === "object") sources.push(record.owner);
-	let Select;
-	let Dialog;
-	let Button;
-	let Input;
-	for (const source of sources) {
-		if (typeof source.Select === "function") Select = source.Select;
-		if (typeof source.Dialog === "function") Dialog = source.Dialog;
-		if (typeof source.Button === "function") Button = source.Button;
-		if (typeof source.Input === "function") Input = source.Input;
-	}
-	return {
-		Select,
-		Dialog,
-		Button,
-		Input
-	};
-}
-function renderInput(Input, props) {
-	if (Input) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Input, { ...props });
-	const { onChange, ref, ...rest } = props;
+function renderInput(props) {
+	const { onChange, ...rest } = props;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Input, {
 		...rest,
 		onChange: (event) => onChange(event.target.value)
 	});
 }
-function renderSelect(Select, props, className) {
-	if (Select) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Select, { ...props });
+function renderSelect(props, className = "dsh-ui-select") {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
 		id: props.id,
 		className,
@@ -892,28 +794,14 @@ function renderSelect(Select, props, className) {
 		}, option.value === "" ? "__empty" : option.value))
 	});
 }
-/**
-* The host's own Button still wins whenever the slot supplies one, so a page
-* rendered inside DSH keeps the surrounding chrome. Standalone there is no host
-* to defer to, and the plugin renders the official primitive instead of a
-* hand-rolled `<button>`: the two legacy variant names the call sites use are
-* mapped onto it here. `danger` has no primitive variant, so it keeps the
-* outlined appearance and takes its tone from a class in the plugin stylesheet
-* — the way every other destructive action in the host reads.
-*/
+/** Map existing plugin variants onto the injected official Button. */
 const BUTTON_VARIANT = {
 	default: "outline",
 	primary: "primary",
 	danger: "outline",
 	icon: "ghost"
 };
-const ZhihuButton = (0, react.forwardRef)(function ZhihuButton({ host, variant, className, ...rest }, ref) {
-	if (host) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(host, {
-		ref,
-		variant,
-		className,
-		...rest
-	});
+const ZhihuButton = (0, react.forwardRef)(function ZhihuButton({ variant, className, ...rest }, ref) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
 		ref,
 		variant: BUTTON_VARIANT[variant ?? "default"],
@@ -956,7 +844,7 @@ const OPERATION_COPY = [
 	},
 	{
 		value: "quota",
-		zh: "官方每日额度",
+		zh: "官方每日免费额度",
 		en: "Official daily quota"
 	}
 ];
@@ -1062,6 +950,10 @@ function buildOpenPlatformParams(operation, form, t = translator()) {
 		}
 	}
 	if (operation === "quota") {
+		if (Array.isArray(form.apiIds)) form = {
+			...form,
+			apiIds: form.apiIds.map((value) => normalizeZhihuQuotaId(value))
+		};
 		if (!Array.isArray(form.apiIds) || form.apiIds.some((id) => !ZHIHU_QUOTA_IDS.includes(id))) throw new Error(t("包含未知的额度项。", "Contains an unknown quota item."));
 		if (form.apiIds.length) params.apiIds = [...new Set(form.apiIds)];
 	}
@@ -1081,9 +973,12 @@ function parseOpenPlatformResponse(operation, raw) {
 	}
 	const value = raw.value;
 	if (!isRecord(value) || value.version !== 1 || value.operation !== operation || !isRecord(value.data) || !jsonValue(value.data)) throw new Error("开放平台响应格式无效。");
-	if (value.quotaId !== void 0 && !ZHIHU_QUOTA_IDS.includes(value.quotaId)) throw new Error("响应额度项无效。");
+	if (value.quotaId !== void 0 && !ZHIHU_QUOTA_IDS.includes(normalizeZhihuQuotaId(value.quotaId))) throw new Error("响应额度项无效。");
 	if (value.paging !== void 0 && (!isRecord(value.paging) || typeof value.paging.canContinue !== "boolean" || value.paging.isEnd !== void 0 && typeof value.paging.isEnd !== "boolean" || value.paging.warning !== void 0 && typeof value.paging.warning !== "string")) throw new Error("分页响应格式无效。");
-	return value;
+	return {
+		...value,
+		...value.quotaId === void 0 ? {} : { quotaId: normalizeZhihuQuotaId(value.quotaId) }
+	};
 }
 function openPlatformNextOffset(result, currentOffset) {
 	if (!result || !["question.answers", "content.comments"].includes(result.operation) || result.paging?.canContinue !== true || result.paging.isEnd === true) return null;
@@ -1102,7 +997,7 @@ async function requestOpenPlatform(rpc, state, operation, params, publish) {
 		if (state.isCurrent(ticket)) publish({ error: error instanceof Error ? error.message : String(error) });
 	}
 }
-function ZhihuOpenPlatformSection({ rpc, Button, Input, Select, quotaOnly = false, selectedOperation }) {
+function ZhihuOpenPlatformSection({ rpc, quotaOnly = false, selectedOperation }) {
 	const t = useT();
 	const [operation, setOperation] = (0, react.useState)(quotaOnly ? "quota" : "question.recommendations");
 	const [form, setForm] = (0, react.useState)(createOpenPlatformForm);
@@ -1153,7 +1048,7 @@ function ZhihuOpenPlatformSection({ rpc, Button, Input, Select, quotaOnly = fals
 					className: "dsh-ui-label",
 					children: label
 				}),
-				renderInput(Input, {
+				renderInput({
 					value: form[key],
 					onChange: (value) => change(key, value),
 					"aria-label": label,
@@ -1176,7 +1071,7 @@ function ZhihuOpenPlatformSection({ rpc, Button, Input, Select, quotaOnly = fals
 				className: "dsh-ui-label",
 				children: label
 			}),
-			renderSelect(Select, {
+			renderSelect({
 				value: form[key],
 				onChange: (value) => change(key, value),
 				"aria-label": label,
@@ -1195,9 +1090,17 @@ function ZhihuOpenPlatformSection({ rpc, Button, Input, Select, quotaOnly = fals
 			offset
 		};
 		try {
-			params = buildOpenPlatformParams(activeOperation, nextForm, t);
-		} catch (cause) {
-			setError(cause instanceof Error ? cause.message : String(cause));
+			params = buildOpenPlatformParams(activeOperation, nextForm);
+		} catch {
+			const message = (locale) => {
+				try {
+					buildOpenPlatformParams(activeOperation, nextForm, translator(locale));
+					return "";
+				} catch (cause) {
+					return cause instanceof Error ? cause.message : String(cause);
+				}
+			};
+			setError([message("zh"), message("en")]);
 			return;
 		}
 		if (offset !== void 0) setForm(nextForm);
@@ -1215,7 +1118,7 @@ function ZhihuOpenPlatformSection({ rpc, Button, Input, Select, quotaOnly = fals
 	const paged = activeOperation === "question.answers" || activeOperation === "content.comments";
 	const dated = activeOperation === "creator.account.stats" || activeOperation === "creator.content.stats";
 	const options = openPlatformOptions(t);
-	const title = quotaOnly ? t("官方每日额度", "Official daily quota") : t("问题与创作", "Questions and creator");
+	const title = quotaOnly ? t("官方每日免费额度", "Official daily quota") : t("问题与创作", "Questions and creator");
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 		className: "zhihu-open-platform dsh-ui-stack",
 		"aria-label": title,
@@ -1228,7 +1131,7 @@ function ZhihuOpenPlatformSection({ rpc, Button, Input, Select, quotaOnly = fals
 				className: "dsh-ui-help",
 				children: quotaOnly ? t("查询知乎返回的官方额度，不推算余额。", "Shows the quota Zhihu reports; no balance is inferred.") : t("手动触发，不自动翻页或重试。", "Manual trigger only; no automatic paging or retry.")
 			}),
-			!quotaOnly && selectedOperation === void 0 && renderSelect(Select, {
+			!quotaOnly && selectedOperation === void 0 && renderSelect({
 				value: activeOperation,
 				options,
 				"aria-label": t("开放平台操作", "Open Platform operation"),
@@ -1317,23 +1220,20 @@ function ZhihuOpenPlatformSection({ rpc, Button, Input, Select, quotaOnly = fals
 				className: "dsh-ui-actions",
 				children: [
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-						host: Button,
 						variant: "primary",
 						disabled: loading,
 						onClick: () => run(),
 						children: activeOperation === "quota" ? t("查询官方额度", "Check quota") : t("执行请求", "Run request")
 					}),
 					loading && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-						host: Button,
 						onClick: () => {
 							state.cancel();
 							setLoading(false);
-							setError(t("已取消；晚到的结果将被丢弃。", "Cancelled; a late response will be discarded."));
+							setError(["已取消；晚到的结果将被丢弃。", "Cancelled; a late response will be discarded."]);
 						},
 						children: t("取消请求", "Cancel")
 					}),
 					nextOffset !== null && !loading && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-						host: Button,
 						onClick: () => run(nextOffset),
 						children: t("下一页", "Next page")
 					})
@@ -1347,7 +1247,7 @@ function ZhihuOpenPlatformSection({ rpc, Button, Input, Select, quotaOnly = fals
 			error && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 				className: "dsh-ui-error",
 				role: "alert",
-				children: error
+				children: clientText(error, t)
 			}),
 			result && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "dsh-ui-stack",
@@ -1362,7 +1262,7 @@ function ZhihuOpenPlatformSection({ rpc, Button, Input, Select, quotaOnly = fals
 					}),
 					result.paging?.warning && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						className: "dsh-ui-banner",
-						children: result.paging.warning
+						children: clientText(result.paging.warning, t)
 					}),
 					!stale && paged && result.paging?.canContinue && nextOffset === null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						className: "dsh-ui-banner",
@@ -1395,6 +1295,52 @@ function OpenPlatformDetails({ quotaOnly }) {
 	});
 }
 //#endregion
+//#region src/client-call-policy.tsx
+function ZhihuCallPolicySummary({ policy }) {
+	const t = useT();
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+		className: "dsh-ui-help",
+		children: t(`${policy.allowPaid ? "已显式允许付费" : "仅使用免费额度"} · 每日上限 ${policy.dailyCallLimit} 次（北京时间）`, `${policy.allowPaid ? "Paid calls explicitly enabled" : "Free allowance only"} · ${policy.dailyCallLimit} calls per Beijing day`)
+	});
+}
+function ZhihuCallPolicySection({ rpc }) {
+	const t = useT();
+	const [policy, setPolicy] = (0, react.useState)(null);
+	const [failed, setFailed] = (0, react.useState)(false);
+	(0, react.useEffect)(() => {
+		let alive = true;
+		rpc.call(ZHIHU_RPC_CHANNEL, "policy.status", {}).then((result) => {
+			if (!alive) return;
+			const value = result;
+			if (value?.ok && typeof value.value?.allowPaid === "boolean" && typeof value.value.dailyCallLimit === "number") setPolicy(value.value);
+			else setFailed(true);
+		}, () => {
+			if (alive) setFailed(true);
+		});
+		return () => {
+			alive = false;
+		};
+	}, [rpc]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+		className: "dsh-ui-stack",
+		"aria-label": t("调用保护", "Call protection"),
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h4", {
+				className: "dsh-ui-heading",
+				children: t("调用保护", "Call protection")
+			}),
+			policy ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuCallPolicySummary, { policy }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "dsh-ui-help",
+				children: failed ? t("保护配置不可用；请检查插件配置。", "Protection settings unavailable. Check plugin configuration.") : t("读取保护配置…", "Loading protection settings…")
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "dsh-ui-hint",
+				children: t("付费须在插件配置显式启用。未确认计费的能力仅允许使用已确认的免费额度。本地保护无法排除同账号其他客户端竞争导致的扣费；调用统计不是账单。", "Enable paid calls explicitly in plugin configuration. Unpriced capabilities require verified free allowance. Other clients on the same account can still cause charges; local counts are not billing.")
+			})
+		]
+	});
+}
+//#endregion
 //#region src/client-quota.tsx
 const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 const identityFields = /* @__PURE__ */ new Set([
@@ -1669,7 +1615,7 @@ function QuotaCharts({ data }) {
 		]
 	});
 }
-function ZhihuQuotaSection({ rpc, Button }) {
+function ZhihuQuotaSection({ rpc }) {
 	const state = (0, react.useRef)(createZhihuClientState()).current;
 	const [snapshot, setSnapshot] = (0, react.useState)(null);
 	const [loading, setLoading] = (0, react.useState)(false);
@@ -1698,7 +1644,7 @@ function ZhihuQuotaSection({ rpc, Button }) {
 		refresh();
 		return () => state.cancel();
 	}, [refresh, state]);
-	const title = t("官方额度用量", "Official quota");
+	const title = t("官方免费额度用量", "Official quota");
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 		className: "dsh-ui-stack",
 		"aria-label": title,
@@ -1718,17 +1664,15 @@ function ZhihuQuotaSection({ rpc, Button }) {
 			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "dsh-ui-actions",
 				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-					host: Button,
 					variant: "primary",
 					disabled: loading,
 					onClick: refresh,
 					children: t("刷新官方额度", "Refresh quota")
 				}), loading && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-					host: Button,
 					onClick: () => {
 						state.cancel();
 						setLoading(false);
-						setError(t("已取消；晚到的结果将被丢弃。", "Cancelled; a late response will be discarded."));
+						setError(["已取消；晚到的结果将被丢弃。", "Cancelled; a late response will be discarded."]);
 					},
 					children: t("取消请求", "Cancel")
 				})]
@@ -1741,7 +1685,7 @@ function ZhihuQuotaSection({ rpc, Button }) {
 			error && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 				className: "dsh-ui-error",
 				role: "alert",
-				children: error
+				children: clientText(error, t)
 			}),
 			snapshot && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "dsh-ui-stack",
@@ -1772,7 +1716,6 @@ const inject = [
 ];
 const PACKAGE_NAME = "@klarkxy/dsh-zhihu";
 const SLOT_ORDER = 120;
-const SLOT_LABEL = "知乎";
 const activityDots = () => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 	className: "zhihu-dots",
 	"aria-hidden": "true",
@@ -1812,21 +1755,21 @@ function safeUrl(url) {
 	return /^https?:\/\//i.test(url) ? url : null;
 }
 /** Credential absence and transport failure read differently from a plain bad request. */
-function failureOf(code, message, t = translator()) {
+function failureOf(code, message) {
 	if (code === "token-missing") return {
 		kind: "credential",
-		text: t("未配置知乎 Access Secret 或凭证不可用，请到「设置」页配置。", "Zhihu Access Secret is missing or unavailable. Set it on the Settings tab.")
+		text: ["未配置知乎 Access Secret 或凭证不可用，请到「设置」页配置。", "Zhihu Access Secret is missing or unavailable. Set it on the Settings tab."]
 	};
 	return {
 		kind: "request",
-		text: t(`请求失败：${message}`, `Request failed: ${message}`)
+		text: [`请求失败：${clientText(message, translator("zh"))}`, `Request failed: ${clientText(message, translator("en"))}`]
 	};
 }
-function networkFailure(cause, t = translator()) {
+function networkFailure(cause) {
 	const detail = cause instanceof Error ? cause.message : String(cause);
 	return {
 		kind: "network",
-		text: t(`网络或连接失败：${detail}`, `Network or connection failed: ${detail}`)
+		text: [`网络或连接失败：${detail}`, `Network or connection failed: ${detail}`]
 	};
 }
 /**
@@ -1879,10 +1822,10 @@ function testOptions(t) {
 	})), ...openPlatformOptions(t).filter((option) => option.value !== "quota")];
 }
 const TEST_OPTIONS = testOptions(translator("zh"));
-function ZhihuTestSelector({ value, onChange, Select }) {
+function ZhihuTestSelector({ value, onChange }) {
 	const t = useT();
 	const options = testOptions(t);
-	return renderSelect(Select, {
+	return renderSelect({
 		"aria-label": t("测试功能", "Feature to test"),
 		value,
 		options,
@@ -2216,11 +2159,10 @@ function SettingsSection(props) {
 	if (state.status === "error") return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(SettingsShell, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 		className: "dsh-ui-error",
 		role: "alert",
-		children: t(`读取失败：${state.error}`, `Could not load: ${state.error}`)
+		children: t(`读取失败：${clientText(state.error, t)}`, `Could not load: ${clientText(state.error, t)}`)
 	}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 		className: "dsh-ui-actions",
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-			host: props.Button,
 			onClick: () => void load(),
 			children: t("重试", "Retry")
 		})
@@ -2249,7 +2191,7 @@ function SettingsSection(props) {
 				return;
 			}
 			setKeyDraft("");
-			setNote(t("已保存。", "Saved."));
+			setNote(["已保存。", "Saved."]);
 			await load();
 		} catch (cause) {
 			if (!alive.current) return;
@@ -2272,7 +2214,7 @@ function SettingsSection(props) {
 				return;
 			}
 			setKeyDraft("");
-			setNote(t("已清除。", "Cleared."));
+			setNote(["已清除。", "Cleared."]);
 			await load();
 		} catch (cause) {
 			if (!alive.current) return;
@@ -2303,7 +2245,7 @@ function SettingsSection(props) {
 						children: t("获取密钥", "Get a key")
 					})]
 				}),
-				renderInput(props.Input, {
+				renderInput({
 					type: "password",
 					className: "zhihu-input",
 					value: keyDraft,
@@ -2322,24 +2264,22 @@ function SettingsSection(props) {
 		failure !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 			className: "dsh-ui-error",
 			role: "alert",
-			children: failure
+			children: clientText(failure, t)
 		}) : null,
 		note !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 			className: "dsh-ui-notice",
 			role: "status",
-			children: note
+			children: clientText(note, t)
 		}) : null,
 		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 			className: "dsh-ui-actions",
 			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-				host: props.Button,
 				variant: "danger",
 				className: "zhihu-button-danger",
 				disabled: busy || keyLocked || !configured,
 				onClick: () => setConfirmClear(true),
 				children: pending === "clear" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [activityDots(), t("清除中…", "Clearing…")] }) : t("清除", "Clear")
 			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-				host: props.Button,
 				variant: "primary",
 				disabled: busy || keyLocked || keyValue.length === 0 || draftFailure !== void 0,
 				onClick: () => void save(),
@@ -2355,11 +2295,9 @@ function SettingsSection(props) {
 			footer: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "dsh-ui-actions",
 				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-					host: props.Button,
 					onClick: () => setConfirmClear(false),
 					children: t("取消", "Cancel")
 				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-					host: props.Button,
 					variant: "danger",
 					className: "zhihu-button-danger",
 					onClick: () => void clear(),
@@ -2595,7 +2533,7 @@ function UsageSection(props) {
 			if (!isUsageSummary(result.value)) {
 				setState({
 					status: "error",
-					error: "invalid response shape"
+					error: ["响应格式与契约不符。", "The response does not match the expected shape."]
 				});
 				return;
 			}
@@ -2631,11 +2569,10 @@ function UsageSection(props) {
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 			className: "dsh-ui-error",
 			role: "alert",
-			children: t(`读取失败：${state.error}`, `Could not load: ${state.error}`)
+			children: t(`读取失败：${clientText(state.error, t)}`, `Could not load: ${clientText(state.error, t)}`)
 		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 			className: "dsh-ui-actions",
 			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-				host: props.Button,
 				onClick: () => void load(),
 				children: t("重试", "Retry")
 			})
@@ -2656,7 +2593,6 @@ function UsageSection(props) {
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "dsh-ui-actions",
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-					host: props.Button,
 					onClick: () => void load(),
 					children: t("刷新统计", "Refresh")
 				})
@@ -2817,7 +2753,7 @@ function KnowledgeSection(props) {
 			if (!result.ok) {
 				setList({
 					status: "error",
-					failure: failureOf(result.error.code, result.error.message, t)
+					failure: failureOf(result.error.code, result.error.message)
 				});
 				return;
 			}
@@ -2826,7 +2762,7 @@ function KnowledgeSection(props) {
 					status: "error",
 					failure: {
 						kind: "request",
-						text: t("响应格式与契约不符。", "The response does not match the expected shape.")
+						text: ["响应格式与契约不符。", "The response does not match the expected shape."]
 					}
 				});
 				return;
@@ -2839,14 +2775,10 @@ function KnowledgeSection(props) {
 			if (!gate.isCurrent(ticket)) return;
 			setList({
 				status: "error",
-				failure: networkFailure(cause, t)
+				failure: networkFailure(cause)
 			});
 		}
-	}, [
-		gate,
-		rpc,
-		t
-	]);
+	}, [gate, rpc]);
 	(0, react.useEffect)(() => {
 		load();
 	}, [load]);
@@ -2855,7 +2787,7 @@ function KnowledgeSection(props) {
 		setFailure(void 0);
 		setNote(void 0);
 		if (file.size > KB_MAX_BYTES) {
-			setFailure(t("文件超过 20 MB 上限。", "The file exceeds the 20 MB limit."));
+			setFailure(["文件超过 20 MB 上限。", "The file exceeds the 20 MB limit."]);
 			return;
 		}
 		const { ticket, signal } = gate.begin();
@@ -2871,17 +2803,17 @@ function KnowledgeSection(props) {
 			if (!gate.isCurrent(ticket)) return;
 			const result = raw;
 			if (!result.ok) {
-				setFailure(t(`上传失败：${result.error.message}`, `Upload failed: ${result.error.message}`));
+				setFailure([`上传失败：${result.error.message}`, `Upload failed: ${result.error.message}`]);
 				return;
 			}
-			setNote(t("已上传到知乎知识库。", "Uploaded to the Zhihu knowledge base."));
+			setNote(["已上传到知乎知识库。", "Uploaded to the Zhihu knowledge base."]);
 			setFile(void 0);
 			setFileKey((key) => key + 1);
 			await load();
 		} catch (cause) {
 			if (!gate.isCurrent(ticket)) return;
 			const detail = cause instanceof Error ? cause.message : String(cause);
-			setFailure(t(`上传失败：${detail}`, `Upload failed: ${detail}`));
+			setFailure([`上传失败：${detail}`, `Upload failed: ${detail}`]);
 		} finally {
 			setBusy(false);
 		}
@@ -2910,11 +2842,10 @@ function KnowledgeSection(props) {
 			list.status === "error" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 				className: "dsh-ui-error",
 				role: "alert",
-				children: list.failure.text
+				children: clientText(list.failure.text, t)
 			}), list.failure.kind !== "credential" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "dsh-ui-actions",
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-					host: props.Button,
 					onClick: () => void load(),
 					children: t("重试", "Retry")
 				})
@@ -2929,7 +2860,7 @@ function KnowledgeSection(props) {
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: "dsh-ui-row",
-						children: [renderSelect(props.Select, {
+						children: [renderSelect({
 							id: "zhihu-kb-base",
 							value: baseId,
 							disabled: busy,
@@ -2943,7 +2874,6 @@ function KnowledgeSection(props) {
 								label: t(`${base.name}${base.isDefault ? "（默认）" : ""} · ${base.contentCount} 篇`, `${base.name}${base.isDefault ? " (default)" : ""} · ${base.contentCount} docs`)
 							}))]
 						}, "dsh-ui-select"), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-							host: props.Button,
 							disabled: busy,
 							onClick: () => void load(),
 							children: t("刷新", "Refresh")
@@ -2993,7 +2923,6 @@ function KnowledgeSection(props) {
 			list.status === "ready" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "dsh-ui-actions",
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-					host: props.Button,
 					variant: "primary",
 					disabled: busy || !file,
 					onClick: () => void upload(),
@@ -3003,12 +2932,12 @@ function KnowledgeSection(props) {
 			note ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 				className: "dsh-ui-notice",
 				role: "status",
-				children: note
+				children: clientText(note, t)
 			}) : null,
 			failure ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 				className: "dsh-ui-error",
 				role: "alert",
-				children: failure
+				children: clientText(failure, t)
 			}) : null
 		]
 	});
@@ -3037,7 +2966,7 @@ function nextVisitedTabs(visited, next) {
 	return visited.includes(next) ? [...visited] : [...visited, next];
 }
 function ZhihuSettings(props) {
-	const { rpc, credentials, Select, Button, Input } = props;
+	const { rpc, credentials } = props;
 	const t = useT();
 	const gateRef = (0, react.useRef)(null);
 	if (!gateRef.current) gateRef.current = createZhihuClientState();
@@ -3083,7 +3012,7 @@ function ZhihuSettings(props) {
 				if (!parsed) {
 					setFailure({
 						kind: "request",
-						text: t("响应格式与契约不符。", "The response does not match the expected shape.")
+						text: ["响应格式与契约不符。", "The response does not match the expected shape."]
 					});
 					setPhase("error");
 					return;
@@ -3093,12 +3022,12 @@ function ZhihuSettings(props) {
 				setPhase("done");
 			} else if (response.error.code === "cancelled") setPhase("idle");
 			else {
-				setFailure(failureOf(response.error.code, response.error.message, t));
+				setFailure(failureOf(response.error.code, response.error.message));
 				setPhase("error");
 			}
 		} catch (cause) {
 			if (!gate.isCurrent(ticket)) return;
-			setFailure(networkFailure(cause, t));
+			setFailure(networkFailure(cause));
 			setPhase("error");
 		}
 	}, [
@@ -3182,12 +3111,11 @@ function ZhihuSettings(props) {
 		className: "dsh-ui-field",
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuTestSelector, {
 			value: testOperation,
-			onChange: onTestOperationChange,
-			Select
+			onChange: onTestOperationChange
 		}), isSearchOperation ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "dsh-ui-row",
-				children: mode === "ask" ? renderSelect(Select, {
+				children: mode === "ask" ? renderSelect({
 					"aria-label": t("直答模型", "Answer model"),
 					value: askModel,
 					onChange: (next) => onAskModelChange(next),
@@ -3219,7 +3147,7 @@ function ZhihuSettings(props) {
 				id: "zhihu-scope-hint",
 				children: t("至少保留一个检索范围。", "Keep at least one scope selected.")
 			})] }) : null,
-			renderInput(Input, {
+			renderInput({
 				type: "search",
 				className: "zhihu-input",
 				"data-testid": "zhihu-query",
@@ -3233,14 +3161,12 @@ function ZhihuSettings(props) {
 			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "dsh-ui-actions",
 				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-					host: Button,
 					variant: "primary",
 					"data-testid": "zhihu-search",
 					disabled: searchDisabled,
 					onClick: () => void runSearch(),
 					children: mode === "hot" ? t("获取热榜", "Get trending") : t("搜索", "Search")
 				}), phase === "loading" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuButton, {
-					host: Button,
 					onClick: () => {
 						gate.cancel();
 						setPhase("idle");
@@ -3256,7 +3182,7 @@ function ZhihuSettings(props) {
 			phase === "error" && failure ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "dsh-ui-error",
 				role: "alert",
-				children: failure.text
+				children: clientText(failure.text, t)
 			}) : null,
 			phase === "done" && outcome ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(OutcomeView, {
 				outcome,
@@ -3264,10 +3190,7 @@ function ZhihuSettings(props) {
 			}) : null
 		] }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuOpenPlatformSection, {
 			selectedOperation: testOperation,
-			rpc,
-			Button,
-			Input,
-			Select
+			rpc
 		}, testOperation)]
 	});
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
@@ -3276,24 +3199,10 @@ function ZhihuSettings(props) {
 		"aria-label": t("知乎", "Zhihu"),
 		children: [
 			tablist,
-			panel("settings", /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsSection, {
-				credentials,
-				Button,
-				Input
-			})),
-			panel("usage", /* @__PURE__ */ (0, react_jsx_runtime.jsx)(UsageSection, {
-				rpc,
-				Button
-			})),
-			panel("quota", /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuQuotaSection, {
-				rpc,
-				Button
-			})),
-			panel("knowledge", /* @__PURE__ */ (0, react_jsx_runtime.jsx)(KnowledgeSection, {
-				rpc,
-				Select,
-				Button
-			})),
+			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("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 })),
 			panel("test", testPanel)
 		]
 	});
@@ -3319,17 +3228,15 @@ function apply(ctx) {
 	} catch {
 		locale = void 0;
 	}
-	const settingsRender = (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuSettingsRoot, {
+	const settingsRender = () => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ZhihuSettingsRoot, {
 		rpc: client.connection.rpc,
 		credentials: wrapCredentials(client.remote.credentials),
-		locale,
-		...hostComponentsFromRenderProps(props)
+		locale
 	});
 	ctx.effect(() => client.slots.inject("plugins.bundle.config", () => client.slots.register({
 		name: "plugins.bundle.config",
 		key: PACKAGE_NAME,
-		order: SLOT_ORDER,
-		label: SLOT_LABEL
+		order: SLOT_ORDER
 	}, settingsRender)), "zhihu.settings");
 }
 //#endregion