@klarkxy/dsh-zhihu 0.1.7 → 0.1.8

package/README.md

@@ -2,17 +2,23 @@
 
 Zhihu search, answers, knowledge bases, and usage tracking for DSH.
 
-[简体中文](https://github.com/klarkxy/dsh-editor/blob/main/packages/dsh-zhihu/docs/README.zh-CN.md)
+[简体中文](https://github.com/klarkxy/dsh-plugins/blob/main/plugins/dsh-zhihu/docs/README.zh-CN.md)
 
 ## Install
 
-Requires Node.js ≥22 and DSH `0.1.7-rc.2`. No repository build is needed.
+Requires Node.js ≥22 and DSH `0.1.7-rc.2`. No repository build is needed. Install:
+
+```sh
+npm install @klarkxy/dsh-zhihu
+```
+
+Then load it:
 
 ```sh
 dsh plugin --profile web add @klarkxy/dsh-zhihu
 ```
 
-Restart DSH Web, open **Zhihu resources**, and enter your Access Secret (DSH credential `ZHIHU_ACCESS_TOKEN`). Use the full scoped name; the unscoped `dsh-zhihu` package belongs to another maintainer.
+Restart DSH Web, open **Plugins → @klarkxy/dsh-zhihu**, and enter your Access Secret (DSH credential `ZHIHU_ACCESS_TOKEN`). Use the full scoped name; the unscoped `dsh-zhihu` package belongs to another maintainer.
 
 To enable agent tools, add this entry to the plugin list in the agent's `agent.cordis.yml`:
 
@@ -22,14 +28,26 @@ To enable agent tools, add this entry to the plugin list in the agent's `agent.c
 
 ## Use
 
-DSH Web provides search, settings, usage, and knowledge-base views. In DSH Editor, open **Settings → Zhihu resources** for configuration, usage, knowledge bases, and a connection test; the agent tools are included.
+DSH Web provides search, settings, usage, and knowledge-base views. Open **Plugins → @klarkxy/dsh-zhihu** for configuration, usage, knowledge bases, and search; the agent tools are included.
 
-Search covers Zhihu, the wider web, trending topics, answers, and public knowledge bases. Uploaded reference files are stored in Zhihu's cloud; do not upload unpublished manuscripts.
+Five agent tools are available once the tools entry is enabled:
+
+- `zhihu_search`: search within Zhihu for community evidence; results are community/reader feedback only, never canon, and never written into project files.
+- `zhihu_global_search`: search the wider web beyond Zhihu through the open platform's global search; reference only.
+- `zhihu_hot_list`: pull the Zhihu hot list to see current community trends; reference for topics and hotspots only.
+- `zhihu_ask`: ask Zhihu 直答, an OpenAI-compatible AI answer service grounded in Zhihu community content; suited for research and background investigation.
+- `zhihu_knowledge_search`: retrieve RAG fragments from Zhihu knowledge bases — public bases by default, with personal and subscription recall scopes available after you upload material on Zhihu's web side.
+
+Usage is tracked as daily counters of calls, failures, and returned results; usage views default to the last 30 days and accept at most 90. Knowledge-base uploads are limited to 20 MB per file.
+
+Search covers Zhihu in-site search, the wider web, the hot list, Zhihu 直答 AI answers, and public knowledge bases. Uploaded reference files are stored in Zhihu's cloud; do not upload unpublished manuscripts.
 
 When [@klarkxy/dsh-web-search-manager](https://www.npmjs.com/package/@klarkxy/dsh-web-search-manager) is also installed in the same profile, this plugin registers **Zhihu global search** as a provider in its web search settings. Enable that provider to use Zhihu's global search through the standard web search tool with the Access Secret from Zhihu settings. The dedicated Zhihu tools work independently.
 
 ## Development
 
-Read [contracts](https://github.com/klarkxy/dsh-editor/blob/main/packages/dsh-zhihu/src/contracts.ts) and [tools](https://github.com/klarkxy/dsh-editor/blob/main/packages/dsh-zhihu/src/tools.ts) for the API.
+Read [contracts](https://github.com/klarkxy/dsh-plugins/blob/main/plugins/dsh-zhihu/src/contracts.ts) and [tools](https://github.com/klarkxy/dsh-plugins/blob/main/plugins/dsh-zhihu/src/tools.ts) for the API.
+
+[Publishing](https://github.com/klarkxy/dsh-plugins/blob/main/docs/editor-plugin-migration.md) · [License](https://github.com/klarkxy/dsh-plugins/blob/main/plugins/dsh-zhihu/LICENSE)
 
-[Publishing](https://github.com/klarkxy/dsh-editor/blob/main/packages/PUBLISHING.md) · [License](https://github.com/klarkxy/dsh-editor/blob/main/packages/dsh-zhihu/LICENSE)
+The client accepts structural host controls and has native HTML fallbacks. Building or using this package does not require application-private UI packages. Agent tools, credentials, RPC contracts and storage identifiers are unchanged.

package/docs/README.zh-CN.md

@@ -2,17 +2,23 @@
 
 DSH 知乎搜索、直答、知识库与用量插件。
 
-[English](https://github.com/klarkxy/dsh-editor/blob/main/packages/dsh-zhihu/README.md)
+[English](https://github.com/klarkxy/dsh-plugins/blob/main/plugins/dsh-zhihu/README.md)
 
 ## 安装
 
-需要 Node.js ≥22、DSH `0.1.7-rc.2`，无需构建本仓库。
+需要 Node.js ≥22、DSH `0.1.7-rc.2`，无需构建本仓库。安装：
+
+```sh
+npm install @klarkxy/dsh-zhihu
+```
+
+然后加载：
 
 ```sh
 dsh plugin --profile web add @klarkxy/dsh-zhihu
 ```
 
-重启 DSH Web，打开「知乎资料」填写 Access Secret（DSH 凭据 `ZHIHU_ACCESS_TOKEN`）。请使用完整 scoped 包名；无 scope 的 `dsh-zhihu` 属于其他维护者。
+重启 DSH Web，从「插件」打开「知乎（@klarkxy/dsh-zhihu）」填写 Access Secret（DSH 凭据 `ZHIHU_ACCESS_TOKEN`）。请使用完整 scoped 包名；无 scope 的 `dsh-zhihu` 属于其他维护者。
 
 模型需要使用知乎工具时，在所用 `agent.cordis.yml` 的插件列表加入：
 
@@ -22,7 +28,17 @@ dsh plugin --profile web add @klarkxy/dsh-zhihu
 
 ## 使用
 
-DSH Web 提供搜索、设置、用量与知识库视图。DSH Editor 在「设置 → 知乎资料」配置、查看用量、管理知识库和测试连接，已内置模型工具。
+DSH Web 提供搜索、设置、用量与知识库视图。在「插件 → 知乎（@klarkxy/dsh-zhihu）」配置、查看用量、管理知识库和搜索；模型工具随插件一同提供。
+
+启用 tools 入口后，模型可使用五个工具：
+
+- `zhihu_search`：知乎站内搜索，拉取社区证据；结果仅作社区/读者反馈参考，不构成 canon，也不直接写入项目文件。
+- `zhihu_global_search`：知乎开放平台全网搜索，检索站外公开网页资料；仅作参考。
+- `zhihu_hot_list`：拉取知乎热榜，了解当前社区热点；仅作题材与热点参考。
+- `zhihu_ask`：调用知乎直答（OpenAI 兼容的 AI 问答），基于知乎社区内容生成综合回答；适合考据与背景调研。
+- `zhihu_knowledge_search`：检索知乎知识库（RAG 片段），默认只查公开库；在知乎网页端上传过个人资料后可加个人/订阅召回范围。
+
+用量按日计数（调用次数、失败次数与成功调用返回的条目数），视图默认展示最近 30 天，最多可查 90 天。知识库上传单文件上限 20 MB。
 
 可查询站内、全网、热榜、直答和公开知识库。上传的参考文件保存在知乎云端，请勿上传未发表手稿。
 
@@ -30,6 +46,8 @@ DSH Web 提供搜索、设置、用量与知识库视图。DSH Editor 在「设
 
 ## 开发
 
-接口见 [contracts](https://github.com/klarkxy/dsh-editor/blob/main/packages/dsh-zhihu/src/contracts.ts) 与 [tools](https://github.com/klarkxy/dsh-editor/blob/main/packages/dsh-zhihu/src/tools.ts)。
+接口见 [contracts](https://github.com/klarkxy/dsh-plugins/blob/main/plugins/dsh-zhihu/src/contracts.ts) 与 [tools](https://github.com/klarkxy/dsh-plugins/blob/main/plugins/dsh-zhihu/src/tools.ts)。
+
+[发布维护](https://github.com/klarkxy/dsh-plugins/blob/main/docs/editor-plugin-migration.md) · [许可证](https://github.com/klarkxy/dsh-plugins/blob/main/plugins/dsh-zhihu/LICENSE)
 
-[发布维护](https://github.com/klarkxy/dsh-editor/blob/main/packages/PUBLISHING.md) · [许可证](https://github.com/klarkxy/dsh-editor/blob/main/packages/dsh-zhihu/LICENSE)
+客户端接收宿主提供的结构化控件，缺失时使用原生 HTML 控件。构建和使用本包不依赖应用私有 UI 包；Agent 工具、凭据、RPC 合同和存储标识保持不变。

package/icon.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="36" height="36" viewBox="0 0 36 36" fill="none">
+  <defs>
+    <linearGradient id="zbubble" x1="6" y1="6" x2="30" y2="28" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#4D75F5"/>
+      <stop offset="1" stop-color="#8EB6FF"/>
+    </linearGradient>
+  </defs>
+  <g transform="translate(3.6 3.6) scale(.8)">
+  <path d="M6 9C6 7.3 7.3 6 9 6H27C28.7 6 30 7.3 30 9V21C30 22.7 28.7 24 27 24H20L13 30V24H9C7.3 24 6 22.7 6 21V9Z" fill="url(#zbubble)"/>
+  <path d="M11 12H25M11 12V19M25 12V19M11 19H25M18 12V19" stroke="#E0EBFF" stroke-width="2" stroke-linecap="round"/>
+  <circle cx="14.5" cy="15.5" r="1.4" fill="#65DED0"/>
+  <circle cx="21.5" cy="15.5" r="1.4" fill="#65DED0"/>
+  </g>
+</svg>

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@klarkxy/dsh-zhihu",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Zhihu search, agent tools, knowledge bases, and usage tracking for DeepSeek Harness.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -36,6 +36,7 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "icon.svg",
     "lib/*.js",
     "lib/*.js.map",
     "lib/*.d.ts",
@@ -63,7 +64,7 @@
     "entries": [
       {
         "id": "zhihu",
-        "title": "知乎资料",
+        "title": "知乎",
         "description": "知乎搜索、知识库与用量",
         "feature": "zhihu",
         "service": "zhihu"
@@ -82,24 +83,37 @@
       }
     ]
   },
+  "scripts": {
+    "build": "tsdown && node ../../scripts/editor-plugins/wrap-client.mjs @klarkxy/dsh-zhihu",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run --root ../.. --config vitest.editor-plugins.config.ts --maxWorkers=2 plugins/dsh-zhihu/src"
+  },
   "dependencies": {
-    "@deepseek-ai/dsh-storage-domain": "0.1.7-rc.2",
     "zod": "^4.1.5"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
-    "@deepseek-ai/dsh-credentials": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-tools": ">=0.1.7-alpha.1 <0.2.0"
+    "@deepseek-ai/dsh-credentials": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-storage-domain": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": ">=0.1.7-alpha.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
     "@deepseek-ai/dsh-credentials": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-storage-domain": "0.1.7-rc.2",
     "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
     "react": "^18.2.0",
     "@types/react": "18.3.31",
-    "dsh-editor-seats": "0.1.0"
+    "react-dom": "^18.2.0",
+    "@types/react-dom": "^18.3.1"
   },
   "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-credentials": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-storage-domain": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-tools": {
       "optional": true
     }
@@ -116,23 +130,18 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/klarkxy/dsh-editor.git",
-    "directory": "packages/dsh-zhihu"
+    "url": "git+https://github.com/klarkxy/dsh-plugins.git",
+    "directory": "plugins/dsh-zhihu"
   },
-  "homepage": "https://github.com/klarkxy/dsh-editor/tree/main/packages/dsh-zhihu#readme",
+  "homepage": "https://klarkxy.github.io/dsh-plugins/plugins/zhihu/",
   "bugs": {
-    "url": "https://github.com/klarkxy/dsh-editor/issues"
+    "url": "https://github.com/klarkxy/dsh-plugins/issues"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "dshRelease": {
-    "contentHash": "sha256-09f8c9b11a25529dc222920deb2eb6b236d948a9dec4d280efc17177b1fd9e23"
-  },
-  "scripts": {
-    "build": "tsdown && node ../../scripts/wrap-client.mjs @klarkxy/dsh-zhihu",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "vitest run --root ../.. packages/dsh-zhihu/src"
+    "contentHash": "abfa1b559afda73ac70b685e2d9bae00fbcc250806fbd1369f9f189fd040e0ca"
   }
-}
+}