trinity-config 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Trinity
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# trinity-config
+
+> 一键把 [Trinity API](https://trinitydesk.ai) 接入 **Claude Code** 与 **Codex CLI** —— 粘贴 `xh-` Key 即用
+
+## 快速开始
+
+### 交互式（推荐）
+
+```bash
+npx -y trinity-config
+```
+
+### 一行命令
+
+```bash
+npx -y trinity-config -k xh-你的key
+```
+
+### 只配其中一个
+
+```bash
+npx -y trinity-config -k xh-你的key --only claude
+npx -y trinity-config -k xh-你的key --only codex
+```
+
+完成后：
+
+```bash
+claude   # Claude Code
+codex    # Codex CLI
+```
+
+## 工作原理
+
+1. 收集 Trinity API Key（`xh-` 前缀）
+2. 调用 [zcf](https://github.com/UfoMiao/zcf) 写入本地配置：
+   - Claude Code → `~/.claude/settings.json`（`ANTHROPIC_BASE_URL` = `https://api.trinitydesk.ai`）
+   - Codex → `~/.codex/config.toml`（Base = `https://api.trinitydesk.ai/v1`）
+3. `GET https://api.trinitydesk.ai/v1/models` 探测连通性
+
+## 命令行参数
+
+| 参数 | 简写 | 说明 |
+| --- | --- | --- |
+| `--api-key` | `-k` | Trinity API Key |
+| `--only` | | `claude` \| `codex` |
+| `--base-url` | | 默认 `https://api.trinitydesk.ai` |
+| `--claude-model` | | Claude 默认模型（默认 `claude-sonnet-4-6`） |
+| `--codex-model` | | Codex 默认模型（默认 `gpt-5.4`） |
+| `--skip-verify` | | 跳过连通性验证 |
+| `--verbose` | `-v` | 显示 zcf 详细输出 |
+| `--help` | `-h` | 帮助 |
+| `--version` | `-V` | 版本 |
+
+## 注意
+
+- 配置后**所有模型调用走 Trinity 计费**，不再使用 Anthropic/OpenAI 官方账号额度。
+- 工具内选择的模型名须为 Trinity 已上架的 `model_code`（可用 `GET /v1/models` 查看）。
+- Windows 下建议用 WSL2 运行 `claude` / `codex`；`npx trinity-config` 可在 PowerShell 执行。
+
+## 开发
+
+```bash
+cd tools/trinity-config
+npm install
+npm run build
+node dist/index.js --help
+```
+
+发版见仓库 `部署相关/trinity-config-npm发版说明.md`。
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,416 @@
+#!/usr/bin/env node
+// src/index.ts
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+
+// src/args.ts
+function printHelp() {
+  console.log(`
+trinity-config \u2014 \u4E00\u952E\u628A Trinity API \u63A5\u5165 Claude Code \u4E0E Codex CLI
+
+\u7528\u6CD5:
+  npx -y trinity-config [\u9009\u9879]
+
+\u9009\u9879:
+  -k, --api-key <key>       Trinity API Key\uFF08xh- \u524D\u7F00\uFF09
+  --only <tool>             \u53EA\u914D\u7F6E claude \u6216 codex
+  --base-url <url>          API \u6839\u5730\u5740\uFF08\u9ED8\u8BA4 ${"https://api.trinitydesk.ai"})
+  --claude-model <model>    Claude Code \u9ED8\u8BA4\u6A21\u578B
+  --codex-model <model>     Codex \u9ED8\u8BA4\u6A21\u578B
+  --skip-verify             \u8DF3\u8FC7 GET /v1/models \u8FDE\u901A\u6027\u68C0\u67E5
+  -v, --verbose             \u663E\u793A zcf \u8BE6\u7EC6\u8F93\u51FA
+  -h, --help                \u663E\u793A\u5E2E\u52A9
+  -V, --version             \u663E\u793A\u7248\u672C
+
+\u793A\u4F8B:
+  npx -y trinity-config
+  npx -y trinity-config -k xh-your-key
+  npx -y trinity-config -k xh-your-key --only claude
+`);
+}
+function parseArgs(argv) {
+  const opts = {
+    skipVerify: false,
+    verbose: false,
+    help: false,
+    version: false
+  };
+  const args = [...argv];
+  while (args.length > 0) {
+    const arg = args.shift();
+    if (!arg) break;
+    switch (arg) {
+      case "-h":
+      case "--help":
+        opts.help = true;
+        break;
+      case "-V":
+      case "--version":
+        opts.version = true;
+        break;
+      case "-v":
+      case "--verbose":
+        opts.verbose = true;
+        break;
+      case "--skip-verify":
+        opts.skipVerify = true;
+        break;
+      case "-k":
+      case "--api-key":
+        opts.apiKey = args.shift();
+        break;
+      case "--only": {
+        const only = args.shift();
+        if (only !== "claude" && only !== "codex") {
+          throw new Error("--only \u987B\u4E3A claude \u6216 codex");
+        }
+        opts.only = only;
+        break;
+      }
+      case "--base-url":
+        opts.baseUrl = args.shift();
+        break;
+      case "--claude-model":
+        opts.claudeModel = args.shift();
+        break;
+      case "--codex-model":
+        opts.codexModel = args.shift();
+        break;
+      default:
+        if (arg.startsWith("-")) {
+          throw new Error(`\u672A\u77E5\u53C2\u6570: ${arg}`);
+        }
+        throw new Error(`\u591A\u4F59\u53C2\u6570: ${arg}`);
+    }
+  }
+  if (opts.help) {
+    printHelp();
+  }
+  return opts;
+}
+function normalizeApiKey(raw) {
+  const key = raw.trim();
+  if (!key) {
+    throw new Error("API Key \u4E0D\u80FD\u4E3A\u7A7A");
+  }
+  return key.startsWith("xh-") ? key : `xh-${key}`;
+}
+
+// src/constants.ts
+var PACKAGE_NAME = "trinity-config";
+var PACKAGE_VERSION = "1.0.0";
+var TRINITY_BASE_URL = "https://api.trinitydesk.ai";
+var DEFAULT_CLAUDE_MODEL = "claude-sonnet-4-6";
+var DEFAULT_CLAUDE_FAST_MODEL = "claude-sonnet-4-6";
+var DEFAULT_CODEX_MODEL = "gpt-5.4";
+var VERIFY_TIMEOUT_MS = 15e3;
+
+// src/merge-claude-env.ts
+import fs from "fs";
+import os from "os";
+import path from "path";
+function claudeSettingsPath() {
+  return path.join(os.homedir(), ".claude", "settings.json");
+}
+function mergeClaudeEnv(claudeModel, fastModel, baseUrl) {
+  const filePath = claudeSettingsPath();
+  if (!fs.existsSync(filePath)) {
+    return;
+  }
+  const raw = fs.readFileSync(filePath, "utf8");
+  let settings;
+  try {
+    settings = JSON.parse(raw);
+  } catch {
+    return;
+  }
+  settings.env = {
+    ...settings.env ?? {},
+    ANTHROPIC_BASE_URL: baseUrl,
+    ANTHROPIC_MODEL: claudeModel,
+    ANTHROPIC_SMALL_FAST_MODEL: fastModel
+  };
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, `${JSON.stringify(settings, null, 2)}
+`, "utf8");
+}
+
+// src/zcf.ts
+import { execa } from "execa";
+function sharedZcfArgs(verbose) {
+  return [
+    "zcf",
+    "init",
+    "--skip-prompt",
+    "--provider",
+    "custom",
+    "--api-type",
+    "auth_token",
+    "--config-action",
+    "merge",
+    "--mcp-services",
+    "skip",
+    "--workflows",
+    "skip",
+    "--output-styles",
+    "skip",
+    "--install-cometix-line",
+    "false",
+    ...verbose ? [] : ["--lang", "en"]
+  ];
+}
+async function runZcfInit(options) {
+  const args = [
+    ...sharedZcfArgs(options.verbose),
+    "--code-type",
+    options.codeType,
+    "--api-url",
+    options.baseUrl,
+    "--api-key",
+    options.apiKey,
+    "--api-model",
+    options.primaryModel
+  ];
+  if (options.codeType === "cc" && options.fastModel) {
+    args.push("--api-haiku-model", options.fastModel);
+    args.push("--api-sonnet-model", options.primaryModel);
+  }
+  await execa("npx", ["-y", ...args], {
+    stdio: options.verbose ? "inherit" : "pipe",
+    reject: true,
+    timeout: 18e4
+  });
+}
+async function configureClaude(apiKey, baseUrl, claudeModel, verbose) {
+  await runZcfInit({
+    codeType: "cc",
+    apiKey,
+    baseUrl,
+    primaryModel: claudeModel,
+    fastModel: DEFAULT_CLAUDE_FAST_MODEL,
+    verbose
+  });
+}
+async function configureCodex(apiKey, codexBaseUrl, codexModel, verbose) {
+  await runZcfInit({
+    codeType: "cx",
+    apiKey,
+    baseUrl: codexBaseUrl,
+    primaryModel: codexModel,
+    verbose
+  });
+}
+function resolveBaseUrls(baseUrl) {
+  const root = (baseUrl ?? TRINITY_BASE_URL).replace(/\/+$/, "");
+  const codexBaseUrl = root.endsWith("/v1") ? root : `${root}/v1`;
+  const claudeBaseUrl = root.endsWith("/v1") ? root.slice(0, -3) : root;
+  return { claudeBaseUrl, codexBaseUrl };
+}
+function defaultModels(claudeModel, codexModel) {
+  return {
+    claudeModel: claudeModel ?? DEFAULT_CLAUDE_MODEL,
+    codexModel: codexModel ?? DEFAULT_CODEX_MODEL
+  };
+}
+
+// src/verify.ts
+import https from "https";
+function getJson(url, apiKey) {
+  return new Promise((resolve, reject) => {
+    const target = new URL(url);
+    const req = https.request(
+      {
+        protocol: target.protocol,
+        hostname: target.hostname,
+        port: target.port || 443,
+        path: `${target.pathname}${target.search}`,
+        method: "GET",
+        headers: {
+          Accept: "application/json",
+          Authorization: `Bearer ${apiKey}`
+        },
+        timeout: VERIFY_TIMEOUT_MS
+      },
+      (res) => {
+        const chunks = [];
+        res.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+        res.on("end", () => {
+          const text2 = Buffer.concat(chunks).toString("utf8");
+          let body;
+          try {
+            body = JSON.parse(text2);
+          } catch {
+            reject(new Error(`\u54CD\u5E94\u4E0D\u662F JSON\uFF08HTTP ${res.statusCode}\uFF09`));
+            return;
+          }
+          resolve({ statusCode: res.statusCode ?? 0, body });
+        });
+      }
+    );
+    req.on("timeout", () => {
+      req.destroy();
+      reject(new Error(`\u8FDE\u63A5\u8D85\u65F6\uFF08>${VERIFY_TIMEOUT_MS}ms\uFF09`));
+    });
+    req.on("error", reject);
+    req.end();
+  });
+}
+async function verifyTrinityApi(apiKey, baseUrl = TRINITY_BASE_URL) {
+  const root = baseUrl.replace(/\/+$/, "");
+  const modelsUrl = `${root}/v1/models`;
+  try {
+    const { statusCode, body } = await getJson(modelsUrl, apiKey);
+    if (statusCode === 401 || statusCode === 403) {
+      return {
+        ok: false,
+        statusCode,
+        message: "API Key \u65E0\u6548\u6216\u5DF2\u7981\u7528\uFF08HTTP 401/403\uFF09"
+      };
+    }
+    if (statusCode === 404) {
+      return {
+        ok: false,
+        statusCode,
+        message: "Base URL \u9519\u8BEF\uFF08\u662F\u5426\u591A\u5199\u4E86 /v1\uFF1F\u5E94\u4F7F\u7528 https://api.trinitydesk.ai\uFF09"
+      };
+    }
+    if (statusCode < 200 || statusCode >= 300) {
+      return {
+        ok: false,
+        statusCode,
+        message: `GET /v1/models \u5931\u8D25\uFF08HTTP ${statusCode}\uFF09`
+      };
+    }
+    const modelIds = (body.data ?? []).map((item) => item.id).filter(Boolean);
+    if (body.object !== "list" && modelIds.length === 0) {
+      return {
+        ok: true,
+        statusCode,
+        message: "\u5DF2\u8FDE\u901A\uFF0C\u4F46\u6A21\u578B\u5217\u8868\u683C\u5F0F\u975E\u5E38\u89C4",
+        modelIds
+      };
+    }
+    return {
+      ok: true,
+      statusCode,
+      message: `\u8FDE\u901A\u6210\u529F\uFF08${modelIds.length} \u4E2A\u6A21\u578B\uFF09`,
+      modelIds
+    };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.includes("ENOTFOUND") || message.includes("ECONNREFUSED")) {
+      return { ok: false, message: `\u65E0\u6CD5\u8FDE\u63A5 ${root}\uFF1A${message}` };
+    }
+    return { ok: false, message: `\u8FDE\u901A\u6027\u68C0\u67E5\u5931\u8D25\uFF1A${message}` };
+  }
+}
+function pickRecommendedModels(modelIds) {
+  const claude = modelIds.find((id) => id === DEFAULT_CLAUDE_MODEL) ?? modelIds.find((id) => id.includes("claude-sonnet")) ?? modelIds.find((id) => id.toLowerCase().includes("claude"));
+  const codex = modelIds.find((id) => id === DEFAULT_CODEX_MODEL) ?? modelIds.find((id) => id === "gpt-5.4") ?? modelIds.find((id) => id.startsWith("gpt-5")) ?? modelIds.find((id) => id.toLowerCase().includes("gpt"));
+  return { claude, codex };
+}
+
+// src/index.ts
+async function promptApiKey(initial) {
+  if (initial) {
+    return normalizeApiKey(initial);
+  }
+  const value = await p.text({
+    message: "\u7C98\u8D34 Trinity API Key\uFF08xh- \u5F00\u5934\uFF09",
+    placeholder: "xh-...",
+    validate: (input) => {
+      if (!input?.trim()) return "\u8BF7\u8F93\u5165 API Key";
+    }
+  });
+  if (p.isCancel(value)) {
+    p.cancel("\u5DF2\u53D6\u6D88");
+    process.exit(0);
+  }
+  return normalizeApiKey(String(value));
+}
+async function run() {
+  let opts;
+  try {
+    opts = parseArgs(process.argv.slice(2));
+  } catch (error) {
+    console.error(pc.red(error instanceof Error ? error.message : String(error)));
+    return 1;
+  }
+  if (opts.help) {
+    return 0;
+  }
+  if (opts.version) {
+    console.log(`${PACKAGE_NAME} v${PACKAGE_VERSION}`);
+    return 0;
+  }
+  p.intro(pc.bgCyan(pc.black(` ${PACKAGE_NAME} v${PACKAGE_VERSION} `)));
+  const apiKey = await promptApiKey(opts.apiKey);
+  const { claudeBaseUrl, codexBaseUrl } = resolveBaseUrls(opts.baseUrl);
+  const models = defaultModels(opts.claudeModel, opts.codexModel);
+  const configureClaudeTool = !opts.only || opts.only === "claude";
+  const configureCodexTool = !opts.only || opts.only === "codex";
+  const spinner2 = p.spinner();
+  if (configureClaudeTool) {
+    spinner2.start("\u914D\u7F6E Claude Code\u2026");
+    try {
+      await configureClaude(apiKey, claudeBaseUrl, models.claudeModel, opts.verbose);
+      mergeClaudeEnv(models.claudeModel, models.claudeModel, claudeBaseUrl);
+      spinner2.stop("Claude Code \u914D\u7F6E\u5DF2\u5199\u5165 ~/.claude/settings.json");
+    } catch (error) {
+      spinner2.stop(pc.red("Claude Code \u914D\u7F6E\u5931\u8D25"));
+      const message = error instanceof Error && "timed out" in error ? "zcf \u6267\u884C\u8D85\u65F6\uFF08>3 \u5206\u949F\uFF09\u3002\u8BF7\u68C0\u67E5\u7F51\u7EDC\u6216\u7A0D\u540E\u91CD\u8BD5\uFF1Anpx -y zcf init --help" : error instanceof Error ? error.message : String(error);
+      console.error(message);
+      return 1;
+    }
+  }
+  if (configureCodexTool) {
+    spinner2.start("\u914D\u7F6E Codex CLI\u2026");
+    try {
+      await configureCodex(apiKey, codexBaseUrl, models.codexModel, opts.verbose);
+      spinner2.stop("Codex \u914D\u7F6E\u5DF2\u5199\u5165 ~/.codex/");
+    } catch (error) {
+      spinner2.stop(pc.red("Codex \u914D\u7F6E\u5931\u8D25"));
+      const message = error instanceof Error && "timed out" in error ? "zcf \u6267\u884C\u8D85\u65F6\uFF08>3 \u5206\u949F\uFF09\u3002\u8BF7\u68C0\u67E5\u7F51\u7EDC\u6216\u7A0D\u540E\u91CD\u8BD5\u3002" : error instanceof Error ? error.message : String(error);
+      console.error(message);
+      return 1;
+    }
+  }
+  if (!opts.skipVerify) {
+    spinner2.start("\u9A8C\u8BC1 Trinity API \u8FDE\u901A\u6027\u2026");
+    const result = await verifyTrinityApi(apiKey, claudeBaseUrl);
+    if (result.ok) {
+      spinner2.stop(pc.green(result.message));
+      const recommended = pickRecommendedModels(result.modelIds ?? []);
+      if (recommended.claude || recommended.codex) {
+        p.note(
+          [
+            recommended.claude ? `Claude \u63A8\u8350\u6A21\u578B: ${recommended.claude}` : null,
+            recommended.codex ? `Codex \u63A8\u8350\u6A21\u578B: ${recommended.codex}` : null
+          ].filter(Boolean).join("\n"),
+          "\u6A21\u578B"
+        );
+      }
+    } else {
+      spinner2.stop(pc.yellow(result.message));
+      p.note(
+        "\u672C\u5730\u914D\u7F6E\u5DF2\u5199\u5165\uFF0C\u4F46\u8FDE\u901A\u6027\u68C0\u67E5\u672A\u901A\u8FC7\u3002\u8BF7\u68C0\u67E5 API Key\u3001\u7F51\u7EDC\uFF0C\u6216\u5728\u63A7\u5236\u53F0\u786E\u8BA4 Key \u6709\u6548\u3002",
+        "\u63D0\u793A"
+      );
+      p.outro(pc.yellow("\u914D\u7F6E\u5B8C\u6210\uFF08\u9A8C\u8BC1\u672A\u901A\u8FC7\uFF09"));
+      return 1;
+    }
+  }
+  const nextSteps = [
+    configureClaudeTool ? "\u8FD0\u884C claude \u542F\u52A8 Claude Code" : null,
+    configureCodexTool ? "\u8FD0\u884C codex \u542F\u52A8 Codex CLI" : null,
+    "\u5728\u5DE5\u5177\u5185\u7528 /model \u5207\u6362\u4E3A Trinity \u5DF2\u4E0A\u67B6\u7684 model_code",
+    "\u914D\u7F6E\u540E\u8BF7\u6C42\u8D70 Trinity \u8BA1\u8D39\uFF0C\u4E0D\u518D\u4F7F\u7528 Anthropic/OpenAI \u5B98\u65B9\u989D\u5EA6"
+  ].filter(Boolean).join("\n");
+  p.note(nextSteps, "\u4E0B\u4E00\u6B65");
+  p.outro(pc.green("\u5B8C\u6210"));
+  return 0;
+}
+run().then((code) => process.exit(code)).catch((error) => {
+  console.error(pc.red(error instanceof Error ? error.stack ?? error.message : String(error)));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "trinity-config",
+  "version": "1.0.0",
+  "description": "一键把 Trinity API 接入 Claude Code 与 Codex CLI",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "trinity-config": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --target node18 --clean && node scripts/add-shebang.mjs",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "trinity",
+    "trinitydesk",
+    "claude-code",
+    "codex",
+    "cli",
+    "ai-gateway",
+    "zcf"
+  ],
+  "author": "Trinity",
+  "homepage": "https://trinitydesk.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/trinitydesk/trinity-config"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "execa": "^9.5.2",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^3.0.0"
+  }
+}