@mison/wecom-cleaner 1.0.0 → 1.2.0

package/README.md

@@ -23,6 +23,7 @@
 - [功能总览](#功能总览)
 - [能力边界](#能力边界)
 - [安装与运行](#安装与运行)
+- [Agent Skills 安装](#agent-skills-安装)
 - [常用参数](#常用参数)
 - [数据与审计文件](#数据与审计文件)
 - [开发与质量门禁](#开发与质量门禁)
@@ -63,8 +64,8 @@
 2. 文件存储目录识别
 
 - 支持默认路径、手动配置路径、自动探测路径。
-- 自动探测采用结构匹配（如 `*/WXWork Files/Caches`），不依赖目录名。
-- 自动探测结果默认不预选，需用户确认后纳入处理。
+- 自动探测采用“结构 + 缓存特征”联合识别（如 `*/WXWork Files/Caches` + 企业微信缓存类别/月目录信号），不依赖目录名且降低误判。
+- 自动探测结果默认预选，执行前可手动取消；同时保留确认提示，避免误纳入无关目录。
 
 3. 删除与恢复链路
 
@@ -86,9 +87,9 @@
 
 6. 可观测性与并发安全
 
-- `doctor` 模式可输出人类可读报告，或通过 `--json` 输出结构化结果。
+- `doctor` 模式可输出人类可读报告，或通过 `--output json` 输出结构化结果。
 - `doctor` 模式为只读体检：不会自动创建状态目录/回收区，也不会触发 Zig 自动修复下载。
-- 多实例并发默认加锁，检测到陈旧锁可交互清理或通过 `--force` 自动清理。
+- 多实例并发默认加锁；检测到陈旧锁会优先自动恢复，异常场景可用 `--force` 兜底清理。
 
 ## 能力边界
 
@@ -128,32 +129,189 @@ npm run e2e:smoke
 - 覆盖开始菜单与关键分支：年月清理、会话分析、全量治理、回收区治理、恢复、系统自检、设置。
 - 可用 `npm run e2e:smoke -- --keep` 保留日志与测试目录。
 
+## Agent Skills 安装
+
+内置技能：`wecom-cleaner-agent`（用于 Codex/Agent 无交互调用）。
+
+推荐方式（npmjs，最稳定）：
+
+```bash
+npx --yes --package=@mison/wecom-cleaner wecom-cleaner-skill install
+```
+
+常用参数：
+
+- `--target <dir>`：自定义安装目录（默认 `$CODEX_HOME/skills` 或 `~/.codex/skills`）
+- `--force`：覆盖已存在技能目录
+- `--dry-run`：仅预演，不落盘
+
+示例：
+
+```bash
+npx --yes --package=@mison/wecom-cleaner wecom-cleaner-skill install --force
+npx --yes --package=@mison/wecom-cleaner wecom-cleaner-skill install --target ~/.codex/skills
+```
+
+GitHub 备选方式（无 npm 包依赖）：
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/MisonL/wecom-cleaner/main/scripts/install-skill.sh | bash
+```
+
+若需安装指定版本标签（例如 `v1.1.0`）：
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/MisonL/wecom-cleaner/main/scripts/install-skill.sh | bash -s -- --ref v1.1.0
+```
+
+Agent 侧统一任务入口脚本（位于 `skills/wecom-cleaner-agent/scripts/`）：
+
+- `cleanup_monthly_report.sh`：年月清理任务卡片（预演/执行/复核）
+- `analysis_report.sh`：会话分析（只读）任务卡片
+- `space_governance_report.sh`：全量空间治理任务卡片
+- `restore_batch_report.sh`：批次恢复任务卡片
+- `recycle_maintain_report.sh`：回收区治理任务卡片
+- `doctor_report.sh`：系统自检任务卡片
+
 ## 常用参数
 
+运行方式：
+
+- 不带参数：进入交互菜单（TUI）。
+- 带参数：进入无交互执行（默认输出 JSON，适合 AI Agent）。
+- 带参数但需交互：可追加 `--interactive` 强制进入交互流程（支持配合 `--mode` 直达功能）。
+- 完整契约文档：[`docs/NON_INTERACTIVE_SPEC.md`](./docs/NON_INTERACTIVE_SPEC.md)。
+
+### 无交互动作参数（互斥，必须且只能一个）
+
+- `--cleanup-monthly`
+- `--analysis-only`
+- `--space-governance`
+- `--restore-batch <batchId>`
+- `--recycle-maintain`
+- `--doctor`
+
+### 无交互安全规则
+
+- 破坏性动作（清理/治理/恢复/回收区治理）默认 `dry-run`。
+- 显式真实执行需带 `--yes`。
+- 若传 `--dry-run false` 但未传 `--yes`，将直接退出（退出码 `3`）。
+
+### 常用无交互示例
+
 ```bash
-wecom-cleaner --root ~/Library/Containers/com.tencent.WeWorkMac/Data/Documents/Profiles
-wecom-cleaner --state-root ~/.wecom-cleaner-state
-wecom-cleaner --external-storage-root /Volumes/Data/MyWeComStorage
-wecom-cleaner --external-storage-auto-detect false
-wecom-cleaner --dry-run-default true
-wecom-cleaner --mode cleanup_monthly
-wecom-cleaner --mode space_governance
-wecom-cleaner --mode recycle_maintain
-wecom-cleaner --mode doctor
-wecom-cleaner --theme auto
-wecom-cleaner --json
-wecom-cleaner --force
+# 年月清理（默认 dry-run）
+wecom-cleaner --cleanup-monthly \
+  --accounts current \
+  --cutoff-month 2024-02 \
+  --categories files,images
+
+# 年月清理（真实执行）
+wecom-cleaner --cleanup-monthly \
+  --accounts all \
+  --months 2023-01,2023-02 \
+  --categories files \
+  --dry-run false \
+  --yes
+
+# 全量空间治理（仅建议项，真实执行）
+wecom-cleaner --space-governance \
+  --suggested-only true \
+  --tiers safe,caution \
+  --dry-run false \
+  --yes
+
+# 回收区治理（按策略执行）
+wecom-cleaner --recycle-maintain --dry-run false --yes
+
+# 批次恢复（冲突策略：重命名）
+wecom-cleaner --restore-batch 20260226-105009-ffa098 --conflict rename
+
+# 系统自检（默认 JSON 输出）
+wecom-cleaner --doctor
 ```
 
-### `--mode` 可选值
+### 输出与兼容参数
+
+- `--output json|text`：无交互输出格式，默认 `json`。
+- `--json`：兼容别名，等价于 `--output json`。
+- `--mode`：兼容参数，建议迁移到动作参数（如 `--cleanup-monthly`）。
+- `--save-config`：将本次全局配置参数写回 `config.json`。
+- `--help` / `-h`：输出命令帮助并退出。
+- `--version` / `-v`：输出版本号并退出。
+
+### 各动作关键统计字段（JSON）
+
+#### `cleanup-monthly`
+
+- `summary.matchedTargets`：命中目标数
+- `summary.matchedBytes`：命中目标总字节
+- `summary.hasWork` / `summary.noTarget`：是否存在可执行目标
+- `summary.successCount` / `skippedCount` / `failedCount`
+- `summary.reclaimedBytes`：预计或实际释放字节
+- `summary.batchId`：真实执行批次号（dry-run 为预演批次）
+- `summary.matchedMonthStart` / `matchedMonthEnd`：本次命中的月份区间
+- `summary.rootPathCount`：涉及的清理根目录数量
+- `summary.accountCount` / `monthCount` / `categoryCount` / `externalRootCount`
+- `summary.cutoffMonth`：截止月份（当使用 `--cutoff-month` 时）
+
+`cleanup-monthly` 还会在 `data.report` 中返回可展示明细：
+
+- `data.report.matched.categoryStats`：按类别统计（条目数、体积）
+- `data.report.matched.monthStats`：按月份统计（条目数、体积）
+- `data.report.matched.rootStats`：按根目录统计（条目数、体积）
+- `data.report.matched.topPaths`：按体积 Top 路径样例
+- `data.report.executed.byCategory/byMonth/byRoot`：真实执行落地统计（成功/跳过/失败 + 体积）
+
+#### `analysis-only`
 
-- `cleanup_monthly`
-- `analysis_only`
-- `space_governance`
-- `recycle_maintain`
-- `restore`
-- `doctor`
-- `settings`
+- `summary.targetCount` / `totalBytes`：命中目录数与总体积
+- `summary.accountCount` / `matchedAccountCount` / `categoryCount` / `monthBucketCount`：维度汇总（范围账号数 vs 实际命中账号数）
+- `data.accountsSummary` / `categoriesSummary` / `monthsSummary`：分布统计
+- `data.report.matched`：统一的类别/月份/根目录/路径样例统计结构
+
+#### `space-governance`
+
+- `summary.matchedTargets` / `matchedBytes`
+- `summary.successCount` / `skippedCount` / `failedCount` / `reclaimedBytes`
+- `summary.tierCount` / `targetTypeCount` / `rootPathCount`
+- `data.report.matched.byTier/byTargetType/byAccount/byRoot/topPaths`
+- `data.report.executed.byCategory/byMonth/byRoot/topPaths`（真实执行时）
+
+#### `restore-batch`
+
+- `summary.batchId` / `entryCount` / `matchedBytes`
+- `summary.successCount` / `skippedCount` / `failedCount` / `restoredBytes`
+- `summary.scopeCount` / `categoryCount` / `rootPathCount`
+- `data.report.matched.byScope/byCategory/byMonth/byRoot/topEntries`
+- `data.report.executed.byScope/byCategory/byMonth/byRoot/topEntries`（真实执行时）
+
+#### `recycle-maintain`
+
+- `summary.candidateCount` / `selectedByAge` / `selectedBySize`
+- `summary.deletedBatches` / `deletedBytes` / `failedBatches`
+- `summary.remainingBatches` / `remainingBytes`
+- `data.report.before` / `after` / `thresholdBytes` / `overThreshold`
+- `data.report.selectedCandidates` / `operations`
+
+#### `doctor`
+
+- `summary.overall` / `pass` / `warn` / `fail`
+- `data.checks`：逐项体检结论（pass/warn/fail）
+- `data.metrics`：账号数、回收区占用、外部存储等关键指标
+- `data.runtime`：运行时环境信息
+
+### 全局参数
+
+- `--root <path>`：Profile 根目录
+- `--state-root <path>`：状态目录
+- `--external-storage-root <path[,path...]>`：手动文件存储目录（配置层）
+- `--external-storage-auto-detect <true|false>`：外部存储自动探测总开关
+- `--external-roots <path[,path...]>`：本次动作临时覆盖的文件存储目录
+- `--external-roots-source <preset|configured|auto|all>`：按来源筛选探测目录（默认 `all`，优先减少漏扫；可按需收窄）
+- `--theme <auto|light|dark>`：Logo 主题
+- `--interactive`：即使携带参数也进入交互流程（可配合 `--mode`）
+- `--force`：锁异常场景下强制清理并继续（兜底参数，通常无需）
 
 ### `--theme` 可选值
 
@@ -233,10 +391,10 @@ npm run e2e:smoke -- --keep
 npm run pack:tgz:dry-run
 ```
 
-当前基线（`v1.0.0`）：
+当前基线（主分支）：
 
-- 单元测试：`47/47` 通过。
-- 覆盖率：`statements 85.65%`，`branches 70.99%`，`functions 91.39%`，`lines 85.65%`。
+- 单元测试：`78/78` 通过。
+- 覆盖率：`statements 88.28%`，`branches 74.44%`，`functions 94.89%`，`lines 88.28%`。
 - 全菜单 smoke：通过（含恢复冲突分支与 doctor JSON 分支）。
 
 ## 发布与打包
@@ -251,6 +409,8 @@ npm run pack:tgz:dry-run
 - `native/bin/darwin-x64/wecom-cleaner-core`
 - `native/bin/darwin-arm64/wecom-cleaner-core`
 
+说明：`native/bin/` 为构建产物目录，不纳入 Git 版本管理。
+
 本地交付包（无作用域前缀）建议：
 
 ```bash
@@ -268,17 +428,21 @@ npm run test:coverage:check
 npm run format:check
 npm run e2e:smoke
 npm run pack:tgz
+npm run pack:release-assets
 
 # 2) 推送主分支与标签
 git push origin main
-git tag v1.0.0
-git push origin v1.0.0
-
-# 3) 发布 GitHub Release（附 tgz 包）
-gh release create v1.0.0 \
-  --title "v1.0.0" \
-  --notes-file docs/releases/v1.0.0.md \
-  wecom-cleaner-1.0.0.tgz
+git tag v1.2.0
+git push origin v1.2.0
+
+# 3) 发布 GitHub Release（附 npm 包 + 双架构核心附件）
+gh release create v1.2.0 \
+  --title "v1.2.0" \
+  --notes-file docs/releases/v1.2.0.md \
+  wecom-cleaner-1.2.0.tgz \
+  dist/release/wecom-cleaner-core-v1.2.0-darwin-x64 \
+  dist/release/wecom-cleaner-core-v1.2.0-darwin-arm64 \
+  dist/release/wecom-cleaner-core-v1.2.0-SHA256SUMS.txt
 
 # 4) 发布 npm
 npm publish --access public

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.0.0` 基线：`statements 85.65%`，`branches 70.99%`，`functions 91.39%`，`lines 85.65%`。
+- `v1.1.0` 基线：`statements 86.57%`，`branches 73.96%`，`functions 93.25%`，`lines 86.57%`。
 
 4. 端到端回归
 
@@ -138,21 +138,21 @@ npm run e2e:smoke -- --keep
 npm run pack:tgz:dry-run
 ```
 
-## 7. 发布执行（首个正式版）
+## 7. 发布执行（当前版本）
 
 1. 版本与产物
 
-- `package.json` / `package-lock.json`：`1.0.0`
-- `native/manifest.json`：版本与 `baseUrl` 对齐 `v1.0.0`
+- `package.json` / `package-lock.json`：`1.1.0`
+- `native/manifest.json`：版本与 `baseUrl` 对齐 `v1.1.0`
 - 默认打包双架构核心：`darwin-x64` + `darwin-arm64`
 
 2. GitHub Release
 
 ```bash
 git push origin main
-git tag v1.0.0
-git push origin v1.0.0
-gh release create v1.0.0 --title "v1.0.0" --notes-file docs/releases/v1.0.0.md wecom-cleaner-1.0.0.tgz
+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
 ```
 
 3. npm 发布

package/docs/NON_INTERACTIVE_SPEC.md

@@ -0,0 +1,239 @@
+# 无交互参数规范（AI Agent）
+
+本文档定义 `wecom-cleaner` 的无交互 CLI 契约，供 AI Agent/脚本稳定调用。
+
+## 1. 运行入口
+
+- `wecom-cleaner`（不带参数）：进入交互模式（TUI）。
+- `wecom-cleaner ...args`（带参数）：进入无交互模式。
+- `wecom-cleaner ...args --interactive`：即使带参数也强制进入交互模式（常用于本地调试/脚本回放）。
+- `wecom-cleaner --help` / `wecom-cleaner -h`：输出命令帮助并退出（`0`）。
+- `wecom-cleaner --version` / `wecom-cleaner -v`：输出版本号并退出（`0`）。
+
+## 2. 动作选择（必填且互斥）
+
+无交互模式必须且只能提供一个动作参数：
+
+- `--cleanup-monthly`
+- `--analysis-only`
+- `--space-governance`
+- `--restore-batch <batchId>`
+- `--recycle-maintain`
+- `--doctor`
+
+若缺少动作或动作冲突，退出码为 `2`。
+
+## 3. 安全确认与 dry-run
+
+破坏性动作：`cleanup-monthly`、`space-governance`、`restore-batch`、`recycle-maintain`。
+
+规则：
+
+- 默认 `dry-run`（不执行真实删除/恢复）。
+- 真实执行需显式传 `--yes`。
+- 若传 `--dry-run false` 且未传 `--yes`，退出码为 `3`。
+
+## 4. 输出协议
+
+无交互默认输出 JSON，可通过 `--output text` 切换文本任务卡片（中文结论 + 范围 + 统计 + 风险提示）。
+
+- `--output json|text`（默认 `json`）
+- `--json` 为兼容别名（等价 `--output json`）
+
+JSON 顶层字段：
+
+- `ok`：布尔
+- `action`：动作名
+- `dryRun`：布尔或 `null`
+- `summary`：动作摘要
+- `warnings`：字符串数组
+- `errors`：错误数组（`code`、`message`、可选路径字段）
+- `data`：动作明细数据
+- `meta`：元信息（版本、耗时、引擎、时间戳等）
+
+`cleanup_monthly` 常见 `summary` 字段：
+
+- `batchId`
+- `hasWork`
+- `noTarget`
+- `matchedTargets`
+- `matchedBytes`
+- `successCount`
+- `skippedCount`
+- `failedCount`
+- `reclaimedBytes`
+- `accountCount`
+- `monthCount`
+- `categoryCount`
+- `externalRootCount`
+- `cutoffMonth`
+- `matchedMonthStart`
+- `matchedMonthEnd`
+- `rootPathCount`
+
+`cleanup_monthly` 的 `data.report`：
+
+- `matched`：
+  - `totalTargets` / `totalBytes`
+  - `monthRange` / `matchedMonths`
+  - `categoryStats` / `monthStats` / `accountStats` / `rootStats`
+  - `topPaths`（按体积排序）
+- `executed`：
+  - `byStatus`
+  - `byCategory` / `byMonth` / `byRoot`
+  - `topPaths`（按体积排序）
+
+`analysis_only` 常见 `summary` 字段：
+
+- `targetCount`
+- `totalBytes`
+- `accountCount`
+- `matchedAccountCount`
+- `categoryCount`
+- `monthBucketCount`
+
+`analysis_only` 的 `data.report`：
+
+- `matched`：
+  - `totalTargets` / `totalBytes`
+  - `monthRange` / `matchedMonths`
+  - `categoryStats` / `monthStats` / `accountStats` / `rootStats`
+  - `topPaths`
+
+`space_governance` 常见 `summary` 字段：
+
+- `matchedTargets` / `matchedBytes`
+- `successCount` / `skippedCount` / `failedCount` / `reclaimedBytes`
+- `tierCount` / `targetTypeCount` / `rootPathCount`
+- `allowRecentActive`
+
+`space_governance` 的 `data.report`：
+
+- `matched`：
+  - `totalTargets` / `totalBytes`
+  - `byTier` / `byTargetType` / `byAccount` / `byRoot`
+  - `topPaths`
+- `executed`：
+  - `byStatus`
+  - `byCategory` / `byMonth` / `byRoot`
+  - `topPaths`
+
+`restore` 常见 `summary` 字段：
+
+- `batchId`
+- `successCount` / `skippedCount` / `failedCount`
+- `restoredBytes`
+- `conflictStrategy`
+- `entryCount` / `matchedBytes`
+- `scopeCount` / `categoryCount` / `rootPathCount`
+
+`restore` 的 `data.report`：
+
+- `matched`：
+  - `totalEntries` / `totalBytes`
+  - `byScope` / `byCategory` / `byMonth` / `byRoot`
+  - `topEntries`
+- `executed`：
+  - `byStatus`
+  - `byScope` / `byCategory` / `byMonth` / `byRoot`
+  - `topEntries`
+
+`recycle_maintain` 常见 `summary` 字段：
+
+- `status`
+- `candidateCount`
+- `selectedByAge` / `selectedBySize`
+- `deletedBatches` / `deletedBytes` / `failedBatches`
+- `remainingBatches` / `remainingBytes`
+
+`recycle_maintain` 的 `data.report`：
+
+- `before` / `after`
+- `thresholdBytes` / `overThreshold`
+- `selectedCandidates`
+- `operations`
+
+`doctor` 常见 `summary` 字段：
+
+- `overall`
+- `pass` / `warn` / `fail`
+
+`doctor` 的 `data`：
+
+- `checks`：体检项列表（pass/warn/fail）
+- `metrics`：关键计数与容量
+- `runtime`：平台与运行时信息
+
+## 5. 退出码
+
+- `0`：执行成功（含 dry-run 成功）
+- `1`：执行失败（业务失败/运行失败）
+- `2`：参数错误或动作契约错误
+- `3`：缺少真实执行确认（`--yes`）
+
+## 6. 全局参数
+
+- `--root <path>`：Profile 根目录
+- `--state-root <path>`：状态目录
+- `--external-storage-root <path[,path...]>`：配置层手动文件存储目录
+- `--external-storage-auto-detect <true|false>`：自动探测开关
+- `--external-roots <path[,path...]>`：动作层临时覆盖文件存储目录
+- `--external-roots-source <preset|configured|auto|all>`：按来源筛选探测目录（默认 `all`）
+- `--theme <auto|light|dark>`
+- `--interactive`：强制交互模式（与无交互动作参数互斥使用时，优先按交互模式执行）
+- `--force`：锁异常场景下强制清理并继续（兜底参数）
+- `--save-config`：把本次全局参数落盘到 `config.json`
+
+## 7. 动作参数
+
+### 7.1 `--cleanup-monthly`
+
+- `--accounts <all|current|id1,id2...>`
+- `--months <YYYY-MM,...>` 或 `--cutoff-month <YYYY-MM>`（二选一）
+- `--categories <all|key1,key2...>`
+- `--include-non-month-dirs <true|false>`
+- `--dry-run <true|false>`
+
+### 7.2 `--analysis-only`
+
+- `--accounts <all|current|id1,id2...>`
+- `--categories <all|key1,key2...>`
+
+说明：
+
+- `analysis-only` 默认按 `external-roots-source=all` 读取外部目录来源（只读动作，避免漏扫）。
+
+### 7.3 `--space-governance`
+
+- `--accounts <all|current|id1,id2...>`
+- `--targets <targetId1,targetId2...>`
+- `--tiers <safe|caution|protected>`
+- `--suggested-only <true|false>`
+- `--allow-recent-active <true|false>`
+- `--dry-run <true|false>`
+
+说明：
+
+- `cleanup-monthly` / `space-governance` 默认 `external-roots-source=all`，优先减少漏扫。
+- 若需更保守范围，可显式设置 `--external-roots-source preset`（仅默认+手动配置来源）。
+
+### 7.4 `--restore-batch <batchId>`
+
+- `--conflict <skip|overwrite|rename>`（默认 `skip`）
+- `--dry-run <true|false>`
+
+### 7.5 `--recycle-maintain`
+
+- `--retention-enabled <true|false>`
+- `--retention-max-age-days <int>`
+- `--retention-min-keep-batches <int>`
+- `--retention-size-threshold-gb <int>`
+- `--dry-run <true|false>`
+
+### 7.6 `--doctor`
+
+- 无动作专属参数；只读执行，返回健康报告。
+
+## 8. 兼容参数
+
+- `--mode`：兼容旧调用，会映射到动作参数并附带 warning，建议迁移。

package/docs/releases/v1.1.0.md

@@ -0,0 +1,36 @@
+# wecom-cleaner v1.1.0
+
+本版本重点是：Agent 可安装技能能力正式内置、无交互调用链路更稳定、发布与验证流程完整收口。
+
+## 新增能力
+
+- 内置 Agent 技能：`skills/wecom-cleaner-agent`
+  - 包含 `SKILL.md`、`agents/openai.yaml`、`references/commands.md`
+- 新增技能安装命令：`wecom-cleaner-skill install`
+  - 支持 `--target`、`--force`、`--dry-run`
+- 新增 GitHub 一键安装脚本：`scripts/install-skill.sh`
+
+## 关键改进
+
+- 无交互协议正式化并文档化：`docs/NON_INTERACTIVE_SPEC.md`
+- 启动行为统一：无参数进交互、带参数走无交互
+- 无交互默认 JSON 输出，兼容 `--json`，并提示 `--mode` 迁移
+- Zig 核心版本统一到 `1.1.0`，manifest 与下载基地址同步到 `v1.1.0`
+
+## 修复与安全
+
+- 修复恢复 `dry-run + overwrite` 分支潜在实删问题
+- 修复回收区治理异常批次路径可能越界的问题
+- `scripts/install-skill.sh` 兼容 `--target` 指向不存在父目录
+- 强化路径白名单 + `realpath` 边界防护与审计落盘
+
+## 质量与验证
+
+- 单元测试：`68/68` 通过
+- 覆盖率：`statements 86.57%`，`branches 73.96%`，`functions 93.25%`，`lines 86.57%`
+- 全菜单 smoke：通过（含恢复冲突分支、doctor JSON、设置菜单）
+
+## 兼容性
+
+- 当前正式支持：macOS（x64 / arm64）
+- Windows 兼容仍在后续版本规划中

package/docs/releases/v1.2.0.md

@@ -0,0 +1,33 @@
+# v1.2.0 发布说明
+
+发布日期：2026-02-26
+
+## 亮点
+
+- 无交互 `--output text` 升级为中文任务卡片：
+  - 任务结论
+  - 处理范围（账号/月份/类别/路径）
+  - 结果统计（命中、释放、成功/跳过/失败、批次）
+  - 分类与月份分布
+  - 风险与运行状态
+- `wecom-cleaner-agent` 升级为“脚本优先”执行模式，新增 6 个报告脚本，面向 Agent 输出更可读。
+- 发布流程支持 GitHub Release 独立双架构核心附件（macOS x64 / arm64）。
+
+## 重要变更
+
+- 非交互 `cleanup-monthly` / `space-governance` 默认外部目录来源改为 `all`（减少漏扫）。
+- 交互模式外部目录默认预选自动探测路径，执行前可取消。
+- `native/bin/` 改为构建产物目录，不再纳入 Git 版本管理。
+
+## 修复
+
+- 修复 Zig 核心对目录体积的误统计问题（此前可能导致容量明显偏小）。
+- 增强清理/恢复/回收区治理结果的分布统计能力，便于用户复核。
+
+## 资产
+
+- npm 包：`wecom-cleaner-1.2.0.tgz`
+- GitHub Release 附件：
+  - `wecom-cleaner-core-v1.2.0-darwin-x64`
+  - `wecom-cleaner-core-v1.2.0-darwin-arm64`
+  - `wecom-cleaner-core-v1.2.0-SHA256SUMS.txt`

package/native/manifest.json

@@ -1,15 +1,16 @@
 {
   "schemaVersion": 1,
-  "version": "1.0.0",
-  "baseUrl": "https://raw.githubusercontent.com/MisonL/wecom-cleaner/v1.0.0/native/bin",
+  "version": "1.2.0",
   "targets": {
     "darwin-x64": {
       "binaryName": "wecom-cleaner-core",
-      "sha256": "14cfa26895101e7b71824e6bb9282f08a38f9dad72d4df2934094eb2ceefbad0"
+      "sha256": "c703a8bdb6df39df776c6a3ab28b3553916d487cf7c38612989566b4ecea34c9",
+      "url": "https://github.com/MisonL/wecom-cleaner/releases/download/v1.2.0/wecom-cleaner-core-v1.2.0-darwin-x64"
     },
     "darwin-arm64": {
       "binaryName": "wecom-cleaner-core",
-      "sha256": "fc33ce3fb44309170da8c2867d11eae552e2e9d3c95b8f0e5a8e8392bb630744"
+      "sha256": "8d0a15efcb70a266e15c752212f15570c006a931681249d6cd41a1c438941f72",
+      "url": "https://github.com/MisonL/wecom-cleaner/releases/download/v1.2.0/wecom-cleaner-core-v1.2.0-darwin-arm64"
     }
   }
 }