hiwork-core 0.0.16 → 0.0.18

package/lib/client.js

@@ -350,6 +350,146 @@ function AiRouterSection(props) {
 var import_react2 = require("react");
 var import_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 
+// src/client/plugin-updates.ts
+var PLUGIN_UPDATES_CHANNEL = "/hiwork-plugin-updates";
+var PLUGIN_UPDATES_POLL_INTERVAL_MS = 5 * 6e4;
+var PluginUpdatesRpcError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "PluginUpdatesRpcError";
+  }
+};
+var GENERIC_FAILURE_MESSAGE = "\u63D2\u4EF6\u66F4\u65B0\u72B6\u6001\u6682\u65F6\u65E0\u6CD5\u83B7\u53D6\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5";
+var INVALID_RESPONSE_MESSAGE = "\u63D2\u4EF6\u66F4\u65B0\u4E3B\u673A\u8FD4\u56DE\u4E86\u65E0\u6548\u54CD\u5E94\u3002";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function text(value) {
+  return typeof value === "string" && value.trim() !== "" ? value : void 0;
+}
+function unwrapPluginUpdatesResult(value) {
+  if (!isRecord(value) || !("ok" in value)) {
+    throw new PluginUpdatesRpcError("internal", INVALID_RESPONSE_MESSAGE);
+  }
+  if (value["ok"] === true) return value["value"];
+  if (value["ok"] === false) {
+    const error = isRecord(value["error"]) ? value["error"] : void 0;
+    const code = text(error?.["code"]) ?? "internal";
+    const message = typeof error?.["message"] === "string" && error["message"].trim() !== "" ? error["message"] : GENERIC_FAILURE_MESSAGE;
+    throw new PluginUpdatesRpcError(code, message);
+  }
+  throw new PluginUpdatesRpcError("internal", INVALID_RESPONSE_MESSAGE);
+}
+function toPackageUpdate(value) {
+  if (!isRecord(value)) return void 0;
+  const packageName = text(value["packageName"]);
+  if (packageName === void 0) return void 0;
+  return {
+    packageName,
+    displayName: text(value["displayName"]) ?? packageName,
+    from: text(value["from"]) ?? "",
+    to: text(value["to"]) ?? ""
+  };
+}
+function toPluginUpdatesSnapshot(value) {
+  if (!isRecord(value)) return void 0;
+  const packages = [];
+  for (const item of Array.isArray(value["packages"]) ? value["packages"] : []) {
+    const normalized = toPackageUpdate(item);
+    if (normalized !== void 0) packages.push(normalized);
+  }
+  const revision = value["revision"];
+  const fetchedAt = value["fetchedAt"];
+  return {
+    packages,
+    fetchedAt: typeof fetchedAt === "number" && Number.isFinite(fetchedAt) ? fetchedAt : 0,
+    revision: typeof revision === "number" && Number.isFinite(revision) ? revision : null
+  };
+}
+var PluginUpdatesStore = class {
+  constructor(rpc) {
+    this.rpc = rpc;
+  }
+  current;
+  dismissed;
+  version = 0;
+  listeners = /* @__PURE__ */ new Set();
+  /** 最近一次成功取到的快照（同步读，可能比服务端现状旧）。没有 / 不可用时 `undefined`。 */
+  snapshot() {
+    return this.current;
+  }
+  /** 变化计数：`useSyncExternalStore` 的 `getSnapshot`（值变化即重渲染）。 */
+  getVersion = () => this.version;
+  /** 订阅变化（快照更新 / 关闭）。返回退订函数。 */
+  subscribe = (listener) => {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  };
+  /** 这个 revision 是否已经被用户关掉过（同 revision 不再提示；换 revision 会重新提示）。 */
+  isDismissed(revision) {
+    return this.dismissed !== void 0 && this.dismissed === revision;
+  }
+  /**
+   * 现在是否该渲染提示卡片。
+   *
+   * 三个条件缺一不可：**有快照**（不可用 / 从没取到 → 不渲染）、**`packages` 非空**
+   * （只有降级项时桌面端返回的也是空 `packages`，spec §4.5 明确不弹）、**这个 revision 没被关过**。
+   * ⚠️ 判据里**没有** `held` / `from` / `displayName`（spec §4.3 的 ⚠️）。
+   */
+  shouldPrompt() {
+    const snapshot = this.current;
+    if (snapshot === void 0 || snapshot.packages.length === 0) return false;
+    return !this.isDismissed(snapshot.revision);
+  }
+  /**
+   * 记住「用户关掉了这一个 revision 的提示」。**只记内存**（spec §4.5：本次会话 + 该 revision），
+   * 不落盘、不调任何 apply。
+   */
+  dismiss() {
+    const snapshot = this.current;
+    if (snapshot === void 0) return;
+    if (this.dismissed === snapshot.revision) return;
+    this.dismissed = snapshot.revision;
+    this.bump();
+  }
+  /**
+   * 向 Host 取一次「有没有待生效的更新」。
+   *
+   * 返回 `undefined` 有两种来源，对调用方是同一件事（**不渲染**）：Host 说「不可用」（`null`），
+   * 或响应形状不合法。⚠️ **失败（`ok:false` / 传输异常）一律抛错且不覆写镜像**——提示条不该
+   * 因为一次抖动而消失，而「更新已经在排队」这件事不会因为读不出来就不存在。
+   */
+  async refresh(signal) {
+    const raw = await this.rpc.call(PLUGIN_UPDATES_CHANNEL, "snapshot", {}, signal);
+    const next = toPluginUpdatesSnapshot(unwrapPluginUpdatesResult(raw));
+    this.current = next;
+    this.bump();
+    return next;
+  }
+  /**
+   * 请求「重启并更新」。**这是全链路唯一的回收入口，且只能由用户点击到达。**
+   *
+   * 返回 `true` 表示触发**已经递下去**（最终落到主进程的 `recycleDshForPluginUpdate()`），
+   * **不是**「更新成功」——主进程会重建窗口，客户端那一刻就没了。
+   * `false` 只在「老桌面端上没有 `desktopPlugins`」时出现（Host 回 `requested: false`）。
+   */
+  async requestRestart(signal) {
+    const raw = await this.rpc.call(PLUGIN_UPDATES_CHANNEL, "apply", {}, signal);
+    const value = unwrapPluginUpdatesResult(raw);
+    return isRecord(value) && value["requested"] === true;
+  }
+  bump() {
+    this.version += 1;
+    for (const listener of [...this.listeners]) listener();
+  }
+};
+function createPluginUpdates(rpc) {
+  return new PluginUpdatesStore(rpc);
+}
+
 // src/client/settings-navigation.ts
 function pickSettingsSectionButton(buttons, labels) {
   for (const label of labels) {
@@ -576,6 +716,90 @@ var confirmActionsStyle = {
   gap: 8,
   marginTop: 8
 };
+var UPDATES_CARD_GAP = 8;
+var UPDATES_CARD_FALLBACK_BOTTOM = 64;
+var UPDATES_CARD_MIN_BOTTOM = 8;
+var updatesCardStyle = (bottom) => ({
+  position: "fixed",
+  left: 8,
+  bottom,
+  zIndex: 1200,
+  boxSizing: "border-box",
+  width: 268,
+  maxWidth: "calc(100vw - 16px)",
+  padding: "12px 12px 10px",
+  display: "flex",
+  flexDirection: "column",
+  gap: 6,
+  background: bgLayer2,
+  borderRadius: 12,
+  border: `1px solid ${borderL2}`,
+  boxShadow: "var(--dsw-shadow-lv3, 0 12px 32px rgba(15,17,21,0.18))"
+});
+var updatesTitleStyle = {
+  display: "flex",
+  alignItems: "center",
+  gap: 6,
+  fontSize: 13,
+  fontWeight: 600,
+  color: textPrimary
+};
+var updatesBodyStyle = { fontSize: 12, lineHeight: 1.6, color: textSecondary };
+var updatesErrorStyle = { fontSize: 12, lineHeight: 1.6, color: warnText };
+var updatesActionsStyle = {
+  display: "flex",
+  justifyContent: "flex-end",
+  gap: 8,
+  marginTop: 4
+};
+function PluginUpdatesCard(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
+    "div",
+    {
+      style: updatesCardStyle(props.bottom),
+      "data-hiwork-plugin-updates": true,
+      role: "status",
+      "aria-label": "\u63D2\u4EF6\u66F4\u65B0\u63D0\u793A",
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { style: updatesTitleStyle, children: "\u63D2\u4EF6\u66F4\u65B0\u5DF2\u5C31\u7EEA" }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { style: updatesBodyStyle, children: "\u91CD\u542F\u540E\u751F\u6548\u3002" }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: updatesBodyStyle, children: [
+          "\u70B9\u300C\u91CD\u542F\u5E76\u66F4\u65B0\u300D\u4F1A\u7ACB\u523B\u91CD\u542F\u5E94\u7528\uFF1A",
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("strong", { children: "\u5F53\u524D\u6B63\u5728\u8F93\u5165\u7684\u5185\u5BB9\u4F1A\u4E22\u5931" }),
+          "\uFF08\u4F1A\u8BDD\u8BB0\u5F55\u4FDD\u5B58\u5728\u78C1\u76D8\u4E0A\uFF0C\u4E0D\u4F1A\u4E22\uFF09\u3002"
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { style: updatesBodyStyle, children: "\u4E5F\u53EF\u4EE5\u7A0D\u540E\u624B\u52A8\u91CD\u542F\uFF1A\u9000\u51FA HiWork \u540E\u91CD\u65B0\u6253\u5F00\uFF08macOS \u6309 Cmd+Q\uFF0C\u5173\u95ED\u7A97\u53E3\u4E0D\u7B97\u9000\u51FA\uFF09\u3002" }),
+        props.restartFailed ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { style: updatesErrorStyle, children: "\u6682\u65F6\u65E0\u6CD5\u89E6\u53D1\u91CD\u542F\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\uFF0C\u6216\u6309\u4E0A\u9762\u7684\u65B9\u5F0F\u624B\u52A8\u9000\u51FA\u540E\u91CD\u65B0\u6253\u5F00\u3002" }) : null,
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: updatesActionsStyle, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+            "button",
+            {
+              type: "button",
+              "data-hiwork-core-secondary": true,
+              "data-hiwork-plugin-updates-dismiss": true,
+              style: secondaryButton,
+              onClick: props.onDismiss,
+              children: "\u5173\u95ED"
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+            "button",
+            {
+              type: "button",
+              "data-hiwork-core-primary": true,
+              "data-hiwork-plugin-updates-restart": true,
+              style: primaryButton,
+              disabled: props.restarting,
+              onClick: props.onRestart,
+              children: props.restarting ? "\u5DF2\u8BF7\u6C42\u91CD\u542F\u2026" : "\u91CD\u542F\u5E76\u66F4\u65B0"
+            }
+          )
+        ] })
+      ]
+    }
+  );
+}
+var serverUpdatesVersion = () => 0;
 function LogoutIcon() {
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
     "svg",
@@ -631,6 +855,41 @@ function LogoutConfirm(props) {
 function UserBadge(props) {
   const state = props.useAiRouterCard((snapshot) => snapshot);
   const [confirming, setConfirming] = (0, import_react2.useState)(false);
+  const updates = props.pluginUpdates;
+  const [restarting, setRestarting] = (0, import_react2.useState)(false);
+  const [restartFailed, setRestartFailed] = (0, import_react2.useState)(false);
+  const [cardBottom, setCardBottom] = (0, import_react2.useState)(UPDATES_CARD_FALLBACK_BOTTOM);
+  const wideRowRef = (0, import_react2.useRef)(null);
+  const railRowRef = (0, import_react2.useRef)(null);
+  const loggedIn = state.status === "logged-in" && state.username !== void 0;
+  (0, import_react2.useSyncExternalStore)(updates.subscribe, updates.getVersion, serverUpdatesVersion);
+  (0, import_react2.useEffect)(() => {
+    if (!loggedIn) return;
+    const tick = () => {
+      void updates.refresh().catch(() => {
+      });
+    };
+    tick();
+    const timer = setInterval(tick, PLUGIN_UPDATES_POLL_INTERVAL_MS);
+    return () => {
+      clearInterval(timer);
+    };
+  }, [loggedIn, updates]);
+  const showUpdates = loggedIn && updates.shouldPrompt();
+  (0, import_react2.useLayoutEffect)(() => {
+    if (!showUpdates) return;
+    const measure = () => {
+      const node = props.wide ? wideRowRef.current : railRowRef.current;
+      if (node === null) return;
+      const rect = node.getBoundingClientRect();
+      setCardBottom(Math.max(UPDATES_CARD_MIN_BOTTOM, Math.round(window.innerHeight - rect.top + UPDATES_CARD_GAP)));
+    };
+    measure();
+    window.addEventListener("resize", measure);
+    return () => {
+      window.removeEventListener("resize", measure);
+    };
+  }, [showUpdates, props.wide]);
   if (state.status !== "logged-in" || state.username === void 0) return null;
   const displayName = state.displayName ?? state.username;
   const initial = displayName.slice(0, 1).toUpperCase();
@@ -638,22 +897,51 @@ function UserBadge(props) {
     setConfirming(false);
     void props.actions.logout();
   } }) : null;
-  if (!props.wide) {
-    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-      "button",
-      {
-        type: "button",
-        "data-hiwork-core-icon": true,
-        style: railRowStyle,
-        title: displayName,
-        "aria-label": "\u6253\u5F00\u8BBE\u7F6E",
-        onClick: openGatewaySettings,
-        children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: avatarStyle(24), children: initial })
+  const onRestart = () => {
+    setRestartFailed(false);
+    setRestarting(true);
+    void updates.requestRestart().then((requested) => {
+      if (!requested) {
+        setRestarting(false);
+        setRestartFailed(true);
       }
-    );
+    }).catch(() => {
+      setRestarting(false);
+      setRestartFailed(true);
+    });
+  };
+  const updatesCard = showUpdates ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+    PluginUpdatesCard,
+    {
+      bottom: cardBottom,
+      restarting,
+      restartFailed,
+      onRestart,
+      onDismiss: () => {
+        updates.dismiss();
+      }
+    }
+  ) : null;
+  if (!props.wide) {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_jsx_runtime2.Fragment, { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+        "button",
+        {
+          ref: railRowRef,
+          type: "button",
+          "data-hiwork-core-icon": true,
+          style: railRowStyle,
+          title: displayName,
+          "aria-label": "\u6253\u5F00\u8BBE\u7F6E",
+          onClick: openGatewaySettings,
+          children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: avatarStyle(24), children: initial })
+        }
+      ),
+      updatesCard
+    ] });
   }
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_jsx_runtime2.Fragment, { children: [
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: wideRowStyle, title: displayName, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { ref: wideRowRef, style: wideRowStyle, title: displayName, children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
         "button",
         {
@@ -694,7 +982,8 @@ function UserBadge(props) {
         }
       )
     ] }),
-    confirm
+    confirm,
+    updatesCard
   ] });
 }
 
@@ -2876,28 +3165,28 @@ function toAssignment(value) {
   const record = value;
   const authRaw = record["auth"];
   const auth = typeof authRaw === "object" && authRaw !== null ? authRaw : void 0;
-  const assignmentId = text(record["assignmentId"]);
-  const serverName = text(record["serverName"]);
-  const url = text(record["url"]);
-  const kind = text(auth?.["kind"]);
-  const mintUrl = text(auth?.["mintUrl"]);
+  const assignmentId = text2(record["assignmentId"]);
+  const serverName = text2(record["serverName"]);
+  const url = text2(record["url"]);
+  const kind = text2(auth?.["kind"]);
+  const mintUrl = text2(auth?.["mintUrl"]);
   if (assignmentId === void 0 || serverName === void 0 || url === void 0 || kind === void 0 || mintUrl === void 0) {
     return void 0;
   }
   return {
     assignmentId,
     revision: typeof record["revision"] === "number" ? record["revision"] : 0,
-    slug: text(record["slug"]) ?? serverName,
-    displayName: text(record["displayName"]) ?? serverName,
+    slug: text2(record["slug"]) ?? serverName,
+    displayName: text2(record["displayName"]) ?? serverName,
     serverName,
-    transport: text(record["transport"]) ?? "",
+    transport: text2(record["transport"]) ?? "",
     url,
     extraHeaders: stringMap(record["extraHeaders"]),
-    auth: { kind, mintUrl, revokeUrl: text(auth?.["revokeUrl"]) ?? "" },
-    updatedAt: text(record["updatedAt"]) ?? ""
+    auth: { kind, mintUrl, revokeUrl: text2(auth?.["revokeUrl"]) ?? "" },
+    updatedAt: text2(record["updatedAt"]) ?? ""
   };
 }
-function text(value) {
+function text2(value) {
   return typeof value === "string" && value.trim() !== "" ? value : void 0;
 }
 function stringMap(raw) {
@@ -2961,17 +3250,17 @@ var ManagedMcpStore = class {
       throw new ManagedMcpRpcError("internal", "MCP \u6E05\u5355\u4E3B\u673A\u8FD4\u56DE\u4E86\u65E0\u6548\u54CD\u5E94\u3002");
     }
     const record = value;
-    const assertion = text(record["assertion"]);
-    const mintUrl = text(record["mintUrl"]);
+    const assertion = text2(record["assertion"]);
+    const mintUrl = text2(record["mintUrl"]);
     if (assertion === void 0 || mintUrl === void 0) {
       throw new ManagedMcpRpcError("internal", "MCP \u6E05\u5355\u4E3B\u673A\u8FD4\u56DE\u4E86\u65E0\u6548\u54CD\u5E94\u3002");
     }
     return {
       assertion,
       mintUrl,
-      revokeUrl: text(record["revokeUrl"]) ?? "",
-      expiresAt: text(record["expiresAt"]) ?? "",
-      serverName: text(record["serverName"]) ?? ""
+      revokeUrl: text2(record["revokeUrl"]) ?? "",
+      expiresAt: text2(record["expiresAt"]) ?? "",
+      serverName: text2(record["serverName"]) ?? ""
     };
   }
   /** 订阅镜像变化（连接器域据此重渲染 / 重排同步）。返回退订函数。 */
@@ -3020,29 +3309,29 @@ var ManagedSkillsRpcError = class extends Error {
     this.name = "ManagedSkillsRpcError";
   }
 };
-var GENERIC_FAILURE_MESSAGE = "\u6280\u80FD\u6E05\u5355\u6682\u65F6\u65E0\u6CD5\u83B7\u53D6\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5";
-var INVALID_RESPONSE_MESSAGE = "\u6280\u80FD\u6E05\u5355\u4E3B\u673A\u8FD4\u56DE\u4E86\u65E0\u6548\u54CD\u5E94\u3002";
+var GENERIC_FAILURE_MESSAGE2 = "\u6280\u80FD\u6E05\u5355\u6682\u65F6\u65E0\u6CD5\u83B7\u53D6\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5";
+var INVALID_RESPONSE_MESSAGE2 = "\u6280\u80FD\u6E05\u5355\u4E3B\u673A\u8FD4\u56DE\u4E86\u65E0\u6548\u54CD\u5E94\u3002";
 function unwrapManagedSkillsResult(value) {
   if (typeof value !== "object" || value === null || !("ok" in value)) {
-    throw new ManagedSkillsRpcError("internal", INVALID_RESPONSE_MESSAGE);
+    throw new ManagedSkillsRpcError("internal", INVALID_RESPONSE_MESSAGE2);
   }
   const result = value;
   if (result.ok === true) return result.value;
   if (result.ok === false) {
     const code = typeof result.error?.code === "string" ? result.error.code : "internal";
-    const message = typeof result.error?.message === "string" && result.error.message.trim() !== "" ? result.error.message : GENERIC_FAILURE_MESSAGE;
+    const message = typeof result.error?.message === "string" && result.error.message.trim() !== "" ? result.error.message : GENERIC_FAILURE_MESSAGE2;
     throw new ManagedSkillsRpcError(code, message);
   }
-  throw new ManagedSkillsRpcError("internal", INVALID_RESPONSE_MESSAGE);
+  throw new ManagedSkillsRpcError("internal", INVALID_RESPONSE_MESSAGE2);
 }
 function toSnapshot2(value) {
   if (typeof value !== "object" || value === null) {
-    throw new ManagedSkillsRpcError("internal", INVALID_RESPONSE_MESSAGE);
+    throw new ManagedSkillsRpcError("internal", INVALID_RESPONSE_MESSAGE2);
   }
   const record = value;
   const rawList = record["assignments"];
   if (!Array.isArray(rawList)) {
-    throw new ManagedSkillsRpcError("internal", INVALID_RESPONSE_MESSAGE);
+    throw new ManagedSkillsRpcError("internal", INVALID_RESPONSE_MESSAGE2);
   }
   const assignments = [];
   for (const item of rawList) {
@@ -3060,7 +3349,7 @@ function toSnapshot2(value) {
     const detail = lastError;
     snapshot.lastError = {
       code: typeof detail.code === "string" ? detail.code : "internal",
-      message: typeof detail.message === "string" ? detail.message : GENERIC_FAILURE_MESSAGE
+      message: typeof detail.message === "string" ? detail.message : GENERIC_FAILURE_MESSAGE2
     };
   }
   return snapshot;
@@ -3068,24 +3357,24 @@ function toSnapshot2(value) {
 function toAssignment2(value) {
   if (typeof value !== "object" || value === null) return void 0;
   const record = value;
-  const assignmentId = text2(record["assignmentId"]);
-  const skillName = text2(record["skillName"]);
-  const contentSha256 = text2(record["contentSha256"]);
+  const assignmentId = text3(record["assignmentId"]);
+  const skillName = text3(record["skillName"]);
+  const contentSha256 = text3(record["contentSha256"]);
   if (assignmentId === void 0 || skillName === void 0 || contentSha256 === void 0) return void 0;
   return {
     assignmentId,
     revision: typeof record["revision"] === "number" ? record["revision"] : 0,
-    slug: text2(record["slug"]) ?? skillName,
-    displayName: text2(record["displayName"]) ?? skillName,
+    slug: text3(record["slug"]) ?? skillName,
+    displayName: text3(record["displayName"]) ?? skillName,
     skillName,
-    description: text2(record["description"]) ?? "",
+    description: text3(record["description"]) ?? "",
     contentSha256,
     sizeBytes: typeof record["sizeBytes"] === "number" ? record["sizeBytes"] : 0,
-    version: text2(record["version"]) ?? "",
-    updatedAt: text2(record["updatedAt"]) ?? ""
+    version: text3(record["version"]) ?? "",
+    updatedAt: text3(record["updatedAt"]) ?? ""
   };
 }
-function text2(value) {
+function text3(value) {
   return typeof value === "string" && value.trim() !== "" ? value : void 0;
 }
 var ManagedSkillsStore = class {
@@ -3155,15 +3444,15 @@ var ManagedSkillsStore = class {
     const raw = await this.rpc.call(MANAGED_SKILLS_CHANNEL, "package", { assignmentId }, signal);
     const value = unwrapManagedSkillsResult(raw);
     if (typeof value !== "object" || value === null) {
-      throw new ManagedSkillsRpcError("internal", INVALID_RESPONSE_MESSAGE);
+      throw new ManagedSkillsRpcError("internal", INVALID_RESPONSE_MESSAGE2);
     }
     const record = value;
-    const id = text2(record["assignmentId"]);
-    const skillName = text2(record["skillName"]);
-    const contentSha256 = text2(record["contentSha256"]);
-    const archiveBase64 = text2(record["archiveBase64"]);
+    const id = text3(record["assignmentId"]);
+    const skillName = text3(record["skillName"]);
+    const contentSha256 = text3(record["contentSha256"]);
+    const archiveBase64 = text3(record["archiveBase64"]);
     if (id === void 0 || skillName === void 0 || contentSha256 === void 0 || archiveBase64 === void 0) {
-      throw new ManagedSkillsRpcError("internal", INVALID_RESPONSE_MESSAGE);
+      throw new ManagedSkillsRpcError("internal", INVALID_RESPONSE_MESSAGE2);
     }
     return { assignmentId: id, skillName, contentSha256, archiveBase64 };
   }
@@ -3251,25 +3540,25 @@ var ManagedWorkbenchRpcError = class extends Error {
     this.name = "ManagedWorkbenchRpcError";
   }
 };
-var GENERIC_FAILURE_MESSAGE2 = "\u5DE5\u4F5C\u53F0\u5E94\u7528\u6E05\u5355\u6682\u65F6\u65E0\u6CD5\u83B7\u53D6\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5";
-var INVALID_RESPONSE_MESSAGE2 = "\u5DE5\u4F5C\u53F0\u6E05\u5355\u4E3B\u673A\u8FD4\u56DE\u4E86\u65E0\u6548\u54CD\u5E94\u3002";
+var GENERIC_FAILURE_MESSAGE3 = "\u5DE5\u4F5C\u53F0\u5E94\u7528\u6E05\u5355\u6682\u65F6\u65E0\u6CD5\u83B7\u53D6\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5";
+var INVALID_RESPONSE_MESSAGE3 = "\u5DE5\u4F5C\u53F0\u6E05\u5355\u4E3B\u673A\u8FD4\u56DE\u4E86\u65E0\u6548\u54CD\u5E94\u3002";
 function unwrapManagedWorkbenchResult(value) {
   if (typeof value !== "object" || value === null || !("ok" in value)) {
-    throw new ManagedWorkbenchRpcError("internal", INVALID_RESPONSE_MESSAGE2);
+    throw new ManagedWorkbenchRpcError("internal", INVALID_RESPONSE_MESSAGE3);
   }
   const result = value;
   if (result.ok === true) return result.value;
   if (result.ok === false) {
     const code = typeof result.error?.code === "string" ? result.error.code : "internal";
-    const message = typeof result.error?.message === "string" && result.error.message.trim() !== "" ? result.error.message : GENERIC_FAILURE_MESSAGE2;
+    const message = typeof result.error?.message === "string" && result.error.message.trim() !== "" ? result.error.message : GENERIC_FAILURE_MESSAGE3;
     throw new ManagedWorkbenchRpcError(code, message);
   }
-  throw new ManagedWorkbenchRpcError("internal", INVALID_RESPONSE_MESSAGE2);
+  throw new ManagedWorkbenchRpcError("internal", INVALID_RESPONSE_MESSAGE3);
 }
-function text3(value) {
+function text4(value) {
   return typeof value === "string" && value.trim() !== "" ? value : void 0;
 }
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function stringArray(value) {
@@ -3277,45 +3566,45 @@ function stringArray(value) {
   return value.filter((item) => typeof item === "string");
 }
 function toApp(value) {
-  if (!isRecord(value)) return void 0;
-  const code = text3(value["code"]);
+  if (!isRecord2(value)) return void 0;
+  const code = text4(value["code"]);
   const executor = value["executor"];
-  if (code === void 0 || !isRecord(executor)) return void 0;
-  const kind = text3(executor["kind"]);
+  if (code === void 0 || !isRecord2(executor)) return void 0;
+  const kind = text4(executor["kind"]);
   if (kind === void 0) return void 0;
   const normalizedExecutor = { ...executor, kind };
-  const mode = text3(executor["mode"]);
+  const mode = text4(executor["mode"]);
   if (mode === void 0) delete normalizedExecutor.mode;
   else normalizedExecutor.mode = mode;
-  const category = isRecord(value["category"]) ? value["category"] : {};
+  const category = isRecord2(value["category"]) ? value["category"] : {};
   const inputs = [];
   for (const item of Array.isArray(value["inputs"]) ? value["inputs"] : []) {
-    if (!isRecord(item)) continue;
-    const key = text3(item["key"]);
+    if (!isRecord2(item)) continue;
+    const key = text4(item["key"]);
     if (key === void 0) continue;
     inputs.push({
       ...item,
       key,
-      type: text3(item["type"]) ?? "",
-      label: text3(item["label"]) ?? key,
+      type: text4(item["type"]) ?? "",
+      label: text4(item["label"]) ?? key,
       required: item["required"] === true
     });
   }
   const outputs = [];
   for (const item of Array.isArray(value["outputs"]) ? value["outputs"] : []) {
-    if (!isRecord(item)) continue;
-    const key = text3(item["key"]);
+    if (!isRecord2(item)) continue;
+    const key = text4(item["key"]);
     if (key === void 0) continue;
-    outputs.push({ ...item, key, type: text3(item["type"]) ?? "" });
+    outputs.push({ ...item, key, type: text4(item["type"]) ?? "" });
   }
-  const iconUrl = text3(value["iconUrl"]);
+  const iconUrl = text4(value["iconUrl"]);
   const revision = value["revision"];
   return {
     code,
-    displayName: text3(value["displayName"]) ?? code,
-    summary: text3(value["summary"]) ?? "",
+    displayName: text4(value["displayName"]) ?? code,
+    summary: text4(value["summary"]) ?? "",
     ...iconUrl === void 0 ? {} : { iconUrl },
-    category: { code: text3(category["code"]) ?? "", name: text3(category["name"]) ?? "" },
+    category: { code: text4(category["code"]) ?? "", name: text4(category["name"]) ?? "" },
     tags: stringArray(value["tags"]),
     featured: value["featured"] === true,
     revision: typeof revision === "number" && Number.isFinite(revision) ? revision : 0,
@@ -3326,9 +3615,9 @@ function toApp(value) {
   };
 }
 function toSnapshot3(value) {
-  if (!isRecord(value)) throw new ManagedWorkbenchRpcError("internal", INVALID_RESPONSE_MESSAGE2);
+  if (!isRecord2(value)) throw new ManagedWorkbenchRpcError("internal", INVALID_RESPONSE_MESSAGE3);
   const rawApps = value["apps"];
-  if (!Array.isArray(rawApps)) throw new ManagedWorkbenchRpcError("internal", INVALID_RESPONSE_MESSAGE2);
+  if (!Array.isArray(rawApps)) throw new ManagedWorkbenchRpcError("internal", INVALID_RESPONSE_MESSAGE3);
   const apps = [];
   for (const item of rawApps) {
     const app = toApp(item);
@@ -3341,10 +3630,10 @@ function toSnapshot3(value) {
     stale: value["stale"] === true
   };
   const lastError = value["lastError"];
-  if (isRecord(lastError)) {
+  if (isRecord2(lastError)) {
     snapshot.lastError = {
-      code: text3(lastError["code"]) ?? "internal",
-      message: typeof lastError["message"] === "string" ? lastError["message"] : GENERIC_FAILURE_MESSAGE2
+      code: text4(lastError["code"]) ?? "internal",
+      message: typeof lastError["message"] === "string" ? lastError["message"] : GENERIC_FAILURE_MESSAGE3
     };
   }
   return snapshot;
@@ -3509,6 +3798,7 @@ function apply(ctx) {
   const managedSkills = new ManagedSkillsStore(connection.rpc);
   const managedWorkbench = new ManagedWorkbenchStore(connection.rpc);
   const appVersion = createAppVersion(connection.rpc);
+  const pluginUpdates = createPluginUpdates(connection.rpc);
   ctx.slots.inject("settings.section", () => ctx.slots.register({
     name: "settings.section",
     id: "hiwork-usage",
@@ -3542,7 +3832,7 @@ function apply(ctx) {
   ctx.slots.inject("sidebar.footer.action", () => ctx.slots.register({
     name: "sidebar.footer.action",
     id: AI_ROUTER_NS,
-    inject: () => controller.inject()
+    inject: () => ({ ...controller.inject(), pluginUpdates })
   }, UserBadge));
   ctx.effect(() => mountLoginGate(scope, storeCredential), "hiwork-core: login gate");
   ctx.effect(() => observeHeroDecorations(document, dailyQuotes), "hiwork-core: hero decorations");

package/lib/index.js

@@ -3137,7 +3137,7 @@ function isUnloading(ctx) {
 }
 
 // src/version.ts
-var PKG_VERSION = false ? "dev" : "0.0.16";
+var PKG_VERSION = false ? "dev" : "0.0.18";
 
 // src/ai-router-client.ts
 var AUTH_AUTHORIZE_PATH = "/api/auth/authorize";
@@ -5446,6 +5446,101 @@ function registerWorkbenchRpc(ctx, deps, store) {
   };
 }
 
+// src/plugin-updates-rpc.ts
+var PLUGIN_UPDATES_RPC_CHANNEL = "/hiwork-plugin-updates";
+var PLUGIN_UPDATES_RPC_ENDPOINTS = ["snapshot", "apply"];
+var PluginUpdatesRequestError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "PluginUpdatesRequestError";
+  }
+};
+var PLUGIN_UPDATES_GENERIC_FAILURE_MESSAGE = "\u63D2\u4EF6\u66F4\u65B0\u72B6\u6001\u6682\u65F6\u65E0\u6CD5\u83B7\u53D6\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5";
+function isPluginUpdatesRpcEndpoint(endpoint) {
+  return PLUGIN_UPDATES_RPC_ENDPOINTS.includes(endpoint);
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function textOrUndefined4(value) {
+  return typeof value === "string" && value.trim() !== "" ? value : void 0;
+}
+function isAborted7(signal) {
+  return signal?.aborted === true;
+}
+function parsePluginUpdatesPayload(endpoint, raw) {
+  if (raw === void 0 || raw === null) return {};
+  if (typeof raw !== "object" || Array.isArray(raw)) {
+    throw new PluginUpdatesRequestError("bad-request", "\u63D2\u4EF6\u66F4\u65B0\u8BF7\u6C42\u53C2\u6570\u4E0D\u5408\u6CD5\u3002");
+  }
+  const keys = Object.keys(raw);
+  const first = keys[0];
+  if (first !== void 0) {
+    throw new PluginUpdatesRequestError("bad-request", `\u63D2\u4EF6\u66F4\u65B0\u8BF7\u6C42\u5305\u542B\u672A\u77E5\u5B57\u6BB5 '${first}'\u3002`);
+  }
+  return {};
+}
+function toPackageUpdate(raw) {
+  if (!isRecord3(raw)) return void 0;
+  const packageName = textOrUndefined4(raw["packageName"]);
+  if (packageName === void 0) return void 0;
+  return {
+    packageName,
+    displayName: textOrUndefined4(raw["displayName"]) ?? packageName,
+    from: textOrUndefined4(raw["from"]) ?? "",
+    to: textOrUndefined4(raw["to"]) ?? ""
+  };
+}
+function toSnapshot(raw) {
+  if (!isRecord3(raw)) return void 0;
+  const packages = [];
+  for (const item of Array.isArray(raw["packages"]) ? raw["packages"] : []) {
+    const normalized = toPackageUpdate(item);
+    if (normalized !== void 0) packages.push(normalized);
+  }
+  const revision = raw["revision"];
+  const fetchedAt = raw["fetchedAt"];
+  return {
+    packages,
+    fetchedAt: typeof fetchedAt === "number" && Number.isFinite(fetchedAt) ? fetchedAt : 0,
+    revision: typeof revision === "number" && Number.isFinite(revision) ? revision : null
+  };
+}
+async function handlePluginUpdatesEndpoint(endpoint, rawPayload, deps, signal) {
+  try {
+    if (isAborted7(signal)) return failure7("cancelled", "\u63D2\u4EF6\u66F4\u65B0\u8BF7\u6C42\u5DF2\u53D6\u6D88\u3002");
+    if (!isPluginUpdatesRpcEndpoint(endpoint)) {
+      throw new PluginUpdatesRequestError("bad-request", `\u672A\u77E5\u7684\u63D2\u4EF6\u66F4\u65B0\u7AEF\u70B9 '${endpoint}'`);
+    }
+    parsePluginUpdatesPayload(endpoint, rawPayload);
+    const plugins = deps.desktopPlugins();
+    if (endpoint === "snapshot") {
+      const value = plugins === void 0 ? null : toSnapshot(await plugins.pending()) ?? null;
+      return { ok: true, value };
+    }
+    if (plugins === void 0) {
+      return { ok: true, value: { requested: false } };
+    }
+    await plugins.applyNow();
+    return { ok: true, value: { requested: true } };
+  } catch (error) {
+    if (error instanceof PluginUpdatesRequestError) return failure7(error.code, error.message);
+    deps.log?.(`hiwork-core: \u63D2\u4EF6\u66F4\u65B0 RPC '${endpoint}' \u5931\u8D25\uFF08${error instanceof Error ? error.name : typeof error}\uFF09`);
+    return failure7("internal", PLUGIN_UPDATES_GENERIC_FAILURE_MESSAGE);
+  }
+}
+function failure7(code, message) {
+  return { ok: false, error: { code, message, details: {} } };
+}
+function registerPluginUpdatesRpc(ctx, deps) {
+  const handler = (endpoint, payload, signal) => handlePluginUpdatesEndpoint(endpoint, payload, deps, signal);
+  const remove = ctx.connection.rpc.handle(PLUGIN_UPDATES_RPC_CHANNEL, handler, { authority: "loopback" });
+  return async () => {
+    await remove();
+  };
+}
+
 // src/office-credentials.ts
 var OFFICE_CREDENTIALS_SERVICE = "hiworkOfficeCredentials";
 var OFFICE_MESSAGE_FALLBACK = {
@@ -6058,6 +6153,12 @@ function apply(ctx, config) {
       ctx.logger.warn(message);
     }
   }), "hiwork-core: app version rpc");
+  ctx.effect(() => registerPluginUpdatesRpc({ connection, logger: ctx.logger }, {
+    desktopPlugins: () => ctx.get("desktopPlugins"),
+    log: (message) => {
+      ctx.logger.warn(message);
+    }
+  }), "hiwork-core: plugin updates rpc");
   ctx.effect(() => registerIpcMessageHandler({
     source: process,
     complete: (input) => {

package/lib/plugin-updates-rpc.js

@@ -0,0 +1,187 @@
+/**
+ * `/hiwork-plugin-updates` loopback RPC 的 Host 实现：把**桌面端**的 `desktopPlugins`
+ * （受管插件清单的只读面 + 唯一的回收入口）搬到渲染端够得着的地方。
+ *
+ * 为什么必须有这条 RPC（spec §4.5 的「数据来源」一段）：`desktopPlugins` 是桌面端的
+ * `desktop-bridge.mts` 用 `ctx.provide('desktopPlugins', …)` 提供到 **DSH host** ctx 上的，
+ * 而 hiwork-core 的客户端跑在 **renderer**——两个进程。客户端现有的全部数据层（usage /
+ * session-cost / daily / managed-mcp / managed-skills / managed-workbench / app-version）
+ * 无一例外都经 `ctx.get('connection').rpc` 走 `/hiwork-*` loopback RPC，**没有任何
+ * client→host 的服务直连通道**。而「重启并更新」是个**点击**，它发生在客户端。所以取数与
+ * 触发都得过这条 RPC。
+ *
+ * 骨架照 `src/workbench-bridge.ts`（同 `src/managed-skills.ts` / `src/app-version-rpc.ts`）：
+ * 导出频道名 + 端点白名单（`as const`）+ 结构化 deps 端口（**不 import cordis 运行时**，
+ * 便于单测直接伪造）+ 一个 `register…Rpc(...)` 返回 disposer。
+ *
+ * 三条本频道特有的纪律：
+ *  - ⚠️ **`desktopPlugins` 是可选的**（不变量：依赖必须是可选的）。老桌面端上没有它 —— 那正是
+ *    「新 core + 老桌面端」这条共存路径。拿不到时 `snapshot` 回**成功信封 + `null`**
+ *    （「不可用」**不是错误**，与 `app-version-rpc.ts` 的「桌面端没推过不是错误」同一条口径），
+ *    客户端据此**不渲染任何东西**。抛错会把共存路径变成一条报错日志。
+ *  - ⚠️ **只搬运 `packages` / `revision` / `fetchedAt` 这三样**，**不搬 `held`**（plan T11
+ *    Step 0）。它们三个是真的：落在 `.dsh-pending-updates.json` 里，跨进程可用。`held` /
+ *    `from` / `displayName` 在生产路径上是空的——根因是 `desktop-bridge.mts` 调
+ *    `createDesktopHostServices()` 时**没传 `pluginManifest`**，于是 `desktop-host.ts` 里那条
+ *    `memory = options.pluginManifest?.current()` 恒 `undefined`、`held` 退到 `?? []`。
+ *    那条通道要修得补一条**主进程 → 子进程**的路（新 IPC 信封或 sidecar 文件），而**本 RPC 是
+ *    client→host 的**，它跨的是「renderer↔DSH」，**跨不过「DSH↔主进程」这一层**。所以别「顺手把
+ *    `held` 也传过去」——传过去也永远是空的，只会让下一个读这段的人以为服务端没下发降级项。
+ *  - ⚠️ **`apply` 不是「更新成功」的回执**：它只把触发递下去（`desktopPlugins.applyNow()` →
+ *    `APPLY_PLUGIN_UPDATES_IPC` → 主进程的 `recycleDshForPluginUpdate()`），重启由**主进程**执行、
+ *    客户端那一刻就没了。按钮语义是「已请求重启」。所以返回值是 `{ requested }`，
+ *    **不是** `{ applied: true }`。
+ *
+ * 回收红线（spec §6.1 不变量②）：本文件的 `apply` 是**唯一**允许触发回收的新入口，且只能由
+ * 用户点击到达（客户端只在「重启并更新」按钮的 onClick 里调它）。`snapshot` **绝不触碰**
+ * `applyNow()`——清单拉取、轮询、启动流程都不许触发回收。
+ */
+/** RPC 频道；必须与 client 半边 `src/client/plugin-updates.ts` 的 `PLUGIN_UPDATES_CHANNEL` 一致（由测试锁定）。 */
+export const PLUGIN_UPDATES_RPC_CHANNEL = '/hiwork-plugin-updates';
+/**
+ * 端点白名单：只有两个。
+ *
+ * `snapshot` 是「现在有没有待生效的更新」（桌面端读 pending 文件，**不拉清单、不写文件、
+ * 不触发回收**），`apply` 是「现在就去重启并应用」——它只在用户点击时被调用。
+ * 白名单是客户端可用的能力边界，多一项就等于先发布了一个没有实现的承诺。
+ */
+export const PLUGIN_UPDATES_RPC_ENDPOINTS = ['snapshot', 'apply'];
+/** 请求侧错误（只有 `bad-request`：未知端点 / 非法 payload）。 */
+export class PluginUpdatesRequestError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'PluginUpdatesRequestError';
+    }
+}
+/** 通用失败文案：不暴露任何桌面端细节。 */
+export const PLUGIN_UPDATES_GENERIC_FAILURE_MESSAGE = '插件更新状态暂时无法获取，请稍后重试';
+/** 是否为白名单端点。 */
+export function isPluginUpdatesRpcEndpoint(endpoint) {
+    return PLUGIN_UPDATES_RPC_ENDPOINTS.includes(endpoint);
+}
+/** 宽松的记录判定（数组与 null 都不算）。 */
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** 非空字符串或 undefined。 */
+function textOrUndefined(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value : undefined;
+}
+/** 取消判定（用函数包一层，避免 TS 把属性窄化固化到 `await` 之后）。 */
+function isAborted(signal) {
+    return signal?.aborted === true;
+}
+/**
+ * payload 校验：两个端点都**只放行空对象**（本频道没有任何入参）。
+ *
+ * 与 workbench / app-version 的空入参分支逐字同款：出现任何字段都是客户端实现缺陷，直接
+ * `bad-request`——一个 `{ force: true }` 被静默忽略，会让调用方以为「强制重启」生效了。
+ */
+export function parsePluginUpdatesPayload(endpoint, raw) {
+    if (raw === undefined || raw === null)
+        return {};
+    if (typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new PluginUpdatesRequestError('bad-request', '插件更新请求参数不合法。');
+    }
+    const keys = Object.keys(raw);
+    const first = keys[0];
+    if (first !== undefined) {
+        throw new PluginUpdatesRequestError('bad-request', `插件更新请求包含未知字段 '${first}'。`);
+    }
+    // endpoint 已在调用方过白名单；这里保留参数是为了类型上与其它频道的 parse* 同形。
+    void endpoint;
+    return {};
+}
+/**
+ * 一条更新的规范化：**只在缺 `packageName` 时丢条目**，其余兜底。
+ *
+ * 为什么判据是 `packageName` 而不是「`to` 是不是精确版本」：界面**只**依赖
+ * `packages.length > 0`（spec §4.3 的 ⚠️）。在这里按更严的形状丢条目，等于把一份真的待生效
+ * 更新静默吃掉——用户就再也等不到重启提示了。所以「形状兜底」在此处的方向是**保住计数**：
+ * 只要这条还指得出是哪个包就留下，`to` 缺了就记空串（界面本来也不渲染它）。
+ * 反过来，缺 `packageName` 的条目连「有没有东西要装」都回答不了，留着只会让界面误报。
+ */
+function toPackageUpdate(raw) {
+    if (!isRecord(raw))
+        return undefined;
+    const packageName = textOrUndefined(raw['packageName']);
+    if (packageName === undefined)
+        return undefined;
+    return {
+        packageName,
+        displayName: textOrUndefined(raw['displayName']) ?? packageName,
+        from: textOrUndefined(raw['from']) ?? '',
+        to: textOrUndefined(raw['to']) ?? '',
+    };
+}
+/**
+ * 把 `desktopPlugins.pending()` 的返回值规范化成 {@link PluginUpdatesSnapshot}。
+ *
+ * `undefined` / 非对象 → `undefined`（= 没有待生效项，界面不渲染）。**只有降级项（`held` 非空、
+ * `packages` 为空）时同样落成空 `packages`**，由客户端据此不渲染——回退对员工是要解释的事，
+ * 不该混在「更新已就绪」里（spec §4.5）。`held` 本身不搬运，理由见文件头。
+ */
+export function toSnapshot(raw) {
+    if (!isRecord(raw))
+        return undefined;
+    const packages = [];
+    for (const item of Array.isArray(raw['packages']) ? raw['packages'] : []) {
+        const normalized = toPackageUpdate(item);
+        if (normalized !== undefined)
+            packages.push(normalized);
+    }
+    const revision = raw['revision'];
+    const fetchedAt = raw['fetchedAt'];
+    return {
+        packages,
+        fetchedAt: typeof fetchedAt === 'number' && Number.isFinite(fetchedAt) ? fetchedAt : 0,
+        revision: typeof revision === 'number' && Number.isFinite(revision) ? revision : null,
+    };
+}
+/**
+ * 处理一次端点调用：返回 DSH Connection 的结果信封，**永不抛异常**。
+ * 导出以便单测直接驱动（无需伪造 `ctx.connection`）。
+ */
+export async function handlePluginUpdatesEndpoint(endpoint, rawPayload, deps, signal) {
+    try {
+        if (isAborted(signal))
+            return failure('cancelled', '插件更新请求已取消。');
+        if (!isPluginUpdatesRpcEndpoint(endpoint)) {
+            throw new PluginUpdatesRequestError('bad-request', `未知的插件更新端点 '${endpoint}'`);
+        }
+        parsePluginUpdatesPayload(endpoint, rawPayload);
+        const plugins = deps.desktopPlugins();
+        if (endpoint === 'snapshot') {
+            // 「不可用」是**成功信封 + null**，不是错误（老桌面端共存的正常路径，见文件头）。
+            const value = plugins === undefined ? null : toSnapshot(await plugins.pending()) ?? null;
+            return { ok: true, value };
+        }
+        // apply：**唯一**的回收触发点，只在用户点击时到达这里。
+        if (plugins === undefined) {
+            // 不可用时不调 applyNow（没有可调的对象），同样按「不是错误」回执：
+            // `requested: false` 如实告诉客户端「这次请求没有被递下去」。
+            return { ok: true, value: { requested: false } };
+        }
+        await plugins.applyNow();
+        return { ok: true, value: { requested: true } };
+    }
+    catch (error) {
+        if (error instanceof PluginUpdatesRequestError)
+            return failure(error.code, error.message);
+        deps.log?.(`hiwork-core: 插件更新 RPC '${endpoint}' 失败（${error instanceof Error ? error.name : typeof error}）`);
+        return failure('internal', PLUGIN_UPDATES_GENERIC_FAILURE_MESSAGE);
+    }
+}
+function failure(code, message) {
+    return { ok: false, error: { code, message, details: {} } };
+}
+/**
+ * 注册 `/hiwork-plugin-updates` 频道，返回异步 disposer（交给 `ctx.effect` 管理生命周期）。
+ */
+export function registerPluginUpdatesRpc(ctx, deps) {
+    const handler = (endpoint, payload, signal) => handlePluginUpdatesEndpoint(endpoint, payload, deps, signal);
+    const remove = ctx.connection.rpc.handle(PLUGIN_UPDATES_RPC_CHANNEL, handler, { authority: 'loopback' });
+    return async () => { await remove(); };
+}

package/lib/types/client/plugin-updates.d.ts

@@ -0,0 +1,150 @@
+/**
+ * 「插件更新待重启」取数层：经 `/hiwork-plugin-updates` loopback RPC 问 Host
+ * 「现在有没有待生效的插件更新」，并在用户点「重启并更新」时触发那次重启。
+ *
+ * Host 半边见 `src/plugin-updates-rpc.ts`（照 `src/workbench-bridge.ts` 的骨架）。
+ * 为什么必须有这条 RPC：`desktopPlugins` 在 **DSH host** ctx 上，而本文件跑在 **renderer**
+ * ——客户端没有任何 client→host 的服务直连通道，只有 `ctx.get('connection').rpc`。
+ *
+ * 四条本层特有的纪律：
+ *  - ⚠️ **不可用不是错误**（老桌面端共存路径）：Host 回 `ok:true` + `null` 时本层归一为
+ *    `undefined`，界面据此**不渲染任何东西**。RPC 失败同样是「这一轮没拿到」，
+ *    **不覆写上一次镜像**——提示条不该因为一次读盘 / 传输抖动或一次网关重启而凭空消失。
+ *  - ⚠️ **只依赖 `packages.length > 0` 与 `revision`**（spec §4.3 的 ⚠️）：`from` /
+ *    `displayName` 在生产路径恒为空 / 退化成包名，`held` 则恒为 `[]`（根因在桌面端
+ *    `desktop-bridge.mts` 没传 `pluginManifest`，见 `src/plugin-updates-rpc.ts` 文件头）。
+ *    所以本层虽然按桌面端契约透传 `packages[i]` 的四个字段，但**界面不许拿它们渲染文案**。
+ *  - ⚠️ **「关闭」按「本次会话 + 该 revision」记**（内存，不落盘）：同一个 revision 不再提示，
+ *    `revision` 变了要能重新提示——否则管理员推完修复、员工关过一次就再也看不见，又变成
+ *    「推了没反应」。`revision` 为 `null`（服务端没给）时 `null` 自成**一个桶**，语义同上。
+ *  - ⚠️ **`requestRestart` 不是「更新成功」的回执**：它只把触发递下去，重启由主进程执行，
+ *    客户端那一刻就没了。`true` 的语义是「已请求重启」。
+ *
+ * client bundle 纯度：本文件不 import 任何 `@deepseek-ai/*` 运行时值，也不 import Host 代码
+ * （响应字段在这里按结构重声明）。
+ */
+/** RPC 频道；必须与 Host `src/plugin-updates-rpc.ts` 的 `PLUGIN_UPDATES_RPC_CHANNEL` 一致（由测试锁定）。 */
+export declare const PLUGIN_UPDATES_CHANNEL = "/hiwork-plugin-updates";
+/** 端点白名单；必须与 Host `PLUGIN_UPDATES_RPC_ENDPOINTS` 一致（由测试锁定）。 */
+export declare const PLUGIN_UPDATES_ENDPOINTS: readonly ["snapshot", "apply"];
+export type PluginUpdatesEndpoint = (typeof PLUGIN_UPDATES_ENDPOINTS)[number];
+/**
+ * 轮询间隔：5 分钟。
+ *
+ * 为什么必须轮询：清单是**主进程**在**运行期**每 6h 拉一次、**只写 pending 文件不应用**
+ * （spec §4.2 的时机表）——也就是说「有待重启的更新」这件事**只会在运行期出现**（启动边界那
+ * 一次拉完就当场应用掉了）。不轮询的话侧栏永远等不到提示条（验收 E3：员工不退出、保持运行 →
+ * 提示条出现）。
+ *
+ * 为什么是 5 分钟：它只是一次 loopback RPC + 桌面端一次读盘，代价远低于「更新提示迟到 6 小时」；
+ * 取值与 client 半边既有的本地镜像 TTL 同量级（`MANAGED_WORKBENCH_STALE_MS` = 5 分钟）。
+ */
+export declare const PLUGIN_UPDATES_POLL_INTERVAL_MS: number;
+/**
+ * 一条待生效的更新（**冻结契约**：与桌面端 `ManagedPluginUpdate` 逐字同形）。
+ *
+ * ⚠️ `from` / `displayName` **不得用于渲染**（见文件头）。
+ */
+export interface PendingPluginUpdate {
+    packageName: string;
+    displayName: string;
+    from: string;
+    to: string;
+}
+/** 一次待更新快照。`revision` = 清单级版本号（服务端没给就是 `null`），供「关闭」去重。 */
+export interface PluginUpdatesSnapshot {
+    packages: PendingPluginUpdate[];
+    fetchedAt: number;
+    revision: number | null;
+}
+/** 宿主 loopback RPC 调用面（结构兼容 `ctx.connection.rpc`）。 */
+export interface PluginUpdatesRpcPort {
+    call(channel: string, endpoint: string, payload: unknown, signal?: AbortSignal): Promise<unknown>;
+}
+/** 带稳定 code 的取数错误（message 已由 Host 消毒，可直接展示）。 */
+export declare class PluginUpdatesRpcError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * 解开 DSH Connection 的结果信封。
+ *
+ * `ok:false` 一律**抛错**（由调用方决定「保留上一次镜像」）——这是「这一轮没拿到」与
+ * 「拿到了一份空的」之间的那道闸，把它读成 `value` 会让一次 RPC 抖动变成「更新没了」。
+ * 只有 `ok === true` 才返回 `value`（`value` 可以是 `null`：那是**不可用**，不是错误）。
+ */
+export declare function unwrapPluginUpdatesResult<T>(value: unknown): T;
+/** 任意异常 → 可展示的 `{code, message}`（传输层异常不暴露原始 message）。 */
+export declare function pluginUpdatesErrorOf(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * 快照形状校验：`null`（不可用）/ 形状不合法一律归一为 `undefined`。
+ *
+ * `undefined` 是**唯一**的「界面什么都不渲染」信号，所以「不可用」与「响应坏了」在这里合并
+ * ——两者对界面是同一件事，区分它们只会多一条没有消费者的分支。
+ */
+export declare function toPluginUpdatesSnapshot(value: unknown): PluginUpdatesSnapshot | undefined;
+/**
+ * 「插件更新待重启」的取数仓库。
+ *
+ * 状态有三样，全部只活在内存里（**不落盘**）：
+ *  - `current`：最近一次**成功**取到的快照（失败不覆写，见 {@link refresh}）；
+ *  - `dismissed`：用户关掉过的那一个 `revision`（`undefined` = 从没关过；`null` = 关过
+ *    「服务端没给 revision」的那一份）。比较是**按值**的，所以 `revision` 一变就自动重新提示；
+ *  - `version`：变化计数，供 `useSyncExternalStore` 当 `getSnapshot` 用（值变了才重渲染）。
+ */
+export declare class PluginUpdatesStore {
+    private readonly rpc;
+    private current;
+    private dismissed;
+    private version;
+    private readonly listeners;
+    constructor(rpc: PluginUpdatesRpcPort);
+    /** 最近一次成功取到的快照（同步读，可能比服务端现状旧）。没有 / 不可用时 `undefined`。 */
+    snapshot(): PluginUpdatesSnapshot | undefined;
+    /** 变化计数：`useSyncExternalStore` 的 `getSnapshot`（值变化即重渲染）。 */
+    getVersion: () => number;
+    /** 订阅变化（快照更新 / 关闭）。返回退订函数。 */
+    subscribe: (listener: () => void) => (() => void);
+    /** 这个 revision 是否已经被用户关掉过（同 revision 不再提示；换 revision 会重新提示）。 */
+    isDismissed(revision: number | null): boolean;
+    /**
+     * 现在是否该渲染提示卡片。
+     *
+     * 三个条件缺一不可：**有快照**（不可用 / 从没取到 → 不渲染）、**`packages` 非空**
+     * （只有降级项时桌面端返回的也是空 `packages`，spec §4.5 明确不弹）、**这个 revision 没被关过**。
+     * ⚠️ 判据里**没有** `held` / `from` / `displayName`（spec §4.3 的 ⚠️）。
+     */
+    shouldPrompt(): boolean;
+    /**
+     * 记住「用户关掉了这一个 revision 的提示」。**只记内存**（spec §4.5：本次会话 + 该 revision），
+     * 不落盘、不调任何 apply。
+     */
+    dismiss(): void;
+    /**
+     * 向 Host 取一次「有没有待生效的更新」。
+     *
+     * 返回 `undefined` 有两种来源，对调用方是同一件事（**不渲染**）：Host 说「不可用」（`null`），
+     * 或响应形状不合法。⚠️ **失败（`ok:false` / 传输异常）一律抛错且不覆写镜像**——提示条不该
+     * 因为一次抖动而消失，而「更新已经在排队」这件事不会因为读不出来就不存在。
+     */
+    refresh(signal?: AbortSignal): Promise<PluginUpdatesSnapshot | undefined>;
+    /**
+     * 请求「重启并更新」。**这是全链路唯一的回收入口，且只能由用户点击到达。**
+     *
+     * 返回 `true` 表示触发**已经递下去**（最终落到主进程的 `recycleDshForPluginUpdate()`），
+     * **不是**「更新成功」——主进程会重建窗口，客户端那一刻就没了。
+     * `false` 只在「老桌面端上没有 `desktopPlugins`」时出现（Host 回 `requested: false`）。
+     */
+    requestRestart(signal?: AbortSignal): Promise<boolean>;
+    private bump;
+}
+/**
+ * 造一份取数面：直接返回仓库本身（组件的 `inject` 面要的就是它）。
+ *
+ * 保留这层构造函数是为了与 client 半边既有的 `createAppVersion(connection.rpc)` 同形——
+ * 装配点只看这一个入口，不直接 new。
+ */
+export declare function createPluginUpdates(rpc: PluginUpdatesRpcPort): PluginUpdatesStore;

package/lib/types/client/user-badge.d.ts

@@ -1,5 +1,6 @@
 import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import { type AiRouterCardFace } from './controller.ts';
+import { type PluginUpdatesStore } from './plugin-updates.ts';
 /**
  * 侧边栏底部「设置」上方的账号信息行：显示当前登录网关的显示名（网关 LDAP
  * 中文名，缺省回退登录账号）。「头像 + 用户名」是一个合并钮，hover 高亮与点击
@@ -9,6 +10,15 @@ import { type AiRouterCardFace } from './controller.ts';
  * 设置入口。行几何（高度/留白/字号/图标尺寸）与 ui-settings-general 的设置触发
  * 行完全一致。
  */
-export type UserBadgeProps = PropsRuntime<'sidebar.footer.action'> & InjectFace<AiRouterCardFace>;
-/** 底部账号信息行。 */
+/**
+ * 「插件更新待重启」的取数面（`/hiwork-plugin-updates`，见 `src/client/plugin-updates.ts`）。
+ *
+ * 单独成一格而**不是**塞进 `AiRouterCardFace`：那个面是登录卡片的控制器，与插件更新无关；
+ * 合成面在这里做，注册点只负责把两者拼起来（`src/client/index.ts`）。
+ */
+export interface PluginUpdatesFace {
+    pluginUpdates: PluginUpdatesStore;
+}
+export type UserBadgeProps = PropsRuntime<'sidebar.footer.action'> & InjectFace<AiRouterCardFace & PluginUpdatesFace>;
+/** 底部账号信息行（宽栏 / 折叠栏共用；插件更新提示卡片也由它渲染，见下）。 */
 export declare function UserBadge(props: UserBadgeProps): import("react").JSX.Element | null;

package/lib/types/plugin-updates-rpc.d.ts

@@ -0,0 +1,169 @@
+/**
+ * `/hiwork-plugin-updates` loopback RPC 的 Host 实现：把**桌面端**的 `desktopPlugins`
+ * （受管插件清单的只读面 + 唯一的回收入口）搬到渲染端够得着的地方。
+ *
+ * 为什么必须有这条 RPC（spec §4.5 的「数据来源」一段）：`desktopPlugins` 是桌面端的
+ * `desktop-bridge.mts` 用 `ctx.provide('desktopPlugins', …)` 提供到 **DSH host** ctx 上的，
+ * 而 hiwork-core 的客户端跑在 **renderer**——两个进程。客户端现有的全部数据层（usage /
+ * session-cost / daily / managed-mcp / managed-skills / managed-workbench / app-version）
+ * 无一例外都经 `ctx.get('connection').rpc` 走 `/hiwork-*` loopback RPC，**没有任何
+ * client→host 的服务直连通道**。而「重启并更新」是个**点击**，它发生在客户端。所以取数与
+ * 触发都得过这条 RPC。
+ *
+ * 骨架照 `src/workbench-bridge.ts`（同 `src/managed-skills.ts` / `src/app-version-rpc.ts`）：
+ * 导出频道名 + 端点白名单（`as const`）+ 结构化 deps 端口（**不 import cordis 运行时**，
+ * 便于单测直接伪造）+ 一个 `register…Rpc(...)` 返回 disposer。
+ *
+ * 三条本频道特有的纪律：
+ *  - ⚠️ **`desktopPlugins` 是可选的**（不变量：依赖必须是可选的）。老桌面端上没有它 —— 那正是
+ *    「新 core + 老桌面端」这条共存路径。拿不到时 `snapshot` 回**成功信封 + `null`**
+ *    （「不可用」**不是错误**，与 `app-version-rpc.ts` 的「桌面端没推过不是错误」同一条口径），
+ *    客户端据此**不渲染任何东西**。抛错会把共存路径变成一条报错日志。
+ *  - ⚠️ **只搬运 `packages` / `revision` / `fetchedAt` 这三样**，**不搬 `held`**（plan T11
+ *    Step 0）。它们三个是真的：落在 `.dsh-pending-updates.json` 里，跨进程可用。`held` /
+ *    `from` / `displayName` 在生产路径上是空的——根因是 `desktop-bridge.mts` 调
+ *    `createDesktopHostServices()` 时**没传 `pluginManifest`**，于是 `desktop-host.ts` 里那条
+ *    `memory = options.pluginManifest?.current()` 恒 `undefined`、`held` 退到 `?? []`。
+ *    那条通道要修得补一条**主进程 → 子进程**的路（新 IPC 信封或 sidecar 文件），而**本 RPC 是
+ *    client→host 的**，它跨的是「renderer↔DSH」，**跨不过「DSH↔主进程」这一层**。所以别「顺手把
+ *    `held` 也传过去」——传过去也永远是空的，只会让下一个读这段的人以为服务端没下发降级项。
+ *  - ⚠️ **`apply` 不是「更新成功」的回执**：它只把触发递下去（`desktopPlugins.applyNow()` →
+ *    `APPLY_PLUGIN_UPDATES_IPC` → 主进程的 `recycleDshForPluginUpdate()`），重启由**主进程**执行、
+ *    客户端那一刻就没了。按钮语义是「已请求重启」。所以返回值是 `{ requested }`，
+ *    **不是** `{ applied: true }`。
+ *
+ * 回收红线（spec §6.1 不变量②）：本文件的 `apply` 是**唯一**允许触发回收的新入口，且只能由
+ * 用户点击到达（客户端只在「重启并更新」按钮的 onClick 里调它）。`snapshot` **绝不触碰**
+ * `applyNow()`——清单拉取、轮询、启动流程都不许触发回收。
+ */
+/** RPC 频道；必须与 client 半边 `src/client/plugin-updates.ts` 的 `PLUGIN_UPDATES_CHANNEL` 一致（由测试锁定）。 */
+export declare const PLUGIN_UPDATES_RPC_CHANNEL = "/hiwork-plugin-updates";
+/**
+ * 端点白名单：只有两个。
+ *
+ * `snapshot` 是「现在有没有待生效的更新」（桌面端读 pending 文件，**不拉清单、不写文件、
+ * 不触发回收**），`apply` 是「现在就去重启并应用」——它只在用户点击时被调用。
+ * 白名单是客户端可用的能力边界，多一项就等于先发布了一个没有实现的承诺。
+ */
+export declare const PLUGIN_UPDATES_RPC_ENDPOINTS: readonly ["snapshot", "apply"];
+export type PluginUpdatesRpcEndpoint = (typeof PLUGIN_UPDATES_RPC_ENDPOINTS)[number];
+/**
+ * 一条待生效的更新（**冻结契约**：与桌面端 `ManagedPluginUpdate` 逐字同形）。
+ *
+ * ⚠️ `from` / `displayName` **不得用于渲染任何东西**（spec §4.3 的 ⚠️）：生产路径上 `from` 恒空串、
+ * `displayName` 退化成包名（`pendingUpdatesFromDisk()`）。保留它们是为了贴合桌面端契约，
+ * 不是因为它们可用——界面只认 `packages.length > 0`。
+ */
+export interface PendingPluginUpdate {
+    packageName: string;
+    displayName: string;
+    from: string;
+    to: string;
+}
+/**
+ * 一次待更新快照。
+ *
+ * `revision` 供提示条去重「关过一次的提示」（spec §4.5）：**服务端没给就是 `null`**，
+ * 客户端把 `null` 当作一个独立的桶（关过它就不再提示，换了值就重新提示）。
+ *
+ * **本对象里没有 `held`**：见文件头第二条纪律。
+ */
+export interface PluginUpdatesSnapshot {
+    packages: PendingPluginUpdate[];
+    /** 桌面端最近一次清单的时刻（epoch ms）；拿不到就是 0。 */
+    fetchedAt: number;
+    /** 清单级版本号；服务端没给就是 `null`。 */
+    revision: number | null;
+}
+/** `snapshot` 端点的响应：`null` = 不可用（老桌面端没有 `desktopPlugins`）。**不是错误**。 */
+export type PluginUpdatesSnapshotValue = PluginUpdatesSnapshot | null;
+/** `apply` 端点的响应：`requested` = 触发是否递下去了（**不是**「更新是否成功」）。 */
+export interface PluginUpdatesApplyValue {
+    requested: boolean;
+}
+/** 客户端可安全展示的失败。 */
+export interface PluginUpdatesFailure {
+    code: string;
+    message: string;
+    /** DSH Connection 信封要求 `details` 是对象；协议层没有额外细节时补空对象。 */
+    details: object;
+}
+/** 端点结果信封（与 DSH Connection 的 `ConnectionRpcResult` 同形）。 */
+export type PluginUpdatesRpcResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: PluginUpdatesFailure;
+};
+/** 请求侧错误（只有 `bad-request`：未知端点 / 非法 payload）。 */
+export declare class PluginUpdatesRequestError extends Error {
+    readonly code: 'bad-request';
+    constructor(code: 'bad-request', message: string);
+}
+/** Host 侧 RPC 依赖的最小上下文（结构兼容 cordis Context，便于单测伪造）。 */
+export interface PluginUpdatesRpcConnection {
+    rpc: {
+        handle(channel: string, handler: (endpoint: string, payload: unknown, signal: AbortSignal) => Promise<unknown>, options: {
+            authority: 'loopback';
+        }): () => Promise<void> | void;
+    };
+}
+export interface PluginUpdatesRpcContext {
+    readonly connection: PluginUpdatesRpcConnection;
+    readonly logger: {
+        warn(message: string): void;
+    };
+}
+/**
+ * 桌面端 `desktopPlugins` 服务在本频道里真正用到的那两个成员（结构兼容，便于单测伪造）。
+ *
+ * 返回值一律按 `unknown` 收：它来自**另一个包**在运行时 provide 的对象，本文件不假设它的形状
+ * ——形状由 {@link toSnapshot} 兜底（这正是「不变量：拿不到就当不可用」在取值一侧的落实）。
+ */
+export interface DesktopPluginsPort {
+    /** 待生效的更新；没有待生效项（含只有 `held`）时返回 `undefined`。 */
+    pending(): Promise<unknown>;
+    /** 等价于用户点插件市场的「更新」：立刻回收。**只能由用户点击触发**。 */
+    applyNow(): Promise<unknown>;
+}
+/** Host 侧取数依赖：桌面端的 `desktopPlugins` 服务（老桌面端上没有它）。 */
+export interface PluginUpdatesRpcDeps {
+    /**
+     * 现取 `ctx.get('desktopPlugins')`；拿不到返回 `undefined`（老桌面端）。
+     *
+     * 做成**函数**而不是值：cordis 的服务可能在插件生命周期中途才被 provide / 被撤下，
+     * 一次性取到的值会把「还没 provide」误判成「永远没有」。
+     */
+    desktopPlugins(): DesktopPluginsPort | undefined;
+    /** Host 日志出口（只记事件与错误类型）。 */
+    log?: ((message: string) => void) | undefined;
+}
+/** 通用失败文案：不暴露任何桌面端细节。 */
+export declare const PLUGIN_UPDATES_GENERIC_FAILURE_MESSAGE = "\u63D2\u4EF6\u66F4\u65B0\u72B6\u6001\u6682\u65F6\u65E0\u6CD5\u83B7\u53D6\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5";
+/** 是否为白名单端点。 */
+export declare function isPluginUpdatesRpcEndpoint(endpoint: string): endpoint is PluginUpdatesRpcEndpoint;
+/**
+ * payload 校验：两个端点都**只放行空对象**（本频道没有任何入参）。
+ *
+ * 与 workbench / app-version 的空入参分支逐字同款：出现任何字段都是客户端实现缺陷，直接
+ * `bad-request`——一个 `{ force: true }` 被静默忽略，会让调用方以为「强制重启」生效了。
+ */
+export declare function parsePluginUpdatesPayload(endpoint: PluginUpdatesRpcEndpoint, raw: unknown): Record<string, never>;
+/**
+ * 把 `desktopPlugins.pending()` 的返回值规范化成 {@link PluginUpdatesSnapshot}。
+ *
+ * `undefined` / 非对象 → `undefined`（= 没有待生效项，界面不渲染）。**只有降级项（`held` 非空、
+ * `packages` 为空）时同样落成空 `packages`**，由客户端据此不渲染——回退对员工是要解释的事，
+ * 不该混在「更新已就绪」里（spec §4.5）。`held` 本身不搬运，理由见文件头。
+ */
+export declare function toSnapshot(raw: unknown): PluginUpdatesSnapshot | undefined;
+/**
+ * 处理一次端点调用：返回 DSH Connection 的结果信封，**永不抛异常**。
+ * 导出以便单测直接驱动（无需伪造 `ctx.connection`）。
+ */
+export declare function handlePluginUpdatesEndpoint(endpoint: string, rawPayload: unknown, deps: PluginUpdatesRpcDeps, signal?: AbortSignal): Promise<PluginUpdatesRpcResult<unknown>>;
+/**
+ * 注册 `/hiwork-plugin-updates` 频道，返回异步 disposer（交给 `ctx.effect` 管理生命周期）。
+ */
+export declare function registerPluginUpdatesRpc(ctx: PluginUpdatesRpcContext, deps: PluginUpdatesRpcDeps): () => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hiwork-core",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "type": "module",
   "description": "HiWork 企业统一登录与模型自动供给插件（ai-router 网关登录，Web 表单，无 CLI 认证）",
   "license": "UNLICENSED",