dsh-harmonyos-hiboard 0.7.1 → 0.7.2

package/README.md

@@ -223,6 +223,11 @@ L2 抢救"承诺了却没调用"、L3 按错误类别重试并自动补 `schedul
    - `retry-ok`：工具真的调用了但失败，按错误类别重试后成功
    - `rescue-ok`：根本没调用工具（写成纯文本 / 只承诺没做），兜底代为补推
 
+   **关掉兜底后面板不会消失**，而是改显示「**漏掉未推送 N 次**」——
+   兜底关闭期间它不再补推，但**继续记账**（记成 `missed`）：本该补推的（写成纯文本 /
+   只承诺没调用）以及调用失败却没重试的，都会被记下来。
+   关掉它的代价应该看得见，而不是等你发现卡片少了几张。
+
    这个面板的意义是：以前"保险丝到底有没有干活"只能靠猜，现在直接列给你看。
 
 配置写在 `<用户目录>/.dsh/hiboard-push/config.json`（0600，先写临时文件再原子替换）。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-harmonyos-hiboard",
-  "version": "0.7.1",
-  "description": "把DSH的任务结果，以服务卡片形式推送到华为鸿蒙负一屏\nPush DSH task results to the Huawei HarmonyOS assistant-today screen as service cards.",
+  "version": "0.7.2",
+  "description": "把DSH的任务结果，以服务卡片形式推送到华为鸿蒙负一屏 ｜ Push DSH task results to the Huawei HarmonyOS assistant-today screen as service cards.",
   "author": "Jim Chen",
   "license": "MIT",
   "repository": {

package/src/lib/client.js

@@ -101,8 +101,13 @@ window.__ModuleLoader__.load({
         },
         debugEmpty: '还没有需要兜底的记录 —— 每次推送都成功调用了工具。',
         debugNone: '兜底还没有运行记录。',
+        debugMissedSummary: function (c) {
+          return '兜底已关闭 —— 期间漏掉未推送 ' + c.missed + ' 次';
+        },
+        debugMissedEmpty: '兜底关闭期间还没有漏推记录。',
         kindRetry: '重试',
         kindRescue: '补推',
+        kindMissed: '漏推',
         loadFailed: '读取配置失败',
         saveFailed: '保存失败',
         unavailable: '设置路由不可用（宿主未提供）。'
@@ -139,8 +144,13 @@ window.__ModuleLoader__.load({
         },
         debugEmpty: 'Nothing needed rescuing yet — every push called the tool successfully.',
         debugNone: 'The safety net has no run records yet.',
+        debugMissedSummary: function (c) {
+          return 'Safety net is off — ' + c.missed + ' pushes have gone missing since';
+        },
+        debugMissedEmpty: 'Nothing has gone missing while the net was off.',
         kindRetry: 'retry',
         kindRescue: 'rescue',
+        kindMissed: 'missed',
         loadFailed: 'Could not load the configuration',
         saveFailed: 'Could not save',
         unavailable: 'The settings route is unavailable (host did not provide it).'
@@ -323,26 +333,48 @@ window.__ModuleLoader__.load({
           preview = h('div', { style: { marginTop: '6px', fontSize: '12px', color: V.danger } }, t.invalid);
         }
 
-        // ---- 兜底战绩：把「原本没推出去、但兜底救回来了」摆出来 ----
+        // ---- 战绩面板 ----
+        // 兜底**开着**：显示「救回了几次」。
+        // 兜底**关掉**：面板不消失，改显示「漏掉了几张」—— 关掉它的代价要看得见，
+        // 否则用户只会觉得"关了就关了"，直到发现卡片少了几张。
+        var guardOn = Boolean(guard && guard.enabled);
+        var itemRows = function (items, kindOf) {
+          return (items || []).map(function (item, index) {
+            return h(
+              'div',
+              { key: String(index), style: { fontSize: '12px', lineHeight: '1.7', color: V.sub } },
+              '· ' + shortTime(item.at) + '　[' + kindOf(item) + '] ' + (item.label || '-') + ' — ' + item.detail
+            );
+          });
+        };
+        var boldLine = function (text) {
+          return h('div', { style: { fontSize: '12px', fontWeight: 600, marginBottom: '4px' } }, text);
+        };
         var debugBody;
         if (!audit) {
           debugBody = muted(t.debugNone);
-        } else if (!audit.exists || audit.counts.retryOk + audit.counts.rescueOk === 0) {
-          debugBody = muted(t.debugEmpty);
+        } else if (guardOn) {
+          debugBody =
+            !audit.exists || audit.counts.retryOk + audit.counts.rescueOk === 0
+              ? muted(t.debugEmpty)
+              : h(
+                  'div',
+                  null,
+                  boldLine(t.debugSummary(audit.counts)),
+                  itemRows(audit.recent, function (item) {
+                    return item.kind === 'retry-ok' ? t.kindRetry : t.kindRescue;
+                  })
+                );
         } else {
-          debugBody = h(
-            'div',
-            null,
-            h('div', { style: { fontSize: '12px', fontWeight: 600, marginBottom: '4px' } }, t.debugSummary(audit.counts)),
-            (audit.recent || []).map(function (item, index) {
-              return h(
-                'div',
-                { key: String(index), style: { fontSize: '12px', lineHeight: '1.7', color: V.sub } },
-                '· ' + shortTime(item.at) + '　[' + (item.kind === 'retry-ok' ? t.kindRetry : t.kindRescue) + '] ' +
-                  (item.label || '-') + ' — ' + item.detail
-              );
-            })
-          );
+          debugBody =
+            !audit.exists || audit.counts.missed === 0
+              ? muted(t.debugMissedEmpty)
+              : h(
+                  'div',
+                  null,
+                  boldLine(t.debugMissedSummary(audit.counts)),
+                  itemRows(audit.missedRecent, function () { return t.kindMissed; })
+                );
         }
 
         return h(

package/src/lib/index.js

@@ -446,7 +446,7 @@ function buildConfigRoute({ authCodeInfo, settings, storeFile }) {
 	 */
 	const auditSummary = () => {
 		const file = join(GUARD_STATE_DIR, "audit.jsonl");
-		const empty = { file, exists: false, counts: { retryOk: 0, rescueOk: 0, failed: 0 }, recent: [] };
+		const empty = { file, exists: false, counts: { retryOk: 0, rescueOk: 0, failed: 0, missed: 0 }, recent: [], missedRecent: [] };
 		let text;
 		try {
 			text = readFileSync(file, "utf8");
@@ -455,8 +455,16 @@ function buildConfigRoute({ authCodeInfo, settings, storeFile }) {
 			return empty;
 		}
 		const lines = text.split("\n").filter(Boolean).slice(-AUDIT_MAX_LINES);
-		const counts = { retryOk: 0, rescueOk: 0, failed: 0 };
+		const counts = { retryOk: 0, rescueOk: 0, failed: 0, missed: 0 };
 		const recent = [];
+		const missedRecent = [];
+		/** missed 的原因码 → 面板上的说法。 */
+		const MISSED_REASON = {
+			"literal-text-unrescued": "模型把调用写成了纯文本（兜底已关闭，未补推）",
+			"broken-promise-unrescued": "模型承诺了推送却没调用工具（兜底已关闭，未补推）",
+			"failed-retryable-unretried": "调用失败，本可重试（兜底已关闭，未重试）",
+			"failed-permanent": "调用永久失败（兜底不会重试这类错误）"
+		};
 		for (const line of lines) {
 			let row;
 			try {
@@ -484,13 +492,24 @@ function buildConfigRoute({ authCodeInfo, settings, storeFile }) {
 					label: row.name ?? "",
 					detail: row.level === "L1" ? "模型把调用写成了纯文本" : "模型承诺了推送却没调用工具"
 				});
+			} else if (row?.kind === "missed") {
+				// 兜底关闭期间"本该补推 / 本该重试"的记录：这是关掉它的代价，要看得到
+				counts.missed += 1;
+				missedRecent.push({
+					kind: "missed",
+					at: row.at ?? "",
+					level: row.level ?? "",
+					label: row.name ?? "",
+					detail: MISSED_REASON[row.reason] ?? String(row.reason ?? "未推送")
+				});
 			} else if (row?.kind === "push-failed" || row?.kind === "rescue-failed" || row?.kind === "rescue-error") {
 				counts.failed += 1;
 			}
 		}
 		// 文件是追加写的，末尾最新；面板要「最近几次」，所以倒序后取前几条
 		recent.reverse();
-		return { file, exists: true, counts, recent: recent.slice(0, 5) };
+		missedRecent.reverse();
+		return { file, exists: true, counts, recent: recent.slice(0, 5), missedRecent: missedRecent.slice(0, 5) };
 	};
 
 	const summary = () => {

package/src/lib/push-guard.js

@@ -546,8 +546,9 @@ export function apply(ctx, config) {
 		ctx.effect(() => {
 			const onEvent = (session, event) => {
 				try {
-					// 设置页关掉后，兜底立即停止（不必重启）
-					if (guardOff()) return;
+					// 注意：**关掉兜底后这个处理器仍要继续跑**。它不再补推，但仍要记账
+					// （见下面的 missed）——「关掉期间漏掉多少张卡片」只有继续观察才数得出来，
+					// 否则设置页那一栏永远是空的。
 					if (!event || typeof event !== "object") return;
 					const sessionId = session?.id ?? "?";
 
@@ -584,6 +585,25 @@ export function apply(ctx, config) {
 						}
 						return;
 					}
+
+					// 兜底被关掉时：**不补推，但照样记账**。
+					// 记成 missed 而不是 rescue-ok —— 设置页据此显示「关掉期间漏掉 N 张」。
+					// 关掉兜底的代价应该是看得见的，而不是悄悄少几张卡片。
+					if (guardOff()) {
+						audit({
+							kind: "missed",
+							level: card.level,
+							name: card.name,
+							sessionId,
+							turn: current.turn,
+							reason: card.level === "L1" ? "literal-text-unrescued" : "broken-promise-unrescued"
+						});
+						ctx.logger?.warn?.(
+							"[push-guard] ⚠️ %s 本该补推（会话 %s 第 %s 轮）：%s —— 但兜底已关闭，仅记账未推送",
+							card.level, sessionId, current.turn ?? "?", card.name
+						);
+						return;
+					}
 					const fingerprint = `${card.name}\n${card.content.length}\n${card.content.slice(0, 80)}`;
 					if (lastRescued.get(sessionId) === fingerprint) return;
 					lastRescued.set(sessionId, fingerprint);
@@ -639,8 +659,31 @@ export function apply(ctx, config) {
 					const ambiguousAttempts = ambiguousBudget;
 					const fallbackScheduleId = String(settings.defaultScheduleId || DEFAULTS.defaultScheduleId).trim() || DEFAULTS.defaultScheduleId;
 					const wrapped = async (args, exec) => {
-						// 设置页关掉后：不补参、不重试，按原样调用（关闭必须真的关闭）
-						if (guardOff()) return original(args, exec);
+						// 设置页关掉后：不补参、不重试，按原样调用（关闭必须真的关闭）。
+						// 但**照样给失败记账**：调用失败了却没重试，就是"漏掉一张"。
+						if (guardOff()) {
+							const outcome = await original(args, exec);
+							try {
+								const verdict = classifyPush(outcome);
+								if (!verdict.ok) {
+									audit({
+										kind: "missed",
+										level: "L3",
+										name: String(args?.name ?? ""),
+										reason: verdict.retryable ? "failed-retryable-unretried" : "failed-permanent",
+										code: verdict.code ?? "",
+										message: String(verdict.message ?? "").slice(0, 160)
+									});
+									ctx.logger?.warn?.(
+										"[push-guard] ⚠️ hiboard_push 失败（%s，%s）—— 兜底已关闭，未重试，仅记账",
+										verdict.code || "-", verdict.retryable ? "本可重试" : "永久错误"
+									);
+								}
+							} catch {
+								/* 记账失败不影响工具本身的返回 */
+							}
+							return outcome;
+						}
 						// ---- 先补 schedule_id，再让工具校验/发送 ----
 						// 为什么必须补：scheduleTaskId 为空时负一屏**只显示一行标题**，
 						// 正文不渲染、详情页点不开（2026-09-27 用户实际遇到）。