ccli-core 0.0.1

package/dist/commands/adc.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/commands/adc.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+/**
+ * @cmdName adc
+ * 在 workspace 中快速创建新命令文件并注册到全局。
+ * 必须在 workspace 根目录下运行。
+ */
+import path from "path";
+import fs from "fs";
+import { execSync } from "child_process";
+import { program } from "commander";
+import { COMMAND_TEMPLATE } from "../template.js";
+function normalizeCmdSlug(raw) {
+    const n = raw.trim().replace(/\\/g, "/");
+    const rest = n.startsWith("tool/") ? n.slice(5) : n;
+    if (!rest || rest.startsWith("/")) {
+        throw new Error(`无效的命令名: ${raw}`);
+    }
+    return rest;
+}
+program
+    .arguments("<cmdname> [desc] [targetPath]")
+    .description("在 workspace 中创建新命令文件并注册到全局")
+    .action((cmdname, desc = "No description provided.", targetPathArg) => {
+    const workspaceRoot = process.cwd();
+    const cmdSlug = normalizeCmdSlug(cmdname);
+    console.log(`创建命令文件：${cmdSlug}\n描述：${desc}`);
+    const content = COMMAND_TEMPLATE.replace(/\$\{cmdname\}/g, cmdSlug).replace(/\$\{desc\}/g, desc);
+    let targetPath;
+    if (targetPathArg) {
+        let resolvedPath = path.resolve(workspaceRoot, targetPathArg);
+        if (!resolvedPath.endsWith(".ts")) {
+            if (fs.existsSync(resolvedPath) &&
+                fs.statSync(resolvedPath).isDirectory()) {
+                resolvedPath = path.join(resolvedPath, `${cmdSlug}.ts`);
+            }
+            else if (!path.extname(resolvedPath)) {
+                resolvedPath += ".ts";
+            }
+        }
+        targetPath = resolvedPath;
+    }
+    else {
+        targetPath = path.join(workspaceRoot, "src/commands/tool", `${cmdSlug}.ts`);
+    }
+    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+    fs.writeFileSync(targetPath, content);
+    try {
+        execSync(`code "${targetPath}"`, { stdio: "inherit" });
+    }
+    catch {
+        // code 命令不可用时静默忽略
+    }
+    execSync("cpu-update", { stdio: "inherit", cwd: workspaceRoot });
+    console.log(`\n✅ 命令已就绪`);
+    console.log(`   命令名：${cmdSlug}`);
+    console.log(`   源文件：${targetPath}`);
+})
+    .parse(process.argv);
+//# sourceMappingURL=adc.js.map

package/dist/commands/adc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adc.js","sourceRoot":"","sources":["../../src/commands/adc.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n/**\n * @cmdName adc\n * 在 workspace 中快速创建新命令文件并注册到全局。\n * 必须在 workspace 根目录下运行。\n */\nimport path from \"path\";\nimport fs from \"fs\";\nimport { execSync } from \"child_process\";\nimport { program } from \"commander\";\nimport { COMMAND_TEMPLATE } from \"../template.js\";\n\nfunction normalizeCmdSlug(raw: string): string {\n  const n = raw.trim().replace(/\\\\/g, \"/\");\n  const rest = n.startsWith(\"tool/\") ? n.slice(5) : n;\n  if (!rest || rest.startsWith(\"/\")) {\n    throw new Error(`无效的命令名: ${raw}`);\n  }\n  return rest;\n}\n\nprogram\n  .arguments(\"<cmdname> [desc] [targetPath]\")\n  .description(\"在 workspace 中创建新命令文件并注册到全局\")\n  .action(\n    (\n      cmdname: string,\n      desc: string = \"No description provided.\",\n      targetPathArg?: string\n    ) => {\n      const workspaceRoot = process.cwd();\n      const cmdSlug = normalizeCmdSlug(cmdname);\n      console.log(`创建命令文件：${cmdSlug}\\n描述：${desc}`);\n\n      const content = COMMAND_TEMPLATE.replace(/\\$\\{cmdname\\}/g, cmdSlug).replace(\n        /\\$\\{desc\\}/g,\n        desc\n      );\n\n      let targetPath: string;\n      if (targetPathArg) {\n        let resolvedPath = path.resolve(workspaceRoot, targetPathArg);\n        if (!resolvedPath.endsWith(\".ts\")) {\n          if (\n            fs.existsSync(resolvedPath) &&\n            fs.statSync(resolvedPath).isDirectory()\n          ) {\n            resolvedPath = path.join(resolvedPath, `${cmdSlug}.ts`);\n          } else if (!path.extname(resolvedPath)) {\n            resolvedPath += \".ts\";\n          }\n        }\n        targetPath = resolvedPath;\n      } else {\n        targetPath = path.join(\n          workspaceRoot,\n          \"src/commands/tool\",\n          `${cmdSlug}.ts`\n        );\n      }\n\n      fs.mkdirSync(path.dirname(targetPath), { recursive: true });\n      fs.writeFileSync(targetPath, content);\n\n      try {\n        execSync(`code \"${targetPath}\"`, { stdio: \"inherit\" });\n      } catch {\n        // code 命令不可用时静默忽略\n      }\n\n      execSync(\"cpu-update\", { stdio: \"inherit\", cwd: workspaceRoot });\n\n      console.log(`\\n✅ 命令已就绪`);\n      console.log(`   命令名：${cmdSlug}`);\n      console.log(`   源文件：${targetPath}`);\n    }\n  )\n  .parse(process.argv);\n"]}

package/dist/commands/cpu-list.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/commands/cpu-list.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/**
+ * @cmdName cpu-list
+ * 列出 workspace 当前已注册的所有命令。
+ * 必须在 workspace 根目录下运行。
+ */
+import fs from "fs";
+import path from "path";
+import chalk from "chalk";
+import Table from "cli-table3";
+const workspaceRoot = process.cwd();
+const packageJsonPath = path.join(workspaceRoot, "package.json");
+try {
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+    const bin = packageJson.bin || {};
+    const commandNames = Object.keys(bin);
+    if (commandNames.length === 0) {
+        console.log(chalk.yellow("目前没有注册任何命令。"));
+        process.exit(0);
+    }
+    console.log(chalk.cyan(`\n🚀 当前已注册命令 (${commandNames.length}):\n`));
+    const table = new Table({
+        head: [chalk.green("领域"), chalk.green("命令名称"), chalk.green("源文件路径")],
+        colWidths: [15, 25, 60],
+    });
+    for (const [name, filePath] of Object.entries(bin)) {
+        const parts = filePath.split("/");
+        let domain = "unknown";
+        const commandsIdx = parts.indexOf("commands");
+        if (commandsIdx !== -1 && parts.length > commandsIdx + 1) {
+            domain = parts[commandsIdx + 1];
+            if (domain.endsWith(".js"))
+                domain = "root";
+        }
+        table.push([chalk.blue(domain), chalk.yellow(name), filePath]);
+    }
+    console.log(table.toString());
+    console.log("");
+}
+catch (error) {
+    console.error(chalk.red("读取 package.json 失败:"), error.message);
+    process.exit(1);
+}
+//# sourceMappingURL=cpu-list.js.map

package/dist/commands/cpu-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpu-list.js","sourceRoot":"","sources":["../../src/commands/cpu-list.ts"],"names":[],"mappings":";AACA;;;;GAIG;AACH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AACpC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;AAEjE,IAAI,CAAC;IACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;IACzE,MAAM,GAAG,GAA2B,WAAW,CAAC,GAAG,IAAI,EAAE,CAAC;IAC1D,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEtC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,YAAY,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC;IAEpE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACtB,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;KACxB,CAAC,CAAC;IAEH,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,MAAM,GAAG,SAAS,CAAC;QACvB,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,WAAW,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,GAAG,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;YAChC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,GAAG,MAAM,CAAC;QAC9C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAAC,OAAO,KAAU,EAAE,CAAC;IACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC","sourcesContent":["#!/usr/bin/env node\n/**\n * @cmdName cpu-list\n * 列出 workspace 当前已注册的所有命令。\n * 必须在 workspace 根目录下运行。\n */\nimport fs from \"fs\";\nimport path from \"path\";\nimport chalk from \"chalk\";\nimport Table from \"cli-table3\";\n\nconst workspaceRoot = process.cwd();\nconst packageJsonPath = path.join(workspaceRoot, \"package.json\");\n\ntry {\n  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, \"utf8\"));\n  const bin: Record<string, string> = packageJson.bin || {};\n  const commandNames = Object.keys(bin);\n\n  if (commandNames.length === 0) {\n    console.log(chalk.yellow(\"目前没有注册任何命令。\"));\n    process.exit(0);\n  }\n\n  console.log(chalk.cyan(`\\n🚀 当前已注册命令 (${commandNames.length}):\\n`));\n\n  const table = new Table({\n    head: [chalk.green(\"领域\"), chalk.green(\"命令名称\"), chalk.green(\"源文件路径\")],\n    colWidths: [15, 25, 60],\n  });\n\n  for (const [name, filePath] of Object.entries(bin)) {\n    const parts = filePath.split(\"/\");\n    let domain = \"unknown\";\n    const commandsIdx = parts.indexOf(\"commands\");\n    if (commandsIdx !== -1 && parts.length > commandsIdx + 1) {\n      domain = parts[commandsIdx + 1];\n      if (domain.endsWith(\".js\")) domain = \"root\";\n    }\n    table.push([chalk.blue(domain), chalk.yellow(name), filePath]);\n  }\n\n  console.log(table.toString());\n  console.log(\"\");\n} catch (error: any) {\n  console.error(chalk.red(\"读取 package.json 失败:\"), error.message);\n  process.exit(1);\n}\n"]}

package/dist/commands/cpu-log.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/commands/cpu-log.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * @cmdName cpu-log
+ * 查看所有命令的历史运行记录。
+ */
+import { homedir } from "os";
+import { join } from "path";
+import { existsSync, readFileSync } from "fs";
+import { program } from "commander";
+import chalk from "chalk";
+import Table from "cli-table3";
+function formatDuration(ms) {
+    return ms < 1000 ? `${ms}ms` : `${(ms / 1000).toFixed(1)}s`;
+}
+function shortenPath(p) {
+    return p.replace(homedir(), "~");
+}
+function truncateCmd(cmd, args, maxLen = 38) {
+    const full = args.length ? `${cmd} ${args.join(" ")}` : cmd;
+    return full.length > maxLen ? full.slice(0, maxLen - 3) + "..." : full;
+}
+function readIndex() {
+    const indexFile = join(homedir(), "ccli", "logs", "index.jsonl");
+    if (!existsSync(indexFile))
+        return [];
+    const lines = readFileSync(indexFile, "utf8").trim().split("\n");
+    const entries = [];
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        try {
+            entries.push(JSON.parse(line));
+        }
+        catch {
+            // 跳过损坏行
+        }
+    }
+    return entries;
+}
+program
+    .description("查看命令历史运行记录（存储于 ~/ccli/logs/）")
+    .option("-n, --tail <n>", "显示最近 n 条", "30")
+    .option("-c, --cmd <name>", "按命令名过滤")
+    .option("--failed", "只显示失败记录")
+    .action((opts) => {
+    let entries = readIndex();
+    if (opts.cmd) {
+        entries = entries.filter((e) => e.cmd === opts.cmd);
+    }
+    if (opts.failed) {
+        entries = entries.filter((e) => e.exitCode !== 0);
+    }
+    // 按时间倒序（最新在上）
+    entries.sort((a, b) => b.ts.localeCompare(a.ts));
+    const tail = Math.max(1, parseInt(opts.tail, 10) || 30);
+    entries = entries.slice(0, tail);
+    if (entries.length === 0) {
+        console.log(chalk.yellow("暂无运行记录。运行任意带 initCmdLogger 的命令后再试。"));
+        return;
+    }
+    const table = new Table({
+        head: [
+            chalk.cyan("命令"),
+            chalk.cyan("结果"),
+            chalk.cyan("耗时"),
+            chalk.cyan("日志位置"),
+        ],
+        colWidths: [40, 14, 8, 48],
+        style: { compact: false },
+    });
+    for (const entry of entries) {
+        const cmdDisplay = truncateCmd(entry.cmd, entry.args);
+        const resultDisplay = entry.exitCode === 0
+            ? chalk.green("✅ 成功")
+            : chalk.red(`❌ 失败(${entry.exitCode})`);
+        const durationDisplay = formatDuration(entry.duration);
+        const pathDisplay = shortenPath(entry.logFile);
+        table.push([cmdDisplay, resultDisplay, durationDisplay, pathDisplay]);
+    }
+    console.log(chalk.bold(`\n最近 ${entries.length} 条运行记录：\n`));
+    console.log(table.toString());
+    console.log();
+})
+    .parse(process.argv);
+//# sourceMappingURL=cpu-log.js.map

package/dist/commands/cpu-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpu-log.js","sourceRoot":"","sources":["../../src/commands/cpu-log.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n/**\n * @cmdName cpu-log\n * 查看所有命令的历史运行记录。\n */\nimport { homedir } from \"os\";\nimport { join } from \"path\";\nimport { existsSync, readFileSync } from \"fs\";\nimport { program } from \"commander\";\nimport chalk from \"chalk\";\nimport Table from \"cli-table3\";\nimport type { LogEntry } from \"../utils/cmdLogger.js\";\n\nfunction formatDuration(ms: number): string {\n  return ms < 1000 ? `${ms}ms` : `${(ms / 1000).toFixed(1)}s`;\n}\n\nfunction shortenPath(p: string): string {\n  return p.replace(homedir(), \"~\");\n}\n\nfunction truncateCmd(cmd: string, args: string[], maxLen = 38): string {\n  const full = args.length ? `${cmd} ${args.join(\" \")}` : cmd;\n  return full.length > maxLen ? full.slice(0, maxLen - 3) + \"...\" : full;\n}\n\nfunction readIndex(): LogEntry[] {\n  const indexFile = join(homedir(), \"ccli\", \"logs\", \"index.jsonl\");\n  if (!existsSync(indexFile)) return [];\n\n  const lines = readFileSync(indexFile, \"utf8\").trim().split(\"\\n\");\n  const entries: LogEntry[] = [];\n  for (const line of lines) {\n    if (!line.trim()) continue;\n    try {\n      entries.push(JSON.parse(line) as LogEntry);\n    } catch {\n      // 跳过损坏行\n    }\n  }\n  return entries;\n}\n\nprogram\n  .description(\"查看命令历史运行记录（存储于 ~/ccli/logs/）\")\n  .option(\"-n, --tail <n>\", \"显示最近 n 条\", \"30\")\n  .option(\"-c, --cmd <name>\", \"按命令名过滤\")\n  .option(\"--failed\", \"只显示失败记录\")\n  .action((opts: { tail: string; cmd?: string; failed?: boolean }) => {\n    let entries = readIndex();\n\n    if (opts.cmd) {\n      entries = entries.filter((e) => e.cmd === opts.cmd);\n    }\n    if (opts.failed) {\n      entries = entries.filter((e) => e.exitCode !== 0);\n    }\n\n    // 按时间倒序（最新在上）\n    entries.sort((a, b) => b.ts.localeCompare(a.ts));\n\n    const tail = Math.max(1, parseInt(opts.tail, 10) || 30);\n    entries = entries.slice(0, tail);\n\n    if (entries.length === 0) {\n      console.log(chalk.yellow(\"暂无运行记录。运行任意带 initCmdLogger 的命令后再试。\"));\n      return;\n    }\n\n    const table = new Table({\n      head: [\n        chalk.cyan(\"命令\"),\n        chalk.cyan(\"结果\"),\n        chalk.cyan(\"耗时\"),\n        chalk.cyan(\"日志位置\"),\n      ],\n      colWidths: [40, 14, 8, 48],\n      style: { compact: false },\n    });\n\n    for (const entry of entries) {\n      const cmdDisplay = truncateCmd(entry.cmd, entry.args);\n      const resultDisplay =\n        entry.exitCode === 0\n          ? chalk.green(\"✅ 成功\")\n          : chalk.red(`❌ 失败(${entry.exitCode})`);\n      const durationDisplay = formatDuration(entry.duration);\n      const pathDisplay = shortenPath(entry.logFile);\n\n      table.push([cmdDisplay, resultDisplay, durationDisplay, pathDisplay]);\n    }\n\n    console.log(chalk.bold(`\\n最近 ${entries.length} 条运行记录：\\n`));\n    console.log(table.toString());\n    console.log();\n  })\n  .parse(process.argv);\n"]}

package/dist/commands/cpu-update.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/commands/cpu-update.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * @cmdName cpu-update
+ * 先在 workspace 执行一次 tsc（根项目 + cli-core），再扫描 dist/commands、同步 package.json bin 并 npm link。
+ * 必须在 workspace 根目录下运行。
+ */
+import { execSync } from "child_process";
+import { syncCommands, npmLink } from "../index.js";
+const workspaceRoot = process.cwd();
+console.log("\n[1/5] 正在编译 workspace (tsc)...");
+execSync("npx tsc", { stdio: "inherit", cwd: workspaceRoot });
+execSync("npx tsc -p packages/cli-core/tsconfig.json", {
+    stdio: "inherit",
+    cwd: workspaceRoot,
+});
+console.log("  - 编译完成。");
+console.log("\n[2/5] 正在清理旧命令并扫描命令文件...");
+const { previous, added } = syncCommands({ projectRoot: workspaceRoot });
+if (previous.length > 0) {
+    console.log(`  - 已清理旧命令 (${previous.length} 个): ${previous.join(", ")}`);
+}
+else {
+    console.log("  - 无需清理旧命令。");
+}
+console.log("\n[3/5] 扫描命令文件完成。");
+if (added.length > 0) {
+    console.log(`  - 发现 ${added.length} 个命令: ${added.join(", ")}`);
+}
+else {
+    console.log("  - 未发现任何命令。");
+}
+console.log("\n[4/5] 正在注册命令到全局 (npm link)...");
+try {
+    npmLink(workspaceRoot);
+    console.log("  - 注册成功。");
+}
+catch (error) {
+    console.error("  - 注册失败:", error.message);
+}
+console.log("\n[5/5] 更新完成！");
+console.log("---------------------------------------");
+if (added.length > 0) {
+    console.log("你可以直接运行以下命令：");
+    added.forEach((cmd) => console.log(`  $ ${cmd}`));
+}
+console.log("---------------------------------------\n");
+//# sourceMappingURL=cpu-update.js.map

package/dist/commands/cpu-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpu-update.js","sourceRoot":"","sources":["../../src/commands/cpu-update.ts"],"names":[],"mappings":";AACA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAEpC,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AAC/C,QAAQ,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC;AAC9D,QAAQ,CAAC,4CAA4C,EAAE;IACrD,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,aAAa;CACnB,CAAC,CAAC;AACH,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAEzB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAEzC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;AAEzE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACxB,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,CAAC,MAAM,QAAQ,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC3E,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAC9B,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACrB,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,MAAM,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAC9B,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AAC/C,IAAI,CAAC;IACH,OAAO,CAAC,aAAa,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC3B,CAAC;AAAC,OAAO,KAAU,EAAE,CAAC;IACpB,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAC7B,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;AACvD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACrB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5B,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC;AACpD,CAAC;AACD,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\n/**\n * @cmdName cpu-update\n * 先在 workspace 执行一次 tsc（根项目 + cli-core），再扫描 dist/commands、同步 package.json bin 并 npm link。\n * 必须在 workspace 根目录下运行。\n */\nimport { execSync } from \"child_process\";\nimport { syncCommands, npmLink } from \"../index.js\";\n\nconst workspaceRoot = process.cwd();\n\nconsole.log(\"\\n[1/5] 正在编译 workspace (tsc)...\");\nexecSync(\"npx tsc\", { stdio: \"inherit\", cwd: workspaceRoot });\nexecSync(\"npx tsc -p packages/cli-core/tsconfig.json\", {\n  stdio: \"inherit\",\n  cwd: workspaceRoot,\n});\nconsole.log(\"  - 编译完成。\");\n\nconsole.log(\"\\n[2/5] 正在清理旧命令并扫描命令文件...\");\n\nconst { previous, added } = syncCommands({ projectRoot: workspaceRoot });\n\nif (previous.length > 0) {\n  console.log(`  - 已清理旧命令 (${previous.length} 个): ${previous.join(\", \")}`);\n} else {\n  console.log(\"  - 无需清理旧命令。\");\n}\n\nconsole.log(\"\\n[3/5] 扫描命令文件完成。\");\nif (added.length > 0) {\n  console.log(`  - 发现 ${added.length} 个命令: ${added.join(\", \")}`);\n} else {\n  console.log(\"  - 未发现任何命令。\");\n}\n\nconsole.log(\"\\n[4/5] 正在注册命令到全局 (npm link)...\");\ntry {\n  npmLink(workspaceRoot);\n  console.log(\"  - 注册成功。\");\n} catch (error: any) {\n  console.error(\"  - 注册失败:\", error.message);\n}\n\nconsole.log(\"\\n[5/5] 更新完成！\");\nconsole.log(\"---------------------------------------\");\nif (added.length > 0) {\n  console.log(\"你可以直接运行以下命令：\");\n  added.forEach((cmd) => console.log(`  $ ${cmd}`));\n}\nconsole.log(\"---------------------------------------\\n\");\n"]}

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+export interface SyncOptions {
+    /** 项目根目录（含 package.json） */
+    projectRoot: string;
+    /** 编译产物命令目录，默认 {projectRoot}/dist/commands */
+    commandsDir?: string;
+    /** package.json 路径，默认 {projectRoot}/package.json */
+    packageJsonPath?: string;
+}
+export interface SyncResult {
+    /** 本次同步前已注册的命令名列表 */
+    previous: string[];
+    /** 本次扫描到的命令名列表 */
+    added: string[];
+    /** 最终写入 bin 字段的映射 */
+    binMap: Record<string, string>;
+}
+/** 递归收集目录下所有 .js 文件的绝对路径 */
+export declare function getAllJsFiles(dir: string): string[];
+/**
+ * 从 JS 文件内容中提取 @cmdName 注解。
+ * 无注解时按文件名推断（index.js 取父目录名）。
+ */
+export declare function getCmdName(filePath: string): string | null;
+/**
+ * 扫描 commandsDir，返回 `{ cmdName: relativePathFromProjectRoot }` 映射。
+ */
+export declare function collectCommands(commandsDir: string, projectRoot: string): Record<string, string>;
+/** 批量取消旧命令的全局链接 */
+export declare function unlinkOldCommands(oldBin: Record<string, string>, projectRoot: string): void;
+/** 执行 npm link 将当前包注册到全局 */
+export declare function npmLink(projectRoot: string): void;
+/**
+ * 完整同步流程：
+ * 1. 读取 package.json 中现有 bin
+ * 2. 取消旧命令全局链接
+ * 3. 扫描 commandsDir，收集新命令
+ * 4. 写回 package.json bin 字段
+ *
+ * 注意：本函数不执行 npm link，由调用方在适当时机调用 `npmLink()`。
+ */
+export declare function syncCommands(options: SyncOptions): SyncResult;
+export { getJsMeta } from "./utils/getJsMeta.js";
+export { exec, execDetailed, ExecError } from "./utils/exec.js";
+export type { ExecOptions, ExecResult, ExecErrorDetails } from "./utils/exec.js";
+export { sleep } from "./utils/sleep.js";
+export { escapeChars } from "./utils/escapeChars.js";
+export { promiseForEach } from "./utils/promise/promiseForEach.js";
+export { initCmdLogger } from "./utils/cmdLogger.js";
+export type { LogEntry } from "./utils/cmdLogger.js";
+export { COMMAND_TEMPLATE } from "./template.js";

package/dist/index.js

@@ -0,0 +1,104 @@
+import fs from "fs";
+import path from "path";
+import { execSync } from "child_process";
+// ──────────────────────────────────────────────
+// 框架 API：命令扫描 & 注册
+// ──────────────────────────────────────────────
+/** 递归收集目录下所有 .js 文件的绝对路径 */
+export function getAllJsFiles(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    const results = [];
+    for (const file of fs.readdirSync(dir)) {
+        const fullPath = path.join(dir, file);
+        if (fs.statSync(fullPath).isDirectory()) {
+            results.push(...getAllJsFiles(fullPath));
+        }
+        else if (path.extname(file) === ".js") {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+/**
+ * 从 JS 文件内容中提取 @cmdName 注解。
+ * 无注解时按文件名推断（index.js 取父目录名）。
+ */
+export function getCmdName(filePath) {
+    const content = fs.readFileSync(filePath, "utf8");
+    const match = content.match(/@cmdName\s+(\S+)/);
+    if (match)
+        return match[1];
+    const fileName = path.basename(filePath, ".js");
+    if (fileName === "index") {
+        return path.basename(path.dirname(filePath));
+    }
+    return fileName;
+}
+/**
+ * 扫描 commandsDir，返回 `{ cmdName: relativePathFromProjectRoot }` 映射。
+ */
+export function collectCommands(commandsDir, projectRoot) {
+    const bin = {};
+    for (const fullPath of getAllJsFiles(commandsDir)) {
+        const cmdName = getCmdName(fullPath);
+        if (cmdName) {
+            bin[cmdName] = `./${path.relative(projectRoot, fullPath)}`;
+        }
+    }
+    return bin;
+}
+/** 批量取消旧命令的全局链接 */
+export function unlinkOldCommands(oldBin, projectRoot) {
+    for (const cmdName of Object.keys(oldBin)) {
+        try {
+            execSync(`npm unlink -g ${cmdName}`, {
+                stdio: "ignore",
+                cwd: projectRoot,
+            });
+        }
+        catch {
+            // 忽略找不到命令的错误
+        }
+    }
+}
+/** 执行 npm link 将当前包注册到全局 */
+export function npmLink(projectRoot) {
+    execSync("npm link --force", { stdio: "ignore", cwd: projectRoot });
+}
+/**
+ * 完整同步流程：
+ * 1. 读取 package.json 中现有 bin
+ * 2. 取消旧命令全局链接
+ * 3. 扫描 commandsDir，收集新命令
+ * 4. 写回 package.json bin 字段
+ *
+ * 注意：本函数不执行 npm link，由调用方在适当时机调用 `npmLink()`。
+ */
+export function syncCommands(options) {
+    const { projectRoot, commandsDir = path.join(projectRoot, "dist", "commands"), packageJsonPath = path.join(projectRoot, "package.json"), } = options;
+    const raw = fs.readFileSync(packageJsonPath, "utf8");
+    const packageJson = JSON.parse(raw);
+    const oldBin = packageJson.bin ?? {};
+    const previous = Object.keys(oldBin);
+    unlinkOldCommands(oldBin, projectRoot);
+    const binMap = collectCommands(commandsDir, projectRoot);
+    const added = Object.keys(binMap);
+    packageJson.bin = binMap;
+    fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n", "utf8");
+    return { previous, added, binMap };
+}
+// ──────────────────────────────────────────────
+// 通用工具函数
+// ──────────────────────────────────────────────
+export { getJsMeta } from "./utils/getJsMeta.js";
+export { exec, execDetailed, ExecError } from "./utils/exec.js";
+export { sleep } from "./utils/sleep.js";
+export { escapeChars } from "./utils/escapeChars.js";
+export { promiseForEach } from "./utils/promise/promiseForEach.js";
+export { initCmdLogger } from "./utils/cmdLogger.js";
+// ──────────────────────────────────────────────
+// 命令模板
+// ──────────────────────────────────────────────
+export { COMMAND_TEMPLATE } from "./template.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\nimport { execSync } from \"child_process\";\n\n// ──────────────────────────────────────────────\n// 类型\n// ──────────────────────────────────────────────\n\nexport interface SyncOptions {\n  /** 项目根目录（含 package.json） */\n  projectRoot: string;\n  /** 编译产物命令目录，默认 {projectRoot}/dist/commands */\n  commandsDir?: string;\n  /** package.json 路径，默认 {projectRoot}/package.json */\n  packageJsonPath?: string;\n}\n\nexport interface SyncResult {\n  /** 本次同步前已注册的命令名列表 */\n  previous: string[];\n  /** 本次扫描到的命令名列表 */\n  added: string[];\n  /** 最终写入 bin 字段的映射 */\n  binMap: Record<string, string>;\n}\n\n// ──────────────────────────────────────────────\n// 框架 API：命令扫描 & 注册\n// ──────────────────────────────────────────────\n\n/** 递归收集目录下所有 .js 文件的绝对路径 */\nexport function getAllJsFiles(dir: string): string[] {\n  if (!fs.existsSync(dir)) return [];\n  const results: string[] = [];\n  for (const file of fs.readdirSync(dir)) {\n    const fullPath = path.join(dir, file);\n    if (fs.statSync(fullPath).isDirectory()) {\n      results.push(...getAllJsFiles(fullPath));\n    } else if (path.extname(file) === \".js\") {\n      results.push(fullPath);\n    }\n  }\n  return results;\n}\n\n/**\n * 从 JS 文件内容中提取 @cmdName 注解。\n * 无注解时按文件名推断（index.js 取父目录名）。\n */\nexport function getCmdName(filePath: string): string | null {\n  const content = fs.readFileSync(filePath, \"utf8\");\n  const match = content.match(/@cmdName\\s+(\\S+)/);\n  if (match) return match[1];\n\n  const fileName = path.basename(filePath, \".js\");\n  if (fileName === \"index\") {\n    return path.basename(path.dirname(filePath));\n  }\n  return fileName;\n}\n\n/**\n * 扫描 commandsDir，返回 `{ cmdName: relativePathFromProjectRoot }` 映射。\n */\nexport function collectCommands(\n  commandsDir: string,\n  projectRoot: string\n): Record<string, string> {\n  const bin: Record<string, string> = {};\n  for (const fullPath of getAllJsFiles(commandsDir)) {\n    const cmdName = getCmdName(fullPath);\n    if (cmdName) {\n      bin[cmdName] = `./${path.relative(projectRoot, fullPath)}`;\n    }\n  }\n  return bin;\n}\n\n/** 批量取消旧命令的全局链接 */\nexport function unlinkOldCommands(\n  oldBin: Record<string, string>,\n  projectRoot: string\n): void {\n  for (const cmdName of Object.keys(oldBin)) {\n    try {\n      execSync(`npm unlink -g ${cmdName}`, {\n        stdio: \"ignore\",\n        cwd: projectRoot,\n      });\n    } catch {\n      // 忽略找不到命令的错误\n    }\n  }\n}\n\n/** 执行 npm link 将当前包注册到全局 */\nexport function npmLink(projectRoot: string): void {\n  execSync(\"npm link --force\", { stdio: \"ignore\", cwd: projectRoot });\n}\n\n/**\n * 完整同步流程：\n * 1. 读取 package.json 中现有 bin\n * 2. 取消旧命令全局链接\n * 3. 扫描 commandsDir，收集新命令\n * 4. 写回 package.json bin 字段\n *\n * 注意：本函数不执行 npm link，由调用方在适当时机调用 `npmLink()`。\n */\nexport function syncCommands(options: SyncOptions): SyncResult {\n  const {\n    projectRoot,\n    commandsDir = path.join(projectRoot, \"dist\", \"commands\"),\n    packageJsonPath = path.join(projectRoot, \"package.json\"),\n  } = options;\n\n  const raw = fs.readFileSync(packageJsonPath, \"utf8\");\n  const packageJson = JSON.parse(raw) as {\n    bin?: Record<string, string>;\n    [key: string]: unknown;\n  };\n\n  const oldBin: Record<string, string> = packageJson.bin ?? {};\n  const previous = Object.keys(oldBin);\n\n  unlinkOldCommands(oldBin, projectRoot);\n\n  const binMap = collectCommands(commandsDir, projectRoot);\n  const added = Object.keys(binMap);\n\n  packageJson.bin = binMap;\n  fs.writeFileSync(\n    packageJsonPath,\n    JSON.stringify(packageJson, null, 2) + \"\\n\",\n    \"utf8\"\n  );\n\n  return { previous, added, binMap };\n}\n\n// ──────────────────────────────────────────────\n// 通用工具函数\n// ──────────────────────────────────────────────\n\nexport { getJsMeta } from \"./utils/getJsMeta.js\";\nexport { exec, execDetailed, ExecError } from \"./utils/exec.js\";\nexport type { ExecOptions, ExecResult, ExecErrorDetails } from \"./utils/exec.js\";\nexport { sleep } from \"./utils/sleep.js\";\nexport { escapeChars } from \"./utils/escapeChars.js\";\nexport { promiseForEach } from \"./utils/promise/promiseForEach.js\";\nexport { initCmdLogger } from \"./utils/cmdLogger.js\";\nexport type { LogEntry } from \"./utils/cmdLogger.js\";\n\n// ──────────────────────────────────────────────\n// 命令模板\n// ──────────────────────────────────────────────\n\nexport { COMMAND_TEMPLATE } from \"./template.js\";\n"]}

package/dist/template.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 新命令的默认模板，由 adc 命令使用。
+ * 占位符：${cmdname}、${desc}
+ */
+export declare const COMMAND_TEMPLATE = "#!/usr/bin/env node\n/**\n * @cmdName ${cmdname}\n * ${desc}\n */\nimport { program } from \"commander\";\nimport { getJsMeta, initCmdLogger } from \"ccli-core\";\n\nconst { projectRoot, cmdName } = getJsMeta(import.meta);\ninitCmdLogger(import.meta);\n\nprogram\n  .description(\"${desc}\")\n  .action(() => {\n    console.log(`Running ${cmdName}...`);\n  })\n  .parse(process.argv);\n";

package/dist/template.js

@@ -0,0 +1,23 @@
+/**
+ * 新命令的默认模板，由 adc 命令使用。
+ * 占位符：${cmdname}、${desc}
+ */
+export const COMMAND_TEMPLATE = `#!/usr/bin/env node
+/**
+ * @cmdName \${cmdname}
+ * \${desc}
+ */
+import { program } from "commander";
+import { getJsMeta, initCmdLogger } from "ccli-core";
+
+const { projectRoot, cmdName } = getJsMeta(import.meta);
+initCmdLogger(import.meta);
+
+program
+  .description("\${desc}")
+  .action(() => {
+    console.log(\`Running \${cmdName}...\`);
+  })
+  .parse(process.argv);
+`;
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;CAiB/B,CAAC","sourcesContent":["/**\n * 新命令的默认模板，由 adc 命令使用。\n * 占位符：${cmdname}、${desc}\n */\nexport const COMMAND_TEMPLATE = `#!/usr/bin/env node\n/**\n * @cmdName \\${cmdname}\n * \\${desc}\n */\nimport { program } from \"commander\";\nimport { getJsMeta, initCmdLogger } from \"ccli-core\";\n\nconst { projectRoot, cmdName } = getJsMeta(import.meta);\ninitCmdLogger(import.meta);\n\nprogram\n  .description(\"\\${desc}\")\n  .action(() => {\n    console.log(\\`Running \\${cmdName}...\\`);\n  })\n  .parse(process.argv);\n`;\n"]}

package/dist/utils/cmdLogger.d.ts

@@ -0,0 +1,16 @@
+export interface LogEntry {
+    ts: string;
+    cmd: string;
+    args: string[];
+    exitCode: number;
+    duration: number;
+    logFile: string;
+}
+/**
+ * 在命令顶部调用，自动将 stdout/stderr Tee 到日志文件，并在进程退出时
+ * 将本次运行元数据追加到 ~/ccli/logs/index.jsonl。
+ *
+ * 用法：在命令文件顶部加一行
+ *   initCmdLogger(import.meta);
+ */
+export declare function initCmdLogger(meta: ImportMeta): void;

package/dist/utils/cmdLogger.js

@@ -0,0 +1,80 @@
+import { homedir } from "os";
+import { join } from "path";
+import { mkdirSync, createWriteStream, appendFileSync } from "fs";
+import { getJsMeta } from "./getJsMeta.js";
+/**
+ * 在命令顶部调用，自动将 stdout/stderr Tee 到日志文件，并在进程退出时
+ * 将本次运行元数据追加到 ~/ccli/logs/index.jsonl。
+ *
+ * 用法：在命令文件顶部加一行
+ *   initCmdLogger(import.meta);
+ */
+export function initCmdLogger(meta) {
+    const { cmdName } = getJsMeta(meta);
+    const args = process.argv.slice(2);
+    const startTime = Date.now();
+    const now = new Date(startTime);
+    const pad = (n) => String(n).padStart(2, "0");
+    const dateStr = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}`;
+    const timeStr = `${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+    const logsRoot = join(homedir(), "ccli", "logs");
+    const logDir = join(logsRoot, dateStr);
+    const logFile = join(logDir, `${timeStr}-${cmdName}.log`);
+    const indexFile = join(logsRoot, "index.jsonl");
+    let stream;
+    try {
+        mkdirSync(logDir, { recursive: true });
+        stream = createWriteStream(logFile, { flags: "a", encoding: "utf8" });
+    }
+    catch {
+        return;
+    }
+    stream.write(`[START] ${now.toISOString()}  ${cmdName}${args.length ? " " + args.join(" ") : ""}\n`);
+    stream.write("─".repeat(50) + "\n");
+    const origStdoutWrite = process.stdout.write.bind(process.stdout);
+    const origStderrWrite = process.stderr.write.bind(process.stderr);
+    process.stdout.write = ((chunk, encodingOrCb, cb) => {
+        try {
+            stream.write(chunk);
+        }
+        catch {
+            /* silent */
+        }
+        return origStdoutWrite(chunk, encodingOrCb, cb);
+    });
+    process.stderr.write = ((chunk, encodingOrCb, cb) => {
+        try {
+            stream.write(chunk);
+        }
+        catch {
+            /* silent */
+        }
+        return origStderrWrite(chunk, encodingOrCb, cb);
+    });
+    process.on("exit", (code) => {
+        const duration = Date.now() - startTime;
+        const exitCode = code ?? 0;
+        try {
+            stream.write("\n" + "─".repeat(50) + "\n");
+            stream.write(`[END] exitCode=${exitCode}  duration=${duration}ms\n`);
+        }
+        catch {
+            /* silent */
+        }
+        const entry = {
+            ts: now.toISOString(),
+            cmd: cmdName,
+            args,
+            exitCode,
+            duration,
+            logFile,
+        };
+        try {
+            appendFileSync(indexFile, JSON.stringify(entry) + "\n", "utf8");
+        }
+        catch {
+            /* silent */
+        }
+    });
+}
+//# sourceMappingURL=cmdLogger.js.map

package/dist/utils/cmdLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmdLogger.js","sourceRoot":"","sources":["../../src/utils/cmdLogger.ts"],"names":[],"mappings":"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","sourcesContent":["import { homedir } from \"os\";\nimport { join } from \"path\";\nimport { mkdirSync, createWriteStream, appendFileSync } from \"fs\";\nimport type { WriteStream } from \"fs\";\nimport { getJsMeta } from \"./getJsMeta.js\";\n\nexport interface LogEntry {\n  ts: string;\n  cmd: string;\n  args: string[];\n  exitCode: number;\n  duration: number;\n  logFile: string;\n}\n\n/**\n * 在命令顶部调用，自动将 stdout/stderr Tee 到日志文件，并在进程退出时\n * 将本次运行元数据追加到 ~/ccli/logs/index.jsonl。\n *\n * 用法：在命令文件顶部加一行\n *   initCmdLogger(import.meta);\n */\nexport function initCmdLogger(meta: ImportMeta): void {\n  const { cmdName } = getJsMeta(meta);\n  const args = process.argv.slice(2);\n  const startTime = Date.now();\n\n  const now = new Date(startTime);\n  const pad = (n: number) => String(n).padStart(2, \"0\");\n  const dateStr = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}`;\n  const timeStr = `${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;\n\n  const logsRoot = join(homedir(), \"ccli\", \"logs\");\n  const logDir = join(logsRoot, dateStr);\n  const logFile = join(logDir, `${timeStr}-${cmdName}.log`);\n  const indexFile = join(logsRoot, \"index.jsonl\");\n\n  let stream: WriteStream;\n  try {\n    mkdirSync(logDir, { recursive: true });\n    stream = createWriteStream(logFile, { flags: \"a\", encoding: \"utf8\" });\n  } catch {\n    return;\n  }\n\n  stream.write(`[START] ${now.toISOString()}  ${cmdName}${args.length ? \" \" + args.join(\" \") : \"\"}\\n`);\n  stream.write(\"─\".repeat(50) + \"\\n\");\n\n  const origStdoutWrite = process.stdout.write.bind(process.stdout);\n  const origStderrWrite = process.stderr.write.bind(process.stderr);\n\n  (process.stdout as NodeJS.WriteStream).write = ((\n    chunk: Uint8Array | string,\n    encodingOrCb?: BufferEncoding | ((err?: Error | null) => void),\n    cb?: (err?: Error | null) => void\n  ): boolean => {\n    try {\n      stream.write(chunk);\n    } catch {\n      /* silent */\n    }\n    return origStdoutWrite(chunk as any, encodingOrCb as any, cb as any);\n  }) as typeof process.stdout.write;\n\n  (process.stderr as NodeJS.WriteStream).write = ((\n    chunk: Uint8Array | string,\n    encodingOrCb?: BufferEncoding | ((err?: Error | null) => void),\n    cb?: (err?: Error | null) => void\n  ): boolean => {\n    try {\n      stream.write(chunk);\n    } catch {\n      /* silent */\n    }\n    return origStderrWrite(chunk as any, encodingOrCb as any, cb as any);\n  }) as typeof process.stderr.write;\n\n  process.on(\"exit\", (code) => {\n    const duration = Date.now() - startTime;\n    const exitCode = code ?? 0;\n\n    try {\n      stream.write(\"\\n\" + \"─\".repeat(50) + \"\\n\");\n      stream.write(`[END] exitCode=${exitCode}  duration=${duration}ms\\n`);\n    } catch {\n      /* silent */\n    }\n\n    const entry: LogEntry = {\n      ts: now.toISOString(),\n      cmd: cmdName,\n      args,\n      exitCode,\n      duration,\n      logFile,\n    };\n\n    try {\n      appendFileSync(indexFile, JSON.stringify(entry) + \"\\n\", \"utf8\");\n    } catch {\n      /* silent */\n    }\n  });\n}\n"]}

package/dist/utils/escapeChars.d.ts

@@ -0,0 +1 @@
+export declare const escapeChars: (str: string, chars: string[]) => string;

package/dist/utils/escapeChars.js

@@ -0,0 +1,20 @@
+export const escapeChars = (str, chars) => {
+    if (!str || chars.length === 0) {
+        return str;
+    }
+    let result = str;
+    // 去重并确保优先处理反斜杠，避免其他字符转义后被二次转义
+    const uniqueChars = [...new Set(chars)];
+    const hasBackslash = uniqueChars.includes("\\");
+    const otherChars = uniqueChars.filter((char) => char !== "\\");
+    if (hasBackslash) {
+        result = result.replace(/\\/g, "\\\\");
+    }
+    for (const char of otherChars) {
+        const escapedChar = char.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        const regex = new RegExp(escapedChar, "g");
+        result = result.replace(regex, "\\" + char);
+    }
+    return result;
+};
+//# sourceMappingURL=escapeChars.js.map

package/dist/utils/escapeChars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeChars.js","sourceRoot":"","sources":["../../src/utils/escapeChars.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,KAAe,EAAU,EAAE;IAClE,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,MAAM,GAAG,GAAG,CAAC;IAEjB,8BAA8B;IAC9B,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAE/D,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAC3C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC","sourcesContent":["export const escapeChars = (str: string, chars: string[]): string => {\n  if (!str || chars.length === 0) {\n    return str;\n  }\n\n  let result = str;\n\n  // 去重并确保优先处理反斜杠，避免其他字符转义后被二次转义\n  const uniqueChars = [...new Set(chars)];\n  const hasBackslash = uniqueChars.includes(\"\\\\\");\n  const otherChars = uniqueChars.filter((char) => char !== \"\\\\\");\n\n  if (hasBackslash) {\n    result = result.replace(/\\\\/g, \"\\\\\\\\\");\n  }\n\n  for (const char of otherChars) {\n    const escapedChar = char.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n    const regex = new RegExp(escapedChar, \"g\");\n    result = result.replace(regex, \"\\\\\" + char);\n  }\n\n  return result;\n};\n"]}

package/dist/utils/exec.d.ts

@@ -0,0 +1,38 @@
+export interface ExecOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    stdin?: string;
+    timeout?: number;
+    maxBuffer?: number;
+}
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface ExecErrorDetails {
+    message: string;
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number;
+    command?: string;
+    signal?: string;
+    killed?: boolean;
+}
+export declare class ExecError extends Error {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    command?: string;
+    logFilePath: string;
+    constructor(details: ExecErrorDetails);
+}
+/**
+ * 包装 exec，方便调用命令行工具并获取输出结果。
+ * 失败时抛出 ExecError，并将详情写入 logs/error/。
+ */
+export declare function exec(command: string, options?: ExecOptions): Promise<string>;
+/**
+ * 执行命令并返回详细结果（stdout, stderr, exitCode），不抛出异常。
+ */
+export declare function execDetailed(command: string, options?: ExecOptions): Promise<ExecResult>;

package/dist/utils/exec.js

@@ -0,0 +1,157 @@
+import { exec as childProcessExec } from "child_process";
+import { promisify } from "util";
+import { writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+const execAsync = promisify(childProcessExec);
+export class ExecError extends Error {
+    stdout;
+    stderr;
+    exitCode;
+    command;
+    logFilePath;
+    constructor(details) {
+        const now = new Date();
+        const timestamp = now
+            .toISOString()
+            .replace(/[-:]/g, "")
+            .replace(/\..+/, "")
+            .replace("T", "");
+        const logFileName = `${timestamp}.error.log`;
+        // 使用 process.cwd() 作为日志目录基准（命令总是从 workspace 根运行）
+        const logDir = join(process.cwd(), "logs/error");
+        const logFilePath = join(logDir, logFileName);
+        try {
+            mkdirSync(logDir, { recursive: true });
+        }
+        catch {
+            // 目录已存在，忽略
+        }
+        const fullErrorInfo = {
+            timestamp: now.toISOString(),
+            message: details.message,
+            exitCode: details.exitCode,
+            stdout: details.stdout,
+            stderr: details.stderr,
+            command: details.command,
+            signal: details.signal,
+            killed: details.killed,
+        };
+        try {
+            writeFileSync(logFilePath, JSON.stringify(fullErrorInfo, null, 2), "utf8");
+        }
+        catch (writeError) {
+            console.error("Failed to write error log:", writeError);
+        }
+        super(`${details.message} | Error log: ${logFilePath}`);
+        this.name = "ExecError";
+        this.stdout = details.stdout || "";
+        this.stderr = details.stderr || "";
+        this.exitCode = details.exitCode || 1;
+        this.command = details.command;
+        this.logFilePath = logFilePath;
+    }
+}
+/**
+ * 包装 exec，方便调用命令行工具并获取输出结果。
+ * 失败时抛出 ExecError，并将详情写入 logs/error/。
+ */
+export async function exec(command, options = {}) {
+    try {
+        const { cwd, env, stdin, timeout = 30000, maxBuffer = 1024 * 1024, } = options;
+        const execOptions = {
+            cwd,
+            env: { ...process.env, ...env },
+            timeout,
+            maxBuffer,
+            encoding: "utf8",
+        };
+        if (stdin) {
+            const { spawn } = await import("child_process");
+            return new Promise((resolve, reject) => {
+                const child = spawn(command, {
+                    shell: true,
+                    cwd,
+                    env: { ...process.env, ...env },
+                    stdio: ["pipe", "pipe", "pipe"],
+                });
+                let stdout = "";
+                let stderr = "";
+                child.stdout.on("data", (data) => { stdout += data.toString(); });
+                child.stderr.on("data", (data) => { stderr += data.toString(); });
+                child.on("close", (code) => {
+                    if (code === 0) {
+                        resolve(stdout.trim());
+                    }
+                    else {
+                        reject(new ExecError({
+                            message: `Command failed with exit code ${code}`,
+                            stdout, stderr,
+                            exitCode: code || 1,
+                            command,
+                        }));
+                    }
+                });
+                child.on("error", (error) => {
+                    reject(new ExecError({
+                        message: `Command execution failed: ${error.message}`,
+                        stdout, stderr,
+                        exitCode: 1,
+                        command,
+                    }));
+                });
+                child.stdin.write(stdin);
+                child.stdin.end();
+            });
+        }
+        const { stdout, stderr } = await execAsync(command, execOptions);
+        const stdoutStr = stdout.toString();
+        const stderrStr = stderr.toString();
+        if (stderrStr && stderrStr.trim()) {
+            console.warn(`Command stderr: ${stderrStr.trim()}`);
+        }
+        return stdoutStr.trim();
+    }
+    catch (error) {
+        if (error.stdout !== undefined && error.stderr !== undefined) {
+            throw new ExecError({
+                message: `Command failed with exit code ${error.code}`,
+                stdout: error.stdout.toString(),
+                stderr: error.stderr.toString(),
+                exitCode: error.code || 1,
+                command,
+            });
+        }
+        if (error.killed && error.signal === "SIGTERM") {
+            throw new ExecError({
+                message: `Command timed out after ${options.timeout || 30000}ms`,
+                stdout: "", stderr: "",
+                exitCode: 1,
+                command,
+                signal: error.signal,
+                killed: error.killed,
+            });
+        }
+        throw new ExecError({
+            message: `Command execution failed: ${error.message}`,
+            stdout: "", stderr: "",
+            exitCode: 1,
+            command,
+        });
+    }
+}
+/**
+ * 执行命令并返回详细结果（stdout, stderr, exitCode），不抛出异常。
+ */
+export async function execDetailed(command, options = {}) {
+    try {
+        const stdout = await exec(command, options);
+        return { stdout, stderr: "", exitCode: 0 };
+    }
+    catch (error) {
+        if (error instanceof ExecError) {
+            return { stdout: error.stdout, stderr: error.stderr, exitCode: error.exitCode };
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=exec.js.map

package/dist/utils/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"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","sourcesContent":["import { exec as childProcessExec } from \"child_process\";\nimport { promisify } from \"util\";\nimport { writeFileSync, mkdirSync } from \"fs\";\nimport { join } from \"path\";\n\nconst execAsync = promisify(childProcessExec);\n\nexport interface ExecOptions {\n  cwd?: string;\n  env?: Record<string, string>;\n  stdin?: string;\n  timeout?: number;\n  maxBuffer?: number;\n}\n\nexport interface ExecResult {\n  stdout: string;\n  stderr: string;\n  exitCode: number;\n}\n\nexport interface ExecErrorDetails {\n  message: string;\n  stdout?: string;\n  stderr?: string;\n  exitCode?: number;\n  command?: string;\n  signal?: string;\n  killed?: boolean;\n}\n\nexport class ExecError extends Error {\n  public stdout: string;\n  public stderr: string;\n  public exitCode: number;\n  public command?: string;\n  public logFilePath: string;\n\n  constructor(details: ExecErrorDetails) {\n    const now = new Date();\n    const timestamp = now\n      .toISOString()\n      .replace(/[-:]/g, \"\")\n      .replace(/\\..+/, \"\")\n      .replace(\"T\", \"\");\n    const logFileName = `${timestamp}.error.log`;\n\n    // 使用 process.cwd() 作为日志目录基准（命令总是从 workspace 根运行）\n    const logDir = join(process.cwd(), \"logs/error\");\n    const logFilePath = join(logDir, logFileName);\n\n    try {\n      mkdirSync(logDir, { recursive: true });\n    } catch {\n      // 目录已存在，忽略\n    }\n\n    const fullErrorInfo = {\n      timestamp: now.toISOString(),\n      message: details.message,\n      exitCode: details.exitCode,\n      stdout: details.stdout,\n      stderr: details.stderr,\n      command: details.command,\n      signal: details.signal,\n      killed: details.killed,\n    };\n\n    try {\n      writeFileSync(logFilePath, JSON.stringify(fullErrorInfo, null, 2), \"utf8\");\n    } catch (writeError) {\n      console.error(\"Failed to write error log:\", writeError);\n    }\n\n    super(`${details.message} | Error log: ${logFilePath}`);\n\n    this.name = \"ExecError\";\n    this.stdout = details.stdout || \"\";\n    this.stderr = details.stderr || \"\";\n    this.exitCode = details.exitCode || 1;\n    this.command = details.command;\n    this.logFilePath = logFilePath;\n  }\n}\n\n/**\n * 包装 exec，方便调用命令行工具并获取输出结果。\n * 失败时抛出 ExecError，并将详情写入 logs/error/。\n */\nexport async function exec(\n  command: string,\n  options: ExecOptions = {}\n): Promise<string> {\n  try {\n    const {\n      cwd,\n      env,\n      stdin,\n      timeout = 30000,\n      maxBuffer = 1024 * 1024,\n    } = options;\n\n    const execOptions: Parameters<typeof execAsync>[1] = {\n      cwd,\n      env: { ...process.env, ...env },\n      timeout,\n      maxBuffer,\n      encoding: \"utf8\",\n    };\n\n    if (stdin) {\n      const { spawn } = await import(\"child_process\");\n      return new Promise((resolve, reject) => {\n        const child = spawn(command, {\n          shell: true,\n          cwd,\n          env: { ...process.env, ...env },\n          stdio: [\"pipe\", \"pipe\", \"pipe\"],\n        });\n\n        let stdout = \"\";\n        let stderr = \"\";\n\n        child.stdout.on(\"data\", (data) => { stdout += data.toString(); });\n        child.stderr.on(\"data\", (data) => { stderr += data.toString(); });\n\n        child.on(\"close\", (code) => {\n          if (code === 0) {\n            resolve(stdout.trim());\n          } else {\n            reject(new ExecError({\n              message: `Command failed with exit code ${code}`,\n              stdout, stderr,\n              exitCode: code || 1,\n              command,\n            }));\n          }\n        });\n\n        child.on(\"error\", (error) => {\n          reject(new ExecError({\n            message: `Command execution failed: ${error.message}`,\n            stdout, stderr,\n            exitCode: 1,\n            command,\n          }));\n        });\n\n        child.stdin.write(stdin);\n        child.stdin.end();\n      });\n    }\n\n    const { stdout, stderr } = await execAsync(command, execOptions);\n    const stdoutStr = stdout.toString();\n    const stderrStr = stderr.toString();\n\n    if (stderrStr && stderrStr.trim()) {\n      console.warn(`Command stderr: ${stderrStr.trim()}`);\n    }\n\n    return stdoutStr.trim();\n  } catch (error: any) {\n    if (error.stdout !== undefined && error.stderr !== undefined) {\n      throw new ExecError({\n        message: `Command failed with exit code ${error.code}`,\n        stdout: error.stdout.toString(),\n        stderr: error.stderr.toString(),\n        exitCode: error.code || 1,\n        command,\n      });\n    }\n\n    if (error.killed && error.signal === \"SIGTERM\") {\n      throw new ExecError({\n        message: `Command timed out after ${options.timeout || 30000}ms`,\n        stdout: \"\", stderr: \"\",\n        exitCode: 1,\n        command,\n        signal: error.signal,\n        killed: error.killed,\n      });\n    }\n\n    throw new ExecError({\n      message: `Command execution failed: ${error.message}`,\n      stdout: \"\", stderr: \"\",\n      exitCode: 1,\n      command,\n    });\n  }\n}\n\n/**\n * 执行命令并返回详细结果（stdout, stderr, exitCode），不抛出异常。\n */\nexport async function execDetailed(\n  command: string,\n  options: ExecOptions = {}\n): Promise<ExecResult> {\n  try {\n    const stdout = await exec(command, options);\n    return { stdout, stderr: \"\", exitCode: 0 };\n  } catch (error) {\n    if (error instanceof ExecError) {\n      return { stdout: error.stdout, stderr: error.stderr, exitCode: error.exitCode };\n    }\n    throw error;\n  }\n}\n"]}

package/dist/utils/getJsMeta.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 获取命令行上下文信息。
+ *
+ * 通过在路径中定位 `dist` 目录边界来推断 projectRoot，
+ * 不依赖硬编码的层级数，兼容任意深度的命令文件（如 dist/commands/ai/services/xxx/index.js）。
+ *
+ * @param meta — 通常传入调用方命令文件自身的 import.meta（不是 cli-core 内部的）
+ */
+export declare function getJsMeta(meta?: ImportMeta): {
+    jsDir: string;
+    srcDir: string;
+    cwd: string;
+    projectRoot: string;
+    cmdName: string;
+    assetsDir: string;
+};

package/dist/utils/getJsMeta.js

@@ -0,0 +1,27 @@
+import { fileURLToPath } from "url";
+import { dirname, join, resolve, relative, basename, extname, sep } from "path";
+/**
+ * 获取命令行上下文信息。
+ *
+ * 通过在路径中定位 `dist` 目录边界来推断 projectRoot，
+ * 不依赖硬编码的层级数，兼容任意深度的命令文件（如 dist/commands/ai/services/xxx/index.js）。
+ *
+ * @param meta — 通常传入调用方命令文件自身的 import.meta（不是 cli-core 内部的）
+ */
+export function getJsMeta(meta = import.meta) {
+    const __filename = fileURLToPath(meta.url);
+    const jsDir = dirname(__filename);
+    // 在路径中定位最后一个 dist 目录，其父目录即为 projectRoot
+    const parts = jsDir.split(sep);
+    const distIdx = parts.lastIndexOf("dist");
+    const projectRoot = distIdx !== -1 ? parts.slice(0, distIdx).join(sep) : resolve(jsDir, "..");
+    const cwd = process.cwd();
+    const distDir = join(projectRoot, "dist");
+    const relPath = relative(distDir, jsDir);
+    const srcDir = join(projectRoot, "src", relPath);
+    const assetsDir = join(projectRoot, "assets");
+    const fileName = basename(__filename, extname(__filename));
+    const cmdName = fileName !== "index" ? fileName : basename(jsDir);
+    return { jsDir, srcDir, cwd, projectRoot, cmdName, assetsDir };
+}
+//# sourceMappingURL=getJsMeta.js.map

package/dist/utils/getJsMeta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getJsMeta.js","sourceRoot":"","sources":["../../src/utils/getJsMeta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhF;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,OAAmB,MAAM,CAAC,IAAI;IACtD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAElC,wCAAwC;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,WAAW,GACf,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAE5E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACjE,CAAC","sourcesContent":["import { fileURLToPath } from \"url\";\nimport { dirname, join, resolve, relative, basename, extname, sep } from \"path\";\n\n/**\n * 获取命令行上下文信息。\n *\n * 通过在路径中定位 `dist` 目录边界来推断 projectRoot，\n * 不依赖硬编码的层级数，兼容任意深度的命令文件（如 dist/commands/ai/services/xxx/index.js）。\n *\n * @param meta — 通常传入调用方命令文件自身的 import.meta（不是 cli-core 内部的）\n */\nexport function getJsMeta(meta: ImportMeta = import.meta) {\n  const __filename = fileURLToPath(meta.url);\n  const jsDir = dirname(__filename);\n\n  // 在路径中定位最后一个 dist 目录，其父目录即为 projectRoot\n  const parts = jsDir.split(sep);\n  const distIdx = parts.lastIndexOf(\"dist\");\n  const projectRoot =\n    distIdx !== -1 ? parts.slice(0, distIdx).join(sep) : resolve(jsDir, \"..\");\n\n  const cwd = process.cwd();\n  const distDir = join(projectRoot, \"dist\");\n  const relPath = relative(distDir, jsDir);\n  const srcDir = join(projectRoot, \"src\", relPath);\n  const assetsDir = join(projectRoot, \"assets\");\n  const fileName = basename(__filename, extname(__filename));\n  const cmdName = fileName !== \"index\" ? fileName : basename(jsDir);\n\n  return { jsDir, srcDir, cwd, projectRoot, cmdName, assetsDir };\n}\n"]}

package/dist/utils/promise/promiseForEach.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 按顺序或并发执行数组中的每个 Promise，可以设置执行间隔和并发量
+ * @param array 要处理的数组
+ * @param callback 处理每个元素的异步函数
+ * @param intervalMs 每项之间的等待时间(毫秒)，默认为 0
+ * @param concurrency 最大并发量，默认为 1 (顺序执行)
+ */
+export declare const promiseForEach: <T>(array: T[], callback: (item: T, index: number, array: T[]) => Promise<void>, intervalMs?: number, concurrency?: number) => Promise<void>;

package/dist/utils/promise/promiseForEach.js

@@ -0,0 +1,39 @@
+/**
+ * 按顺序或并发执行数组中的每个 Promise，可以设置执行间隔和并发量
+ * @param array 要处理的数组
+ * @param callback 处理每个元素的异步函数
+ * @param intervalMs 每项之间的等待时间(毫秒)，默认为 0
+ * @param concurrency 最大并发量，默认为 1 (顺序执行)
+ */
+export const promiseForEach = async (array, callback, intervalMs = 0, concurrency = 1) => {
+    if (concurrency <= 1) {
+        for (let index = 0; index < array.length; index++) {
+            await callback(array[index], index, array);
+            if (intervalMs > 0 && index < array.length - 1) {
+                await new Promise((resolve) => setTimeout(resolve, intervalMs));
+            }
+        }
+        return;
+    }
+    let currentIndex = 0;
+    const runningTasks = [];
+    const processNext = async () => {
+        while (currentIndex < array.length) {
+            const index = currentIndex++;
+            if (intervalMs > 0 && index > 0) {
+                await new Promise((resolve) => setTimeout(resolve, intervalMs));
+            }
+            try {
+                await callback(array[index], index, array);
+            }
+            catch (error) {
+                console.error(`处理第 ${index} 项时出错:`, error);
+            }
+        }
+    };
+    for (let i = 0; i < Math.min(concurrency, array.length); i++) {
+        runningTasks.push(processNext());
+    }
+    await Promise.all(runningTasks);
+};
+//# sourceMappingURL=promiseForEach.js.map

package/dist/utils/promise/promiseForEach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promiseForEach.js","sourceRoot":"","sources":["../../../src/utils/promise/promiseForEach.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,KAAU,EACV,QAA+D,EAC/D,UAAU,GAAG,CAAC,EACd,WAAW,GAAG,CAAC,EACA,EAAE;IACjB,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YAClD,MAAM,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAC3C,IAAI,UAAU,GAAG,CAAC,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,YAAY,GAAoB,EAAE,CAAC;IAEzC,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;QAC5C,OAAO,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;YAE7B,IAAI,UAAU,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;YAClE,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7D,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAClC,CAAC,CAAC","sourcesContent":["/**\n * 按顺序或并发执行数组中的每个 Promise，可以设置执行间隔和并发量\n * @param array 要处理的数组\n * @param callback 处理每个元素的异步函数\n * @param intervalMs 每项之间的等待时间(毫秒)，默认为 0\n * @param concurrency 最大并发量，默认为 1 (顺序执行)\n */\nexport const promiseForEach = async <T>(\n  array: T[],\n  callback: (item: T, index: number, array: T[]) => Promise<void>,\n  intervalMs = 0,\n  concurrency = 1\n): Promise<void> => {\n  if (concurrency <= 1) {\n    for (let index = 0; index < array.length; index++) {\n      await callback(array[index], index, array);\n      if (intervalMs > 0 && index < array.length - 1) {\n        await new Promise((resolve) => setTimeout(resolve, intervalMs));\n      }\n    }\n    return;\n  }\n\n  let currentIndex = 0;\n  const runningTasks: Promise<void>[] = [];\n\n  const processNext = async (): Promise<void> => {\n    while (currentIndex < array.length) {\n      const index = currentIndex++;\n\n      if (intervalMs > 0 && index > 0) {\n        await new Promise((resolve) => setTimeout(resolve, intervalMs));\n      }\n\n      try {\n        await callback(array[index], index, array);\n      } catch (error) {\n        console.error(`处理第 ${index} 项时出错:`, error);\n      }\n    }\n  };\n\n  for (let i = 0; i < Math.min(concurrency, array.length); i++) {\n    runningTasks.push(processNext());\n  }\n\n  await Promise.all(runningTasks);\n};\n"]}

package/dist/utils/sleep.d.ts

@@ -0,0 +1 @@
+export declare function sleep(ms: number): Promise<unknown>;

package/dist/utils/sleep.js

@@ -0,0 +1,4 @@
+export async function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=sleep.js.map

package/dist/utils/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,EAAU;IACpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["export async function sleep(ms: number) {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "ccli-core",
+  "version": "0.0.1",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "adc": "./dist/commands/adc.js",
+    "cpu-update": "./dist/commands/cpu-update.js",
+    "cpu-list": "./dist/commands/cpu-list.js",
+    "cpu-log": "./dist/commands/cpu-log.js"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -w -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "chalk": "^5.4.1",
+    "cli-table3": "^0.6.5"
+  },
+  "devDependencies": {
+    "@types/node": "^24.5.2",
+    "typescript": "^5.2.2"
+  }
+}