@mison/wecom-cleaner 1.3.2 → 1.3.3

package/README.md

@@ -96,10 +96,12 @@
 
 - 启动后按“早/午/晚”三时段检查更新（默认开启）。
 - 版本源优先 npmjs，失败自动回退 GitHub Release。
+- 检查更新会同时校验 Agent skills 是否与主程序版本匹配。
 - 交互模式发现新版本时可直接选择升级方式：
   - npm 升级（默认）
   - GitHub 脚本升级
-- 无交互模式仅提示不阻断任务执行。
+- 程序升级完成后默认联动同步 skills，避免“程序已升级但 skills 仍旧版”。
+- 无交互模式可用 `--sync-skills` 单独修复 skills 版本绑定。
 
 ## 能力边界
 
@@ -154,12 +156,16 @@ npx --yes --package=@mison/wecom-cleaner wecom-cleaner-skill install
 - `--target <dir>`：自定义安装目录（默认 `$CODEX_HOME/skills` 或 `~/.codex/skills`）
 - `--force`：覆盖已存在技能目录
 - `--dry-run`：仅预演，不落盘
+- `status` 子命令：检查 skills 与主程序版本是否匹配
+- `sync` 子命令：等价 `install --force`，用于升级 skills
 
 示例：
 
 ```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
+npx --yes --package=@mison/wecom-cleaner wecom-cleaner-skill status --json
+npx --yes --package=@mison/wecom-cleaner wecom-cleaner-skill sync
 ```
 
 GitHub 备选方式（无 npm 包依赖）：
@@ -168,10 +174,10 @@ GitHub 备选方式（无 npm 包依赖）：
 curl -fsSL https://raw.githubusercontent.com/MisonL/wecom-cleaner/main/scripts/install-skill.sh | bash
 ```
 
-若需安装指定版本标签（例如 `v1.3.2`）：
+若需安装指定版本标签（例如 `v1.3.3`）：
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/MisonL/wecom-cleaner/main/scripts/install-skill.sh | bash -s -- --ref v1.3.2
+curl -fsSL https://raw.githubusercontent.com/MisonL/wecom-cleaner/main/scripts/install-skill.sh | bash -s -- --ref v1.3.3
 ```
 
 Agent 侧统一任务入口脚本（位于 `skills/wecom-cleaner-agent/scripts/`）：
@@ -204,6 +210,7 @@ Agent 侧统一任务入口脚本（位于 `skills/wecom-cleaner-agent/scripts/`
 - `--doctor`
 - `--check-update`
 - `--upgrade <npm|github-script>`
+- `--sync-skills`
 
 ### 无交互安全规则
 
@@ -254,7 +261,10 @@ wecom-cleaner --check-update --output text
 wecom-cleaner --upgrade npm --upgrade-yes
 
 # 执行升级（GitHub 托管脚本方式）
-wecom-cleaner --upgrade github-script --upgrade-version 1.3.2 --upgrade-yes
+wecom-cleaner --upgrade github-script --upgrade-version 1.3.3 --upgrade-yes
+
+# 单独同步 skills（修复版本不匹配）
+wecom-cleaner --sync-skills --skill-sync-method npm --dry-run false
 ```
 
 ### 输出与兼容参数
@@ -270,6 +280,9 @@ wecom-cleaner --upgrade github-script --upgrade-version 1.3.2 --upgrade-yes
 - `--upgrade-channel stable|pre`：升级检查通道（稳定版/预发布）。
 - `--upgrade-version <x.y.z>`：指定升级目标版本。
 - `--upgrade-yes`：确认执行升级动作（无此参数将拒绝执行升级）。
+- `--upgrade-sync-skills true|false`：升级后是否联动同步 skills（默认 `true`）。
+- `--skill-sync-method npm|github-script`：skills 同步方式（默认 `npm`）。
+- `--skill-sync-ref <x.y.z>`：skills 同步版本标签（通常与程序版本一致）。
 
 ### 各动作关键统计字段（JSON）
 
@@ -343,7 +356,10 @@ wecom-cleaner --upgrade github-script --upgrade-version 1.3.2 --upgrade-yes
 - `summary.currentVersion` / `latestVersion`
 - `summary.source`：`npm` 或 `github`
 - `summary.channel`：`stable` 或 `pre`
+- `summary.skillsStatus` / `summary.skillsMatched`
+- `summary.skillsInstalledVersion` / `summary.skillsBoundAppVersion`
 - `data.update`：检查详情（含 `errors`、`checkReason`、`checkedAt`）
+- `data.skills`：skills 绑定详情（状态、目录、建议）
 
 #### `upgrade`
 
@@ -352,6 +368,17 @@ wecom-cleaner --upgrade github-script --upgrade-version 1.3.2 --upgrade-yes
 - `summary.targetVersion`：目标版本
 - `summary.status`：升级命令退出码
 - `data.upgrade.command`：实际执行命令
+- `summary.skillSyncStatus` / `summary.skillSyncMethod` / `summary.skillSyncTargetVersion`
+- `summary.skillsStatusBefore` / `summary.skillsStatusAfter`
+- `data.skillSync`：skills 同步命令结果
+
+#### `sync-skills`
+
+- `summary.method`：skills 同步方式（`npm` / `github-script`）
+- `summary.status`：`dry_run` / `synced` / `failed` / `mismatch_after_sync`
+- `summary.skillsStatusBefore` / `summary.skillsStatusAfter`
+- `data.before` / `data.after`：同步前后 skills 绑定详情
+- `data.skillSync`：执行命令与退出码
 
 ### 全局参数
 
@@ -493,7 +520,7 @@ npm run pack:tgz
 npm run pack:release-assets
 
 # 2) 推送主分支与标签
-VERSION="1.3.2"
+VERSION="1.3.3"
 git push origin main
 git tag "v${VERSION}"
 git push origin "v${VERSION}"

package/docs/NON_INTERACTIVE_SPEC.md

@@ -22,6 +22,7 @@
 - `--doctor`
 - `--check-update`
 - `--upgrade <npm|github-script>`
+- `--sync-skills`
 
 若缺少动作或动作冲突，退出码为 `2`。
 
@@ -59,6 +60,7 @@ JSON 顶层字段：
 - `data`：动作明细数据
 - `meta`：元信息（版本、耗时、引擎、时间戳等）
 - `data.userFacingSummary`：统一的用户侧结果摘要（范围 + 结果 + 关键分布）
+  - `scopeNotes`：扫描边界说明（例如是否纳入“文件存储位置”目录、是否因命中为 0 跳过执行）
 - `data.taskPhases`：阶段协议明细（仅在 `--run-task` 时返回）
 - `data.taskCard`：阶段任务卡片（仅在 `--run-task` 时返回）
 - `data.scanDebug`：扫描诊断信息（仅在 `--scan-debug summary|full` 时返回）
@@ -182,12 +184,23 @@ JSON 顶层字段：
 - `hasUpdate`
 - `currentVersion` / `latestVersion`
 - `source`
+- `sourceChain`（来源链路说明：先 npm，必要时自动回退 GitHub）
 - `channel`
 - `skippedByUser`
+- `skillsStatus` / `skillsMatched`
+- `skillsInstalledVersion` / `skillsBoundAppVersion`
 
 `check_update` 的 `data`：
 
 - `update`：更新检查详情（`checkedAt`、`checkReason`、`errors`、`upgradeMethods`）
+- `skills`：skills 版本绑定详情（状态、目录、建议）
+
+说明：
+
+- 当 npm 失败但 GitHub 回退成功时，动作整体仍为成功：
+  - `summary.source=github`
+  - `summary.sourceChain` 会说明“npm 失败后回退”
+  - 失败细节进入 `warnings`，不计入 `errors`
 
 `upgrade` 常见 `summary` 字段：
 
@@ -196,11 +209,31 @@ JSON 顶层字段：
 - `targetVersion`
 - `status`
 - `command`
+- `skillSyncEnabled`
+- `skillSyncMethod`
+- `skillSyncStatus`
+- `skillSyncTargetVersion`
+- `skillsStatusBefore` / `skillsStatusAfter`
 
 `upgrade` 的 `data`：
 
 - `upgrade`：升级执行结果（stdout/stderr/exit status）
 - `update`：升级前检查结果（若有）
+- `skills`：升级前后 skills 绑定状态
+- `skillSync`：skills 同步执行结果
+
+`sync_skills` 常见 `summary` 字段：
+
+- `method`：同步方式（`npm` / `github-script`）
+- `dryRun`：是否预演
+- `status`：`dry_run` / `synced` / `failed` / `mismatch_after_sync`
+- `skillsStatusBefore` / `skillsStatusAfter`
+- `skillsMatchedAfter`
+
+`sync_skills` 的 `data`：
+
+- `before` / `after`：同步前后 skills 绑定详情
+- `skillSync`：执行命令与退出码
 
 ## 5. 退出码
 
@@ -224,6 +257,9 @@ JSON 顶层字段：
 - `--upgrade-channel <stable|pre>`：更新通道（稳定版/预发布）
 - `--upgrade-version <x.y.z>`：升级到指定版本
 - `--upgrade-yes`：确认执行升级（无此参数将拒绝执行升级）
+- `--upgrade-sync-skills <true|false>`：升级后是否联动同步 skills（默认 `true`）
+- `--skill-sync-method <npm|github-script>`：skills 同步方式
+- `--skill-sync-ref <x.y.z>`：skills 同步版本标签
 - `--run-task preview|execute|preview-execute-verify`：无交互阶段协议
 - `--scan-debug off|summary|full`：扫描诊断输出等级
 
@@ -296,6 +332,18 @@ JSON 顶层字段：
 
 - `npm`：执行 `npm i -g @mison/wecom-cleaner@<version>`
 - `github-script`：执行 GitHub 托管脚本 `scripts/upgrade.sh`
+- 默认会联动同步 skills，可通过 `--upgrade-sync-skills false` 关闭。
+
+### 7.9 `--sync-skills`
+
+- `--skill-sync-method <npm|github-script>`（可选，默认 `npm`）
+- `--skill-sync-ref <x.y.z>`（可选）
+- `--dry-run <true|false>`（可选，默认 `false`）
+
+说明：
+
+- 用于单独修复/升级 Agent skills 版本绑定。
+- `npm` 方式优先使用本地随包 skills；`github-script` 方式按指定版本标签下载。
 
 ## 8. 兼容参数
 

package/docs/TEST_MATRIX.md

@@ -26,6 +26,7 @@
 - `doctor`
 - `check_update`
 - `upgrade`
+- `sync_skills`
 
 ### 维度 C：范围组合
 
@@ -102,13 +103,15 @@
 8. `doctor`：只读模式不创建状态目录
 9. `check_update`：npm 正常 / npm 失败回退 GitHub / 全部失败
 10. `upgrade`：未确认拒绝、已是最新不执行、执行失败可返回非 0
-11. Agent 报告脚本：成功、无目标、失败三态退出码与卡片完整性
+11. `sync_skills`：预演/真实同步、版本匹配状态收敛
+12. Agent 报告脚本：成功、无目标、失败三态退出码与卡片完整性
 
 ## 当前门禁（执行顺序）
 
 1. `npm run check`
-2. `npm run test:coverage:check`
-3. `shellcheck skills/wecom-cleaner-agent/scripts/*.sh scripts/upgrade.sh scripts/install-skill.sh scripts/release-gate.sh`
-4. `npm run e2e:smoke`
+2. `npm run check:skills-version`
+3. `npm run test:coverage:check`
+4. `shellcheck skills/wecom-cleaner-agent/scripts/*.sh scripts/upgrade.sh scripts/install-skill.sh scripts/release-gate.sh`
+5. `npm run e2e:smoke`
 
 说明：若新增动作/字段，需先补此文档矩阵与断言，再提交实现。

package/docs/releases/v1.3.3.md

@@ -0,0 +1,32 @@
+# v1.3.3
+
+发布日期：2026-02-27
+
+## 重点更新
+
+- 新增 skills 版本绑定元数据：`skills/wecom-cleaner-agent/version.json`，将 skills 版本与主程序版本显式绑定。
+- 新增无交互动作 `--sync-skills`，支持独立同步 Agent skills（`npm` / `github-script`）。
+- 新增 `wecom-cleaner-skill status` / `wecom-cleaner-skill sync`，用于检测和修复版本不匹配。
+- 新增 skills 版本门禁：`scripts/check-skills-version.js`，并接入 `npm run check:skills-version` 与 `release:gate`。
+
+## 升级链路改进
+
+- `--check-update` 输出新增 skills 匹配状态与版本字段（`skillsStatus`、`skillsMatched` 等）。
+- `--upgrade` 默认联动同步 skills，并返回同步状态、同步方式与前后匹配状态。
+- 交互模式“检查更新与升级”支持直接触发 skills 同步；头部增加 skills 状态徽章。
+- `scripts/upgrade.sh` 默认升级后同步 skills，可通过 `--sync-skills false` 关闭。
+
+## 发布与资产
+
+- release 资产打包新增 skills 独立附件：`wecom-cleaner-skill-vX.Y.Z.tar.gz`。
+- SHA256 清单命名统一为：`wecom-cleaner-vX.Y.Z-SHA256SUMS.txt`。
+- `scripts/install-skill.sh` 安装完成后输出 skills 版本与绑定版本，便于核验。
+
+## Agent 技能适配
+
+- `wecom-cleaner-agent` 的 `check_update_report` / `upgrade_report` / `doctor_report` 已适配 skills 版本状态与同步反馈。
+- `SKILL.md` 与命令参考文档已同步更新。
+
+## 稳定性结论
+
+- 已通过：`npm run format:check`、`npm run check`、`npm run check:skills-version`、`npm test`（116/116）。

package/native/manifest.json

@@ -1,16 +1,16 @@
 {
   "schemaVersion": 1,
-  "version": "1.3.2",
+  "version": "1.3.3",
   "targets": {
     "darwin-x64": {
       "binaryName": "wecom-cleaner-core",
-      "sha256": "7cb303935b713397012e88431238fa3b44e416ba1ceb0b1a96f354f3c818108c",
-      "url": "https://github.com/MisonL/wecom-cleaner/releases/download/v1.3.2/wecom-cleaner-core-v1.3.2-darwin-x64"
+      "sha256": "e803a1d480895f3edc2350151611a20390ae01401c179aa3f58b5773fed011a8",
+      "url": "https://github.com/MisonL/wecom-cleaner/releases/download/v1.3.3/wecom-cleaner-core-v1.3.3-darwin-x64"
     },
     "darwin-arm64": {
       "binaryName": "wecom-cleaner-core",
-      "sha256": "93a33ae854e2dc7778865e3d59c048ba8f3d3ff3e3f3d19ec0906c316c18e503",
-      "url": "https://github.com/MisonL/wecom-cleaner/releases/download/v1.3.2/wecom-cleaner-core-v1.3.2-darwin-arm64"
+      "sha256": "0bee4994c39ec66690a1effa2acc4178a581567750577c5caa9ba4e495dd3b1d",
+      "url": "https://github.com/MisonL/wecom-cleaner/releases/download/v1.3.3/wecom-cleaner-core-v1.3.3-darwin-arm64"
     }
   }
 }

package/native/zig/src/version.zig

@@ -1 +1 @@
-pub const APP_VERSION = "1.3.2";
+pub const APP_VERSION = "1.3.3";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mison/wecom-cleaner",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "企业微信本地聊天缓存清理工具（交互式 CLI/TUI）",
   "author": "MisonL",
   "license": "MIT",
@@ -42,6 +42,7 @@
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "check": "node --check src/*.js",
+    "check:skills-version": "node scripts/check-skills-version.js",
     "e2e:smoke": "bash scripts/e2e-smoke.sh",
     "release:gate": "bash scripts/release-gate.sh",
     "prepack": "npm run build:native:release && npm run check",

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

@@ -32,6 +32,7 @@ description: 用于执行和编排 wecom-cleaner 的无交互 Agent 技能。当
 - 系统自检：`scripts/doctor_report.sh`
 - 检查更新：`scripts/check_update_report.sh`
 - 程序升级：`scripts/upgrade_report.sh`
+- skills 同步：回退到 `wecom-cleaner --sync-skills --output json`
 
 调用顺序：
 

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，并在破坏性动作中使用 --run-task（preview 或 preview-execute-verify）读取 data.taskCard/taskPhases。'
+  default_prompt: '请使用 $wecom-cleaner-agent 执行任务：按用户意图自动选择 scripts/ 下对应报告脚本（cleanup/analysis/space/restore/recycle/doctor/check-update/upgrade），需要 skills 同步时回退 wecom-cleaner --sync-skills --output json；优先输出中文用户任务卡片；仅在脚本不可用时回退 wecom-cleaner --output json，并在破坏性动作中使用 --run-task（preview 或 preview-execute-verify）读取 data.taskCard/taskPhases。'
   brand_color: '#0EA5E9'

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

@@ -63,7 +63,20 @@ 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.2 --execute true
+bash scripts/upgrade_report.sh --method github-script --version 1.3.3 --execute true
+```
+
+### 1.9 同步 Agent Skills
+
+```bash
+# 预演同步（不落盘）
+wecom-cleaner --sync-skills --dry-run true --output json
+
+# 真实同步（默认 npm）
+wecom-cleaner --sync-skills --skill-sync-method npm --dry-run false --output json
+
+# 按 GitHub 版本标签同步
+wecom-cleaner --sync-skills --skill-sync-method github-script --skill-sync-ref 1.3.3 --dry-run false --output json
 ```
 
 ## 2. 常用全局参数
@@ -118,7 +131,10 @@ 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.2 --upgrade-yes --output json
+wecom-cleaner --upgrade github-script --upgrade-version 1.3.3 --upgrade-yes --output json
+
+# 同步 skills（独立动作）
+wecom-cleaner --sync-skills --skill-sync-method npm --output json
 ```
 
 ## 4. 退出码约定
@@ -137,3 +153,8 @@ wecom-cleaner --upgrade github-script --upgrade-version 1.3.2 --upgrade-yes --ou
 3. 核心统计（命中、预计/实际释放、成功/跳过/失败、批次号）
 4. 分布明细（按类别/月份/路径）
 5. 安全状态（耗时、引擎、告警、错误）
+
+实现建议（统一体验）：
+
+- 优先消费 `data.userFacingSummary`，并优先展示其中 `scopeNotes`（扫描边界说明）。
+- 对 `check-update` 动作，优先展示 `summary.sourceChain`，明确“npm -> GitHub 回退”链路。

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

@@ -85,6 +85,11 @@ latest_version="$(jq -r '.summary.latestVersion // "-"' "$REPORT_JSON")"
 source_used="$(jq -r '.summary.source // "none"' "$REPORT_JSON")"
 channel_used="$(jq -r '.summary.channel // "stable"' "$REPORT_JSON")"
 skipped_by_user="$(jq -r '.summary.skippedByUser // false' "$REPORT_JSON")"
+skills_status="$(jq -r '.summary.skillsStatus // (.data.skills.status // "unknown")' "$REPORT_JSON")"
+skills_matched="$(jq -r '.summary.skillsMatched // (.data.skills.matched // false)' "$REPORT_JSON")"
+skills_version="$(jq -r '.summary.skillsInstalledVersion // (.data.skills.installedSkillVersion // "-")' "$REPORT_JSON")"
+skills_bound_version="$(jq -r '.summary.skillsBoundAppVersion // (.data.skills.installedRequiredAppVersion // "-")' "$REPORT_JSON")"
+skills_target_dir="$(jq -r '.data.skills.targetSkillDir // "-"' "$REPORT_JSON")"
 duration_ms="$(jq -r '.meta.durationMs // 0' "$REPORT_JSON")"
 warnings_count="$(jq -r '(.warnings // []) | length' "$REPORT_JSON")"
 errors_count="$(jq -r '(.errors // []) | length' "$REPORT_JSON")"
@@ -124,11 +129,20 @@ printf -- '- 检查通道：%s\n' "$channel_label"
 printf -- '- 信息来源：%s（先 npm，失败再回退 GitHub）\n' "$source_label"
 printf -- '- 用户跳过提醒：%s\n' "$( [[ "$skipped_by_user" == "true" ]] && printf '是' || printf '否' )"
 
+printf '\nSkills 版本状态\n'
+printf -- '- 匹配状态：%s（%s）\n' "$( [[ "$skills_matched" == "true" ]] && printf '已匹配' || printf '未匹配' )" "$skills_status"
+printf -- '- skills 版本：%s\n' "$skills_version"
+printf -- '- skills 绑定程序版本：%s\n' "$skills_bound_version"
+printf -- '- skills 目录：%s\n' "$skills_target_dir"
+
 if [[ "$has_update" == "true" && "$skipped_by_user" != "true" ]]; then
   printf '\n建议下一步（需你确认后执行）\n'
   printf -- '- 默认升级方式（npm）：wecom-cleaner --upgrade npm --upgrade-version %s --upgrade-yes\n' "$latest_version"
   printf -- '- 备选方式（GitHub 脚本）：wecom-cleaner --upgrade github-script --upgrade-version %s --upgrade-yes\n' "$latest_version"
 fi
+if [[ "$skills_matched" != "true" ]]; then
+  printf -- '- 同步 skills（推荐）：wecom-cleaner --sync-skills --skill-sync-method npm\n'
+fi
 
 printf '\n运行状态\n'
 printf -- '- 耗时：%s ms\n' "$duration_ms"
@@ -139,3 +153,4 @@ printf '\n指标释义\n'
 printf -- '- 当前版本：你本机 wecom-cleaner 版本。\n'
 printf -- '- 最新版本：按所选通道可获取的最新可用版本。\n'
 printf -- '- 用户跳过提醒：表示该版本是否被标记为“暂不提醒”。\n'
+printf -- '- Skills 匹配状态：表示 Agent skills 是否与当前程序版本绑定一致。\n'

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

@@ -72,6 +72,8 @@ account_count="$(jq -r '.data.metrics.accountCount // 0' "$REPORT_JSON")"
 external_count="$(jq -r '.data.metrics.externalStorageCount // 0' "$REPORT_JSON")"
 recycle_batches="$(jq -r '.data.metrics.recycleBatchCount // 0' "$REPORT_JSON")"
 recycle_bytes="$(jq -r '.data.metrics.recycleBytes // 0' "$REPORT_JSON")"
+skills_status="$(jq -r '.data.metrics.skillsStatus // "unknown"' "$REPORT_JSON")"
+skills_matched="$(jq -r '.data.metrics.skillsMatched // false' "$REPORT_JSON")"
 runtime_os="$(jq -r '.data.runtime.os // "-"' "$REPORT_JSON")"
 runtime_arch="$(jq -r '.data.runtime.arch // "-"' "$REPORT_JSON")"
 duration_ms="$(jq -r '.meta.durationMs // 0' "$REPORT_JSON")"
@@ -107,6 +109,7 @@ printf -- '- 运行平台：%s / %s\n' "$runtime_os" "$runtime_arch"
 printf -- '- 识别账号：%s 个\n' "$account_count"
 printf -- '- 外部存储目录：%s 个\n' "$external_count"
 printf -- '- 回收区批次：%s 个，约 %s\n' "$recycle_batches" "$(human_bytes "$recycle_bytes")"
+printf -- '- Skills 绑定：%s（%s）\n' "$skills_status" "$( [[ "$skills_matched" == "true" ]] && printf '已匹配' || printf '未匹配' )"
 
 printf '\n故障项（需要优先处理）\n'
 fail_rows=0

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

@@ -162,6 +162,7 @@ if [[ "$EXECUTE" != "true" ]]; then
   printf -- '- 计划执行命令：%s\n' "${plan_cmd[*]}"
   printf '\n说明\n'
   printf -- '- 如需真实执行，请追加参数：--execute true\n'
+  printf -- '- 真实升级默认会联动同步 skills，避免 Agent 能力与主程序版本不一致。\n'
   printf -- '- 升级会更新本机安装，不会触碰聊天缓存数据。\n'
   exit 0
 fi
@@ -193,6 +194,12 @@ summary_method="$(jq -r '.summary.method // "-"' "$EXEC_JSON")"
 summary_target="$(jq -r '.summary.targetVersion // "-"' "$EXEC_JSON")"
 summary_status="$(jq -r '.summary.status // "-"' "$EXEC_JSON")"
 summary_command="$(jq -r '.summary.command // "-"' "$EXEC_JSON")"
+skill_sync_method="$(jq -r '.summary.skillSyncMethod // "-"' "$EXEC_JSON")"
+skill_sync_status="$(jq -r '.summary.skillSyncStatus // "-"' "$EXEC_JSON")"
+skill_sync_target="$(jq -r '.summary.skillSyncTargetVersion // "-"' "$EXEC_JSON")"
+skill_sync_command="$(jq -r '.data.skillSync.command // "-"' "$EXEC_JSON")"
+skills_status_before="$(jq -r '.summary.skillsStatusBefore // "-"' "$EXEC_JSON")"
+skills_status_after="$(jq -r '.summary.skillsStatusAfter // "-"' "$EXEC_JSON")"
 duration_ms="$(jq -r '.meta.durationMs // 0' "$EXEC_JSON")"
 warnings_count="$(jq -r '(.warnings // []) | length' "$EXEC_JSON")"
 errors_count="$(jq -r '(.errors // []) | length' "$EXEC_JSON")"
@@ -217,6 +224,14 @@ printf -- '- 命令退出码：%s\n' "$summary_status"
 printf -- '- 执行命令：%s\n' "$summary_command"
 printf -- '- 升级后版本：%s\n' "$installed_version"
 
+printf '\nSkills 同步\n'
+printf -- '- 同步方式：%s\n' "$skill_sync_method"
+printf -- '- 同步状态：%s\n' "$skill_sync_status"
+printf -- '- 目标版本：%s\n' "$skill_sync_target"
+printf -- '- 同步命令：%s\n' "$skill_sync_command"
+printf -- '- 同步前状态：%s\n' "$skills_status_before"
+printf -- '- 同步后状态：%s\n' "$skills_status_after"
+
 if [[ "$errors_count" -gt 0 ]]; then
   printf '\n错误摘要\n'
   while IFS= read -r message; do

package/skills/wecom-cleaner-agent/version.json

@@ -0,0 +1,6 @@
+{
+  "schemaVersion": 1,
+  "skillName": "wecom-cleaner-agent",
+  "skillVersion": "1.3.3",
+  "requiredAppVersion": "1.3.3"
+}