dsh-config-manager 0.1.78 → 0.1.80

package/lib/sync/autosync-config.d.ts

@@ -7,6 +7,30 @@ export type AutosyncInterval = '5m' | '15m' | '30m' | '60m' | '6h' | '12h' | '24
 export declare const DEFAULT_AUTOSYNC_INTERVAL: AutosyncInterval;
 /** 缺省启动触发最小间隔阈值（5 分钟，防频繁重启反复同步） */
 export declare const DEFAULT_STARTUP_MIN_INTERVAL_MS: number;
+/** 缺省开启「本地改动即时触发」（真·自动同步；关闭后退回纯定时器） */
+export declare const DEFAULT_AUTOSYNC_REALTIME = true;
+/** 缺省远端轮询间隔（realtime 开启时与本地监听并行：本地改动即时上行，远端改动最迟 1 分钟内下行） */
+export declare const DEFAULT_AUTOSYNC_REMOTE_CHECK_MS: number;
+/** 远端轮询间隔下限（15 s）：再短只是空转 fetch，收益为零 */
+export declare const MIN_AUTOSYNC_REMOTE_CHECK_MS: number;
+/** 远端轮询间隔上限（60 min）：比这更慢就不该叫「实时」了 */
+export declare const MAX_AUTOSYNC_REMOTE_CHECK_MS: number;
+/** 自动应用的最高风险等级（low = 只有低风险分区自动落盘；medium = 中风险 plugins/mcp 也自动落盘） */
+export type AutosyncAutoApplyTier = 'low' | 'medium';
+/** 缺省自动应用等级：medium（用户拍板：plugins/mcp 的中风险改动也要真自动，否则「同步所有改动」是假的） */
+export declare const DEFAULT_AUTOSYNC_AUTO_APPLY_TIER: AutosyncAutoApplyTier;
+/**
+ * 双侧都改（真冲突）时的自动裁决策略：
+ *  - 'ask'   ：保留冲突待人工裁决（改造前的唯一行为）；
+ *  - 'local' ：缺省 —— **保留本机并推上去**（VS Code 风格）：本机版本成为新的远端最新，
+ *              被覆盖的远端版本仍留在远端历史快照里，随时可回滚。
+ *
+ * 刻意**不提供** 'remote'：采用远端需要走 applyMergeResolutions，那条路径会整体应用所有
+ * 可决断分区、绕过 risk.ts 的风险分级（audit-sync sync-F5），与「分区逐档放行」冲突。
+ */
+export type AutosyncConflictPolicy = 'ask' | 'local';
+/** 缺省冲突策略：local（保留本机并推上去） */
+export declare const DEFAULT_AUTOSYNC_CONFLICT_POLICY: AutosyncConflictPolicy;
 /** 最近一次自动同步执行状态 */
 export type AutosyncRunStatus = 'success' | 'skipped' | 'failed' | 'partial';
 /** 自动同步配置（持久化面；单通道） */
@@ -17,6 +41,21 @@ export interface AutosyncConfig {
     interval: AutosyncInterval;
     /** 重启触发的「自动下载合并」最小间隔阈值（ms） */
     startupMinIntervalMs: number;
+    /**
+     * 真·自动同步：本地文件改动后即时触发一次（缺省 true）。
+     *
+     * false = 退回改造前的纯定时器语义（等 interval 到点）；保留这个开关是因为
+     * 「监听整棵配置目录」在某些环境（网络盘、超大 skills 树）可能带来额外 I/O。
+     *
+     * 可选：**读取层（parseV1Channel）恒补缺省值**，旧文件/旧夹具不需要带这个字段。
+     */
+    realtime?: boolean;
+    /** realtime 开启时的远端轮询间隔（ms；下限 15 s、上限 60 min，缺省 60 s） */
+    remoteCheckMs?: number;
+    /** 自动应用的最高风险等级（缺省 medium） */
+    autoApplyTier?: AutosyncAutoApplyTier;
+    /** 双侧都改时的自动裁决策略（缺省 local：保留本机并推上去） */
+    conflictPolicy?: AutosyncConflictPolicy;
     /** 连续失败计数（用于通知判定） */
     consecutiveFailures: number;
     /** 最近一次自动同步执行时间（ISO-8601 UTC）；''/undefined = 从未执行 */
@@ -42,9 +81,43 @@ export interface AutosyncConfig {
 export type AutosyncConfigByChannel = Record<SyncTransportType, AutosyncConfig>;
 /** 缺省配置（首次无文件 / 损坏 / 不支持 schema 时回退） */
 export declare function defaultAutosyncConfig(): AutosyncConfig;
+/** 远端轮询间隔夹取（非数字 / 越界一律回落到边界值，绝不写入 NaN）。 */
+export declare function clampRemoteCheckMs(value: number): number;
 /** 读取全部通道的自动同步配置（v2 文件；v1 迁移为 git；webdav 缺省）。 */
 export declare function readAllAutosyncConfigs(dir: string): Promise<AutosyncConfigByChannel>;
 /** 读取指定通道的自动同步配置；文件不存在 / 损坏 / 不支持 schema → 缺省值（不抛错）。 */
 export declare function readAutosyncConfig(dir: string, channel: SyncTransportType): Promise<AutosyncConfig>;
 /** 写入指定通道的自动同步配置（原子写：临时文件 + rename；保留另一通道；自动创建目录）。 */
 export declare function writeAutosyncConfig(dir: string, channel: SyncTransportType, cfg: AutosyncConfig): Promise<void>;
+/**
+ * 可展示的「本轮失败原因」（issue #105）。
+ *
+ * 判据只有一条：**本轮状态真的是 failed**，才允许把 lastRunMessage 当成错误文案回传。
+ * 此前状态路由无条件回传 lastRunMessage，而 POST /sync/autosync 又会把读到的旧配置原样
+ * 写回 —— 于是「十天前那次失败的错误原文」会被一次纯粹改间隔的保存坐实，卡片上继续挂着
+ * 早已不成立的错误，用户据此去查一个不存在的故障（真机现场：认证已修好，界面仍报认证失败）。
+ *
+ * 返回 undefined = 界面不得渲染任何 lastRunMessage 单元格。
+ */
+export declare function lastRunFailureMessage(cfg: Pick<AutosyncConfig, 'lastRunStatus' | 'lastRunMessage'>): string | undefined;
+/**
+ * 清空「上一轮运行结果」三字段（issue #105：配置变更 ≠ 一轮运行结果）。
+ *
+ * POST /sync/autosync 是**配置**写入而不是运行，写完必须把上一轮的结论清掉，否则旧结论
+ * 会被当成当前结论继续展示。保留 lastRunAt/lastRunStatus 与连续失败计数：它们描述的是
+ * 「上一次真的跑过什么」，不会因为改了间隔就变成假话。
+ */
+export declare function clearLastRunResult(cfg: AutosyncConfig): AutosyncConfig;
+/**
+ * 勾选「自动同步」后是否该立刻跑一轮（issue #105 建议 4）。
+ *
+ * 三种情况返回 false：
+ *  - 本来就已经开着：这次 POST 只是改间隔 / 调阈值，不是「打开」动作；
+ *  - 打开后仍在 startupMinIntervalMs 冷却窗口内：刚跑过，别连点把通道打爆；
+ *  - 这次是把开关关掉：关掉当然不跑。
+ * `lastRunAt` 缺失或读不出（NaN）→ 当作「很久没跑过」，该跑。
+ *
+ * 判据与 `autosync-scheduler.ts` 的 `shouldTriggerStartupRun` 一致；这里不能直接 import 它
+ * —— 调度器依赖本模块，反向引用会成环。
+ */
+export declare function shouldRunOnEnable(prev: Pick<AutosyncConfig, 'enabled'>, next: Pick<AutosyncConfig, 'enabled' | 'lastRunAt' | 'startupMinIntervalMs'>, nowMs?: number): boolean;

package/lib/sync/autosync-config.js

@@ -25,6 +25,18 @@ export const AUTOSYNC_CONFIG_SCHEMA_VERSION = 2;
 export const DEFAULT_AUTOSYNC_INTERVAL = '30m';
 /** 缺省启动触发最小间隔阈值（5 分钟，防频繁重启反复同步） */
 export const DEFAULT_STARTUP_MIN_INTERVAL_MS = 5 * 60 * 1000;
+/** 缺省开启「本地改动即时触发」（真·自动同步；关闭后退回纯定时器） */
+export const DEFAULT_AUTOSYNC_REALTIME = true;
+/** 缺省远端轮询间隔（realtime 开启时与本地监听并行：本地改动即时上行，远端改动最迟 1 分钟内下行） */
+export const DEFAULT_AUTOSYNC_REMOTE_CHECK_MS = 60 * 1000;
+/** 远端轮询间隔下限（15 s）：再短只是空转 fetch，收益为零 */
+export const MIN_AUTOSYNC_REMOTE_CHECK_MS = 15 * 1000;
+/** 远端轮询间隔上限（60 min）：比这更慢就不该叫「实时」了 */
+export const MAX_AUTOSYNC_REMOTE_CHECK_MS = 60 * 60 * 1000;
+/** 缺省自动应用等级：medium（用户拍板：plugins/mcp 的中风险改动也要真自动，否则「同步所有改动」是假的） */
+export const DEFAULT_AUTOSYNC_AUTO_APPLY_TIER = 'medium';
+/** 缺省冲突策略：local（保留本机并推上去） */
+export const DEFAULT_AUTOSYNC_CONFLICT_POLICY = 'local';
 /** 缺省配置（首次无文件 / 损坏 / 不支持 schema 时回退） */
 export function defaultAutosyncConfig() {
     return {
@@ -32,8 +44,18 @@ export function defaultAutosyncConfig() {
         interval: DEFAULT_AUTOSYNC_INTERVAL,
         startupMinIntervalMs: DEFAULT_STARTUP_MIN_INTERVAL_MS,
         consecutiveFailures: 0,
+        realtime: DEFAULT_AUTOSYNC_REALTIME,
+        remoteCheckMs: DEFAULT_AUTOSYNC_REMOTE_CHECK_MS,
+        autoApplyTier: DEFAULT_AUTOSYNC_AUTO_APPLY_TIER,
+        conflictPolicy: DEFAULT_AUTOSYNC_CONFLICT_POLICY,
     };
 }
+/** 远端轮询间隔夹取（非数字 / 越界一律回落到边界值，绝不写入 NaN）。 */
+export function clampRemoteCheckMs(value) {
+    if (!Number.isFinite(value))
+        return DEFAULT_AUTOSYNC_REMOTE_CHECK_MS;
+    return Math.min(MAX_AUTOSYNC_REMOTE_CHECK_MS, Math.max(MIN_AUTOSYNC_REMOTE_CHECK_MS, Math.round(value)));
+}
 /** 从 v1 顶层字段（缺 schemaVersion 或 schemaVersion=1）解析单通道配置；非法字段回退缺省。 */
 function parseV1Channel(obj) {
     const cfg = defaultAutosyncConfig();
@@ -47,6 +69,16 @@ function parseV1Channel(obj) {
     if (typeof obj['consecutiveFailures'] === 'number' && Number.isFinite(obj['consecutiveFailures']) && obj['consecutiveFailures'] >= 0) {
         cfg.consecutiveFailures = obj['consecutiveFailures'];
     }
+    // 真·自动同步的三个新字段：缺失（旧文件）→ 缺省值，等于升级后立刻自动生效（用户已拍板）
+    if (typeof obj['realtime'] === 'boolean')
+        cfg.realtime = obj['realtime'];
+    if (typeof obj['remoteCheckMs'] === 'number')
+        cfg.remoteCheckMs = clampRemoteCheckMs(obj['remoteCheckMs']);
+    if (obj['autoApplyTier'] === 'low' || obj['autoApplyTier'] === 'medium')
+        cfg.autoApplyTier = obj['autoApplyTier'];
+    if (obj['conflictPolicy'] === 'ask' || obj['conflictPolicy'] === 'local') {
+        cfg.conflictPolicy = obj['conflictPolicy'];
+    }
     if (typeof obj['lastRunAt'] === 'string' && obj['lastRunAt'] !== '')
         cfg.lastRunAt = obj['lastRunAt'];
     if (typeof obj['lastRunStatus'] === 'string' && (obj['lastRunStatus'] === 'success' || obj['lastRunStatus'] === 'skipped' || obj['lastRunStatus'] === 'failed' || obj['lastRunStatus'] === 'partial')) {
@@ -125,6 +157,59 @@ export async function writeAutosyncConfig(dir, channel, cfg) {
     const data = stringifyJsonSafe(payload, { space: 2 });
     await atomicWriteFile(target, data, { mode: 0o600 });
 }
+/**
+ * 可展示的「本轮失败原因」（issue #105）。
+ *
+ * 判据只有一条：**本轮状态真的是 failed**，才允许把 lastRunMessage 当成错误文案回传。
+ * 此前状态路由无条件回传 lastRunMessage，而 POST /sync/autosync 又会把读到的旧配置原样
+ * 写回 —— 于是「十天前那次失败的错误原文」会被一次纯粹改间隔的保存坐实，卡片上继续挂着
+ * 早已不成立的错误，用户据此去查一个不存在的故障（真机现场：认证已修好，界面仍报认证失败）。
+ *
+ * 返回 undefined = 界面不得渲染任何 lastRunMessage 单元格。
+ */
+export function lastRunFailureMessage(cfg) {
+    if (cfg.lastRunStatus !== 'failed')
+        return undefined;
+    const message = cfg.lastRunMessage;
+    return message === undefined || message === '' ? undefined : message;
+}
+/**
+ * 清空「上一轮运行结果」三字段（issue #105：配置变更 ≠ 一轮运行结果）。
+ *
+ * POST /sync/autosync 是**配置**写入而不是运行，写完必须把上一轮的结论清掉，否则旧结论
+ * 会被当成当前结论继续展示。保留 lastRunAt/lastRunStatus 与连续失败计数：它们描述的是
+ * 「上一次真的跑过什么」，不会因为改了间隔就变成假话。
+ */
+export function clearLastRunResult(cfg) {
+    const next = { ...cfg };
+    delete next.lastRunMessage;
+    delete next.lastRunSkipReason;
+    delete next.lastRunSkipCount;
+    return next;
+}
+/**
+ * 勾选「自动同步」后是否该立刻跑一轮（issue #105 建议 4）。
+ *
+ * 三种情况返回 false：
+ *  - 本来就已经开着：这次 POST 只是改间隔 / 调阈值，不是「打开」动作；
+ *  - 打开后仍在 startupMinIntervalMs 冷却窗口内：刚跑过，别连点把通道打爆；
+ *  - 这次是把开关关掉：关掉当然不跑。
+ * `lastRunAt` 缺失或读不出（NaN）→ 当作「很久没跑过」，该跑。
+ *
+ * 判据与 `autosync-scheduler.ts` 的 `shouldTriggerStartupRun` 一致；这里不能直接 import 它
+ * —— 调度器依赖本模块，反向引用会成环。
+ */
+export function shouldRunOnEnable(prev, next, nowMs = Date.now()) {
+    if (!next.enabled || prev.enabled)
+        return false;
+    const lastRunAt = next.lastRunAt;
+    if (lastRunAt === undefined || lastRunAt === '')
+        return true;
+    const lastMs = Date.parse(lastRunAt);
+    if (Number.isNaN(lastMs))
+        return true;
+    return nowMs - lastMs >= next.startupMinIntervalMs;
+}
 /** AutosyncConfig → 文件载荷（可选运行字段仅在非空时写入，保持文件干净）。 */
 function toChannelPayload(cfg) {
     const payload = {
@@ -132,6 +217,10 @@ function toChannelPayload(cfg) {
         interval: cfg.interval,
         startupMinIntervalMs: cfg.startupMinIntervalMs,
         consecutiveFailures: cfg.consecutiveFailures,
+        realtime: cfg.realtime ?? DEFAULT_AUTOSYNC_REALTIME,
+        remoteCheckMs: clampRemoteCheckMs(cfg.remoteCheckMs ?? DEFAULT_AUTOSYNC_REMOTE_CHECK_MS),
+        autoApplyTier: cfg.autoApplyTier ?? DEFAULT_AUTOSYNC_AUTO_APPLY_TIER,
+        conflictPolicy: cfg.conflictPolicy ?? DEFAULT_AUTOSYNC_CONFLICT_POLICY,
     };
     if (cfg.lastRunAt !== undefined && cfg.lastRunAt !== '')
         payload['lastRunAt'] = cfg.lastRunAt;

package/lib/sync/autosync-scheduler.d.ts

@@ -4,6 +4,7 @@ import type { SectionId } from '../schema/types.ts';
 import type { RunRegistry } from '../core/run-registry.ts';
 import type { JournalRunContext } from '../core/phase3-host.ts';
 import type { SyncEngine } from './sync-engine.ts';
+import type { SyncSnapshotMeta } from './transport.ts';
 import type { MutationLockPort, MutationLockContext } from '../utils/env-lock.ts';
 import type { AutosyncConfig, AutosyncInterval } from './autosync-config.ts';
 import type { SyncConfig, SyncTransportType } from './sync-config.ts';
@@ -11,6 +12,7 @@ import { readSyncHistory } from './sync-history.ts';
 import type { AutosyncHistoryEntry } from './sync-history.ts';
 import type { MergePlan } from './merge.ts';
 import type { SyncApplyPlan } from './risk.ts';
+import { SyncWatcher } from './sync-watcher.ts';
 /** 间隔 → ms 换算（§4.3） */
 export declare function intervalToMs(interval: AutosyncInterval): number;
 /**
@@ -31,6 +33,24 @@ export interface AutosyncRunResult {
     historyId: string;
     consecutiveFailures: number;
 }
+/**
+ * runOnce 的触发语义（只影响「做什么」的两个分支，不改变同步流程本身）。
+ * reason 只进日志，用来说明这一轮是被谁叫醒的（排障时能区分「定时兜底」与「真有事发生」）。
+ */
+export interface AutosyncRunOptions {
+    /** true = 启动触发变体：只做下行合并，不上传。 */
+    startup?: boolean;
+    /** 触发来源：interval / remote-poll / local-change / manual / startup / enable-toggle。 */
+    reason?: string;
+}
+/** watcher 工厂入参（缺省实现 = 真实 SyncWatcher；测试注入内存实现）。 */
+export interface WatcherFactoryOptions {
+    homeDir: string;
+    profile: string | undefined;
+    log: Logger;
+    /** 一批本地改动落地（已去抖）→ 交给调度器触发一轮同步。 */
+    onFlush: (changed: readonly string[]) => void;
+}
 export interface AutoSyncSchedulerOptions {
     syncDir: string;
     host: {
@@ -57,8 +77,9 @@ export interface AutoSyncSchedulerOptions {
     /**
      * 远端新快照检测（§3.2「下载=检测到远端新快照才拉取」）。
      * 缺省：若 engine 实现了 hasNewRemoteSnapshot() 则调用；否则视为 true（保持旧行为=每次拉取）。
+     * `listed` = 本轮已取到的远端列表（查加密快照时顺手拿到）—— 传下去就不必再 list 一次。
      */
-    detectRemoteNew?: (engine: SyncEngine) => Promise<boolean>;
+    detectRemoteNew?: (engine: SyncEngine, listed?: readonly SyncSnapshotMeta[]) => Promise<boolean>;
     /**
      * 本地配置变化检测（§3.1「上传=本地改动才推」）。
      * 缺省：若 engine 实现了 hasLocalChanges() 则调用；否则视为 true（保持旧行为=每次都推）。
@@ -89,6 +110,17 @@ export interface AutoSyncSchedulerOptions {
             result: unknown;
         }>;
     };
+    /**
+     * 家目录（= DSH 的 $DSH_HOME）。提供时才启用「本地改动即时上行」的文件监听；
+     * 缺省（测试/未接线）→ 只靠定时器与远端轮询，行为退化为改造前。
+     */
+    homeDir?: string;
+    /** 当前 profile（决定监听 profiles/<profile>/ 下的组合 patch 与插件清单）。 */
+    profile?: string;
+    /** 注入 watcher 工厂（缺省 = 真实 SyncWatcher；测试可传内存实现）。 */
+    makeWatcher?: (opts: WatcherFactoryOptions) => SyncWatcher;
+    /** 触发合并窗口（ms）：连续保存/连续远端探测只跑一轮。缺省 3000。 */
+    minTriggerGapMs?: number;
 }
 export declare class AutoSyncScheduler {
     private readonly syncDir;
@@ -112,6 +144,22 @@ export declare class AutoSyncScheduler {
     private lockCtxForJournal;
     /** 每通道一个定时器（git/webdav 各自 enabled 时独立排期）。 */
     private readonly timers;
+    /** realtime 通道的远端轮询定时器：与 interval 定时器**分开**，否则每次轮询都会重置兜底间隔。 */
+    private readonly remoteTimers;
+    /** 本地改动监听（只有 enabled && realtime 的通道才挂；全关 → null）。 */
+    private watcher;
+    /** 当前需要监听的通道（setupWatchers 计算）。 */
+    private realtimeChannels;
+    /** 运行期到达的触发：本轮收尾后立刻补跑（绝不并发写本地配置，也绝不丢）。 */
+    private pendingTrigger;
+    /** 上次开始运行的时刻（trigger 的最小间隔合并用）。 */
+    private readonly lastRunAtMs;
+    /** 因最小间隔被推迟的触发（每通道至多一个）。 */
+    private readonly gapTimers;
+    private readonly homeDir;
+    private readonly profile;
+    private readonly makeWatcher;
+    private readonly minTriggerGapMs;
     private stopped;
     private running;
     constructor(opts: AutoSyncSchedulerOptions);
@@ -119,11 +167,30 @@ export declare class AutoSyncScheduler {
     private appendHistory;
     /** 启动：读两个通道配置 → enabled 通道各自排定时器 → 对每个 enabled 通道执行一次启动触发。 */
     start(): void;
-    /** 停止：清全部定时器、标记不再调度；正在执行的任务允许自然结束。 */
+    /** 停止：清全部定时器、拆掉文件监听、标记不再调度；正在执行的任务允许自然结束。 */
     stop(): void;
     /** 重新加载配置（路由 POST /sync/autosync 后调用；重排所有通道定时器）。 */
     reload(): Promise<void>;
     private refreshTimers;
+    /**
+     * 外部触发一次运行（本地改动 / 远端探测 / 另一通道让位）。
+     *
+     * - 正在跑 → 记 pendingTrigger，本轮收尾后**立刻补跑**（不并发写本地配置，也绝不丢）；
+     * - 距上次开始不足 minTriggerGapMs → 合并成一次（连续保存只跑一轮，每通道至多一个定时器）。
+     */
+    trigger(channel: SyncTransportType, reason?: string): void;
+    /** 兜底间隔定时器：每个 enabled 通道按各自 interval 排一次性定时器，触发后只重排自己。 */
+    private scheduleIntervalTimers;
+    /**
+     * realtime 通道的远端轮询：按 remoteCheckMs（缺省 60s）排一次性定时器。
+     * 轮询只是「叫醒一轮 runOnce」—— 是否真的下载仍由 detectRemoteNew 判定，
+     * 所以哪怕每 60s 叫醒一次，无变化时也只会记一条 upToDate 而不会反复传输。
+     */
+    private scheduleRemoteTimers;
+    /** 按「enabled && realtime」重算监听集合：需要就挂、全关就拆（绝不留下空转句柄）。 */
+    private setupWatchers;
+    /** watcher 回调：任一批改动 → 让所有 realtime 通道各跑一轮（各自有变化检测，不会空转传输）。 */
+    private onLocalChange;
     /** 启动触发下载合并（每个 enabled 通道；受各自 startupMinIntervalMs 阈值约束）。 */
     private startupRuns;
     /**
@@ -131,9 +198,8 @@ export declare class AutoSyncScheduler {
      * @param channel - 同步通道（git / webdav；各自独立的配置与运行状态）
      * @param opts.startup - true 表示启动触发变体（只做 Phase A+B，不做 Phase C push）
      */
-    runOnce(channel: SyncTransportType, opts?: {
-        startup?: boolean;
-    }): Promise<AutosyncRunResult>;
+    runOnce(channel: SyncTransportType, opts?: AutosyncRunOptions): Promise<AutosyncRunResult>;
+    private runOnceInternal;
     /**
      * 收尾：写该通道 autosync-config（lastRunAt / lastRunStatus / consecutiveFailures /
      * lastRunHistoryId / 本轮消息与跳过原因）。
@@ -146,7 +212,15 @@ export declare class AutoSyncScheduler {
      * 成功清空两者（空串/undefined 不进文件，见 autosync-config.toChannelPayload）。
      */
     private writeFinalConfig;
-    /** 连续失败 ≥ 3 → 通知（host.log.warn）。 */
+    /**
+     * 连续失败 ≥ 3 → 通知（host.log.warn）。
+     *
+     * issue #105：通知的持久痕迹只留历史 entry 的 notifiedAt。
+     * 此前这里把通知文案写进 autosync-config.lastRunMessage —— 那是「本轮错误原文」的字段，
+     * 一个字段两种语义，界面就无法判断该显示什么；而且 entry.notifiedAt 只在内存对象上改、
+     * 从未落盘（sync-history 当时只有 append），通知事实其实没留下。现在两者都走一处：
+     * 通知文案只进日志，notifiedAt 落盘到历史记录。
+     */
     private maybeNotify;
 }
 /**