@x-all-in-one/coding-helper 0.0.7 → 0.1.0

package/README.md

@@ -1,91 +1,124 @@
-# coding-helper
+# Coding Helper
 
-## Getting started
+CLI 工具，用于配置 AI 编程助手（Claude Code、OpenCode、Codex）的 API 端点和模型。
 
-To make it easy for you to get started with GitLab, here's a list of recommended next steps.
+## 安装
 
-Already a pro? Just edit this README.md and make it your own. Want to make it easy? [Use the template at the bottom](#editing-this-readme)!
+```bash
+npm install -g @x-all-in-one/coding-helper
+# 或
+pnpm add -g @x-all-in-one/coding-helper
+```
 
-## Add your files
+## 使用
 
-- [ ] [Create](https://docs.gitlab.com/ee/user/project/repository/web_editor.html#create-a-file) or [upload](https://docs.gitlab.com/ee/user/project/repository/web_editor.html#upload-a-file) files
-- [ ] [Add files using the command line](https://docs.gitlab.com/topics/git/add_files/#add-files-to-a-git-repository) or push an existing Git repository with the following command:
+```bash
+# 启动交互式配置向导
+chelper
 
+# 查看帮助
+chelper --help
+
+# 切换语言
+chelper lang
 ```
-cd existing_repo
-git remote add origin https://gitlab.yeaosound.com/xaio-ai/coding-helper.git
-git branch -M main
-git push -uf origin main
-```
 
-## Integrate with your tools
+## 开发
+
+### 环境要求
+
+- Node.js >= 18
+- pnpm >= 10
 
-- [ ] [Set up project integrations](https://gitlab.yeaosound.com/xaio-ai/coding-helper/-/settings/integrations)
+### 常用命令
 
-## Collaborate with your team
+```bash
+pnpm install          # 安装依赖
+pnpm dev              # 开发模式（热重载）
+pnpm build            # 构建项目
+pnpm lint             # 代码检查
+pnpm lint:fix         # 自动修复
+```
 
-- [ ] [Invite team members and collaborators](https://docs.gitlab.com/ee/user/project/members/)
-- [ ] [Create a new merge request](https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html)
-- [ ] [Automatically close issues from merge requests](https://docs.gitlab.com/ee/user/project/issues/managing_issues.html#closing-issues-automatically)
-- [ ] [Enable merge request approvals](https://docs.gitlab.com/ee/user/project/merge_requests/approvals/)
-- [ ] [Set auto-merge](https://docs.gitlab.com/user/project/merge_requests/auto_merge/)
+### 目录结构
 
-## Test and Deploy
+```
+src/
+├── cli.ts                # 入口文件
+├── lib/
+│   ├── config.ts         # 配置管理 (~/.chelper/config.yaml)
+│   ├── i18n.ts           # 国际化
+│   ├── tool-manager.ts   # 工具注册管理
+│   ├── wizard/           # 交互式 TUI
+│   ├── tools/            # 工具实现 (Claude Code, OpenCode, Codex)
+│   └── plugins/          # 插件实现
+└── locales/              # 语言文件
+```
 
-Use the built-in continuous integration in GitLab.
+## 发版流程
 
-- [ ] [Get started with GitLab CI/CD](https://docs.gitlab.com/ee/ci/quick_start/)
-- [ ] [Analyze your code for known vulnerabilities with Static Application Security Testing (SAST)](https://docs.gitlab.com/ee/user/application_security/sast/)
-- [ ] [Deploy to Kubernetes, Amazon EC2, or Amazon ECS using Auto Deploy](https://docs.gitlab.com/ee/topics/autodevops/requirements.html)
-- [ ] [Use pull-based deployments for improved Kubernetes management](https://docs.gitlab.com/ee/user/clusters/agent/)
-- [ ] [Set up protected environments](https://docs.gitlab.com/ee/ci/environments/protected_environments.html)
+本项目使用 [Changeset](https://github.com/changesets/changesets) 进行版本管理。
 
-***
+### 1. 创建 Changeset
 
-# Editing this README
+开发完成后，运行以下命令声明版本变更：
 
-When you're ready to make this README your own, just edit this file and use the handy template below (or feel free to structure it however you want - this is just a starting point!). Thanks to [makeareadme.com](https://www.makeareadme.com/) for this template.
+```bash
+pnpm changeset
+```
 
-## Suggestions for a good README
+交互式选择：
+- **patch** - 修复 bug (0.0.x)
+- **minor** - 新功能 (0.x.0)
+- **major** - 破坏性变更 (x.0.0)
 
-Every project is different, so consider which of these sections apply to yours. The sections used in the template are suggestions for most open source projects. Also keep in mind that while a README can be too long and detailed, too long is better than too short. If you think your README is too long, consider utilizing another form of documentation rather than cutting out information.
+这会在 `.changeset/` 目录下生成一个 markdown 文件。
 
-## Name
-Choose a self-explaining name for your project.
+### 2. 提交代码
 
-## Description
-Let people know what your project can do specifically. Provide context and add a link to any reference visitors might be unfamiliar with. A list of Features or a Background subsection can also be added here. If there are alternatives to your project, this is a good place to list differentiating factors.
+```bash
+git add .
+git commit -m "feat: 添加新功能"
+git push origin feature/xxx
+```
 
-## Badges
-On some READMEs, you may see small images that convey metadata, such as whether or not all the tests are passing for the project. You can use Shields to add some to your README. Many services also have instructions for adding a badge.
+### 3. 创建 MR 并合并
 
-## Visuals
-Depending on what you are making, it can be a good idea to include screenshots or even a video (you'll frequently see GIFs rather than actual videos). Tools like ttygif can help, but check out Asciinema for a more sophisticated method.
+创建 Merge Request 合并到 `main` 分支。
 
-## Installation
-Within a particular ecosystem, there may be a common way of installing things, such as using Yarn, NuGet, or Homebrew. However, consider the possibility that whoever is reading your README is a novice and would like more guidance. Listing specific steps helps remove ambiguity and gets people to using your project as quickly as possible. If it only runs in a specific context like a particular programming language version or operating system or has dependencies that have to be installed manually, also add a Requirements subsection.
+### 4. 自动发版
 
-## Usage
-Use examples liberally, and show the expected output if you can. It's helpful to have inline the smallest example of usage that you can demonstrate, while providing links to more sophisticated examples if they are too long to reasonably include in the README.
+合并后，GitLab CI 会自动：
+1. 执行 `changeset version` 更新版本号和 CHANGELOG
+2. 执行 `changeset publish` 发布到 npm
+3. 提交版本变更并推送
 
-## Support
-Tell people where they can go to for help. It can be any combination of an issue tracker, a chat room, an email address, etc.
+## Commit 规范
 
-## Roadmap
-If you have ideas for releases in the future, it is a good idea to list them in the README.
+使用 [Conventional Commits](https://www.conventionalcommits.org/) 规范：
 
-## Contributing
-State if you are open to contributions and what your requirements are for accepting them.
+| 类型 | 说明 |
+|------|------|
+| `feat` | 新功能 |
+| `fix` | 修复 bug |
+| `docs` | 文档变更 |
+| `style` | 代码格式（不影响功能） |
+| `refactor` | 重构（不是新功能也不是修复） |
+| `perf` | 性能优化 |
+| `test` | 测试相关 |
+| `chore` | 构建/工具变更 |
 
-For people who want to make changes to your project, it's helpful to have some documentation on how to get started. Perhaps there is a script that they should run or some environment variables that they need to set. Make these steps explicit. These instructions could also be useful to your future self.
+## GitLab CI
 
-You can also document commands to lint the code or run tests. These steps help to ensure high code quality and reduce the likelihood that the changes inadvertently break something. Having instructions for running tests is especially helpful if it requires external setup, such as starting a Selenium server for testing in a browser.
+流水线包含以下阶段：
 
-## Authors and acknowledgment
-Show your appreciation to those who have contributed to the project.
+| 阶段 | 说明 |
+|------|------|
+| `install` | 安装依赖 |
+| `lint` | 代码检查 |
+| `build` | 构建项目 |
+| `release` | 发版（仅 main 分支） |
 
 ## License
-For open source projects, say how it is licensed.
 
-## Project status
-If you have run out of energy or time for your project, put a note at the top of the README saying that development has slowed down or stopped completely. Someone may choose to fork your project or volunteer to step in as a maintainer or owner, allowing your project to keep going. You can also make an explicit request for maintainers.
+MIT

package/dist/commands/auth.js

@@ -2,10 +2,10 @@ import chalk from 'chalk';
 import inquirer from 'inquirer';
 import ora from 'ora';
 import { validateApiKey } from '../lib/api-validator.js';
-import { DEFAULT_CONFIG } from '../lib/claude-code-manager.js';
 import { configManager } from '../lib/config.js';
 import { i18n } from '../lib/i18n.js';
 import { toolManager } from '../lib/tool-manager.js';
+import { DEFAULT_CONFIG } from '../lib/tools/claude-code-tool.js';
 /**
  * 支持的工具列表
  */

package/dist/commands/config.js

@@ -1,27 +1,29 @@
 import chalk from 'chalk';
 import inquirer from 'inquirer';
 import { i18n } from '../lib/i18n.js';
-import { SUPPORTED_TOOLS, toolManager } from '../lib/tool-manager.js';
+import { toolManager, toolRegistry } from '../lib/tool-manager.js';
 import { wizard } from '../lib/wizard.js';
 export async function configCommand(args) {
     const subCommand = args[0];
     const toolName = args[1];
     // 如果没有参数，进入交互式选择
     if (!subCommand) {
+        const supportedTools = toolRegistry.getSupportedTools();
         const { selectedTool } = await inquirer.prompt([
             {
                 type: 'list',
                 name: 'selectedTool',
                 message: i18n.t('wizard.select_tool'),
-                choices: Object.values(SUPPORTED_TOOLS).map(tool => ({
+                choices: supportedTools.map(tool => ({
                     name: `${tool.displayName} (${tool.name})`,
                     value: tool.name,
                 })),
             },
         ]);
+        const tool = toolRegistry.getTool(selectedTool);
         // 检查工具是否安装
         if (!toolManager.isToolInstalled(selectedTool)) {
-            console.log(chalk.yellow(`\n${i18n.t('wizard.tool_not_installed', { tool: SUPPORTED_TOOLS[selectedTool].displayName })}`));
+            console.log(chalk.yellow(`\n${i18n.t('wizard.tool_not_installed', { tool: tool?.displayName || selectedTool })}`));
             const { shouldInstall } = await inquirer.prompt([
                 {
                     type: 'confirm',
@@ -116,9 +118,10 @@ export async function configCommand(args) {
         return;
     }
     // 其他工具的支持
-    if (SUPPORTED_TOOLS[subCommand]) {
+    const tool = toolRegistry.getTool(subCommand);
+    if (tool) {
         if (!toolManager.isToolInstalled(subCommand)) {
-            console.log(chalk.yellow(i18n.t('wizard.tool_not_installed', { tool: SUPPORTED_TOOLS[subCommand].displayName })));
+            console.log(chalk.yellow(i18n.t('wizard.tool_not_installed', { tool: tool.displayName })));
             return;
         }
         await wizard.showToolMenu(subCommand);
@@ -127,7 +130,8 @@ export async function configCommand(args) {
     console.error(chalk.red(`Unknown command: ${subCommand}`));
     console.log(chalk.gray('Usage: chelper config [tool-name]'));
     console.log(chalk.gray('Available tools:'));
-    Object.values(SUPPORTED_TOOLS).forEach((tool) => {
-        console.log(chalk.gray(`  - ${tool.name}: ${tool.displayName}`));
+    const supportedTools = toolRegistry.getSupportedTools();
+    supportedTools.forEach((t) => {
+        console.log(chalk.gray(`  - ${t.name}: ${t.displayName}`));
     });
 }

package/dist/commands/doctor.js

@@ -1,10 +1,10 @@
 import chalk from 'chalk';
 import ora from 'ora';
 import { validateApiKey } from '../lib/api-validator.js';
-import { claudeCodeManager } from '../lib/claude-code-manager.js';
 import { configManager } from '../lib/config.js';
 import { i18n } from '../lib/i18n.js';
 import { toolManager } from '../lib/tool-manager.js';
+import { claudeCodeTool } from '../lib/tools/claude-code-tool.js';
 export async function doctorCommand() {
     const spinner = ora(i18n.t('doctor.checking')).start();
     const results = [];
@@ -73,7 +73,7 @@ export async function doctorCommand() {
     }
     // Check 4: Configuration status
     spinner.text = i18n.t('doctor.check_config');
-    claudeCodeManager.getModelConfig();
+    claudeCodeTool.getModelConfig();
     const models = configManager.getModels();
     const configComplete = !!apiKey && !!(models.haikuModel || models.sonnetModel || models.opusModel);
     let configMessage = '';

package/dist/index.d.ts

@@ -2,6 +2,6 @@
 export * from './lib/command.js';
 export * from './lib/config.js';
 export * from './lib/i18n.js';
-export * from './lib/opencode-manager.js';
 export * from './lib/tool-manager.js';
+export * from './lib/tools/index.js';
 export * from './lib/wizard.js';

package/dist/index.js

@@ -2,6 +2,6 @@
 export * from './lib/command.js';
 export * from './lib/config.js';
 export * from './lib/i18n.js';
-export * from './lib/opencode-manager.js';
 export * from './lib/tool-manager.js';
+export * from './lib/tools/index.js';
 export * from './lib/wizard.js';

package/dist/lib/config.d.ts

@@ -6,6 +6,7 @@ export interface ChelperConfig {
     opusModel?: string;
     openCodeModel?: string;
     openCodeSmallModel?: string;
+    codexModel?: string;
 }
 export declare class ConfigManager {
     private static instance;
@@ -43,5 +44,7 @@ export declare class ConfigManager {
         openCodeModel?: string;
         openCodeSmallModel?: string;
     }): void;
+    getCodexModel(): string | undefined;
+    setCodexModel(model: string): void;
 }
 export declare const configManager: ConfigManager;

package/dist/lib/config.js

@@ -102,5 +102,11 @@ export class ConfigManager {
     setOpenCodeModels(models) {
         this.updateConfig(models);
     }
+    getCodexModel() {
+        return this.config.codexModel;
+    }
+    setCodexModel(model) {
+        this.updateConfig({ codexModel: model });
+    }
 }
 export const configManager = ConfigManager.getInstance();

package/dist/lib/model-service.d.ts

@@ -0,0 +1,49 @@
+export interface ModelInfo {
+    id: string;
+    name?: string;
+    context_length?: number;
+    max_output_tokens?: number;
+}
+/**
+ * 模型服务
+ * 负责模型列表的获取、缓存和同步
+ */
+export declare class ModelService {
+    private static instance;
+    private cachedModels;
+    private cachedModelsWithInfo;
+    private constructor();
+    static getInstance(): ModelService;
+    /**
+     * 获取可用模型列表（带缓存）
+     */
+    fetchModels(): Promise<string[]>;
+    /**
+     * 获取带详细信息的模型列表
+     */
+    fetchModelsWithInfo(apiKey: string): Promise<ModelInfo[]>;
+    /**
+     * 清除缓存
+     */
+    clearCache(): void;
+    /**
+     * 刷新模型列表（仅获取最新数据）
+     */
+    refreshModels(): Promise<{
+        success: boolean;
+        count: number;
+    }>;
+    /**
+     * 刷新并同步模型列表到 OpenCode 配置
+     * 只更新 provider.xaio.models，不改变当前选择的模型
+     */
+    refreshAndSyncToOpenCode(): Promise<{
+        success: boolean;
+        count: number;
+    }>;
+    /**
+     * 获取缓存的模型数量
+     */
+    getCachedCount(): number;
+}
+export declare const modelService: ModelService;

package/dist/lib/model-service.js

@@ -0,0 +1,129 @@
+import { configManager } from './config.js';
+import { openCodeTool } from './tools/opencode-tool.js';
+/**
+ * 模型服务
+ * 负责模型列表的获取、缓存和同步
+ */
+export class ModelService {
+    static instance;
+    cachedModels = [];
+    cachedModelsWithInfo = [];
+    constructor() { }
+    static getInstance() {
+        if (!ModelService.instance) {
+            ModelService.instance = new ModelService();
+        }
+        return ModelService.instance;
+    }
+    /**
+     * 获取可用模型列表（带缓存）
+     */
+    async fetchModels() {
+        const apiKey = configManager.getApiKey();
+        if (!apiKey) {
+            return [];
+        }
+        if (this.cachedModels.length > 0) {
+            return this.cachedModels;
+        }
+        const modelsWithInfo = await this.fetchModelsWithInfo(apiKey);
+        this.cachedModels = modelsWithInfo.map(m => m.id);
+        return this.cachedModels;
+    }
+    /**
+     * 获取带详细信息的模型列表
+     */
+    async fetchModelsWithInfo(apiKey) {
+        if (this.cachedModelsWithInfo.length > 0) {
+            return this.cachedModelsWithInfo;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), 30000);
+        try {
+            const response = await fetch('https://code-api.x-aio.com/v1/models', {
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const data = await response.json();
+            if (data && data.data && Array.isArray(data.data)) {
+                this.cachedModelsWithInfo = data.data.map((m) => ({
+                    id: m.id,
+                    name: m.name || m.id,
+                    context_length: m.context_length,
+                    max_output_tokens: m.max_output_tokens,
+                }));
+                this.cachedModels = this.cachedModelsWithInfo.map(m => m.id);
+                return this.cachedModelsWithInfo;
+            }
+            return [];
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            throw error;
+        }
+    }
+    /**
+     * 清除缓存
+     */
+    clearCache() {
+        this.cachedModels = [];
+        this.cachedModelsWithInfo = [];
+    }
+    /**
+     * 刷新模型列表（仅获取最新数据）
+     */
+    async refreshModels() {
+        const apiKey = configManager.getApiKey();
+        if (!apiKey) {
+            return { success: false, count: 0 };
+        }
+        this.clearCache();
+        try {
+            const models = await this.fetchModelsWithInfo(apiKey);
+            return { success: models.length > 0, count: models.length };
+        }
+        catch {
+            return { success: false, count: 0 };
+        }
+    }
+    /**
+     * 刷新并同步模型列表到 OpenCode 配置
+     * 只更新 provider.xaio.models，不改变当前选择的模型
+     */
+    async refreshAndSyncToOpenCode() {
+        const apiKey = configManager.getApiKey();
+        if (!apiKey) {
+            return { success: false, count: 0 };
+        }
+        this.clearCache();
+        try {
+            // 获取最新模型
+            const models = await this.fetchModelsWithInfo(apiKey);
+            if (models.length === 0) {
+                return { success: false, count: 0 };
+            }
+            // 同步到 OpenCode 配置
+            openCodeTool.syncModelsToConfig(models);
+            return { success: true, count: models.length };
+        }
+        catch {
+            return { success: false, count: 0 };
+        }
+    }
+    /**
+     * 获取缓存的模型数量
+     */
+    getCachedCount() {
+        return this.cachedModels.length;
+    }
+}
+// 单例导出
+export const modelService = ModelService.getInstance();

package/dist/lib/plugins/ccline-plugin.d.ts

@@ -0,0 +1,40 @@
+import type { IPlugin } from '../tools/base-tool.js';
+/**
+ * CCLine 插件实现
+ * CCLine 是 Claude Code 的增强插件
+ */
+export declare class CCLinePlugin implements IPlugin {
+    readonly name = "ccline";
+    readonly displayName = "CCLine";
+    private settingsPath;
+    constructor();
+    /**
+     * 检查 CCLine 是否已安装
+     */
+    isInstalled(): boolean;
+    /**
+     * 安装 CCLine
+     */
+    install(): Promise<void>;
+    /**
+     * 装载 CCLine（添加到 Claude Code 配置）
+     */
+    load(): void;
+    /**
+     * 取消装载 CCLine（从配置中移除）
+     */
+    unload(): void;
+    /**
+     * 检查 CCLine 是否已装载到配置
+     */
+    isLoaded(): boolean;
+    /**
+     * 读取 Claude Code settings.json
+     */
+    private getSettings;
+    /**
+     * 保存 Claude Code settings.json
+     */
+    private saveSettings;
+}
+export declare const cclinePlugin: CCLinePlugin;

package/dist/lib/plugins/ccline-plugin.js

@@ -0,0 +1,116 @@
+import { execSync, spawn } from 'node:child_process';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * CCLine 插件实现
+ * CCLine 是 Claude Code 的增强插件
+ */
+export class CCLinePlugin {
+    name = 'ccline';
+    displayName = 'CCLine';
+    settingsPath;
+    constructor() {
+        this.settingsPath = join(homedir(), '.claude', 'settings.json');
+    }
+    /**
+     * 检查 CCLine 是否已安装
+     */
+    isInstalled() {
+        try {
+            // 检查 ccline 命令是否可用
+            const cmd = process.platform === 'win32' ? 'where ccline' : 'which ccline';
+            execSync(cmd, { stdio: 'pipe' });
+            return true;
+        }
+        catch {
+            // 如果命令不存在，尝试检查 npm 全局包
+            try {
+                execSync('npm list -g @cometix/ccline', { stdio: 'pipe' });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+    }
+    /**
+     * 安装 CCLine
+     */
+    async install() {
+        const isWindows = process.platform === 'win32';
+        const command = isWindows ? 'npm.cmd' : 'npm';
+        const args = ['install', '-g', '@cometix/ccline'];
+        return new Promise((resolve, reject) => {
+            const child = spawn(command, args, {
+                stdio: 'inherit',
+                shell: true,
+            });
+            child.on('close', (code) => {
+                if (code === 0) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`CCLine install failed with code ${code}`));
+                }
+            });
+            child.on('error', (error) => {
+                reject(error);
+            });
+        });
+    }
+    /**
+     * 装载 CCLine（添加到 Claude Code 配置）
+     */
+    load() {
+        const settings = this.getSettings();
+        // CCLine 使用 statusLine 配置
+        settings.statusLine = {
+            type: 'command',
+            command: 'ccline',
+            padding: 0,
+        };
+        this.saveSettings(settings);
+    }
+    /**
+     * 取消装载 CCLine（从配置中移除）
+     */
+    unload() {
+        const settings = this.getSettings();
+        // 检查 statusLine 是否是 ccline 配置
+        if (settings.statusLine && settings.statusLine.command === 'ccline') {
+            delete settings.statusLine;
+            this.saveSettings(settings);
+        }
+    }
+    /**
+     * 检查 CCLine 是否已装载到配置
+     */
+    isLoaded() {
+        const settings = this.getSettings();
+        return !!(settings.statusLine && settings.statusLine.command === 'ccline');
+    }
+    /**
+     * 读取 Claude Code settings.json
+     */
+    getSettings() {
+        try {
+            if (existsSync(this.settingsPath)) {
+                const content = readFileSync(this.settingsPath, 'utf-8');
+                return JSON.parse(content);
+            }
+        }
+        catch {
+            // ignore
+        }
+        return {};
+    }
+    /**
+     * 保存 Claude Code settings.json
+     */
+    saveSettings(settings) {
+        writeFileSync(this.settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
+    }
+}
+// 单例导出
+export const cclinePlugin = new CCLinePlugin();

package/dist/lib/plugins/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ccline-plugin.js';
+export * from './oh-my-opencode-plugin.js';

package/dist/lib/plugins/index.js

@@ -0,0 +1,3 @@
+// 插件导出
+export * from './ccline-plugin.js';
+export * from './oh-my-opencode-plugin.js';