dsh-composer-ux 0.16.5 → 0.17.1

package/CHANGELOG.md

@@ -2,6 +2,43 @@
 
 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.17.1] — 2026-10-01（说清「两条通道不要同时开同一类事件」）
+
+用户的决定（2026-10-01）：**个人微信交给 dsh-notify-plugin**（它自己扫码、自己实现 iLink 协议），
+**本插件这条 PushPlus / 企业微信群机器人通道保留**，当作"不想再装一个插件"时的退路。
+
+由此多出一个真实的使用陷阱：两条通道都开同一类事件 ⇒ **同一条事会推两遍**。
+所以这一版把提醒直接写进设置页的「微信通知」卡里（不靠文档，用户当场看得见）。
+
+本次只改文案，不动任何逻辑：28 个套件 2473 条 0 失败、变异 167/167（与 0.17.0 相同）。
+## [0.17.0] — 2026-10-01（新增：单向微信通知）
+
+用户 2026-10-01 明确：**只要通知，不做双向**、不走 OpenClaw，用现成的微信推送服务。界面里固定标注
+**「只能通知，不能回」** —— 不暗示一个不存在的能力。
+
+- **两条渠道**：PushPlus token（推到你关注的公众号对话）/ 企业微信群机器人 webhook；总开关**默认关**。
+- **三类事件**（照 dsh-messager 那套）：需要你回应（等审批 / 等你回答）· 任务完成 · 任务出错。
+  挂在官方事件上：`approval/request`、`user-questions/request`、（**waterfall 透传**，只观察不代答）、
+  （只有 running→idle 才算完成）、。
+- **防刷屏**：30 秒内同会话同类合并（按会话分桶，别的会话完成不会被吞）。
+- **测试推送**：绕过防刷屏与分类开关（但仍要求总开关开着、凭据填了），且**不写记账**
+  —— 否则一次测试会压掉后面真实的通知。
+- **凭据安全**：只存本机；界面与日志只显示打码形式（头 4 尾 2）；响应体与错误信息里绝不回显 token。
+- **投递在宿主侧**：标签页关着也能推。宿主没有事件总线时**只告警不挂**（通知挂不上绝不连累宿主启动）。
+
+## 验证
+
+- `npm test`：**28 个套件 2473 passed / 0 failed**（新增 4 个套件：微信通知核心 / 事件适配 /
+  发送器 / 测试推送路由）。
+- 变异：**167/167 全部咬住**（新增 FP 审批不再透传、FQ 去掉防刷屏、FR 凭据不打码；并把 0.16.4
+  滚动改动后失效的 EC/FC 两条重新对准当前结构）。
+
+## 待用户验收（不是已验证）
+
+**「消息真的到你手机」这一步我无法验证** —— 这台机器上没有 PushPlus token、也没有群机器人地址。
+请你在设置页打开总开关、填好凭据、点一次**「发送测试」**：界面上会显示渠道给的原话（成功或失败原因）。
+在这条完成之前，请不要把本功能当成已验证。
+
 ## [0.16.5] — 2026-10-01（设置页抬头加「官网 ↗」）
 
 起因（用户原话）：**「https://www.deepseek.com/harness/ 把这个 DSH 的官网链接放到我的插件里」**；

package/README.md

@@ -518,7 +518,7 @@ Windows 上 DSH 给模型的终端工具是 **PowerShell**（工具名 `pwsh`）
 | 工具循环的消息形状 / 轮次封顶 / 异常必须降级 | 同上第 6 节（假 llm 驱动整条循环，逐条检查 `role:'tool'` 与 `toolCallId`） |
 | 工具路径：默认关、开了才派、**查完吐散文必须回落**、拿不到工作目录就不派 | `test/quick-commands.mjs` 5g 节（13 条，真路由 + 假 llm） |
 | 工具读到的内容不进台账 | 同 5g 节：断言台账里只有工具名与次数、没有读到的文件内容 |
-| 变异守卫真的会咬人，且**必须是指定的那条测试变红** | `npm run test:mutations`：**164 条全部咬住**（判据是 `red.some(line => line.includes(item.expect))`，不是"有红就行"） |
+| 变异守卫真的会咬人，且**必须是指定的那条测试变红** | `npm run test:mutations`：**167 条全部咬住**（判据是 `red.some(line => line.includes(item.expect))`，不是"有红就行"） |
 | 发布门禁三条判据 | `npm run gates` 全过；`check:tag` 实测 `v0.12.0` 的 tag 名与所指提交里的版本一致 |
 | 三平台 CI | GitHub Actions：ubuntu / windows / macos × Node 20（`npm ci → typecheck → build → test → check:pack → check:docs`） |
 
@@ -652,9 +652,9 @@ node build.mjs                    # 产出 lib/index.js + lib/client.js
                                   #   ⚠️ 宿主半会**内联** schemastery / cosmokit：
                                   #   优先用 DSH 检出里的 vendor 副本，检出不在时退到 node_modules
                                   #   里同版本的 npm 包（两者逐字节相同）——CI 上走的就是退路
-npm test                          # 24 个套件；当前 2385 passed, 0 failed（2026-09-29 实测；CI 三平台同样全绿）
+npm test                          # 28 个套件；当前 2473 passed, 0 failed（2026-09-29 实测；CI 三平台同样全绿）
                                   #   走 scripts/run-tests.mjs：顺带把"多少套件/多少条"记进 test/.last-run.json
-npm run test:mutations            # 手动跑：变异测试，证明那套护栏真的在咬人（164 条，须单独跑）
+npm run test:mutations            # 手动跑：变异测试，证明那套护栏真的在咬人（167 条，须单独跑）
                                   #   同样记录结果，供下面的文档门禁核对
 npm run gates                     # 发版门禁三条一起跑：tag 指向 / 包内容 / 文档数字
 npm run check:tag                 #   ① tag 名里的版本 == 该 tag 所指提交里的 package.json 版本

package/lib/client.js

@@ -1011,6 +1011,12 @@ var RESTART_CSRF_HEADER = "x-composer-ux-restart";
 var RESTART_CSRF_VALUE = "1";
 var SYNC_API_PATH = "/composer-ux/sync-prices";
 var ENABLED_FIELD = "enabled";
+var NOTIFY_ENABLED_FIELD = "notifyEnabled";
+var NOTIFY_CHANNEL_FIELD = "notifyChannel";
+var NOTIFY_PUSHPLUS_FIELD = "notifyPushplusToken";
+var NOTIFY_WECOM_FIELD = "notifyWecomWebhook";
+var NOTIFY_KINDS_FIELD = "notifyKinds";
+var NOTIFY_TEST_API_PATH = "/composer-ux/notify/test";
 var KEYS_ENABLED_FIELD = "keysEnabled";
 var MENU_ENABLED_FIELD = "menuEnabled";
 var QUICK_ENABLED_FIELD = "quickEnabled";
@@ -1278,6 +1284,12 @@ var DEFAULT_HEADER_NAME = "x-opencode-session";
 var HEADER_VALUE_MAX = 200;
 var HEADER_NAME_MAX = 64;
 var DEFAULT_SETTINGS = {
+  // 微信通知：默认全关全空（0.17.0）。
+  notifyEnabled: false,
+  notifyChannel: "pushplus",
+  notifyPushplusToken: "",
+  notifyWecomWebhook: "",
+  notifyKinds: { "needs-input": true, done: true, error: true },
   // 总开关默认开：它只是总闸，真正"要不要用这一栏"由下面五个开关决定（默认关）。
   enabled: true,
   // 五栏默认关（老文档由 sectionEnabledOf 迁移成"碰过就开"）。
@@ -1489,7 +1501,26 @@ function sanitizeSettings(value) {
     return out;
   };
   const asTier = () => normalizeOptimizerTier(source[OPTIMIZER_TIER_FIELD]);
+  const asNotifyChannel = () => {
+    const raw = source[NOTIFY_CHANNEL_FIELD];
+    return raw === "wecom" ? "wecom" : "pushplus";
+  };
+  const asNotifyKinds = () => {
+    const raw = source[NOTIFY_KINDS_FIELD];
+    const row2 = typeof raw === "object" && raw !== null ? raw : {};
+    return {
+      "needs-input": row2["needs-input"] !== false,
+      done: row2.done !== false,
+      error: row2.error !== false
+    };
+  };
   return {
+    // 微信通知（0.17.0，单向）：默认全关/全空。
+    notifyEnabled: asBool(NOTIFY_ENABLED_FIELD),
+    notifyChannel: asNotifyChannel(),
+    notifyPushplusToken: asString(NOTIFY_PUSHPLUS_FIELD),
+    notifyWecomWebhook: asString(NOTIFY_WECOM_FIELD),
+    notifyKinds: asNotifyKinds(),
     enabled: asBool(ENABLED_FIELD),
     // 五栏开关：显式写过听它的，否则按"用户碰过没"迁移（见 sectionEnabledOf）。
     keysEnabled: sectionEnabledOf(KEYS_ENABLED_FIELD, source),
@@ -5833,6 +5864,143 @@ function useRestart() {
   };
   return { stage, detail: detail2, blocked, ask, confirm, cancel };
 }
+function maskSecret(value) {
+  if (value === "") return "";
+  return value.length < 8 ? "****" : `${value.slice(0, 4)}\u2026${value.slice(-2)}`;
+}
+function NotifyCard({ settings, setField }) {
+  const on = settings.notifyEnabled;
+  const channel = settings.notifyChannel;
+  const kinds = settings.notifyKinds;
+  const [busy, setBusy] = (0, import_react7.useState)(false);
+  const [note2, setNote] = (0, import_react7.useState)("");
+  const send = () => {
+    setBusy(true);
+    setNote("");
+    void fetch(NOTIFY_TEST_API_PATH, {
+      method: "POST",
+      headers: { "content-type": "application/json", [RESTART_CSRF_HEADER]: RESTART_CSRF_VALUE },
+      body: "{}"
+    }).then(async (r) => await r.json()).then((v) => {
+      setNote(v.ok === true ? "\u5DF2\u53D1\u51FA \u2014\u2014 \u53BB\u5FAE\u4FE1\u770B\u4E00\u773C\uFF08\u8FD9\u91CC\u4E0D\u5199\u201C\u5DF2\u9A8C\u8BC1\u201D\uFF0C\u53EA\u6709\u4F60\u80FD\u786E\u8BA4\uFF09" : `\u6CA1\u53D1\u51FA\u53BB\uFF1A${v.reason ?? "\u672A\u77E5\u539F\u56E0"}`);
+    }).catch((e) => {
+      setNote(`\u8BF7\u6C42\u5931\u8D25\uFF1A${e instanceof Error ? e.message : String(e)}`);
+    }).finally(() => {
+      setBusy(false);
+    });
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(
+    FoldCard,
+    {
+      name: "\u5FAE\u4FE1\u901A\u77E5",
+      summary: on ? `\u5DF2\u5F00 \xB7 ${channel === "pushplus" ? "PushPlus" : "\u4F01\u4E1A\u5FAE\u4FE1\u673A\u5668\u4EBA"} \xB7 \u53EA\u80FD\u901A\u77E5\uFF0C\u4E0D\u80FD\u56DE` : "\u672A\u542F\u7528 \xB7 \u53EA\u80FD\u901A\u77E5\uFF0C\u4E0D\u80FD\u56DE",
+      toggle: { checked: on, onChange: (next) => {
+        setField(NOTIFY_ENABLED_FIELD, next);
+      } },
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { style: { margin: "10px 0", fontSize: 12, lineHeight: 1.6, opacity: 0.85 }, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("strong", { children: "\u53EA\u80FD\u901A\u77E5\uFF0C\u4E0D\u80FD\u56DE\u3002" }),
+          "\u9700\u8981\u4F60\u56DE\u5E94 / \u5B8C\u6210 / \u51FA\u9519\u65F6\u63A8\u4E00\u6761\u5230\u4F60\u624B\u673A\uFF1B\u8981\u5904\u7406\u4ECD\u56DE DSH \u754C\u9762\u70B9\u3002",
+          /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("br", {}),
+          /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("span", { style: { opacity: 0.75 }, children: '\u5982\u679C\u4F60\u540C\u65F6\u88C5\u4E86 dsh-notify-plugin\uFF08\u4E2A\u4EBA\u5FAE\u4FE1\u76F4\u8FDE\u90A3\u6761\uFF09\uFF0C**\u540C\u4E00\u7C7B\u4E8B\u4EF6\u53EA\u5F00\u4E00\u8FB9** \u2014\u2014 \u4E24\u8FB9\u90FD\u5F00\u5C31\u4F1A\u6536\u5230\u4E24\u6761\u3002\u8FD9\u4E00\u6761\u662F\u7ED9"\u4E0D\u60F3\u518D\u88C5\u4E00\u4E2A\u63D2\u4EF6"\u7684\u4EBA\u7559\u7684\u9000\u8DEF\u3002' })
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+          ToggleRow,
+          {
+            label: "\u7528 PushPlus\uFF08\u5230\u4F60\u5173\u6CE8\u7684\u516C\u4F17\u53F7\uFF09",
+            desc: "pushplus.plus \u7528\u5FAE\u4FE1\u767B\u5F55\u62FF token\uFF0C\u586B\u5728\u4E0B\u9762\u3002",
+            checked: channel === "pushplus",
+            onChange: () => {
+              setField(NOTIFY_CHANNEL_FIELD, "pushplus");
+            },
+            first: true
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+          TextFieldRow,
+          {
+            title: "PushPlus token",
+            desc: settings.notifyPushplusToken === "" ? "\u8FD8\u6CA1\u586B\uFF08\u586B\u4E86\u624D\u80FD\u63A8\u9001\uFF09" : `\u5F53\u524D\uFF1A${maskSecret(settings.notifyPushplusToken)}\uFF08\u8981\u770B\u5168\u6587\u8BF7\u91CD\u65B0\u7C98\u8D34\uFF09`,
+            value: settings.notifyPushplusToken,
+            placeholder: "\u7C98\u8D34 token",
+            maxLength: 200,
+            onChange: (next) => {
+              setField(NOTIFY_PUSHPLUS_FIELD, next);
+            }
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+          ToggleRow,
+          {
+            label: "\u7528\u4F01\u4E1A\u5FAE\u4FE1\u7FA4\u673A\u5668\u4EBA",
+            desc: "\u53EA\u6709\u4F60\u7684\u4F01\u4E1A\u5FAE\u4FE1\u7FA4\u91CC\u52A0\u4E2A\u673A\u5668\u4EBA\uFF0C\u628A webhook \u586B\u4E0B\u9762\u3002",
+            checked: channel === "wecom",
+            onChange: () => {
+              setField(NOTIFY_CHANNEL_FIELD, "wecom");
+            }
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+          TextFieldRow,
+          {
+            title: "\u4F01\u4E1A\u5FAE\u4FE1 webhook",
+            desc: settings.notifyWecomWebhook === "" ? "\u8FD8\u6CA1\u586B" : `\u5F53\u524D\uFF1A${maskSecret(settings.notifyWecomWebhook)}`,
+            value: settings.notifyWecomWebhook,
+            placeholder: "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=\u2026",
+            maxLength: 500,
+            onChange: (next) => {
+              setField(NOTIFY_WECOM_FIELD, next);
+            }
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+          ToggleRow,
+          {
+            label: "\u9700\u8981\u4F60\u56DE\u5E94\u65F6\u901A\u77E5",
+            desc: "\u7B49\u5BA1\u6279\u3001\u7B49\u4F60\u56DE\u7B54\u95EE\u9898\u65F6\u63A8\u4E00\u6761\u3002",
+            checked: kinds["needs-input"],
+            onChange: (next) => {
+              setField(NOTIFY_KINDS_FIELD, { ...kinds, "needs-input": next });
+            }
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+          ToggleRow,
+          {
+            label: "\u4EFB\u52A1\u5B8C\u6210\u65F6\u901A\u77E5",
+            desc: "\u4E00\u8F6E\u8DD1\u5B8C\uFF08\u8FD0\u884C\u4E2D\u2192\u7A7A\u95F2\uFF09\u63A8\u4E00\u6761\u3002",
+            checked: kinds.done,
+            onChange: (next) => {
+              setField(NOTIFY_KINDS_FIELD, { ...kinds, done: next });
+            }
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+          ToggleRow,
+          {
+            label: "\u4EFB\u52A1\u51FA\u9519\u65F6\u901A\u77E5",
+            desc: "\u67D0\u6B65\u6216\u67D0\u8F6E\u62A5\u9519\u65F6\u63A8\u4E00\u6761\u3002",
+            checked: kinds.error,
+            onChange: (next) => {
+              setField(NOTIFY_KINDS_FIELD, { ...kinds, error: next });
+            }
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+          ToggleRow,
+          {
+            label: "\u6D4B\u8BD5\u63A8\u9001",
+            desc: note2 === "" ? "\u70B9\u53F3\u8FB9\u6309\u94AE\uFF0C\u7ACB\u523B\u53D1\u4E00\u6761\u5230\u4F60\u5FAE\u4FE1\u9A8C\u8BC1\u914D\u7F6E\u3002" : note2,
+            checked: false,
+            onChange: () => {
+            },
+            action: { label: busy ? "\u53D1\u9001\u4E2D\u2026" : "\u53D1\u9001\u6D4B\u8BD5", onClick: send }
+          }
+        )
+      ]
+    }
+  );
+}
 function RestartButton({ restart }) {
   const busy = restart.stage === "restarting" || restart.stage === "asking";
   const blocked = restart.blocked;
@@ -5883,7 +6051,7 @@ function RestartBanner({ restart }) {
     }, children: "\u77E5\u9053\u4E86" }) })
   ] });
 }
-function SettingsSection({ useLive, useBook, useBookStatus, useWriteNotice, actions }) {
+function SettingsSection({ useLive, useBook, useBookStatus, useWriteNotice, actions, setField }) {
   const settings = useLive((item) => item);
   const book = useBook((item) => item);
   const bookStatus = useBookStatus((item) => item);
@@ -5961,6 +6129,7 @@ function SettingsSection({ useLive, useBook, useBookStatus, useWriteNotice, acti
           )
         ] })
       ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(NotifyCard, { settings, setField }),
       /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(RestartBanner, { restart }),
       writeNotice !== "" && /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { className: "dsh-ux-restartBanner dsh-ux-restartBannerFailed", role: "status", children: [
         /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("span", { className: "dsh-ux-restartBannerText", children: [