dsh-deferred-boot 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -1,80 +1,103 @@
-# Changelog
-
-All notable changes to this project are documented in this file.
-The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/).
-
-## [0.3.1] - 2026-11-07
-
-### Added
-- Plugin list inside the configuration form: installed plugins are grouped into
-  third-party and official entries (official collapsed by default), each with a
-  lightweight / medium / heavy startup-cost grade and an estimated mount cost.
-- Checkbox selection writes `deferredPlugins` entries (`id`, `name`,
-  `strategy: "idle"`); the plugin itself and `@deepseek-ai/*` core rows are locked.
-- Estimated extra startup wait shown at the bottom of the form.
-
-### Changed
-- The plugin page item renders a one-line summary in the list and the full form
-  when opened (view-aware: `summary` vs `page`).
-- Right-side columns of the plugin list are fixed-width so grades, state and
-  cost line up.
-
-### Fixed
-- The form no longer crashes (and disappears) before the settings controller is
-  ready: snapshot reads, strict-context access and JSON edits are guarded.
-- The list entry is registered through `plugins.item` so settings → plugins
-  shows the card again.
-
-## [0.3.0] - 2026-11-07
-
-### Added
-- Per-field hints in the configuration form (zh/en), explaining what each
-  value changes.
-- Plugin-market publishing: `scripts/gen-market-index.mjs` generates a
-  format-1 market index (`market/index.json`), and `docs/PUBLISHING.md`
-  documents the npm + index-source flow.
-- npm metadata: keywords, author, engines, files whitelist, and
-  `@deepseek-ai/schemastery` as a runtime dependency.
-
-### Changed
-- The form no longer depends on `props.ctx`; it reads the ctx captured in
-  `apply()`, matching the reference web-search card.
-- README rewritten for the plugin page and npm: badges, install steps,
-  configuration table, development layout.
-
-### Fixed
-- Configuration form showing "配置服务暂不可用" on newer DSH clients.
-
-## [0.2.0] - 2026-11-07
-
-### Added
-- Graphical configuration form on the plugin page (`plugins.bundle.config`),
-  backed by the `deferred-boot` settings namespace; values are saved to the
-  current profile's Cordis patch, so `cordis.patch.yml` no longer has to be
-  edited by hand.
-- `Config` schema with four volatile fields: `idleDelay`, `disposeTimeout`,
-  `readyFallbackMs`, `deferredPlugins`.
-- Locale dictionaries (zh/en) for the plugin page and the form.
-- Icon, LICENSE (MIT), CI workflow, and packaging scripts.
-
-### Fixed
-- `cannot set property "deferredBoot" without provide`: the service is now
-  exposed with `ctx.provide('deferredBoot', api)`, which the strict Cordis 4
-  context requires.
-
-## [0.1.0] - 2026-11-07
-
-### Added
-- Initial scheduler: mounts deferred plugins after the main UI is ready, one
-  target per idle slice.
-- Existence check before `loader.create`, per-target failure isolation,
-  `dispose` raced against `disposeTimeout`, three failed attempts freeze a
-  target as `failed`, and manual `ctx.deferredBoot.ensure(id)` mounting.
-- Strategies: `idle`, `manual`, `inline-lazy`, `disabled`.
-- Tests for the scheduler, config normalization, and the client module.
-
-[0.3.1]: https://github.com/Bu-sheng/dsh-deferred-boot/releases/tag/v0.3.1
-[0.3.0]: https://github.com/Bu-sheng/dsh-deferred-boot/releases/tag/v0.3.0
-[0.2.0]: https://github.com/Bu-sheng/dsh-deferred-boot/releases/tag/v0.2.0
-[0.1.0]: https://github.com/Bu-sheng/dsh-deferred-boot/releases/tag/v0.1.0
+# Changelog
+
+All notable changes to this project are documented in this file.
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.3.2] - 2026-11-07
+
+### Fixed
+- Readiness detection now uses signals that actually exist on the desktop Web
+  GUI: `typertGateway.hasLiveClient()` first, then `webApp.getAdvertisedUrl()`.
+  The previous probes (`connection.hostDescription`, `connection.host`,
+  `app.ready`) are not exported by those services, so every boot waited out
+  `readyFallbackMs` and the plugin effectively just slept 5 s instead of
+  waiting for the first screen.
+- `deferredPlugins` ids are stored without the loader's `include:` prefix:
+  `loader.create` used to reintroduce the full id and collide with the entry a
+  bundle patch had already inserted, which surfaced as duplicate entries and
+  `异常` badges on the plugin page. `normalizeDeferred` / `shortEntryId` in the
+  configuration form and the profile patch use the short id now.
+- Deferred targets are mounted into the loader's `include` group (the same place
+  a bundle patch inserts them) and existing entries are looked up through
+  `loader.resolve`, including the nested `include:<id>` path.
+
+### Changed
+- The plugin page no longer offers deferring the loader's own `cordis:*`
+  namespace nodes, and duplicates are dropped by plugin name before saving.
+
+## [0.3.1] - 2026-11-07
+
+### Added
+- Plugin list inside the configuration form: installed plugins are grouped into
+  third-party and official entries (official collapsed by default), each with a
+  lightweight / medium / heavy startup-cost grade and an estimated mount cost.
+- Checkbox selection writes `deferredPlugins` entries (`id`, `name`,
+  `strategy: "idle"`); the plugin itself and `@deepseek-ai/*` core rows are locked.
+- Estimated extra startup wait shown at the bottom of the form.
+
+### Changed
+- The plugin page item renders a one-line summary in the list and the full form
+  when opened (view-aware: `summary` vs `page`).
+- Right-side columns of the plugin list are fixed-width so grades, state and
+  cost line up.
+
+### Fixed
+- The form no longer crashes (and disappears) before the settings controller is
+  ready: snapshot reads, strict-context access and JSON edits are guarded.
+- The list entry is registered through `plugins.item` so settings → plugins
+  shows the card again.
+
+## [0.3.0] - 2026-11-07
+
+### Added
+- Per-field hints in the configuration form (zh/en), explaining what each
+  value changes.
+- Plugin-market publishing: `scripts/gen-market-index.mjs` generates a
+  format-1 market index (`market/index.json`), and `docs/PUBLISHING.md`
+  documents the npm + index-source flow.
+- npm metadata: keywords, author, engines, files whitelist, and
+  `@deepseek-ai/schemastery` as a runtime dependency.
+
+### Changed
+- The form no longer depends on `props.ctx`; it reads the ctx captured in
+  `apply()`, matching the reference web-search card.
+- README rewritten for the plugin page and npm: badges, install steps,
+  configuration table, development layout.
+
+### Fixed
+- Configuration form showing "配置服务暂不可用" on newer DSH clients.
+
+## [0.2.0] - 2026-11-07
+
+### Added
+- Graphical configuration form on the plugin page (`plugins.bundle.config`),
+  backed by the `deferred-boot` settings namespace; values are saved to the
+  current profile's Cordis patch, so `cordis.patch.yml` no longer has to be
+  edited by hand.
+- `Config` schema with four volatile fields: `idleDelay`, `disposeTimeout`,
+  `readyFallbackMs`, `deferredPlugins`.
+- Locale dictionaries (zh/en) for the plugin page and the form.
+- Icon, LICENSE (MIT), CI workflow, and packaging scripts.
+
+### Fixed
+- `cannot set property "deferredBoot" without provide`: the service is now
+  exposed with `ctx.provide('deferredBoot', api)`, which the strict Cordis 4
+  context requires.
+
+## [0.1.0] - 2026-11-07
+
+### Added
+- Initial scheduler: mounts deferred plugins after the main UI is ready, one
+  target per idle slice.
+- Existence check before `loader.create`, per-target failure isolation,
+  `dispose` raced against `disposeTimeout`, three failed attempts freeze a
+  target as `failed`, and manual `ctx.deferredBoot.ensure(id)` mounting.
+- Strategies: `idle`, `manual`, `inline-lazy`, `disabled`.
+- Tests for the scheduler, config normalization, and the client module.
+
+[0.3.2]: https://github.com/Bu-sheng/dsh-deferred-boot/releases/tag/v0.3.2
+[0.3.1]: https://github.com/Bu-sheng/dsh-deferred-boot/releases/tag/v0.3.1
+[0.3.0]: https://github.com/Bu-sheng/dsh-deferred-boot/releases/tag/v0.3.0
+[0.2.0]: https://github.com/Bu-sheng/dsh-deferred-boot/releases/tag/v0.2.0
+[0.1.0]: https://github.com/Bu-sheng/dsh-deferred-boot/releases/tag/v0.1.0

package/README.md

@@ -8,7 +8,7 @@
 
 ## 特性
 
-- 就绪后再调度：优先 `connection.hostDescription`，退化为 `connection.host`、`app.ready` 轮询与兜底超时
+- 就绪后再调度：优先 `typertGateway.hasLiveClient()`（浏览器页面已接上 RPC 网关），退化为 `webApp.getAdvertisedUrl()`，再退 `app.ready` / `connection` 与兜底超时
 - 分段空闲调度：`scheduler.postTask(background)` → `requestIdleCallback` → `setTimeout`，一次回调只挂一个目标
 - 安全挂载：`loader.create` 前检查同名/同 id 条目，已存在则跳过并标记 `mounted`
 - 故障隔离：每个目标独立 `try/catch`，连续 3 次失败冻结为 `failed`，不影响其余目标

package/docs/design.md

@@ -32,13 +32,19 @@
 
 ### 就绪等待的多重兜底
 
-1. `ctx.connection.hostDescription`（字符串或函数）
-2. `ctx.connection.host`（ready 握手发布的 `{ home }` 对象，流一断即清空）
-3. 任一暴露 `ready === true` 的服务（`app` / `webApp`）
-4. `readyFallbackMs` 计时兜底
+按顺序探测，第一个命中即返回（实现见 `src/scheduler.js` 的 `probeReadySource`）：
+
+1. `typertGateway.hasLiveClient() === true` —— 浏览器页面已接上 RPC 网关，这是桌面 Web GUI 上真正存在的「首屏活了」信号
+2. `webApp.getAdvertisedUrl()` 返回非空 URL —— Web GUI 已在服务（无页面连接时也能命中）
+3. `ctx.app.ready === true`
+4. `ctx.connection.hostDescription`（字符串或函数）
+5. `ctx.connection.host`（ready 握手发布的 `{ home }` 对象，流一断即清空）
+6. `readyFallbackMs` 计时兜底
 
 不硬编码任何宿主事件名。
 
+> 注意：桌面 Web GUI 的 `connection` 服务**没有** `hostDescription` / `host`，`webApp` 也没有 `ready`；这三项只为非 Web 宿主保留。0.3.2 之前只探这三项，实测 60 秒一次都不命中，最终总是走兜底超时，等价于「盲等 5 秒」。
+
 ### HMR 重载后的状态重建
 
 插件重载后从当前 loader 的存在性检查重建状态（`status()` 内部调用 `rebuildFromLoader()`），不会把已挂载目标再挂一遍。
@@ -73,6 +79,7 @@
 
 ## 已知限制
 
-- `hostDescription` 在当前 checkout 的 connection 服务上未以该名字导出；实际可用信号是 `host`（ready 握手对象）。探测顺序已按仓库现状适配。
+- 桌面 Web GUI 的 `connection` 服务不导出 `hostDescription` / `host`，`webApp` 也不导出 `ready`；这三项只在非 Web 宿主上可能命中。Web GUI 上的实际信号是 `typertGateway.hasLiveClient()` 与 `webApp.getAdvertisedUrl()`。
+- 延迟挂载不能只把目标从 bundles 摘掉：DSH 插件页用 `dsh.profile.bundles` 判断启用状态，摘掉后页面会显示为关闭/异常。`loader.create` 与 bundle patch 插入的 entry 同名不同 patchId，同时存在会撞成重复 entry。因此 `deferredPlugins` 只适合「确实想延后、且愿意接受插件页状态不一致」的场景，默认留空。
 - 调度器只负责挂载时机；目标插件在 `apply` 内的同步重活不会被本插件拆分。
 - 图形界面依赖 settings 服务；settings 不可用时表单显示「配置服务尚未就绪」，插件本身仍正常工作。