@mison/wecom-cleaner 1.2.0 → 1.3.0

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

@@ -0,0 +1,141 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+用法：
+  check_update_report.sh [--channel stable|pre] [--root <path>] [--state-root <path>]
+
+说明：
+  - 执行“检查更新（只读）”，不做任何安装动作。
+  - 输出用户可读任务卡片。
+EOF
+}
+
+if ! command -v jq >/dev/null 2>&1; then
+  echo "错误：缺少 jq，请先安装（brew install jq）。" >&2
+  exit 2
+fi
+
+if ! command -v wecom-cleaner >/dev/null 2>&1; then
+  echo "错误：未找到 wecom-cleaner 命令，请先安装 @mison/wecom-cleaner。" >&2
+  exit 2
+fi
+
+CHANNEL="stable"
+ROOT=""
+STATE_ROOT=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --channel | --upgrade-channel)
+      CHANNEL="${2:-stable}"
+      shift 2
+      ;;
+    --root)
+      ROOT="${2:-}"
+      shift 2
+      ;;
+    --state-root)
+      STATE_ROOT="${2:-}"
+      shift 2
+      ;;
+    -h | --help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "错误：未知参数 $1" >&2
+      usage
+      exit 2
+      ;;
+  esac
+done
+
+case "$CHANNEL" in
+  stable | pre) ;;
+  *)
+    echo "错误：--channel 只能是 stable 或 pre" >&2
+    exit 2
+    ;;
+esac
+
+REPORT_JSON="$(mktemp -t wecom-check-update.XXXX.json)"
+REPORT_ERR="$(mktemp -t wecom-check-update.XXXX.err)"
+trap 'rm -f "$REPORT_JSON" "$REPORT_ERR"' EXIT
+
+cmd=(--check-update --output json --upgrade-channel "$CHANNEL")
+if [[ -n "$ROOT" ]]; then
+  cmd+=(--root "$ROOT")
+fi
+if [[ -n "$STATE_ROOT" ]]; then
+  cmd+=(--state-root "$STATE_ROOT")
+fi
+
+if ! wecom-cleaner "${cmd[@]}" >"$REPORT_JSON" 2>"$REPORT_ERR"; then
+  err_head="$(head -n 3 "$REPORT_ERR" 2>/dev/null || true)"
+  echo "执行失败：${err_head:-未知错误}" >&2
+  exit 1
+fi
+
+checked="$(jq -r '.summary.checked // false' "$REPORT_JSON")"
+has_update="$(jq -r '.summary.hasUpdate // false' "$REPORT_JSON")"
+current_version="$(jq -r '.summary.currentVersion // "-"' "$REPORT_JSON")"
+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")"
+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")"
+
+source_label="$source_used"
+case "$source_used" in
+  npm) source_label="npmjs" ;;
+  github) source_label="GitHub Release" ;;
+  none) source_label="不可用" ;;
+esac
+
+channel_label="稳定版"
+if [[ "$channel_used" == "pre" ]]; then
+  channel_label="预发布"
+fi
+
+if [[ "$checked" != "true" ]]; then
+  conclusion="检查失败，请稍后重试。"
+elif [[ "$has_update" == "true" ]]; then
+  if [[ "$skipped_by_user" == "true" ]]; then
+    conclusion="检测到新版本，但该版本已被设置为跳过提醒。"
+  else
+    conclusion="检测到新版本，可按你确认后升级。"
+  fi
+else
+  conclusion="当前已是最新版本。"
+fi
+
+printf '\n=== 更新检查结果（给用户）===\n'
+printf -- '- 执行结论：%s\n' "$conclusion"
+printf -- '- 本次只做版本检查，不会改动你的数据或本机安装。\n'
+
+printf '\n版本信息\n'
+printf -- '- 当前版本：%s\n' "$current_version"
+printf -- '- 最新版本：%s\n' "$latest_version"
+printf -- '- 检查通道：%s\n' "$channel_label"
+printf -- '- 信息来源：%s（先 npm，失败再回退 GitHub）\n' "$source_label"
+printf -- '- 用户跳过提醒：%s\n' "$( [[ "$skipped_by_user" == "true" ]] && printf '是' || printf '否' )"
+
+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
+
+printf '\n运行状态\n'
+printf -- '- 耗时：%s ms\n' "$duration_ms"
+printf -- '- 告警：%s\n' "$warnings_count"
+printf -- '- 错误：%s\n' "$errors_count"
+
+printf '\n指标释义\n'
+printf -- '- 当前版本：你本机 wecom-cleaner 版本。\n'
+printf -- '- 最新版本：按所选通道可获取的最新可用版本。\n'
+printf -- '- 用户跳过提醒：表示该版本是否被标记为“暂不提醒”。\n'

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

@@ -190,7 +190,7 @@ run_cmd_to_file() {
   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 "执行失败（dry-run=${dry_run}）：${err_head:-未知错误}" >&2
     return 1
   fi
 }
@@ -275,6 +275,7 @@ if [[ -z "$selected_categories_human" ]]; then
 fi
 
 printf '\n=== 清理结果（给用户）===\n'
+printf -- '- 执行结论：%s（%s）\n' "$conclusion" "$reason"
 if [[ "$executed" == "true" ]]; then
   printf -- '- 已完成：已清理 %s 项聊天缓存，释放 %s。\n' "$execute_success" "$(human_bytes "$execute_reclaimed")"
 elif [[ "$preview_matched" -eq 0 ]]; then
@@ -287,6 +288,7 @@ printf -- '- 你的目标：清理 %s 及之前的企业微信聊天缓存。\n'
 printf '\n你关心的范围\n'
 printf -- '- 账号：%s（识别到 %s 个账号）\n' "$account_scope_label" "$scope_accounts"
 printf -- '- 数据类型：%s\n' "$selected_categories_human"
+printf -- '- 筛选月份桶：%s，筛选类别数：%s\n' "$scope_months" "$scope_categories"
 if [[ -n "$matched_month_start" && -n "$matched_month_end" ]]; then
   printf -- '- 实际命中月份：%s ~ %s\n' "$matched_month_start" "$matched_month_end"
 else
@@ -300,6 +302,7 @@ printf -- '- 命中字节：%s（命中目录当前大小）\n' "$(human_bytes "
 printf -- '- 预计释放：%s（预演估算）\n' "$(human_bytes "$preview_reclaimed")"
 if [[ "$executed" == "true" ]]; then
   printf -- '- 实际释放：%s（真实执行结果）\n' "$(human_bytes "$execute_reclaimed")"
+  printf -- '- 执行明细：成功 %s / 跳过 %s / 失败 %s\n' "$execute_success" "$execute_skipped" "$execute_failed"
   printf -- '- 清理批次：%s（可用于恢复）\n' "$execute_batch"
   printf -- '- 复核结果：剩余可清理 %s 项\n' "$verify_matched"
 else
@@ -431,6 +434,13 @@ if [[ "$executed" == "true" ]]; then
   fi
 fi
 
+printf '\n运行状态\n'
+printf -- '- 扫描引擎：%s\n' "$engine"
+printf -- '- 总耗时：%s ms\n' "$duration_total"
+printf -- '- 告警：%s\n' "$warnings_total"
+printf -- '- 错误：%s\n' "$errors_total"
+printf -- '- 预演失败项：%s\n' "$preview_failed"
+
 if [[ "$warnings_total" -gt 0 || "$errors_total" -gt 0 ]]; then
   printf '\n异常与提示\n'
   printf -- '- 告警：%s\n' "$warnings_total"

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

@@ -143,7 +143,7 @@ run_cmd_to_file() {
   fi
   if ! wecom-cleaner "${cmd_parts[@]}" >"$output_file" 2>"$err_file"; then
     err_head="$(head -n 3 "$err_file" 2>/dev/null || true)"
-    echo "执行失败（dry-run=$dry_run）：${err_head:-未知错误}" >&2
+    echo "执行失败（dry-run=${dry_run}）：${err_head:-未知错误}" >&2
     return 1
   fi
 }

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

@@ -145,7 +145,7 @@ run_cmd_to_file() {
   fi
   if ! wecom-cleaner "${cmd_parts[@]}" >"$output_file" 2>"$err_file"; then
     err_head="$(head -n 3 "$err_file" 2>/dev/null || true)"
-    echo "执行失败（dry-run=$dry_run）：${err_head:-未知错误}" >&2
+    echo "执行失败（dry-run=${dry_run}）：${err_head:-未知错误}" >&2
     return 1
   fi
 }

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

@@ -173,7 +173,7 @@ run_cmd_to_file() {
   fi
   if ! wecom-cleaner "${cmd_parts[@]}" >"$output_file" 2>"$err_file"; then
     err_head="$(head -n 3 "$err_file" 2>/dev/null || true)"
-    echo "执行失败（dry-run=$dry_run）：${err_head:-未知错误}" >&2
+    echo "执行失败（dry-run=${dry_run}）：${err_head:-未知错误}" >&2
     return 1
   fi
 }
@@ -241,6 +241,7 @@ warnings_total=$((warnings_preview + warnings_exec + warnings_verify))
 errors_total=$((errors_preview + errors_exec + errors_verify))
 
 printf '\n=== 全量空间治理结果（给用户）===\n'
+printf -- '- 执行结论：%s（%s）\n' "$conclusion" "$reason"
 if [[ "$executed" == "true" ]]; then
   printf -- '- 已完成：已治理 %s 项空间目标，释放 %s。\n' "$execute_success" "$(human_bytes "$execute_reclaimed")"
 elif [[ "$matched_targets" -eq 0 ]]; then
@@ -263,6 +264,7 @@ printf -- '- 命中体积：%s\n' "$(human_bytes "$matched_bytes")"
 printf -- '- 预计释放：%s\n' "$(human_bytes "$preview_reclaimed")"
 if [[ "$executed" == "true" ]]; then
   printf -- '- 实际释放：%s\n' "$(human_bytes "$execute_reclaimed")"
+  printf -- '- 执行明细：成功 %s / 跳过 %s / 失败 %s\n' "$execute_success" "$execute_skipped" "$execute_failed"
   printf -- '- 清理批次：%s（可用于恢复）\n' "$execute_batch"
   printf -- '- 复核结果：剩余可治理 %s 项\n' "$verify_matched"
 else

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

@@ -0,0 +1,240 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+用法：
+  upgrade_report.sh [--method npm|github-script] [--version <x.y.z>] [--channel stable|pre]
+                    [--execute true|false] [--root <path>] [--state-root <path>]
+
+说明：
+  - 默认仅预演（--execute false），不做真实升级。
+  - --execute true 时才会实际执行升级。
+EOF
+}
+
+if ! command -v jq >/dev/null 2>&1; then
+  echo "错误：缺少 jq，请先安装（brew install jq）。" >&2
+  exit 2
+fi
+
+if ! command -v wecom-cleaner >/dev/null 2>&1; then
+  echo "错误：未找到 wecom-cleaner 命令，请先安装 @mison/wecom-cleaner。" >&2
+  exit 2
+fi
+
+METHOD="npm"
+VERSION=""
+CHANNEL="stable"
+EXECUTE="false"
+ROOT=""
+STATE_ROOT=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --method | --upgrade)
+      METHOD="${2:-npm}"
+      shift 2
+      ;;
+    --version | --upgrade-version)
+      VERSION="${2:-}"
+      shift 2
+      ;;
+    --channel | --upgrade-channel)
+      CHANNEL="${2:-stable}"
+      shift 2
+      ;;
+    --execute)
+      EXECUTE="${2:-false}"
+      shift 2
+      ;;
+    --root)
+      ROOT="${2:-}"
+      shift 2
+      ;;
+    --state-root)
+      STATE_ROOT="${2:-}"
+      shift 2
+      ;;
+    -h | --help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "错误：未知参数 $1" >&2
+      usage
+      exit 2
+      ;;
+  esac
+done
+
+case "$METHOD" in
+  npm | github-script) ;;
+  *)
+    echo "错误：--method 只能是 npm 或 github-script" >&2
+    exit 2
+    ;;
+esac
+
+case "$CHANNEL" in
+  stable | pre) ;;
+  *)
+    echo "错误：--channel 只能是 stable 或 pre" >&2
+    exit 2
+    ;;
+esac
+
+case "$EXECUTE" in
+  true | false) ;;
+  *)
+    echo "错误：--execute 只能是 true 或 false" >&2
+    exit 2
+    ;;
+esac
+
+CHECK_JSON="$(mktemp -t wecom-upgrade-check.XXXX.json)"
+CHECK_ERR="$(mktemp -t wecom-upgrade-check.XXXX.err)"
+EXEC_JSON="$(mktemp -t wecom-upgrade-exec.XXXX.json)"
+EXEC_ERR="$(mktemp -t wecom-upgrade-exec.XXXX.err)"
+trap 'rm -f "$CHECK_JSON" "$CHECK_ERR" "$EXEC_JSON" "$EXEC_ERR"' EXIT
+
+check_cmd=(--check-update --output json --upgrade-channel "$CHANNEL")
+if [[ -n "$ROOT" ]]; then
+  check_cmd+=(--root "$ROOT")
+fi
+if [[ -n "$STATE_ROOT" ]]; then
+  check_cmd+=(--state-root "$STATE_ROOT")
+fi
+
+check_ok="true"
+if ! wecom-cleaner "${check_cmd[@]}" >"$CHECK_JSON" 2>"$CHECK_ERR"; then
+  check_ok="false"
+fi
+
+has_update="false"
+current_version="-"
+latest_version="-"
+source_used="none"
+if [[ "$check_ok" == "true" ]]; then
+  has_update="$(jq -r '.summary.hasUpdate // false' "$CHECK_JSON")"
+  current_version="$(jq -r '.summary.currentVersion // "-"' "$CHECK_JSON")"
+  latest_version="$(jq -r '.summary.latestVersion // "-"' "$CHECK_JSON")"
+  source_used="$(jq -r '.summary.source // "none"' "$CHECK_JSON")"
+fi
+
+plan_target="$VERSION"
+if [[ -z "$plan_target" && "$check_ok" == "true" && "$latest_version" != "-" ]]; then
+  plan_target="$latest_version"
+fi
+
+plan_cmd=(wecom-cleaner --upgrade "$METHOD")
+if [[ -n "$plan_target" ]]; then
+  plan_cmd+=(--upgrade-version "$plan_target")
+fi
+plan_cmd+=(--upgrade-channel "$CHANNEL" --upgrade-yes)
+if [[ -n "$ROOT" ]]; then
+  plan_cmd+=(--root "$ROOT")
+fi
+if [[ -n "$STATE_ROOT" ]]; then
+  plan_cmd+=(--state-root "$STATE_ROOT")
+fi
+plan_cmd+=(--output json)
+
+if [[ "$EXECUTE" != "true" ]]; then
+  printf '\n=== 程序升级预演结果（给用户）===\n'
+  if [[ "$check_ok" == "true" ]]; then
+    printf -- '- 执行结论：仅预演，未执行真实升级。\n'
+    if [[ "$has_update" == "true" ]]; then
+      printf -- '- 检查结果：检测到新版本（当前 %s，最新 %s）。\n' "$current_version" "$latest_version"
+    else
+      printf -- '- 检查结果：当前已是最新版本（%s）。\n' "$current_version"
+    fi
+    printf -- '- 信息来源：%s（先 npm，失败再回退 GitHub）。\n' "$source_used"
+  else
+    err_head="$(head -n 3 "$CHECK_ERR" 2>/dev/null || true)"
+    echo "执行失败：${err_head:-未知错误}" >&2
+    printf -- '- 执行结论：更新检查失败，未进入升级预演。\n'
+    printf -- '- 检查结果：%s\n' "${err_head:-未知错误}"
+    exit 1
+  fi
+  printf -- '- 升级方式：%s\n' "$METHOD"
+  printf -- '- 计划目标版本：%s\n' "${plan_target:--}"
+  printf -- '- 计划执行命令：%s\n' "${plan_cmd[*]}"
+  printf '\n说明\n'
+  printf -- '- 如需真实执行，请追加参数：--execute true\n'
+  printf -- '- 升级会更新本机安装，不会触碰聊天缓存数据。\n'
+  exit 0
+fi
+
+upgrade_cmd=(--upgrade "$METHOD" --upgrade-channel "$CHANNEL" --upgrade-yes --output json)
+if [[ -n "$VERSION" ]]; then
+  upgrade_cmd+=(--upgrade-version "$VERSION")
+fi
+if [[ -n "$ROOT" ]]; then
+  upgrade_cmd+=(--root "$ROOT")
+fi
+if [[ -n "$STATE_ROOT" ]]; then
+  upgrade_cmd+=(--state-root "$STATE_ROOT")
+fi
+
+upgrade_ok="true"
+if ! wecom-cleaner "${upgrade_cmd[@]}" >"$EXEC_JSON" 2>"$EXEC_ERR"; then
+  upgrade_ok="false"
+fi
+
+if ! jq -e . >/dev/null 2>&1 <"$EXEC_JSON"; then
+  err_head="$(head -n 3 "$EXEC_ERR" 2>/dev/null || true)"
+  echo "执行失败：${err_head:-未知错误}" >&2
+  exit 1
+fi
+
+summary_executed="$(jq -r '.summary.executed // false' "$EXEC_JSON")"
+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")"
+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")"
+
+installed_version="$(wecom-cleaner --version 2>/dev/null || true)"
+if [[ -z "$installed_version" ]]; then
+  installed_version="-"
+fi
+
+printf '\n=== 程序升级结果（给用户）===\n'
+if [[ "$upgrade_ok" == "true" ]]; then
+  printf -- '- 执行结论：升级流程已完成。\n'
+else
+  printf -- '- 执行结论：升级执行失败，请按错误信息排查。\n'
+fi
+
+printf '\n执行信息\n'
+printf -- '- 升级方式：%s\n' "$summary_method"
+printf -- '- 目标版本：%s\n' "$summary_target"
+printf -- '- 是否执行升级：%s\n' "$( [[ "$summary_executed" == "true" ]] && printf '是' || printf '否' )"
+printf -- '- 命令退出码：%s\n' "$summary_status"
+printf -- '- 执行命令：%s\n' "$summary_command"
+printf -- '- 升级后版本：%s\n' "$installed_version"
+
+if [[ "$errors_count" -gt 0 ]]; then
+  printf '\n错误摘要\n'
+  while IFS= read -r message; do
+    [[ -z "${message:-}" ]] && continue
+    printf -- '- %s\n' "$message"
+  done < <(jq -r '.errors // [] | .[] | .message // ""' "$EXEC_JSON")
+fi
+
+printf '\n运行状态\n'
+printf -- '- 耗时：%s ms\n' "$duration_ms"
+printf -- '- 告警：%s\n' "$warnings_count"
+printf -- '- 错误：%s\n' "$errors_count"
+
+printf '\n指标释义\n'
+printf -- '- 目标版本：本次升级计划安装的版本。\n'
+printf -- '- 升级后版本：命令执行后本机实际返回的版本号。\n'
+printf -- '- 命令退出码：0 表示升级命令执行成功，非 0 表示执行失败。\n'
+
+if [[ "$upgrade_ok" != "true" ]]; then
+  exit 1
+fi