@openharmonyinsight/opencode-oh 0.1.0

package/dist/src/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsBlH"}

package/dist/src/validation/index.js

@@ -0,0 +1,24 @@
+import { getProviderTemplate } from '../provider/templates.js';
+export async function validateApiKey(providerId, apiKey, model) {
+    const template = getProviderTemplate(providerId);
+    if (!template) {
+        return { valid: false, error: `Unknown provider: ${providerId}` };
+    }
+    if (!template.supportsApiKeyValidation || !template.validateApiKey) {
+        return { valid: true };
+    }
+    try {
+        const valid = await template.validateApiKey(apiKey, model || '');
+        if (!valid) {
+            return { valid: false, error: 'API key validation failed' };
+        }
+        return { valid: true };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            error: `Validation error: ${error instanceof Error ? error.message : String(error)}`
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAO/D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB,EAAE,MAAc,EAAE,KAAc;IACrF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,UAAU,EAAE,EAAE,CAAC;IACpE,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,wBAAwB,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QACnE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC;QAC9D,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SACrF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tests/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/tests/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../../tests/config.test.ts"],"names":[],"mappings":""}

package/dist/tests/config.test.js

@@ -0,0 +1,104 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { ConfigManager } from '../src/config/index.js';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+describe('ConfigManager', () => {
+    let configManager;
+    let testConfigPath;
+    let testConfigDir;
+    beforeEach(() => {
+        testConfigDir = fs.mkdtempSync(path.join(os.tmpdir(), 'opencode-oh-test-'));
+        testConfigPath = path.join(testConfigDir, 'opencode.json');
+        configManager = new ConfigManager();
+        configManager.configPath = testConfigPath;
+    });
+    afterEach(() => {
+        if (fs.existsSync(testConfigDir)) {
+            fs.rmSync(testConfigDir, { recursive: true, force: true });
+        }
+    });
+    it('should return null when config does not exist', () => {
+        const config = configManager.readConfig();
+        expect(config).toBeNull();
+    });
+    it('should read existing config', () => {
+        const testConfig = {
+            $schema: 'https://opencode.ai/config.json',
+            provider: {}
+        };
+        fs.writeFileSync(testConfigPath, JSON.stringify(testConfig));
+        const config = configManager.readConfig();
+        expect(config).toEqual(testConfig);
+    });
+    it('should write config', () => {
+        const testConfig = {
+            $schema: 'https://opencode.ai/config.json',
+            provider: {}
+        };
+        configManager.writeConfig(testConfig);
+        expect(fs.existsSync(testConfigPath)).toBe(true);
+        const read = JSON.parse(fs.readFileSync(testConfigPath, 'utf-8'));
+        expect(read).toEqual(testConfig);
+    });
+    it('should backup existing config', () => {
+        const testConfig = {
+            $schema: 'https://opencode.ai/config.json',
+            provider: {}
+        };
+        fs.writeFileSync(testConfigPath, JSON.stringify(testConfig));
+        const backupPath = configManager.backupConfig();
+        expect(backupPath).toBeTruthy();
+        expect(fs.existsSync(backupPath)).toBe(true);
+    });
+    it('should return null when backing up non-existent config', () => {
+        const backupPath = configManager.backupConfig();
+        expect(backupPath).toBeNull();
+    });
+    it('should add provider to config', () => {
+        const input = {
+            providerId: 'volcengine',
+            apiKey: 'test-key',
+            modelName: 'test-model'
+        };
+        configManager.addProvider(input);
+        const config = configManager.readConfig();
+        expect(config).not.toBeNull();
+        expect(config?.provider.volcengine).toBeDefined();
+        expect(config?.provider.volcengine.options.apiKey).toBe('test-key');
+    });
+    it('should add provider to config when provider property is missing', () => {
+        const testConfig = {
+            $schema: 'https://opencode.ai/config.json'
+        };
+        fs.writeFileSync(testConfigPath, JSON.stringify(testConfig));
+        const input = {
+            providerId: 'volcengine',
+            apiKey: 'test-key',
+            modelName: 'test-model'
+        };
+        configManager.addProvider(input);
+        const config = configManager.readConfig();
+        expect(config).not.toBeNull();
+        expect(config?.provider.volcengine).toBeDefined();
+        expect(config?.provider.volcengine.options.apiKey).toBe('test-key');
+    });
+    it('should add provider to config when provider is null', () => {
+        const testConfig = {
+            $schema: 'https://opencode.ai/config.json',
+            provider: null
+        };
+        fs.writeFileSync(testConfigPath, JSON.stringify(testConfig));
+        const input = {
+            providerId: 'volcengine',
+            apiKey: 'test-key',
+            modelName: 'test-model'
+        };
+        configManager.addProvider(input);
+        const config = configManager.readConfig();
+        expect(config).not.toBeNull();
+        expect(config?.provider.volcengine).toBeDefined();
+        expect(config?.provider.volcengine.options.apiKey).toBe('test-key');
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/tests/config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../../tests/config.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,aAA4B,CAAC;IACjC,IAAI,cAAsB,CAAC;IAC3B,IAAI,aAAqB,CAAC;IAE1B,UAAU,CAAC,GAAG,EAAE;QACd,aAAa,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;QAC5E,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;QAC3D,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QACnC,aAAqB,CAAC,UAAU,GAAG,cAAc,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YACjC,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,UAAU,GAAG;YACjB,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,EAAE;SACb,CAAC;QACF,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,UAAU,GAAG;YACjB,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,EAAE;SACb,CAAC;QACF,aAAa,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;QAClE,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,UAAU,GAAG;YACjB,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,EAAE;SACb,CAAC;QACF,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,aAAa,CAAC,YAAY,EAAE,CAAC;QAChD,MAAM,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE,CAAC;QAChC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,UAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,UAAU,GAAG,aAAa,CAAC,YAAY,EAAE,CAAC;QAChD,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,KAAK,GAAkB;YAC3B,UAAU,EAAE,YAAY;YACxB,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,YAAY;SACxB,CAAC;QACF,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QAClD,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,UAAU,GAAG;YACjB,OAAO,EAAE,iCAAiC;SAC3C,CAAC;QACF,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QAE7D,MAAM,KAAK,GAAkB;YAC3B,UAAU,EAAE,YAAY;YACxB,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,YAAY;SACxB,CAAC;QACF,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QAClD,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,UAAU,GAAG;YACjB,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QAE7D,MAAM,KAAK,GAAkB;YAC3B,UAAU,EAAE,YAAY;YACxB,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,YAAY;SACxB,CAAC;QACF,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QAClD,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/validation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.test.d.ts.map

package/dist/tests/validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.d.ts","sourceRoot":"","sources":["../../tests/validation.test.ts"],"names":[],"mappings":""}

package/dist/tests/validation.test.js

@@ -0,0 +1,37 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { validateApiKey } from '../src/validation/index.js';
+describe('validateApiKey', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should validate volcengine API key successfully', async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true
+        });
+        global.fetch = mockFetch;
+        const result = await validateApiKey('volcengine', 'valid-key');
+        expect(result.valid).toBe(true);
+    });
+    it('should return error for invalid volcengine API key', async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: false
+        });
+        global.fetch = mockFetch;
+        const result = await validateApiKey('volcengine', 'invalid-key');
+        expect(result.valid).toBe(false);
+        expect(result.error).toBeDefined();
+    });
+    it('should handle network errors', async () => {
+        const mockFetch = vi.fn().mockRejectedValue(new Error('Network error'));
+        global.fetch = mockFetch;
+        const result = await validateApiKey('volcengine', 'test-key');
+        expect(result.valid).toBe(false);
+        expect(result.error).toBe('API key validation failed');
+    });
+    it('should return error for unknown provider', async () => {
+        const result = await validateApiKey('unknown', 'test-key');
+        expect(result.valid).toBe(false);
+        expect(result.error).toContain('Unknown provider');
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/tests/validation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.js","sourceRoot":"","sources":["../../tests/validation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC1C,EAAE,EAAE,IAAI;SACT,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC;QAEzB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QAC/D,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC1C,EAAE,EAAE,KAAK;SACV,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC;QAEzB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QACjE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;QACxE,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC;QAEzB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/docs/plans/2026-02-12-opencode-oh-design.md

@@ -0,0 +1,90 @@
+# opencode-oh Design Document
+
+**Date:** 2026-02-12
+**Topic:** opencode-oh - OpenHarmony OpenCode Helper Tool
+
+## Overview
+
+opencode-oh is a CLI helper tool for configuring opencode with third-party model providers. It features an interactive TUI interface and supports API key validation, configuration backup, and multi-language support.
+
+## Architecture
+
+### Core Components
+
+**Configuration Management Module**
+- Reads, parses, backs up, and writes `~/.config/opencode/opencode.json`
+- Validates configuration integrity using JSON Schema
+
+**Provider Module**
+- Defines configuration templates for providers (e.g., Volcengine)
+- Implements provider-specific validation logic
+- Extensible for additional providers
+
+**TUI Interaction Module**
+- Interactive interface using inquirer or prompts
+- Supports bilingual (Chinese/English) prompts and error messages
+- Guides users through the configuration process
+
+**Validation Module**
+- Validates API keys by calling Provider APIs
+- Ensures configuration usability before committing changes
+
+**Main Program Flow**
+1. Start → Detect configuration file
+2. TUI select provider → Guide user input
+3. Validate API → Backup config
+4. Update configuration
+
+## Data Structures
+
+```typescript
+interface ProviderConfig {
+  npm: string;  // @ai-sdk/openai-compatible
+  name: string;
+  options: {
+    baseURL: string;
+    apiKey: string;
+  };
+  models: Record<string, { name: string }>;
+}
+
+interface OpenCodeConfig {
+  $schema: string;
+  provider: Record<string, ProviderConfig>;
+}
+
+interface ProviderTemplate {
+  id: string;
+  displayName: string;
+  npm: string;
+  baseURL: string;
+  supportsApiKeyValidation: boolean;
+  validateApiKey?: (apiKey: string, model: string) => Promise<boolean>;
+}
+```
+
+Provider templates predefine common providers like Volcengine, with support for dynamic extension. TUI-collected input maps to ProviderConfig and merges into existing configuration.
+
+## Error Handling
+
+- **Config file missing or invalid**: Prompt user, ask to create default config
+- **API validation failure**: Offer retry or skip option, log error
+- **File write failure**: Restore backup, prompt about permissions
+- **Network errors**: Friendly timeout message, suggest network check
+
+## Testing Strategy
+
+- **Unit tests**: Config read/write, template mapping, validation logic
+- **Integration tests**: Simulated TUI input, verify complete configuration flow
+- **E2E tests**: Execute actual configuration in temp directory, verify generated opencode.json
+- **Mock API tests**: Use nock to simulate Provider API responses
+
+**Framework**: Vitest
+**Coverage target**: 80%+
+
+## Implementation Notes
+
+- Language: Node.js with TypeScript
+- TUI Framework: Interactive prompts with bilingual support
+- Configuration path: `~/.config/opencode/opencode.json`
+- Backup strategy: Automatic `.bak` file before modifications

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@openharmonyinsight/opencode-oh",
+  "version": "0.1.0",
+  "description": "OpenHarmony OpenCode Helper Tool - Configure opencode with third-party model providers",
+  "main": "dist/index.js",
+  "bin": {
+    "opencode-oh": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src --ext .ts",
+    "dev": "tsx src/cli.ts"
+  },
+  "keywords": [
+    "opencode",
+    "openharmony",
+    "cli",
+    "tui"
+  ],
+  "author": "raymond.wangxing@huawei.com",
+  "homepage": "https://openharmonyinsight.cn",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "inquirer": "^9.3.7"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.8",
+    "@types/node": "^22.10.5",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^9.17.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.18"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { run } from './index.js';
+
+run().catch(error => {
+  console.error('Fatal error:', error);
+  process.exit(1);
+});

package/src/config/index.ts

@@ -0,0 +1,106 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import type { OpenCodeConfig, ProviderConfig, ProviderInput } from './types.js';
+import { getProviderTemplate } from '../provider/templates.js';
+
+const CONFIG_DIR = path.join(os.homedir(), '.config', 'opencode');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'opencode.json');
+const DEFAULT_SCHEMA = 'https://opencode.ai/config.json';
+
+export class ConfigManager {
+  private configPath: string;
+  
+  constructor() {
+    this.configPath = CONFIG_FILE;
+  }
+
+  getConfigPath(): string {
+    return this.configPath;
+  }
+
+  readConfig(): OpenCodeConfig | null {
+    try {
+      if (!fs.existsSync(this.configPath)) {
+        return null;
+      }
+      const content = fs.readFileSync(this.configPath, 'utf-8');
+      return JSON.parse(content);
+    } catch (error) {
+      throw new Error(`Failed to read config: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+
+  writeConfig(config: OpenCodeConfig): void {
+    try {
+      const configDir = path.dirname(this.configPath);
+      if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+      }
+      fs.writeFileSync(this.configPath, JSON.stringify(config, null, 2), 'utf-8');
+    } catch (error) {
+      throw new Error(`Failed to write config: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+
+  backupConfig(): string | null {
+    try {
+      if (!fs.existsSync(this.configPath)) {
+        return null;
+      }
+      const backupPath = `${this.configPath}.bak`;
+      const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+      const timestampedBackupPath = `${this.configPath}.${timestamp}.bak`;
+      
+      fs.copyFileSync(this.configPath, timestampedBackupPath);
+      return timestampedBackupPath;
+    } catch (error) {
+      throw new Error(`Failed to backup config: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+
+  restoreBackup(backupPath: string): void {
+    try {
+      fs.copyFileSync(backupPath, this.configPath);
+    } catch (error) {
+      throw new Error(`Failed to restore backup: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+
+  addProvider(input: ProviderInput): void {
+    const config = this.readConfig() || this.getDefaultConfig();
+
+    if (!config.provider || typeof config.provider !== 'object') {
+      config.provider = {};
+    }
+
+    const template = getProviderTemplate(input.providerId);
+    if (!template) {
+      throw new Error(`Unknown provider: ${input.providerId}`);
+    }
+
+    const providerConfig: ProviderConfig = {
+      npm: template.npm,
+      name: template.id,
+      options: {
+        baseURL: template.baseURL,
+        apiKey: input.apiKey
+      },
+      models: {
+        [input.modelName]: {
+          name: input.modelName
+        }
+      }
+    };
+
+    config.provider[input.providerId] = providerConfig;
+    this.writeConfig(config);
+  }
+
+  getDefaultConfig(): OpenCodeConfig {
+    return {
+      $schema: DEFAULT_SCHEMA,
+      provider: {}
+    };
+  }
+}

package/src/config/types.ts

@@ -0,0 +1,29 @@
+export interface ProviderConfig {
+  npm: string;
+  name: string;
+  options: {
+    baseURL: string;
+    apiKey: string;
+  };
+  models: Record<string, { name: string }>;
+}
+
+export interface OpenCodeConfig {
+  $schema: string;
+  provider: Record<string, ProviderConfig>;
+}
+
+export interface ProviderTemplate {
+  id: string;
+  displayName: string;
+  npm: string;
+  baseURL: string;
+  supportsApiKeyValidation: boolean;
+  validateApiKey?: (apiKey: string, model: string) => Promise<boolean>;
+}
+
+export interface ProviderInput {
+  providerId: string;
+  apiKey: string;
+  modelName: string;
+}

package/src/index.ts

@@ -0,0 +1,26 @@
+import { ConfigManager } from './config/index.js';
+import { TUIManager } from './tui/index.js';
+
+export async function run(): Promise<void> {
+  const configManager = new ConfigManager();
+  const tuiManager = new TUIManager();
+
+  try {
+    const input = await tuiManager.run();
+    if (!input) {
+      console.log('Cancelled');
+      return;
+    }
+
+    const backupPath = configManager.backupConfig();
+    if (backupPath) {
+      tuiManager.showBackup(backupPath);
+    }
+
+    configManager.addProvider(input);
+    tuiManager.showMessage('configUpdated');
+  } catch (error) {
+    tuiManager.showError(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+}

package/src/provider/templates.ts

@@ -0,0 +1,76 @@
+import type { ProviderTemplate } from '../config/types.js';
+
+export const PROVIDER_TEMPLATES: Record<string, ProviderTemplate> = {
+  volcengine: {
+    id: 'volcengine',
+    displayName: '火山引擎',
+    npm: '@ai-sdk/openai-compatible',
+    baseURL: 'https://ark.cn-beijing.volces.com/api/v3',
+    supportsApiKeyValidation: true,
+    validateApiKey: async (apiKey: string, model: string) => {
+      try {
+        const response = await fetch('https://ark.cn-beijing.volces.com/api/v3/models', {
+          method: 'GET',
+          headers: {
+            'Authorization': `Bearer ${apiKey}`,
+            'Content-Type': 'application/json'
+          }
+        });
+        return response.ok;
+      } catch {
+        return false;
+      }
+    }
+  },
+
+  'volcengine-codingplan': {
+    id: 'volcengine-codingplan',
+    displayName: '火山引擎CodingPlan',
+    npm: '@ai-sdk/openai-compatible',
+    baseURL: 'https://ark.cn-beijing.volces.com/api/coding/v3',
+    supportsApiKeyValidation: true,
+    validateApiKey: async (apiKey: string, model: string) => {
+      try {
+        const response = await fetch('https://ark.cn-beijing.volces.com/api/coding/v3/models', {
+          method: 'GET',
+          headers: {
+            'Authorization': `Bearer ${apiKey}`,
+            'Content-Type': 'application/json'
+          }
+        });
+        return response.ok;
+      } catch {
+        return false;
+      }
+    }
+  },
+
+  'ZhiPu-CodingPlan': {
+    id: 'ZhiPu-CodingPlan',
+    displayName: '智谱CodingPlan',
+    npm: '@ai-sdk/openai-compatible',
+    baseURL: 'https://open.bigmodel.cn/api/paas/v4',
+    supportsApiKeyValidation: true,
+    validateApiKey: async (apiKey: string) => {
+      try {
+        const response = await fetch('https://open.bigmodel.cn/api/paas/v4/models', {
+          method: 'GET',
+          headers: {
+            'Authorization': `Bearer ${apiKey}`
+          }
+        });
+        return response.ok;
+      } catch {
+        return false;
+      }
+    }
+  }
+};
+
+export function getProviderTemplate(id: string): ProviderTemplate | undefined {
+  return PROVIDER_TEMPLATES[id];
+}
+
+export function getAllProviderTemplates(): ProviderTemplate[] {
+  return Object.values(PROVIDER_TEMPLATES);
+}