@x-all-in-one/coding-helper 0.1.1 → 0.3.0

package/README.md

@@ -2,6 +2,13 @@
 
 CLI 工具，用于配置 AI 编程助手（Claude Code、OpenCode、Codex）的 API 端点和模型。
 
+## 功能
+
+- 统一管理多个 AI 编程工具的配置
+- 交互式配置向导
+- 支持自定义 API 端点和模型
+- 多语言支持（中文/英文）
+
 ## 安装
 
 ```bash
@@ -23,101 +30,11 @@ chelper --help
 chelper lang
 ```
 
-## 开发
-
-### 环境要求
-
-- Node.js >= 18
-- pnpm >= 10
-
-### 常用命令
-
-```bash
-pnpm install          # 安装依赖
-pnpm dev              # 开发模式（热重载）
-pnpm build            # 构建项目
-pnpm lint             # 代码检查
-pnpm lint:fix         # 自动修复
-```
-
-### 目录结构
-
-```
-src/
-├── cli.ts                # 入口文件
-├── lib/
-│   ├── config.ts         # 配置管理 (~/.chelper/config.yaml)
-│   ├── i18n.ts           # 国际化
-│   ├── tool-manager.ts   # 工具注册管理
-│   ├── wizard/           # 交互式 TUI
-│   ├── tools/            # 工具实现 (Claude Code, OpenCode, Codex)
-│   └── plugins/          # 插件实现
-└── locales/              # 语言文件
-```
-
-## 发版流程
-
-本项目使用 [Changeset](https://github.com/changesets/changesets) 进行版本管理。
-
-### 1. 创建 Changeset
-
-开发完成后，运行以下命令声明版本变更：
-
-```bash
-pnpm changeset
-```
-
-交互式选择：
-- **patch** - 修复 bug (0.0.x)
-- **minor** - 新功能 (0.x.0)
-- **major** - 破坏性变更 (x.0.0)
-
-这会在 `.changeset/` 目录下生成一个 markdown 文件。
-
-### 2. 提交代码
-
-```bash
-git add .
-git commit -m "feat: 添加新功能"
-git push origin feature/xxx
-```
-
-### 3. 创建 MR 并合并
-
-创建 Merge Request 合并到 `main` 分支。
-
-### 4. 自动发版
-
-合并后，GitLab CI 会自动：
-1. 执行 `changeset version` 更新版本号和 CHANGELOG
-2. 执行 `changeset publish` 发布到 npm
-3. 提交版本变更并推送
-
-## Commit 规范
-
-使用 [Conventional Commits](https://www.conventionalcommits.org/) 规范：
-
-| 类型 | 说明 |
-|------|------|
-| `feat` | 新功能 |
-| `fix` | 修复 bug |
-| `docs` | 文档变更 |
-| `style` | 代码格式（不影响功能） |
-| `refactor` | 重构（不是新功能也不是修复） |
-| `perf` | 性能优化 |
-| `test` | 测试相关 |
-| `chore` | 构建/工具变更 |
-
-## GitLab CI
-
-流水线包含以下阶段：
+## 支持的工具
 
-| 阶段 | 说明 |
-|------|------|
-| `install` | 安装依赖 |
-| `lint` | 代码检查 |
-| `build` | 构建项目 |
-| `release` | 发版（仅 main 分支） |
+- [Claude Code](https://claude.ai/code) - Anthropic 官方 CLI
+- [OpenCode](https://github.com/opencode-ai/opencode) - 开源 AI 编程助手
+- [Codex](https://github.com/openai/codex) - OpenAI CLI
 
 ## License
 

package/dist/lib/tools/codex-tool.d.ts

@@ -1,22 +1,21 @@
 import { BaseTool } from './base-tool.js';
+export interface ModelProviderInfo {
+    name: string;
+    base_url?: string;
+    env_key?: string;
+    wire_api?: 'chat' | 'responses';
+}
 export interface CodexConfig {
     model?: string;
-    provider?: {
-        name?: string;
-        baseURL?: string;
-        apiKey?: string;
-    };
-    [key: string]: any;
+    model_provider?: string;
+    model_providers?: Record<string, ModelProviderInfo>;
+    [key: string]: unknown;
 }
 export interface CodexModelConfig {
     apiKey: string;
     model: string;
     baseUrl?: string;
 }
-/**
- * Codex 工具实现
- * 实现 ITool 接口，管理 Codex 的配置和生命周期
- */
 export declare class CodexTool extends BaseTool {
     private static instance;
     readonly name = "codex";
@@ -26,33 +25,15 @@ export declare class CodexTool extends BaseTool {
     readonly configPath: string;
     private constructor();
     static getInstance(): CodexTool;
-    /**
-     * Ensure config directory exists
-     */
     private ensureDir;
-    /**
-     * Read codex config
-     */
     getConfig(): CodexConfig;
-    /**
-     * Save codex config
-     */
-    saveConfig(config: unknown): void;
-    /**
-     * Fetch available models from API
-     */
+    saveConfig(config: CodexConfig): void;
     fetchAvailableModels(apiKey: string): Promise<string[]>;
-    /**
-     * Save model config to Codex
-     */
     saveModelConfig(config: unknown): Promise<void>;
-    /**
-     * Get current model config
-     */
+    private setApiKeyEnv;
+    private getShellRcPath;
+    private getEnvValue;
     getModelConfig(): CodexModelConfig | null;
-    /**
-     * Clear model config
-     */
     clearModelConfig(): void;
 }
 export declare const codexTool: CodexTool;

package/dist/lib/tools/codex-tool.js

@@ -1,13 +1,11 @@
+import { execSync } from 'node:child_process';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
+import { parse, stringify } from 'smol-toml';
 import { BaseTool } from './base-tool.js';
-// 使用相同的 X-AIO API 端点
 const DEFAULT_BASE_URL = 'https://code-api.x-aio.com/v1';
-/**
- * Codex 工具实现
- * 实现 ITool 接口，管理 Codex 的配置和生命周期
- */
+const X_AIO_CODE_API_KEY_ENV = 'X_AIO_CODE_API_KEY';
 export class CodexTool extends BaseTool {
     static instance;
     name = 'codex';
@@ -17,10 +15,7 @@ export class CodexTool extends BaseTool {
     configPath;
     constructor() {
         super();
-        // Codex config file path (cross-platform support)
-        // - macOS/Linux: ~/.codex/config.json
-        // - Windows: %USERPROFILE%\.codex\config.json
-        this.configPath = join(homedir(), '.codex', 'config.json');
+        this.configPath = join(homedir(), '.codex', 'config.toml');
     }
     static getInstance() {
         if (!CodexTool.instance) {
@@ -28,24 +23,17 @@ export class CodexTool extends BaseTool {
         }
         return CodexTool.instance;
     }
-    /**
-     * Ensure config directory exists
-     */
     ensureDir(filePath) {
         const dir = dirname(filePath);
         if (!existsSync(dir)) {
             mkdirSync(dir, { recursive: true });
         }
     }
-    // ==================== ITool 接口实现 ====================
-    /**
-     * Read codex config
-     */
     getConfig() {
         try {
             if (existsSync(this.configPath)) {
                 const content = readFileSync(this.configPath, 'utf-8');
-                return JSON.parse(content);
+                return parse(content);
             }
         }
         catch (error) {
@@ -53,21 +41,15 @@ export class CodexTool extends BaseTool {
         }
         return {};
     }
-    /**
-     * Save codex config
-     */
     saveConfig(config) {
         try {
             this.ensureDir(this.configPath);
-            writeFileSync(this.configPath, JSON.stringify(config, null, 2), 'utf-8');
+            writeFileSync(this.configPath, stringify(config), 'utf-8');
         }
         catch (error) {
             throw new Error(`Failed to save Codex config: ${error}`);
         }
     }
-    /**
-     * Fetch available models from API
-     */
     async fetchAvailableModels(apiKey) {
         try {
             const controller = new AbortController();
@@ -95,48 +77,145 @@ export class CodexTool extends BaseTool {
             return [];
         }
     }
-    /**
-     * Save model config to Codex
-     */
     async saveModelConfig(config) {
         const modelConfig = config;
-        // Read current config (preserve user's other settings)
         const currentConfig = this.getConfig();
-        // Build new config
+        const providerKey = 'x-aio';
         const newConfig = {
             ...currentConfig,
             model: modelConfig.model,
-            provider: {
-                name: 'X-AIO',
-                baseURL: modelConfig.baseUrl || DEFAULT_BASE_URL,
-                apiKey: modelConfig.apiKey,
+            model_provider: providerKey,
+            model_providers: {
+                ...currentConfig.model_providers,
+                [providerKey]: {
+                    name: 'X-AIO',
+                    base_url: modelConfig.baseUrl || DEFAULT_BASE_URL,
+                    env_key: X_AIO_CODE_API_KEY_ENV,
+                    wire_api: 'responses',
+                },
             },
         };
         this.saveConfig(newConfig);
+        this.setApiKeyEnv(modelConfig.apiKey);
+    }
+    setApiKeyEnv(apiKey) {
+        const isWindows = process.platform === 'win32';
+        if (isWindows) {
+            const escapedKey = apiKey.replace(/'/g, '\'\'');
+            const psCommand = `[Environment]::SetEnvironmentVariable('${X_AIO_CODE_API_KEY_ENV}', '${escapedKey}', 'User')`;
+            try {
+                execSync(`powershell -Command "${psCommand}"`, { stdio: 'ignore' });
+            }
+            catch {
+                console.warn('Failed to set Windows environment variable');
+            }
+        }
+        else {
+            const shellRcPath = this.getShellRcPath();
+            if (shellRcPath) {
+                let content = existsSync(shellRcPath) ? readFileSync(shellRcPath, 'utf-8') : '';
+                const exportLine = `export ${X_AIO_CODE_API_KEY_ENV}="${apiKey}"`;
+                const regex = new RegExp(`^export ${X_AIO_CODE_API_KEY_ENV}=.*$`, 'm');
+                if (regex.test(content)) {
+                    content = content.replace(regex, exportLine);
+                }
+                else {
+                    content = content ? `${content}\n${exportLine}\n` : `${exportLine}\n`;
+                }
+                writeFileSync(shellRcPath, content, 'utf-8');
+            }
+        }
+        process.env[X_AIO_CODE_API_KEY_ENV] = apiKey;
+    }
+    getShellRcPath() {
+        const home = homedir();
+        const shell = process.env.SHELL || '';
+        if (shell.includes('zsh')) {
+            const zshrc = join(home, '.zshrc');
+            const zprofile = join(home, '.zprofile');
+            if (existsSync(zshrc))
+                return zshrc;
+            if (existsSync(zprofile))
+                return zprofile;
+            return zshrc;
+        }
+        if (shell.includes('bash')) {
+            const bashrc = join(home, '.bashrc');
+            const bashProfile = join(home, '.bash_profile');
+            if (existsSync(bashrc))
+                return bashrc;
+            if (existsSync(bashProfile))
+                return bashProfile;
+            return bashrc;
+        }
+        return join(home, '.profile');
+    }
+    getEnvValue(envKey) {
+        if (process.env[envKey]) {
+            return process.env[envKey];
+        }
+        if (process.platform === 'win32') {
+            try {
+                const result = execSync(`powershell -Command "[Environment]::GetEnvironmentVariable('${envKey}', 'User')"`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] }).trim();
+                if (result && result !== '') {
+                    return result;
+                }
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+        else {
+            try {
+                const shellRcPath = this.getShellRcPath();
+                if (existsSync(shellRcPath)) {
+                    const content = readFileSync(shellRcPath, 'utf-8');
+                    const regex = new RegExp(`^export ${envKey}=["']?([^"'\\n]+)["']?`, 'm');
+                    const match = content.match(regex);
+                    if (match && match[1]) {
+                        return match[1];
+                    }
+                }
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+        return undefined;
     }
-    /**
-     * Get current model config
-     */
     getModelConfig() {
         const config = this.getConfig();
-        if (!config.provider?.apiKey) {
+        const providerKey = config.model_provider;
+        if (!providerKey || !config.model_providers?.[providerKey]) {
+            return null;
+        }
+        const provider = config.model_providers[providerKey];
+        const envKey = provider.env_key;
+        const apiKey = envKey ? this.getEnvValue(envKey) : undefined;
+        if (!apiKey) {
             return null;
         }
         return {
-            apiKey: config.provider.apiKey,
+            apiKey,
             model: config.model || '',
-            baseUrl: config.provider.baseURL || '',
+            baseUrl: provider.base_url || '',
         };
     }
-    /**
-     * Clear model config
-     */
     clearModelConfig() {
         const currentConfig = this.getConfig();
-        delete currentConfig.model;
-        delete currentConfig.provider;
+        const providerKey = 'x-aio';
+        if (currentConfig.model_provider === providerKey) {
+            delete currentConfig.model;
+            delete currentConfig.model_provider;
+        }
+        if (currentConfig.model_providers?.[providerKey]) {
+            delete currentConfig.model_providers[providerKey];
+            if (Object.keys(currentConfig.model_providers).length === 0) {
+                delete currentConfig.model_providers;
+            }
+        }
         this.saveConfig(currentConfig);
+        delete process.env[X_AIO_CODE_API_KEY_ENV];
     }
 }
-// 单例导出
 export const codexTool = CodexTool.getInstance();

package/dist/lib/tools/opencode-tool.d.ts

@@ -116,6 +116,7 @@ export declare class OpenCodeTool extends BaseTool {
     /**
      * 同步模型列表到配置（不改变当前选择的模型）
      * 仅更新 provider.xaio.models 部分
+     * 如果 provider 不存在但有 apiKey，则创建新的 provider
      */
     syncModelsToConfig(modelInfos: ModelInfo[]): void;
     /**

package/dist/lib/tools/opencode-tool.js

@@ -1,6 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
+import { configManager } from '../config.js';
 import { BaseTool } from './base-tool.js';
 // X-AIO Provider ID
 const XAIO_PROVIDER_ID = 'xaio';
@@ -268,15 +269,35 @@ export class OpenCodeTool extends BaseTool {
     /**
      * 同步模型列表到配置（不改变当前选择的模型）
      * 仅更新 provider.xaio.models 部分
+     * 如果 provider 不存在但有 apiKey，则创建新的 provider
      */
     syncModelsToConfig(modelInfos) {
         const currentConfig = this.getConfig();
-        const xaioProvider = currentConfig.provider?.[XAIO_PROVIDER_ID];
+        let xaioProvider = currentConfig.provider?.[XAIO_PROVIDER_ID];
         if (!xaioProvider) {
-            // 如果还没有配置过，不做任何操作
-            return;
+            // 如果还没有配置过，尝试从 configManager 获取 apiKey 创建 provider
+            const apiKey = configManager.getApiKey();
+            if (!apiKey) {
+                // 没有 apiKey，无法创建 provider
+                return;
+            }
+            // 创建新的 provider
+            xaioProvider = {
+                npm: '@ai-sdk/openai-compatible',
+                name: OPENCODE_DEFAULT_CONFIG.PROVIDER_NAME,
+                options: {
+                    baseURL: OPENCODE_DEFAULT_CONFIG.BASE_URL,
+                    apiKey,
+                },
+                models: {},
+            };
+            // 初始化 provider 对象
+            if (!currentConfig.provider) {
+                currentConfig.provider = {};
+            }
+            currentConfig.provider[XAIO_PROVIDER_ID] = xaioProvider;
         }
-        // 只更新 models 部分
+        // 更新 models 部分
         const modelsConfig = this.buildModelsConfig(modelInfos);
         xaioProvider.models = modelsConfig;
         this.saveConfig(currentConfig);

package/dist/lib/wizard/menus/plugin-menu.d.ts

@@ -14,6 +14,10 @@ export declare class PluginMenu {
      * 安装插件
      */
     private installPlugin;
+    /**
+     * 提示用户刷新模型列表
+     */
+    private promptRefreshModels;
     /**
      * 装载插件
      */

package/dist/lib/wizard/menus/plugin-menu.js

@@ -2,6 +2,7 @@ import chalk from 'chalk';
 import inquirer from 'inquirer';
 import ora from 'ora';
 import { i18n } from '../../i18n.js';
+import { modelService } from '../../model-service.js';
 import { promptHelper } from '../ui/prompt-helper.js';
 import { uiRenderer } from '../ui/ui-renderer.js';
 /**
@@ -83,6 +84,10 @@ export class PluginMenu {
         try {
             await plugin.install();
             console.log(chalk.green(`\n✓ ${i18n.t('wizard.plugin_installed', { plugin: plugin.displayName })}`));
+            // oh-my-opencode 安装后提示刷新模型列表
+            if (plugin.name === 'oh-my-opencode') {
+                await this.promptRefreshModels();
+            }
         }
         catch (error) {
             console.log(chalk.red(`\n✗ ${i18n.t('wizard.plugin_install_failed', { plugin: plugin.displayName })}`));
@@ -90,6 +95,33 @@ export class PluginMenu {
         }
         await promptHelper.pressEnterToContinue();
     }
+    /**
+     * 提示用户刷新模型列表
+     */
+    async promptRefreshModels() {
+        console.log('');
+        const { shouldRefresh } = await promptHelper.promptWithHints([
+            {
+                type: 'confirm',
+                name: 'shouldRefresh',
+                message: i18n.t('wizard.prompt_refresh_models'),
+                default: true,
+            },
+        ]);
+        if (shouldRefresh) {
+            const spinner = ora({
+                text: i18n.t('wizard.refreshing_models'),
+                spinner: 'star2',
+            }).start();
+            const result = await modelService.refreshAndSyncToOpenCode();
+            if (result.success) {
+                spinner.succeed(chalk.green(i18n.t('wizard.models_refreshed', { count: String(result.count) })));
+            }
+            else {
+                spinner.fail(i18n.t('wizard.refresh_models_failed'));
+            }
+        }
+    }
     /**
      * 装载插件
      */

package/dist/lib/wizard/menus/tool-menu.js

@@ -358,6 +358,9 @@ export class ToolMenu {
             }
             await new Promise(resolve => setTimeout(resolve, 800));
             spinner.succeed(chalk.green(i18n.t('wizard.config_loaded', { tool: toolRegistry.getTool(toolName)?.displayName })));
+            if (toolName === 'codex' && process.platform === 'win32') {
+                console.log(chalk.yellow(`  ${i18n.t('wizard.restart_terminal_hint')}`));
+            }
             await new Promise(resolve => setTimeout(resolve, 2000));
         }
         catch (error) {

package/dist/locales/en_US.json

@@ -198,9 +198,11 @@
     "tool_started": "Tool started",
     "tool_start_failed": "Failed to start tool",
     "action_refresh_models": "Refresh Model List - (Update available models to config)",
+    "prompt_refresh_models": "Refresh model list now? (Update available models to config)",
     "refreshing_models": "Refreshing model list...",
     "models_refreshed": "Model list refreshed, {{count}} models synced",
-    "refresh_models_failed": "Failed to refresh model list"
+    "refresh_models_failed": "Failed to refresh model list",
+    "restart_terminal_hint": "Environment variable set. Please restart your terminal before using Codex"
   },
   "doctor": {
     "checking": "Running health check...",

package/dist/locales/zh_CN.json

@@ -198,9 +198,11 @@
     "tool_started": "工具已启动",
     "tool_start_failed": "启动工具失败",
     "action_refresh_models": "刷新模型列表 - (更新可用模型到配置)",
+    "prompt_refresh_models": "是否立即刷新模型列表？(更新可用模型到配置)",
     "refreshing_models": "正在刷新模型列表...",
     "models_refreshed": "模型列表已刷新，共同步 {{count}} 个模型",
-    "refresh_models_failed": "刷新模型列表失败"
+    "refresh_models_failed": "刷新模型列表失败",
+    "restart_terminal_hint": "环境变量已设置，请重新打开终端后再使用 Codex"
   },
   "doctor": {
     "checking": "正在进行健康检查...",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@x-all-in-one/coding-helper",
   "type": "module",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "X All In One Coding Helper",
   "author": "X.AIO",
   "homepage": "https://docs.x-aio.com/zh/docs",
@@ -37,6 +37,7 @@
     "js-yaml": "^4.1.0",
     "open": "^11.0.0",
     "ora": "^8.0.1",
+    "smol-toml": "^1.6.0",
     "terminal-link": "^5.0.0"
   },
   "devDependencies": {