@tokenaut/opentoken 1.3.5 → 1.4.0

package/README.md

@@ -1,118 +1,132 @@
-# OpenToken
+# @opentoken/opentoken
 
-OpenToken 一键配置 CLI，支持 Claude Code 和 Codex。
+快速接入 [https://gw.opentoken.io](https://gw.opentoken.io) 的强大模型。
 
 ## 安装
 
 ```bash
-npm install -g @tokenaut/opentoken
+npx @opentoken/opentoken
+npm install -g @opentoken/opentoken
 ```
 
-## 用法
+## 命令
 
-```bash
-opentoken <tool> [--key <api_key>] [--model <model>] [--url <base_url>]
-```
+| 命令 | 说明 |
+|------|------|
+| `opentoken` | 交互主菜单 |
+| `opentoken --help` / `-h` | 帮助 |
 
-各参数均可独立使用，只修改指定的配置项，未指定的保持不变。
+---
 
-## 工具
+## 已支持的应用与配置文件
 
-| 命令 | 说明 | 配置文件 |
-|------|------|---------|
-| `opentoken cc` | Claude Code | `~/.claude/settings.json` |
-| `opentoken codex` / `cx` | Codex | `~/.codex/config.toml` + `~/.codex/auth.json` |
+本 CLI 会为不同工具写入对应配置文件（路径均在用户目录下）。
 
-## 模型别名
+| 应用 | 子命令（别名） | 配置文件 |
+|------|----------------|----------|
+| **Claude Code** | `cc`、`claude` | `~/.claude/settings.json`（环境变量：`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_MODEL`） |
+| **Atomcode** | `atomcode`、`ac` | `~/.atomcode/config.toml` |
+| **OpenClaw** | `openclaw`、`oc` | `~/.openclaw/openclaw.json`（合并写入 Opentoken：`models.providers.opentoken`、`agents.defaults.model.primary` 等） |
+| **Hermes** | `hermes`、`hm` | `~/.hermes/config.yaml`（`model.provider`、`model.base_url`、`model.default`）与 `~/.hermes/.env`（`OPENTOKEN_API_KEY`） |
+| **OpenCode** | `opencode`、`od` | `~/.config/opencode/opencode.json`（合并写入 Opentoken：`provider.opentoken`） |
+| **Codex** | `codex`、`cx` | `~/.codex/config.toml`（`model_provider`、`model_providers.opentoken`、`wire_api = "responses"`）与 `~/.codex/auth.json`（`OPENAI_API_KEY`） |
 
-### Claude Code
+OpenClaw 会为 **`opentoken`** 提供方写入 **`baseUrl`**（`https://gw.opentoken.io/v1`）、**`api`**（`openai-completions`）、**`apiKey`** 与 **`models`**，并把 **`agents.defaults.model.primary`** 设为 `opentoken/<模型 ID>`；其它顶级字段与其它 provider **保留不删**（例如已有 `channels`、`gateway`）。Windows 下路径为 `%USERPROFILE%\.openclaw\openclaw.json`。
 
-| 别名 | 模型 ID |
-|------|---------|
-| `opus` | `claude-opus-4-8`（默认） |
-| `sonnet` | `claude-sonnet-4-6` |
-| `haiku` | `claude-haiku-4-5` |
+Hermes 使用 Opentoken 时需 **`provider: custom`**，且 **`base_url` 须带 `/v1` 后缀**（本工具写入为 `https://gw.opentoken.io/v1`）；密钥写入 `.env` 中的 `OPENTOKEN_API_KEY`。
 
-### Codex
+OpenCode 会为 **`opentoken`** 提供方写入 **`npm`**（`@ai-sdk/anthropic`）、**`baseURL`**（`https://gw.opentoken.io/v1`，必须带 `/v1`）、**`apiKey`** 与 **`models`**（自动拉取可用模型列表并生成配置）；其它 provider **保留不删**。配置文件支持 `$schema` 字段用于 IDE 提示。参考 [OpenCode 文档](https://help.aliyun.com/zh/model-studio/opencode-coding-plan)。
+
+Codex 会为 **`opentoken`** 提供方写入 **`base_url`**（默认 `https://gw.opentoken.io/v1`）与 **`wire_api = "responses"`**（不写 `env_key`），并只从模型列表中选择 `supported_endpoint_types` 包含 `responses` 的模型。API Key 写入 **`~/.codex/auth.json`** 的 **`OPENAI_API_KEY`**，Codex 命令行与 IDE 插件共用，无需再 export 环境变量。
+
+---
 
-| 别名 | 模型 ID |
-|------|---------|
-| `5.4` / `gpt5.4` / `gpt-5.4` | `gpt-5.4`（默认） |
-| `5.5` / `gpt5.5` / `gpt-5.5` | `gpt-5.5` |
+## 快捷一键配置（非交互）
 
-## 示例
+以下为各应用在命令行直接写入配置的用法。选项可单独或组合使用：**`--key` / `-k`**，**`--url` / `-u`**（仅 Claude Code），**`--model` / `-m`**。
 
 ### Claude Code
 
 ```bash
-# 一键初始化
-opentoken cc --key sk-xxxxx
+opentoken cc --key   <api_key>
+opentoken cc --url   <base_url>
+opentoken cc --model <model_id>
+opentoken cc -k <api_key> -u <base_url> -m <model_id>
+```
 
-# 只改模型
-opentoken cc --model sonnet
+示例：
 
-# 完整指定
-opentoken cc --key sk-xxxxx --model opus --url https://gw.opentoken.io
+```bash
+opentoken cc -k sk-xxx
+opentoken cc -k sk-xxx -u https://gw.opentoken.io -m claude-opus-4-5
 ```
 
-### Codex
+### Atomcode
+
+Base URL 固定为 Opentoken 的 OpenAI 兼容地址，仅需 Key 与模型：
 
 ```bash
-# 一键初始化
-opentoken cx --key sk-xxxxx --url https://gw.opentoken.io/v1
+opentoken atomcode --key <api_key>
+opentoken ac --model <model_id>
+opentoken ac -k <api_key> -m <model_id>
+```
 
-# 只改模型
-opentoken cx --model 5.5
+### OpenClaw
 
-# 完整指定
-opentoken cx --key sk-xxxxx --model gpt-5.5 --url https://gw.opentoken.io/v1
+写入（或合并）`~/.openclaw/openclaw.json` 中的 Opentoken 配置：
+
+```bash
+opentoken openclaw --key <api_key>
+opentoken oc --model <model_id>
+opentoken oc -k <api_key> -m <model_id>
 ```
 
-## 一键配置命令
+### Hermes
 
-### OpenToken 网关
+写入 `model.default`、`OPENTOKEN_API_KEY`，并强制 `provider: custom` 与 Opentoken `base_url`：
 
 ```bash
-# Claude Code（注意 cc 的 url 没有 /v1）
-opentoken cc --key <your-api-key> --model opus --url https://gw.opentoken.io
-
-# Codex
-opentoken cx --key <your-api-key> --model 5.5 --url https://gw.opentoken.io/v1
+opentoken hermes --key <api_key>
+opentoken hm --model <model_id>
+opentoken hm -k <api_key> -m <model_id>
 ```
 
-### Omni 网关
+### OpenCode
 
-```bash
-# Claude Code
-opentoken cc --key <your-api-key> --model opus --url https://omniroute.goio.uk/v1
+写入（或合并）`~/.config/opencode/opencode.json` 中的 Opentoken 配置：
 
-# Codex
-opentoken cx --key <your-api-key> --model 5.5 --url https://omniroute.goio.uk/v1
+```bash
+opentoken opencode --key <api_key>
+opentoken od --model <model_id>
+opentoken od -k <api_key> -m <model_id>
 ```
 
-## 写入字段
+提供 API Key 后会自动拉取完整模型列表并写入配置。配置格式兼容 Anthropic API，使用 `@ai-sdk/anthropic` SDK。
 
-### Claude Code（`~/.claude/settings.json`）
+### Codex
 
-- `ANTHROPIC_AUTH_TOKEN`
-- `ANTHROPIC_BASE_URL`
-- `ANTHROPIC_MODEL`（主模型）
-- `ANTHROPIC_DEFAULT_SONNET_MODEL`（Sonnet 辅助模型）
-- `ANTHROPIC_DEFAULT_HAIKU_MODEL`（Haiku 辅助模型）
-- `API_TIMEOUT_MS`
-- `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`
-- `ENABLE_TOOL_SEARCH`
+写入（或合并）`~/.codex/config.toml` 中的 Opentoken Responses API 配置：
 
-默认 Base URL：`https://gw.opentoken.io/`
+```bash
+opentoken codex --key <api_key>
+opentoken cx --url https://gw.opentoken.io/v1
+opentoken cx --model <model_id>
+opentoken cx -k <api_key> -u https://gw.opentoken.io/v1 -m <model_id>
+```
+
+提供 API Key 后会自动拉取 `supported_endpoint_types` 含 `responses` 的模型，并写入 Codex profiles 与 `tui.model_availability_nux`，同时将 Key 写入 `~/.codex/auth.json`：
+
+```json
+{
+  "auth_mode": "apikey",
+  "OPENAI_API_KEY": "<api_key>"
+}
+```
 
-### Codex（`~/.codex/config.toml` + `~/.codex/auth.json`）
+若 `config.toml` 中仍有旧版 **`env_key`** 行，请删除以免与 `auth.json` 冲突。
 
-- `model` / `model_provider`
-- `model_providers.opentoken`（name、base_url、wire_api）
-- `profiles.<model>`
-- `tui.model_availability_nux`
-- `OPENAI_API_KEY`（写入 auth.json）
+---
 
-默认 Base URL：`https://gw.opentoken.io/v1`
+## 环境
 
-opentoken cc --key sk-ot-v1-e7551b49a8c18f3f5b54dda11fb03f96f05a2aa7280bdeb9 --model opus --url https://gw.opentoken.io
+Node.js >= 14 · MIT

package/bin/opentoken.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
+
 'use strict';
 
-const run = require('../src/cli');
+const { run } = require('../src/cli');
 
-run().catch((error) => {
-  console.error(error.message || error);
+run().catch((err) => {
+  console.error(err);
   process.exit(1);
-});
+});

package/package.json

@@ -1,32 +1,44 @@
 {
   "name": "@tokenaut/opentoken",
-  "version": "1.3.5",
-  "description": "OpenToken Claude Code 一键配置 CLI",
+  "version": "1.4.0",
+  "description": "OpenToken 一键接入 AI 模型 · https://gw.opentoken.io",
   "main": "src/cli.js",
   "bin": {
     "opentoken": "bin/opentoken.js"
   },
-  "files": [
-    "bin",
-    "src"
-  ],
   "scripts": {
     "start": "node bin/opentoken.js",
     "dev": "node bin/opentoken.js"
   },
   "keywords": [
     "opentoken",
+    "openrouter",
     "claude",
     "claude-code",
+    "api token",
+    "token配置",
+    "openrouter token",
+    "api配置",
+    "anthropic",
+    "codex",
     "cli",
-    "config"
+    "ai工具",
+    "openai",
+    "模型切换"
   ],
   "author": "opentoken",
   "license": "MIT",
+  "dependencies": {
+    "@iarna/toml": "^2.2.5",
+    "js-yaml": "^4.1.0",
+    "chalk": "^4.1.2",
+    "inquirer": "^8.2.6",
+    "string-width": "^4.2.3"
+  },
   "engines": {
     "node": ">=14.0.0"
   },
-  "dependencies": {
-    "@iarna/toml": "^2.2.5"
+  "publishConfig": {
+    "access": "public"
   }
-}
+}

package/src/atomcode-config.js

@@ -0,0 +1,94 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const TOML = require('@iarna/toml');
+const {
+  ATOMCODE_OPENTOKEN_BASE_URL,
+  ATOMCODE_CONTEXT_WINDOW,
+} = require('./models');
+
+const CONFIG_DIR = path.join(os.homedir(), '.atomcode');
+const CONFIG_PATH = path.join(CONFIG_DIR, 'config.toml');
+
+const PROVIDER_KEY = 'Opentoken';
+
+function readRaw() {
+  if (!fs.existsSync(CONFIG_PATH)) return '';
+  return fs.readFileSync(CONFIG_PATH, 'utf-8');
+}
+
+function getCurrentAtomcodeConfig() {
+  const raw = readRaw();
+  if (!raw || !String(raw).trim()) {
+    return { apiKey: '', model: '' };
+  }
+  const data = TOML.parse(raw);
+  const p =
+    data &&
+    typeof data === 'object' &&
+    data.providers &&
+    typeof data.providers === 'object' &&
+    !Array.isArray(data.providers)
+      ? data.providers[PROVIDER_KEY]
+      : null;
+  return {
+    apiKey: p && p.api_key != null ? String(p.api_key) : '',
+    model: p && p.model != null ? String(p.model) : '',
+  };
+}
+
+function applyAtomcodeConfig(patch) {
+  const { apiKey, model } = patch || {};
+  let data = {};
+  const raw = readRaw();
+  if (raw && String(raw).trim()) {
+    try {
+      data = TOML.parse(raw);
+    } catch (e) {
+      throw new Error(
+        '现有 config.toml 无法解析，请先备份后手动修复：' + e.message,
+      );
+    }
+  }
+  if (data === null || typeof data !== 'object' || Array.isArray(data)) {
+    throw new Error('config.toml 根节点必须是表（TOML table）');
+  }
+  if (
+    !data.providers ||
+    typeof data.providers !== 'object' ||
+    Array.isArray(data.providers)
+  ) {
+    data.providers = {};
+  }
+  const prev =
+    data.providers[PROVIDER_KEY] &&
+    typeof data.providers[PROVIDER_KEY] === 'object' &&
+    !Array.isArray(data.providers[PROVIDER_KEY])
+      ? { ...data.providers[PROVIDER_KEY] }
+      : {};
+  const merged = {
+    ...prev,
+    type: 'openai',
+    base_url: ATOMCODE_OPENTOKEN_BASE_URL,
+    context_window: ATOMCODE_CONTEXT_WINDOW,
+  };
+  if (apiKey !== undefined) merged.api_key = apiKey;
+  if (model !== undefined) merged.model = model;
+
+  data.providers[PROVIDER_KEY] = merged;
+  data.default_provider = PROVIDER_KEY;
+
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  fs.writeFileSync(CONFIG_PATH, TOML.stringify(data), 'utf-8');
+}
+
+module.exports = {
+  CONFIG_PATH,
+  PROVIDER_KEY,
+  getCurrentAtomcodeConfig,
+  applyAtomcodeConfig,
+};