dsh-config-manager 0.1.83 → 0.1.85

package/lib/adapters/file-collection.d.ts

@@ -116,11 +116,18 @@ export declare abstract class FileCollectionAdapter implements ConfigAdapter<Fil
     /** 单元清单（零 I/O：直接由 export 产物归并）。 */
     listUnits(section: ExportSection<FilesSection>): ExportUnit[];
     /**
-     * 幂等比对用的内容（相对 baseDir 路径 + 盘上/包内字节 → 参与哈希比对的字节）。
+     * **身份内容**（相对 baseDir 路径 + 盘上/包内字节 → 参与哈希与导出的字节）。
      *
      * 缺省 = **原字节**：对文件类分区来说「相对路径 + 内容哈希」就是身份语义，不得改动。
      * 覆写者只应用于剔除**不属于「配置身份」的易变字段**（见 SelfAdapter 的两个调度配置：
-     * 运行态每轮都被改写，整文件哈希会恒判 Conflict —— issue #73）。两条契约：
+     * 运行态每轮都被改写，整文件哈希会恒判 Conflict —— issue #73；同一批字段还会让
+     * 分区 hash 每轮都变 → 自动同步每轮真推一次 —— issue #127）。
+     *
+     * 用途有两处，且**必须共用同一份字节**，否则「判等」与「落地」分叉：
+     *   1. analyzeImport 的幂等判定（包内 vs 盘上）；
+     *   2. collect() 的导出载荷与 contentHash —— hashSection 按字节算分区 hash，
+     *      载荷里留着易变字段就等于每轮都判「本地有改动」。
+     * 两条契约：
      *   1. **必须收敛**：applyItem 写盘后再分析一次必须判 Skip，否则同步永不收敛；
      *   2. **未改写时返回同一引用** —— 调用方据此复用导入侧已算好的 contentHash，
      *      不给 sessions 这类大分区白算一遍哈希。

package/lib/adapters/file-collection.js

@@ -206,10 +206,22 @@ export class FileCollectionAdapter {
                 unitBytes += read.sizeBytes;
                 if (unitBytes > room)
                     break;
+                // 身份字节（issue #127）：`comparableContent` 定义的「参与哈希的身份内容」同时作为
+                // **导出载荷**写出。否则基线与包内字节的口径不一致 —— 子类剔掉的易变字段仍躺在载荷里，
+                // hashSection 照样每轮都变（真机现场：self 分区因 sync-autosync.json 的运行态每 ~60s
+                // 被判「本地有改动」，一天推 40+ 个内容几乎相同的快照）。
+                // 缺省实现返回同一引用 → 其余分区字节/哈希逐字节不变（`files.test.ts` 的 contentHash 断言照旧）。
+                const identity = mode === 'content' ? this.comparableContent(member.relPath, read.data) : read.data;
                 pending.push({
                     rel: member.rel,
                     sizeBytes: read.sizeBytes,
-                    entry: { relativePath: member.relPath, data: read.data, contentHash: read.contentHash },
+                    entry: {
+                        relativePath: member.relPath,
+                        data: identity,
+                        contentHash: mode === 'content'
+                            ? (identity === read.data ? read.contentHash : sha256Hex(identity))
+                            : read.contentHash,
+                    },
                 });
             }
             if (unitBytes > room) {
@@ -291,11 +303,18 @@ export class FileCollectionAdapter {
         return unitsFromFiles(this.id, section.data.files ?? [], (rel) => this.unitIdOf(rel));
     }
     /**
-     * 幂等比对用的内容（相对 baseDir 路径 + 盘上/包内字节 → 参与哈希比对的字节）。
+     * **身份内容**（相对 baseDir 路径 + 盘上/包内字节 → 参与哈希与导出的字节）。
      *
      * 缺省 = **原字节**：对文件类分区来说「相对路径 + 内容哈希」就是身份语义，不得改动。
      * 覆写者只应用于剔除**不属于「配置身份」的易变字段**（见 SelfAdapter 的两个调度配置：
-     * 运行态每轮都被改写，整文件哈希会恒判 Conflict —— issue #73）。两条契约：
+     * 运行态每轮都被改写，整文件哈希会恒判 Conflict —— issue #73；同一批字段还会让
+     * 分区 hash 每轮都变 → 自动同步每轮真推一次 —— issue #127）。
+     *
+     * 用途有两处，且**必须共用同一份字节**，否则「判等」与「落地」分叉：
+     *   1. analyzeImport 的幂等判定（包内 vs 盘上）；
+     *   2. collect() 的导出载荷与 contentHash —— hashSection 按字节算分区 hash，
+     *      载荷里留着易变字段就等于每轮都判「本地有改动」。
+     * 两条契约：
      *   1. **必须收敛**：applyItem 写盘后再分析一次必须判 Skip，否则同步永不收敛；
      *   2. **未改写时返回同一引用** —— 调用方据此复用导入侧已算好的 contentHash，
      *      不给 sessions 这类大分区白算一遍哈希。

package/lib/adapters/self.d.ts

@@ -20,9 +20,13 @@
  * 快照/回滚路径一致）；**清单来自覆写的 listRelPaths()（白名单），export() 与 preview() 都经
  * 基类 collect()**（self 目录内存在大量非配置子目录，不能像 skills/sessions 那样整体递归）。
  *
- * **例外：两个调度配置的比对口径见覆写的 comparableContent()** —— sync-autosync.json /
- * backup-schedule.json 内含每次执行收尾都被改写的运行态字段，整文件哈希会恒判 Conflict
- * （每轮同步都重现，用户点「应用」还会把远端陈旧运行态倒灌回本机；issue #73）。
+ * **例外：两个调度配置的身份字节见覆写的 comparableContent()** —— sync-autosync.json /
+ * backup-schedule.json 内含每次执行收尾都被改写的运行态字段（lastRunAt / lastRunStatus /
+ * lastRunHistoryId / consecutiveFailures …），整文件哈希会恒判 Conflict（每轮同步都重现，
+ * 用户点「应用」还会把远端陈旧运行态倒灌回本机；issue #73）；同一批字段还会让 self 分区
+ * 的 hashSection 每轮都变 —— 自动同步的「本地有改动」检测因此**永远为真**，每次远端轮询
+ * （缺省 60s）都真推一个新快照（issue #127：真机 41 次/天、内容仅差一个 lastRunAt）。
+ * 现在这份字节同时用于导出载荷与哈希（见基类 collect()），运行态只留在本机文件里。
  *
  * 为什么必须靠 listRelPaths() 而不是覆写 export() 来收窄（2026-10 真机报告）：
  * `preview()` / `listRelPaths()` 是后来才加进基类的。本类此前只覆写 export()，于是只读预览