dsh-vibegap 0.1.0 → 0.1.2

package/README.md

@@ -3,18 +3,36 @@
 VibeGap 的 DeepSeek Harness 原生插件。Agent 持续运行 18 秒后，dsh web
 右下角会出现拼写单词卡；会话完成或等待确认时，完成当前单词后自动收起或继续。
 插件可独立运行，不要求安装 VibeGap Python 桌面端。
-如果本机 VibeGap daemon 正在运行，插件会自动改用桌面端的当前词书和进度游标；
-连接失败或运行中断线时，会回退到浏览器内的独立进度。
+如果本机 VibeGap Core 正在运行，插件会自动改用桌面端的当前词书和进度游标；
+Core 在页面打开后才由另一个 Agent 拉起也能自动接入。连接失败或运行中断线时，
+会回退到浏览器内的独立进度，远端游标会同步回本地作为断线续用位置。
 
 ## 安装
 
-本地开发安装：
+从 npm 安装：
+
+```bash
+dsh plugin --profile web add dsh-vibegap
+dsh web
+```
+
+也可以从发布镜像仓库
+[`dsh-vibegap`](https://github.com/ktao732084-arch/dsh-vibegap) 安装：
+
+```bash
+dsh plugin --profile web add "github:ktao732084-arch/dsh-vibegap#main"
+dsh web
+```
+
+本地开发使用 link 安装：
 
 ```bash
 dsh plugin --profile web add link:<仓库绝对路径>/vibegap/adapters/dsh/plugin
 dsh web
 ```
 
+> 本目录是开发主场;发布走 dsh-vibegap 镜像仓库(改动合入后同步拷贝过去打 tag)。
+
 卸载：
 
 ```bash
@@ -25,8 +43,9 @@ dsh plugin --profile web remove dsh-vibegap
 自动发音偏好通过 dsh 官方 snapshot store 保存在当前浏览器中。无痕模式或浏览器
 拒绝持久化时，卡片仍可使用，但刷新后进度可能丢失。
 
-本机 daemon 可用时，单词和进度改由 `http://127.0.0.1:8765/panel/*` 提供，
-仅允许来自 `localhost` 或 `127.0.0.1` 的 HTTP(S) 浏览器 Origin。
+本机 Core 可用时，单词和进度改由 `http://127.0.0.1:8765/panel/*` 提供，
+插件每 5 秒低频探测一次，且仅允许来自 `localhost` 或 `127.0.0.1` 的
+HTTP(S) 浏览器 Origin。DSH 单独使用时不会因此启动 Python/Core 进程。
 
 ## 使用
 

package/lib/client.js

@@ -18,6 +18,7 @@ window.__ModuleLoader__.load({
     var TRANSLATION_MAX_CHARS = 100;
     var DAEMON_URL = "http://127.0.0.1:8765/panel";
     var DAEMON_TIMEOUT_MS = 1000;
+    var DAEMON_PROBE_MS = 5000;
     var DICT_URL = "https://raw.githubusercontent.com/RealKai42/qwerty-learner/master/public/dicts/CET6_T.json";
     var STYLE_ID = "vg-card-styles";
     var DONE_NOTICE = "会话已完成 · 拼完当前词后收起";
@@ -180,19 +181,39 @@ window.__ModuleLoader__.load({
       if (payload.error) throw new Error(payload.error);
       return payload;
     }
+    function syncLocalProgress(remoteProgress) {
+      if (!remoteProgress || !Number.isFinite(Number(remoteProgress.cursor))) return;
+      progressStore.update(function (draft) {
+        if (!Array.isArray(draft.words) || draft.words.length === 0) return;
+        if (Number(remoteProgress.total) !== draft.words.length) return;
+        draft.cursor = Math.min(Math.max(Number(remoteProgress.cursor), 0), draft.words.length - 1);
+      });
+    }
     function useDaemonBackend() {
       var backend = React.useState({ mode: "probing", word: null });
+      var current = useCell({ mode: "probing", word: null });
+      var setBackend = function (next) { current.current = next; backend[1](next); };
       React.useEffect(function () {
         var active = true;
-        (async function () {
+        var timer = null;
+        async function probe() {
           try {
             var state = await panelRequest("/state");
             if (!state.ready) throw new Error("daemon has no wordbook");
-            var word = await panelRequest("/next-word");
-            if (active) backend[1]({ mode: "daemon", word: word });
-          } catch (_) { if (active) backend[1]({ mode: "local", word: null }); }
-        })();
-        return function () { active = false; };
+            syncLocalProgress(state.progress);
+            var cursor = state.progress && Number(state.progress.cursor);
+            var known = current.current.word && Number(current.current.word.position);
+            if (current.current.mode !== "daemon" || cursor !== known) {
+              var word = await panelRequest("/next-word");
+              if (active) setBackend({ mode: "daemon", word: word });
+            }
+          } catch (_) {
+            if (active && current.current.mode !== "local") setBackend({ mode: "local", word: null });
+          }
+          if (active) timer = setTimeout(probe, DAEMON_PROBE_MS);
+        }
+        probe();
+        return function () { active = false; if (timer) clearTimeout(timer); };
       }, []);
       return backend;
     }
@@ -398,13 +419,14 @@ window.__ModuleLoader__.load({
         advanceProgress(model.selection.ordered.length); return;
       }
       try {
-        await panelRequest("/commit", {
+        var result = await panelRequest("/commit", {
           method: "POST", headers: { "Content-Type": "application/json" },
           body: JSON.stringify({
             result: model.states.peeked[0] ? "fail" : "pass",
             typo_count: model.states.typos[0],
           }),
         });
+        syncLocalProgress(result);
         var word = await panelRequest("/next-word");
         model.backend[1]({ mode: "daemon", word: word });
       } catch (_) { model.backend[1]({ mode: "local", word: null }); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vibegap",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Self-contained vocabulary flashcards for DeepSeek Harness web sessions",
   "main": "lib/index.js",
   "exports": {