@mison/wecom-cleaner 1.0.0 → 1.1.0

package/src/skill-cli.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import { installSkill, resolveDefaultSkillsRoot } from './skill-installer.js';
+
+function printHelp() {
+  console.log(`wecom-cleaner-skill
+
+用法：
+  wecom-cleaner-skill install [--target <目录>] [--force] [--dry-run]
+  wecom-cleaner-skill path
+
+说明：
+  - install: 安装 wecom-cleaner-agent 到 Codex 技能目录
+  - path: 输出默认技能目录（由 CODEX_HOME 或 ~/.codex 推导）
+`);
+}
+
+function parseArgs(argv) {
+  const parsed = {
+    command: 'install',
+    target: '',
+    force: false,
+    dryRun: false,
+    help: false,
+  };
+
+  const tokens = [...argv];
+  const first = tokens[0] || '';
+  if (first && !first.startsWith('-')) {
+    parsed.command = first;
+    tokens.shift();
+  }
+
+  for (let i = 0; i < tokens.length; i += 1) {
+    const token = tokens[i];
+    if (token === '-h' || token === '--help') {
+      parsed.help = true;
+      continue;
+    }
+    if (token === '--force') {
+      parsed.force = true;
+      continue;
+    }
+    if (token === '--dry-run') {
+      parsed.dryRun = true;
+      continue;
+    }
+    if (token === '--target') {
+      const next = tokens[i + 1];
+      if (!next || next.startsWith('-')) {
+        throw new Error('参数 --target 缺少目录值');
+      }
+      parsed.target = next;
+      i += 1;
+      continue;
+    }
+    throw new Error(`未知参数: ${token}`);
+  }
+
+  return parsed;
+}
+
+async function main() {
+  try {
+    const args = parseArgs(process.argv.slice(2));
+
+    if (args.help) {
+      printHelp();
+      return;
+    }
+
+    if (args.command === 'path') {
+      console.log(resolveDefaultSkillsRoot());
+      return;
+    }
+
+    if (args.command !== 'install') {
+      throw new Error(`不支持的命令: ${args.command}`);
+    }
+
+    const result = await installSkill({
+      targetRoot: args.target,
+      force: args.force,
+      dryRun: args.dryRun,
+    });
+
+    const mode = result.dryRun ? '预演' : '安装';
+    const replaceText = result.replaced ? '（覆盖已存在版本）' : '';
+    console.log(`${mode}成功${replaceText}`);
+    console.log(`技能: ${result.skillName}`);
+    console.log(`目标: ${result.targetSkillDir}`);
+  } catch (error) {
+    console.error(`执行失败: ${error.message}`);
+    process.exitCode = 1;
+  }
+}
+
+main();

package/src/skill-installer.js

@@ -0,0 +1,76 @@
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { access, cp, mkdir, rm } from 'node:fs/promises';
+import { constants as fsConstants } from 'node:fs';
+
+export const SKILL_NAME = 'wecom-cleaner-agent';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PROJECT_ROOT = path.resolve(__dirname, '..');
+const DEFAULT_SOURCE_SKILL_DIR = path.join(PROJECT_ROOT, 'skills', SKILL_NAME);
+
+export function resolveDefaultSkillsRoot(env = process.env) {
+  const codexHome = typeof env.CODEX_HOME === 'string' ? env.CODEX_HOME.trim() : '';
+  if (codexHome) {
+    return path.resolve(codexHome, 'skills');
+  }
+  return path.resolve(os.homedir(), '.codex', 'skills');
+}
+
+export function resolveTargetSkillsRoot(rawTarget, env = process.env) {
+  if (typeof rawTarget === 'string' && rawTarget.trim()) {
+    return path.resolve(rawTarget.trim());
+  }
+  return resolveDefaultSkillsRoot(env);
+}
+
+async function exists(targetPath) {
+  try {
+    await access(targetPath, fsConstants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function installSkill(options = {}) {
+  const sourceSkillDir = path.resolve(options.sourceSkillDir || DEFAULT_SOURCE_SKILL_DIR);
+  const targetRoot = resolveTargetSkillsRoot(options.targetRoot);
+  const dryRun = options.dryRun === true;
+  const force = options.force === true;
+
+  const sourceSkillFile = path.join(sourceSkillDir, 'SKILL.md');
+  const sourceExists = await exists(sourceSkillFile);
+  if (!sourceExists) {
+    throw new Error(`技能源目录无效，缺少 SKILL.md: ${sourceSkillDir}`);
+  }
+
+  const targetSkillDir = path.join(targetRoot, SKILL_NAME);
+  const targetExists = await exists(targetSkillDir);
+  if (targetExists && !force) {
+    throw new Error(`目标技能已存在：${targetSkillDir}。如需覆盖请加 --force`);
+  }
+
+  if (!dryRun) {
+    await mkdir(targetRoot, { recursive: true });
+    if (targetExists) {
+      await rm(targetSkillDir, { recursive: true, force: true });
+    }
+    await cp(sourceSkillDir, targetSkillDir, {
+      recursive: true,
+      force: true,
+      preserveTimestamps: true,
+    });
+  }
+
+  return {
+    skillName: SKILL_NAME,
+    sourceSkillDir,
+    targetRoot,
+    targetSkillDir,
+    dryRun,
+    replaced: targetExists,
+  };
+}