@mison/wecom-cleaner 1.3.0 → 1.3.2

package/README.md

@@ -168,10 +168,10 @@ GitHub 备选方式（无 npm 包依赖）：
 curl -fsSL https://raw.githubusercontent.com/MisonL/wecom-cleaner/main/scripts/install-skill.sh | bash
 ```
 
-若需安装指定版本标签（例如 `v1.3.0`）：
+若需安装指定版本标签（例如 `v1.3.2`）：
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/MisonL/wecom-cleaner/main/scripts/install-skill.sh | bash -s -- --ref v1.3.0
+curl -fsSL https://raw.githubusercontent.com/MisonL/wecom-cleaner/main/scripts/install-skill.sh | bash -s -- --ref v1.3.2
 ```
 
 Agent 侧统一任务入口脚本（位于 `skills/wecom-cleaner-agent/scripts/`）：
@@ -238,6 +238,9 @@ wecom-cleaner --space-governance \
 # 回收区治理（按策略执行）
 wecom-cleaner --recycle-maintain --dry-run false --yes
 
+# 年月清理（三阶段协议：预演 -> 执行 -> 复核）
+wecom-cleaner --cleanup-monthly --accounts all --cutoff-month 2024-04 --run-task preview-execute-verify --yes
+
 # 批次恢复（冲突策略：重命名）
 wecom-cleaner --restore-batch 20260226-105009-ffa098 --conflict rename
 
@@ -251,13 +254,15 @@ wecom-cleaner --check-update --output text
 wecom-cleaner --upgrade npm --upgrade-yes
 
 # 执行升级（GitHub 托管脚本方式）
-wecom-cleaner --upgrade github-script --upgrade-version 1.3.1 --upgrade-yes
+wecom-cleaner --upgrade github-script --upgrade-version 1.3.2 --upgrade-yes
 ```
 
 ### 输出与兼容参数
 
 - `--output json|text`：无交互输出格式，默认 `json`。
 - `--json`：兼容别名，等价于 `--output json`。
+- `--run-task preview|execute|preview-execute-verify`：阶段任务协议（推荐给 Agent）。
+- `--scan-debug off|summary|full`：扫描诊断信息输出等级。
 - `--mode`：兼容参数，建议迁移到动作参数（如 `--cleanup-monthly`）。
 - `--save-config`：将本次全局配置参数写回 `config.json`。
 - `--help` / `-h`：输出命令帮助并退出。
@@ -280,6 +285,7 @@ wecom-cleaner --upgrade github-script --upgrade-version 1.3.1 --upgrade-yes
 - `summary.rootPathCount`：涉及的清理根目录数量
 - `summary.accountCount` / `monthCount` / `categoryCount` / `externalRootCount`
 - `summary.cutoffMonth`：截止月份（当使用 `--cutoff-month` 时）
+- `summary.runTaskMode` / `summary.taskDecision`：阶段协议模式与决策（仅 `--run-task`）
 
 `cleanup-monthly` 还会在 `data.report` 中返回可展示明细：
 
@@ -288,6 +294,9 @@ wecom-cleaner --upgrade github-script --upgrade-version 1.3.1 --upgrade-yes
 - `data.report.matched.rootStats`：按根目录统计（条目数、体积）
 - `data.report.matched.topPaths`：按体积 Top 路径样例
 - `data.report.executed.byCategory/byMonth/byRoot`：真实执行落地统计（成功/跳过/失败 + 体积）
+- `data.taskPhases`：阶段执行明细（预演/执行/复核）
+- `data.taskCard`：面向用户的任务卡片聚合结果
+- `data.scanDebug`：扫描诊断（当 `--scan-debug summary|full`）
 
 #### `analysis-only`
 
@@ -355,6 +364,8 @@ wecom-cleaner --upgrade github-script --upgrade-version 1.3.1 --upgrade-yes
 - `--theme <auto|light|dark>`：Logo 主题
 - `--interactive`：即使携带参数也进入交互流程（可配合 `--mode`）
 - `--force`：锁异常场景下强制清理并继续（兜底参数，通常无需）
+- `--run-task preview|execute|preview-execute-verify`：阶段任务协议（推荐无交互自动化调用）
+- `--scan-debug off|summary|full`：附加扫描诊断信息
 
 ### `--theme` 可选值
 
@@ -438,8 +449,8 @@ npm run pack:tgz:dry-run
 
 当前基线（主分支）：
 
-- 单元测试：`100/100` 通过。
-- 覆盖率：`statements 87.63%`，`branches 74.03%`，`functions 92.47%`，`lines 87.63%`。
+- 单元测试：`107/107` 通过。
+- 覆盖率：`statements 87.66%`，`branches 74.38%`，`functions 92.47%`，`lines 87.66%`。
 - 全菜单 smoke：通过（含恢复冲突分支与 doctor JSON 分支）。
 
 ## 测试矩阵
@@ -482,7 +493,7 @@ npm run pack:tgz
 npm run pack:release-assets
 
 # 2) 推送主分支与标签
-VERSION="1.3.0"
+VERSION="1.3.2"
 git push origin main
 git tag "v${VERSION}"
 git push origin "v${VERSION}"

package/docs/IMPLEMENTATION_PLAN.md

@@ -122,7 +122,7 @@
 - 使用 `c8` 输出覆盖率报告。
 - 门禁阈值：`lines/statements >= 75%`，`functions >= 80%`，`branches >= 60%`。
 - 命令：`npm run test:coverage` / `npm run test:coverage:check`。
-- `v1.1.0` 基线：`statements 86.57%`，`branches 73.96%`，`functions 93.25%`，`lines 86.57%`。
+- `v1.3.2` 基线：`statements 87.66%`，`branches 74.38%`，`functions 92.47%`，`lines 87.66%`。
 
 4. 端到端回归
 
@@ -142,17 +142,17 @@ npm run pack:tgz:dry-run
 
 1. 版本与产物
 
-- `package.json` / `package-lock.json`：`1.1.0`
-- `native/manifest.json`：版本与 `baseUrl` 对齐 `v1.1.0`
+- `package.json` / `package-lock.json`：`1.3.2`
+- `native/manifest.json`：版本与 `baseUrl` 对齐当前发布标签
 - 默认打包双架构核心：`darwin-x64` + `darwin-arm64`
 
 2. GitHub Release
 
 ```bash
 git push origin main
-git tag v1.1.0
-git push origin v1.1.0
-gh release create v1.1.0 --title "v1.1.0" --notes-file docs/releases/v1.1.0.md wecom-cleaner-1.1.0.tgz
+git tag v1.3.2
+git push origin v1.3.2
+gh release create v1.3.2 --title "v1.3.2" --notes-file docs/releases/v1.3.2.md wecom-cleaner-1.3.2.tgz
 ```
 
 3. npm 发布

package/docs/NON_INTERACTIVE_SPEC.md

@@ -34,6 +34,10 @@
 - 默认 `dry-run`（不执行真实删除/恢复）。
 - 真实执行需显式传 `--yes`。
 - 若传 `--dry-run false` 且未传 `--yes`，退出码为 `3`。
+- 可通过 `--run-task` 启用阶段协议：
+  - `preview`：仅预演阶段。
+  - `execute`：仅真实执行阶段（破坏性动作需 `--yes`）。
+  - `preview-execute-verify`：预演 -> 真实执行 -> 同条件复核（预演命中 `0` 时自动跳过执行与复核）。
 
 ## 4. 输出协议
 
@@ -41,6 +45,8 @@
 
 - `--output json|text`（默认 `json`）
 - `--json` 为兼容别名（等价 `--output json`）
+- `--run-task preview|execute|preview-execute-verify`（推荐破坏性动作使用）
+- `--scan-debug off|summary|full`（默认 `off`）
 
 JSON 顶层字段：
 
@@ -53,6 +59,9 @@ JSON 顶层字段：
 - `data`：动作明细数据
 - `meta`：元信息（版本、耗时、引擎、时间戳等）
 - `data.userFacingSummary`：统一的用户侧结果摘要（范围 + 结果 + 关键分布）
+- `data.taskPhases`：阶段协议明细（仅在 `--run-task` 时返回）
+- `data.taskCard`：阶段任务卡片（仅在 `--run-task` 时返回）
+- `data.scanDebug`：扫描诊断信息（仅在 `--scan-debug summary|full` 时返回）
 
 `cleanup_monthly` 常见 `summary` 字段：
 
@@ -215,6 +224,8 @@ JSON 顶层字段：
 - `--upgrade-channel <stable|pre>`：更新通道（稳定版/预发布）
 - `--upgrade-version <x.y.z>`：升级到指定版本
 - `--upgrade-yes`：确认执行升级（无此参数将拒绝执行升级）
+- `--run-task preview|execute|preview-execute-verify`：无交互阶段协议
+- `--scan-debug off|summary|full`：扫描诊断输出等级
 
 ## 7. 动作参数
 

package/docs/TEST_MATRIX.md

@@ -39,6 +39,8 @@
 - dry-run（预演）
 - 真实执行（`--dry-run false --yes`）
 - 真实执行后复核（同条件二次运行）
+- 阶段协议（`--run-task preview|execute|preview-execute-verify`）
+- 扫描诊断（`--scan-debug summary|full`）
 
 ### 维度 E：异常与边界
 
@@ -92,13 +94,15 @@
 
 1. `cleanup_monthly`：`--cutoff-month` + `--output json` + dry-run（有目标 / 无目标）
 2. `cleanup_monthly`：真实执行 + 复核（复核命中应下降或归零）
-3. `space_governance`：`suggested-only` 与 `allow-recent-active` 组合
-4. `restore`：`skip/overwrite/rename` 三冲突策略
-5. `recycle_maintain`：`disabled` / `no_candidate` / `partial_failed`
-6. `doctor`：只读模式不创建状态目录
-7. `check_update`：npm 正常 / npm 失败回退 GitHub / 全部失败
-8. `upgrade`：未确认拒绝、已是最新不执行、执行失败可返回非 0
-9. Agent 报告脚本：成功、无目标、失败三态退出码与卡片完整性
+3. `cleanup_monthly`：`--run-task preview-execute-verify --yes`（阶段字段稳定）
+4. `cleanup_monthly`：`--scan-debug summary/full`（诊断字段稳定）
+5. `space_governance`：`suggested-only` 与 `allow-recent-active` 组合
+6. `restore`：`skip/overwrite/rename` 三冲突策略
+7. `recycle_maintain`：`disabled` / `no_candidate` / `partial_failed`
+8. `doctor`：只读模式不创建状态目录
+9. `check_update`：npm 正常 / npm 失败回退 GitHub / 全部失败
+10. `upgrade`：未确认拒绝、已是最新不执行、执行失败可返回非 0
+11. Agent 报告脚本：成功、无目标、失败三态退出码与卡片完整性
 
 ## 当前门禁（执行顺序）
 

package/docs/releases/v1.3.1.md

@@ -0,0 +1,31 @@
+# v1.3.1
+
+发布日期：2026-02-27
+
+## 重点更新
+
+- 新增无交互阶段协议 `--run-task`：
+  - `preview`：仅预演
+  - `execute`：仅执行
+  - `preview-execute-verify`：预演 -> 执行 -> 复核
+- 无交互 JSON 新增阶段产物：
+  - `data.taskPhases`：阶段明细（状态、耗时、命中/成功/失败统计）
+  - `data.taskCard`：用户视角任务卡片（范围、结论、分布）
+- 新增扫描诊断参数 `--scan-debug off|summary|full`：用于定位“扫描命中与预期不一致”问题。
+
+## CLI 与 Agent 协同
+
+- `--help` 已补充 `--run-task` 与 `--scan-debug`。
+- skills 文档与命令参考已同步：CLI 回退场景优先使用 `--run-task`，并读取 `taskCard/taskPhases`。
+
+## 测试与质量
+
+- 新增/更新：
+  - `test/config.test.js`：新增 `--run-task` / `--scan-debug` 参数解析覆盖。
+  - `test/cli-non-interactive.test.js`：新增阶段协议与扫描诊断覆盖。
+- 全量测试通过：`npm test`（107/107）。
+
+## 兼容性说明
+
+- 旧的无交互调用方式保持兼容（不传 `--run-task` 时行为不变）。
+- 文本输出保持原有动作卡片，新增阶段流程区块仅在 `--run-task` 时显示。

package/docs/releases/v1.3.2.md

@@ -0,0 +1,38 @@
+# v1.3.2
+
+发布日期：2026-02-27
+
+## 重点更新
+
+- 4 个破坏性 Agent 报告脚本统一改为 `--run-task` 单入口（预演 / 执行 / 复核一致语义）：
+  - `cleanup_monthly_report.sh`
+  - `space_governance_report.sh`
+  - `restore_batch_report.sh`
+  - `recycle_maintain_report.sh`
+- Zig 核心版本号改为构建期自动注入，不再手工写死。
+- `native/manifest.json` 升级到 `v1.3.2`，并同步 `darwin-x64`/`darwin-arm64` 双架构 SHA256。
+
+## 稳定性修复
+
+- 修复 4 个报告脚本在错误分支下的变量展开风险：失败场景稳定返回非 0，避免自动化流程误判成功。
+- 修复 Zig 核心 `--ping` 版本与包版本可能不一致的问题。
+
+## 文档同步
+
+- README、实施计划、技能命令参考、升级脚本示例统一更新到 `v1.3.2`。
+
+## 验证结果
+
+- 发布门禁全通过：`npm run release:gate`
+  - `format:check`
+  - `check`
+  - `test:coverage:check`
+  - `shellcheck(skills)`
+  - `e2e:smoke`
+  - `pack:tgz:dry-run`
+  - `pack:release-assets:dry-run`
+- 覆盖率基线（`test:coverage:check`）：
+  - `statements 87.66%`
+  - `branches 74.38%`
+  - `functions 92.47%`
+  - `lines 87.66%`

package/native/manifest.json

@@ -1,16 +1,16 @@
 {
   "schemaVersion": 1,
-  "version": "1.3.0",
+  "version": "1.3.2",
   "targets": {
     "darwin-x64": {
       "binaryName": "wecom-cleaner-core",
-      "sha256": "1ea550528055b97e26a76de7d33ca7c445f7dcedf36b21c0cfe1ef7e0f9841bf",
-      "url": "https://github.com/MisonL/wecom-cleaner/releases/download/v1.3.0/wecom-cleaner-core-v1.3.0-darwin-x64"
+      "sha256": "7cb303935b713397012e88431238fa3b44e416ba1ceb0b1a96f354f3c818108c",
+      "url": "https://github.com/MisonL/wecom-cleaner/releases/download/v1.3.2/wecom-cleaner-core-v1.3.2-darwin-x64"
     },
     "darwin-arm64": {
       "binaryName": "wecom-cleaner-core",
-      "sha256": "2819be9b6108435d94f9a6f5cd0f4e219c335925239366f76fe8a22da023a736",
-      "url": "https://github.com/MisonL/wecom-cleaner/releases/download/v1.3.0/wecom-cleaner-core-v1.3.0-darwin-arm64"
+      "sha256": "93a33ae854e2dc7778865e3d59c048ba8f3d3ff3e3f3d19ec0906c316c18e503",
+      "url": "https://github.com/MisonL/wecom-cleaner/releases/download/v1.3.2/wecom-cleaner-core-v1.3.2-darwin-arm64"
     }
   }
 }

package/native/zig/build.sh

@@ -2,6 +2,9 @@
 set -euo pipefail
 
 ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+PACKAGE_VERSION="$(node -p "JSON.parse(require('fs').readFileSync('${ROOT_DIR}/package.json', 'utf8')).version")"
+VERSION_ZIG_PATH="${ROOT_DIR}/native/zig/src/version.zig"
+printf 'pub const APP_VERSION = "%s";\n' "${PACKAGE_VERSION}" > "${VERSION_ZIG_PATH}"
 
 HOST_OS="$(uname -s | tr '[:upper:]' '[:lower:]')"
 HOST_ARCH="$(uname -m)"

package/native/zig/src/main.zig

@@ -1,4 +1,5 @@
 const std = @import("std");
+const version_meta = @import("version.zig");
 
 fn isAbsPath(path: []const u8) bool {
     return std.fs.path.isAbsolute(path);
@@ -57,7 +58,7 @@ fn dirTreeSize(dir: *std.fs.Dir) !u64 {
 }
 
 fn printPing(writer: *std.Io.Writer) !void {
-    try writer.writeAll("{\"ok\":true,\"engine\":\"zig\",\"version\":\"1.3.0\"}\n");
+    try writer.print("{{\"ok\":true,\"engine\":\"zig\",\"version\":\"{s}\"}}\n", .{version_meta.APP_VERSION});
 }
 
 fn runDu(args: []const []const u8, writer: *std.Io.Writer) !void {

package/native/zig/src/version.zig

@@ -0,0 +1 @@
+pub const APP_VERSION = "1.3.2";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mison/wecom-cleaner",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "企业微信本地聊天缓存清理工具（交互式 CLI/TUI）",
   "author": "MisonL",
   "license": "MIT",

package/skills/wecom-cleaner-agent/SKILL.md

@@ -16,10 +16,11 @@ description: 用于执行和编排 wecom-cleaner 的无交互 Agent 技能。当
 1. 全程只用无交互命令（禁止直接运行 `wecom-cleaner` 进入 TUI）。
 2. 优先脚本入口，禁止手写三步命令流（除非脚本失败或缺失）。
 3. 破坏性动作（清理/治理/恢复/回收区治理）默认预演；真实执行必须有明确授权。
-4. 升级动作默认只做检查或预演（`--execute false`）；真实升级必须有明确授权。
-5. 若预演命中为 `0`，必须结束并说明“无需执行”，不得继续真实执行。
-6. 最终汇报必须是中文用户视角，先结论再细节，并解释关键指标含义。
-7. 禁止在终端回显完整 JSON；只输出人类可读摘要。
+4. 回退到 CLI 时，破坏性动作必须使用 `--run-task` 协议（`preview` 或 `preview-execute-verify`），禁止手工串联多次命令。
+5. 升级动作默认只做检查或预演（`--execute false`）；真实升级必须有明确授权。
+6. 若预演命中为 `0`，必须结束并说明“无需执行”，不得继续真实执行。
+7. 最终汇报必须是中文用户视角，先结论再细节，并解释关键指标含义。
+8. 禁止在终端回显完整 JSON；只输出人类可读摘要。
 
 ## 动作到脚本映射（必须）
 
@@ -37,6 +38,7 @@ description: 用于执行和编排 wecom-cleaner 的无交互 Agent 技能。当
 1. 先判断用户意图对应哪个动作。
 2. 直接调用对应脚本。
 3. 脚本失败时，才回退到 `wecom-cleaner --<action> --output json` 手工流程。
+4. 回退流程里优先读取 `data.taskCard` 与 `data.taskPhases`，再读取 `summary/data.report` 细节。
 
 ## 脚本调用约定
 
@@ -44,6 +46,9 @@ description: 用于执行和编排 wecom-cleaner 的无交互 Agent 技能。当
 - 用户明确“现在执行/开始清理/确认执行”时才传 `--execute true`。
 - 破坏性动作脚本内部会做：预演 ->（可选）真实执行 ->（可选）复核。
 - 升级脚本默认“检查 + 预演”；只有明确授权才执行真实升级。
+- CLI 回退时：
+  - 仅预演：`--run-task preview`
+  - 已授权执行：`--run-task preview-execute-verify --yes`
 
 推荐参数：
 

package/skills/wecom-cleaner-agent/agents/openai.yaml

@@ -1,5 +1,5 @@
 interface:
   display_name: 'WeCom Cleaner Agent'
   short_description: '面向AI Agent的企业微信缓存清理与恢复无交互执行技能'
-  default_prompt: '请使用 $wecom-cleaner-agent 执行任务：按用户意图自动选择 scripts/ 下对应报告脚本（cleanup/analysis/space/restore/recycle/doctor/check-update/upgrade），优先输出中文用户任务卡片；仅在脚本不可用时回退 wecom-cleaner --output json。'
+  default_prompt: '请使用 $wecom-cleaner-agent 执行任务：按用户意图自动选择 scripts/ 下对应报告脚本（cleanup/analysis/space/restore/recycle/doctor/check-update/upgrade），优先输出中文用户任务卡片；仅在脚本不可用时回退 wecom-cleaner --output json，并在破坏性动作中使用 --run-task（preview 或 preview-execute-verify）读取 data.taskCard/taskPhases。'
   brand_color: '#0EA5E9'

package/skills/wecom-cleaner-agent/references/commands.md

@@ -3,6 +3,11 @@
 ## 1. 首选入口：任务卡片脚本（统一体验）
 
 所有动作优先使用 `skills/wecom-cleaner-agent/scripts/` 下脚本，直接输出用户可读报告。
+其中破坏性动作脚本（年月清理/全量治理/恢复/回收区治理）已统一内置 `--run-task` 阶段协议：
+
+- `--execute false` 等价于 `preview`
+- `--execute true` 等价于 `preview-execute-verify --yes`
+- 当命中目标为 `0` 时会自动跳过真实执行，且保留一致的任务卡片输出与退出码语义
 
 ### 1.1 年月清理
 
@@ -58,7 +63,7 @@ bash scripts/upgrade_report.sh --method npm --execute false
 
 # 明确授权后执行真实升级
 bash scripts/upgrade_report.sh --method npm --execute true
-bash scripts/upgrade_report.sh --method github-script --version 1.3.0 --execute true
+bash scripts/upgrade_report.sh --method github-script --version 1.3.2 --execute true
 ```
 
 ## 2. 常用全局参数
@@ -75,25 +80,35 @@ bash scripts/upgrade_report.sh --method github-script --version 1.3.0 --execute
 ## 3. 回退方案：直接调用 wecom-cleaner
 
 仅在脚本不可用时使用直接命令，且保持 `--output json`。
+破坏性动作必须使用 `--run-task`，并优先消费 `data.taskCard` / `data.taskPhases`。
 
 ```bash
 # 年月清理（预演）
-wecom-cleaner --cleanup-monthly --accounts all --cutoff-month 2024-07 --output json
+wecom-cleaner --cleanup-monthly --accounts all --cutoff-month 2024-07 --run-task preview --output json
 
-# 年月清理（真实执行）
-wecom-cleaner --cleanup-monthly --accounts all --cutoff-month 2024-07 --dry-run false --yes --output json
+# 年月清理（真实执行 + 复核）
+wecom-cleaner --cleanup-monthly --accounts all --cutoff-month 2024-07 --run-task preview-execute-verify --yes --output json
 
 # 会话分析
 wecom-cleaner --analysis-only --accounts all --output json
 
-# 全量空间治理
-wecom-cleaner --space-governance --accounts all --tiers safe,caution --output json
+# 全量空间治理（预演）
+wecom-cleaner --space-governance --accounts all --tiers safe,caution --run-task preview --output json
+
+# 全量空间治理（真实执行 + 复核）
+wecom-cleaner --space-governance --accounts all --tiers safe,caution --run-task preview-execute-verify --yes --output json
+
+# 批次恢复（预演）
+wecom-cleaner --restore-batch 20260226-154831-c418d9 --conflict rename --run-task preview --output json
+
+# 批次恢复（真实执行 + 复核）
+wecom-cleaner --restore-batch 20260226-154831-c418d9 --conflict rename --run-task preview-execute-verify --yes --output json
 
-# 批次恢复
-wecom-cleaner --restore-batch 20260226-154831-c418d9 --conflict rename --output json
+# 回收区治理（预演）
+wecom-cleaner --recycle-maintain --run-task preview --output json
 
-# 回收区治理
-wecom-cleaner --recycle-maintain --output json
+# 回收区治理（真实执行 + 复核）
+wecom-cleaner --recycle-maintain --run-task preview-execute-verify --yes --output json
 
 # 系统自检
 wecom-cleaner --doctor --output json
@@ -103,7 +118,7 @@ wecom-cleaner --check-update --output json
 
 # 程序升级（必须带 --upgrade-yes）
 wecom-cleaner --upgrade npm --upgrade-yes --output json
-wecom-cleaner --upgrade github-script --upgrade-version 1.3.0 --upgrade-yes --output json
+wecom-cleaner --upgrade github-script --upgrade-version 1.3.2 --upgrade-yes --output json
 ```
 
 ## 4. 退出码约定

package/skills/wecom-cleaner-agent/scripts/cleanup_monthly_report.sh

@@ -146,20 +146,22 @@ category_label_from_key() {
   esac
 }
 
-PREVIEW_JSON="$(mktemp -t wecom-cleaner-preview.XXXX.json)"
-EXEC_JSON="$(mktemp -t wecom-cleaner-exec.XXXX.json)"
-VERIFY_JSON="$(mktemp -t wecom-cleaner-verify.XXXX.json)"
-PREVIEW_ERR="$(mktemp -t wecom-cleaner-preview.XXXX.err)"
-EXEC_ERR="$(mktemp -t wecom-cleaner-exec.XXXX.err)"
-VERIFY_ERR="$(mktemp -t wecom-cleaner-verify.XXXX.err)"
+RESULT_JSON="$(mktemp -t wecom-cleaner-task.XXXX.json)"
+RESULT_ERR="$(mktemp -t wecom-cleaner-task.XXXX.err)"
+PREVIEW_JSON="$RESULT_JSON"
+EXEC_JSON="$RESULT_JSON"
+RUN_TASK_MODE="preview"
+if [[ "$EXECUTE" == "true" ]]; then
+  RUN_TASK_MODE="preview-execute-verify"
+fi
 
 cleanup_tmp() {
-  rm -f "$PREVIEW_JSON" "$EXEC_JSON" "$VERIFY_JSON" "$PREVIEW_ERR" "$EXEC_ERR" "$VERIFY_ERR"
+  rm -f "$RESULT_JSON" "$RESULT_ERR"
 }
 trap cleanup_tmp EXIT
 
 run_cmd_to_file() {
-  local dry_run="$1"
+  local task_mode="$1"
   local output_file="$2"
   local err_file="$3"
   local cmd_parts=(
@@ -167,7 +169,7 @@ run_cmd_to_file() {
     --cutoff-month "$CUTOFF_MONTH"
     --accounts "$ACCOUNTS"
     --output json
-    --dry-run "$dry_run"
+    --run-task "$task_mode"
   )
   if [[ -n "$ROOT" ]]; then
     cmd_parts+=(--root "$ROOT")
@@ -184,33 +186,30 @@ run_cmd_to_file() {
   if [[ -n "$EXTERNAL_ROOTS_SOURCE" ]]; then
     cmd_parts+=(--external-roots-source "$EXTERNAL_ROOTS_SOURCE")
   fi
-  if [[ "$dry_run" == "false" ]]; then
+  if [[ "$task_mode" == "preview-execute-verify" ]]; then
     cmd_parts+=(--yes)
   fi
   if ! wecom-cleaner "${cmd_parts[@]}" >"$output_file" 2>"$err_file"; then
     local err_head
     err_head="$(head -n 3 "$err_file" 2>/dev/null || true)"
-    echo "执行失败（dry-run=${dry_run}）：${err_head:-未知错误}" >&2
+    echo "执行失败（run-task=${task_mode}）：${err_head:-未知错误}" >&2
     return 1
   fi
 }
 
-run_cmd_to_file true "$PREVIEW_JSON" "$PREVIEW_ERR"
-
-preview_matched="$(jq -r '.summary.matchedTargets // 0' "$PREVIEW_JSON")"
-preview_matched_bytes="$(jq -r '.summary.matchedBytes // 0' "$PREVIEW_JSON")"
-preview_reclaimed="$(jq -r '.summary.reclaimedBytes // 0' "$PREVIEW_JSON")"
-preview_failed="$(jq -r '.summary.failedCount // 0' "$PREVIEW_JSON")"
-scope_accounts="$(jq -r '.summary.accountCount // 0' "$PREVIEW_JSON")"
-scope_months="$(jq -r '.summary.monthCount // 0' "$PREVIEW_JSON")"
-scope_categories="$(jq -r '.summary.categoryCount // 0' "$PREVIEW_JSON")"
-engine="$(jq -r '.meta.engine // "unknown"' "$PREVIEW_JSON")"
-duration_preview="$(jq -r '.meta.durationMs // 0' "$PREVIEW_JSON")"
-warnings_preview="$(jq -r '(.warnings // []) | length' "$PREVIEW_JSON")"
-errors_preview="$(jq -r '(.errors // []) | length' "$PREVIEW_JSON")"
-matched_month_start="$(jq -r '.summary.matchedMonthStart // .data.report.matched.monthRange.from // ""' "$PREVIEW_JSON")"
-matched_month_end="$(jq -r '.summary.matchedMonthEnd // .data.report.matched.monthRange.to // ""' "$PREVIEW_JSON")"
-root_path_count="$(jq -r '.summary.rootPathCount // (.data.report.matched.rootStats // [] | length)' "$PREVIEW_JSON")"
+run_cmd_to_file "$RUN_TASK_MODE" "$RESULT_JSON" "$RESULT_ERR"
+
+preview_matched="$(jq -r '((.data.taskPhases // [] | map(select(.name=="preview"))[0].stats.matchedTargets) // .summary.matchedTargets // 0) | tonumber? // 0' "$RESULT_JSON")"
+preview_matched_bytes="$(jq -r '((.data.taskPhases // [] | map(select(.name=="preview"))[0].stats.matchedBytes) // .summary.matchedBytes // 0) | tonumber? // 0' "$RESULT_JSON")"
+preview_reclaimed="$(jq -r '((.data.taskPhases // [] | map(select(.name=="preview"))[0].stats.reclaimedBytes) // .summary.reclaimedBytes // 0) | tonumber? // 0' "$RESULT_JSON")"
+preview_failed="$(jq -r '((.data.taskPhases // [] | map(select(.name=="preview"))[0].stats.failedCount) // .summary.failedCount // 0) | tonumber? // 0' "$RESULT_JSON")"
+scope_accounts="$(jq -r '.summary.accountCount // 0' "$RESULT_JSON")"
+scope_months="$(jq -r '.summary.monthCount // 0' "$RESULT_JSON")"
+scope_categories="$(jq -r '.summary.categoryCount // 0' "$RESULT_JSON")"
+engine="$(jq -r '.data.engineUsed // .meta.engine // "unknown"' "$RESULT_JSON")"
+matched_month_start="$(jq -r '.summary.matchedMonthStart // .data.report.matched.monthRange.from // ""' "$RESULT_JSON")"
+matched_month_end="$(jq -r '.summary.matchedMonthEnd // .data.report.matched.monthRange.to // ""' "$RESULT_JSON")"
+root_path_count="$(jq -r '.summary.rootPathCount // (.data.report.matched.rootStats // [] | length)' "$RESULT_JSON")"
 
 executed="false"
 execute_success=0
@@ -219,31 +218,16 @@ execute_failed=0
 execute_reclaimed=0
 execute_batch="-"
 verify_matched="$preview_matched"
-duration_exec=0
-duration_verify=0
-warnings_exec=0
-warnings_verify=0
-errors_exec=0
-errors_verify=0
-
-if [[ "$preview_matched" -gt 0 && "$EXECUTE" == "true" ]]; then
-  run_cmd_to_file false "$EXEC_JSON" "$EXEC_ERR"
+execute_phase_status="$(jq -r '.data.taskPhases // [] | map(select(.name=="execute"))[0].status // "missing"' "$RESULT_JSON")"
+if [[ "$execute_phase_status" == "completed" ]]; then
   executed="true"
-  execute_success="$(jq -r '.summary.successCount // 0' "$EXEC_JSON")"
-  execute_skipped="$(jq -r '.summary.skippedCount // 0' "$EXEC_JSON")"
-  execute_failed="$(jq -r '.summary.failedCount // 0' "$EXEC_JSON")"
-  execute_reclaimed="$(jq -r '.summary.reclaimedBytes // 0' "$EXEC_JSON")"
-  execute_batch="$(jq -r '.summary.batchId // "-"' "$EXEC_JSON")"
-  duration_exec="$(jq -r '.meta.durationMs // 0' "$EXEC_JSON")"
-  warnings_exec="$(jq -r '(.warnings // []) | length' "$EXEC_JSON")"
-  errors_exec="$(jq -r '(.errors // []) | length' "$EXEC_JSON")"
-
-  run_cmd_to_file true "$VERIFY_JSON" "$VERIFY_ERR"
-  verify_matched="$(jq -r '.summary.matchedTargets // 0' "$VERIFY_JSON")"
-  duration_verify="$(jq -r '.meta.durationMs // 0' "$VERIFY_JSON")"
-  warnings_verify="$(jq -r '(.warnings // []) | length' "$VERIFY_JSON")"
-  errors_verify="$(jq -r '(.errors // []) | length' "$VERIFY_JSON")"
+  execute_success="$(jq -r '((.data.taskPhases // [] | map(select(.name=="execute" and .status=="completed"))[0].stats.successCount) // .summary.successCount // 0) | tonumber? // 0' "$RESULT_JSON")"
+  execute_skipped="$(jq -r '((.data.taskPhases // [] | map(select(.name=="execute" and .status=="completed"))[0].stats.skippedCount) // .summary.skippedCount // 0) | tonumber? // 0' "$RESULT_JSON")"
+  execute_failed="$(jq -r '((.data.taskPhases // [] | map(select(.name=="execute" and .status=="completed"))[0].stats.failedCount) // .summary.failedCount // 0) | tonumber? // 0' "$RESULT_JSON")"
+  execute_reclaimed="$(jq -r '((.data.taskPhases // [] | map(select(.name=="execute" and .status=="completed"))[0].stats.reclaimedBytes) // .summary.reclaimedBytes // 0) | tonumber? // 0' "$RESULT_JSON")"
+  execute_batch="$(jq -r '((.data.taskPhases // [] | map(select(.name=="execute" and .status=="completed"))[0].stats.batchId) // .summary.batchId // "-")' "$RESULT_JSON")"
 fi
+verify_matched="$(jq -r '((.data.taskPhases // [] | map(select(.name=="verify" and .status=="completed"))[0].stats.matchedTargets) // ((.data.taskPhases // [] | map(select(.name=="preview" and .status=="completed"))[0].stats.matchedTargets) // .summary.matchedTargets // 0)) | tonumber? // 0' "$RESULT_JSON")"
 
 if [[ "$executed" == "true" ]]; then
   conclusion="已完成"
@@ -256,9 +240,9 @@ else
   reason="已完成预演，等待授权执行真实清理。"
 fi
 
-duration_total=$((duration_preview + duration_exec + duration_verify))
-warnings_total=$((warnings_preview + warnings_exec + warnings_verify))
-errors_total=$((errors_preview + errors_exec + errors_verify))
+duration_total="$(jq -r 'if ((.data.taskPhases // []) | length) > 0 then ([.data.taskPhases[] | (.durationMs // 0 | tonumber? // 0)] | add) else (.meta.durationMs // 0 | tonumber? // 0) end' "$RESULT_JSON")"
+warnings_total="$(jq -r 'if ((.data.taskPhases // []) | length) > 0 then ([.data.taskPhases[] | (.warningCount // 0 | tonumber? // 0)] | add) else ((.warnings // []) | length) end' "$RESULT_JSON")"
+errors_total="$(jq -r 'if ((.data.taskPhases // []) | length) > 0 then ([.data.taskPhases[] | (.errorCount // 0 | tonumber? // 0)] | add) else ((.errors // []) | length) end' "$RESULT_JSON")"
 
 selected_categories_human=""
 while IFS= read -r key; do