@qilitt-mickey/vue3-temp-skill 1.2.5 → 1.2.7

package/bin/cli.js

@@ -1,659 +1,344 @@
 #!/usr/bin/env node
 
-/**
- * vue3-temp-skill CLI
- *
- * 将 Vue 3 项目开发规范技能安装到指定 AI 工具
- *
- * 用法:
- *   vue3-temp-skill install <target> [options]   安装到指定 AI 工具
- *   vue3-temp-skill update [target] [options]     更新已安装的技能（默认更新全部已安装目标）
- *   vue3-temp-skill uninstall [target] [options]  卸载已安装的技能（默认卸载全部）
- *   vue3-temp-skill list                          查看已安装的目标
- *   vue3-temp-skill --help                        帮助
- *   vue3-temp-skill --version                     版本号
- *
- * 通过 npx / pnpx 使用时自动下载最新版本：
- *   npx @qilitt-mickey/vue3-temp-skill@latest install cursor
- *   npx @qilitt-mickey/vue3-temp-skill@latest update
- */
-
 import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
-import { execFileSync, execSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 
-const HOME = os.homedir();
-// bin/cli.js → 上一级即包根目录
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SKILL_DIR = path.resolve(__dirname, "..");
-const SKILL_NAME = "vue3-temp-skill";
-const TRACK_FILE = path.join(HOME, ".vue3-temp-skill.json");
-// 只复制 AI 运行时真正需要的文件；validate/cli 属作者侧词典维护工具，不随技能分发。
-// design-audit.mjs / check.mjs / apply-final-gate.mjs 必须随包分发：E11 交付完整性 / E12 设计层
-// 累积性（ledger 台账）/ 终态机读凭证（四闸串联，FINAL-GATE: PASS）是落地会话的运行时闸——
-// 缺了它们「只挑主题令牌落地 + 覆盖历史成果 + 以自述结束会话」无法被静态拦截
-// （失效模式：运行时副本缺审计闸时，残缺口变更集会一路绿灯）。
-const RUNTIME_SCRIPT_FILES = ["match.py", "modules.json", "check-landing.mjs"];
-const PKG_VERSION = JSON.parse(fs.readFileSync(path.join(SKILL_DIR, "package.json"), "utf-8")).version;
-
-// ============================================================
-// AI 工具配置
-// ============================================================
-const TARGETS = {
-  cursor: {
-    name: "Cursor",
-    // Cursor 技能目录：个人 ~/.cursor/skills，项目 .cursor/skills
-    dir: (p) => (p ? path.join(p, ".cursor/skills") : path.join(HOME, ".cursor/skills")),
-    type: "skills",
-    // 旧版曾安装到 .cursor/rules/*.mdc，安装/卸载时一并清理
-    legacyRulesFile: (p) =>
-      path.join(p ? path.join(p, ".cursor/rules") : path.join(HOME, ".cursor/rules"), `${SKILL_NAME}.mdc`),
-  },
-  qoder: {
-    name: "Qoder",
-    dir: (p) => (p ? path.join(p, ".qoder/skills") : path.join(HOME, ".qoderworkcn/skills")),
-    type: "skills",
-  },
-  copilot: {
-    name: "GitHub Copilot",
-    // 仅项目级：必须指定 --project，否则相对当前工作目录
-    file: (p) => path.join(p || process.cwd(), ".github/copilot-instructions.md"),
-    type: "merge",
-    projectOnly: true,
-  },
-  windsurf: {
-    name: "Windsurf",
-    dir: (p) => (p ? path.join(p, ".windsurf/rules") : path.join(HOME, ".windsurf/rules")),
-    type: "rules",
-  },
-  gemini: {
-    name: "Gemini CLI",
-    // 仅项目级：必须指定 --project，否则相对当前工作目录
-    file: (p) => path.join(p || process.cwd(), "GEMINI.md"),
-    type: "merge",
-    projectOnly: true,
-  },
-  trae: {
-    name: "Trae",
-    dir: (p) => (p ? path.join(p, ".trae/rules") : path.join(HOME, ".trae/rules")),
-    type: "rules",
-  },
-  claude: {
-    name: "Claude Code",
-    dir: (p) => (p ? path.join(p, ".claude/skills") : path.join(HOME, ".claude/skills")),
-    type: "skills",
-  },
-  universal: {
-    name: "Universal (.agents)",
-    // 全局 → ~/.agents/skills；项目 → <project>/.agents/skills
-    dir: (p) => (p ? path.join(p, ".agents/skills") : path.join(HOME, ".agents/skills")),
-    type: "skills",
-  },
-};
-
-/**
- * 解析安装目标的可读路径（用于日志）
- */
-function resolveTargetPath(targetKey, projectDir) {
-  const cfg = TARGETS[targetKey];
-  if (cfg.type === "merge") return cfg.file(projectDir);
-  if (cfg.type === "rules") return path.join(cfg.dir(projectDir), `${SKILL_NAME}.md`);
-  return path.join(cfg.dir(projectDir), SKILL_NAME);
-}
-
-// ============================================================
-// 样式
-// ============================================================
-const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
-const green = (s) => `\x1b[32m${s}\x1b[0m`;
-const red = (s) => `\x1b[31m${s}\x1b[0m`;
-const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
-const bold = (s) => `\x1b[1m${s}\x1b[0m`;
-const dim = (s) => `\x1b[2m${s}\x1b[0m`;
-
-// ============================================================
-// 工具函数
-// ============================================================
-
-function ensureDir(dir) {
-  fs.mkdirSync(dir, { recursive: true });
-}
-
-/**
- * 复制单个文件
- */
-function copyFile(src, dest) {
-  if (fs.existsSync(src)) {
-    fs.copyFileSync(src, dest);
+const PACKAGE_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+export const SKILL_NAME = "vue3-temp-skill";
+export const RUNTIME_DIRS = ["references", "scripts", "adapters", "mapping"];
+// 保留已有改动：generate-page.mjs 不再分发；作者侧 cli、测试及临时产物不属于运行资源。
+export const RUNTIME_SCRIPT_FILES = ["match.py", "modules.json", "check-landing.mjs", "generate-css.mjs", "verify-render.mjs"];
+const RUNTIME_FILES = ["SKILL.md", "README.md"];
+const MANIFEST = ".skill-install.json";
+const BEGIN = `<!-- begin ${SKILL_NAME} -->`;
+const END = `<!-- end ${SKILL_NAME} -->`;
+const AUTO_DETECT = false;
+
+// 可注入 HOME、包根和 cwd；import 本身不会安装、写记录或退出进程。
+export function createInstaller({ home = os.homedir(), skillDir = PACKAGE_DIR, cwd = process.cwd(), log = console.log } = {}) {
+  home = path.resolve(home);
+  skillDir = path.resolve(skillDir);
+  cwd = path.resolve(cwd);
+  const version = JSON.parse(fs.readFileSync(path.join(skillDir, "package.json"), "utf8")).version;
+  const trackFile = path.join(home, `.${SKILL_NAME}.json`);
+  // 编辑器专属落点只属于安装器，不进入运行技能的协议或编排。
+  const targets = {
+    cursor: { name: "Cursor", type: "skills", dir: ".cursor/skills" },
+    qoder: { name: "Qoder", type: "skills", dir: ".qoder/skills" },
+    copilot: { name: "GitHub Copilot", type: "merge", file: ".github/copilot-instructions.md", projectOnly: true },
+    windsurf: { name: "Windsurf", type: "rules", dir: ".windsurf/rules" },
+    gemini: { name: "Gemini CLI", type: "merge", file: "GEMINI.md", projectOnly: true },
+    trae: { name: "Trae", type: "rules", dir: ".trae/rules" },
+    codebuddy: { name: "CodeBuddy", type: "rules", dir: ".codebuddy/rules" },
+    claude: { name: "Claude Code", type: "skills", dir: ".claude/skills" },
+    universal: { name: "Universal (.agents)", type: "skills", dir: ".agents/skills" },
+  };
+  const stat = (file) => {
+    try { return fs.lstatSync(file); } catch (err) { if (err.code === "ENOENT") return null; throw err; }
+  };
+  const conflict = (file) => { throw new Error(`未管理或类型不符的路径冲突，保留原内容: ${file}`); };
+  function safePath(file) {
+    for (let current = path.resolve(file); ; current = path.dirname(current)) {
+      const info = stat(current);
+      if (info?.isSymbolicLink() || (current !== path.resolve(file) && info && !info.isDirectory())) conflict(current);
+      if (path.dirname(current) === current) break;
+    }
   }
-}
-
-/**
- * 复制目录（仅用于 references/ 等已知安全的小目录）
- * @param {string[]} [skipDirs] 需要排除的子目录名（不随分发，如 fixtures 作者侧回归数据）
- */
-function copyDir(src, dest, skipDirs = []) {
-  ensureDir(dest);
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    if (entry.name.startsWith(".") || entry.isSymbolicLink()) continue;
-    if (entry.isDirectory() && skipDirs.includes(entry.name)) continue;
-    const s = path.join(src, entry.name);
-    const d = path.join(dest, entry.name);
-    if (entry.isDirectory()) copyDir(s, d, skipDirs);
-    else fs.copyFileSync(s, d);
+  function projectPath(value) {
+    if (typeof value !== "string" || !value.trim() || value.startsWith("-")) throw new Error("--project 需要有效目录参数");
+    const dir = path.resolve(cwd, value);
+    safePath(dir);
+    if (!stat(dir)?.isDirectory()) throw new Error(`--project 必须是已存在的目录: ${dir}`);
+    return dir;
   }
-}
-
-function removeDir(dir) {
-  if (!fs.existsSync(dir)) return;
-  try {
-    if (process.platform === "win32") {
-      // Windows: rd /s /q 使用系统 API 删除，不受 Node.js 调用栈限制
-      execSync(`rd /s /q "${dir}"`, { stdio: "ignore" });
-    } else {
-      execSync(`rm -rf "${dir}"`, { stdio: "ignore" });
+  function paths(target, project = null) {
+    const cfg = targets[target];
+    if (!cfg) throw new Error(`未知目标: ${target}`);
+    if (cfg.projectOnly && !project) throw new Error(`${target} 仅支持项目安装，必须指定 --project <dir>`);
+    const root = project ? projectPath(project) : home;
+    const dest = cfg.file ? path.join(root, cfg.file) : path.join(root, cfg.dir, SKILL_NAME + (cfg.type === "rules" ? ".md" : ""));
+    // 文件旁独立资源避免多个编辑器共享生命周期；所有入口都是相对索引文件的路径。
+    const body = cfg.type === "skills" ? dest : path.join(path.dirname(dest), `.${SKILL_NAME}-resources`);
+    return { cfg, dest, body };
+  }
+  const excluded = (name) => name.startsWith(".") || /(?:^__pycache__$|^node_modules$|^fixtures?$|^(?:tmp|temp|coverage|test-results|playwright-report)$|(?:\.test|\.spec)\.|\.(?:tmp|temp|log|pyc|tgz)$|~$)/i.test(name);
+  function runtimeFiles() {
+    const files = new Map();
+    function add(relative) {
+      const source = path.join(skillDir, relative);
+      safePath(source);
+      if (!stat(source)?.isFile()) throw new Error(`运行资源缺失: ${source}`);
+      files.set(relative, fs.readFileSync(source));
     }
-  } catch {
-    // 兜底：尝试 Node.js 原生方法
-    try {
-      fs.rmSync(dir, { recursive: true, force: true });
-    } catch {
-      // 静默失败，目录可能已被删除
+    function walk(relative) {
+      const source = path.join(skillDir, relative);
+      safePath(source);
+      if (!stat(source)?.isDirectory()) throw new Error(`运行资源目录缺失: ${source}`);
+      for (const entry of fs.readdirSync(source, { withFileTypes: true })) {
+        if (excluded(entry.name) || entry.isSymbolicLink()) continue;
+        const child = `${relative}/${entry.name}`;
+        if (entry.isDirectory()) walk(child);
+        else if (entry.isFile()) add(child);
+      }
     }
-  }
-}
-
-/**
- * 读取技能完整内容：SKILL.md + references/*.md
- */
-function readFullSkill() {
-  let content = "";
-
-  const skillMd = path.join(SKILL_DIR, "SKILL.md");
-  if (fs.existsSync(skillMd)) content += fs.readFileSync(skillMd, "utf-8");
-
-  const refsDir = path.join(SKILL_DIR, "references");
-  if (fs.existsSync(refsDir)) {
-    for (const f of fs.readdirSync(refsDir).filter((f) => f.endsWith(".md")).sort()) {
-      content += `\n\n---\n\n${fs.readFileSync(path.join(refsDir, f), "utf-8")}`;
+    for (const file of RUNTIME_FILES) add(file);
+    for (const dir of RUNTIME_DIRS) {
+      if (dir === "scripts") for (const file of RUNTIME_SCRIPT_FILES) add(`scripts/${file}`);
+      else walk(dir);
     }
+    return files;
   }
-  return content;
-}
-
-// ============================================================
-// 安装记录（用于 update / list / uninstall）
-// ============================================================
-
-function readTrack() {
-  try {
-    return JSON.parse(fs.readFileSync(TRACK_FILE, "utf-8"));
-  } catch {
-    return { installed: [], version: "" };
-  }
-}
-
-function writeTrack(data) {
-  fs.writeFileSync(TRACK_FILE, JSON.stringify(data, null, 2), "utf-8");
-}
-
-function recordInstall(targetKey, projectDir) {
-  const track = readTrack();
-  const key = projectDir ? `${targetKey}@${projectDir}` : targetKey;
-  if (!track.installed.includes(key)) {
-    track.installed.push(key);
-  }
-  track.version = PKG_VERSION;
-  track.updatedAt = new Date().toISOString();
-  writeTrack(track);
-}
-
-function recordUninstall(targetKey, projectDir) {
-  const track = readTrack();
-  const key = projectDir ? `${targetKey}@${projectDir}` : targetKey;
-  track.installed = track.installed.filter((k) => k !== key);
-  writeTrack(track);
-}
-
-// ============================================================
-// 安装逻辑
-// ============================================================
-
-/**
- * rules 类型：Windsurf / Trae
- */
-function installRules(targetKey, projectDir) {
-  const cfg = TARGETS[targetKey];
-  const targetDir = cfg.dir(projectDir);
-  ensureDir(targetDir);
-
-  const content = readFullSkill();
-  const file = path.join(targetDir, `${SKILL_NAME}.md`);
-  fs.writeFileSync(file, content, "utf-8");
-}
-
-/**
- * skills 类型：Cursor / Qoder / Claude / Universal
- */
-function installSkills(targetKey, projectDir) {
-  const cfg = TARGETS[targetKey];
-  const targetDir = cfg.dir(projectDir);
-  const dest = path.join(targetDir, SKILL_NAME);
-
-  // 先清理旧版本
-  if (fs.existsSync(dest)) {
-    removeDir(dest);
+  function validRelative(file) {
+    return typeof file === "string" && !file.includes("\\") && !file.includes(":") && !path.posix.isAbsolute(file) &&
+      file.split("/").every((part) => part && part !== "." && part !== "..") &&
+      (RUNTIME_FILES.includes(file) || RUNTIME_DIRS.some((dir) => file.startsWith(`${dir}/`)));
   }
-
-  // 只复制必要文件，不复制整个包目录（避免缓存目录中的无关文件导致递归）
-  ensureDir(dest);
-  copyFile(path.join(SKILL_DIR, "SKILL.md"), path.join(dest, "SKILL.md"));
-  copyFile(path.join(SKILL_DIR, "README.md"), path.join(dest, "README.md"));
-
-  const refsSrc = path.join(SKILL_DIR, "references");
-  if (fs.existsSync(refsSrc)) {
-    copyDir(refsSrc, path.join(dest, "references"));
+  // 无标记旧目录仅在 --force 且每个文件均可与本包核对时认领；旧版本无法核对则提示人工迁移。
+  function ownership(dir, force, source) {
+    safePath(dir);
+    if (!stat(dir)) return { files: [], exists: false };
+    if (!stat(dir).isDirectory()) conflict(dir);
+    const marker = path.join(dir, MANIFEST);
+    safePath(marker);
+    if (stat(marker)) {
+      if (!stat(marker).isFile()) conflict(marker);
+      let data;
+      try { data = JSON.parse(fs.readFileSync(marker, "utf8")); } catch { conflict(marker); }
+      if (data.schema !== 1 || data.skill !== SKILL_NAME || !Array.isArray(data.files) ||
+          !data.files.includes("SKILL.md") || !data.files.every(validRelative) || new Set(data.files).size !== data.files.length) conflict(marker);
+      for (const file of data.files) {
+        const dest = path.join(dir, file);
+        safePath(dest);
+        if (stat(dest) && !stat(dest).isFile()) conflict(dest);
+      }
+      return { files: data.files, exists: true };
+    }
+    if (!force) throw new Error(`未管理的旧目录冲突: ${dir}；仅可用 --force 尝试识别自有资源后迁移`);
+    source ||= runtimeFiles();
+    const files = [];
+    function inspect(relative = "") {
+      for (const entry of fs.readdirSync(path.join(dir, relative), { withFileTypes: true })) {
+        const file = relative ? `${relative}/${entry.name}` : entry.name;
+        const full = path.join(dir, file);
+        if (entry.isSymbolicLink()) conflict(full);
+        if (entry.isDirectory()) {
+          if (![...source.keys()].some((key) => key.startsWith(`${file}/`))) conflict(full);
+          inspect(file);
+        } else if (entry.isFile() && source.has(file) && fs.readFileSync(full).equals(source.get(file))) files.push(file);
+        else conflict(full);
+      }
+    }
+    inspect();
+    if (!files.includes("SKILL.md")) conflict(dir);
+    return { files, exists: true, legacy: true };
   }
-
-  const scriptsSrc = path.join(SKILL_DIR, "scripts");
-  if (fs.existsSync(scriptsSrc)) {
-    const scriptsDest = path.join(dest, "scripts");
-    ensureDir(scriptsDest);
-    for (const file of RUNTIME_SCRIPT_FILES) {
-      copyFile(path.join(scriptsSrc, file), path.join(scriptsDest, file));
+  function blockRange(text) {
+    const start = text.indexOf(BEGIN);
+    const end = text.indexOf(END);
+    if (start === -1 && end === -1) return null;
+    if (start === -1 || end < start || text.indexOf(BEGIN, start + BEGIN.length) !== -1 || text.indexOf(END, end + END.length) !== -1 ||
+        /<!--\s*(?:begin|end)\s+[^>]+-->/.test(text.slice(start + BEGIN.length, end))) {
+      throw new Error(`损坏、重复或嵌套的 ${SKILL_NAME} begin/end 标记；未修改文件`);
     }
+    return [start, end + END.length];
   }
-
-  // 视觉契约落地依赖：mapping/ 三列变量映射表（区域名 ↔ 项目现状对照）
-  const mappingSrc = path.join(SKILL_DIR, "mapping");
-  if (fs.existsSync(mappingSrc)) {
-    copyDir(mappingSrc, path.join(dest, "mapping"));
+  function loader(dest, body) {
+    const entry = `./${path.relative(path.dirname(dest), path.join(body, "SKILL.md")).split(path.sep).join("/")}`;
+    // 分隔空白全部在标记内，卸载可逐字恢复无尾换行的用户说明。
+    return `${BEGIN}\n\n## ${SKILL_NAME}\n\n读取 [技能入口](<${entry}>) 并执行；相对资源和脚本路径以该 SKILL.md 所在目录为基准，不以项目工作目录为基准。\n与其他技能同轮使用时保留各自职责，按入口中的协作顺序执行；不支持技能调用时直接读取入口。\n\n${END}`;
   }
-
-  // Cursor：清理旧版 rules/*.mdc，避免与 skills 重复
-  if (cfg.legacyRulesFile) {
-    const legacy = cfg.legacyRulesFile(projectDir);
-    if (fs.existsSync(legacy)) {
-      try {
-        fs.unlinkSync(legacy);
-      } catch {
-        // 忽略清理失败
-      }
+  function legacyRulesText(body) {
+    let content = fs.readFileSync(path.join(skillDir, "SKILL.md"), "utf8");
+    for (const file of fs.readdirSync(path.join(skillDir, "references")).filter((f) => f.endsWith(".md")).sort()) {
+      content += `\n\n---\n\n${fs.readFileSync(path.join(skillDir, "references", file), "utf8")}`;
     }
+    return `> 技能本体（scripts/adapters/mapping/references）已随附安装至: ${body}\n` +
+      `> 运行施工脚本时一律使用该路径，例如:\n` +
+      `>   node ${body}/scripts/generate-css.mjs --project <项目根>\n` +
+      `>   node ${body}/scripts/check-landing.mjs --project <项目根>\n\n` + content;
   }
-}
-
-/**
- * merge 类型：Copilot / Gemini
- */
-function installMerge(targetKey, projectDir) {
-  const cfg = TARGETS[targetKey];
-  const targetFile = cfg.file(projectDir);
-  ensureDir(path.dirname(targetFile));
-
-  const content = readFullSkill();
-  fs.writeFileSync(targetFile, content, "utf-8");
-}
-
-function installTarget(targetKey, projectDir) {
-  const cfg = TARGETS[targetKey];
-  if (cfg.type === "rules") installRules(targetKey, projectDir);
-  else if (cfg.type === "skills") installSkills(targetKey, projectDir);
-  else if (cfg.type === "merge") installMerge(targetKey, projectDir);
-
-  recordInstall(targetKey, projectDir);
-  return resolveTargetPath(targetKey, projectDir);
-}
-
-// ============================================================
-// 卸载逻辑
-// ============================================================
-
-function uninstallTarget(targetKey, projectDir) {
-  const cfg = TARGETS[targetKey];
-
-  if (cfg.type === "rules") {
-    const targetDir = cfg.dir(projectDir);
-    const file = path.join(targetDir, `${SKILL_NAME}.md`);
-    if (fs.existsSync(file)) fs.unlinkSync(file);
-  } else if (cfg.type === "skills") {
-    const targetDir = cfg.dir(projectDir);
-    const dest = path.join(targetDir, SKILL_NAME);
-    if (fs.existsSync(dest)) removeDir(dest);
-    // 同时清理 Cursor 旧版 rules
-    if (cfg.legacyRulesFile) {
-      const legacy = cfg.legacyRulesFile(projectDir);
-      if (fs.existsSync(legacy)) {
-        try {
-          fs.unlinkSync(legacy);
-        } catch {
-          // 忽略
+  function indexState(cfg, dest, force, source) {
+    safePath(dest);
+    if (!stat(dest)) return { text: "", range: null };
+    if (stat(dest).isDirectory()) {
+      if (!force) throw new Error(`旧目录占用了索引文件: ${dest}；需要 --force 并识别自有资源后迁移`);
+      const directory = ownership(dest, force, source);
+      // 索引目录必须可完整移走；不能先删除受管文件再发现其中还留有用户文件。
+      function check(relative = "") {
+        for (const entry of fs.readdirSync(path.join(dest, relative), { withFileTypes: true })) {
+          const file = relative ? `${relative}/${entry.name}` : entry.name;
+          if (entry.isDirectory() && directory.files.some((owned) => owned.startsWith(`${file}/`))) check(file);
+          else if (!entry.isFile() || (!directory.files.includes(file) && (directory.legacy || file !== MANIFEST))) conflict(path.join(dest, file));
         }
       }
+      check();
+      return { text: "", range: null, directory };
     }
-  } else if (cfg.type === "merge") {
-    const targetFile = cfg.file(projectDir);
-    if (fs.existsSync(targetFile)) fs.unlinkSync(targetFile);
+    if (!stat(dest).isFile()) conflict(dest);
+    const text = fs.readFileSync(dest, "utf8");
+    const range = blockRange(text);
+    if (cfg.type === "rules" && !range) {
+      const legacyBody = path.join(path.dirname(path.dirname(dest)), "skills", SKILL_NAME);
+      if (!force || text !== legacyRulesText(legacyBody)) {
+        throw new Error(`未管理的规则文件冲突: ${dest}；旧版本需 --force 且可识别，否则请人工迁移`);
+      }
+      return { text: "", range: null, legacyBody, legacyOwnership: ownership(legacyBody, force, source) };
+    }
+    return { text, range };
   }
-
-  recordUninstall(targetKey, projectDir);
-}
-
-// ============================================================
-// CLI 命令
-// ============================================================
-
-function showHelp() {
-  console.log(`
-${bold("vue3-temp-skill")} v${PKG_VERSION}
-Vue 3 企业级中后台项目开发规范技能包
-
-${bold("用法:")}
-  vue3-temp-skill <command> [target] [options]
-
-${bold("命令:")}
-  install <target>    安装技能到指定 AI 工具
-  update [target]     更新已安装的技能（默认更新全部已安装目标）
-  uninstall [target]  卸载技能（默认卸载全部已安装目标）
-  list                查看已安装的目标和版本
-
-${bold("目标 (target):")}
-  cursor       → Cursor          ~/.cursor/skills/
-  qoder        → Qoder           ~/.qoderworkcn/skills/
-  copilot      → GitHub Copilot  <项目>/.github/copilot-instructions.md（项目级）
-  windsurf     → Windsurf        ~/.windsurf/rules/
-  gemini       → Gemini CLI      <项目>/GEMINI.md（项目级）
-  trae         → Trae            ~/.trae/rules/
-  claude       → Claude Code     ~/.claude/skills/
-  universal    → 通用标准        ~/.agents/skills/
-  all          → 安装到所有支持的工具
-
-${bold("选项:")}
-  --project <dir>   安装到指定项目目录（默认全局安装到用户主目录）
-  --help, -h        显示帮助
-  --version, -v     显示版本号
-
-${bold("示例:")}
-  ${dim("# 安装到 Cursor（全局技能）")}
-  npx @qilitt-mickey/vue3-temp-skill install cursor
-
-  ${dim("# 安装到所有工具（全局）+ 当前目录的 Copilot/Gemini 项目文件")}
-  npx @qilitt-mickey/vue3-temp-skill install all
-
-  ${dim("# 安装到指定项目（含 .agents / Copilot / Gemini）")}
-  npx @qilitt-mickey/vue3-temp-skill install all --project ./my-app
-
-  ${dim("# 更新所有已安装的目标（搭配 @latest 拉取最新版）")}
-  npx @qilitt-mickey/vue3-temp-skill@latest update
-
-  ${dim("# 查看已安装情况")}
-  npx @qilitt-mickey/vue3-temp-skill list
-`);
-}
-
-function showVersion() {
-  console.log(PKG_VERSION);
-}
-
-function warnProjectOnly(targetKey, projectDir) {
-  const cfg = TARGETS[targetKey];
-  if (cfg.projectOnly && !projectDir) {
-    console.log(
-      yellow(
-        `  ! ${cfg.name} 为项目级配置，已写入当前目录: ${resolveTargetPath(targetKey, null)}`
-      )
-    );
-    console.log(dim(`    建议: vue3-temp-skill install ${targetKey} --project <项目路径>`));
+  function prune(dir, files) {
+    const directories = new Set([dir]);
+    for (const file of files) {
+      for (let parent = path.dirname(path.join(dir, file)); parent !== dir; parent = path.dirname(parent)) directories.add(parent);
+    }
+    for (const directory of [...directories].sort((a, b) => b.length - a.length)) {
+      if (stat(directory)?.isDirectory() && fs.readdirSync(directory).length === 0) fs.rmdirSync(directory);
+    }
   }
-}
-
-function cmdInstall(target, projectDir) {
-  if (!target) {
-    console.error(red("✗ 请指定安装目标，例如: vue3-temp-skill install cursor"));
-    console.error("运行 vue3-temp-skill --help 查看所有支持的目标");
-    process.exit(1);
+  function removeBody(dir, owned) {
+    for (const file of owned.files) if (stat(path.join(dir, file))) fs.unlinkSync(path.join(dir, file));
+    if (!owned.legacy && stat(path.join(dir, MANIFEST))) fs.unlinkSync(path.join(dir, MANIFEST));
+    prune(dir, owned.files);
   }
-
-  if (target === "all") {
-    const total = Object.keys(TARGETS).length;
-    let success = 0;
-    const failed = [];
-    console.log(bold(`\n安装 vue3-temp-skill v${PKG_VERSION} → 全部工具\n`));
-    for (const key of Object.keys(TARGETS)) {
-      try {
-        const dest = installTarget(key, projectDir);
-        success++;
-        console.log(green(`  ✓ ${TARGETS[key].name}`));
-        console.log(dim(`    → ${dest}`));
-        warnProjectOnly(key, projectDir);
-      } catch (err) {
-        failed.push(TARGETS[key].name);
-        console.log(red(`  ✗ ${TARGETS[key].name}: ${err.message}`));
+  function install(target, project, force) {
+    const { cfg, dest, body } = paths(target, project);
+    const source = runtimeFiles();
+    const index = cfg.type === "skills" ? null : indexState(cfg, dest, force, source);
+    const owned = ownership(body, force, source);
+    // 先完成全部冲突检查，不能写完资源后才发现用户索引不允许覆盖。
+    for (const file of source.keys()) {
+      const output = path.join(body, file);
+      safePath(output);
+      if (stat(output) && (!stat(output).isFile() || !owned.files.includes(file))) conflict(output);
+      for (let relative = path.posix.dirname(file); relative !== "."; relative = path.posix.dirname(relative)) {
+        const parent = path.join(body, relative);
+        if (stat(parent) && !owned.files.some((previous) => previous.startsWith(`${relative}/`))) conflict(parent);
       }
     }
-    console.log("");
-    if (failed.length === 0) {
-      console.log(green(`✓ 已安装到全部 ${total} 个工具 (v${PKG_VERSION})`));
-    } else {
-      console.log(yellow(`✓ 安装完成: ${success}/${total} 成功`));
-      console.log(red(`  ✗ 失败: ${failed.join(", ")}`));
+    for (const [file, content] of source) {
+      const output = path.join(body, file);
+      fs.mkdirSync(path.dirname(output), { recursive: true });
+      fs.writeFileSync(output, content);
     }
-  } else if (TARGETS[target]) {
-    try {
-      const dest = installTarget(target, projectDir);
-      console.log(green(`✓ 已安装到 ${TARGETS[target].name} (v${PKG_VERSION})`));
-      console.log(dim(`  → ${dest}`));
-      warnProjectOnly(target, projectDir);
-    } catch (err) {
-      console.error(red(`✗ 安装失败: ${err.message}`));
-      process.exit(1);
+    const stale = owned.files.filter((file) => !source.has(file));
+    for (const file of stale) if (stat(path.join(body, file))) fs.unlinkSync(path.join(body, file));
+    prune(body, stale);
+    fs.writeFileSync(path.join(body, MANIFEST), JSON.stringify({ schema: 1, skill: SKILL_NAME, files: [...source.keys()].sort() }, null, 2) + "\n");
+    if (index) {
+      if (index.directory) removeBody(dest, index.directory);
+      if (index.legacyBody) removeBody(index.legacyBody, index.legacyOwnership);
+      const block = loader(dest, body);
+      const text = index.range ? index.text.slice(0, index.range[0]) + block + index.text.slice(index.range[1]) : index.text + block;
+      fs.mkdirSync(path.dirname(dest), { recursive: true });
+      fs.writeFileSync(dest, text, "utf8");
     }
-  } else {
-    console.error(red(`✗ 未知目标: ${target}`));
-    console.error("运行 vue3-temp-skill --help 查看支持的目标");
-    process.exit(1);
+    return dest;
   }
-}
-
-function cmdUpdate(target, projectDir) {
-  const track = readTrack();
-
-  if (track.installed.length === 0) {
-    console.log(yellow("当前没有已安装的目标，请先运行 install 命令"));
-    process.exit(0);
+  function uninstall(target, project, force) {
+    const { cfg, dest, body } = paths(target, project);
+    const index = cfg.type === "skills" ? null : indexState(cfg, dest, force);
+    const owned = ownership(body, force);
+    if (index?.directory) removeBody(dest, index.directory);
+    else if (index?.range) {
+      const text = index.text.slice(0, index.range[0]) + index.text.slice(index.range[1]);
+      if (!text && cfg.type === "rules") fs.unlinkSync(dest);
+      else fs.writeFileSync(dest, text, "utf8");
+    } else if (index?.legacyBody) fs.unlinkSync(dest);
+    if (index?.legacyBody) removeBody(index.legacyBody, index.legacyOwnership);
+    if (owned.exists) removeBody(body, owned);
+    return dest;
   }
-
-  // 如果指定了目标，只更新该目标
-  if (target) {
-    if (target !== "all" && !TARGETS[target]) {
-      console.error(red(`✗ 未知目标: ${target}`));
-      process.exit(1);
-    }
-    const targets = target === "all" ? Object.keys(TARGETS) : [target];
-    let success = 0;
-    const failed = [];
-    for (const key of targets) {
-      try {
-        installTarget(key, projectDir);
-        success++;
-      } catch (err) {
-        failed.push(TARGETS[key].name);
-      }
-    }
-    if (failed.length === 0) {
-      console.log(green(`✓ 已更新到 v${PKG_VERSION}`));
+  function readTrack() {
+    safePath(trackFile);
+    if (!stat(trackFile)) return [];
+    const data = JSON.parse(fs.readFileSync(trackFile, "utf8"));
+    let entries;
+    if (data.schema === 2 && Array.isArray(data.entries)) entries = data.entries;
+    else if (Array.isArray(data.installed)) {
+      entries = data.installed.map((entry) => {
+        const at = entry.indexOf("@");
+        return { target: at === -1 ? entry : entry.slice(0, at), project: at === -1 ? null : entry.slice(at + 1), version: data.version };
+      });
     } else {
-      console.log(yellow(`✓ 更新完成: ${success}/${targets.length} 成功`));
-      console.log(red(`  ✗ 失败: ${failed.join(", ")}`));
+      entries = Object.entries(data).filter(([key]) => targets[key]).map(([target, value]) => ({ target, project: value.project || null, version: value.version }));
     }
-    return;
+    return entries.filter((entry) => targets[entry.target]).map((entry) => ({ ...entry, project: entry.project ? path.resolve(cwd, entry.project) : null }));
   }
-
-  // 默认更新全部已安装目标
-  let success = 0;
-  const failed = [];
-  for (const entry of track.installed) {
-    const [targetKey, projDir] = entry.includes("@")
-      ? [entry.split("@")[0], entry.split("@").slice(1).join("@")]
-      : [entry, null];
-
-    if (!TARGETS[targetKey]) continue;
-
-    try {
-      installTarget(targetKey, projDir || projectDir);
-      success++;
-    } catch (err) {
-      failed.push(TARGETS[targetKey].name);
+  function writeTrack(entries) {
+    safePath(trackFile);
+    fs.mkdirSync(home, { recursive: true });
+    fs.writeFileSync(trackFile, JSON.stringify({ schema: 2, entries }, null, 2) + "\n");
+  }
+  function parseArgs(argv) {
+    const opts = { positional: [], force: false };
+    for (let i = 0; i < argv.length; i++) {
+      const arg = argv[i];
+      if (arg === "--project") {
+        if (opts.project !== undefined) throw new Error("--project 不可重复");
+        opts.project = projectPath(argv[++i]);
+      } else if (arg === "--force") opts.force = true;
+      else if (arg === "--help" || arg === "-h") opts.help = true;
+      else if (arg === "--version" || arg === "-v") opts.version = true;
+      else if (arg.startsWith("-")) throw new Error(`未知参数: ${arg}`);
+      else opts.positional.push(arg);
     }
+    return opts;
   }
-  if (failed.length === 0) {
-    console.log(green(`✓ 已更新 ${success} 个工具到 v${PKG_VERSION}`));
-  } else {
-    console.log(yellow(`✓ 更新完成: ${success}/${track.installed.length} 成功`));
-    console.log(red(`  ✗ 失败: ${failed.join(", ")}`));
+  function help() {
+    log(`${SKILL_NAME} v${version}\n用法: ${SKILL_NAME} <install|update|uninstall|list> [target|all] [--project <dir>] [--force]\n目标: ${Object.keys(targets).join(", ")}\nCopilot/Gemini 必须指定 --project；批量全局安装跳过项目专属目标。\nQoder 全局目录: ~/.qoder/skills\n--force 仅迁移可识别的自有旧资源，不能覆盖未管理文件。旧 Qoder / Cursor rules 不会被自动删除。`);
   }
-}
-
-function cmdUninstall(target, projectDir) {
-  const track = readTrack();
-
-  if (target) {
-    if (target !== "all" && !TARGETS[target]) {
-      console.error(red(`✗ 未知目标: ${target}`));
-      process.exit(1);
+  function run(argv) {
+    const opts = parseArgs(argv);
+    if (opts.help || (!opts.positional.length && !opts.version)) { help(); return; }
+    if (opts.version) { log(version); return; }
+    let [command, target] = opts.positional;
+    if (targets[command] || command === "all" || (AUTO_DETECT && command === "系统")) {
+      if (target) throw new Error("多余的位置参数");
+      target = command; command = "install";
     }
-    const targets = target === "all" ? Object.keys(TARGETS) : [target];
-    let success = 0;
-    const failed = [];
-    for (const key of targets) {
-      try {
-        uninstallTarget(key, projectDir);
-        success++;
-      } catch (err) {
-        failed.push(TARGETS[key].name);
-      }
+    if (opts.positional.length > 2) throw new Error("多余的位置参数");
+    if (!["install", "update", "uninstall", "list"].includes(command)) throw new Error(`未知命令: ${command}`);
+    if (target === "系统" && AUTO_DETECT) target = "all";
+    if (target && target !== "all" && !targets[target]) throw new Error(`未知目标: ${target}`);
+    if (command === "list") {
+      if (target || opts.project || opts.force) throw new Error("list 不接受目标或安装参数");
+      for (const entry of readTrack()) log(`${entry.target} v${entry.version} ${entry.project || home}`);
+      return;
     }
-    if (target === "all") {
-      if (failed.length === 0) {
-        console.log(green(`✓ 已卸载全部 ${success} 个工具`));
-      } else {
-        console.log(yellow(`✓ 卸载完成: ${success}/${targets.length} 成功`));
-        console.log(red(`  ✗ 失败: ${failed.join(", ")}`));
-      }
+    let track = readTrack();
+    let jobs;
+    if (command === "install") {
+      if (!target && !AUTO_DETECT) throw new Error("请指定安装目标");
+      const keys = target && target !== "all" ? [target] : Object.keys(targets).filter((key) => {
+        const cfg = targets[key];
+        if (cfg.projectOnly) return Boolean(opts.project);
+        return !AUTO_DETECT || Boolean(stat(path.join(opts.project || home, cfg.dir)));
+      });
+      jobs = keys.map((key) => ({ target: key, project: opts.project || null }));
     } else {
-      if (failed.length === 0) {
-        console.log(green(`✓ 已卸载 ${TARGETS[target].name}`));
-      } else {
-        console.error(red(`✗ 卸载失败: ${failed.join(", ")}`));
-      }
+      jobs = track.filter((entry) => !target || target === "all" || entry.target === target);
+      if (opts.project !== undefined) jobs = jobs.map((entry) => ({ ...entry, project: opts.project }));
+      if (target && target !== "all" && (opts.project !== undefined || jobs.length === 0)) jobs = [{ target, project: opts.project || null }];
     }
-    return;
-  }
-
-  // 默认卸载全部
-  if (track.installed.length === 0) {
-    console.log(yellow("当前没有已安装的目标"));
-    return;
-  }
-
-  let success = 0;
-  for (const entry of track.installed) {
-    const [targetKey, projDir] = entry.includes("@")
-      ? [entry.split("@")[0], entry.split("@").slice(1).join("@")]
-      : [entry, null];
-
-    if (TARGETS[targetKey]) {
-      try {
-        uninstallTarget(targetKey, projDir || projectDir);
-        success++;
-      } catch {
-        // 静默
-      }
+    const identity = (entry) => JSON.stringify([entry.target, entry.project]);
+    jobs = [...new Map(jobs.map((entry) => [identity(entry), entry])).values()];
+    // 参数与所有项目根在写入前校验；显式 --project 始终覆盖旧记录的 project。
+    for (const job of jobs) paths(job.target, job.project);
+    if (!jobs.length) { log("未找到需要处理的目标。"); return; }
+    for (const job of jobs) {
+      const dest = command === "uninstall" ? uninstall(job.target, job.project, opts.force) : install(job.target, job.project, opts.force);
+      track = track.filter((entry) => identity(entry) !== identity(job));
+      if (command !== "uninstall") track.push({ target: job.target, project: job.project, version, path: dest });
+      writeTrack(track);
+      log(`${command} ${job.target} → ${dest}`);
     }
   }
-  writeTrack({ installed: [], version: "", updatedAt: "" });
-  console.log(green(`✓ 已卸载全部 ${success} 个工具`));
-}
-
-function cmdList() {
-  const track = readTrack();
-
-  console.log(bold(`\nvue3-temp-skill v${track.version || "未安装"}`));
-  console.log(dim(`记录文件: ${TRACK_FILE}\n`));
-
-  if (track.installed.length === 0) {
-    console.log(yellow("当前没有已安装的目标"));
-    return;
-  }
-
-  console.log(bold("已安装的目标:"));
-  for (const entry of track.installed) {
-    const [targetKey, projDir] = entry.includes("@")
-      ? [entry.split("@")[0], entry.split("@").slice(1).join("@")]
-      : [entry, null];
-
-    const cfg = TARGETS[targetKey];
-    const name = cfg ? cfg.name : targetKey;
-    const scope = projDir ? ` (项目: ${projDir})` : " (全局)";
-    const dest = cfg ? resolveTargetPath(targetKey, projDir) : "";
-    const exists = dest && fs.existsSync(dest);
-    const mark = exists ? green("•") : yellow("!");
-    console.log(`  ${mark} ${name}${scope}`);
-    if (dest) console.log(dim(`    ${dest}${exists ? "" : "  (文件不存在)"}`));
-  }
-
-  if (track.updatedAt) {
-    console.log(dim(`\n最后更新: ${track.updatedAt}`));
-  }
+  return { run, paths, runtimeFiles };
 }
 
-// ============================================================
-// 入口
-// ============================================================
-
-function main() {
-  const args = process.argv.slice(2);
-
-  if (!args.length || args.includes("--help") || args.includes("-h")) {
-    showHelp();
-    process.exit(0);
-  }
-
-  if (args.includes("--version") || args.includes("-v")) {
-    showVersion();
-    process.exit(0);
-  }
-
-  const command = args[0];
-  const target = args[1];
-  const projectIdx = args.indexOf("--project");
-  const projectDir = projectIdx !== -1 ? path.resolve(args[projectIdx + 1]) : null;
-
-  switch (command) {
-    case "install":
-      cmdInstall(target, projectDir);
-      break;
-    case "update":
-      cmdUpdate(target === "--project" ? null : target, projectDir);
-      break;
-    case "uninstall":
-      cmdUninstall(target === "--project" ? null : target, projectDir);
-      break;
-    case "list":
-      cmdList();
-      break;
-    default:
-      // 兼容旧用法：直接传 target 名当作 install
-      if (TARGETS[command] || command === "all") {
-        cmdInstall(command, projectDir);
-      } else {
-        console.error(red(`✗ 未知命令: ${command}`));
-        console.error("运行 vue3-temp-skill --help 查看帮助");
-        process.exit(1);
-      }
-  }
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  try { createInstaller().run(process.argv.slice(2)); }
+  catch (err) { console.error(err.message); process.exitCode = 1; }
 }
-
-main();