dsh-quick-toc 0.7.5 → 0.7.6

package/CHANGELOG.en.md

@@ -2,6 +2,11 @@
 
 All notable changes to **dsh-quick-toc** are documented here. Chinese version: [CHANGELOG.md](CHANGELOG.md).
 
+## [0.7.6] - 2026-09-24
+
+### Fixed
+- **On the 0.1.7 line the settings card's writes only reached the browser**: on a profile whose entry id differs from the first candidate name (the real profile names the entry `dsh-quick-toc` while the first candidate is `quick-toc`), the `configForms.describe()` view was still EMPTY at the moment the plugin applied, so the code that looks up the settings namespace guessed a candidate name the host does not serve and bound a form that never became ready. The card still opened and still took clicks, but every write fell back to this browser's mirror while the settings document (the profile's `cordis.patch.yml` on 0.1.7) stayed untouched — and the console stayed silent. Now an empty view means "the document has not arrived", not "the host serves nothing": the plugin no longer guesses, it subscribes to `describe()` and binds once the document is there, and only then registers the card; a host that never serves a document still gets the card after 4 seconds, reading and writing the browser mirror (the documented fallback layer). Verified on both lines: on 0.1.7-rc.1 the profile's `cordis.patch.yml` gained `lang: en`, on 0.1.5-rc.3 `settings.yaml`'s `dsh-quick-toc:` became `{ handle: 0.6, autoLoad: false, lang: en }`.
+
 ## [0.7.5] - 2026-09-24
 
 ### Changed

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 **dsh-quick-toc** 的重要变更都记录在这里。英文版见 [CHANGELOG.en.md](CHANGELOG.en.md)。
 
+## [0.7.6] - 2026-09-24
+
+### 修复
+- **0.1.7 线上设置卡片的写入只落在浏览器里**：入口 id 与候选名不一致的 profile 上（例如真实 profile 把入口命名为 `dsh-quick-toc`，而候选表第一个是 `quick-toc`），插件加载的那一刻 `configForms.describe()` 的视图**还没到**（实测返回空表），于是找设置命名空间的那段代码按候选名猜了一个**宿主并不服务**的名字，绑上一个永远不就绪的表单——卡片照常能开能点，但所有写入都退回本浏览器的镜像，设置文档（0.1.7 上是 profile 的 `cordis.patch.yml`）永远不动，而且控制台没有任何报错。现在：视图为空时**不再猜名字**（空 ≠ 宿主不服务），改为订阅 `describe()` 并在文档到位后绑定，绑定成功才注册卡片；宿主始终不给文档时 4 秒后仍注册卡片、退回本地镜像这个既有的降级层。0.1.7-rc.1 与 0.1.5-rc.3 两条线都实测确认写入落盘（前者 `cordis.patch.yml` 新增 `lang: en`，后者 `settings.yaml` 的 `dsh-quick-toc:` 变成 `{ handle: 0.6, autoLoad: false, lang: en }`）。
+
 ## [0.7.5] - 2026-09-24
 
 ### 变更

package/README.en.md

@@ -42,7 +42,7 @@ A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/
 
 | Plugin | Supported DSH |
 | --- | --- |
-| **0.7.x** (latest, 0.7.5) | 0.1.5-rc.3, 0.1.7-alpha.1, 0.1.7-alpha.2, 0.1.7-rc.1 |
+| **0.7.x** (latest, 0.7.6) | 0.1.5-rc.3, 0.1.7-alpha.1, 0.1.7-alpha.2, 0.1.7-rc.1 |
 | 0.6.x (0.6.3) | 0.1.5-rc.1, 0.1.5-rc.2 |
 | 0.5.x (0.5.1) | 0.1.5-rc.1, 0.1.5-rc.2 |
 | 0.4.x (0.4.1) | 0.1.5-rc.1, 0.1.5-rc.2 |

package/README.md

@@ -42,7 +42,7 @@
 
 | 插件版本 | 支持的 DSH 版本 |
 | --- | --- |
-| **0.7.x**（最新，0.7.5） | 0.1.5-rc.3、0.1.7-alpha.1、0.1.7-alpha.2、0.1.7-rc.1 |
+| **0.7.x**（最新，0.7.6） | 0.1.5-rc.3、0.1.7-alpha.1、0.1.7-alpha.2、0.1.7-rc.1 |
 | 0.6.x（0.6.3） | 0.1.5-rc.1、0.1.5-rc.2 |
 | 0.5.x（0.5.1） | 0.1.5-rc.1、0.1.5-rc.2 |
 | 0.4.x（0.4.1） | 0.1.5-rc.1、0.1.5-rc.2 |

package/lib/client.js

@@ -7335,6 +7335,13 @@ window.__ModuleLoader__.load({
           try { json = JSON.stringify(ns.schema || {}); } catch (e) { json = ""; }
           if (json.indexOf("sheetZoom") >= 0 && json.indexOf("autoLoad") >= 0) return ns.ns;
         }
+        // An EMPTY describe view means the settings document has not arrived yet
+        // (measured on 0.1.7-rc.1: `served=[]` while the document loads), NOT that
+        // the host serves nothing. Guessing a candidate name here binds the card
+        // to a form that never answers, and every write silently stayed in this
+        // browser's mirror instead of the settings document; the caller waits for
+        // the view instead.
+        if (served.length === 0) return null;
         for (var j = 0; j < candidates.length; j++) {
           try {
             var form = forms.get(candidates[j]);
@@ -7352,7 +7359,7 @@ window.__ModuleLoader__.load({
             if (forms.get(candidates[k])) return candidates[k];
           } catch (e) { /* try the next candidate */ }
         }
-        return candidates[0];
+        return null;
       };
       var pickSettingsScope = function () {
         var scope = getService("settingsScope");
@@ -7365,34 +7372,23 @@ window.__ModuleLoader__.load({
         var forms = getService("configForms");
         if (forms && typeof forms.get === "function") {
           try {
-            return forms.get(formsNamespace(forms));
+            var ns = formsNamespace(forms);
+            // null = the describe view has not arrived: no scope yet, the caller
+            // waits for it instead of binding to a name the host does not serve.
+            if (ns === null) return null;
+            return forms.get(ns);
           } catch (e) { /* leave the localStorage layer in charge */ }
         }
         return null;
       };
-      var boundScope = pickSettingsScope();
-      if (boundScope) {
-        try {
-          prefsStore.attachHost(boundScope);
-        } catch (e) {
-          boundScope = null;
-          console.warn("[dsh-quick-toc] settings scope unavailable, preferences stay in this browser:", e);
-        }
-      }
-
-      // The plugin-configuration card, in whichever seat the running host offers:
-      //  * up to rc.2 it is a keyed `settings.plugin.item` cell under
-      //    Settings → Plugins → Plugin configuration, keyed by the settings namespace;
-      //  * on the alpha the plugin's own page in the sidebar's Plugins list carries it,
-      //    as the bundle's configuration keyed by the npm package name
-      //    (`plugins.bundle.config`). A row-level cell (`plugins.row.config`, keyed
-      //    `<package>#<row id>`) exists too, but a registration there did not reach that
-      //    page in 0.1.7-alpha.1 while the bundle cell did — and these preferences are the
-      //    plugin's, not one row's, so the bundle page is the right seat anyway.
-      // Registering into a slot a given host never declares is inert (the registration
-      // waits), so both are offered unconditionally, and only once a scope bound keeps a
-      // half-configured host from rendering a card that could not read or write anything.
-      if (boundScope) {
+      // Host layer first: bind it, and on 0.1.7 WAIT for the settings document —
+      // its `configForms` describe view is empty until the document arrives, and
+      // binding a guessed namespace there left the card reading and writing this
+      // browser's mirror while the settings document sat untouched.
+      var seatsOffered = false;
+      var offerSeats = function () {
+        if (seatsOffered) return;
+        seatsOffered = true;
         ctx.slots.inject("plugins.bundle.config", function () {
           return ctx.slots.register({
             name: "plugins.bundle.config",
@@ -7407,7 +7403,55 @@ window.__ModuleLoader__.load({
             locale: "dsh-quick-toc"
           }, TocSettingsCard);
         });
+      };
+      var tryAttachHost = function () {
+        var scope = pickSettingsScope();
+        if (!scope) return false;
+        try {
+          prefsStore.attachHost(scope);
+        } catch (e) {
+          console.warn("[dsh-quick-toc] settings scope unavailable, preferences stay in this browser:", e);
+          return false;
+        }
+        offerSeats();
+        return true;
+      };
+      if (!tryAttachHost()) {
+        var formsMirror = null;
+        try {
+          var formsService = getService("configForms");
+          formsMirror = formsService && typeof formsService.describe === "function" ? formsService.describe() : null;
+        } catch (e) { formsMirror = null; }
+        if (formsMirror && typeof formsMirror.subscribe === "function") {
+          var offMirror = null;
+          var adopt = function () {
+            if (tryAttachHost() && typeof offMirror === "function") offMirror();
+          };
+          offMirror = formsMirror.subscribe(adopt);
+          if (typeof formsMirror.ensure === "function") formsMirror.ensure();
+          adopt();
+        }
+        // A host that never serves a document still gets the card, reading and
+        // writing this browser's mirror — the documented fallback layer. The
+        // delay only exists so a slow document is preferred over the fallback.
+        if (!seatsOffered) {
+          setTimeout(function () {
+            if (!seatsOffered) offerSeats();
+          }, 4000);
+        }
       }
+
+      // The plugin-configuration card, in whichever seat the running host offers:
+      //  * up to rc.2 it is a keyed `settings.plugin.item` cell under
+      //    Settings → Plugins → Plugin configuration, keyed by the settings namespace;
+      //  * on the alpha the plugin's own page in the sidebar's Plugins list carries it,
+      //    as the bundle's configuration keyed by the npm package name
+      //    (`plugins.bundle.config`). A row-level cell (`plugins.row.config`, keyed
+      //    `<package>#<row id>`) exists too, but a registration there did not reach that
+      //    page in 0.1.7-alpha.1 while the bundle cell did — and these preferences are the
+      //    plugin's, not one row's, so the bundle page is the right seat anyway.
+      // Registering into a slot a given host never declares is inert, so both are
+      // offered together, once the host layer bound (or the fallback timer fired).
     }
 
     exports.name = "dsh-quick-toc"; // runner attributes slot entries to this registrant

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-quick-toc",
-  "version": "0.7.5",
+  "version": "0.7.6",
   "description": "Conversation TOC for DeepSeek Harness (DSH): a whole-session, turn-grouped Markdown outline with hover previews, a level filter, a full-width curtain, jump-to-end buttons, title/full-text/cross-session search and a Chinese/English interface.",
   "type": "module",
   "main": "lib/index.js",