@done-coding/cli-cc-switch 0.0.1-alpha.0

package/README.md

@@ -0,0 +1,61 @@
+# @done-coding/cli-cc-switch
+
+```
+模型路由
+```
+
+## 使用
+
+```bash
+npm install @done-coding/cli-cc-switch
+```
+
+安装后提供两个命令入口（指向同一 `es/cli.mjs`）：
+
+- `dc-cc-switch` — 正式命令名
+- `cc-router` — 兼容入口（迁移自 `@ccsuite/cli-router` 保留）
+
+```bash
+dc-cc-switch [command] [options]   # 正式
+cc-router [command] [options]      # 兼容
+```
+
+除 `--meta-*` 外的所有参数**原样透传**给 claude。
+
+## meta 选项（cc-switch 自身命令面，不透传）
+
+| 选项 | 行为 |
+| ---- | ---- |
+| `--meta-profile=<name>` | 显式指定 profile 启动 |
+| `--meta-pick` | 终端交互选择 profile 启动（需 TTY） |
+| `--meta-help` | 显示自身帮助 |
+| `--meta-version` | 显示自身版本 |
+
+优先级：`--meta-help` > `--meta-version` > `--meta-pick` > `--meta-profile=`。
+
+<!-- repo-map:start -->
+
+## 目录导航（自动维护，勿手改段内 — 由项目初始化脚本重跑刷新）
+
+- `.done-coding/` — 注入配置
+- `src/` — 源码
+  - `__tests__/` — 单元测试
+    - `config.test.ts`
+    - `deepseek-template.test.ts`
+    - `env-guard.test.ts`
+    - `parse-argv.test.ts`
+    - `prompt-interactive.test.ts`
+    - `prompt.test.ts`
+    - `run-router.test.ts`
+    - `select-profile.test.ts`
+  - `handlers/` — 子命令处理器
+  - `types/` — 类型定义
+  - `utils/` — 工具函数
+  - `cli.ts` — CLI 入口
+  - `index.ts` — 库出口
+  - `main.ts` — 路由主流程
+
+> 用途：供协作者/AI 按图定位，免遍历目录树。结构变更后重跑初始化刷新。
+> （模块根的本段展开该模块**内部**结构；深层大目录 ≥8 项或继续分叉则嵌套列出，叶子小目录不展。）
+
+<!-- repo-map:end -->

package/es/cli.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { a } from "./main-DPg5hFgO.js";
+a();

package/es/index.mjs

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { D as e, P as E, b as i, c as n, f as r, h as l, i as o, m as c, p as d, s as m } from "./main-DPg5hFgO.js";
+export {
+  e as DEEPSEEK_TEMPLATE,
+  E as PROFILE_PATH,
+  i as buildChildEnv,
+  n as createAsSubcommand,
+  r as findEmptyKeys,
+  l as hasModelEnvConflict,
+  o as isSecretKey,
+  c as maskValue,
+  d as parseArgv,
+  m as selectProfile
+};

package/es/main-DPg5hFgO.js

@@ -0,0 +1,337 @@
+#!/usr/bin/env node
+import { spawn as j } from "node:child_process";
+import C from "node:os";
+import _ from "node:path";
+import { resolveHandlerContext as F, xPrompts as H } from "@done-coding/cli-utils";
+import p from "node:fs";
+import U from "node:readline";
+const n = _.join(
+  C.homedir(),
+  ".done-coding",
+  "cc-switch",
+  "profile.json"
+), d = "--meta-profile=", h = "--meta-pick", w = "--meta-help", y = "--meta-version", P = {
+  run: 0,
+  profile: 1,
+  pick: 2,
+  version: 3,
+  help: 4
+}, m = (e, t) => P[t] > P[e] ? t : e, G = (e) => e.startsWith("--meta-") && e !== h && e !== w && e !== y && !e.startsWith(d), K = () => {
+  process.stdout.write(
+    [
+      "dc-cc-switch（cc-router）— claude-code 模型路由透传",
+      "",
+      "用法:",
+      "  dc-cc-switch [meta 选项] <claude 参数...>",
+      "",
+      "meta 选项（cc-switch 自身命令面，不透传给 claude）:",
+      `  ${d}<name>  显式指定 profile 启动`,
+      `  ${h}            终端交互选择 profile 启动`,
+      `  ${w}            显示本帮助`,
+      `  ${y}         显示版本`,
+      "",
+      "其余所有参数原样透传给 claude。",
+      `配置: ${n}`,
+      ""
+    ].join(`
+`)
+  );
+}, V = (e) => {
+  process.stdout.write(`${e}
+`);
+}, B = async (e) => {
+  const t = Object.keys(e.profiles);
+  t.length === 0 && (process.stderr.write(
+    `配置中没有可用 profile，请先编辑 ${n}。
+`
+  ), process.exit(1)), F().interactive || (process.stderr.write(
+    `--meta-pick 需要交互式终端，请改用 --meta-profile=<name> 显式指定。
+`
+  ), process.exit(1));
+  const { profile: r } = await H({
+    type: "select",
+    name: "profile",
+    message: "选择以哪个配置启动 claude",
+    choices: t.map((s) => ({ title: s, value: s }))
+  });
+  return r;
+}, J = (e) => {
+  let t, r = "run";
+  const s = [];
+  for (const o of e) {
+    if (o.startsWith(d)) {
+      t = o.slice(d.length), r = m(r, "profile");
+      continue;
+    }
+    if (o === h) {
+      r = m(r, "pick");
+      continue;
+    }
+    if (o === w) {
+      r = m(r, "help");
+      continue;
+    }
+    if (o === y) {
+      r = m(r, "version");
+      continue;
+    }
+    if (G(o))
+      throw new Error(
+        `未知 meta 选项：${o}。可用选项：${d}<name>、${h}、${w}、${y}`
+      );
+    s.push(o);
+  }
+  return { action: r, profileName: t, passthrough: s };
+}, W = (e, t) => {
+  const r = t ?? e.defaultProfile, s = e.profiles[r];
+  if (!s) {
+    const o = Object.keys(e.profiles).join(", ") || "(无)";
+    throw new Error(
+      `profile "${r}" 不存在。可用 profile：${o}。配置文件：${n}`
+    );
+  }
+  return { name: r, profile: s };
+}, Y = /^ANTHROPIC_/, X = [
+  "CLAUDE_CODE_SUBAGENT_MODEL",
+  "CLAUDE_CODE_EFFORT_LEVEL"
+], b = _.join(
+  C.homedir(),
+  ".claude",
+  "settings.json"
+), R = (e) => Y.test(e) || X.includes(e), q = (e, t) => {
+  const r = {};
+  for (const [s, o] of Object.entries(e))
+    o !== void 0 && (R(s) || (r[s] = o));
+  for (const [s, o] of Object.entries(t))
+    r[s] = o;
+  return r;
+}, Q = (e) => !e || typeof e != "object" ? [] : Object.keys(e).filter((t) => R(t)), z = () => {
+  let e;
+  try {
+    e = JSON.parse(p.readFileSync(b, "utf8"));
+  } catch {
+    return null;
+  }
+  if (typeof e != "object" || e === null)
+    return null;
+  const t = e.env;
+  return typeof t != "object" || t === null || Array.isArray(t) ? null : t;
+}, L = {
+  defaultProfile: "deepseek",
+  profiles: {
+    deepseek: {
+      env: {
+        ANTHROPIC_BASE_URL: "https://api.deepseek.com/anthropic",
+        ANTHROPIC_AUTH_TOKEN: "",
+        ANTHROPIC_MODEL: "deepseek-v4-pro[1m]",
+        ANTHROPIC_DEFAULT_OPUS_MODEL: "deepseek-v4-pro[1m]",
+        ANTHROPIC_DEFAULT_SONNET_MODEL: "deepseek-v4-pro[1m]",
+        ANTHROPIC_DEFAULT_HAIKU_MODEL: "deepseek-v4-flash[1m]",
+        CLAUDE_CODE_SUBAGENT_MODEL: "deepseek-v4-pro[1m]",
+        CLAUDE_CODE_EFFORT_LEVEL: "max"
+      }
+    }
+  }
+}, g = (e) => {
+  p.mkdirSync(_.dirname(n), { recursive: !0 }), p.writeFileSync(n, JSON.stringify(e, null, 2)), p.chmodSync(n, 384);
+}, Z = () => {
+  if (!p.existsSync(n))
+    return g(L), L;
+  const e = p.readFileSync(n, "utf8");
+  let t;
+  try {
+    t = JSON.parse(e);
+  } catch (s) {
+    const o = s instanceof Error ? s.message : String(s);
+    throw new Error(`配置文件非法 JSON：${n}（${o}）`);
+  }
+  if (typeof t != "object" || t === null)
+    throw new Error(`配置文件结构非法：${n}（应为 JSON 对象）`);
+  const r = t;
+  if (typeof r.defaultProfile != "string")
+    throw new Error(`配置文件缺少字符串字段 defaultProfile：${n}`);
+  if (typeof r.profiles != "object" || r.profiles === null || Array.isArray(r.profiles))
+    throw new Error(`配置文件缺少对象字段 profiles：${n}`);
+  return r;
+}, ee = /TOKEN|KEY|SECRET/i;
+class T extends Error {
+  constructor() {
+    super("用户中断输入"), this.name = "PromptAbortError";
+  }
+}
+const te = (e) => ee.test(e), we = (e) => e === "" ? "" : "******", k = (e) => Object.keys(e).filter((t) => e[t] === "");
+let A = !1, f = null;
+const re = (e) => new Promise((t, r) => {
+  const s = U.createInterface({
+    input: process.stdin,
+    output: process.stderr
+  });
+  f = s, s.on("close", () => {
+    f === s && (f = null);
+  }), s.question(e, (o) => {
+    s.close(), t(o);
+  }), s.on("SIGINT", () => {
+    s.close(), r(new T());
+  });
+}), se = 3, oe = 4, ne = 127, ce = (e) => new Promise((t, r) => {
+  process.stderr.write(e);
+  const s = process.stdin;
+  typeof s.setRawMode == "function" && (s.setRawMode(!0), A = !0), s.resume(), s.setEncoding("utf8");
+  let o = "";
+  const c = () => {
+    s.removeListener("data", a);
+  }, a = (S) => {
+    for (const i of S) {
+      const l = i.charCodeAt(0);
+      if (i === "\r" || i === `
+`) {
+        c(), process.stderr.write(`
+`), t(o);
+        return;
+      }
+      if (l === se || l === oe) {
+        c(), process.stderr.write(`
+`), r(new T());
+        return;
+      }
+      if (l === ne || i === "\b") {
+        o = o.slice(0, -1);
+        continue;
+      }
+      o += i;
+    }
+  };
+  s.on("data", a);
+}), ie = async (e) => {
+  const t = k(e.env);
+  for (const r of t) {
+    const s = te(r);
+    let o = "";
+    for (; o === ""; ) {
+      const c = `请输入 ${r}: `;
+      o = s ? await ce(c) : await re(c);
+    }
+    e.env[r] = o;
+  }
+}, ae = () => {
+  f && (f.close(), f = null);
+  const e = process.stdin;
+  A && typeof e.setRawMode == "function" && (e.setRawMode(!1), A = !1), e.removeAllListeners("data"), e.removeAllListeners("keypress"), e.removeAllListeners("readable"), e.pause();
+}, M = {
+  version: "0.0.1-alpha.0",
+  cliConfig: {
+    moduleName: "cc-switch"
+  }
+}, le = "claude", $ = async (e) => {
+  const { action: t, profileName: r, passthrough: s } = J(
+    e ?? process.argv.slice(2)
+  );
+  t === "help" && (K(), process.exit(0)), t === "version" && (V(M.version), process.exit(0));
+  const o = Z(), c = t === "pick" ? await B(o) : r, { profile: a } = W(o, c);
+  if (k(a.env).length > 0) {
+    try {
+      await ie(a);
+    } catch (v) {
+      if (v instanceof T)
+        return process.stderr.write(`已取消，未写入配置。
+`), process.exit(1);
+      throw v;
+    }
+    g(o), ae();
+  }
+  const i = z(), l = Q(i);
+  if (l.length > 0)
+    return process.stderr.write(
+      `检测到 ${b} 的 env 块含模型路由类 key：${l.join(", ")}。请手动清理这些 key 后重试。
+`
+    ), process.exit(1);
+  const D = q(process.env, a.env), I = j(le, s, {
+    stdio: "inherit",
+    shell: !1,
+    env: D
+  });
+  return new Promise((v, O) => {
+    I.on("error", (u) => {
+      try {
+        if (u.code === "ENOENT") {
+          process.stderr.write(
+            `未找到 claude 可执行文件，请确认 claude-code 已安装并在 PATH 中。
+`
+          ), process.exit(127);
+          return;
+        }
+        process.stderr.write(`启动 claude 失败：${u.message}
+`), process.exit(1);
+      } catch (E) {
+        O(E);
+      }
+    }), I.on("exit", (u, E) => {
+      try {
+        if (E) {
+          process.exit(128 + pe(E));
+          return;
+        }
+        process.exit(u ?? 1);
+      } catch (x) {
+        O(x);
+      }
+    });
+  });
+}, pe = (e) => ({
+  SIGHUP: 1,
+  SIGINT: 2,
+  SIGQUIT: 3,
+  SIGILL: 4,
+  SIGABRT: 6,
+  SIGFPE: 8,
+  SIGKILL: 9,
+  SIGSEGV: 11,
+  SIGPIPE: 13,
+  SIGALRM: 14,
+  SIGTERM: 15
+})[e] ?? 1, {
+  cliConfig: { moduleName: N }
+} = M, ye = async () => {
+  try {
+    await $();
+  } catch (e) {
+    const t = e instanceof Error ? e.message : String(e);
+    process.stderr.write(`${t}
+`), process.exit(1);
+  }
+}, ve = () => ({
+  command: N,
+  describe: "claude-code 模型路由透传（dc-cc-switch / cc-router）",
+  builder(e) {
+    return e.strict(!1).option("meta-profile", {
+      type: "string",
+      describe: "选择 profile（~/.done-coding/cc-switch/profile.json 中的 profile 名）"
+    }).option("meta-pick", {
+      type: "boolean",
+      describe: "终端交互选择 profile 启动"
+    }).option("meta-help", {
+      type: "boolean",
+      describe: "显示 cc-switch 自身帮助"
+    }).option("meta-version", {
+      type: "boolean",
+      describe: "显示 cc-switch 自身版本"
+    });
+  },
+  handler() {
+    const e = process.argv.findIndex((r) => r === N), t = e >= 0 ? process.argv.slice(e + 1) : process.argv.slice(2);
+    return $(t);
+  }
+});
+export {
+  L as D,
+  n as P,
+  ye as a,
+  q as b,
+  ve as c,
+  k as f,
+  Q as h,
+  te as i,
+  we as m,
+  J as p,
+  W as s
+};

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@done-coding/cli-cc-switch",
+  "version": "0.0.1-alpha.0",
+  "description": "claude-code路由",
+  "private": false,
+  "module": "es/index.mjs",
+  "types": "types/index.d.ts",
+  "type": "module",
+  "bin": {
+    "dc-cc-switch": "es/cli.mjs",
+    "cc-router": "es/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "import": "./es/index.mjs",
+      "types": "./types/index.d.ts"
+    }
+  },
+  "files": [
+    "es",
+    "lib",
+    "types"
+  ],
+  "scripts": {
+    "dev": "vite build -w -m hotBuild",
+    "build": "vite build",
+    "prepack": "pnpm build",
+    "prebuild": "rimraf types",
+    "test": "vitest run",
+    "coverage": "vitest run --coverage"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/done-coding/done-coding-cli.git",
+    "directory": "packages/cc-switch"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "author": "JustSoSu",
+  "license": "MIT",
+  "sideEffects": false,
+  "devDependencies": {
+    "@done-coding/cli-inject": "0.6.5",
+    "@types/node": "^18.0.0",
+    "@types/yargs": "^17.0.28",
+    "@vitest/coverage-v8": "^1.6.1",
+    "rimraf": "^5.0.1",
+    "typescript": "^5.8.3",
+    "vite": "^5.0.10",
+    "vite-plugin-dts": "^3.7.0",
+    "vitest": "^1.6.1"
+  },
+  "dependencies": {
+    "@done-coding/cli-utils": "0.12.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "gitHead": "13ba28f171c3a209b451ce1cfa09506cbd4abbcb"
+}

package/types/cli.d.ts

@@ -0,0 +1 @@
+export { }

package/types/index.d.ts

@@ -0,0 +1,95 @@
+import type { CommandModule } from '@done-coding/cli-utils';
+
+/**
+ * REQ-7 层 1：strip-then-inject（纯函数，可单测）。
+ * 复制 processEnv → 删除所有模型路由类 key → 注入 profileEnv（顺序不可反）。
+ * 仅作用于返回的子进程 env 对象，[MUST NOT] 修改 cc-router 自身 process.env，
+ * [MUST NOT] 读/写任何文件。空 profileEnv `{}` 仍 strip（不回退继承值）。
+ * 非模型 CLAUDE_CODE_* / PATH / HOME 等一律不动。
+ */
+export declare const buildChildEnv: (processEnv: NodeJS.ProcessEnv, profileEnv: Record<string, string>) => Record<string, string>;
+
+/**
+ * 作为子命令注册进 done-coding 主 CLI（`DC cc-switch`）。
+ * 门面路由：builder 宽松（strict(false) + 声明 meta 家族选项，不拦截
+ * claude 透传参数）；handler 内从 process.argv 在子命令名边界后取**原始切片**
+ * 喂给 runRouter —— 不消费 yargs 解析产物，守 REQ-1 逐字保真语义
+ * （独立入口 dc-cc-switch / cc-router 行为与未注册前完全一致）。
+ * meta 自身命令面（REQ-1）：--meta-profile=<name> / --meta-pick /
+ * --meta-help / --meta-version 由 runRouter 消费，[MUST NOT] 透传给 claude。
+ */
+export declare const createAsSubcommand: () => CommandModule;
+
+/**
+ * REQ-3 内置 deepseek 模板。键集合与 requirements REQ-3 表逐键一致；
+ * ANTHROPIC_AUTH_TOKEN 恒为空字符串（绝不含真实 token）。
+ */
+export declare const DEEPSEEK_TEMPLATE: ProfileConfig;
+
+/**
+ * 找出值严格等于 `""` 的键（纯函数，可单测）。
+ * 仅严格空字符串命中（"REPLACE_ME" 等非空占位不算）；按 Object.keys 插入顺序返回。
+ */
+export declare const findEmptyKeys: (env: Record<string, string>) => string[];
+
+/**
+ * REQ-7 层 2 纯判定（纯函数，可单测）：返回 settings.json env 块中
+ * 命中模型路由类判定的 key 列表（判定规则与层 1 完全一致）。
+ */
+export declare const hasModelEnvConflict: (settingsEnvObj: Record<string, unknown> | null | undefined) => string[];
+
+/** 键名是否为敏感（token 类）键（纯函数，可单测）。 */
+export declare const isSecretKey: (key: string) => boolean;
+
+/** 固定遮蔽：不含任何明文片段（纯函数，可单测，REQ-6 报错脱敏用）。 */
+export declare const maskValue: (v: string) => string;
+
+/** meta 动作：run=透传启动 / profile=显式指定 / pick=交互选择 / help / version */
+export declare type MetaAction = "run" | "profile" | "pick" | "help" | "version";
+
+/**
+ * 解析 argv（纯函数，可单测）。
+ * meta 自身命令面（REQ-1）：--meta-profile=<name>（多个取最后一个生效）、
+ * --meta-pick / --meta-help / --meta-version，按 REQ-6 优先级归并 action，
+ * 被消费项均不入 passthrough；未知 --meta-* 前缀 fail-fast throw；
+ * 其余所有参数按原始顺序原样收集，[MUST NOT] trim/去引号/合并/重排/校验。
+ */
+export declare const parseArgv: (argv: string[]) => ParsedArgv;
+
+/** argv 解析结果：meta 动作归并 + 消费的 --meta-profile + 其余原样透传 */
+export declare interface ParsedArgv {
+    action: MetaAction;
+    profileName?: string;
+    passthrough: string[];
+}
+
+/** 单个 profile：可选描述 + env 注入键值 */
+export declare interface Profile {
+    describe?: string;
+    env: Record<string, string>;
+}
+
+/**
+ * profile 配置文件唯一路径：~/.done-coding/cc-switch/profile.json
+ * `~` 不写死具体用户，由 os.homedir() 解析当前用户 home。
+ */
+export declare const PROFILE_PATH: string;
+
+/** profile 配置文件结构（~/.done-coding/cc-switch/profile.json） */
+export declare interface ProfileConfig {
+    defaultProfile: string;
+    profiles: Record<string, Profile>;
+}
+
+/**
+ * 选择 profile（纯函数，可单测）。
+ * 有 profileName 用之，否则用 cfg.defaultProfile。
+ * 目标不存在 / defaultProfile 悬空 → throw（列可用名 + 配置路径），
+ * [MUST NOT] 猜最近名 / 回退 default。profile.env 为空 `{}` 合法。
+ */
+export declare const selectProfile: (cfg: ProfileConfig, profileName?: string) => {
+    name: string;
+    profile: Profile;
+};
+
+export { }