@mison/wecom-cleaner 1.0.0

package/native/zig/src/main.zig

@@ -0,0 +1,96 @@
+const std = @import("std");
+
+fn isAbsPath(path: []const u8) bool {
+    return std.fs.path.isAbsolute(path);
+}
+
+fn pathSize(path: []const u8) !u64 {
+    const cwd = std.fs.cwd();
+
+    const file_res = if (isAbsPath(path)) std.fs.openFileAbsolute(path, .{}) else cwd.openFile(path, .{});
+    if (file_res) |file| {
+        defer file.close();
+        const st = try file.stat();
+        return st.size;
+    } else |err| {
+        if (err != error.IsDir) {
+            return err;
+        }
+    }
+
+    var dir = if (isAbsPath(path))
+        try std.fs.openDirAbsolute(path, .{ .iterate = true, .access_sub_paths = true })
+    else
+        try cwd.openDir(path, .{ .iterate = true, .access_sub_paths = true });
+    defer dir.close();
+
+    return dirTreeSize(&dir);
+}
+
+fn dirTreeSize(dir: *std.fs.Dir) !u64 {
+    var total: u64 = 0;
+    var it = dir.iterate();
+
+    while (try it.next()) |entry| {
+        switch (entry.kind) {
+            .file => {
+                const st = dir.statFile(entry.name) catch continue;
+                total += st.size;
+            },
+            .directory => {
+                var sub = dir.openDir(entry.name, .{ .iterate = true, .access_sub_paths = true }) catch continue;
+                defer sub.close();
+                total += dirTreeSize(&sub) catch 0;
+            },
+            .sym_link => {},
+            else => {
+                const st = dir.statFile(entry.name) catch continue;
+                if (st.kind == .file) {
+                    total += st.size;
+                }
+            },
+        }
+    }
+
+    return total;
+}
+
+fn printPing(writer: *std.Io.Writer) !void {
+    try writer.writeAll("{\"ok\":true,\"engine\":\"zig\",\"version\":\"1.0.0\"}\n");
+}
+
+fn runDu(args: []const []const u8, writer: *std.Io.Writer) !void {
+    for (args) |p| {
+        const size = pathSize(p) catch 0;
+        try writer.print("{d}\t{s}\n", .{ size, p });
+    }
+}
+
+pub fn main() !void {
+    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
+    defer _ = gpa.deinit();
+    const allocator = gpa.allocator();
+
+    const args = try std.process.argsAlloc(allocator);
+    defer std.process.argsFree(allocator, args);
+
+    var stdout_buffer: [8192]u8 = undefined;
+    var stdout_writer = std.fs.File.stdout().writer(&stdout_buffer);
+    const writer = &stdout_writer.interface;
+
+    if (args.len >= 2 and std.mem.eql(u8, args[1], "--ping")) {
+        try printPing(writer);
+        try writer.flush();
+        return;
+    }
+
+    if (args.len >= 2 and std.mem.eql(u8, args[1], "du")) {
+        if (args.len == 2) return;
+        try runDu(args[2..], writer);
+        try writer.flush();
+        return;
+    }
+
+    try writer.writeAll("Usage: wecom-cleaner-core --ping | du <path...>\n");
+    try writer.flush();
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@mison/wecom-cleaner",
+  "version": "1.0.0",
+  "description": "企业微信本地聊天缓存清理工具（交互式 CLI/TUI）",
+  "author": "MisonL",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MisonL/wecom-cleaner.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MisonL/wecom-cleaner/issues"
+  },
+  "homepage": "https://github.com/MisonL/wecom-cleaner",
+  "type": "module",
+  "bin": {
+    "wecom-cleaner": "./src/cli.js"
+  },
+  "main": "./src/cli.js",
+  "files": [
+    "src",
+    "native",
+    "README.md",
+    "LICENSE",
+    "docs"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build:native": "./native/zig/build.sh",
+    "build:native:darwin:x64": "TARGET_OS=darwin TARGET_ARCH=x64 ./native/zig/build.sh",
+    "build:native:darwin:arm64": "TARGET_OS=darwin TARGET_ARCH=arm64 ./native/zig/build.sh",
+    "build:native:release": "npm run build:native:darwin:x64 && npm run build:native:darwin:arm64",
+    "start": "node src/cli.js",
+    "dev": "node src/cli.js",
+    "test": "node --test test/*.test.js",
+    "test:coverage": "c8 --reporter=text --reporter=lcov --all --include=src/**/*.js --exclude=src/cli.js node --test test/*.test.js",
+    "test:coverage:check": "c8 --check-coverage --lines 75 --functions 80 --branches 60 --statements 75 --all --include=src/**/*.js --exclude=src/cli.js node --test test/*.test.js",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check": "node --check src/*.js",
+    "e2e:smoke": "bash scripts/e2e-smoke.sh",
+    "prepack": "npm run build:native:release && npm run check",
+    "pack:tgz": "node scripts/pack-tgz.js",
+    "pack:tgz:dry-run": "node scripts/pack-tgz.js --dry-run"
+  },
+  "keywords": [
+    "wecom",
+    "cleaner",
+    "wechat-work",
+    "cache",
+    "tui"
+  ],
+  "dependencies": {
+    "@inquirer/prompts": "^7.8.6"
+  },
+  "devDependencies": {
+    "c8": "^10.1.3",
+    "prettier": "^3.6.2"
+  }
+}

package/src/analysis.js

@@ -0,0 +1,58 @@
+import { formatBytes, renderTable } from './utils.js';
+
+export function printAnalysisSummary(result) {
+  const {
+    totalBytes,
+    targets,
+    accountsSummary,
+    categoriesSummary,
+    monthsSummary,
+    engineUsed,
+    nativeFallbackReason,
+  } = result;
+
+  console.log('能力说明：');
+  console.log('1. 企业微信会话数据库是私有/加密格式，无法稳定解析“会话名->本地文件夹”映射。');
+  console.log('2. 当前模式仅分析可见缓存目录的数据分布，不执行删除。');
+  console.log('3. 目录分析可作为手工清理决策依据。\n');
+
+  console.log(`扫描目录: ${targets.length} 项`);
+  console.log(`总大小  : ${formatBytes(totalBytes)}`);
+  if (engineUsed) {
+    console.log(`扫描引擎: ${engineUsed === 'zig' ? 'Zig核心' : 'Node引擎'}`);
+  }
+  if (nativeFallbackReason) {
+    console.log(`引擎提示: ${nativeFallbackReason}`);
+  }
+
+  if (accountsSummary.length > 0) {
+    const rows = accountsSummary.map((row) => [
+      row.userName,
+      row.corpName,
+      row.shortId,
+      String(row.count),
+      formatBytes(row.sizeBytes),
+    ]);
+    console.log('\n账号维度：');
+    console.log(renderTable(['用户名', '企业名', '短ID', '目录数', '大小'], rows));
+  }
+
+  if (categoriesSummary.length > 0) {
+    const rows = categoriesSummary.map((row) => [
+      row.categoryLabel,
+      row.categoryKey,
+      String(row.count),
+      formatBytes(row.sizeBytes),
+    ]);
+    console.log('\n类型维度：');
+    console.log(renderTable(['类型', 'Key', '目录数', '大小'], rows));
+  }
+
+  if (monthsSummary.length > 0) {
+    const rows = monthsSummary
+      .slice(0, 20)
+      .map((row) => [row.monthKey, String(row.count), formatBytes(row.sizeBytes)]);
+    console.log('\n月份维度（Top 20）：');
+    console.log(renderTable(['月份/目录', '目录数', '大小'], rows));
+  }
+}

package/src/cleanup.js

@@ -0,0 +1,217 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { appendJsonLine, ensureDir, pathExists } from './utils.js';
+import { classifyErrorType, ERROR_TYPES } from './error-taxonomy.js';
+
+function generateBatchId() {
+  const date = new Date();
+  const y = date.getFullYear();
+  const m = String(date.getMonth() + 1).padStart(2, '0');
+  const d = String(date.getDate()).padStart(2, '0');
+  const hh = String(date.getHours()).padStart(2, '0');
+  const mm = String(date.getMinutes()).padStart(2, '0');
+  const ss = String(date.getSeconds()).padStart(2, '0');
+  const rand = crypto.randomBytes(3).toString('hex');
+  return `${y}${m}${d}-${hh}${mm}${ss}-${rand}`;
+}
+
+async function movePath(src, dest) {
+  await ensureDir(path.dirname(dest));
+  try {
+    await fs.rename(src, dest);
+    return;
+  } catch (error) {
+    if (error?.code !== 'EXDEV') {
+      throw error;
+    }
+  }
+
+  await fs.cp(src, dest, { recursive: true, force: true });
+  await fs.rm(src, { recursive: true, force: true });
+}
+
+function escapePathForName(srcPath) {
+  const base = path.basename(srcPath).replace(/[^a-zA-Z0-9._-]/g, '_');
+  return base || 'unknown';
+}
+
+export async function executeCleanup({
+  targets,
+  recycleRoot,
+  indexPath,
+  dryRun,
+  scope = 'cleanup_monthly',
+  shouldSkip,
+  onProgress,
+}) {
+  const batchId = generateBatchId();
+  const batchRoot = dryRun ? null : path.join(recycleRoot, batchId);
+  if (batchRoot) {
+    await ensureDir(batchRoot);
+  }
+
+  const summary = {
+    batchId,
+    dryRun: Boolean(dryRun),
+    successCount: 0,
+    skippedCount: 0,
+    failedCount: 0,
+    reclaimedBytes: 0,
+    errors: [],
+  };
+
+  const total = targets.length;
+
+  for (let i = 0; i < total; i += 1) {
+    const target = targets[i];
+    if (typeof onProgress === 'function') {
+      onProgress(i + 1, total);
+    }
+
+    let skipByPolicy = null;
+    if (typeof shouldSkip === 'function') {
+      skipByPolicy = await shouldSkip(target);
+    }
+    if (typeof skipByPolicy === 'string' && skipByPolicy) {
+      summary.skippedCount += 1;
+      await appendJsonLine(indexPath, {
+        action: 'cleanup',
+        time: Date.now(),
+        scope,
+        batchId,
+        sourcePath: target.path,
+        recyclePath: null,
+        accountId: target.accountId,
+        accountShortId: target.accountShortId,
+        userName: target.userName,
+        corpName: target.corpName,
+        categoryKey: target.categoryKey,
+        categoryLabel: target.categoryLabel,
+        monthKey: target.monthKey,
+        sizeBytes: target.sizeBytes,
+        targetKey: target.targetKey || null,
+        tier: target.tier || null,
+        status: skipByPolicy,
+        error_type: ERROR_TYPES.POLICY_SKIPPED,
+        dryRun: Boolean(dryRun),
+      });
+      continue;
+    }
+
+    const exists = await pathExists(target.path);
+    if (!exists) {
+      summary.skippedCount += 1;
+      await appendJsonLine(indexPath, {
+        action: 'cleanup',
+        time: Date.now(),
+        scope,
+        batchId,
+        sourcePath: target.path,
+        recyclePath: null,
+        accountId: target.accountId,
+        accountShortId: target.accountShortId,
+        userName: target.userName,
+        corpName: target.corpName,
+        categoryKey: target.categoryKey,
+        categoryLabel: target.categoryLabel,
+        monthKey: target.monthKey,
+        sizeBytes: target.sizeBytes,
+        targetKey: target.targetKey || null,
+        tier: target.tier || null,
+        status: 'skipped_missing_source',
+        error_type: ERROR_TYPES.PATH_NOT_FOUND,
+        dryRun: Boolean(dryRun),
+      });
+      continue;
+    }
+
+    if (dryRun) {
+      summary.successCount += 1;
+      summary.reclaimedBytes += target.sizeBytes;
+      await appendJsonLine(indexPath, {
+        action: 'cleanup',
+        time: Date.now(),
+        scope,
+        batchId,
+        sourcePath: target.path,
+        recyclePath: null,
+        accountId: target.accountId,
+        accountShortId: target.accountShortId,
+        userName: target.userName,
+        corpName: target.corpName,
+        categoryKey: target.categoryKey,
+        categoryLabel: target.categoryLabel,
+        monthKey: target.monthKey,
+        sizeBytes: target.sizeBytes,
+        targetKey: target.targetKey || null,
+        tier: target.tier || null,
+        status: 'dry_run',
+        dryRun: true,
+      });
+      continue;
+    }
+
+    const destName = `${String(i + 1).padStart(4, '0')}_${escapePathForName(target.path)}`;
+    const recyclePath = path.join(batchRoot, destName);
+
+    try {
+      await movePath(target.path, recyclePath);
+      summary.successCount += 1;
+      summary.reclaimedBytes += target.sizeBytes;
+
+      const now = Date.now();
+      await appendJsonLine(indexPath, {
+        action: 'cleanup',
+        time: now,
+        scope,
+        batchId,
+        sourcePath: target.path,
+        recyclePath,
+        accountId: target.accountId,
+        accountShortId: target.accountShortId,
+        userName: target.userName,
+        corpName: target.corpName,
+        categoryKey: target.categoryKey,
+        categoryLabel: target.categoryLabel,
+        monthKey: target.monthKey,
+        sizeBytes: target.sizeBytes,
+        targetKey: target.targetKey || null,
+        tier: target.tier || null,
+        status: 'success',
+        dryRun: false,
+      });
+    } catch (error) {
+      summary.failedCount += 1;
+      const message = error instanceof Error ? error.message : String(error);
+      summary.errors.push({
+        path: target.path,
+        message,
+      });
+      await appendJsonLine(indexPath, {
+        action: 'cleanup',
+        time: Date.now(),
+        scope,
+        batchId,
+        sourcePath: target.path,
+        recyclePath,
+        accountId: target.accountId,
+        accountShortId: target.accountShortId,
+        userName: target.userName,
+        corpName: target.corpName,
+        categoryKey: target.categoryKey,
+        categoryLabel: target.categoryLabel,
+        monthKey: target.monthKey,
+        sizeBytes: target.sizeBytes,
+        targetKey: target.targetKey || null,
+        tier: target.tier || null,
+        status: 'failed',
+        error_type: classifyErrorType(message),
+        dryRun: false,
+        error: message,
+      });
+    }
+  }
+
+  return summary;
+}