@yhong91/cpac 0.1.12 → 0.1.14

package/README.md

@@ -10,7 +10,7 @@ CPAC 将 Codex 和 Claude Code 接入远端 CLIProxyAPI（CPA）：
 ## 要求
 
 - [Node.js](https://nodejs.org/) 20 或更新版本（npm 随 Node 安装）
-- 已安装需要使用的 agent：`codex` 或 `claude`
+- 已安装需要使用的 agent：`codex`、`claude`、`pi`、`kimi` 或 `opencode`
 - 有权访问的 CPA API key
 
 ## 安装
@@ -31,6 +31,41 @@ npm install -g .
 cpac
 ```
 
+## 快速上手
+
+```bash
+# 1. 安装
+npm install -g @yhong91/cpac
+
+# 2. 配置密钥：无参数运行进入交互引导，自动写入 shell 启动文件；
+#    也可手动写入（zsh 示例）：
+cpac
+echo 'export CPA_API_KEY="<你的key>"' >> ~/.zshrc && source ~/.zshrc
+
+# 3. 验证
+cpac status
+
+# 4a. 持久注入（长期生效，写入 agent 配置，可完整恢复）
+cpac install --all                     # 注入所有检测到的目标（codex/pi/kimi）
+cpac install --target codex            # 只注入 Codex（默认开启 multi-agent v2）
+cpac install --target codex --v2_models  # 先多选 spawn_agent 模型再注入
+cpac uninstall --target codex          # 字节级恢复原配置
+
+# 4b. 临时接管（退出无痕，不写任何配置文件）
+cpac claude                            # Claude Code 走 CPA
+cpac opencode                          # opencode 走 CPA（模型选 cpac/<模型名>）
+
+# 5. 可选：Claude 模型槽位配置（持久缓存，每次 cpac claude 自动生效）
+cpac claude-models --haiku             # 下拉选择 haiku 槽模型
+cpac claude-models --classifier <模型>  # Auto mode 审批分类器模型
+
+# 6. 升级
+cpac upgrade --check
+npm install -g @yhong91/cpac@latest
+```
+
+各命令的完整参数与行为见下方对应章节。
+
 ## 首次引导
 
 无参数运行 `cpac` 会显示当前 CPA、密钥状态和可用命令：
@@ -157,7 +192,7 @@ Claude Code 的发现协议不携带 context 信息，claude 前缀的未知模
 注入 CPA 模型目录：
 
 ```bash
-cpac inject
+cpac inject [--v2_off] [--v2_models] [--config PATH]
 ```
 
 查看状态：

package/dist/cpac.js

@@ -734,6 +734,10 @@ export async function createLoopbackProxy(cpaUrl, apiKey, proxyId, port) {
                 response.end(JSON.stringify({ error: "CPA upstream request failed" }));
         });
         request.once("aborted", () => upstream.destroy());
+        response.once("close", () => {
+            if (!response.writableEnded)
+                upstream.destroy();
+        });
         request.pipe(upstream);
     });
     server.on("upgrade", (_request, socket) => {
@@ -941,6 +945,11 @@ export async function createClaudeProxy(cpaUrl, apiKey) {
                 if (!response.writableEnded)
                     response.end(JSON.stringify({ error: "CPA upstream request failed" }));
             });
+            request.once("aborted", () => upstream.destroy());
+            response.once("close", () => {
+                if (!response.writableEnded)
+                    upstream.destroy();
+            });
             upstream.end(body);
         });
     });
@@ -1980,7 +1989,8 @@ export async function runUpgrade(checkOnly) {
 function usage() {
     return [
         "Usage: cpac",
-        "       cpac <inject|status|restore> [--config PATH]",
+        "       cpac inject [--v2_off] [--v2_models] [--config PATH]",
+        "       cpac <status|restore> [--config PATH]",
         "       cpac proxy [--config PATH]",
         "       cpac claude [--config PATH] [--] [claude args...]",
         "       cpac opencode [--config PATH] [--] [opencode args...]",
@@ -2166,6 +2176,8 @@ function parseArgs(args) {
     }
     let configPath = defaultConfigPath();
     const positional = [];
+    let v2Off = false;
+    let v2Models = false;
     for (let index = 0; index < args.length; index += 1) {
         if (args[index] === "--config") {
             const value = args[++index];
@@ -2173,6 +2185,12 @@ function parseArgs(args) {
                 throw new CPACError("--config requires a path");
             configPath = resolve(expandUserPath(value));
         }
+        else if (args[index] === "--v2_off" || args[index] === "--v2-off") {
+            v2Off = true;
+        }
+        else if (args[index] === "--v2_models" || args[index] === "--v2-models") {
+            v2Models = true;
+        }
         else if (args[index].startsWith("-")) {
             throw new CPACError(`unknown option: ${args[index]}`);
         }
@@ -2183,6 +2201,12 @@ function parseArgs(args) {
         !["inject", "status", "restore", "proxy"].includes(positional[0])) {
         throw new CPACError(usage());
     }
+    if (positional[0] !== "inject" && (v2Off || v2Models)) {
+        throw new CPACError("--v2_off / --v2_models is only valid with inject or install");
+    }
+    if (positional[0] === "inject") {
+        return { command: "inject", configPath, v2Off, v2Models };
+    }
     return {
         command: positional[0],
         configPath,
@@ -2244,8 +2268,16 @@ export async function main(args = process.argv.slice(2)) {
             return await runPi(config, parsed.action);
         if (parsed.command === "kimi")
             return await runKimi(config, parsed.action);
-        if (parsed.command === "inject")
-            await inject(config);
+        if (parsed.command === "inject") {
+            let injectConfig = config;
+            if (parsed.v2Models) {
+                const picked = await pickSpawnModels(config);
+                saveSpawnModels(parsed.configPath, picked);
+                console.log(`spawn_models saved to ${parsed.configPath}: ${picked.join(", ")}`);
+                injectConfig = { ...config, spawn_models: picked };
+            }
+            await inject(injectConfig, parsed.v2Off);
+        }
         else if (parsed.command === "restore")
             await restore(config);
         else

package/dist/pi-extension.template

@@ -5,6 +5,7 @@ const CPA = "__CPA_URL__";
 const BUILTIN = new Set(["openai", "github-copilot", "xai", "deepseek", "anthropic", "google"]);
 const VENDOR_PREFIXES = [
   ["gpt-", "openai"], ["o1-", "openai"], ["o3-", "openai"], ["o4-", "openai"],
+  ["gpt-image", "openai"],
   ["claude-", "anthropic"], ["gemini-", "google"], ["grok-", "xai"],
   ["deepseek-", "deepseek"], ["glm-", "zhipu"], ["kimi-", "moonshot"],
   ["mimo-", "xiaomi"], ["doubao-", "volcengine"], ["ark-", "volcengine"],
@@ -21,6 +22,9 @@ const MAX_TOKENS = {
   "doubao-seed-2.0-lite": 128000, "doubao-seed-2.1-turbo": 128000,
 };
 const DEFAULT_MAX_TOKENS = 65536;
+const REASONING_EFFORTS = new Set([
+  "minimal", "low", "medium", "high", "xhigh", "max", "ultra",
+]);
 
 function vendorFor(slug) {
   for (const [prefix, vendor] of VENDOR_PREFIXES) {
@@ -33,6 +37,32 @@ function groupName(vendor) {
   return BUILTIN.has(vendor) ? vendor + "-cpa" : vendor;
 }
 
+function effortsFor(row) {
+  const levels = row.supported_reasoning_levels;
+  if (!Array.isArray(levels)) return undefined;
+  const efforts = levels.flatMap(function (level) {
+    if (!level || typeof level !== "object") return [];
+    const effort = level.effort;
+    return typeof effort === "string" && REASONING_EFFORTS.has(effort) ? [effort] : [];
+  });
+  return efforts.length > 0 ? efforts : undefined;
+}
+
+function thinkingLevelMapFor(efforts) {
+  if (!efforts || !efforts.some(function (effort) { return REASONING_EFFORTS.has(effort); })) {
+    return undefined;
+  }
+  const available = new Set(efforts);
+  return {
+    minimal: available.has("minimal") ? "minimal" : available.has("low") ? "low" : null,
+    low: available.has("low") ? "low" : null,
+    medium: available.has("medium") ? "medium" : null,
+    high: available.has("high") ? "high" : null,
+    xhigh: available.has("xhigh") ? "xhigh" : null,
+    max: available.has("max") || available.has("ultra") ? "max" : null,
+  };
+}
+
 function intField(value) {
   return typeof value === "number" && Number.isFinite(value) && value > 0
     ? Math.floor(value) : undefined;
@@ -72,7 +102,12 @@ export default async function (pi) {
     const slug = typeof m.slug === "string" && m.slug.trim()
       ? m.slug.trim()
       : typeof m.id === "string" && m.id.trim() ? m.id.trim() : null;
-    if (slug) rows.push({ slug: slug, display_name: m.display_name, supported_reasoning_levels: m.supported_reasoning_levels, context_window: m.context_window });
+    if (slug) rows.push({
+      slug: slug,
+      display_name: m.display_name,
+      supported_reasoning_levels: m.supported_reasoning_levels,
+      context_window: m.context_window,
+    });
   }
   if (rows.length === 0) {
     console.error("[cpac] CPA models response has no usable models");
@@ -92,15 +127,19 @@ export default async function (pi) {
       apiKey: apiKey,
       api: "openai-responses",
       models: models.map(function (m) {
-        return {
+        const efforts = effortsFor(m);
+        const thinkingLevelMap = thinkingLevelMapFor(efforts);
+        const modelObj = {
           id: m.slug,
           name: typeof m.display_name === "string" ? m.display_name : m.slug,
-          reasoning: Array.isArray(m.supported_reasoning_levels) && m.supported_reasoning_levels.length > 0,
+          reasoning: efforts === undefined || thinkingLevelMap !== undefined,
           input: ["text", "image"],
           cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
           contextWindow: intField(m.context_window) || 200000,
           maxTokens: MAX_TOKENS[m.slug] || DEFAULT_MAX_TOKENS,
         };
+        if (thinkingLevelMap) modelObj.thinkingLevelMap = thinkingLevelMap;
+        return modelObj;
       }),
     });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yhong91/cpac",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Connect Codex and Claude Code to a remote CLIProxyAPI gateway",
   "type": "module",
   "bin": {