dsh-zhihu-search 2.0.1 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +5 -2
  2. package/README_en.md +6 -2
  3. package/package.json +30 -29
package/README.md CHANGED
@@ -105,7 +105,7 @@
105
105
 
106
106
  ### 前置
107
107
 
108
- - **DSH `0.1.7-rc.2` 或更高，且低于 `0.2.0`** —— 即 [package.json](package.json) 里 `engines.dsh` 与全部 `@deepseek-ai/dsh-*` 共同声明的那条区间（两处**同形状**是硬要求：接缝缺席时配置界面会静默不出现）。
108
+ - **DSH 的区间见 [package.json](package.json) 的 `engines.dsh`** —— 那是唯一真源，它与全部 27 条 `@deepseek-ai/dsh-*` 声明**逐字相同**（不同形状时使用者装到的宿主可能缺接缝，而接缝缺席是**静默**的：配置界面不出现、宿主不报错）。本文件与 [README_en.md](README_en.md) 都不抄那个会漂的值。
109
109
  - Node `>= 20`
110
110
 
111
111
  装宿主时**要显式指定版本线**：本家族的 `latest` 标签不可靠（多数 `@deepseek-ai/dsh-*` 包上它指向很早的版本），按默认方式装可能落在声明范围之外 —— 现查 `npm view @deepseek-ai/dsh dist-tags`。
@@ -128,6 +128,9 @@ dsh plugin --profile web add "$PWD"
128
128
 
129
129
  `dsh plugin` 会把本包装进 profile 并挂进 `dsh.profile.bundles`。重启 `dsh --profile web` 后生效。
130
130
 
131
+ ⚠️ 上面那步 `npm install` 不能省：`link:` 装法下依赖由仓库自己提供（见 [AGENTS.md](AGENTS.md)），
132
+ 漏装则插件显示「未运行」（`ERR_MODULE_NOT_FOUND`）。
133
+
131
134
  ### 从 npm 安装
132
135
 
133
136
  ```bash
@@ -147,7 +150,7 @@ dsh plugin --profile web add dsh-zhihu-search
147
150
 
148
151
  - **宿主够新**：插件页 →「已安装（Installed）」组 → **点「知乎检索」进它的详情页**（标题来自 [locale/zh.json](locale/zh.json)，中文界面下的显示名；技术名 `dsh-zhihu-search` 仍在标题下方），配置区就内联在描述与「包含的组件」之间 —— **没有多一次 Configure**，密钥与开关都在那里改。
149
152
  - **宿主更早（没有 `configForms`）**：三个工具照常工作，插件页里**不会出现配置入口** —— 静默，不报错。这就是分水岭；浏览器控制台会留一条 WARN 级英文提示说明这件事。
150
- - **需要就地配置**：把宿主升到 `engines.dsh` 声明的版本或更高 —— 那个版本目前只在 `alpha` 线上，装法 `npm install -g @deepseek-ai/dsh@alpha`；哪条线指向哪个版本现查 `npm view @deepseek-ai/dsh dist-tags`。
153
+ - **需要就地配置**：把宿主升到 `engines.dsh` 声明的那条线或更高 —— 承诺线就是 `next`，装法 `npm install -g @deepseek-ai/dsh@next`；哪条线指向哪个版本现查 `npm view @deepseek-ai/dsh dist-tags`。
151
154
 
152
155
  宿主版本线怎么装见[安装 → 前置](#前置)；每周的实测结论与红了怎么办见 [docs/PUBLISHING.md](docs/PUBLISHING.md) 的「兼容性」。
153
156
 
package/README_en.md CHANGED
@@ -105,7 +105,7 @@ The three sections below are each tool's full parameter set and limits. The mode
105
105
 
106
106
  ### Requirements
107
107
 
108
- - **DSH `0.1.7-rc.2` or newer, below `0.2.0`** — the single range that [package.json](package.json) declares in both `engines.dsh` and every `@deepseek-ai/dsh-*` entry (the two must stay the same shape: a missing host seam makes the configuration UI disappear silently).
108
+ - **DSH range**: see `engines.dsh` in [package.json](package.json) — that is the single source of truth, and it is **character-for-character identical** to all 27 `@deepseek-ai/dsh-*` entries (a mismatch means a Host without the seam this plugin needs, and a missing seam is **silent**: no configuration UI, no error). Neither this file nor [README.md](README.md) copies the value, which drifts.
109
109
  - Node `>= 20`
110
110
 
111
111
  Install the Host from an **explicit dist-tag**: `latest` is not trustworthy across this family (on most `@deepseek-ai/dsh-*` packages it points at a much older version), so a default install can land outside the declared range — check it live with `npm view @deepseek-ai/dsh dist-tags`.
@@ -128,6 +128,10 @@ dsh plugin --profile web add "$PWD"
128
128
 
129
129
  `dsh plugin` installs the package into the profile and lists it in `dsh.profile.bundles`. Restart `dsh --profile web` to pick it up.
130
130
 
131
+ ⚠️ The `npm install` above is not optional: under the `link:` form the repository supplies its
132
+ own dependencies (see [AGENTS.md](AGENTS.md)) — skip it and the plugin shows as "not running"
133
+ (`ERR_MODULE_NOT_FOUND`).
134
+
131
135
  ### From npm
132
136
 
133
137
  ```bash
@@ -147,7 +151,7 @@ The configuration UI registers into the Host's `plugins.bundle.config` slot, and
147
151
 
148
152
  - **Host is new enough**: **Plugins → Installed → click "Zhihu Search"** to open its details page (that title comes from [locale/en.json](locale/en.json), the name shown on an English UI; the technical name `dsh-zhihu-search` stays right below it) — the configuration section sits inline between the description and the components list, with **no extra Configure step**. Both the key and the switch are edited there.
149
153
  - **Earlier Host (no `configForms`)**: the three tools keep working, and the Plugins page simply **shows no configuration entry** — silently, with no error. That is the watershed; the browser console keeps one WARN-level English note about it.
150
- - **Want in-place configuration**: upgrade the Host to the version declared by `engines.dsh` or newer — that version currently lives on the `alpha` line only, so install it with `npm install -g @deepseek-ai/dsh@alpha`; which line points at which version is one command away: `npm view @deepseek-ai/dsh dist-tags`.
154
+ - **Want in-place configuration**: upgrade the Host to the line declared by `engines.dsh` or newer — the committed line is `next`, so install it with `npm install -g @deepseek-ai/dsh@next`; which line points at which version is one command away: `npm view @deepseek-ai/dsh dist-tags`.
151
155
 
152
156
  How to install the Host from the right line: [Install → Requirements](#requirements). Weekly measurements and what to do when a line breaks: [docs/PUBLISHING.md](docs/PUBLISHING.md).
153
157
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-zhihu-search",
3
- "version": "2.0.1",
3
+ "version": "2.1.0",
4
4
  "description": "Zhihu in-site search, global web search, and Zhida answers for the model, over the official Zhihu Open Platform API.",
5
5
  "keywords": [
6
6
  "dsh",
@@ -48,7 +48,7 @@
48
48
  ],
49
49
  "engines": {
50
50
  "node": ">=20",
51
- "dsh": ">=0.1.7-alpha.1 <0.2.0"
51
+ "dsh": ">=0.2.0-rc.1 <0.3.0"
52
52
  },
53
53
  "dsh": {
54
54
  "bundle": {
@@ -71,19 +71,20 @@
71
71
  "format": "prettier --write .",
72
72
  "format:check": "prettier --check .",
73
73
  "check:release": "node scripts/check-release.mjs",
74
+ "check:declaration": "node scripts/check-declaration.mjs",
74
75
  "prepare": "npm run build"
75
76
  },
76
77
  "peerDependencies": {
77
78
  "@deepseek-ai/cordis": "^4.0.2",
78
- "@deepseek-ai/dsh-client-locale": ">=0.1.7-alpha.1 <0.2.0",
79
- "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-alpha.1 <0.2.0",
80
- "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-alpha.1 <0.2.0",
81
- "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-alpha.1 <0.2.0",
82
- "@deepseek-ai/dsh-credentials": ">=0.1.7-alpha.1 <0.2.0",
83
- "@deepseek-ai/dsh-llm": ">=0.1.7-alpha.1 <0.2.0",
84
- "@deepseek-ai/dsh-settings": ">=0.1.7-alpha.1 <0.2.0",
85
- "@deepseek-ai/dsh-tools": ">=0.1.7-alpha.1 <0.2.0",
86
- "@deepseek-ai/dsh-util-values": ">=0.1.7-alpha.1 <0.2.0",
79
+ "@deepseek-ai/dsh-client-locale": ">=0.2.0-rc.1 <0.3.0",
80
+ "@deepseek-ai/dsh-client-ui-primitives": ">=0.2.0-rc.1 <0.3.0",
81
+ "@deepseek-ai/dsh-client-ui-settings": ">=0.2.0-rc.1 <0.3.0",
82
+ "@deepseek-ai/dsh-client-ui-slots": ">=0.2.0-rc.1 <0.3.0",
83
+ "@deepseek-ai/dsh-credentials": ">=0.2.0-rc.1 <0.3.0",
84
+ "@deepseek-ai/dsh-llm": ">=0.2.0-rc.1 <0.3.0",
85
+ "@deepseek-ai/dsh-settings": ">=0.2.0-rc.1 <0.3.0",
86
+ "@deepseek-ai/dsh-tools": ">=0.2.0-rc.1 <0.3.0",
87
+ "@deepseek-ai/dsh-util-values": ">=0.2.0-rc.1 <0.3.0",
87
88
  "@deepseek-ai/schemastery": "^3.18.2",
88
89
  "react": "^18.3.1",
89
90
  "react-dom": "^18.3.1"
@@ -91,24 +92,24 @@
91
92
  "devDependencies": {
92
93
  "@deepseek-ai/cordis": "^4.0.2",
93
94
  "@deepseek-ai/cordis-plugin-loader": "^1.0.4",
94
- "@deepseek-ai/dsh-agent": ">=0.1.7-alpha.1 <0.2.0",
95
- "@deepseek-ai/dsh-client-locale": ">=0.1.7-alpha.1 <0.2.0",
96
- "@deepseek-ai/dsh-client-ui-plugin-manager": ">=0.1.7-alpha.1 <0.2.0",
97
- "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-alpha.1 <0.2.0",
98
- "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.7-alpha.1 <0.2.0",
99
- "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-alpha.1 <0.2.0",
100
- "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-alpha.1 <0.2.0",
101
- "@deepseek-ai/dsh-credentials": ">=0.1.7-alpha.1 <0.2.0",
102
- "@deepseek-ai/dsh-invariants": ">=0.1.7-alpha.1 <0.2.0",
103
- "@deepseek-ai/dsh-llm": ">=0.1.7-alpha.1 <0.2.0",
104
- "@deepseek-ai/dsh-scope": ">=0.1.7-alpha.1 <0.2.0",
105
- "@deepseek-ai/dsh-session": ">=0.1.7-alpha.1 <0.2.0",
106
- "@deepseek-ai/dsh-session-projection": ">=0.1.7-alpha.1 <0.2.0",
107
- "@deepseek-ai/dsh-settings": ">=0.1.7-alpha.1 <0.2.0",
108
- "@deepseek-ai/dsh-system-prompt": ">=0.1.7-alpha.1 <0.2.0",
109
- "@deepseek-ai/dsh-tools": ">=0.1.7-alpha.1 <0.2.0",
110
- "@deepseek-ai/dsh-user-approval": ">=0.1.7-alpha.1 <0.2.0",
111
- "@deepseek-ai/dsh-util-values": ">=0.1.7-alpha.1 <0.2.0",
95
+ "@deepseek-ai/dsh-agent": ">=0.2.0-rc.1 <0.3.0",
96
+ "@deepseek-ai/dsh-client-locale": ">=0.2.0-rc.1 <0.3.0",
97
+ "@deepseek-ai/dsh-client-ui-plugin-manager": ">=0.2.0-rc.1 <0.3.0",
98
+ "@deepseek-ai/dsh-client-ui-primitives": ">=0.2.0-rc.1 <0.3.0",
99
+ "@deepseek-ai/dsh-client-ui-renderer": ">=0.2.0-rc.1 <0.3.0",
100
+ "@deepseek-ai/dsh-client-ui-settings": ">=0.2.0-rc.1 <0.3.0",
101
+ "@deepseek-ai/dsh-client-ui-slots": ">=0.2.0-rc.1 <0.3.0",
102
+ "@deepseek-ai/dsh-credentials": ">=0.2.0-rc.1 <0.3.0",
103
+ "@deepseek-ai/dsh-invariants": ">=0.2.0-rc.1 <0.3.0",
104
+ "@deepseek-ai/dsh-llm": ">=0.2.0-rc.1 <0.3.0",
105
+ "@deepseek-ai/dsh-scope": ">=0.2.0-rc.1 <0.3.0",
106
+ "@deepseek-ai/dsh-session": ">=0.2.0-rc.1 <0.3.0",
107
+ "@deepseek-ai/dsh-session-projection": ">=0.2.0-rc.1 <0.3.0",
108
+ "@deepseek-ai/dsh-settings": ">=0.2.0-rc.1 <0.3.0",
109
+ "@deepseek-ai/dsh-system-prompt": ">=0.2.0-rc.1 <0.3.0",
110
+ "@deepseek-ai/dsh-tools": ">=0.2.0-rc.1 <0.3.0",
111
+ "@deepseek-ai/dsh-user-approval": ">=0.2.0-rc.1 <0.3.0",
112
+ "@deepseek-ai/dsh-util-values": ">=0.2.0-rc.1 <0.3.0",
112
113
  "@deepseek-ai/schemastery": "^3.18.2",
113
114
  "@eslint/js": "^10.0.1",
114
115
  "@types/node": "^20.0.0",