dsh-cabinet-mode 0.2.0 → 0.2.2

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.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,31 @@
2
2
 
3
3
  All notable changes to this project are documented in this file.
4
4
 
5
+ ## [0.2.2] - 2026-11-05
6
+
7
+ ### Documentation
8
+
9
+ - Make the plugin market the preferred installation path for users and AI
10
+ assistants in both READMEs, with tested UI steps, the exact raw index URL,
11
+ verification boundaries and explicit tarball/local-directory fallbacks.
12
+
13
+ ## [0.2.1] - 2026-11-05
14
+
15
+ ### Changed
16
+
17
+ - Refresh the five member portraits with chibi artwork and recognize role aliases,
18
+ numeric suffixes and common separators (#3).
19
+ - Preserve original member identities beside localized role labels, including
20
+ task owners and foreign-owner groups; add identity collision regressions (#4).
21
+ - Explain the exact raw JSON market URL and recovery from GitHub webpage URLs
22
+ producing `$.format must be 1`, including on the generated index branch.
23
+ - Describe the runtime sidebar and avatars correctly in the market listing.
24
+
25
+ ### Fixed
26
+
27
+ - Publish icon and index README changes even when marketplace.json is unchanged.
28
+ Preserve registry propagation waiting and protection against version loss.
29
+
5
30
  ## [0.2.0] - 2026-11-05
6
31
 
7
32
  ### Added
package/README.md CHANGED
@@ -2,6 +2,8 @@
2
2
 
3
3
  [中文](README.zh.md) | English
4
4
 
5
+ **Install:** [Use the plugin market (recommended)](#install-from-the-plugin-market-recommended).
6
+
5
7
  <p align="center">
6
8
  <img src="docs/images/cabinet-portrait.jpg" width="200" alt="Cabinet Mode — grand-secretary portrait, shipped as the bundle icon (icon.svg)"/>
7
9
  </p>
@@ -61,13 +63,15 @@ preset declaration:
61
63
  - **Task colours** — pending gray, in progress blue, completed green (legend at
62
64
  the bottom of the panel).
63
65
  - **Member look** — each row carries a circular avatar (22px, 24px for the Lead),
64
- the name, a status label and the current model; avatars map by name prefix and
65
- fall back to the Lead tint when unmatched.
66
+ the Chinese role and original member name, a status label and the current model.
67
+ Aliases share a bureau avatar, while original names keep members distinguishable
68
+ in cards, Owner tags and off-roster groups. Truncated labels have full tooltips;
69
+ unmatched names use a neutral avatar.
66
70
 
67
71
  The five member avatars are tinted per bureau: Lead bright yellow, 翰林院编修
68
72
  (编辑) cyan, 工部主事 (执行) red, 大理寺评事 (核验) dark, 都察院御史 (验收)
69
- crimson — light-toned, Chinese-style 3D semi-realistic three-quarter profile
70
- busts (soft-focus guofeng backdrop inside the circle). They are
73
+ crimson — light-toned chibi portraits in Ming-style court dress
74
+ (soft-focus guofeng backdrop inside the circle). They are
71
75
  embedded in `client.js` as 128px data URLs; the square source PNGs live in
72
76
  `docs/images/avatars/` and are downscaled by `src/build_avatars.py` (originals
73
77
  are kept at 512x512 and are never embedded directly).
@@ -95,108 +99,51 @@ board). It adds no service and no protocol.
95
99
 
96
100
  ---
97
101
 
98
- ## Install with an AI agent (copy this prompt)
102
+ ## Install from the plugin market (recommended)
103
+
104
+ **For users and AI assistants, prefer the DSH plugin market.** It installs the published npm bundle into the active profile; you do not need a checkout, a manually edited patch or a tarball URL.
105
+
106
+ Copy this **raw JSON index URL**:
99
107
 
100
108
  ```text
101
- Install the "Cabinet Mode" (内阁模式) DSH bundle for me.
102
-
103
- 1. Run `dsh --version` and tell me the version. 0.2.1-rc.3 is the tested reference;
104
- this bundle declares no hard DSH version gate, but other DSH versions are not verified.
105
- 2. Install the bundle into my DSH profile:
106
- dsh plugin --profile desktop add <absolute path to the dsh-cabinet-mode checkout or .tgz>
107
- (You can also use the GitHub Release tarball URL instead of a local path.)
108
- If the `dsh` CLI is unavailable, open DSH Settings -> Plugins -> Add plugin and
109
- choose "local directory" with the absolute path of the dsh-cabinet-mode checkout.
110
- 3. Run `dsh plugin --profile desktop list` and confirm `dsh-cabinet-mode` is installed.
111
- 4. Do NOT also append cordis.patch.yml to my profile patch: the two installation
112
- methods are mutually exclusive and duplicate preset ids fail to load.
113
- 5. Tell me to fully quit and restart DSH, then create a new session and choose
114
- "内阁模式" (preset id: cabinet) in the mode picker.
115
-
116
- If any step fails, show the exact error and stop. Do not retry more than once.
109
+ https://raw.githubusercontent.com/luodaoyi/dsh-cabinet-mode/market-index/marketplace.json
117
110
  ```
118
111
 
119
- ## Manual install (3 lines)
112
+ 1. Open **Plugins → Experimental plugins → More** if needed, then enable **Custom plugin market** (自定义插件市场).
113
+ 2. Return to **Plugins → Discover** (发现), open **Index sources** (索引源), paste the raw URL above and click **Add**.
114
+ 3. Wait for **Cabinet Mode / 内阁模式** to appear. Click **Install**, check the package `dsh-cabinet-mode@<version>` and registry `https://registry.npmjs.org/`, then confirm installation.
115
+ 4. Check that DSH reports **Installed** and displays the version. Fully quit and restart DSH, create a new session, and select **内阁模式** (`cabinet`). Open the Cabinet tab with **+** in the right sidebar if needed.
120
116
 
121
- ```sh
122
- dsh plugin --profile desktop add https://github.com/luodaoyi/dsh-cabinet-mode/releases/download/v0.2.0/dsh-cabinet-mode-0.2.0.tgz
123
- # fully quit and restart DeepSeek Harness
124
- # New session -> mode picker -> 内阁模式
125
- ```
117
+ Do **not** paste a GitHub `blob` or `tree` webpage URL. DSH does not convert those pages into an index: `$.format must be 1` was reproduced with a blob URL. Remove the invalid source and add the raw URL instead. This rule applies to Respire and other markets too.
126
118
 
127
- For a local checkout, replace the tarball URL with the absolute path of this
128
- repository. On Windows the CLI is `dsh` (runs through `dsh.cmd`); the same
129
- commands work on Linux and macOS.
130
-
131
- > **DSH 0.2.1-rc.5 desktop notes (tested 2026-10-31):**
132
- >
133
- > - The `dsh` CLI that ships with the desktop app runs `dsh plugin --profile
134
- > desktop list/add ...` fine (exit 0). On first use it may ask you to initialize
135
- > the profile ("Open DeepSeek Harness Desktop once … then fully quit it") and may
136
- > wait up to 120 s on a profile lock — so **fully quit DeepSeek Harness before
137
- > installing or upgrading**.
138
- > - What a desktop profile does reject is `dsh --profile desktop --dump-config`
139
- > ("managed exclusively by the Electron application"); run composition checks
140
- > against the `web` profile instead.
141
- > - Fallbacks: the plugin page (Settings → Plugins → Add plugin → local directory /
142
- > tarball URL), or the pnpm shipped inside DeepSeek Harness (keeps
143
- > `dsh-cabinet-mode` in `dsh.profile.bundles`):
144
- >
145
- > ```sh
146
- > node "<DeepSeek Harness install>\resources\runtime\primary-runtime\dependencies\pnpm\bin\pnpm.mjs" --dir "%USERPROFILE%\.dsh\profiles\desktop" add https://github.com/luodaoyi/dsh-cabinet-mode/releases/download/v0.2.0/dsh-cabinet-mode-0.2.0.tgz
147
- > ```
148
- >
149
- > Back up the profile's `package.json` / `pnpm-lock.yaml` first.
150
-
151
- ## Install from the plugin market
152
-
153
- The bundle is also listed in a DeepSeek Harness plugin market index that is
154
- generated from the npm registry, so DSH can install and update it without a tarball
155
- URL or a local checkout:
119
+ **Verification scope:** the raw source loaded and installed version 0.2.0 through the real DSH 0.2.1-rc.5 web client on Windows in an isolated profile (2026-11-05). Other DSH versions and Linux/macOS market UI flows are unverified. The index format is also tested with the official rc.5 parser. Live agent-team behavior is a separate test.
120
+
121
+ ## Install with an AI agent (copy this prompt)
156
122
 
157
123
  ```text
124
+ Install the Cabinet Mode (内阁模式) DSH bundle for me, preferably through its plugin market index:
158
125
  https://raw.githubusercontent.com/luodaoyi/dsh-cabinet-mode/market-index/marketplace.json
126
+
127
+ 1. Identify my DSH version and intended profile. Use the existing UI to enable Custom plugin market, then Plugins → Discover → Index sources.
128
+ 2. Add the exact raw JSON URL above. Do not use GitHub blob/tree URLs, edit the index, or invent a command to add a market source.
129
+ 3. Install Cabinet Mode from that source. Verify the confirmation shows dsh-cabinet-mode@<version> from https://registry.npmjs.org/, then verify the Installed result and version.
130
+ 4. If browser/UI control is unavailable, give me those short UI steps. Use the release tarball or local-directory fallback only when the market is unavailable or I choose it; explain the specific reason first.
131
+ 5. Do not also append cordis.patch.yml to my profile: installing both ways duplicates the preset. Preserve my existing profile and plugins.
132
+ 6. Tell me to fully quit and restart DSH, create a new session and choose 内阁模式 (preset id cabinet). Do not claim success until the installed version is verified; do not claim untested team behavior works.
133
+
134
+ On failure, show the exact error. For $.format must be 1, replace the webpage source with the raw JSON URL. Do not repeatedly reinstall or silently switch methods.
135
+ ```
136
+
137
+ ## Fallback: release tarball or local checkout
138
+
139
+ Use this only when the market is unavailable or for local development. Fully quit desktop DSH first to release the profile lock, then install the release bundle:
140
+
141
+ ```sh
142
+ dsh plugin --profile desktop add https://github.com/luodaoyi/dsh-cabinet-mode/releases/download/v0.2.2/dsh-cabinet-mode-0.2.2.tgz
143
+ dsh plugin --profile desktop list
159
144
  ```
160
145
 
161
- 1. Open **Plugin market** (插件市场) in DSH, open **Index sources** (索引源), add the
162
- URL above, and refresh it.
163
- 2. Install **内阁模式 / Cabinet Mode** (`dsh-cabinet-mode`) from the market list that
164
- appears. DSH installs `dsh-cabinet-mode@<version>` from
165
- `https://registry.npmjs.org` into the current profile. This is the same bundle
166
- install as Method A below — use one of them, never both.
167
- 3. **Fully quit and restart DeepSeek Harness**, then create a new session and pick
168
- **内阁模式** in the mode picker.
169
- 4. To update later: on the **Installed** (已安装) page, uninstall the old version
170
- first, then install the newer version from **Plugin market**, and restart again.
171
- The market has **no in-place update** for third-party plugins — the "update
172
- available" (有新版本) badge only opens the Installed page.
173
-
174
- How "update available" is detected: DSH compares **SemVer versions only**, so a
175
- package rebuilt under the same version number is not flagged (npm versions are
176
- immutable, so this does not affect the npm source). There is **no periodic
177
- auto-check**: the index is fetched when the plugin market is opened or refreshed
178
- and cached for 10 minutes. These are code-level findings from the DSH 0.2.1-rc.5
179
- sources, recorded with line references in [docs/cross-platform.md](docs/cross-platform.md) (§7);
180
- the real update flow was not exercised end to end.
181
-
182
- The index is regenerated from the npm registry after every tagged release and only
183
- lists published, non-deprecated stable versions; do not edit the `market-index`
184
- branch by hand.
185
-
186
- > **Release status (2026-11-03):** `dsh-cabinet-mode@0.1.4`, `0.1.5` and `0.1.6` are
187
- > published on `registry.npmjs.org` by the tag-triggered OIDC workflow, each with a
188
- > provenance attestation on sigstore, and the `market-index` branch is refreshed
189
- > automatically after every publish. The whole tag → publish → GitHub Release → index
190
- > refresh chain has run green twice (v0.1.5: run 41657224370, v0.1.6: run
191
- > 41661809576), and the index now lists 0.1.6, 0.1.5 and 0.1.4. The registry also
192
- > carries a placeholder `0.0.0-stage` prerelease, which the index intentionally does
193
- > not list.
194
- >
195
- > **Not verified:** the exact plugin-market UI labels and click path in your DSH
196
- > build, and a real install/update in that GUI. The
197
- > `dsh-cabinet-mode@<version>` install spec is what the format-1 reader
198
- > (`@deepseek-ai/dsh-plugin-market-index@0.2.1-rc.5`, `marketInstallTarget`) returns
199
- > for an npm source; that function was executed locally, the UI was not.
146
+ Check the installed version, restart DSH and select Cabinet Mode in a new session. For a local checkout, replace the URL with its absolute path. If the CLI is unavailable, use **Plugins → Add plugin** and select the tarball URL or local directory. Use the intended profile; `desktop` is the desktop app profile. Neither method should be combined with the manual preset patch. The optional installer scripts provide only the preset fallback, not the Cabinet UI.
200
147
 
201
148
  ## Upgrade
202
149
 
@@ -207,7 +154,7 @@ the same install command with the new version URL (or pick the new `.tgz` in the
207
154
  plugin page), then fully quit and restart DeepSeek Harness:
208
155
 
209
156
  ```sh
210
- dsh plugin --profile desktop add https://github.com/luodaoyi/dsh-cabinet-mode/releases/download/v0.2.0/dsh-cabinet-mode-0.2.0.tgz
157
+ dsh plugin --profile desktop add https://github.com/luodaoyi/dsh-cabinet-mode/releases/download/v0.2.2/dsh-cabinet-mode-0.2.2.tgz
211
158
  ```
212
159
 
213
160
  `dsh plugin --profile desktop list` should report the new version. Upgrades were
@@ -252,9 +199,9 @@ on DSH 0.2.1-rc.5.
252
199
 
253
200
  | Method | Windows | Linux | macOS | Notes |
254
201
  |---|---|---|---|---|
255
- | **A. DSH plugin manager** (recommended): plugin page "Add plugin -> local directory/package", or `dsh plugin --profile <profile> add <absolute path / .tgz / release URL>` | ✅ tested locally on 2026-10-29: local-directory install **and GitHub Release asset URL install**; `dsh plugin --profile desktop list` = 3 packages; composition check passed | ⚙️ code-level inference, **not tested on this machine** | ⚙️ code-level inference, **not tested on this machine** | Pure YAML bundle: no build, no dependencies, no OS-specific code. See [docs/cross-platform.md](docs/cross-platform.md). |
202
+ | **Plugin market** (index source): see [Install from the plugin market](#install-from-the-plugin-market-recommended) | ✅ **Windows rc.5 web client install verified** (isolated profile, 2026-11-05) | ❌ **not tested** | ❌ **not tested** | Same npm bundle install through DSH's plugin market; the npm publish and the `market-index` branch now exist. |
203
+ | **A. DSH plugin manager** (fallback): plugin page "Add plugin -> local directory/package", or `dsh plugin --profile <profile> add <absolute path / .tgz / release URL>` | ✅ tested locally on 2026-10-29: local-directory install **and GitHub Release asset URL install**; `dsh plugin --profile desktop list` = 3 packages; composition check passed | ⚙️ code-level inference, **not tested on this machine** | ⚙️ code-level inference, **not tested on this machine** | Pure YAML bundle: no build, no dependencies, no OS-specific code. See [docs/cross-platform.md](docs/cross-platform.md). |
256
204
  | **B. Fallback node scripts** (no plugin manager): `node scripts/install.mjs --profile <profile>` then `--apply`; writes the profile `cordis.patch.yml` | ✅ scripts tested on Windows (dry-run + temp copies) | ⚙️ code-level inference, **not tested** | ⚙️ code-level inference, **not tested** | Same file layout on all platforms: `<DSH_HOME>/profiles/<profile>/cordis.patch.yml`. |
257
- | **Plugin market** (index source): see [Install from the plugin market](#install-from-the-plugin-market) | ❌ **GUI install not tested** (npm publish + index are live as of 2026-11-03) | ❌ **not tested** | ❌ **not tested** | Same npm bundle install through DSH's plugin market; the npm publish and the `market-index` branch now exist. |
258
205
 
259
206
  **Method A and Method B are mutually exclusive.** Both create the preset
260
207
  declaration `config.id: cabinet`. Installing both makes the preset id appear
@@ -262,7 +209,7 @@ twice, and the preset declaration then fails to load. Uninstall one method befor
262
209
  switching to the other. The plugin-market route installs the same bundle as
263
210
  Method A, so the same exclusivity applies to it.
264
211
 
265
- ### A. Install as a DSH bundle (recommended, all platforms)
212
+ ### A. Fallback: install a bundle directly
266
213
 
267
214
  1. Install the bundle into the profile you use:
268
215
  - **Plugin page:** Settings → Plugins → Add plugin → local directory / package,
@@ -443,11 +390,7 @@ These were **not** tested on this machine and must not be presented as verified:
443
390
  - Whether `config.id` syntax rules reject unusual ids (this id is `cabinet`).
444
391
  - HMR behavior for preset declarations, and private-registry/proxied tarball
445
392
  installs.
446
- - **The plugin market in real use.** Parsing the published index, resolving the npm
447
- install spec and installing `dsh-cabinet-mode@0.1.5` into a throwaway profile were
448
- exercised locally, and the full tag → publish → automatic index refresh chain runs
449
- in CI (v0.1.5, run 41657224370), but no install or update has been performed in
450
- the DSH plugin-market GUI itself.
393
+ - **Market updates and other clients.** Raw-source addition and installation of 0.2.0 were verified in the Windows rc.5 web client. The uninstall/reinstall update flow and other DSH versions/platforms remain unverified.
451
394
 
452
395
  ## Known limitations
453
396
 
package/README.zh.md CHANGED
@@ -2,6 +2,8 @@
2
2
 
3
3
  [English](README.md) | 中文
4
4
 
5
+ **安装入口:** [优先从插件市场安装](#从插件市场安装索引源推荐)。
6
+
5
7
  <p align="center">
6
8
  <img src="docs/images/cabinet-portrait.jpg" width="200" alt="内阁模式图标来源:明代内阁首辅画像(已作为 bundle 图标 icon.svg 随包发布)"/>
7
9
  </p>
@@ -32,9 +34,9 @@
32
34
  - **派活树**:首辅行在顶,任务按 `ownerName` 缩进挂到对应阁臣名下,`blockedBy` 依赖以标签挂在任务下方——首辅给谁派了什么活、被哪条任务卡住,一眼可见。
33
35
  - **谁在干活**:成员 running 时整行浅绿高亮、状态点持续脉冲;空闲 / 启动中 / 失败分别用灰 / 琥珀 / 红点区分,首辅行同样参与高亮。
34
36
  - **任务三色**:待办灰、进行中蓝、已完成绿(面板底部附图例)。
35
- - **成员形象**:每行头像(圆形 22px,首辅 24px)+姓名+状态文字+当前模型;头像按姓名前缀匹配,未匹配的成员回落首辅色。
37
+ - **成员形象**:每行包含圆形头像、中文称谓与成员原名、状态文字和当前模型。别名共享衙门头像,成员卡片、Owner 标签和不在册分组保留原名以区分身份;截断文字提供完整提示,未匹配名称使用中性头像。
36
38
 
37
- 五张成员头像按衙门分色:首辅明黄、翰林院编修青、工部主事赤、大理寺评事玄、都察院御史绯——浅色系国风 3D 半写实 3/4 侧颜胸像(圈内浅景深国风背景)。头像以 128px data URL 内嵌进 `client.js`,源图为正方形 PNG 存于 `docs/images/avatars/`,由 `src/build_avatars.py` 缩放生成(源图 512×512,不直接内嵌)。
39
+ 五张成员头像按衙门分色:首辅明黄、翰林院编修青、工部主事赤、大理寺评事玄、都察院御史绯——浅色系国风 Q 版明代冠服人物(圈内浅景深国风背景)。头像以 128px data URL 内嵌进 `client.js`,源图为正方形 PNG 存于 `docs/images/avatars/`,由 `src/build_avatars.py` 缩放生成(源图 512×512,不直接内嵌)。
38
40
 
39
41
  示例(其余四张同目录:`hanlin.png` / `works.png` / `dali.png` / `yushi.png`):
40
42
 
@@ -51,83 +53,58 @@
51
53
 
52
54
  ---
53
55
 
54
- ## 让 AI 帮你安装(复制下面这段提示词)
56
+ ## 从插件市场安装(索引源,推荐)
57
+
58
+ **用户和 AI 助手都优先通过 DSH 插件市场安装。** 商店会把已发布的 npm bundle 安装到当前 profile,无需克隆仓库、手改配置或寻找 tgz 下载地址。
59
+
60
+ 复制这个 **raw JSON 索引地址**:
55
61
 
56
62
  ```text
57
- 请帮我安装 DeepSeek Harness 的「内阁模式」(Cabinet Mode)bundle。
58
-
59
- 1. 先运行 `dsh --version` 并告诉我版本。0.2.1-rc.3 是已实测参照;本包不声明
60
- DSH 版本硬限制,但其他版本未经验证。
61
- 2. 把 bundle 装进我的 DSH profile:
62
- dsh plugin --profile desktop add <dsh-cabinet-mode 仓库或 .tgz 的绝对路径>
63
- (也可用 GitHub Release 的 tgz URL 代替本地路径。)
64
- 若 `dsh` CLI 不可用:打开 DSH 设置 → 插件 → 添加插件 → 选择「本地目录」,
65
- 指向 dsh-cabinet-mode 仓库的绝对路径。
66
- 3. 运行 `dsh plugin --profile desktop list`,确认出现 dsh-cabinet-mode。
67
- 4. 不要同时把 cordis.patch.yml 追加到我的 profile patch:两种安装方式互斥,
68
- 同时装会让 preset 重复而加载失败。
69
- 5. 安装完成后提醒我完全退出并重启 DSH;然后在新建任务时选择「内阁模式」
70
- (preset id: cabinet)。
71
-
72
- 任何一步失败请贴原始错误并停止,不要连续重试超过一次。
63
+ https://raw.githubusercontent.com/luodaoyi/dsh-cabinet-mode/market-index/marketplace.json
73
64
  ```
74
65
 
75
- ## 手动安装(3 行)
66
+ 1. 打开「**插件 → 实验性插件**」,必要时点击「**更多**」,启用「**自定义插件市场**」。
67
+ 2. 返回「**插件 → 发现**」,打开「**索引源**」,粘贴上面的 raw 地址,点击「**添加**」。
68
+ 3. 等待出现「**内阁模式 / Cabinet Mode**」,点击「**安装**」。确认弹窗中的包名为 `dsh-cabinet-mode@<版本>`,注册表为 `https://registry.npmjs.org/`,再确认安装。
69
+ 4. 检查界面显示「**已安装**」及版本号。**完全退出并重启 DSH**,新建会话,在模式选择器中选「**内阁模式**」(`cabinet`);需要时通过右侧栏「**+**」打开内阁页签。
76
70
 
77
- ```sh
78
- dsh plugin --profile desktop add https://github.com/luodaoyi/dsh-cabinet-mode/releases/download/v0.2.0/dsh-cabinet-mode-0.2.0.tgz
79
- # 完全退出并重启 DeepSeek Harness
80
- # 新建任务 -> 模式选择器 -> 内阁模式
81
- ```
71
+ **不要填写 GitHub 的 `blob` 或 `tree` 网页地址。** DSH 不会把网页自动转换成索引;我们已用 blob 地址复现 `$.format must be 1`。遇到该错误,移除错误源,重新添加上述 raw 地址。Respire 等其他商店也适用同一规则。
72
+
73
+ **验证范围:** 2026-11-05 已在 Windows、DSH 0.2.1-rc.5 的隔离 web profile 中,通过真实客户端添加 raw 索引并安装 0.2.0。其他 DSH 版本和 Linux/macOS 的商店界面流程尚未验证;索引格式另由官方 rc.5 解析器回归测试。真实团队任务交互属于另一项验证。
82
74
 
83
- 本地目录安装:把上面的 tgz URL 换成仓库绝对路径即可。Windows 上 CLI 为 `dsh`(经 `dsh.cmd`),Linux/macOS 命令相同。
84
-
85
- > **DSH 0.2.1-rc.5 桌面端实测(2026-10-31):**
86
- >
87
- > - 桌面端自带的 `dsh` CLI 跑 `dsh plugin --profile desktop list/add ...` 正常
88
- > (exit 0)。首次使用可能要求先初始化 profile(提示「Open DeepSeek Harness
89
- > Desktop once … then fully quit it」),并可能等待 profile 锁最多 120 秒——
90
- > 所以**安装/升级前先完全退出 DeepSeek Harness**。
91
- > - 桌面 profile 真正被拒的是 `dsh --profile desktop --dump-config`
92
- > ("managed exclusively by the Electron application");组合校验请用 `web`
93
- > profile。
94
- > - 备选:插件页(设置 → 插件 → 添加插件 → 本地目录 / tgz URL),或 DeepSeek
95
- > Harness 自带的 pnpm——装完确认 profile `package.json` 的
96
- > `dsh.profile.bundles` 里保留了 `dsh-cabinet-mode`:
97
- >
98
- > ```sh
99
- > node "<DeepSeek Harness 安装目录>\resources\runtime\primary-runtime\dependencies\pnpm\bin\pnpm.mjs" --dir "%USERPROFILE%\.dsh\profiles\desktop" add https://github.com/luodaoyi/dsh-cabinet-mode/releases/download/v0.2.0/dsh-cabinet-mode-0.2.0.tgz
100
- > ```
101
- >
102
- > 操作前先备份该 profile 的 `package.json` / `pnpm-lock.yaml`。
103
-
104
- ## 从插件市场安装(索引源)
105
-
106
- 本 bundle 同时登记在一份由 npm registry 生成的 DeepSeek Harness 插件市场索引里,DSH 可直接安装与更新,无需 tgz URL 或本地目录:
75
+ ## 让 AI 帮你安装(复制下面这段提示词)
107
76
 
108
77
  ```text
78
+ 请帮我安装 DeepSeek Harness 的「内阁模式」bundle,优先使用插件市场索引:
109
79
  https://raw.githubusercontent.com/luodaoyi/dsh-cabinet-mode/market-index/marketplace.json
80
+
81
+ 1. 确认我的 DSH 版本和目标 profile。通过已有界面启用「自定义插件市场」,进入「插件 → 发现 → 索引源」。
82
+ 2. 添加上面的 raw JSON 地址。不要使用 GitHub blob/tree 网页,不要修改索引,也不要编造添加商店源的 CLI 命令。
83
+ 3. 从该源安装「内阁模式」,确认弹窗为 dsh-cabinet-mode@<版本>、注册表为 https://registry.npmjs.org/,然后核实「已安装」结果和版本号。
84
+ 4. 如果你无法操作界面,请给我简短的界面步骤;只有市场不可用或我选择备用方法时,才使用 Release tgz 或本地目录,并先解释具体原因。
85
+ 5. 不要再向 profile 追加 cordis.patch.yml,避免重复 preset。保留我的已有 profile 和其他插件。
86
+ 6. 提醒我完全退出并重启 DSH,新建会话并选择「内阁模式」(preset id cabinet)。未核实安装版本不要声称成功,未测试的团队交互不要声称已验证。
87
+
88
+ 失败时给出原始错误。遇到 $.format must be 1,先把网页源换成 raw JSON 地址;不要反复重装或悄悄换安装方法。
110
89
  ```
111
90
 
112
- 1. 在 DSH 打开**插件市场**,打开**索引源**列表,添加上面的 URL 并刷新。
113
- 2. 在市场列表中安装 **内阁模式 / Cabinet Mode**(`dsh-cabinet-mode`)。DSH 会把 `dsh-cabinet-mode@<版本>` 从 `https://registry.npmjs.org` 安装到当前 profile。这与方式 A 是同一种 bundle 安装,二者只能选其一。
114
- 3. **完全退出并重启 DeepSeek Harness**,然后新建任务,在模式选择器中选择**内阁模式**。
115
- 4. 以后更新:先在**已安装**页卸载旧版本,再从**插件市场**安装新版本,然后再次重启。市场对第三方插件**没有原地升级**——「有新版本」徽标点下去只是打开「已安装」页。
91
+ ## 备用:Release 包或本地目录安装
116
92
 
117
- 「可更新」如何判定:DSH 只比较 **SemVer 版本号**,同一版本号重新构建不会提示可更新(npm 版本不可变,npm 源不受影响)。**没有任何定时自动检查**:只有打开或刷新插件市场时才抓取索引,缓存 10 分钟。以上为 DSH 0.2.1-rc.5 源码级结论(行号见 [docs/cross-platform.md](docs/cross-platform.md) 第 7 节);真实更新流程未做端到端实测。
93
+ 仅在商店不可用或本地开发时使用。先完全退出桌面 DSH,释放 profile 锁,再执行:
118
94
 
119
- 索引在每次 tag 发布后由 npm registry 重新生成,只列出已发布、未弃用的稳定版本;不要手工编辑 `market-index` 分支。
95
+ ```sh
96
+ dsh plugin --profile desktop add https://github.com/luodaoyi/dsh-cabinet-mode/releases/download/v0.2.2/dsh-cabinet-mode-0.2.2.tgz
97
+ dsh plugin --profile desktop list
98
+ ```
120
99
 
121
- > **发布状态(2026-11-03):** `dsh-cabinet-mode@0.1.4`、`0.1.5`、`0.1.6` 已由 tag 触发的 OIDC 流程发布到 `registry.npmjs.org`,均带 sigstore provenance;`market-index` 分支在每次发布后自动刷新。tag → 发布 → GitHub Release → 刷新索引全链路已两次跑绿(v0.1.5:run 41657224370;v0.1.6:run 41661809576),索引现列出 0.1.6、0.1.5 与 0.1.4。registry 上另有占位版本 `0.0.0-stage`(预发布,索引不列)。
122
- >
123
- > **未验证:** 你所用 DSH 版本的插件市场界面文案与点击路径,以及该 GUI 里的真实安装/更新。上面的 `dsh-cabinet-mode@<版本>` 安装 spec 是格式 1 读取器(`@deepseek-ai/dsh-plugin-market-index@0.2.1-rc.5` 的 `marketInstallTarget`)对 npm 源返回的结果;该函数已在本机执行,界面未实测。
100
+ 核实安装版本,重启 DSH 后新建会话并选择内阁模式。本地开发可把 URL 换成仓库绝对路径;CLI 不可用时,在「插件 → 添加插件」选择 tgz URL 或本地目录。确认目标 profile:`desktop` 是桌面应用 profile。上述方法均不可与手工 preset patch 叠加。可选安装脚本仅提供 persona preset 回退,不提供内阁界面。
124
101
 
125
102
  ## 升级
126
103
 
127
104
  若通过插件市场安装:刷新市场,先在**已安装**页卸载旧版本,再从**插件市场**安装新版本,然后重启——没有 tgz URL 要换,也没有一键更新。否则用同一条安装命令换新版本 URL(或在插件页选新 `.tgz`),然后完全退出并重启 DeepSeek Harness:
128
105
 
129
106
  ```sh
130
- dsh plugin --profile desktop add https://github.com/luodaoyi/dsh-cabinet-mode/releases/download/v0.2.0/dsh-cabinet-mode-0.2.0.tgz
107
+ dsh plugin --profile desktop add https://github.com/luodaoyi/dsh-cabinet-mode/releases/download/v0.2.2/dsh-cabinet-mode-0.2.2.tgz
131
108
  ```
132
109
 
133
110
  `dsh plugin --profile desktop list` 应显示新版本。升级已在 Windows 实测:
@@ -165,13 +142,13 @@ v0.1.2 → v0.1.3 走内嵌 pnpm(DSH 0.2.1-rc.5)。
165
142
 
166
143
  | 方式 | Windows | Linux | macOS | 说明 |
167
144
  |---|---|---|---|---|
168
- | **A. DSH 插件管理器**(推荐):插件页「添加插件 → 本地目录/包」,或 `dsh plugin --profile <profile> add <绝对路径 / .tgz / release URL>` | ✅ 2026-10-29 本机实测:本地目录安装与 **GitHub Release 资产 URL 安装**均成功;`dsh plugin --profile desktop list` = 3 packages;合成校验通过 | ⚙️ 代码级推断,**未在本机实测** | ⚙️ 代码级推断,**未在本机实测** | 纯 YAML bundle:无构建、无依赖、无 OS 专用代码。见 [docs/cross-platform.md](docs/cross-platform.md)。 |
145
+ | **插件市场**(索引源):见 [从插件市场安装](#从插件市场安装索引源推荐) | ✅ **Windows rc.5 web 客户端安装已实测**(隔离 profile,2026-11-05) | ❌ **未实测** | ❌ **未实测** | 通过 DSH 插件市场安装同一个 npm bundle;npm 发布与 `market-index` 分支均已存在。 |
146
+ | **A. DSH 插件管理器**(备用):插件页「添加插件 → 本地目录/包」,或 `dsh plugin --profile <profile> add <绝对路径 / .tgz / release URL>` | ✅ 2026-10-29 本机实测:本地目录安装与 **GitHub Release 资产 URL 安装**均成功;`dsh plugin --profile desktop list` = 3 packages;合成校验通过 | ⚙️ 代码级推断,**未在本机实测** | ⚙️ 代码级推断,**未在本机实测** | 纯 YAML bundle:无构建、无依赖、无 OS 专用代码。见 [docs/cross-platform.md](docs/cross-platform.md)。 |
169
147
  | **B. 回退 node 脚本**(无插件管理器时):`node scripts/install.mjs --profile <profile>` 演练后 `--apply`,写入 profile 的 `cordis.patch.yml` | ✅ 脚本已在 Windows 实测(演练 + 临时副本) | ⚙️ 代码级推断,**未实测** | ⚙️ 代码级推断,**未实测** | 三平台同一路径:`<DSH_HOME>/profiles/<profile>/cordis.patch.yml`。 |
170
- | **插件市场**(索引源):见 [从插件市场安装](#从插件市场安装索引源) | ❌ **GUI 安装未实测**(npm 与索引已于 2026-11-03 上线) | ❌ **未实测** | ❌ **未实测** | 通过 DSH 插件市场安装同一个 npm bundle;npm 发布与 `market-index` 分支均已存在。 |
171
148
 
172
149
  **方式 A 与方式 B 二选一,不可叠加。** 两种方式都会声明 `config.id: cabinet`;同时装会让 preset id 重复,声明加载失败。切换前先卸载旧方式。插件市场安装的是与方式 A 相同的 bundle,同样受这条互斥约束。
173
150
 
174
- ### A. 作为 DSH bundle 安装(推荐,全平台)
151
+ ### A. 备用:直接安装 DSH bundle
175
152
 
176
153
  1. 安装到你在用的 profile:
177
154
  - **插件页**:设置 → 插件 → 添加插件 → 本地目录/包,选择本仓库(或其 `.tgz`)。
@@ -267,7 +244,7 @@ npmjs.com 侧的一次性配置(维护者在网页上完成,无法从本仓
267
244
  - DSH 升级后已装 bundle 或回退 patch 是否保留。
268
245
  - `config.id` 语法校验规则(本 id 为 `cabinet`,仅小写字母)。
269
246
  - preset 声明的 HMR 热生效、私有源/代理下的 tgz 安装。
270
- - **插件市场的真实使用。** 索引解析、npm 安装 spec 解析、把 `dsh-cabinet-mode@0.1.5` 装进一次性 profile 都已在本机执行;tag → 发布 → 自动刷新索引全链路已在 CI 跑通(v0.1.5,run 41657224370);但 DSH 插件市场 GUI 里的真实安装/更新仍未执行。
247
+ - **市场更新与其他客户端。** 已在 Windows rc.5 web 客户端验证添加 raw 索引和安装 0.2.0;卸载后重装的升级流程、其他 DSH 版本与平台尚未验证。
271
248
 
272
249
  ## 已知限制
273
250