Skip to content

armgit / Orkas

Public Imported from GitHub
0

Orkas is an open-source (MIT), local-first AI team for your desktop: a Commander turns your goal into to-dos and coordinates 16 built-in specialist agents plus Claude Code, Codex, OpenCode, OpenClaw and Hermes, with projects, scheduled automations and connectors. Free app for macOS & Windows; built-in models or your own keys.

Fix localized API key handoff

BlueSkyID666dad53d9c57e9
diff --git a/src/renderer/modules/settings.js b/src/renderer/modules/settings.js
index 1e6ae1cb..ec12dfd7 100644
--- a/src/renderer/modules/settings.js
+++ b/src/renderer/modules/settings.js
@@ -15,6 +15,19 @@ const _OPENROUTER_CUSTOM_MODEL_VALUE = '__openrouter_custom_model__';
const _ORKAS_API_PROVIDER_ID = 'orkas-api';
const _ORKAS_API_KEYS_URL = 'https://orkas.ai/views/account/account.html#api-keys';
+function _settingsLocalizedOrkasWebUrl(rawUrl) {
+ try {
+ const url = new URL(String(rawUrl || ''));
+ if (url.origin !== 'https://orkas.ai') return String(rawUrl || '');
+ const current = String(typeof getLang === 'function' ? getLang() : 'en').trim().toLowerCase();
+ const lang = ['zh', 'en', 'ja', 'pt'].includes(current) ? current : 'en';
+ url.searchParams.set('lang', lang);
+ return url.toString();
+ } catch (_) {
+ return String(rawUrl || '');
+ }
+}
+
function _settingsIsOpenRouterCustomModel(providerId, modelId) {
return providerId === 'openrouter' && modelId === _OPENROUTER_CUSTOM_MODEL_VALUE;
}
@@ -1032,7 +1045,8 @@ function _settingsBindOrkasApiOnce() {
_settingsState.orkasApiBound = true;
createBtn.addEventListener('click', async () => {
- const res = await window.orkas.invoke('auth.openExternal', { url: _ORKAS_API_KEYS_URL });
+ const url = _settingsLocalizedOrkasWebUrl(_ORKAS_API_KEYS_URL);
+ const res = await window.orkas.invoke('auth.openExternal', { url });
if (!res || !res.ok) {
_settingsSetI18nStatus('settings-orkas-api-status', 'error', 'settings.orkas_api.open_failed');
}
diff --git a/test/renderer/settings-orkas-api.test.ts b/test/renderer/settings-orkas-api.test.ts
index 848de207..58d7d87f 100644
--- a/test/renderer/settings-orkas-api.test.ts
+++ b/test/renderer/settings-orkas-api.test.ts
@@ -37,7 +37,7 @@ class FakeElement {
click() { return this.dispatch('click'); }
}
-function loadQuickSetupHarness() {
+function loadQuickSetupHarness(language = 'en') {
const source = readFileSync(resolve(__dirname, '../../src/renderer/modules/settings.js'), 'utf8');
const html = readFileSync(resolve(__dirname, '../../src/renderer/index.html'), 'utf8');
const elements = new Map<string, FakeElement>();
@@ -60,6 +60,7 @@ function loadQuickSetupHarness() {
createLogger: () => ({ info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn() }),
escapeHtml: (value: unknown) => String(value ?? ''),
t: (key: string) => key,
+ getLang: () => language,
document: {
getElementById: (id: string) => elements.get(id) || null,
createElement: () => new FakeElement(),
@@ -196,7 +197,7 @@ describe('Orkas public API quick setup', () => {
await elements.get('settings-orkas-api-configure')!.click();
expect(invoke).toHaveBeenCalledWith('auth.openExternal', {
- url: 'https://orkas.ai/views/account/account.html#api-keys',
+ url: 'https://orkas.ai/views/account/account.html?lang=en#api-keys',
});
expect(invoke).toHaveBeenCalledWith('orkasApi.configureAll', {
apiKey: 'public-orkas-key',
@@ -206,6 +207,29 @@ describe('Orkas public API quick setup', () => {
expect(refreshModelGuard).toHaveBeenCalledOnce();
});
+ it.each(['zh', 'en', 'ja', 'pt'])('carries the %s desktop language to the API-key page', async (language) => {
+ const { elements, invoke } = loadQuickSetupHarness(language);
+
+ await elements.get('settings-orkas-api-create-key')!.click();
+
+ expect(invoke).toHaveBeenCalledWith('auth.openExternal', {
+ url: `https://orkas.ai/views/account/account.html?lang=${language}#api-keys`,
+ });
+ });
+
+ it('preserves existing query parameters and fragments while localizing Orkas Web URLs', () => {
+ const { context } = loadQuickSetupHarness('ja');
+
+ expect(vm.runInContext(
+ "_settingsLocalizedOrkasWebUrl('https://orkas.ai/views/account/account.html?source=settings#api-keys')",
+ context,
+ )).toBe('https://orkas.ai/views/account/account.html?source=settings&lang=ja#api-keys');
+ expect(vm.runInContext(
+ "_settingsLocalizedOrkasWebUrl('https://example.com/account?source=settings#api-keys')",
+ context,
+ )).toBe('https://example.com/account?source=settings#api-keys');
+ });
+
it('keeps dynamic setup status bound to an i18n key after language changes', async () => {
const { context, elements } = loadQuickSetupHarness();
elements.get('settings-orkas-api-key-input')!.value = 'public-orkas-key';