@co0ontty/wand 4.14.0 → 4.15.0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "a6331de5ad360ff5cd861a4ffe8bc5dc37f56562",
-  "builtAt": "2026-07-18T00:02:56.112Z",
-  "version": "4.14.0",
+  "commit": "4cb2d575fe6ffe06c991374d39dfef79740befeb",
+  "builtAt": "2026-07-18T00:38:58.299Z",
+  "version": "4.15.0",
   "channel": "stable"
 }

package/dist/cli.js

@@ -110,6 +110,11 @@ async function main() {
                     systemAi: config.systemAi ? {
                         ...config.systemAi,
                         apiKey: config.systemAi.apiKey ? "<set>" : "",
+                        fallbacks: config.systemAi.fallbacks?.map((profile) => ({
+                            ...profile,
+                            apiKey: profile.apiKey ? "<set>" : "",
+                            fallbacks: undefined,
+                        })),
                     } : undefined,
                 };
                 process.stdout.write(`${JSON.stringify(display, null, 2)}\n`);

package/dist/config.js

@@ -4,7 +4,7 @@ import { chmod, mkdir, readFile, rename, unlink, writeFile } from "node:fs/promi
 import path from "node:path";
 import process from "node:process";
 import { isRunningAsRoot } from "./env-utils.js";
-import { normalizeSystemAiConfig } from "./system-ai.js";
+import { normalizeSystemAiConfig, systemAiProfiles } from "./system-ai.js";
 function isThinkingEffort(value) {
     return value === "off"
         || value === "standard"
@@ -513,8 +513,7 @@ export function writePreferenceToStorage(config, storage, key, value, options =
 export function validateCommitAiConfig(config) {
     if (config.commitAiSource !== "api")
         return;
-    const directApi = config.systemAi;
-    if (!directApi?.baseUrl || !directApi.apiKey || !directApi.model) {
+    if (!systemAiProfiles(config.systemAi, true).length) {
         throw new Error("选择直连 API 生成 Commit 时，必须先填写 API 地址、API Key 和模型。");
     }
 }

package/dist/git-quick-commit.js

@@ -1,7 +1,7 @@
 import { existsSync } from "node:fs";
 import { spawn } from "node:child_process";
 import { ClaudeRunError, runClaudePrint } from "./claude-sdk-runner.js";
-import { callSystemAiText } from "./system-ai.js";
+import { callSystemAiTextWithFallback } from "./system-ai.js";
 import { buildChildEnv } from "./env-utils.js";
 import { runGit as runGitBase, runGitAsync as runGitAsyncBase, runGitRaw as runGitRawBase, runGitRawAsync as runGitRawAsyncBase, getGitErrorMessage, } from "./git-utils.js";
 import { thinkingEffortToClaudeCliEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToOpenCodeVariant } from "./structured-provider-common.js";
@@ -615,7 +615,7 @@ async function callCliAiText(prompt, cwd, language, opts) {
     return callClaudeText(prompt, cwd, language, opts.model);
 }
 async function callDirectApiText(prompt, systemAi) {
-    const text = await callSystemAiText(prompt, systemAi);
+    const text = await callSystemAiTextWithFallback(prompt, systemAi);
     if (!text.trim()) {
         throw new QuickCommitError("直连 API 返回了空结果。", "EMPTY_AI_MESSAGE");
     }

package/dist/process-manager.js

@@ -18,7 +18,7 @@ import { getProviderCommandSessionId, getProviderResumeCommandSessionId } from "
 import { normalizeThinkingEffort, thinkingEffortToClaudeCliEffort, thinkingEffortToClaudeSlashEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToOpenCodeVariant } from "./structured-provider-common.js";
 import { SessionTopicCoordinator } from "./session-topic.js";
 import { getErrorMessage } from "./error-utils.js";
-import { resolveCommitAiContext } from "./session-ai-context.js";
+import { resolveSystemAiContext } from "./session-ai-context.js";
 import { resolveSessionCwd } from "./session-cwd.js";
 import { ProviderHistoryScanner, } from "./provider-history-scanner.js";
 function resolveProviderFromCommand(command) {
@@ -1720,7 +1720,7 @@ export class ProcessManager extends EventEmitter {
             input: prompt,
             cwd: record.cwd,
             language: this.config.language,
-            ai: resolveCommitAiContext(record, this.config),
+            ai: resolveSystemAiContext(record, this.config),
             onGenerating: (generating) => {
                 if (!this.disposed)
                     this.setSessionTopicGenerating(id, generating);

package/dist/prompt-optimizer.js

@@ -1,5 +1,5 @@
 import { ClaudeRunError, runClaudePrint } from "./claude-sdk-runner.js";
-import { callSystemAiText } from "./system-ai.js";
+import { callSystemAiTextWithFallback } from "./system-ai.js";
 const CLAUDE_TIMEOUT_MS = 60_000;
 const MAX_INPUT_LENGTH = 8000;
 export class PromptOptimizeError extends Error {
@@ -51,7 +51,18 @@ export async function optimizePrompt(rawText, language, cwd, systemAi) {
         throw new PromptOptimizeError(`输入过长（${text.length} 字符），请缩短到 ${MAX_INPUT_LENGTH} 以内。`, "INPUT_TOO_LONG");
     }
     const prompt = buildOptimizePrompt(text, language);
-    const raw = systemAi?.enabled ? await callSystemAiText(prompt, systemAi) : await callClaudeText(prompt, cwd, language);
+    let raw;
+    if (systemAi?.enabled) {
+        try {
+            raw = await callSystemAiTextWithFallback(prompt, systemAi);
+        }
+        catch {
+            raw = await callClaudeText(prompt, cwd, language);
+        }
+    }
+    else {
+        raw = await callClaudeText(prompt, cwd, language);
+    }
     const cleaned = raw
         .replace(/^```[a-zA-Z]*\n?/, "")
         .replace(/\n?```$/, "")

package/dist/server-settings-routes.js

@@ -6,17 +6,13 @@ import { asyncRoute } from "./express-async.js";
 import { getProviderDefaultModels, PREFERENCE_KEYS, saveConfig, validateCommitAiConfig, writePreferenceToStorage, } from "./config.js";
 import { getCachedModels, refreshModels } from "./models.js";
 import { DEPLOYMENT_CONFIG_KEYS } from "./runtime-config.js";
-import { discoverCliSystemAiConfig, normalizeSystemAiConfig } from "./system-ai.js";
+import { discoverCliSystemAiConfigs, normalizeSystemAiConfig } from "./system-ai.js";
 function publicConfig(config) {
     const { password: _password, appSecret: _appSecret, ...safe } = config;
     const defaultModels = getProviderDefaultModels(config);
     return {
         ...safe,
-        systemAi: safe.systemAi ? {
-            ...safe.systemAi,
-            apiKey: "",
-            hasApiKey: Boolean(safe.systemAi.apiKey),
-        } : undefined,
+        systemAi: publicSystemAi(safe.systemAi),
         defaultModel: defaultModels.claude,
         defaultCodexModel: defaultModels.codex,
         defaultOpenCodeModel: defaultModels.opencode,
@@ -25,6 +21,21 @@ function publicConfig(config) {
         defaultModels,
     };
 }
+function publicSystemAi(systemAi) {
+    if (!systemAi)
+        return undefined;
+    return {
+        ...systemAi,
+        apiKey: "",
+        hasApiKey: Boolean(systemAi.apiKey),
+        fallbacks: systemAi.fallbacks?.map((profile) => ({
+            ...profile,
+            apiKey: "",
+            hasApiKey: Boolean(profile.apiKey),
+            fallbacks: undefined,
+        })),
+    };
+}
 function publicDistributionInfo(distribution) {
     const androidApk = { ...distribution.androidApk };
     const macosDmg = { ...distribution.macosDmg };
@@ -117,18 +128,19 @@ export function registerSettingsRoutes(app, deps) {
         const source = body.source === "codex" || body.source === "opencode" || body.source === "claude"
             ? body.source
             : config.commitCli;
-        const imported = discoverCliSystemAiConfig(source);
-        if (!imported) {
+        const imported = discoverCliSystemAiConfigs(source);
+        if (!imported.length) {
             res.status(404).json({ error: "没有在已配置的 CLI 文件中找到可直连的 API 地址、密钥和模型。" });
             return;
         }
         const candidate = runtimeConfig.createCandidate();
         writePreferenceToStorage(candidate, storage, "systemAi", {
-            ...imported,
+            ...imported[0],
             enabled: candidate.systemAi?.enabled === true,
+            fallbacks: imported.slice(1),
         });
         runtimeConfig.commit(candidate, new Set(["systemAi"]));
-        res.json({ ok: true, systemAi: (publicConfig(candidate).systemAi) });
+        res.json({ ok: true, count: imported.length, systemAi: (publicConfig(candidate).systemAi) });
     });
     app.get("/api/app-connect-code", requireAdmin, (req, res) => {
         res.json(deps.resolveAppConnectCode(req));
@@ -199,7 +211,15 @@ export function registerSettingsRoutes(app, deps) {
                 const apiKey = typeof body.systemAi.apiKey === "string" && body.systemAi.apiKey.trim()
                     ? body.systemAi.apiKey.trim()
                     : previous?.apiKey ?? "";
-                stagePreference("systemAi", normalizeSystemAiConfig({ ...previous, ...body.systemAi, apiKey }, previous));
+                const submittedFallbacks = Array.isArray(body.systemAi.fallbacks)
+                    ? body.systemAi.fallbacks.map((item, index) => {
+                        const raw = item && typeof item === "object" && !Array.isArray(item) ? item : {};
+                        const prior = previous?.fallbacks?.[index];
+                        const fallbackApiKey = typeof raw.apiKey === "string" && raw.apiKey.trim() ? raw.apiKey.trim() : prior?.apiKey ?? "";
+                        return { ...prior, ...raw, apiKey: fallbackApiKey, fallbacks: undefined };
+                    })
+                    : previous?.fallbacks;
+                stagePreference("systemAi", normalizeSystemAiConfig({ ...previous, ...body.systemAi, apiKey, fallbacks: submittedFallbacks }, previous));
             }
             for (const field of PREFERENCE_KEYS) {
                 if (field === "systemAi")

package/dist/session-ai-context.d.ts

@@ -16,5 +16,7 @@ export interface SessionAiContext {
 export declare function resolveSessionProvider(snapshot: Pick<SessionSnapshot, "provider" | "structuredState" | "runner" | "command">): SessionProvider;
 /** Build the provider-specific settings used by session-adjacent AI actions. */
 export declare function resolveSessionAiContext(snapshot: Pick<SessionSnapshot, "provider" | "structuredState" | "runner" | "command" | "selectedModel" | "thinkingEffort">, config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel" | "defaultThinkingEffort" | "inheritEnv">): SessionAiContext;
+/** Build the source order for Wand-owned AI features such as titles. */
+export declare function resolveSystemAiContext(snapshot: Parameters<typeof resolveSessionAiContext>[0], config: Parameters<typeof resolveSessionAiContext>[1] & Pick<WandConfig, "systemAi" | "commitCli" | "commitModel">): SessionAiContext;
 /** Build the AI context for quick-commit actions from their global preferences. */
 export declare function resolveCommitAiContext(snapshot: Pick<SessionSnapshot, "provider" | "structuredState" | "runner" | "command" | "selectedModel" | "thinkingEffort">, config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel" | "defaultThinkingEffort" | "inheritEnv" | "commitCli" | "commitModel" | "commitAiSource" | "systemAi">): SessionAiContext;

package/dist/session-ai-context.js

@@ -1,4 +1,5 @@
 import { getDefaultModelForProvider } from "./config.js";
+import { systemAiProfiles } from "./system-ai.js";
 /**
  * Resolve the provider from every representation used by current and legacy
  * sessions. Older persisted sessions may not have the top-level provider, but
@@ -45,7 +46,7 @@ function normalizeModel(value) {
     return model && model !== "default" ? model : undefined;
 }
 function usableSystemAi(config) {
-    if (!config.baseUrl.trim() || !config.apiKey.trim() || !config.model.trim())
+    if (!systemAiProfiles(config, true).length)
         return undefined;
     return { ...config, enabled: true };
 }
@@ -61,6 +62,17 @@ export function resolveSessionAiContext(snapshot, config) {
         inheritEnv: config.inheritEnv,
     };
 }
+/** Build the source order for Wand-owned AI features such as titles. */
+export function resolveSystemAiContext(snapshot, config) {
+    const sessionContext = resolveSessionAiContext(snapshot, config);
+    const directApi = config.systemAi ? usableSystemAi(config.systemAi) : undefined;
+    const cliContext = {
+        ...sessionContext,
+        provider: config.commitCli === "codex" || config.commitCli === "opencode" ? config.commitCli : "claude",
+        model: normalizeModel(config.commitModel),
+    };
+    return directApi && config.systemAi?.enabled ? { ...cliContext, systemAi: directApi } : cliContext;
+}
 /** Build the AI context for quick-commit actions from their global preferences. */
 export function resolveCommitAiContext(snapshot, config) {
     const sessionContext = resolveSessionAiContext(snapshot, config);

package/dist/structured-session-manager.js

@@ -7,7 +7,7 @@ import { getErrorMessage } from "./error-utils.js";
 import { resolveSdkClaudeBinary } from "./claude-sdk-runner.js";
 import { SessionTopicCoordinator } from "./session-topic.js";
 import { resolveSessionCwd } from "./session-cwd.js";
-import { resolveCommitAiContext } from "./session-ai-context.js";
+import { resolveSystemAiContext } from "./session-ai-context.js";
 import { CodexRunner } from "./structured-codex-adapter.js";
 import { normalizeStructuredToolResultContent } from "./structured-content.js";
 import { buildAppendSystemPromptParts, buildClaudeSdkThinking, ClaudeCliRunner, derivePermissionPolicy, } from "./structured-claude-adapter.js";
@@ -501,7 +501,7 @@ export class StructuredSessionManager {
             input,
             cwd: session.cwd,
             language: this.config.language,
-            ai: resolveCommitAiContext(session, this.config),
+            ai: resolveSystemAiContext(session, this.config),
             onGenerating: (generating) => {
                 if (!this.disposed)
                     this.setSessionTopicGenerating(id, generating);

package/dist/system-ai.d.ts

@@ -4,6 +4,12 @@ export declare class SystemAiError extends Error {
     constructor(message: string, code: string);
 }
 export declare function normalizeSystemAiConfig(value: unknown, fallback?: SystemAiConfig): SystemAiConfig;
-/** Copy the first usable direct-API profile from the user's configured CLIs. */
+/** Copy every usable direct-API profile from the user's configured CLIs. */
+export declare function discoverCliSystemAiConfigs(preferred?: SessionProvider, home?: string): SystemAiConfig[];
+/** Backward-compatible first-profile discovery. */
 export declare function discoverCliSystemAiConfig(preferred?: SessionProvider, home?: string): SystemAiConfig | null;
+/** Return the configured API chain in call order, excluding incomplete entries. */
+export declare function systemAiProfiles(config: SystemAiConfig | undefined, forceEnabled?: boolean): SystemAiConfig[];
 export declare function callSystemAiText(prompt: string, config: SystemAiConfig, timeoutMs?: number): Promise<string>;
+/** Try every configured API in order. Empty responses are treated as unavailable. */
+export declare function callSystemAiTextWithFallback(prompt: string, config: SystemAiConfig, timeoutMs?: number): Promise<string>;

package/dist/system-ai.js

@@ -28,7 +28,7 @@ export function normalizeSystemAiConfig(value, fallback) {
         if (parsed.protocol !== "http:" && parsed.protocol !== "https:")
             throw new Error("系统 AI API 地址必须使用 http 或 https。");
     }
-    return {
+    const normalized = {
         enabled: raw.enabled === true,
         protocol,
         baseUrl,
@@ -37,6 +37,25 @@ export function normalizeSystemAiConfig(value, fallback) {
         authHeader: raw.authHeader === "x-api-key" ? "x-api-key" : "bearer",
         source: raw.source === "claude" || raw.source === "codex" || raw.source === "opencode" ? raw.source : "custom",
     };
+    if (Array.isArray(raw.fallbacks)) {
+        normalized.fallbacks = raw.fallbacks
+            .map((item, index) => {
+            try {
+                const itemFallback = fallback?.fallbacks?.[index];
+                const profile = normalizeSystemAiConfig(item, itemFallback);
+                delete profile.fallbacks;
+                return profile;
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((item) => item !== null);
+    }
+    else if (fallback?.fallbacks?.length) {
+        normalized.fallbacks = fallback.fallbacks.map((item) => ({ ...item, fallbacks: undefined }));
+    }
+    return normalized;
 }
 function readJson(filePath) {
     if (!existsSync(filePath))
@@ -68,14 +87,30 @@ function discoverOpenCode(home) {
     const selectedModel = typeof config?.model === "string" ? config.model : "";
     const providerId = selectedModel.split("/", 1)[0] ?? "";
     const providers = config?.provider && typeof config.provider === "object" ? config.provider : {};
-    const provider = providers[providerId] && typeof providers[providerId] === "object" ? providers[providerId] : null;
-    const options = provider?.options && typeof provider.options === "object" ? provider.options : {};
-    const apiKey = typeof options.apiKey === "string" ? options.apiKey : "";
-    const baseUrl = typeof options.baseURL === "string" ? options.baseURL : typeof options.baseUrl === "string" ? options.baseUrl : "";
-    if (!apiKey || !baseUrl || !selectedModel)
-        return null;
-    const model = selectedModel.includes("/") ? selectedModel.slice(selectedModel.indexOf("/") + 1) : selectedModel;
-    return normalizeSystemAiConfig({ enabled: true, protocol: "openai", baseUrl, apiKey, model, authHeader: "bearer", source: "opencode" });
+    const orderedProviders = [providerId, ...Object.keys(providers).filter((id) => id !== providerId)];
+    const found = [];
+    for (const id of orderedProviders) {
+        const provider = providers[id] && typeof providers[id] === "object" ? providers[id] : null;
+        const options = provider?.options && typeof provider.options === "object" ? provider.options : {};
+        const apiKey = typeof options.apiKey === "string" ? options.apiKey : "";
+        const baseUrl = typeof options.baseURL === "string" ? options.baseURL : typeof options.baseUrl === "string" ? options.baseUrl : "";
+        const models = provider?.models && typeof provider.models === "object" ? provider.models : {};
+        const configuredModel = id === providerId && selectedModel
+            ? (selectedModel.includes("/") ? selectedModel.slice(selectedModel.indexOf("/") + 1) : selectedModel)
+            : typeof provider?.model === "string" ? provider.model : Object.keys(models)[0] ?? "";
+        if (!apiKey || !baseUrl || !configuredModel)
+            continue;
+        found.push(normalizeSystemAiConfig({
+            enabled: true,
+            protocol: "openai",
+            baseUrl,
+            apiKey,
+            model: configuredModel,
+            authHeader: "bearer",
+            source: "opencode",
+        }));
+    }
+    return found;
 }
 function discoverCodex(home) {
     const auth = readJson(path.join(home, ".codex", "auth.json"));
@@ -94,18 +129,49 @@ function discoverCodex(home) {
         return null;
     return normalizeSystemAiConfig({ enabled: true, protocol: "openai", baseUrl, apiKey, model, authHeader: "bearer", source: "codex" });
 }
-/** Copy the first usable direct-API profile from the user's configured CLIs. */
-export function discoverCliSystemAiConfig(preferred, home = os.homedir()) {
-    const discoverers = { claude: discoverClaude, codex: discoverCodex, opencode: discoverOpenCode };
+/** Copy every usable direct-API profile from the user's configured CLIs. */
+export function discoverCliSystemAiConfigs(preferred, home = os.homedir()) {
+    const discoverers = {
+        claude: (dir) => [discoverClaude(dir)].filter((item) => item !== null),
+        codex: (dir) => [discoverCodex(dir)].filter((item) => item !== null),
+        opencode: discoverOpenCode,
+    };
     const order = [preferred ?? "claude", "claude", "opencode", "codex"];
+    const found = [];
+    const seen = new Set();
     for (const provider of [...new Set(order)]) {
         if (provider === "grok" || provider === "qoder")
             continue;
-        const found = discoverers[provider](home);
-        if (found)
-            return found;
+        for (const profile of discoverers[provider](home)) {
+            const key = [profile.protocol, profile.baseUrl, profile.apiKey, profile.model].join("\0");
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            found.push(profile);
+        }
     }
-    return null;
+    return found;
+}
+/** Backward-compatible first-profile discovery. */
+export function discoverCliSystemAiConfig(preferred, home = os.homedir()) {
+    return discoverCliSystemAiConfigs(preferred, home)[0] ?? null;
+}
+/** Return the configured API chain in call order, excluding incomplete entries. */
+export function systemAiProfiles(config, forceEnabled = false) {
+    if (!config || (!forceEnabled && !config.enabled))
+        return [];
+    const candidates = [config, ...(config.fallbacks ?? [])];
+    const seen = new Set();
+    return candidates.flatMap((candidate) => {
+        const normalized = normalizeSystemAiConfig({ ...candidate, enabled: true, fallbacks: undefined });
+        if (!normalized.baseUrl || !normalized.apiKey || !normalized.model)
+            return [];
+        const key = [normalized.protocol, normalized.baseUrl, normalized.apiKey, normalized.model].join("\0");
+        if (seen.has(key))
+            return [];
+        seen.add(key);
+        return [normalized];
+    });
 }
 function endpoint(baseUrl, protocol) {
     const url = new URL(baseUrl);
@@ -166,3 +232,23 @@ export async function callSystemAiText(prompt, config, timeoutMs = SYSTEM_AI_TIM
         throw new SystemAiError("系统 AI API 返回了无法解析的响应。", "SYSTEM_AI_INVALID_RESPONSE");
     }
 }
+/** Try every configured API in order. Empty responses are treated as unavailable. */
+export async function callSystemAiTextWithFallback(prompt, config, timeoutMs = SYSTEM_AI_TIMEOUT_MS) {
+    const profiles = systemAiProfiles(config, true);
+    if (!profiles.length) {
+        throw new SystemAiError("系统 AI API 配置不完整。", "SYSTEM_AI_CONFIG_INVALID");
+    }
+    const errors = [];
+    for (const profile of profiles) {
+        try {
+            const text = await callSystemAiText(prompt, profile, timeoutMs);
+            if (text.trim())
+                return text;
+            errors.push(`${profile.source ?? "custom"}: 返回空结果`);
+        }
+        catch (error) {
+            errors.push(`${profile.source ?? "custom"}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    throw new SystemAiError(`所有系统 AI API 均不可用：${errors.join("；")}`, "SYSTEM_AI_ALL_FAILED");
+}

package/dist/types.d.ts

@@ -146,6 +146,11 @@ export interface SystemAiConfig {
     authHeader?: SystemAiAuthHeader;
     /** 自动导入时记录来源，仅用于设置页说明。 */
     source?: "claude" | "codex" | "opencode" | "custom";
+    /**
+     * 其余可直连 API，按数组顺序依次尝试。保留顶层字段作为首选项，
+     * 以兼容已有配置与手工编辑入口。
+     */
+    fallbacks?: SystemAiConfig[];
 }
 export type ClaudeModelSource = "builtin" | "configured" | "verified-cache" | "models-api";
 export type ClaudeModelAvailability = "default" | "candidate" | "verified" | "stale";