cctra 0.3.0

package/src/core/model-fetch.ts

@@ -0,0 +1,124 @@
+// 占位：从上游拉模型列表（带 3 层缓存：内存 → 磁盘 → 网络）
+// 完整实现会照搬 ccswi/src/models/api.ts 的 getAllModelNames 逻辑
+// v1 先用空实现，CLI add 时手动填模型 ID 也行
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { modelsCachePath, ensureCctraDir } from "../utils/paths";
+import type { ApiFormat } from "../types";
+
+export interface FetchModelsOptions {
+  endpoint: string;
+  token: string;
+  apiFormat: ApiFormat;
+  modelsPath?: string;       // 默认 "/v1/models"
+  ttlMs?: number;            // 默认 24h
+}
+
+interface ModelCacheEntry {
+  models: string[];
+  expiresAt: number;
+}
+
+const memoryCache = new Map<string, ModelCacheEntry>();
+
+const DEFAULT_TTL = 24 * 60 * 60 * 1000; // 24h
+const OPENROUTER_FALLBACK = "https://openrouter.ai/api/v1/models";
+
+/**
+ * 从上游拉模型列表（带 3 层缓存 + OpenRouter fallback）
+ * 1. 试上游 endpoint 的 /v1/models
+ * 2. 失败 → fallback 到 OpenRouter（去 :free 后缀 + 去 provider 前缀）
+ * 3. 网络都失败 → 返回空数组（add wizard 会用手动输入 fallback）
+ */
+export async function fetchUpstreamModels(opts: FetchModelsOptions): Promise<string[]> {
+  const ttl = opts.ttlMs ?? DEFAULT_TTL;
+  const path = opts.modelsPath ?? "/v1/models";
+  const key = `${opts.endpoint}|${path}`;
+
+  // L1: 内存
+  const mem = memoryCache.get(key);
+  if (mem && mem.expiresAt > Date.now()) return mem.models;
+
+  // L2: 磁盘
+  ensureCctraDir();
+  const cachePath = modelsCachePath();
+  if (existsSync(cachePath)) {
+    try {
+      const disk = JSON.parse(readFileSync(cachePath, "utf-8")) as Record<string, ModelCacheEntry>;
+      const entry = disk[key];
+      if (entry && entry.expiresAt > Date.now()) {
+        memoryCache.set(key, entry);
+        return entry.models;
+      }
+    } catch {
+      // ignore disk cache error
+    }
+  }
+
+  // L3: 网络 — 先试上游
+  const url = joinUrl(opts.endpoint, path);
+  const headers: Record<string, string> = {};
+  if (opts.token) headers["Authorization"] = `Bearer ${opts.token}`;
+
+  let models = await tryFetchModels(url, headers);
+
+  // L4: Fallback 到 OpenRouter
+  if (models.length === 0) {
+    const fallback = await tryFetchModels(OPENROUTER_FALLBACK, {});
+    models = sanitizeOpenRouterModels(fallback);
+  }
+
+  // 回写缓存
+  const entry: ModelCacheEntry = { models, expiresAt: Date.now() + ttl };
+  memoryCache.set(key, entry);
+  try {
+    mkdirSync(dirname(cachePath), { recursive: true });
+    let disk: Record<string, ModelCacheEntry> = {};
+    if (existsSync(cachePath)) {
+      disk = JSON.parse(readFileSync(cachePath, "utf-8")) as Record<string, ModelCacheEntry>;
+    }
+    disk[key] = entry;
+    writeFileSync(cachePath, JSON.stringify(disk, null, 2), "utf-8");
+  } catch {
+    // ignore
+  }
+  return models;
+}
+
+/**
+ * 拉单个端点的 models（无 auth header 因为 OpenRouter fallback 不带 token）
+ */
+async function tryFetchModels(url: string, headers: Record<string, string>): Promise<string[]> {
+  try {
+    const res = await fetch(url, { headers, signal: AbortSignal.timeout(5000) });
+    if (res.ok) {
+      const body = await res.json() as { data?: Array<{ id: string }> };
+      return (body.data ?? []).map((m) => m.id);
+    }
+  } catch {
+    // 网络/超时失败
+  }
+  return [];
+}
+
+/**
+ * 清理 OpenRouter 返回的模型名（抄 ccswi 规则）
+ * - 去掉 :free 后缀
+ * - 去掉 provider 前缀（org/model → model）
+ */
+function sanitizeOpenRouterModels(models: string[]): string[] {
+  return models.flatMap((id) => {
+    if (id.endsWith(":free")) return [];
+    const slashIdx = id.indexOf("/");
+    return slashIdx > 0 ? [id.slice(slashIdx + 1)] : [id];
+  });
+}
+
+function joinUrl(base: string, path: string): string {
+  const b = base.replace(/\/+$/, "");
+  const p = path.startsWith("/") ? path : `/${path}`;
+  // 避免 /v1/v1 重复
+  if (b.endsWith("/v1") && p.startsWith("/v1/")) return `${b}${p.slice(3)}`;
+  if (b.endsWith("/v1beta") && p.startsWith("/v1beta/")) return `${b}${p.slice(7)}`;
+  return `${b}${p}`;
+}

package/src/core/resolve.ts

@@ -0,0 +1,73 @@
+import type { Config, Source, Model } from "../types";
+import { getSource } from "./source";
+import { resolveTier } from "../tier/resolve";
+
+/**
+ * 解析模型引用字符串，返回 (Source, upstreamModelId, apiFormat)
+ *
+ * 解析优先级：
+ *   1. tier 名字（cctra / cctra-pro / cctra-flash / cctra-vision 或用户自建）
+ *   2. "sub/model" 或 "plugin/model"（按 / 拆分）
+ *   3. 全局 alias（在所有 source 的 model.alias 里找）
+ *   4. 都不匹配 → null
+ */
+export function resolveModelRef(
+  ref: string,
+  config: Config,
+): { source: Source; modelId: string } | null {
+  if (!ref) return null;
+
+  const trimmed = ref.trim();
+
+  // 1. tier 名字
+  const tierResolved = resolveTier(trimmed, config);
+  if (tierResolved) return tierResolved;
+
+  // 2. "sub/model" 格式
+  if (trimmed.includes("/")) {
+    const [sourceName, modelPart] = trimmed.split("/", 2);
+    if (!sourceName || !modelPart) return null;
+    const source = getSource(config, sourceName);
+    if (!source) return null;
+    const model = findModelInSource(source, modelPart);
+    if (!model) return null;
+    return { source, modelId: model.id };
+  }
+
+  // 3. 全局 alias
+  const aliasMatches: Array<{ source: Source; modelId: string }> = [];
+  for (const source of Object.values(config.subscriptions)) {
+    const m = findModelInSource(source, trimmed);
+    if (m) aliasMatches.push({ source, modelId: m.id });
+  }
+  for (const plugin of Object.values(config.plugins)) {
+    if (!plugin.enabled) continue;
+    const m = findModelInSource(plugin, trimmed);
+    if (m) aliasMatches.push({ source: plugin, modelId: m.id });
+  }
+  if (aliasMatches.length === 1) return aliasMatches[0]!;
+  if (aliasMatches.length > 1) {
+    // 多个匹配：抛错（上层包装成 400）
+    const names = aliasMatches.map((m) => `${m.source.name}/${m.modelId}`).join(", ");
+    throw new ResolveError(`Ambiguous model alias "${trimmed}". Candidates: ${names}`);
+  }
+
+  return null;
+}
+
+/** 在 source 的 models 列表里按 id 或 alias 找 */
+function findModelInSource(source: Source, ref: string): Model | null {
+  return (
+    source.models.find((m) => m.id === ref) ??
+    source.models.find((m) => m.alias === ref) ??
+    null
+  );
+}
+
+/** 解析错误（用 throw 表达歧义或不存在） */
+export class ResolveError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "ResolveError";
+  }
+}

package/src/core/routing.ts

@@ -0,0 +1,31 @@
+import type { Config, Source, ApiFormat } from "../types";
+import { resolveModelRef, ResolveError } from "./resolve";
+import { getApiFormat } from "./source";
+
+/**
+ * 把客户端 model 字段解析成完整的路由信息
+ * 给 HTTP handler 用
+ */
+export interface RouteInfo {
+  source: Source;
+  upstreamModelId: string;
+  apiFormat: ApiFormat;
+}
+
+export function resolveRoute(model: string, config: Config): RouteInfo {
+  let resolved: { source: Source; modelId: string } | null = null;
+  try {
+    resolved = resolveModelRef(model, config);
+  } catch (e) {
+    if (e instanceof ResolveError) throw e;
+    throw e;
+  }
+  if (!resolved) {
+    throw new ResolveError(`Unknown model: "${model}". Use \`cctra tier set\`, \`cctra model\`, or \`sub/model\` format.`);
+  }
+  return {
+    source: resolved.source,
+    upstreamModelId: resolved.modelId,
+    apiFormat: getApiFormat(resolved.source),
+  };
+}

package/src/core/source.ts

@@ -0,0 +1,28 @@
+import type { Config, Source, Subscription, PluginConfig, ApiFormat } from "../types";
+
+/** 把 Subscription 和 PluginConfig 都视为统一的 Source */
+export function getAllSources(config: Config): Source[] {
+  const subs = Object.values(config.subscriptions);
+  const plugins = Object.values(config.plugins).filter((p) => p.enabled);
+  return [...subs, ...plugins];
+}
+
+export function getSource(config: Config, name: string): Source | null {
+  return config.subscriptions[name] ?? config.plugins[name] ?? null;
+}
+
+/** 判断 source 是不是 plugin */
+export function isPlugin(s: Source): s is PluginConfig {
+  return s.kind === "plugin";
+}
+
+/** 判断 source 是不是 subscription */
+export function isSubscription(s: Source): s is Subscription {
+  return s.kind === "subscription";
+}
+
+/** Source 的 API 格式（plugin 的格式由 plugin 实例决定，先用 openai-chat 占位） */
+export function getApiFormat(s: Source): ApiFormat {
+  if (isSubscription(s)) return s.apiFormat;
+  return "openai-chat"; // 插件默认；具体以插件 getConfig 返回的 UpstreamReady.apiFormat 为准
+}

package/src/daemon/install.ts

@@ -0,0 +1,47 @@
+// ============================================================================
+// 平台分发：根据 process.platform 调对应的 installer
+// ============================================================================
+import { installWindows, isInstalledWindows, uninstallWindows } from "./platform/windows";
+import { installMacOS, isInstalledMacOS, uninstallMacOS } from "./platform/macos";
+import { installLinux, isInstalledLinux, uninstallLinux } from "./platform/linux";
+
+export interface InstallOptions {
+  /** 启动器 .exe 路径（Windows 专用） */
+  bundledLauncherPath?: string;
+  /** daemon 入口 .ts 路径（macOS / Linux 用） */
+  daemonEntrypoint: string;
+}
+
+export function install(opts: InstallOptions): void {
+  const platform = process.platform;
+  if (platform === "win32") {
+    if (!opts.bundledLauncherPath) {
+      throw new Error("Windows install requires bundledLauncherPath");
+    }
+    installWindows(opts.bundledLauncherPath);
+  } else if (platform === "darwin") {
+    installMacOS(opts.daemonEntrypoint);
+  } else if (platform === "linux") {
+    installLinux(opts.daemonEntrypoint);
+  } else {
+    throw new Error(`Unsupported platform: ${platform}`);
+  }
+  // 顶层不写 logger.info —— 外层 commands/daemon.ts 已有 success() 友好提示
+}
+
+export function uninstall(): void {
+  const platform = process.platform;
+  if (platform === "win32") uninstallWindows();
+  else if (platform === "darwin") uninstallMacOS();
+  else if (platform === "linux") uninstallLinux();
+  else throw new Error(`Unsupported platform: ${platform}`);
+  // 顶层不写 logger.info —— 外层 commands/daemon.ts 已有 success() 友好提示
+}
+
+export function isInstalled(): boolean {
+  const platform = process.platform;
+  if (platform === "win32") return isInstalledWindows();
+  if (platform === "darwin") return isInstalledMacOS();
+  if (platform === "linux") return isInstalledLinux();
+  return false;
+}

package/src/daemon/platform/linux.ts

@@ -0,0 +1,65 @@
+// ============================================================================
+// Linux：写 ~/.config/systemd/user/cctra.service + systemctl --user enable
+// ============================================================================
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { daemonLogPath } from "../../utils/paths";
+import { info } from "../../ui/format";
+
+const UNIT_NAME = "cctra.service";
+const UNIT_PATH = join(homedir(), ".config", "systemd", "user", UNIT_NAME);
+
+export function installLinux(daemonEntrypoint: string, bunPath: string = "/usr/bin/env"): void {
+  if (process.platform !== "linux") {
+    throw new Error("installLinux should only be called on Linux");
+  }
+
+  mkdirSync(join(homedir(), ".config", "systemd", "user"), { recursive: true });
+  const unit = generateUnit(daemonEntrypoint, bunPath);
+  writeFileSync(UNIT_PATH, unit, "utf-8");
+  info(`wrote unit to ${UNIT_PATH}`);
+
+  try {
+    execSync("systemctl --user daemon-reload", { stdio: "pipe" });
+    execSync("systemctl --user enable --now cctra.service", { stdio: "pipe" });
+    info(`enabled and started ${UNIT_NAME}`);
+  } catch (e) {
+    throw new Error(`systemctl failed: ${(e as Error).message}`);
+  }
+}
+
+export function uninstallLinux(): void {
+  if (process.platform !== "linux") return;
+  try {
+    execSync("systemctl --user disable --now cctra.service", { stdio: "pipe" });
+  } catch { /* not enabled */ }
+  if (existsSync(UNIT_PATH)) unlinkSync(UNIT_PATH);
+  try {
+    execSync("systemctl --user daemon-reload", { stdio: "pipe" });
+  } catch { /* ignore */ }
+}
+
+export function isInstalledLinux(): boolean {
+  return process.platform === "linux" && existsSync(UNIT_PATH);
+}
+
+function generateUnit(daemonEntrypoint: string, _bunPath: string): string {
+  const log = daemonLogPath();
+  return `[Unit]
+Description=cctra daemon
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=/usr/bin/env bun run ${daemonEntrypoint}
+Restart=always
+RestartSec=3
+StandardOutput=append:${log}
+StandardError=append:${log}
+
+[Install]
+WantedBy=default.target
+`;
+}

package/src/daemon/platform/macos.ts

@@ -0,0 +1,71 @@
+// ============================================================================
+// macOS：写 ~/Library/LaunchAgents/com.cctra.daemon.plist + launchctl bootstrap
+// 完全无 UI 痕迹（plain CLI + LaunchAgent = brew services 同款）
+// ============================================================================
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { daemonLogPath } from "../../utils/paths";
+import { info } from "../../ui/format";
+
+const PLIST_LABEL = "com.cctra.daemon";
+const PLIST_PATH = join(homedir(), "Library", "LaunchAgents", `${PLIST_LABEL}.plist`);
+
+export function installMacOS(daemonEntrypoint: string, bunPath: string = "/usr/bin/env"): void {
+  if (process.platform !== "darwin") {
+    throw new Error("installMacOS should only be called on macOS");
+  }
+
+  mkdirSync(join(homedir(), "Library", "LaunchAgents"), { recursive: true });
+  const plist = generatePlist(daemonEntrypoint, bunPath);
+  writeFileSync(PLIST_PATH, plist, "utf-8");
+  info(`wrote plist to ${PLIST_PATH}`);
+
+  // 用 modern bootstrap 语法（避免 Apple Silicon deprecation warning）
+  const uid = process.getuid?.() ?? execSync("id -u").toString().trim();
+  try {
+    execSync(`launchctl bootstrap gui/${uid} "${PLIST_PATH}"`, { stdio: "pipe" });
+    info(`bootstrapped ${PLIST_LABEL}`);
+  } catch (e) {
+    // 可能已存在，先 bootout 再 bootstrap
+    try {
+      execSync(`launchctl bootout gui/${uid}/${PLIST_LABEL}`, { stdio: "pipe" });
+    } catch { /* ignore */ }
+    execSync(`launchctl bootstrap gui/${uid} "${PLIST_PATH}"`, { stdio: "pipe" });
+    info(`bootstrapped ${PLIST_LABEL}`);
+  }
+}
+
+export function uninstallMacOS(): void {
+  if (process.platform !== "darwin") return;
+  const uid = process.getuid?.() ?? execSync("id -u").toString().trim();
+  try {
+    execSync(`launchctl bootout gui/${uid}/${PLIST_LABEL}`, { stdio: "pipe" });
+  } catch { /* not loaded */ }
+  if (existsSync(PLIST_PATH)) unlinkSync(PLIST_PATH);
+}
+
+export function isInstalledMacOS(): boolean {
+  return process.platform === "darwin" && existsSync(PLIST_PATH);
+}
+
+function generatePlist(daemonEntrypoint: string, bunPath: string): string {
+  const log = daemonLogPath();
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>Label</key><string>${PLIST_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${bunPath}</string>
+    <string>bun</string>
+    <string>run</string>
+    <string>${daemonEntrypoint}</string>
+  </array>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><true/>
+  <key>StandardOutPath</key><string>${log}</string>
+  <key>StandardErrorPath</key><string>${log}</string>
+</dict></plist>`;
+}

package/src/daemon/platform/windows.ts

@@ -0,0 +1,70 @@
+// ============================================================================
+// Windows：注册表 HKCU\Run（无 UAC）+ 拷贝 Rust 启动器到 ~/.cctra/bin/
+// ============================================================================
+import { execSync } from "node:child_process";
+import { copyFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { ensureCctraDir, windowsLauncherPath } from "../../utils/paths";
+import { info } from "../../ui/format";
+
+const REG_KEY = `HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run`;
+const REG_NAME = "cctra";
+
+/** 把 Rust 启动器从 src-tauri/ 拷贝到 ~/.cctra/bin/，然后注册到 Run key */
+export function installWindows(bundledLauncherPath: string): void {
+  if (process.platform !== "win32") {
+    throw new Error("installWindows should only be called on Windows");
+  }
+
+  ensureCctraDir();
+  const dest = windowsLauncherPath();
+  mkdirSync(dirname(dest), { recursive: true });
+
+  // 拷贝 .exe
+  if (!existsSync(bundledLauncherPath)) {
+    throw new Error(`Bundled launcher not found: ${bundledLauncherPath}. Build it first with scripts/build-launcher.ps1`);
+  }
+  copyFileSync(bundledLauncherPath, dest);
+  info(`copied launcher to ${dest}`);
+
+  // 写注册表（HKCU 不需要管理员）
+  const cmd = `reg add "${REG_KEY}" /v ${REG_NAME} /t REG_SZ /d "\"${dest}\"" /f`;
+  try {
+    execSync(cmd, { stdio: "pipe" });
+    info(`registered ${REG_NAME} in ${REG_KEY}`);
+  } catch (e) {
+    throw new Error(`Failed to register Run key: ${(e as Error).message}`);
+  }
+}
+
+export function uninstallWindows(): void {
+  if (process.platform !== "win32") return;
+
+  try {
+    execSync(`reg delete "${REG_KEY}" /v ${REG_NAME} /f`, { stdio: "pipe" });
+    info(`removed ${REG_NAME} from ${REG_KEY}`);
+  } catch {
+    // 没注册过，跳过
+  }
+
+  const dest = windowsLauncherPath();
+  if (existsSync(dest)) {
+    try {
+      execSync(`del /f "${dest}"`, { stdio: "pipe" });
+      info(`removed launcher ${dest}`);
+    } catch {
+      // 删不掉（文件被占用等）不阻塞
+    }
+  }
+}
+
+/** 检测是否已注册 */
+export function isInstalledWindows(): boolean {
+  if (process.platform !== "win32") return false;
+  try {
+    const out = execSync(`reg query "${REG_KEY}" /v ${REG_NAME}`, { stdio: "pipe" }).toString();
+    return out.includes(REG_NAME);
+  } catch {
+    return false;
+  }
+}

package/src/daemon/start.ts

@@ -0,0 +1,22 @@
+// ============================================================================
+// 启动 daemon（后台拉起）
+// v1: 调用 OS 的 service manager（Windows 触发 HKCU Run / macOS launchctl / Linux systemctl）
+// v1 简化：直接 spawn 一个新的 bun 进程跑 serve，等价于不带 daemon 安装的启动方式
+// ============================================================================
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { info } from "../ui/format";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export async function startDaemon(): Promise<void> {
+  const indexPath = join(__dirname, "..", "index.ts");
+  const child = spawn("bun", ["run", indexPath, "serve"], {
+    detached: true,
+    stdio: "ignore",
+    windowsHide: true,
+  });
+  child.unref();
+  info(`started (pid=${child.pid})`);
+}

package/src/daemon/status.ts

@@ -0,0 +1,19 @@
+// ============================================================================
+// 状态查询：探测端口 /healthz
+// ============================================================================
+import { loadConfigFile } from "../core/config";
+
+export async function checkDaemonStatus(): Promise<{ running: boolean; port: number }> {
+  const config = loadConfigFile();
+  const port = config.port;
+  try {
+    const res = await fetch(`http://127.0.0.1:${port}/healthz`, { signal: AbortSignal.timeout(2000) });
+    if (res.ok) {
+      const data = await res.json() as { ok: boolean };
+      return { running: data.ok === true, port };
+    }
+    return { running: false, port };
+  } catch {
+    return { running: false, port };
+  }
+}

package/src/daemon/stop.ts

@@ -0,0 +1,58 @@
+// ============================================================================
+// 停止 daemon：探测端口占用进程并 kill
+// 端口从 config 读，与 serve 时绑定的端口保持一致
+// ============================================================================
+import { execSync } from "node:child_process";
+import { loadConfigFile } from "../core/config";
+import { info } from "../ui/format";
+
+export async function stopDaemon(): Promise<void> {
+  const port = loadConfigFile().port;
+
+  if (process.platform === "win32") {
+    // PowerShell 找占用 config.port 端口的进程
+    // -ErrorAction SilentlyContinue + 0 长度 = 找不到监听时 stdout 为空，exit 0
+    const out = execSync(
+      `powershell -NoProfile -Command "(Get-NetTCPConnection -LocalPort ${port} -State Listen -ErrorAction SilentlyContinue).OwningProcess"`,
+      { stdio: "pipe" },
+    ).toString();
+    const pids = Array.from(new Set(
+      out.split("\n").map((s) => s.trim()).filter((s) => /^\d+$/.test(s)),
+    ));
+    if (pids.length === 0) {
+      throw new Error(`No process is listening on port ${port} (daemon not running?)`);
+    }
+    for (const pid of pids) {
+      try {
+        execSync(`taskkill /F /PID ${pid}`, { stdio: "pipe" });
+        info(`killed pid ${pid}`);
+      } catch (e) {
+        throw new Error(`taskkill /F /PID ${pid} failed: ${(e as Error).message}`);
+      }
+    }
+    return;
+  }
+
+  // macOS / Linux：lsof 找 pid
+  let out: string;
+  try {
+    out = execSync(`lsof -ti :${port}`, { stdio: "pipe" }).toString();
+  } catch {
+    // lsof 找不到监听时 exit 1、stdout 为空
+    throw new Error(`No process is listening on port ${port} (daemon not running?)`);
+  }
+  const pids = Array.from(new Set(
+    out.split("\n").map((s) => s.trim()).filter((s) => /^\d+$/.test(s)),
+  ));
+  if (pids.length === 0) {
+    throw new Error(`No process is listening on port ${port} (daemon not running?)`);
+  }
+  for (const pid of pids) {
+    try {
+      execSync(`kill -TERM ${pid}`, { stdio: "pipe" });
+      info(`killed pid ${pid}`);
+    } catch (e) {
+      throw new Error(`kill -TERM ${pid} failed: ${(e as Error).message}`);
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,34 @@
+// ============================================================================
+// CLI 入口：commander 注册所有子命令
+// ============================================================================
+import { Command } from "commander";
+import { registerAdd } from "./commands/add";
+import { registerLs } from "./commands/ls";
+import { registerShow } from "./commands/show";
+import { registerRm } from "./commands/rm";
+import { registerRename } from "./commands/rename";
+import { registerModel } from "./commands/model";
+import { registerPlugin } from "./commands/plugin";
+import { registerTier } from "./commands/tier";
+import { registerDaemon } from "./commands/daemon";
+import { registerServe } from "./commands/serve";
+import pkg from "../package.json";
+
+const program = new Command();
+program
+  .name("cctra")
+  .description("Local LLM subscription protocol converter + plugin host")
+  .version(pkg.version, "-v, --version");
+
+registerAdd(program);
+registerLs(program);
+registerShow(program);
+registerRm(program);
+registerRename(program);
+registerModel(program);
+registerPlugin(program);
+registerTier(program);
+registerDaemon(program);
+registerServe(program);
+
+program.parse(process.argv);