feat(dsh): 适配 DSH 0.2.0-rc.1（单线支持）+ v0.24.0
支持线从 ^0.1.7-rc.1 整体前移到 ^0.2.0-rc.1；0.1.7 线（含 npm latest 的 0.1.7-rc.2）停留在 v0.23.0。适配前实测确认这是纯增量，故本版无运行时兼容分支。 必改项（否则装不上/不加载） - 14 条 DSH peer → ^0.2.0-rc.1。实测 caret 跨 minor 不成立：`^0.1.7-rc.1` 展开为 >=0.1.7-rc.1 <0.2.0-0，对 0.2.0-rc.1 判定 false（includePrerelease 也救不了）。判别性验证：把 peer 回退成 ^0.1.7-rc.1 后，在 0.2.0-rc.1 宿主上 `dsh plugin add` 直接拒绝并回滚包树—— "installation rejected: Plugin dsh-better-sidebar@0.24.0 is incompatible with dsh 0.2.0-rc.1: peerDependencies {…^0.1.7-rc.1…}"；恢复 ^0.2.0-rc.1 后安装通过 - 28 个 @deepseek-ai/* devDependencies 精确钉 0.2.0-rc.1（cordis 4.0.4 / cordis-plugin-group 1.0.4 / cordis-plugin-include 1.0.9 不变） - 新增 @deepseek-ai/dsh-util-code-language@0.2.0-rc.1：0.2.0 的 ui-primitives 产物裸 import 它（0.1.7 的产物同样 import，只是旧树里恰好被传递提供）， 不补则所有加载 ui-primitives 的 20 个 spec 在收集期失败 实测证据（写进 docs/plans/2026-09-28-dsh-0.2.0-rc.1-adaptation.md） - 本插件消费的 19 个宿主包零值导出删除（对比 export {} / exports.x=） - 类型面仅 3 处且全为增量：ui-primitives（DisclosureRow/TextShimmer/Tooltip 新增可选 prop、overlay 顶部内距）、dsh-session（新增 ToolCallRecovery）、 dsh-api-remotes（新增 product-analytics remote） - 会话格式仍 v4、SUBAGENT_DESCRIPTOR_VERSION 仍 3、dsh/lib/bin.js 与 dsh-client-modules 运行时逐字节相同、web profile 客户端 inject 列表相同、 ui-primitives 裸 import 集合不变、agent-team 四包类型逐字相同 - 宿主 web profile：新增 desktop-only product-analytics/telemetry（web 上 disabled）；time-context/schedule/ui-schedule（本就 disabled）移入可选 dsh-experimental-schedule-bundle；插件不依赖宿主 schedule 其余同步 - CI 与挂载 lane 钉 @deepseek-ai/dsh@0.2.0-rc.1（scripts/e2e-common.sh 的 DSH_NPX_SPEC/DSH_EXPECT_VERSION、ci.yml），注释记下「0.2.0 首个候选版只挂 next」与「caret 跨 minor 必失效」两条教训 - tests/market-manifest.spec.ts 的 peer 形状断言钉当前基线 tuple - dsh.plugin.json engines.dsh → >=0.2.0-rc.1；SIDEBAR_SERVICE_VERSION → 0.24.0 - README/README_EN、CHANGELOG/CHANGELOG_EN、AGENTS.md（§2 钉版句 + §3 改为 「DSH 版本适配要点」并新增 §3.0 当前基线，0.1.7 内容降为历史分节）、 docs/external-plugin-guide.md 全部同步 验证：pnpm peers check 仅剩上游 better-locale 的 5 条 unmet（非本插件 peer）； typecheck / lint / test（136 文件 1484 通过 9 跳过）/ build 全绿； DSH_CMD='npx -y --package @deepseek-ai/dsh@0.2.0-rc.1 dsh' pnpm test:mount = 7/7； pnpm test:mount:aggregate 通过（聚合双挂载退让）
This commit is contained in:
Menghuan1918
@@ -154,7 +154,9 @@ jobs:
|
||||
# Write an EXACT version, never a dist-tag: when 0.1.7-rc.1 shipped, the
|
||||
# npm `alpha` tag still meant 0.1.7-alpha.2, rc.1 went out on `next`, and
|
||||
# `latest` was still the 0.1.5 line — `@alpha` would mount a host this
|
||||
# plugin no longer supports. The lanes speak the slash-only RPC dialect
|
||||
# plugin no longer supports. The 0.2.0 line repeats the pattern: its
|
||||
# first candidate is `next` while `latest` is still 0.1.7-rc.2.
|
||||
# The lanes speak the slash-only RPC dialect
|
||||
# (tests/e2e/host-protocol.ts).
|
||||
#
|
||||
# The larger heap is the fix for one of the two ways this step used to
|
||||
@@ -177,7 +179,7 @@ jobs:
|
||||
- name: Install dsh CLI (pinned)
|
||||
env:
|
||||
NODE_OPTIONS: --max-old-space-size=4096
|
||||
run: npm install -g @deepseek-ai/dsh@0.1.7-rc.1
|
||||
run: npm install -g @deepseek-ai/dsh@0.2.0-rc.1
|
||||
|
||||
# lib/ is gitignored; the tarball is produced from this build.
|
||||
- name: Build and pack the npm tarball
|
||||
|
||||
@@ -19,11 +19,27 @@
|
||||
|
||||
「npm 打包 → 真实挂载 → 无头渲染」门禁（证明打包产物在真实 DSH 挂载后不 crash）：`pnpm build && pnpm pack` 产 tarball → `scripts/e2e-mount.sh` 装进全新 scratch profile（`dsh plugin --profile web add <tarball>`）并启动真实 `dsh web`（keyless，`--port 0`）→ `tests/e2e/mount.e2e.ts`（Playwright）断言 `[data-dsh-better-sidebar]` 挂载、无错误条/pageerror/console 错误，展开 DSH 原生右侧栏后经其 guide 页逐个打开本插件贡献的 tab 类型**以及宿主自己的终端条目**（必须恰好 1 条——多于 1 条即意味着插件又在遮蔽宿主），再经插件文件树（原生 `files` kind 接管）打开 seed 文件强制加载 editor chunk（`client-editor.js`），并跑 mermaid / README 预览与 sidechat 宿主路由烟测。**`browser` 不在这个清单里，而是显式断言缺席**：DSH 0.1.7 的 `ui-sidebar-browser` 只在 desktop profile 挂载（`web-app` 的 patch 里 `disabled: ctx.get('profileContext')?.name !== 'desktop'`），lane 全走 web profile，钉住「没有」比默默放过更能暴露宿主立场的变化。
|
||||
|
||||
本地：`pnpm build && pnpm pack && pnpm exec playwright install chromium && pnpm test:mount`（`DSH_CMD` 未设时 `scripts/e2e-common.sh` 回退的 npx 钉版是 `DSH_NPX_SPEC`，默认 `@deepseek-ai/dsh@0.1.7-rc.1`——**不钉就会解析 `latest`，而 `latest` 仍是插件已不支持的 0.1.5 线**）。CI 钉 `@deepseek-ai/dsh@0.1.7-rc.1`（**pin 一律写精确版本号，不要写 `@alpha`**：rc.1 上线时 npm `alpha` 指的是 **0.1.7-alpha.2**，rc.1 走的是 `next`；`latest` 仍是 0.1.5-rc.3；peer 下限 `^0.1.7-rc.1`）。该步骤用 `NODE_OPTIONS=--max-old-space-size=4096`：钉版自身的传递依赖是浮动 `^` 范围，上游分阶段发布预发布版时（rc.2 于 2026-09-10 的 14:43–14:57 逐包上线）npm 会组出混合 peer 图，3062 条 ERESOLVE 后 OOM（exit 134）；另一个失败模式是对未发布兄弟包 ETARGET，靠「钉一个已完整发布的版本」修掉。**不要加 `--legacy-peer-deps`**：它跳过的正是全局安装必须提供的 peer，`@deepseek-ai/dsh-app-boot` 在 boot 时 require 的 `@deepseek-ai/cordis-plugin-group` 是 peer 而非 dependency，加了它 CLI 直接 `ERR_MODULE_NOT_FOUND`（实测过一次，见 rc.2 计划 C 节）。`ci-windows` 的 `Test` 跑 `pnpm test:windows`（`--maxWorkers=1`）而非 `pnpm test`——多个 spec 真起进程（`smoke` / `install-powershell` / `git`），2 核 runner 上并行起 ConPTY / 冷启 `powershell.exe` 是超时与 worker 静默死亡的放大器；`vitest.config.ts` 的全局 `testTimeout: 15_000`（默认 5000 在 Windows 上对真起进程的用例太低，三个不同文件先后翻车）是配套的一半。e2e spec 命名 `*.e2e.ts` + vitest `exclude` 双保险；**改 `exclude` 必须保留默认排除项**（exclude 整体替换默认值）。
|
||||
本地：`pnpm build && pnpm pack && pnpm exec playwright install chromium && pnpm test:mount`（`DSH_CMD` 未设时 `scripts/e2e-common.sh` 回退的 npx 钉版是 `DSH_NPX_SPEC`，默认 `@deepseek-ai/dsh@0.2.0-rc.1`——**不钉就会解析 `latest`，而 `latest` 仍是 0.1.7-rc.2**；本机 pnpm 的 registry 是 npmmirror，新预发布常滞后，装不到时用 `pnpm install --registry https://registry.npmjs.org` 一次性覆盖）。CI 钉 `@deepseek-ai/dsh@0.2.0-rc.1`（**pin 一律写精确版本号，不要写 dist-tag**：0.1.7-rc.1 上线时 `alpha` 指的是 **0.1.7-alpha.2**，而 0.2.0-rc.1 只挂在 `next` 上；peer 下限 `^0.2.0-rc.1`）。该步骤用 `NODE_OPTIONS=--max-old-space-size=4096`：钉版自身的传递依赖是浮动 `^` 范围，上游分阶段发布预发布版时（rc.2 于 2026-09-10 的 14:43–14:57 逐包上线）npm 会组出混合 peer 图，3062 条 ERESOLVE 后 OOM（exit 134）；另一个失败模式是对未发布兄弟包 ETARGET，靠「钉一个已完整发布的版本」修掉。**不要加 `--legacy-peer-deps`**：它跳过的正是全局安装必须提供的 peer，`@deepseek-ai/dsh-app-boot` 在 boot 时 require 的 `@deepseek-ai/cordis-plugin-group` 是 peer 而非 dependency，加了它 CLI 直接 `ERR_MODULE_NOT_FOUND`（实测过一次，见 rc.2 计划 C 节）。`ci-windows` 的 `Test` 跑 `pnpm test:windows`（`--maxWorkers=1`）而非 `pnpm test`——多个 spec 真起进程（`smoke` / `install-powershell` / `git`），2 核 runner 上并行起 ConPTY / 冷启 `powershell.exe` 是超时与 worker 静默死亡的放大器；`vitest.config.ts` 的全局 `testTimeout: 15_000`（默认 5000 在 Windows 上对真起进程的用例太低，三个不同文件先后翻车）是配套的一半。e2e spec 命名 `*.e2e.ts` + vitest `exclude` 双保险；**改 `exclude` 必须保留默认排除项**（exclude 整体替换默认值）。
|
||||
|
||||
---
|
||||
|
||||
## 3. DSH 0.1.7 适配要点（0.1.7-rc.1+ 基线）
|
||||
## 3. DSH 版本适配要点
|
||||
|
||||
### 3.0 当前基线：DSH 0.2.0-rc.1（v0.24.0 起）
|
||||
|
||||
**v0.24.0 起仅支持 DSH 0.2.0-rc.1+**（peer 下限 `^0.2.0-rc.1`，CI 与挂载 lane 钉 `@deepseek-ai/dsh@0.2.0-rc.1`）。**0.1.7 线（含 npm `latest` 的 0.1.7-rc.2）停留在 v0.23.0**。
|
||||
|
||||
**教训（本次最贵的一条）**：**caret 范围永远跨不过 minor**。`^0.1.7-rc.1` 展开为 `>=0.1.7-rc.1 <0.2.0-0`，对 `0.2.0-rc.1` 判定为 **false**（实测，`includePrerelease: true` 也救不了）→ 宿主启动预检（§3.4 第 12 条）把整行 `row.disabled = true`，只在 stderr 留一行，插件**静默不加载**。§3.4 第 12 条里「`includePrerelease` 让判定更宽松（`^0.1.6-alpha.2` 也能满足 `0.1.7-rc.1`）」只在**同一 minor 内**成立：那里的上界 `<0.2.0-0` 没被跨过。显式比较器不受此限（`>=0.1.1-rc.2 <0.2.0` 反而容纳 `0.2.0-rc.1`），本仓库仍只用 caret + 当前基线 tuple，并由 `tests/market-manifest.spec.ts` 钉住。
|
||||
|
||||
**0.2.0-rc.1 复查结论（适配前实测，故本版无任何运行时兼容分支）**：
|
||||
- 本插件消费的 **19 个宿主包零值导出删除**（脚本对比每包的 `export {}` / `exports.x=`）；唯一新增是 `ui-primitives` 的 `pointerModality`。
|
||||
- 类型面变化只有三处且全为增量：`ui-primitives`（`DisclosureRow` / `TextShimmer` / `Tooltip` 新增可选 prop、overlay 顶部内距改用 frame overlay inset）、`dsh-session`（新增 `ToolCallRecovery` 与 `openTurnClosers` 的新措辞；`interruptedTurnClosers` 仍在）、`dsh-api-remotes`（新增 product-analytics remote 行）。
|
||||
- **未变**：会话格式仍 v4（无 `session-format-v4-to-v5`）、`SUBAGENT_DESCRIPTOR_VERSION` 仍 3、`dsh/lib/bin.js` 与 `dsh-client-modules` 运行时**逐字节相同**、web profile 客户端 inject 列表相同、`ui-primitives` 裸 import 集合相同（无需新增测试期依赖）、agent-team 四个包类型逐字相同。
|
||||
- **宿主 web profile 组成**：新增 desktop-only `product-analytics` / `desktop-product-telemetry`（web 上 `disabled`）；`time-context` / `schedule` / `ui-schedule`（本就 `disabled`）移入可选 `dsh-experimental-schedule-bundle`。挂载 lane 的「宿主 tab 恰好 1 条（terminal）、browser 缺席」断言不受影响。插件**不依赖**宿主 schedule 服务。
|
||||
- **生态连带**：可选集成 `@huanlin/dsh-plugin-better-locale` 的 peer 钉 `^0.1.x`（最新 0.4.3 也钉 `^0.1.5-rc.2`），在 0.2.0 上必被预检禁用 → `pnpm peers check` 会报它的 5 条 unmet peer，属上游未适配，与本插件自身 14 条 peer 无关。
|
||||
- **本机 dev 树**：先 `pnpm install --registry https://registry.npmjs.org`（npmmirror 对新预发布滞后，直接 `pnpm install` 会 `ERR_PNPM_NO_MATCHING_VERSION`）。
|
||||
|
||||
### 3.1~3.4 历史：DSH 0.1.7 适配要点（0.1.7-rc.1+ 基线，v0.21.1–v0.23.0）
|
||||
|
||||
**v0.21.1 起仅支持 DSH 0.1.7-rc.1+**（peer 下限 `^0.1.7-rc.1`，CI 钉 `@deepseek-ai/dsh@0.1.7-rc.1`）。**下限必须动**：semver 的预发布规则要求比较子与候选版本同 `[major,minor,patch]` 元组，`^0.1.6-alpha.2` 在数学上**永远容纳不下任何 `0.1.7-*` 预发布版**（实测 `0.1.7-alpha.1` 对 `^0.1.6-alpha.2` / `>=0.1.6-alpha.2` 全是 false），而 `^0.1.7-rc.1` 天然容纳 0.1.7 的 rc/正式全线。**下限从 alpha.1 收到 rc.1 是刻意的**：`0.21.0-alpha.1` 从未发布到 npm（`latest` 仍是 v0.19.1，npm 上没有 alpha.1 的下载量），而修掉 rc.1 的 `DiffBlockLabels` 之后，同一份代码在 alpha.1 上会**崩**——alpha.1 的 `DiffBlock` 仍读上游已删除的 `labels.files`。声明与「真机验证过的宿主」一致，比声明一条跑不通的支持线更安全；rc.1 起 peer 还是**启动期硬约束**（见 §3.4 第 12 条），声明过宽的代价从「可能报错」变成「静默不加载」。**支持线取舍**：0.1.6-alpha.2 及更早的用户停留在 **v0.19.1**（0.20.0 这一版从未发布到 npm）——本版破坏面足够大（`dsh-settings` 整体重写、25 个图标具名导出消失、会话格式 v3→v4），按本仓库先例不写运行时兼容层。发版：release.yml 按版本号是否含 `-` 自动选 `alpha`/`latest` dist-tag（`0.21.1` 不含 `-` → `latest`，npm `latest` 由此从 0.19.1 前移到 0.21.1；中间的 `0.21.0-rc.1` 含 `-`，只进过 `alpha` 通道）。
|
||||
|
||||
|
||||
@@ -2,6 +2,16 @@
|
||||
|
||||
> 本文档收录 dsh-better-sidebar 的完整发布历史（最新版摘要见 [README](README.md)；同步发布于 [GitHub Releases](https://github.com/omdsh-dev/DSH-better-sidebar/releases)）。
|
||||
|
||||
### v0.24.0
|
||||
|
||||
> 📦 **支持线前移**：仅适配 DSH **0.2.0-rc.1+**（peer 下限 `^0.2.0-rc.1`，CI 钉 `@deepseek-ai/dsh@0.2.0-rc.1`）。**0.1.7 线（含 npm `latest` 的 0.1.7-rc.2）请固定 v0.23.0**——宿主 0.2.0 的启动兼容性预检按 `semver.satisfies(宿主版本, peer范围, {includePrerelease:true})` 判定，caret 范围跨 minor 不成立（实测 `^0.1.7-rc.1` 对 `0.2.0-rc.1` 为 **false**，整行会被静默禁用），因此本版不保留任何 0.1.7 兼容分支。
|
||||
|
||||
- 📦 **基线抬到 `0.2.0-rc.1`**：14 条 DSH peer + 27 个 `@deepseek-ai/*` devDependencies 同步钉版；`dsh.plugin.json` 的 `engines.dsh` 随之前移；挂载 lane（`scripts/e2e-common.sh`）与 CI 钉版同步。
|
||||
- 🔍 **适配前的实测结论（纯增量，故无运行时改动）**：本插件消费的 19 个宿主包里**零个值导出被删除**；类型面仅 `dsh-client-ui-primitives`（`DisclosureRow`/`TextShimmer`/`Tooltip` 新增可选 prop、overlay 顶部内距）、`dsh-session`（新增 `ToolCallRecovery`）、`dsh-api-remotes`（新增 product-analytics remote）有变化；会话格式仍 **v4**（无迁移包）、`SUBAGENT_DESCRIPTOR_VERSION` 仍 **3**、`dsh/lib/bin.js`（`dsh plugin` / `dsh web` / 启动行 / `--version`）与 `dsh-client-modules` 运行时**逐字节相同**、web profile 的客户端 inject 列表相同、`ui-primitives` 的裸 import 集合相同（无需新增测试期依赖）。
|
||||
- 🧩 **宿主 web profile 组成变化与本插件无关但已核对**：新增 desktop-only 的 `product-analytics` / `desktop-product-telemetry`（web profile 上 `disabled`）；原先就 `disabled` 的 `time-context` / `schedule` / `ui-schedule` 三行移入可选的 `dsh-experimental-schedule-bundle`。「宿主 tab 只有 terminal、browser 缺席」的挂载断言不受影响。
|
||||
- 🧪 **测试与规则**：`tests/market-manifest.spec.ts` 的 peer 形状断言改为钉当前基线 tuple，并把「caret 跨 minor 必失效」写进注释（这条与 §3.4 第 12 条里「includePrerelease 更宽松」的经验不冲突：宽松只发生在同一 minor 内）。
|
||||
- ⚠️ **唯一残留**：可选集成 `@huanlin/dsh-plugin-better-locale`（未被任何源码/测试 import，仅结构化运行时探测）的 peer 钉在 `^0.1.0-rc.8`，其最新 0.4.3 同样钉 `^0.1.5-rc.2`——两者在 0.2.0 上都会被宿主预检禁用，故 `pnpm peers check` 会报它的 5 条 unmet peer。这是上游未适配 0.2.0 的结果，与本插件自身 14 条 peer 无关。
|
||||
|
||||
### v0.22.0
|
||||
|
||||
> 📦 **正式版**（npm `latest`）：仅支持 **DSH 0.1.7-rc.1+**（peer 下限 `^0.1.7-rc.1`，CI 钉 `@deepseek-ai/dsh@0.1.7-rc.1`）——本版没有动支持线，0.21.1 的用户直接升级即可。**DSH 0.1.6-alpha.2 及更早仍请固定 v0.19.1**。主内容是把任务管理页从「子代理拓扑」重做成**工作流图**，并在随后几轮里按真机反馈打磨；期间 DSH 0.1.7 删掉了 Agent Teams 的 Remote 方法，团队与后台任务两个数据面随之改写。
|
||||
|
||||
@@ -2,6 +2,16 @@
|
||||
|
||||
> Full release history of dsh-better-sidebar (see the [README](README_EN.md) for the latest release; also mirrored on [GitHub Releases](https://github.com/omdsh-dev/DSH-better-sidebar/releases)).
|
||||
|
||||
### v0.24.0
|
||||
|
||||
> 📦 **Support line moved**: DSH **0.2.0-rc.1+** only (peer floor `^0.2.0-rc.1`, CI pins `@deepseek-ai/dsh@0.2.0-rc.1`). **The 0.1.7 line (including npm `latest` = 0.1.7-rc.2) should pin v0.23.0** — the 0.2.0 host's startup compatibility preflight evaluates `semver.satisfies(hostVersion, peerRange, {includePrerelease:true})`, and a caret never spans a minor bump (measured: `^0.1.7-rc.1` vs `0.2.0-rc.1` is **false**, so the whole row is disabled silently). This version therefore keeps no 0.1.7 compatibility branch.
|
||||
|
||||
- 📦 **Baseline lifted to `0.2.0-rc.1`**: 14 DSH peers and 27 `@deepseek-ai/*` devDependencies move together; `dsh.plugin.json`'s `engines.dsh` follows; the mount lane (`scripts/e2e-common.sh`) and CI pins follow.
|
||||
- 🔍 **Measured before adapting (purely additive, hence no runtime change)**: across the 19 host packages this plugin consumes, **zero value exports were removed**; the only type-surface changes are `dsh-client-ui-primitives` (optional props on `DisclosureRow` / `TextShimmer` / `Tooltip`, overlay top inset), `dsh-session` (new `ToolCallRecovery`) and `dsh-api-remotes` (a new product-analytics remote); session format stays **v4** (no migration package), `SUBAGENT_DESCRIPTOR_VERSION` stays **3**, `dsh/lib/bin.js` (`dsh plugin` / `dsh web` / the ready line / `--version`) and the `dsh-client-modules` runtime are **byte-identical**, the web profile's client inject list is unchanged, and `ui-primitives`' bare imports are identical (no new test-time dependency).
|
||||
- 🧩 **Host web-profile composition changes, checked though unrelated**: desktop-only `product-analytics` / `desktop-product-telemetry` rows are added (disabled on the web profile); the already-disabled `time-context` / `schedule` / `ui-schedule` rows move into the optional `dsh-experimental-schedule-bundle`. The mount assertion "the host owns exactly one tab entry (terminal) and browser is absent" is unaffected.
|
||||
- 🧪 **Tests and rules**: the peer-shape assertion in `tests/market-manifest.spec.ts` now pins the current baseline tuple and records the "a caret never spans a minor bump" lesson (compatible with §3.4 item 12's "includePrerelease is more permissive" note — that permissiveness only holds inside one minor line).
|
||||
- ⚠️ **Only residue**: the optional `@huanlin/dsh-plugin-better-locale` integration (imported by no source file or test; detected structurally at runtime) pins `^0.1.0-rc.8`, and even its newest 0.4.3 pins `^0.1.5-rc.2` — both fail the 0.2.0 preflight, so `pnpm peers check` reports its 5 unmet peers. That is upstream not having adapted to 0.2.0, unrelated to this plugin's own 14 peers.
|
||||
|
||||
### v0.22.0
|
||||
|
||||
> 📦 **Stable release** (npm `latest`): DSH **0.1.7-rc.1+** only (peer floor `^0.1.7-rc.1`, CI pins `@deepseek-ai/dsh@0.1.7-rc.1`) — the support line is unchanged, so v0.21.1 users can upgrade straight away. **Hosts on DSH 0.1.6-alpha.2 or earlier still pin v0.19.1.** The headline is the Tasks page rebuilt from a "subagent topology" into a **workflow graph**, then polished over several rounds of real-host feedback; along the way DSH 0.1.7 deleted the Agent Teams Remote methods, so both the team and background-job data planes were rewritten.
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
> [!IMPORTANT]
|
||||
> **v0.19.0 起接入 DSH 原生侧边栏**：右列就是 DSH 自己的右侧栏，插件把每个 tab 类型注册为原生 tab（不再自绘右侧面板），只保留自绘的底部工作台与开放给所有插件的 `ctx.betterSidebar` 服务。
|
||||
>
|
||||
> **v0.21.1 起要求 DSH `0.1.7-rc.1+`**（peer 下限 `^0.1.7-rc.1`；本版 v0.22.0 即 npm `latest`）。DSH 0.1.7 自带完整文档预览，插件把只读预览（表格 / PDF / 图片 / Office）整体让给内置，只保留 Markdown / HTML 与可编辑的代码编辑器。**0.1.6-alpha.2 及更早的用户请固定 `dsh-better-sidebar@0.19.1`**；按 DSH 版本选插件版本的对照表见[安装](#-安装)。
|
||||
> **v0.24.0 起要求 DSH `0.2.0-rc.1+`**（peer 下限 `^0.2.0-rc.1`）。0.2.0 对本插件所用的全部宿主 API 是**纯增量**（零导出删除、会话格式仍 v4、CLI 与客户端运行时未变），所以这一版没有运行时兼容分支，只把支持线整体前移。**DSH 0.1.7 线的用户请固定 `dsh-better-sidebar@0.23.0`——caret 范围跨 minor 不成立，`^0.1.7-rc.1` 在 0.2.0 宿主上会被启动预检静默禁用**；按 DSH 版本选插件版本的对照表见[安装](#-安装)。
|
||||
|
||||
<!-- Hero -->
|
||||
<div align="center">
|
||||
@@ -14,7 +14,7 @@
|
||||
<a href="https://github.com/omdsh-dev/DSH-better-sidebar/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/omdsh-dev/DSH-better-sidebar" /></a>
|
||||
<a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" /></a>
|
||||
<a href="https://dshfind.com/zh/plugins/omdsh-dev/DSH-better-sidebar?ref=badge"><img alt="dshfind" src="https://dshfind.com/api/badge/omdsh-dev/DSH-better-sidebar?lang=zh" /></a><br /><br />
|
||||
<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="支持的 DSH 版本（v0.22.0）：0.1.7-rc.1+" src="https://img.shields.io/badge/DSH-0.1.7--rc.1%2B-4d6bfe" /></a>
|
||||
<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="支持的 DSH 版本（v0.24.0）：0.2.0-rc.1+" src="https://img.shields.io/badge/DSH-0.2.0--rc.1%2B-4d6bfe" /></a>
|
||||
<a href="https://github.com/topics/dsh-better-sidebar"><img alt="插件生态：GitHub topic dsh-better-sidebar" src="https://img.shields.io/badge/%E6%8F%92%E4%BB%B6%E7%94%9F%E6%80%81-topic%20dsh--better--sidebar-4d6bfe" /></a><br /><br />
|
||||
<img alt="文件管理" src="https://img.shields.io/badge/-文件管理-4d6bfe" /> <img alt="编辑预览" src="https://img.shields.io/badge/-编辑预览-4d6bfe" /> <img alt="底部工作台" src="https://img.shields.io/badge/-底部工作台-4d6bfe" /> <img alt="文件变动" src="https://img.shields.io/badge/-文件变动-4d6bfe" /> <img alt="后台任务" src="https://img.shields.io/badge/-后台任务-4d6bfe" /> <img alt="侧边对话" src="https://img.shields.io/badge/-侧边对话-4d6bfe" /> <img alt="插件接入" src="https://img.shields.io/badge/-插件接入-4d6bfe" /><br /><br />
|
||||
<b>右侧栏 + 底部面板双工作台</b>，并把 <code>ctx.betterSidebar</code> 服务开放给所有插件——<br />
|
||||
@@ -62,15 +62,16 @@
|
||||
**前置**：已装好 DSH（`dsh web` 能正常运行），Node.js ≥ 20、pnpm ≥ 10。
|
||||
|
||||
**支持的 DSH 版本**：
|
||||
<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="支持的 DSH 版本（v0.22.0）：0.1.7-rc.1+" src="https://img.shields.io/badge/DSH-0.1.7--rc.1%2B-4d6bfe" /></a>
|
||||
<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="支持的 DSH 版本（v0.24.0）：0.2.0-rc.1+" src="https://img.shields.io/badge/DSH-0.2.0--rc.1%2B-4d6bfe" /></a>
|
||||
|
||||
> 📌 **通道与支持线**：`v0.22.0` 是**正式版**（npm `latest`），仅适配 DSH **0.1.7-rc.1+**。**装 DSH 请写精确版本号**：`npm i -g @deepseek-ai/dsh@0.1.7-rc.1`（rc.1 走 npm `next` 通道）。**DSH 0.1.6-alpha.2 及更早的用户请固定 `dsh-better-sidebar@0.19.1`**——0.1.7 的破坏面（设置服务重写、图标导出改名、会话格式 v3→v4）大到本版不写兼容层。
|
||||
> 📌 **通道与支持线**：`v0.24.0` 适配 DSH **0.2.0-rc.1+**（0.2.0 首个候选版走 npm `next` 通道，`latest` 仍是 0.1.7-rc.2）。**装 DSH 请写精确版本号**：`npm i -g @deepseek-ai/dsh@0.2.0-rc.1`。**0.1.7 线的用户请固定 `dsh-better-sidebar@0.23.0`**：0.2.0 是宿主 minor 变更，`^0.1.7-rc.1` 这类 caret 范围在 0.2.0 上会被宿主的启动兼容性预检判定失败、整行静默禁用。
|
||||
|
||||
> 🧭 **按你的 DSH 版本选插件版本**：
|
||||
>
|
||||
> | 你的 DSH 版本 | 安装命令 | 版本 / peer 声明 |
|
||||
> | --- | --- | --- |
|
||||
> | **0.1.7-rc.1+**（含之后的 0.1.7 正式版） | `dsh plugin --profile web add dsh-better-sidebar@latest` | **0.22.0**，`^0.1.7-rc.1` |
|
||||
> | **0.2.0-rc.1+**（含之后的 0.2.0 正式版） | `dsh plugin --profile web add dsh-better-sidebar@latest` | **0.24.0**，`^0.2.0-rc.1` |
|
||||
> | **0.1.7-rc.1 ~ 0.1.7-rc.2**（含 0.1.7 正式版；npm `latest` 目前仍是 0.1.7-rc.2） | `dsh plugin --profile web add dsh-better-sidebar@0.23.0` | **0.23.0**，`^0.1.7-rc.1` |
|
||||
> | 0.1.7-alpha.1 / 0.1.7-alpha.2 | **没有可装版本**——先把 DSH 升到 rc.1，再跑上一行：<br>`npm i -g @deepseek-ai/dsh@0.1.7-rc.1` | — |
|
||||
> | 0.1.6-alpha.2 及更早、`0.1.5-rc.*`（含 npm `latest` 的 0.1.5-rc.3） | `dsh plugin --profile web add dsh-better-sidebar@0.19.1` | **0.19.1**，`^0.1.5-rc.1` |
|
||||
> | `0.1.5-alpha.2` | `dsh plugin --profile web add dsh-better-sidebar@0.19.0-alpha.1` | `^0.1.5-alpha.2` |
|
||||
@@ -190,7 +191,16 @@ dsh registry enable dsh-external/dsh-better-sidebar
|
||||
|
||||
## 🆕 最近更新
|
||||
|
||||
**支持的 DSH 版本**：<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="支持的 DSH 版本（v0.22.0）：0.1.7-rc.1+" src="https://img.shields.io/badge/DSH-0.1.7--rc.1%2B-4d6bfe" /></a> · 完整发布历史见 [Releases](https://github.com/omdsh-dev/DSH-better-sidebar/releases)
|
||||
**支持的 DSH 版本**：<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="支持的 DSH 版本（v0.24.0）：0.2.0-rc.1+" src="https://img.shields.io/badge/DSH-0.2.0--rc.1%2B-4d6bfe" /></a> · 完整发布历史见 [Releases](https://github.com/omdsh-dev/DSH-better-sidebar/releases)
|
||||
|
||||
### v0.24.0
|
||||
|
||||
> 📦 **支持线前移**：仅适配 DSH **0.2.0-rc.1+**（peer 下限 `^0.2.0-rc.1`，CI 钉 `@deepseek-ai/dsh@0.2.0-rc.1`）。**0.1.7 线（含 npm `latest` 的 0.1.7-rc.2）请固定 v0.23.0**：caret 范围跨 minor 不成立，`^0.1.7-rc.1` 在 0.2.0 宿主上会被启动兼容性预检整行禁用（实测 `semver.satisfies('0.2.0-rc.1','^0.1.7-rc.1',{includePrerelease:true}) === false`）。
|
||||
|
||||
- 📦 **基线整体抬到 `0.2.0-rc.1`**：14 条 DSH peer 与 27 个 `@deepseek-ai/*` devDependencies 同步；`dsh.plugin.json` 的 `engines.dsh` 随之前移。
|
||||
- 🔍 **实测确认是纯增量**：本插件用到的 19 个宿主包里**零个值导出被删除**；类型面只有 `ui-primitives`（`DisclosureRow` / `TextShimmer` / `Tooltip` 新增可选 prop、overlay 顶部内距）、`dsh-session`（新增 `ToolCallRecovery`）与 `dsh-api-remotes`（新增 product-analytics remote）变化；会话格式仍 v4、`SUBAGENT_DESCRIPTOR_VERSION` 仍 3、`dsh/lib/bin.js` 与 `dsh-client-modules` 运行时逐字未变。因此**没有为 0.1.7 保留任何兼容分支**。
|
||||
- 🧪 **挂载 lane 与 CI 钉版同步到 `0.2.0-rc.1`**；`tests/market-manifest.spec.ts` 的 peer 形状规则改为钉当前基线 tuple，并记下「caret 跨 minor 必失效」这条教训。
|
||||
- ⚠️ **生态连带**：`@huanlin/dsh-plugin-better-locale`（可选集成，非本插件依赖面）的 peer 钉在 `^0.1.x` 线上，在 0.2.0 上无法加载，其 5 条 unmet peer 是本次 `pnpm peers check` 唯一残留（上游未适配，与本插件的 14 条 peer 无关）。
|
||||
|
||||
### v0.22.0
|
||||
|
||||
@@ -248,7 +258,7 @@ dsh registry enable dsh-external/dsh-better-sidebar
|
||||
## 🛠️ 开发与构建
|
||||
|
||||
```sh
|
||||
pnpm install # @deepseek-ai/* devDependencies 已发布（基线 0.1.7-rc.1，alpha dist-tag），直接解析、无需令牌
|
||||
pnpm install # @deepseek-ai/* devDependencies 已发布（基线 0.2.0-rc.1，走 npm `next` 通道），直接解析、无需令牌
|
||||
pnpm typecheck # tsc --noEmit
|
||||
pnpm lint # eslint .（flat config：js + typescript-eslint + react-hooks recommended）
|
||||
pnpm build # → lib/index.js + lib/invariant.js + lib/client.js + lib/client-registry.js + lib/types
|
||||
|
||||
+16
-6
@@ -3,7 +3,7 @@
|
||||
> [!IMPORTANT]
|
||||
> **Built on DSH's native sidebar API** (since v0.19.0): the right column *is* DSH's own sidebar — the plugin registers every tab type as a native tab (no right panel of its own anymore) and keeps only its self-drawn bottom workbench and the `ctx.betterSidebar` service open to every plugin.
|
||||
>
|
||||
> **Since v0.21.1 the host support floor is DSH `0.1.7-rc.1+`** (peer floor `^0.1.7-rc.1`; v0.22.0 *is* npm's `latest`). DSH 0.1.7 ships a complete document preview of its own, so the plugin hands every read-only preview (spreadsheets / PDF / images / Office) back to the built-in and keeps only Markdown / HTML and the editable code editor. **Hosts on 0.1.6-alpha.2 or earlier should pin `dsh-better-sidebar@0.19.1`** — the DSH-to-plugin version table is in [Installation](#-installation).
|
||||
> **Since v0.24.0 the host support floor is DSH `0.2.0-rc.1+`** (peer floor `^0.2.0-rc.1`). Everything this plugin consumes from 0.2.0 is **purely additive** (zero removed exports, session format still v4, CLI and client runtime byte-identical), so this version carries no runtime compatibility branch — it only moves the support line. **Hosts on the 0.1.7 line should pin `dsh-better-sidebar@0.23.0` — a caret never spans a minor bump, and `^0.1.7-rc.1` is silently disabled by the 0.2.0 startup preflight**; the DSH-to-plugin version table is in [Installation](#-installation).
|
||||
|
||||
<!-- Hero -->
|
||||
<div align="center">
|
||||
@@ -14,7 +14,7 @@
|
||||
<a href="https://github.com/omdsh-dev/DSH-better-sidebar/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/omdsh-dev/DSH-better-sidebar" /></a>
|
||||
<a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" /></a>
|
||||
<a href="https://dshfind.com/en/plugins/omdsh-dev/DSH-better-sidebar?ref=badge"><img alt="dshfind" src="https://dshfind.com/api/badge/omdsh-dev/DSH-better-sidebar?lang=en" /></a><br /><br />
|
||||
<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="Supported DSH versions (v0.22.0): 0.1.7-rc.1+" src="https://img.shields.io/badge/DSH-0.1.7--rc.1%2B-4d6bfe" /></a>
|
||||
<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="Supported DSH versions (v0.24.0): 0.2.0-rc.1+" src="https://img.shields.io/badge/DSH-0.2.0--rc.1%2B-4d6bfe" /></a>
|
||||
<a href="https://github.com/topics/dsh-better-sidebar"><img alt="Plugin ecosystem: GitHub topic dsh-better-sidebar" src="https://img.shields.io/badge/plugin%20ecosystem-topic%20dsh--better--sidebar-4d6bfe" /></a><br /><br />
|
||||
<img alt="File management" src="https://img.shields.io/badge/-File%20management-4d6bfe" /> <img alt="Edit & preview" src="https://img.shields.io/badge/-Edit%20%26%20preview-4d6bfe" /> <img alt="Bottom workbench" src="https://img.shields.io/badge/-Bottom%20workbench-4d6bfe" /> <img alt="Changes" src="https://img.shields.io/badge/-Changes-4d6bfe" /> <img alt="Background tasks" src="https://img.shields.io/badge/-Background%20tasks-4d6bfe" /> <img alt="Side Chat" src="https://img.shields.io/badge/-Side%20Chat-4d6bfe" /> <img alt="Plugin integration" src="https://img.shields.io/badge/-Plugin%20integration-4d6bfe" /><br /><br />
|
||||
<b>A dual workbench (right sidebar + bottom panel)</b> that opens its <code>ctx.betterSidebar</code> service to every plugin —<br />
|
||||
@@ -62,15 +62,16 @@ What this plugin adds on top of DSH's stock sidebar:
|
||||
**Prerequisites**: DSH installed (`dsh web` boots), Node.js ≥ 20, pnpm ≥ 10.
|
||||
|
||||
**Supported DSH versions**:
|
||||
<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="Supported DSH versions (v0.22.0): 0.1.7-rc.1+" src="https://img.shields.io/badge/DSH-0.1.7--rc.1%2B-4d6bfe" /></a>
|
||||
<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="Supported DSH versions (v0.24.0): 0.2.0-rc.1+" src="https://img.shields.io/badge/DSH-0.2.0--rc.1%2B-4d6bfe" /></a>
|
||||
|
||||
> 📌 **Channel and support line**: `v0.22.0` is the **stable release** (npm `latest`) and targets DSH **0.1.7-rc.1+** only. **Pin the DSH version exactly**: `npm i -g @deepseek-ai/dsh@0.1.7-rc.1` (rc.1 rides npm's `next` dist-tag). **Hosts on DSH 0.1.6-alpha.2 or earlier should pin `dsh-better-sidebar@0.19.1`** — 0.1.7's breakage (the settings-service rewrite, the icon-export renames, session format v3→v4) is large enough that this version ships no compatibility layer.
|
||||
> 📌 **Channel and support line**: `v0.24.0` targets DSH **0.2.0-rc.1+** (0.2.0's first candidate rides npm's `next` dist-tag; `latest` is still 0.1.7-rc.2). **Pin the DSH version exactly**: `npm i -g @deepseek-ai/dsh@0.2.0-rc.1`. **Hosts on the 0.1.7 line should pin `dsh-better-sidebar@0.23.0`**: 0.2.0 is a host minor bump, and caret ranges such as `^0.1.7-rc.1` fail the host's startup compatibility preflight on 0.2.0, which disables the whole profile row silently.
|
||||
|
||||
> 🧭 **Pick the plugin version that matches your DSH**:
|
||||
>
|
||||
> | Your DSH | Install command | Version / peer declared |
|
||||
> | --- | --- | --- |
|
||||
> | **0.1.7-rc.1+** (including a later 0.1.7 stable) | `dsh plugin --profile web add dsh-better-sidebar@latest` | **0.22.0**, `^0.1.7-rc.1` |
|
||||
> | **0.2.0-rc.1+** (including a later 0.2.0 stable) | `dsh plugin --profile web add dsh-better-sidebar@latest` | **0.24.0**, `^0.2.0-rc.1` |
|
||||
> | **0.1.7-rc.1 – 0.1.7-rc.2** (and a later 0.1.7 stable; npm `latest` is still 0.1.7-rc.2) | `dsh plugin --profile web add dsh-better-sidebar@0.23.0` | **0.23.0**, `^0.1.7-rc.1` |
|
||||
> | 0.1.7-alpha.1 / 0.1.7-alpha.2 | **nothing to install** — move DSH to rc.1 first, then run the row above:<br>`npm i -g @deepseek-ai/dsh@0.1.7-rc.1` | — |
|
||||
> | 0.1.6-alpha.2 and earlier, `0.1.5-rc.*` (including the 0.1.5-rc.3 that is npm's `latest`) | `dsh plugin --profile web add dsh-better-sidebar@0.19.1` | **0.19.1**, `^0.1.5-rc.1` |
|
||||
> | `0.1.5-alpha.2` | `dsh plugin --profile web add dsh-better-sidebar@0.19.0-alpha.1` | `^0.1.5-alpha.2` |
|
||||
@@ -199,7 +200,16 @@ WeChat / QQ group QR codes will live here. After uploading the QR images (drag t
|
||||
<a href="https://github.com/user-attachments/assets/946f7028-4967-461e-a750-d1b5056b62d0"><img width="33%" alt="Service API base screenshot" src="https://github.com/user-attachments/assets/946f7028-4967-461e-a750-d1b5056b62d0" /></a>
|
||||
</div>
|
||||
|
||||
**Supported DSH versions**: <a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="Supported DSH versions (v0.22.0): 0.1.7-rc.1+" src="https://img.shields.io/badge/DSH-0.1.7--rc.1%2B-4d6bfe" /></a> · full release history on the [Releases](https://github.com/omdsh-dev/DSH-better-sidebar/releases) page
|
||||
**Supported DSH versions**: <a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="Supported DSH versions (v0.24.0): 0.2.0-rc.1+" src="https://img.shields.io/badge/DSH-0.2.0--rc.1%2B-4d6bfe" /></a> · full release history on the [Releases](https://github.com/omdsh-dev/DSH-better-sidebar/releases) page
|
||||
|
||||
### v0.24.0
|
||||
|
||||
> 📦 **Support line moved**: DSH **0.2.0-rc.1+** only (peer floor `^0.2.0-rc.1`, CI pins `@deepseek-ai/dsh@0.2.0-rc.1`). **The 0.1.7 line (including npm `latest` = 0.1.7-rc.2) should pin v0.23.0**: a caret never spans a minor bump, so `^0.1.7-rc.1` fails the 0.2.0 host's startup compatibility preflight and the whole row is disabled (measured: `semver.satisfies('0.2.0-rc.1','^0.1.7-rc.1',{includePrerelease:true}) === false`).
|
||||
|
||||
- 📦 **Baseline lifted to `0.2.0-rc.1`**: 14 DSH peers and 27 `@deepseek-ai/*` devDependencies move together; `dsh.plugin.json`'s `engines.dsh` follows.
|
||||
- 🔍 **Measured as purely additive**: across the 19 host packages this plugin consumes, **zero value exports were removed**; the only type-surface changes are `ui-primitives` (optional props on `DisclosureRow` / `TextShimmer` / `Tooltip`, plus the overlay top inset), `dsh-session` (new `ToolCallRecovery`) and `dsh-api-remotes` (a new product-analytics remote). Session format stays v4, `SUBAGENT_DESCRIPTOR_VERSION` stays 3, and `dsh/lib/bin.js` plus the `dsh-client-modules` runtime are byte-identical — so **no compatibility branch for 0.1.7 is kept**.
|
||||
- 🧪 **Mount lane and CI pins follow to `0.2.0-rc.1`**; the peer-shape rule in `tests/market-manifest.spec.ts` now pins the current baseline tuple and records the "a caret never spans a minor bump" lesson.
|
||||
- ⚠️ **Ecosystem side effect**: the optional `@huanlin/dsh-plugin-better-locale` integration pins the `^0.1.x` line and cannot load on 0.2.0; its 5 unmet peers are the only residue in `pnpm peers check` (upstream has not adapted; unrelated to this plugin's own 14 peers).
|
||||
|
||||
### v0.22.0
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
> 面向 **消费插件开发者**：如何让你的插件向 better-sidebar 注册新的侧边栏页面（tab）和文件类型预览器。
|
||||
>
|
||||
> 适用版本：**v0.4.0+**（`ctx.betterSidebar` 服务）；声明式设置 **v0.4.1+**；text/number 设置行 **v0.11.0+**；badge/生命周期/定向打开/插件设置/版本探测 **v0.12.0+**；select 设置行（`settingSelect`）与外链认领（`urlTarget`）**v0.13.0+**；统一 `@deepseek-ai/cordis` 类型基底 **v0.15.2+**。当前版本 **v0.22.0**（npm dist-tag `latest`，peer 下限 `^0.1.7-rc.1`，仅支持 DSH **0.1.7-rc.1+**）。**v0.19.0 移除了自绘右侧面板与自由窗口**（见 §0、§11）；**自 v0.20.0 开发线起**（**注意：0.20.0 从未发布到 npm，这些变更全部落在 v0.21.1**）插件**移除了自带的终端**（宿主 0.1.6 的 `ui-sidebar-terminal` 取代，见 §4.4）、**移除了终端固定（pin）**，并在 0.1.7 上**把浏览器视图与只读文件预览整体让给宿主**（`ui-sidebar-browser` / `ui-sidebar-documentpreview`，见 §4.4、§5.4）、**收敛了外链接管**（见 §4.1）、**重写了设置接入面**（`SettingsForms`，见 §8.2）、**给文件树加了实时刷新**（见 §10）；同时**删除了轮尾产物行接管**（DSH 0.1.6 把 `conversation.chat.turnTail` 从 chain 改成只能追加的 list，替换语义不复存在）。
|
||||
> 适用版本：**v0.4.0+**（`ctx.betterSidebar` 服务）；声明式设置 **v0.4.1+**；text/number 设置行 **v0.11.0+**；badge/生命周期/定向打开/插件设置/版本探测 **v0.12.0+**；select 设置行（`settingSelect`）与外链认领（`urlTarget`）**v0.13.0+**；统一 `@deepseek-ai/cordis` 类型基底 **v0.15.2+**。当前版本 **v0.24.0**（peer 下限 `^0.2.0-rc.1`，仅支持 DSH **0.2.0-rc.1+**；0.1.7 线请用 v0.23.0——caret 范围跨 minor 不成立，`^0.1.7-rc.1` 会被 0.2.0 宿主的启动预检静默禁用）。**v0.19.0 移除了自绘右侧面板与自由窗口**（见 §0、§11）；**自 v0.20.0 开发线起**（**注意：0.20.0 从未发布到 npm，这些变更全部落在 v0.21.1**）插件**移除了自带的终端**（宿主 0.1.6 的 `ui-sidebar-terminal` 取代，见 §4.4）、**移除了终端固定（pin）**，并在 0.1.7 上**把浏览器视图与只读文件预览整体让给宿主**（`ui-sidebar-browser` / `ui-sidebar-documentpreview`，见 §4.4、§5.4）、**收敛了外链接管**（见 §4.1）、**重写了设置接入面**（`SettingsForms`，见 §8.2）、**给文件树加了实时刷新**（见 §10）；同时**删除了轮尾产物行接管**（DSH 0.1.6 把 `conversation.chat.turnTail` 从 chain 改成只能追加的 list，替换语义不复存在）。
|
||||
> 权威代码：`src/client/service.ts`（服务实现）、`src/client/builtins/`（内置 5 tab + 3 viewer 参考实现）、`lib/types/client/service.d.ts`（类型声明）。
|
||||
> 仓库开发规则（硬约束 / CI / 发版）见 [AGENTS.md](../AGENTS.md)。
|
||||
|
||||
|
||||
@@ -0,0 +1,70 @@
|
||||
# DSH 0.2.0-rc.1 适配记录（v0.24.0）
|
||||
|
||||
> 状态：已实施。支持线从 `^0.1.7-rc.1` 整体前移到 `^0.2.0-rc.1`（**单线**：0.1.7 用户停在 v0.23.0）。
|
||||
> 上游发布：[dsh-v0.2.0-rc.1](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.0-rc.1)（npm dist-tag `next`；`latest` 仍是 0.1.7-rc.2）。
|
||||
|
||||
## 0. 结论先行
|
||||
|
||||
**0.2.0-rc.1 对本插件所消费的全部宿主 API 是纯增量**：19 个被用到的宿主包**零值导出删除**，会话格式与子代理描述符版本未动，CLI 与客户端运行时逐字节相同。因此本版**没有为 0.1.7 写任何运行时兼容分支**——唯一必须改的是 peer 下限（否则宿主启动预检会静默禁用整行）。
|
||||
|
||||
## 1. 硬阻塞：caret 跨 minor 不成立
|
||||
|
||||
`packages/boot/app-boot/src/plugin-compatibility.ts`（0.1.7-rc.1 起）遍历 profile 行的 `peerDependencies`，对名字为 `@deepseek-ai/dsh` / `@deepseek-ai/dsh-*` 的条目跑
|
||||
`semver.satisfies(宿主版本, 范围, { includePrerelease: true })`，不满足就 `row.disabled = true`，只在 stderr 留一行 `disabling profile plugin …`。
|
||||
|
||||
实测（semver 7，`includePrerelease: true`）：
|
||||
|
||||
| range | 对 `0.2.0-rc.1` |
|
||||
| --- | --- |
|
||||
| `^0.1.7-rc.1` | **false**（caret 上界展开为 `<0.2.0-0`） |
|
||||
| `^0.2.0-rc.1` | true |
|
||||
| `>=0.1.7-rc.1 <0.3.0` | true（显式比较器不带 `-0` 上界） |
|
||||
| `>=0.1.1-rc.2 <0.2.0` | true（同上，`dsh-whale-report` 正因此仍能加载） |
|
||||
|
||||
**教训**：`AGENTS.md` §3.4 第 12 条(c) 那条「`includePrerelease` 让判定更宽松（`^0.1.6-alpha.2` 也能满足 `0.1.7-rc.1`）」**只在同一 minor 内成立**；跨 minor 时必须同步抬 peer 下限。用户已选择**单线**方案，不做「同时覆盖两条线」的放宽范围。
|
||||
|
||||
## 2. 适配前实测证据（决定了「零运行时改动」）
|
||||
|
||||
| 检查面 | 方法 | 结果 |
|
||||
| --- | --- | --- |
|
||||
| 值导出删除 | 对插件 import 的 19 个宿主包，提取 `lib/*.js` 里 `export {…}` / `exports.x=` 的名字集合做差 | **removed = none**；唯一新增 `ui-primitives` 的 `pointerModality` |
|
||||
| 类型面变化 | `lib/types/**` 逐文件 hash + diff | 仅 3 处：`ui-primitives`（`DisclosureRow` / `TextShimmer` / `Tooltip` 新增可选 prop、overlay 顶部内距改用 frame overlay inset）、`dsh-session`（新增 `ToolCallRecovery`；`interruptedTurnClosers` 仍在）、`dsh-api-remotes`（新增 product-analytics remote 行） |
|
||||
| 会话格式 | 查 `SESSION_FORMAT_VERSION` 与 `session-format-*` 迁移包清单 | 仍 **v4**，无 `session-format-v4-to-v5` |
|
||||
| 子代理描述符 | `grep SUBAGENT_DESCRIPTOR_VERSION` | 仍 **3** |
|
||||
| CLI 契约 | `diff dsh/lib/bin.js` | **字节相同**（`dsh plugin` / `dsh web` / 就绪行 / `--version` 全不变） |
|
||||
| 客户端运行时 | `diff dsh-client-modules/lib/index.js`、客户端包 `provide(...)` 名字、web-app 的 `dsh.client.inject` | 全部相同 |
|
||||
| 测试期依赖 | 对比 `ui-primitives` 产物的裸 import 集合 | 相同 → **无需新增 devDependency**（不重演 0.1.7 §3.3 第 12 条） |
|
||||
| agent-team | 四个包的 `lib/types` hash | 逐字相同 |
|
||||
| web profile 组成 | `web-app/cordis.patch.yml` diff | 新增 desktop-only `product-analytics` / `desktop-product-telemetry`（web 上 `disabled`）；`time-context` / `schedule` / `ui-schedule`（本就 `disabled`）移入可选 `dsh-experimental-schedule-bundle`。挂载 lane 的「宿主 tab 恰 1 条（terminal）、browser 缺席」断言不受影响 |
|
||||
|
||||
## 3. 实施内容
|
||||
|
||||
1. `package.json`：14 条 DSH peer → `^0.2.0-rc.1`；27 个 `@deepseek-ai/*` devDependencies 精确钉版 → `0.2.0-rc.1`（`@deepseek-ai/cordis` 4.0.4 / `cordis-plugin-group` 1.0.4 / `cordis-plugin-include` 1.0.9 不变）；`version` → `0.24.0`。
|
||||
2. `dsh.plugin.json`：`engines.dsh` → `>=0.2.0-rc.1`（零读者的元数据，但保持诚实）。
|
||||
3. `scripts/e2e-common.sh`：`DSH_NPX_SPEC` 与 `DSH_EXPECT_VERSION` → `0.2.0-rc.1`。
|
||||
4. `.github/workflows/ci.yml`：`npm install -g @deepseek-ai/dsh@0.2.0-rc.1` + 注释补「0.2.0 首个候选版只挂在 `next` 上」。
|
||||
5. `tests/market-manifest.spec.ts`：peer 形状正则钉当前基线 tuple（`/^\^0\.2\.0-[a-z0-9.]+$/`），并把「caret 跨 minor 必失效」写进注释。
|
||||
6. 文档：`README.md` / `README_EN.md`（支持线横幅、shields 徽章、安装对照表新增 0.2.0 行并保留 0.1.7 行的 v0.23.0 指引、最近更新新增 v0.24.0）、`CHANGELOG.md` / `CHANGELOG_EN.md`（v0.24.0 条目）、`AGENTS.md`（§2 钉版句、§3 改为「DSH 版本适配要点」并新增 §3.0 当前基线 + 0.1.7 历史分节）、`docs/external-plugin-guide.md`（当前版本与 peer 下限）。
|
||||
7. **未改任何 `src/**` 运行时代码**——证据见 §2。
|
||||
|
||||
## 4. 已知残留（非本插件可解）
|
||||
|
||||
- `@huanlin/dsh-plugin-better-locale`（**可选**集成；没有任何源码或测试 import 它，运行时靠 `ctx.get('betterLocale')` 结构化探测）的 peer 钉在 `^0.1.0-rc.8`，其最新 0.4.3 也钉 `^0.1.5-rc.2` → 在 0.2.0 上都会被宿主预检禁用。因此 `pnpm peers check` 会报它的 **5 条 unmet peer**；本插件自身的 14 条 peer 全部满足。属上游未适配 0.2.0。
|
||||
- 本机 pnpm 的 registry 是 `registry.npmmirror.com`，对新预发布滞后（本次实测：镜像上 `@deepseek-ai/dsh-attachment@0.2.0-rc.1` 不存在 → `ERR_PNPM_NO_MATCHING_VERSION`）。安装用一次性覆盖：`pnpm install --registry https://registry.npmjs.org`。
|
||||
- `@deepseek-ai/dsh-experimental-agent-team-web-profile` 仍无 0.1.7 / 0.2.0 发布（停在 0.1.6-alpha.2）→ 本机实例升级时该行保持旧版，运行时兼容性属**未验证**（见 §5）。
|
||||
|
||||
## 5. 本机 3080 实例升级（与仓库适配分开执行）
|
||||
|
||||
升级前的 profile 预检（18 个依赖，按宿主同一套 semver 语义逐个判定）：
|
||||
|
||||
| 依赖 | DSH peer | 0.2.0-rc.1 |
|
||||
| --- | --- | --- |
|
||||
| `dsh-better-sidebar@0.23.0` | `^0.1.7-rc.1` | **会被禁用** → 本版 v0.24.0 修复 |
|
||||
| `dshmarket@1.35.0` | `^0.1.0-rc.7 \|\| ^0.1.1-rc.2`（最新 1.66.3 的 `dsh-settings` peer 仍是 `^0.1.x`） | **会被禁用**（上游未适配，无法绕过） |
|
||||
| `dsh-whale-report@0.5.4` | `>=0.1.1-rc.2 <0.2.0` | 可加载（显式比较器） |
|
||||
| `dsh-notification@0.1.4` | `*` | 可加载 |
|
||||
| `dsh-feishu-notify` / `dsh-flowglass` / `dsh-lan-access` / `dsh-apollo` / `dsh-tauri*` | 无 DSH peer | 不被预检拦（运行时未验证） |
|
||||
| `@deepseek-ai/dsh-experimental-agent-team-profile` | 无 DSH peer | 升级到 0.2.0-rc.1 |
|
||||
| `@deepseek-ai/dsh-experimental-agent-team-web-profile@0.1.6-alpha.2` | 无 DSH peer | 保持旧版（无 0.2.0 发布），运行时未验证 |
|
||||
|
||||
升级步骤（含回滚）见最终交付说明：备份 `~/.dsh/dsh-web.sh` 与 `profiles/web/package.json` → launcher 的 npx 钉版 → `0.2.0-rc.1` → 升 agent-team profile → 装 v0.24.0 tarball → `pm2 restart dsh-web` → 核对路由与 `pm2 logs` 的 `disabling profile plugin` 行。
|
||||
+2
-2
@@ -1,10 +1,10 @@
|
||||
{
|
||||
"id": "dsh-external/dsh-better-sidebar",
|
||||
"version": "0.23.0",
|
||||
"version": "0.24.0",
|
||||
"main": "./lib/index.js",
|
||||
"description": "更好用的右侧边栏——文件树、编辑器、文件变动、任务和侧边对话都收在这一栏里，每个会话互不干扰。暴露服务供其他插件注册侧边栏页面与文件预览器",
|
||||
"engines": {
|
||||
"dsh": ">=0.1.7-rc.1"
|
||||
"dsh": ">=0.2.0-rc.1"
|
||||
},
|
||||
"contributes": {
|
||||
"tools": [],
|
||||
|
||||
+43
-42
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "dsh-better-sidebar",
|
||||
"version": "0.23.0",
|
||||
"version": "0.24.0",
|
||||
"description": "Better Sidebar for DSH — file tree, editor, changes, tasks and side chat in one column, separate for every conversation. Also exposes a service other plugins use to register sidebar tabs and file viewers.",
|
||||
"type": "module",
|
||||
"repository": {
|
||||
@@ -94,20 +94,20 @@
|
||||
"license": "MIT",
|
||||
"peerDependencies": {
|
||||
"@deepseek-ai/cordis": "^4.0.4",
|
||||
"@deepseek-ai/dsh-agent": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-client-locale": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-conversation": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-primitives": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-settings": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-sidebar-right": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-slots": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-host-webserver": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-invariants": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-llm": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-session": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-settings": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-subagent": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-tools": "^0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-agent": "^0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-client-locale": "^0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-conversation": "^0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-primitives": "^0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-settings": "^0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-sidebar-right": "^0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-slots": "^0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-host-webserver": "^0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-invariants": "^0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-llm": "^0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-session": "^0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-settings": "^0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-subagent": "^0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-tools": "^0.2.0-rc.1",
|
||||
"@huanlin/dsh-plugin-better-locale": "^0.1.0",
|
||||
"react": "^18.2.0",
|
||||
"react-dom": "^18.2.0"
|
||||
@@ -157,33 +157,34 @@
|
||||
"@deepseek-ai/cordis": "4.0.4",
|
||||
"@deepseek-ai/cordis-plugin-group": "1.0.4",
|
||||
"@deepseek-ai/cordis-plugin-include": "1.0.9",
|
||||
"@deepseek-ai/dsh-agent": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-agent-loop": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-attachment": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-client-locale": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-client-store": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-sidebar-right": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-host-webserver": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-invariants": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-llm": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-ptc-runtime": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-sandbox": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-sandbox-policy": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-scope": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-session": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-session-persistence": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-session-projection": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-settings": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-subagent": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-system-prompt": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-tools": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-user-approval": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-util-time": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-util-workspace-path": "0.1.7-rc.1",
|
||||
"@deepseek-ai/dsh-agent": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-agent-loop": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-attachment": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-client-locale": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-client-store": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-conversation": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-sidebar-right": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-host-webserver": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-invariants": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-llm": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-ptc-runtime": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-sandbox": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-sandbox-policy": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-scope": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-session": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-session-persistence": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-session-projection": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-settings": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-subagent": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-system-prompt": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-tools": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-user-approval": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-util-code-language": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-util-time": "0.2.0-rc.1",
|
||||
"@deepseek-ai/dsh-util-workspace-path": "0.2.0-rc.1",
|
||||
"@eslint/js": "^10.0.1",
|
||||
"@huanlin/dsh-plugin-better-locale": "^0.1.0",
|
||||
"@playwright/test": "^1.62.1",
|
||||
|
||||
Generated
+371
-362
File diff suppressed because it is too large
Load Diff
@@ -42,11 +42,12 @@ e2e_require_cmd() {
|
||||
# 缺省值（`dsh`）由调用方从环境变量取好传入。
|
||||
#
|
||||
# 回退的 npx 版本是显式钉死的：不钉就会解析 npm 的 `latest` dist-tag，而
|
||||
# 0.1.7 线目前只有预发布（`latest` 仍是 0.1.5-rc.3），冒烟会静静地挂到一
|
||||
# 个插件已不支持的宿主上。**必须写精确版本，不能写 `@alpha`**：0.1.7-rc.1
|
||||
# 上线时 `alpha` 指的是 0.1.7-alpha.2，rc.1 走的是 `next`。钉版必须与
|
||||
# package.json 的 peer 下限同步。
|
||||
DSH_NPX_SPEC="${DSH_NPX_SPEC:-@deepseek-ai/dsh@0.1.7-rc.1}"
|
||||
# 0.2.0 线目前只有预发布（`latest` 仍是 0.1.7-rc.2，0.2.0-rc.1 走 `next`），
|
||||
# 冒烟会静静地挂到一个插件已不支持的宿主上。**必须写精确版本，不能写
|
||||
# `@next`/`@alpha` 之类的 dist-tag**：0.1.7-rc.1 上线时 `alpha` 指的是
|
||||
# 0.1.7-alpha.2，0.2.0-rc.1 又只挂在 `next` 上。钉版必须与 package.json 的
|
||||
# peer 下限同步（caret 跨 minor 不成立：`^0.1.7-rc.1` 实测不满足 0.2.0-rc.1）。
|
||||
DSH_NPX_SPEC="${DSH_NPX_SPEC:-@deepseek-ai/dsh@0.2.0-rc.1}"
|
||||
e2e_resolve_dsh_cmd() {
|
||||
local explicit="${DSH_CMD}"
|
||||
if ! command -v "$DSH_CMD" >/dev/null 2>&1; then
|
||||
@@ -68,7 +69,7 @@ e2e_resolve_dsh_cmd() {
|
||||
# 己在挂什么），只告警。
|
||||
e2e_check_dsh_version() {
|
||||
local explicit="$1" actual expected
|
||||
expected="${DSH_EXPECT_VERSION:-0.1.7-rc.1}"
|
||||
expected="${DSH_EXPECT_VERSION:-0.2.0-rc.1}"
|
||||
# `dsh --version` 冷启动要走 npx，给足预算；拿不到版本就只告警。
|
||||
actual="$($DSH_CMD --version 2>/dev/null | tr -d '[:space:]' | head -c 64 || true)"
|
||||
case "$actual" in
|
||||
|
||||
@@ -639,7 +639,7 @@ export function matchUrlTarget(tabs: readonly TabDescriptor[], url: URL): TabDes
|
||||
* The plugin version this service instance reports. Keep in lockstep with
|
||||
* `package.json`'s version — `tests/service.spec.ts` asserts the pair.
|
||||
*/
|
||||
export const SIDEBAR_SERVICE_VERSION = '0.23.0'
|
||||
export const SIDEBAR_SERVICE_VERSION = '0.24.0'
|
||||
|
||||
/**
|
||||
* Monotonic capability list consumers use to gate new API usage (features
|
||||
|
||||
@@ -123,15 +123,25 @@ describe('DSH community-market manifest compatibility', () => {
|
||||
// and DISABLES the whole profile row when it fails — one stderr line in a
|
||||
// log nobody reads, no dialog, and `peerDependenciesMeta.optional` grants
|
||||
// no exemption. An exact pin (the style devDependencies use) or a
|
||||
// comparator carrying no prerelease (`^0.1.7`) would therefore make the
|
||||
// comparator carrying no prerelease (`^0.2.0`) would therefore make the
|
||||
// plugin silently stop loading, so the published ranges must stay carets
|
||||
// on the baseline tuple. `pnpm peers check` cannot see this: it validates
|
||||
// the resolved dev tree, not the range shape a host will read.
|
||||
//
|
||||
// A caret NEVER spans a minor bump, even with `includePrerelease` on:
|
||||
// `^0.1.7-rc.1` expands to `>=0.1.7-rc.1 <0.2.0-0`, so it rejects
|
||||
// `0.2.0-rc.1` (measured: false) and a 0.2.0 host would disable the row
|
||||
// instead of loading the plugin. The support line therefore moves WITH the
|
||||
// baseline and is never widened to "cover both lines". (An explicit
|
||||
// comparator behaves differently — `>=0.1.1-rc.2 <0.2.0` does admit
|
||||
// `0.2.0-rc.1`, because only carets get the `-0` upper bound — which is why
|
||||
// the assertion below pins the baseline tuple instead of accepting any
|
||||
// caret that looks plausible.)
|
||||
const peers = pkg.peerDependencies ?? {}
|
||||
const dshPeers = Object.keys(peers).filter(name => name === '@deepseek-ai/dsh' || name.startsWith('@deepseek-ai/dsh-'))
|
||||
expect(dshPeers.length).toBeGreaterThan(10)
|
||||
for (const name of dshPeers) {
|
||||
expect(peers[name], name).toMatch(/^\^0\.1\.7-[a-z0-9.]+$/)
|
||||
expect(peers[name], name).toMatch(/^\^0\.2\.0-[a-z0-9.]+$/)
|
||||
}
|
||||
})
|
||||
})
|
||||
|
||||
Reference in New Issue
Block a user