@klarkxy/dsh-zhihu 0.2.8 → 0.2.10

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. 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.
+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, and returned items serve as reference material.
 
 ## Install
 
@@ -12,11 +12,11 @@ Use Zhihu as a research source for the model: site search, web search, hot list,
 dsh plugin --profile web add @klarkxy/dsh-zhihu
 ```
 
-Replace `web` with your profile name and restart DSH Web. Use the full scoped name; the unscoped `dsh-zhihu` belongs to someone else.
+Replace `web` with your profile name and restart DSH Web. Always specify the full scoped name `@klarkxy/dsh-zhihu`, as the unscoped `dsh-zhihu` is a separate package by another author.
 
 ## Use
 
-Open **Plugins → Zhihu** and enter your Access Secret under **Settings**. Other tabs:
+Open **Settings → Zhihu** and enter your Access Secret under **Settings**. Other tabs:
 
 - **Stats**: local daily calls, failures, and result counts;
 - **Official quota**: remaining free allowance as reported by Zhihu;
@@ -27,11 +27,11 @@ With the Web Search plugin installed, Zhihu web search also appears in its provi
 
 ## 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.
+In **Settings → 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. You can also paste Zhihu’s authorization text directly into the App Secret field when both credentials appear as `ZHIHU_OPENAPI_APP_KEY:"…"` and `ZHIHU_OPENAPI_APP_SECRET:"…"`; the plugin extracts and 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 plugin covers draft preparation and validation; publishing is done on Zhihu.
 
 ## Give the tools to the model
 
-These model tools are enabled by default; no agent preset changes needed:
+These model tools are enabled by default in your agent presets:
 
 | Tool | Purpose |
 | --- | --- |
@@ -44,9 +44,11 @@ These model tools are enabled by default; no agent preset changes needed:
 | `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, along with the service's explanation when provided.
+
 ## Cost protection
 
-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:
+By default research requests use only Zhihu's free allowance: before each request the plugin checks the official quota and sends the request only when free quota remains. It also caps usage at 100 requests per day (Beijing time). Both are configurable:
 
 ```yaml
 config:
@@ -54,16 +56,16 @@ config:
   dailyCallLimit: 100
 ```
 
-Paid use is allowed only when you set `allowPaid: true` yourself.
+Paid use is enabled 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.
+- Other clients sharing the same account can consume the free allowance between quota checks.
 - 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: publishing drafts, OAuth account switching, top-ups, or wallet queries.
+- Drafts support articles, questions, and pins. Supported images: JPEG, PNG, GIF, WebP, and BMP (up to 15 MB for GIF, and up to 30 MB for other formats; convert HEIC/AVIF to a supported format before uploading).
+- Draft and image operations use Zhihu's publishing authorization, separate from search quota and paid-search settings.
+- Each request runs once without automatic retries.
+- Scope covers research queries, knowledge bases, creator stats, and draft preparation; publishing drafts, OAuth account switching, top-ups, and wallet queries stay on Zhihu.
 
 ## License
 

package/docs/README.zh-CN.md

@@ -4,7 +4,7 @@
 
 [English](../README.md)
 
-把知乎交给模型当调研信源：站内搜索、全网搜索、热榜、知乎直答、知识库、问题发现和创作数据。`zhihu_sync` 工具还可以保存、校验文章、提问或想法草稿并上传配图。每次请求只用你自己的知乎 Access Secret；结果是参考资料，不是定论。
+把知乎交给模型当调研信源：站内搜索、全网搜索、热榜、知乎直答、知识库、问题发现和创作数据。`zhihu_sync` 工具还可以保存、校验文章、提问或想法草稿并上传配图。每次请求只用你自己的知乎 Access Secret，返回内容作为调研参考资料。
 
 ## 安装
 
@@ -12,11 +12,11 @@
 dsh plugin --profile web add @klarkxy/dsh-zhihu
 ```
 
-把 `web` 换成你的 profile 名，重启 DSH Web。请使用完整的 scoped 包名；无 scope 的 `dsh-zhihu` 属于其他维护者。
+把 `web` 换成你的 profile 名，重启 DSH Web。请使用完整的 scoped 包名 `@klarkxy/dsh-zhihu`（无 scope 的 `dsh-zhihu` 属于其他维护者）。
 
 ## 使用
 
-打开「插件 → 知乎」，在「设置」中填写 Access Secret。其他页签：
+打开「设置 → 知乎」，在「设置」页签中填写 Access Secret。其他页签：
 
 - **统计**：本机记录的每日调用、失败和结果条数；
 - **官方用量**：知乎返回的剩余免费额度；
@@ -27,11 +27,11 @@ 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 后仍可继续处理。本版本没有发布入口：模型与插件界面都不能发布草稿。
+在「设置 → 知乎 → 设置」页签填写发布用 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 预设：
+以下模型工具默认在 Agent 预设中启用：
 
 | 工具 | 用途 |
 | --- | --- |
@@ -44,9 +44,11 @@ dsh plugin --profile web add @klarkxy/dsh-zhihu
 | `zhihu_quota` | 查询官方额度 |
 | `zhihu_sync` | 保存、列出、读取并校验草稿，上传配图 |
 
+站内搜索和全网搜索无匹配内容时返回空列表；服务提供原因说明时会一并显示。
+
 ## 费用保护
 
-检索与创作查询默认只用知乎的免费额度：每次请求前先查官方额度，额度不足就不发送。另外每天（北京时间）最多 100 次请求。两项都可在插件配置中修改：
+检索与创作查询默认只用知乎的免费额度：每次请求前先查官方额度，确认有剩余免费额度才发送。另外每天（北京时间）最多 100 次请求。两项都可在插件配置中修改：
 
 ```yaml
 config:
@@ -54,16 +56,16 @@ config:
   dailyCallLimit: 100
 ```
 
-只有你自己把 `allowPaid` 设为 `true` 才允许付费调用。
+仅在你主动将 `allowPaid` 设为 `true` 时才启用付费调用。
 
 ## 限制
 
-- 不能保证绝对零费用：同一账号的其他客户端可能先用掉免费额度。
-- 知识库文件保存在知乎云端，单个文件最大 20 MB；草稿配图也会上传到知乎。
-- 草稿支持文章、提问和想法，不支持回答或视频。图片支持 JPEG、PNG、GIF、WebP、BMP；GIF 最大 15 MB，其他图片最大 30 MB。HEIC/AVIF 请先转换格式。
-- 草稿与图片操作使用知乎提供的发布授权；搜索额度与付费搜索开关不控制它们。
-- 所有请求都不会自动重试。
-- 不提供草稿发布、OAuth 账号切换、充值或钱包查询。
+- 同一账号下的其他客户端可能在两次额度检查之间消耗免费额度。
+- 知识库文件保存在知乎云端，单个文件最大 20 MB；草稿配图同样上传至知乎。
+- 草稿支持文章、提问和想法。图片支持 JPEG、PNG、GIF、WebP、BMP（GIF 最大 15 MB，其他格式最大 30 MB；HEIC/AVIF 请先转换为上述格式再上传）。
+- 草稿与图片操作使用知乎提供的发布授权，独立于搜索额度与付费搜索开关。
+- 每次请求单次执行，由调用方按需决定是否重试。
+- 功能范围涵盖调研检索、知识库、创作统计与草稿准备；草稿发布、OAuth 账号切换、充值与钱包查询请在知乎端操作。
 
 ## 许可证
 

package/lib/client.js

@@ -592,7 +592,7 @@ ${scope} {
 * The shared contract paints this page: the type tiers, the card, the field,
 * the banners, the empty state, the focus ring and every control's own recipe.
 * What is left here is only the geometry the contract does not cover — the
-* reading width of the plugin page, two inline SVG charts, the quota matrix and
+* reading width of the settings page, two inline SVG charts, the quota matrix and
 * the day table.
 *
 * Nothing below declares a colour of its own beyond naming a host token for a
@@ -1727,7 +1727,7 @@ function ZhihuQuotaSection({ rpc }) {
 /**
 * 知乎发布助手的应用凭据设置。
 *
-* 只有插件设置页（plugins.bundle.config）里才有这段表单：右侧栏工作台不发凭据，
+* 只有设置页的知乎分区（settings.section）里才有这段表单：右侧栏工作台不发凭据，
 * 也不重复提供入口。凭据本身由宿主管理（remote.credentials），插件只读写引用。
 */
 const ZHIHU_APP_KEY_REF = "ZHIHU_OPENAPI_APP_KEY";
@@ -2084,8 +2084,7 @@ const inject = [
 	"remote.credentials",
 	"locale"
 ];
-const PACKAGE_NAME = "@klarkxy/dsh-zhihu";
-const SLOT_ORDER = 120;
+const SLOT_ORDER = 160;
 const activityText = (children) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.TextShimmer, {
 	active: true,
 	children
@@ -3616,11 +3615,16 @@ function apply(ctx) {
 		credentials: wrapCredentials(client.remote.credentials),
 		locale
 	});
-	ctx.effect(() => client.slots.inject("plugins.bundle.config", () => client.slots.register({
-		name: "plugins.bundle.config",
-		key: PACKAGE_NAME,
+	ctx.effect(() => client.slots.inject("settings.section", () => [client.slots.register({
+		name: "settings.section",
+		id: "zhihu",
+		order: SLOT_ORDER,
+		label: () => (locale ? locale.getSnapshot().active : "zh").startsWith("zh") ? "知乎" : "Zhihu"
+	}, settingsRender), client.slots.inject("settings.section.icon", () => client.slots.register({
+		name: "settings.section.icon",
+		id: "zhihu",
 		order: SLOT_ORDER
-	}, settingsRender)), "zhihu.settings");
+	}, _deepseek_ai_dsh_client_ui_primitives.IconQuestionOutlineRegular))]), "zhihu.settings");
 }
 //#endregion
 exports.CapabilitiesNote = CapabilitiesNote;

package/lib/index.js

@@ -2859,7 +2859,7 @@ async function apply(ctx, config = {}) {
 	const syncDomain = await ctx.storageDomain.open(zhihuSyncDomainSpec);
 	const sync = createZhihuSyncService(syncDomain.table("drafts"), { resolveCredentials: async () => {
 		const [key, secret] = await Promise.all(ZHIHU_SYNC_CREDENTIAL_REFS.map((ref) => host.credentials.resolve(credentialRef(ref))));
-		if (!key?.value.trim() || !secret?.value.trim()) throw new ZhihuSyncServiceError("sync-credentials-missing", "请在知乎插件设置中填写发布 App Key 和 App Secret。");
+		if (!key?.value.trim() || !secret?.value.trim()) throw new ZhihuSyncServiceError("sync-credentials-missing", "请在「设置 → 知乎」中填写发布 App Key 和 App Secret。");
 		return {
 			appKey: key.value.trim(),
 			appSecret: secret.value.trim()