opencode-metrics-plugin 0.4.3 → 0.4.4

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.4.4（2026-09-17）
+
+- **移除单包体积上限**
+- **云端日期目录改随会话开始日，单会话一个只存在一个目录**
+- **内置 migration-complete 场景**（label=`migration-complete`，终态）：命中 `droid2hmos report validate … --require-complete`（complete 硬门槛唯一正规途径）或 `droid2hmos report render`（仅 complete 后执行）即视为迁移完成，上传成功写 `.sent` 已传标记；容忍 `.cmd`/`.exe` 包装调用。
+- **hap 产物平铺**：包内路径由 `hap/<根名>/<build 剥离相对路径>` 改为 `hap/<原始文件名>`，不再创建深层目录（同名后者覆盖为已知行为）。
+- **黑名单新增 `gradle-home` / `.gradle`**：AI 会话临时发明的 GRADLE_USER_HOME 目录（实测单目录 1.1GB）不再入包。
+
 ## 0.4.3（2026-09-16）
 
 - **修复 AGC 上传 400**：Node 原生 http.request 默认不发送 `User-Agent`，AGC 云存储 2026-09-16 起强制校验该头（此前 0.4.2 及更早版本同缺陷，服务端新策略触发）——上传 PUT 显式携带 `User-Agent: opencode-metrics-plugin/<version>`。

package/README.md

@@ -57,13 +57,14 @@
 
 默认开启（`upload.enabled: false` 可关）：
 
-- **触发场景**：bash 执行 `git commit`（label=`git`）；会话结束/插件退出（label=`session-end`）；**根会话 task 工具完成或失败即刻触发 session-end**（子代理嵌套调用不触发）。可自定义场景（命令正则、事件名或工具名）
-- **打包内容**：时点快照 JSON + 事件日志（恒含）+ 会话动过的工作区产物根（鸿蒙工程标记探测，≤3 个）+ build 目录内的 `.hap` 产物包（借道组装目录，不受 build 黑名单影响）
+- **触发场景**：bash 执行 `git commit`（label=`git`）；**迁移完成**（`droid2hmos report validate … --require-complete` 或 `report render`，label=`migration-complete`，终态场景）；会话结束/插件退出（label=`session-end`）；**根会话 task 工具完成或失败即刻触发 session-end**（子代理嵌套调用不触发）。可自定义场景（命令正则、事件名或工具名）
+- **打包内容**：时点快照 JSON + 事件日志（恒含）+ 会话动过的工作区产物根（鸿蒙工程标记探测，≤3 个）+ build 目录内的 `.hap` 产物包（平铺为 `hap/<原始文件名>`，借道组装目录不受 build 黑名单影响）
 - **根推断增强**：安卓工程根（如 gradle 外壳）不整根保留也不丢弃——向内扫描提升鸿蒙子工程（`ohos/` 等）与迁移工作区（`.migration` / `.harmonyos`）；会话期间新建的相邻鸿蒙工程（目录 mtime 在会话开始之后）也会纳入，邻居老工程不混入；纯安卓工程（无任何鸿蒙子根）不打包
-- **自动剔除**：黑名单目录（`oh_modules` / `build` / `node_modules` 等 8 项）；安卓工程（根级 + 子树级，gradle 信号 ≥2 判定，可用 `excludeAndroidProjects: false` 关闭）
-- **云端路径**：`YYYYMMDD/<安卓包名或项目名>-<sessionId>/<agent缩写>-<触发>-v<n>/<agent缩写>-<触发>-v<n>.tar.gz` 与同名 `.json`（一个版本一个目录，双文件归拢；日期取包创建日）
+- **自动剔除**：黑名单目录（`oh_modules` / `build` / `node_modules` / `gradle-home` / `.gradle` 等 10 项）；安卓工程（根级 + 子树级，gradle 信号 ≥2 判定，可用 `excludeAndroidProjects: false` 关闭）
+- **云端路径**：`YYYYMMDD/<安卓包名或项目名>-<sessionId>/<agent缩写>-<触发>-v<n>/<agent缩写>-<触发>-v<n>.tar.gz` 与同名 `.json`（一个版本一个目录，双文件归拢；日期取**会话开始日**，跨天会话归到开始日，旧数据回退包创建日）
+- **无体积上限**：单包不再做大小拦截（原 500MB 上限已移除），超大包交给上传超时（10min）与失败保留机制兜底
 - **可靠性**：串行队列 + 指数退避重试（默认 5 次，4xx 不重试）；失败包移入暂存目录 `failed/` 下**与云端同构的目录**（含 meta 元数据，可整目录手动上传），下次启动自动补偿重传，重传成功即清理；保留超期（默认 7 天）或超量（默认 1GB，从最旧删）自动清理
-- **进程死亡兜底**：宿主突然退出（session-end 从未触发）时，下次启动对静默超 24h 且未传终态的快照自动补打 session-end 包（`metrics/.sent/` 已传标记防重传，超 7 天放弃）
+- **进程死亡兜底**：宿主突然退出（session-end 从未触发）时，下次启动对未传终态的快照**立即**自动补打 session-end 包（活跃会话排除；`metrics/.sent/` 已传标记防重传，超 7 天放弃）
 
 ## 输出目录
 
@@ -101,14 +102,13 @@
 |---|---|---|---|
 | `upload.enabled` | boolean | `true` | 上传总开关；`false` 显式关闭 |
 | `upload.uploader.agcConfigPath` | string | 包内凭证 | `agc-apiclient.json` 绝对路径（client_id/secret/project_id/region/bucket） |
-| `upload.scenarios` | object | 内置两场景 | 按 key 合并：`enabled:false` 禁用内置；自定义场景提供 `commands`（正则）/ `events`（事件名）/ `tools`（工具名，终态触发）与 `label`（进文件名） |
+| `upload.scenarios` | object | 内置三场景 | 按 key 合并：`enabled:false` 禁用内置；自定义场景提供 `commands`（正则）/ `events`（事件名）/ `tools`（工具名，终态触发）/ `terminal`（终态标记）与 `label`（进文件名） |
 | `upload.appendArtifacts` | array | — | 追加产物规则：`path`（绝对或相对会话工作目录）+ `matchBy`（`session-activity` 会话动过才纳入 / `existence` 存在即纳入）+ `dirMarkers`/`fileMarkers` |
-| `upload.blacklist` | string[] | 默认 8 项 | 打包排除的目录/文件名（追加，不替换） |
+| `upload.blacklist` | string[] | 默认 10 项 | 打包排除的目录/文件名（追加，不替换） |
 | `upload.excludeAndroidProjects` | boolean | `true` | 剔除安卓工程（根级 + 根内子树） |
-| `upload.maxArtifactBytes` | number | `524288000` | 单包体积上限（默认 500MB），超限该次标失败 |
 | `upload.retry` | object | `{5, 1000}` | `maxAttempts` 最大尝试次数；`backoffMs` 退避基数（1s/4s/16s/64s/256s） |
 | `upload.retryRescue` | object | `{true, 7, 1GB}` | 失败保留与补偿重传：`enabled` 开关；`retentionDays` 保留天数；`maxFailedBytes` failed/ 总量上限（超限从最旧删） |
-| `upload.orphanRescue` | object | `{true, 24, 7}` | 孤儿快照补传：`enabled` 开关；`idleHours` 静默下限（小时）；`maxAgeDays` 最大快照年龄（天），超龄放弃 |
+| `upload.orphanRescue` | object | `{true, 0, 7}` | 孤儿快照补传：`enabled` 开关；`idleHours` 静默下限（小时，缺省 0 = 启动即补）；`maxAgeDays` 最大快照年龄（天），超龄放弃 |
 
 ## 可编程 API
 

package/dist/metrics/upload/agcUploader.d.ts

@@ -40,7 +40,7 @@ export declare function loadAgcCredentials(configPath: string, tokenCacheDir?: s
 export interface AgcUploader {
     /**
      * 上传一次触发的两个文件（归档包 + 快照）到
-     * YYYYMMDD/<projectName>-<sessionId>/<agentName>-<trigger>-v<n>.tar.gz|.json，
+     * YYYYMMDD（会话开始日）/<projectName>-<sessionId>/<agentName>-<trigger>-v<n>.tar.gz|.json，
      * 两者都成功才算成功；任一失败返回该失败（整任务由队列重试）。
      *
      * @param uploadPackage 归档产物（含双文件与路径元数据）
@@ -70,7 +70,9 @@ export declare function abbreviateAgentName(agentName: string): string;
 /**
  * 组装云端对象路径前缀（含版本目录，双文件归拢其内）：
  * YYYYMMDD/<projectName>-<sessionId>/<agent缩写>-<trigger>-v<n>/<agent缩写>-<trigger>-v<n>
- * 日期目录取包创建日（createdAt）：重传不漂移到重传当天，失败保留目录与之同构。
+ * 日期目录取会话开始日（sessionStartedAt，快照 startTime 跨重启取最早）：
+ * 跨天会话归到开始日；旧 meta 无此字段回退包创建日（createdAt），重传不漂移到重传当天，
+ * 失败保留目录与之同构。
  */
 export declare function composeRemoteBase(uploadPackage: UploadPackage): string;
 /** 归档包云端对象完整路径（上传成功日志用） */

package/dist/metrics/upload/agcUploader.js

@@ -226,10 +226,12 @@ export function abbreviateAgentName(agentName) {
 /**
  * 组装云端对象路径前缀（含版本目录，双文件归拢其内）：
  * YYYYMMDD/<projectName>-<sessionId>/<agent缩写>-<trigger>-v<n>/<agent缩写>-<trigger>-v<n>
- * 日期目录取包创建日（createdAt）：重传不漂移到重传当天，失败保留目录与之同构。
+ * 日期目录取会话开始日（sessionStartedAt，快照 startTime 跨重启取最早）：
+ * 跨天会话归到开始日；旧 meta 无此字段回退包创建日（createdAt），重传不漂移到重传当天，
+ * 失败保留目录与之同构。
  */
 export function composeRemoteBase(uploadPackage) {
-    const created = new Date(uploadPackage.createdAt);
+    const created = new Date(uploadPackage.sessionStartedAt ?? uploadPackage.createdAt);
     const pad = (value) => String(value).padStart(2, "0");
     const dateDirectory = `${created.getFullYear()}${pad(created.getMonth() + 1)}${pad(created.getDate())}`;
     const fileBase = `${abbreviateAgentName(uploadPackage.agentName)}-${uploadPackage.trigger}-v${uploadPackage.sequence}`;

package/dist/metrics/upload/packageArchiver.d.ts

@@ -19,8 +19,6 @@ export interface ArchiveSessionOptions {
     blacklist?: string[];
     /** 剔除根内嵌套的安卓工程子目录（深度 ≤2），缺省 true */
     excludeAndroidProjects?: boolean;
-    /** 单包体积上限，超限该次失败 */
-    maxArtifactBytes?: number;
 }
 /**
  * 打包一次上传产物：恒含项（快照 + 事件日志）与各 workspace 根打成单个 tar.gz，

package/dist/metrics/upload/packageArchiver.js

@@ -4,9 +4,54 @@ import { spawn } from "node:child_process";
 import { createHash } from "node:crypto";
 import { log } from "../../shared/log.js";
 import { looksLikeAndroidProject } from "./workspaceResolver.js";
-import { DEFAULT_BLACKLIST, DEFAULT_MAX_ARTIFACT_BYTES, sanitizeNameSegment, } from "./types.js";
-// 会话维度单调序号：v1, v2, ...（进程内；硬杀丢失为 v1 已知限制）
-const sessionSequence = new Map();
+import { DEFAULT_BLACKLIST, sanitizeNameSegment, } from "./types.js";
+/**
+ * 会话维度单调序号持久化：metrics/<sessionId>.seq 读旧值 +1 写回。
+ * 进程内 Map 方案在硬杀/重启后会从 v1 重来，跨进程同日同触发场景会覆盖云端同名对象。
+ *
+ * @param metricsDir 快照目录
+ * @param sessionId  会话 id
+ * @returns           本次序号（从 1 起）
+ */
+function nextSequence(metricsDir, sessionId) {
+    const seqPath = path.join(metricsDir, `${sessionId}.seq`);
+    let sequence = 1;
+    try {
+        const previous = Number(fs.readFileSync(seqPath, "utf-8").trim());
+        if (Number.isFinite(previous) && previous > 0)
+            sequence = previous + 1;
+    }
+    catch {
+        // 首次打包，从 1 起
+    }
+    try {
+        fs.writeFileSync(seqPath, String(sequence));
+    }
+    catch {
+        // 写失败退化为本次返回值，下次可能重号（与旧的进程内行为一致）
+    }
+    return sequence;
+}
+/**
+ * 从快照提取会话开始时间（ms）：顶层 startTime（merge 跨重启取最早）→
+ * header.startTime（ISO 字符串）兜底；均无效返回 undefined（云端路径回退 createdAt）。
+ *
+ * @param snapshotPath 快照文件路径
+ */
+function extractSessionStartTime(snapshotPath) {
+    try {
+        const snapshot = JSON.parse(fs.readFileSync(snapshotPath, "utf-8"));
+        if (typeof snapshot.startTime === "number" && snapshot.startTime > 0)
+            return snapshot.startTime;
+        const parsed = Date.parse(String(snapshot.header?.startTime ?? ""));
+        if (Number.isFinite(parsed) && parsed > 0)
+            return parsed;
+    }
+    catch {
+        // 快照损坏时回退 createdAt（composeRemoteBase 侧兜底）
+    }
+    return undefined;
+}
 let tarAvailable = null;
 /**
  * 打包一次上传产物：恒含项（快照 + 事件日志）与各 workspace 根打成单个 tar.gz，
@@ -28,8 +73,7 @@ export async function archiveSessionPackage(options) {
     }
     const stagingDir = options.stagingDir;
     fs.mkdirSync(stagingDir, { recursive: true });
-    const sequence = (sessionSequence.get(sessionId) ?? 0) + 1;
-    sessionSequence.set(sessionId, sequence);
+    const sequence = nextSequence(metricsDir, sessionId);
     const agentLabel = sanitizeNameSegment(options.agentName, "agent");
     const projectLabel = sanitizeNameSegment(options.projectName);
     const triggerLabel = sanitizeNameSegment(options.trigger, "upload");
@@ -48,16 +92,12 @@ export async function archiveSessionPackage(options) {
             fs.copyFileSync(logFile, path.join(assemblyDir, "events", path.basename(logFile)));
         }
         const rootEntries = assignRootEntryNames(roots);
-        // hap 产物包独立收集：build 目录整体在 tar 黑名单中，hap 借道组装目录随包上传；
-        // 目标路径剥去 build 段（否则被 --exclude */build 连坐排除）
+        // hap 产物包独立收集：build 目录整体在 tar 黑名单中，hap 借道组装目录随包上传。
+        // 平铺落位：直接以原始文件名放 hap/ 下（同名后者覆盖；hap 文件名通常含模块名，实际冲突概率极低）
         const hapFiles = collectHapFiles(roots, options.blacklist ?? []);
         let hapBytes = 0;
         for (const hap of hapFiles) {
-            const entry = rootEntries.find((candidate) => normalizeRootKey(candidate.root) === normalizeRootKey(hap.root));
-            if (!entry)
-                continue;
-            const targetRelative = hap.relativePath.replace(/(^|\/)build\//, "$1");
-            const target = path.join(assemblyDir, "hap", entry.entryName, ...targetRelative.split("/"));
+            const target = path.join(assemblyDir, "hap", path.basename(hap.filePath));
             fs.mkdirSync(path.dirname(target), { recursive: true });
             fs.copyFileSync(hap.filePath, target);
             hapBytes += fs.statSync(hap.filePath).size;
@@ -69,11 +109,6 @@ export async function archiveSessionPackage(options) {
         }
         fs.renameSync(tmpPath, archivePath);
         const sizeBytes = fs.statSync(archivePath).size;
-        const maxBytes = options.maxArtifactBytes ?? DEFAULT_MAX_ARTIFACT_BYTES;
-        if (sizeBytes > maxBytes) {
-            fs.rmSync(archivePath, { force: true });
-            return fail("too-large", `包体积 ${sizeBytes} 超过上限 ${maxBytes}`);
-        }
         // 快照单独一份（与包内时点一致）
         fs.copyFileSync(path.join(assemblyDir, "snapshot", `${sessionId}.json`), snapshotPath);
         const sha256 = await computeSha256(archivePath);
@@ -93,6 +128,7 @@ export async function archiveSessionPackage(options) {
             sha256,
             roots: [...roots],
             createdAt: Date.now(),
+            sessionStartedAt: extractSessionStartTime(snapshotSource),
         };
         // 元数据 sidecar：失败保留/启动补偿重建上传任务与云端路径的依据，终态时随双文件删除
         fs.writeFileSync(path.join(stagingDir, `${baseName}.meta.json`), JSON.stringify(uploadPackage, null, 2));
@@ -122,11 +158,6 @@ function assignRootEntryNames(roots) {
         return { root, entryName };
     });
 }
-/** 根路径归一化比较键（仅 Windows 大小写不敏感） */
-function normalizeRootKey(target) {
-    const resolved = path.resolve(target);
-    return process.platform === "win32" ? resolved.toLowerCase() : resolved;
-}
 /** hap 收集递归深度上限（build 目录内部层级防护） */
 const HAP_SCAN_DEPTH = 10;
 /**

package/dist/metrics/upload/scenarios.d.ts

@@ -11,6 +11,8 @@ export interface ResolvedScenario {
     events: string[];
     /** 匹配的工具名（根会话直接调用的工具 completed/error 时触发） */
     toolNames: string[];
+    /** 终态标记：命中上传成功即写 .sent 已传标记 */
+    terminal: boolean;
 }
 /**
  * 合并内置场景与 opencode.json 配置：内置 key 深合并（label/commands/events/tools

package/dist/metrics/upload/scenarios.js

@@ -9,6 +9,17 @@ const BUILTIN_SCENARIOS = {
     // git 与 commit 之间允许 ≤4 个选项（如 -c user.name=x、-C <path>、--no-verify），
     // 但选项必须以 - 开头——避免把 "git log --grep=commit" 一类误判为提交
     "git-commit": { label: "git", commands: ["\\bgit\\s+(?:-{1,2}[\\w.-]+(?:[ =][^\\s]+)?\\s+){0,4}commit\\b"] },
+    // 迁移完成强信号：report validate --require-complete 是 complete 硬门槛的唯一正规途径，
+    // report render 仅 complete 后才执行；命中即视为会话业务终态（terminal，上传成功写 .sent 标记）。
+    // 前缀容忍 .cmd/.exe 包装调用（Windows 实际形态）
+    "migration-complete": {
+        label: "migration-complete",
+        terminal: true,
+        commands: [
+            "\\bdroid2hmos(?:\\.cmd|\\.exe)?\\s+report\\s+validate\\b[^\\r\\n]*--require-complete",
+            "\\bdroid2hmos(?:\\.cmd|\\.exe)?\\s+report\\s+render\\b",
+        ],
+    },
 };
 /**
  * 合并内置场景与 opencode.json 配置：内置 key 深合并（label/commands/events/tools
@@ -44,6 +55,7 @@ export function resolveScenarios(configs) {
             commandRegexes,
             events: config.events ?? [],
             toolNames: config.tools ?? [],
+            terminal: config.terminal ?? false,
         });
     }
     return result;

package/dist/metrics/upload/types.d.ts

@@ -27,6 +27,8 @@ export interface ScenarioConfig {
     events?: string[];
     /** 工具名匹配器：根会话直接调用的工具进入终态（completed/error）时触发 */
     tools?: string[];
+    /** 显式终态标记：命中上传成功即写 .sent 已传标记（缺省由 events 含 session.deleted 或 tools 非空推导） */
+    terminal?: boolean;
 }
 /** 上传通道配置（当前仅 agc） */
 export interface UploaderConfig {
@@ -52,7 +54,7 @@ export interface RetryRescueConfig {
 export interface OrphanRescueConfig {
     /** 缺省 true：启用孤儿快照补传 */
     enabled?: boolean;
-    /** 快照静默多久视为孤儿（小时，缺省 24；活跃会话快照始终排除） */
+    /** 快照静默多久视为孤儿（小时，缺省 0 = 启动即补，活跃会话快照始终排除） */
     idleHours?: number;
     /** 快照最大补传年龄（天，缺省 7，超过视为陈旧放弃） */
     maxAgeDays?: number;
@@ -73,8 +75,6 @@ export interface UploadConfig {
     blacklist?: string[];
     /** 剔除安卓工程（根级剔除 + 根内子树剔除），缺省 true */
     excludeAndroidProjects?: boolean;
-    /** 单包体积上限，超限该次标 failed */
-    maxArtifactBytes?: number;
     retry?: UploadRetryConfig;
     retryRescue?: RetryRescueConfig;
     orphanRescue?: OrphanRescueConfig;
@@ -107,6 +107,8 @@ export interface UploadPackage {
     /** 纳入的 workspace 产物根 */
     roots: string[];
     createdAt: number;
+    /** 会话开始时间（ms，取快照 startTime，跨重启取最早）：云端日期目录 YYYYMMDD 的来源，随 meta.json 持久化；旧 meta 缺省回退 createdAt */
+    sessionStartedAt?: number;
 }
 /**
  * 清洗名称为安全的路径段：非法字符（含空格）替换为 "-"，保留中文与内部点号，
@@ -131,8 +133,6 @@ export declare const DEFAULT_DIR_MARKERS: readonly string[];
 export declare const DEFAULT_FILE_MARKERS: readonly string[];
 /** 打包排除的目录/文件名（按路径段匹配） */
 export declare const DEFAULT_BLACKLIST: readonly string[];
-/** 单包体积上限默认 500MB */
-export declare const DEFAULT_MAX_ARTIFACT_BYTES: number;
 /** 自证据路径向上探测标记的最大层级 */
 export declare const MAX_PROBE_DEPTH = 5;
 /** 产物根数量上限 */

package/dist/metrics/upload/types.js

@@ -34,9 +34,9 @@ export const DEFAULT_BLACKLIST = [
     "node_modules",
     ".idea",
     "local.properties",
+    "gradle-home",
+    ".gradle",
 ];
-/** 单包体积上限默认 500MB */
-export const DEFAULT_MAX_ARTIFACT_BYTES = 500 * 1024 * 1024;
 /** 自证据路径向上探测标记的最大层级 */
 export const MAX_PROBE_DEPTH = 5;
 /** 产物根数量上限 */

package/dist/metrics/upload/uploadManager.d.ts

@@ -31,7 +31,7 @@ export declare function createUploadManager(options: UploadManagerOptions): Uplo
  * 三个文件名已处理）。字母序下 .json/.meta.json 先于 .tar.gz 迭代，若单遍
  * 边迭代边删 .json，会在 tar.gz 校验前破坏三件套——完整崩溃遗留包必然被
  * 误判"不完整"而销毁（曾连续销毁终态包）。第二遍才清理无 tar.gz 对应的
- * 孤儿 .json/meta 与组装残留。
+ * 孤儿 .json/meta、被中途打断的 .tar.gz.tmp 半成品与组装残留。
  *
  * @param stagingDir    暂存目录
  * @param rescueEnabled 失败保留开关（false 时完整三件套也直接删除，旧行为）

package/dist/metrics/upload/uploadManager.js

@@ -30,7 +30,7 @@ export function createUploadManager(options) {
     void uploader.warmup();
     // 终态场景标签集合：这些标签的包上传成功即写已传标记（孤儿扫描防重依据）
     const terminalLabels = new Set(scenarios
-        .filter((s) => s.enabled && (s.events.includes("session.deleted") || s.toolNames.length > 0))
+        .filter((s) => s.enabled && (s.terminal || s.events.includes("session.deleted") || s.toolNames.length > 0))
         .map((s) => s.label));
     // 失败保留与启动补偿配置（默认开启）
     const rescueEnabled = config.retryRescue?.enabled !== false;
@@ -93,8 +93,9 @@ export function createUploadManager(options) {
             queue.enqueue(pkg);
     }
     // 孤儿快照补传：宿主死亡导致终态触发从未发生时，按快照年龄补打 session-end 包
+    // （idleHours 缺省 0：启动即补，Ctrl+C/崩溃/关窗后无需静默等待；.sent 时效判断防重）
     if (config.orphanRescue?.enabled !== false) {
-        const idleMs = (config.orphanRescue?.idleHours ?? 24) * 3_600_000;
+        const idleMs = (config.orphanRescue?.idleHours ?? 0) * 3_600_000;
         const maxAgeMs = (config.orphanRescue?.maxAgeDays ?? 7) * 86_400_000;
         void rescueOrphanSnapshots(idleMs, maxAgeMs);
     }
@@ -148,7 +149,6 @@ export function createUploadManager(options) {
             stagingDir: directories.uploadStagingDir,
             blacklist: config.blacklist,
             excludeAndroidProjects: config.excludeAndroidProjects,
-            maxArtifactBytes: config.maxArtifactBytes,
         });
         if (archiveResult.ok) {
             queue.enqueue(archiveResult.package);
@@ -357,7 +357,7 @@ function dedupePaths(paths) {
  * 三个文件名已处理）。字母序下 .json/.meta.json 先于 .tar.gz 迭代，若单遍
  * 边迭代边删 .json，会在 tar.gz 校验前破坏三件套——完整崩溃遗留包必然被
  * 误判"不完整"而销毁（曾连续销毁终态包）。第二遍才清理无 tar.gz 对应的
- * 孤儿 .json/meta 与组装残留。
+ * 孤儿 .json/meta、被中途打断的 .tar.gz.tmp 半成品与组装残留。
  *
  * @param stagingDir    暂存目录
  * @param rescueEnabled 失败保留开关（false 时完整三件套也直接删除，旧行为）
@@ -392,11 +392,11 @@ export function sweepStagingDirectory(stagingDir, rescueEnabled) {
             handled.add(`${base}.json`);
             handled.add(`${base}.meta.json`);
         }
-        // 第二遍：清理剩余孤儿（无对应 tar.gz 的快照副本/meta、组装残留目录）
+        // 第二遍：清理剩余孤儿（无对应 tar.gz 的快照副本/meta、被中途打断的 .tar.gz.tmp 半成品、组装残留目录）
         for (const entry of entries) {
             if (handled.has(entry))
                 continue;
-            if (entry.endsWith(".json") || entry.startsWith(".assembly-")) {
+            if (entry.endsWith(".json") || entry.endsWith(".tar.gz.tmp") || entry.startsWith(".assembly-")) {
                 fs.rmSync(path.join(stagingDir, entry), { recursive: true, force: true });
                 removed++;
                 removedNames.push(entry);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-metrics-plugin",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "opencode plugin: auto-records every session's metrics (tokens/rounds/steps/sub-agents/hvigor builds) to snapshot JSON. Zero DB, zero config. Pair with session-viewer for visualization.",
   "type": "module",
   "license": "MIT",