@lemoncat7/dsh-knowledge 2.6.1 → 2.7.0

package/README.md

@@ -8,6 +8,16 @@
 
 ## 兼容性
 
+### 2.7.0 更新
+
+正式版，适配 DSH **0.1.2-rc.1**。
+
+- 新增回写任务工作区：按最新创建顺序查看队列、日期、阻塞项、失败原因和写入目标，支持重试与取消。
+- 保留中断后的内容快照和写入计划，支持重启恢复；取消请求持久化，执行退出前不会提前放行后续轮次。
+- 队列和对话共享状态变化通知，断线自动重连、轮询兜底；修复记录不存在时仍显示旧等待状态的问题。
+- 新任务记录创建时间，旧任务未记录的时间不伪造。已写入的内容不会因取消任务而撤销。
+- 150 项自动化测试通过，另通过桌面、手机、平板浏览器验证。需更新发起回写的客户端；只升级中央知识库不会更新客户端队列逻辑。
+
 ### 2.6.1 更新
 
 适配 DSH **0.1.2-rc.1**。
@@ -20,6 +30,16 @@
 
 `2.6.0` 将轮后回写改为本机持久化队列：先保存本轮快照，再释放会话结束流程，不再等待提取模型或远程写入。失败可在原回答下重试；重启和后续对话不会覆盖未完成任务。状态显示等待回写／回写中／成功及目标文档／失败与原因。远程直接写入需要中央服务同时升级到 `2.6.0`，旧服务不支持幂等回执时会明确报错并保留计划，不冒险重复写入。
 
+### 回写任务管理
+
+知识工作区的“回写任务”，以及回答下方的“管理回写”，可查看本机持久化队列。按创建先后倒序显示，最新任务在前，每页最多 50 条，可按会话筛选，查看创建日期时间、尝试次数、下次重试时间、阻塞任务、失败原因及完成后的目标文档。旧记录未保存创建时间时明确标注，不用迁移时间冒充。即使连接中央知识库，这里管理的也是当前 DSH 客户端的队列。
+
+- 网络等暂时错误最多自动尝试 5 次，之后保留为失败项，支持手动重试。重试复用原快照和已保存的计划，不使用后续对话重新生成旧任务。
+- 服务正常关闭后恢复排队；进程意外退出时，在旧工作租约到期后恢复（租约为 60 秒）。失败项仍需处理，不会在每次启动时无限重试。
+- 同会话必须按顺序回写。前一轮失败时，可重试前一轮，或取消它以放行后续轮次；其他会话不会被该失败项阻塞。
+- 排队和失败项可立即取消。执行中的任务先记录取消请求，待当前执行退出后完成取消，期间不提前放行后续任务。取消请求在重启后仍有效；已写入内容不撤销，也不支持恢复已取消的任务。
+- 页面通过共享长轮询接收状态变更通知，收到变化后立即查询最新状态，同时保留每 5 秒刷新队列的兜底。隐藏后暂停连接，重新显示或网络恢复后重新同步；原回答下也使用共享通知通道。确认记录不存在时清除旧等待状态，查询网络失败则提示重连，不误报任务不存在。历史版本未保存快照的任务不能安全重试。
+
 前端回写状态自动轮询，修复浏览器原生 `fetch` 的接收者绑定问题；读取失败会明确显示正在重连，不把查询失败误报为写入失败。139 项自动化测试通过，并验证真实 Chromium 中的状态请求、目标文档链接及桌面／手机／平板展示。
 
 `2.5.1` 修复知识目录的长文件名撑宽列表、遮挡结束状态的问题：名称按剩余空间省略，悬停可查看完整名称和路径，“已解决／已收集完成”标签完整保留。不改变文档内容、权限、配色或动画。

package/lib/client.d.ts

@@ -15,6 +15,9 @@ export type KnowledgeDocumentTarget = {
 } | {
     view: 'notes';
     noteId?: string;
+} | {
+    view: 'writeback';
+    sessionId: string;
 };
 /** Cordis services needed by the browser half. */
 export declare const inject: string[];

package/lib/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AA8CnE,MAAM,WAAW,4BAA4B;IAC3C,MAAM,IAAI,OAAO,CAAA;IACjB,IAAI,IAAI,IAAI,CAAA;IACZ,MAAM,IAAI,IAAI,CAAA;IACd,YAAY,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAA;IACnD,aAAa,IAAI,uBAAuB,GAAG,SAAS,CAAA;IACpD,KAAK,IAAI,IAAI,CAAA;IACb,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAC5C;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAMtC,kDAAkD;AAClD,eAAO,MAAM,MAAM,UAA2C,CAAA;AAE9D,gFAAgF;AAChF,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAyB9C"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AA8CnE,MAAM,WAAW,4BAA4B;IAC3C,MAAM,IAAI,OAAO,CAAA;IACjB,IAAI,IAAI,IAAI,CAAA;IACZ,MAAM,IAAI,IAAI,CAAA;IACd,YAAY,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAA;IACnD,aAAa,IAAI,uBAAuB,GAAG,SAAS,CAAA;IACpD,KAAK,IAAI,IAAI,CAAA;IACb,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAC5C;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAA;AAM5C,kDAAkD;AAClD,eAAO,MAAM,MAAM,UAA2C,CAAA;AAE9D,gFAAgF;AAChF,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAyB9C"}

package/lib/client.js

@@ -44,6 +44,8 @@ var WritebackStatusClient = class {
   failures = 0;
   value;
   readError;
+  missing = false;
+  invalidated = false;
   setVisible(visible) {
     this.visible = visible;
     if (visible) this.refresh();
@@ -56,6 +58,11 @@ var WritebackStatusClient = class {
     if (this.disposed || !this.visible || this.retrying || this.request && !this.request.signal.aborted) return;
     void this.load(false);
   }
+  invalidate() {
+    if (this.disposed || !this.visible) return;
+    if (this.retrying || this.request && !this.request.signal.aborted) this.invalidated = true;
+    else this.refresh();
+  }
   retry() {
     if (this.disposed || this.retrying || !this.value?.retryable) return;
     this.retrying = true;
@@ -77,13 +84,20 @@ var WritebackStatusClient = class {
       });
       const body = await response.json();
       if (this.request !== controller || this.disposed) return;
-      if (!response.ok && (retry || response.status !== 404)) throw new Error(body.error ?? `\u72B6\u6001\u8BF7\u6C42\u5931\u8D25\uFF08HTTP ${response.status}\uFF09`);
-      this.readError = void 0;
+      if (!response.ok && (retry || response.status !== 404 || String(body.status) !== "missing")) throw new Error(body.error ?? `\u72B6\u6001\u8BF7\u6C42\u5931\u8D25\uFF08HTTP ${response.status}\uFF09`);
+      if (response.ok && !body.summary) throw new Error("\u65E0\u6548\u7684\u56DE\u5199\u72B6\u6001\u54CD\u5E94");
       if (response.ok && body.summary) {
+        this.readError = void 0;
+        this.missing = false;
         this.value = body;
         this.failures = 0;
-        delay = body.status === "completed" ? 0 : body.status === "failed" ? 15e3 : 1500;
+        delay = body.status === "completed" || body.status === "cancelled" ? 0 : body.status === "failed" ? 15e3 : 1500;
       } else {
+        if (this.value || this.missing) {
+          this.missing = true;
+          this.value = void 0;
+          this.readError = "\u5F53\u524D\u5BA2\u6237\u7AEF\u627E\u4E0D\u5230\u8FD9\u8F6E\u56DE\u5199\u8BB0\u5F55\uFF1B\u65E7\u7B49\u5F85\u72B6\u6001\u5DF2\u5931\u6548\uFF0C\u8BF7\u5728\u56DE\u5199\u4EFB\u52A1\u4E2D\u6838\u5BF9\u3002";
+        } else this.readError = void 0;
         delay = ++this.failures <= 3 ? 1500 : 6e4;
       }
     } catch (error) {
@@ -97,7 +111,10 @@ var WritebackStatusClient = class {
         this.request = void 0;
         if (retry) this.retrying = false;
         this.change(this.value, this.retrying, this.readError);
-        if (delay && this.visible) this.timer = setTimeout(() => this.refresh(), delay);
+        if (this.invalidated && this.visible) {
+          this.invalidated = false;
+          this.refresh();
+        } else if (delay && this.visible) this.timer = setTimeout(() => this.refresh(), delay);
       }
     }
   }
@@ -108,6 +125,75 @@ var WritebackStatusClient = class {
   }
 };
 
+// web/writeback-live.js
+var groups = /* @__PURE__ */ new Map();
+function subscribeWritebackChanges(client, listener) {
+  let group = groups.get(client);
+  if (!group) {
+    let emit2 = function() {
+      for (const fn of listeners) fn();
+    }, resume2 = function() {
+      clearTimeout(timer);
+      request2?.abort();
+      request2 = void 0;
+      if (!document.hidden && !stopped) {
+        emit2();
+        void poll();
+      }
+    };
+    var emit = emit2, resume = resume2;
+    const listeners = /* @__PURE__ */ new Set();
+    let stopped = false, request2, timer, revision = "", failures = 0;
+    async function poll() {
+      if (stopped || document.hidden) return;
+      const controller = new AbortController();
+      request2 = controller;
+      try {
+        const response = await fetch(`/knowledge-control/v1/writeback-changes?since=${encodeURIComponent(revision)}`, {
+          credentials: "same-origin",
+          cache: "no-store",
+          headers: { "x-dsh-knowledge-client": client },
+          signal: AbortSignal.any([controller.signal, AbortSignal.timeout(25e3)])
+        });
+        if (!response.ok) throw new Error("notification transport unavailable");
+        const data = await response.json();
+        if (typeof data.revision !== "string") throw new Error("invalid revision");
+        if (stopped || controller.signal.aborted) return;
+        const changed = revision !== data.revision || failures > 0;
+        revision = data.revision;
+        failures = 0;
+        if (changed) emit2();
+      } catch {
+        if (!controller.signal.aborted) failures++;
+      } finally {
+        if (request2 === controller) {
+          request2 = void 0;
+          if (!stopped && !document.hidden) timer = setTimeout(poll, failures ? Math.min(3e4, 1e3 * 2 ** Math.min(failures, 5)) : 0);
+        }
+      }
+    }
+    document.addEventListener("visibilitychange", resume2);
+    window.addEventListener("online", resume2);
+    group = { listeners, close() {
+      stopped = true;
+      clearTimeout(timer);
+      request2?.abort();
+      document.removeEventListener("visibilitychange", resume2);
+      window.removeEventListener("online", resume2);
+    } };
+    groups.set(client, group);
+    timer = setTimeout(poll, 0);
+  }
+  group.listeners.add(listener);
+  return () => {
+    group.listeners.delete(listener);
+    if (!group.listeners.size) {
+      group.close();
+      groups.delete(client);
+    }
+  };
+}
+
 // src/workspace-ownership.ts
 var WORKSPACE_ACTIVATE_EVENT = "@lemoncat7/dsh-plugin-ui/workspace-activate";
 function activatePluginWorkspace(pluginId) {
@@ -4040,6 +4126,7 @@ function KnowledgeWritebackStatus({
       }
     );
     client.current = status;
+    const unsubscribeChanges = subscribeWritebackChanges("conversation-web", () => status.invalidate());
     let inView = true;
     const refresh = () => status.setVisible(inView && !document.hidden);
     const observer = typeof IntersectionObserver === "undefined" ? void 0 : new IntersectionObserver((entries2) => {
@@ -4057,10 +4144,14 @@ function KnowledgeWritebackStatus({
       window.removeEventListener("focus", refresh);
       window.removeEventListener("online", refresh);
       status.dispose();
+      unsubscribeChanges();
       client.current = void 0;
     };
   }, [sessionId, turn]);
-  if (state === void 0) return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { ref: container, children: readError && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { className: "dsh-knowledge-writeback-notice", role: "status", children: readError }) });
+  if (state === void 0) return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { ref: container, children: readError && /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { className: "dsh-knowledge-writeback-notice", role: "status", children: [
+    readError,
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("button", { type: "button", onClick: () => workspace.openDocument({ view: "writeback", sessionId }), children: "\u7BA1\u7406\u56DE\u5199" })
+  ] }) });
   const retry = () => client.current?.retry();
   const destinations = state.destinations ?? [];
   const summary = state.summary.replace(/^知识库回写\s*·\s*/u, "");
@@ -4071,7 +4162,8 @@ function KnowledgeWritebackStatus({
       /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { title: state.error, children: summary }),
       state.status === "failed" && state.retryable && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("button", { type: "button", disabled: retrying, onClick: () => {
         void retry();
-      }, children: retrying ? "\u91CD\u8BD5\u4E2D\u2026" : "\u91CD\u8BD5" })
+      }, children: retrying ? "\u91CD\u8BD5\u4E2D\u2026" : "\u91CD\u8BD5" }),
+      state.status !== "completed" && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("button", { type: "button", onClick: () => workspace.openDocument({ view: "writeback", sessionId }), children: "\u7BA1\u7406\u56DE\u5199" })
     ] }),
     destinations.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("ul", { className: "dsh-knowledge-writeback-destinations", "aria-label": "\u56DE\u5199\u76EE\u6807", children: destinations.map((destination, index) => /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("li", { children: [
       /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "dsh-knowledge-writeback-base", children: destination.knowledgeBaseName }),
@@ -4487,7 +4579,10 @@ function knowledgePanelUrl(managementPath, sessionId, projectId, target) {
   if (sessionId !== void 0) params.set("sessionId", sessionId);
   if (projectId !== void 0) params.set("projectId", projectId);
   if (target !== void 0) {
-    if (target.view === "notes") {
+    if (target.view === "writeback") {
+      params.set("view", "writeback");
+      params.set("sessionId", target.sessionId);
+    } else if (target.view === "notes") {
       params.set("view", "notes");
       if (target.noteId !== void 0) params.set("noteId", target.noteId);
     } else {