@co0ontty/wand 4.79.0 → 4.80.0

package/README.md

@@ -11,7 +11,7 @@
 
 ### Overview
 
-Wand is a web console for remotely accessing and managing local CLI tools from a browser. It supports [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [OpenCode](https://opencode.ai/), [Grok Build](https://grok.com/), [Qoder CLI](https://docs.qoder.com/en/cli/quick-start), and [Pi](https://pi.dev/), with terminal and structured conversation views, persistent resumable sessions, permission controls, file browsing, and native clients for multiple platforms.
+Wand is a web console for remotely accessing and managing local CLI tools from a browser. It supports [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [OpenCode](https://opencode.ai/), [Grok Build](https://grok.com/), [Qoder CLI](https://docs.qoder.com/en/cli/quick-start), and [Pi](https://pi.dev/), as well as [Gemini CLI](https://github.com/google-gemini/gemini-cli), with terminal and structured conversation views, persistent resumable sessions, permission controls, file browsing, and native clients for multiple platforms.
 
 The browser password manager extension source lives in `browser-extension/`.
 
@@ -48,7 +48,7 @@ wand config:password
 #### Core
 
 - **Dual view modes** — switch between raw terminal output and a structured conversation view for the same session
-- **Multiple providers** — create PTY or structured sessions for Claude Code, Codex, OpenCode, Grok, Qoder CLI, and Pi
+- **Multiple providers** — create PTY or structured sessions for Claude Code, Codex, OpenCode, Grok, Qoder CLI, Pi, and Gemini CLI
 - **Session management** — create, archive, and resume Claude, Codex, OpenCode, Grok, and Qoder sessions with their provider-native context; restore Claude/Codex native history; show summaries in the session list
 - **Permission control** — visual permission prompts with one-time approval, per-turn memory, and related policies
 
@@ -65,7 +65,7 @@ wand config:password
 - **Native clients** — Android, iOS, and macOS clients with encrypted connection codes and update checks
 - **HTTPS** — optional self-signed certificates for remote or mobile access
 - **Update channels** — built-in stable/beta update checks and upgrade prompts
-- **CLI updates** — check and quickly update Claude Code, Codex, OpenCode, Qoder CLI, and Pi from server settings, with optional automatic updates
+- **CLI updates** — check and quickly update Claude Code, Codex, OpenCode, Qoder CLI, Pi, and Gemini CLI from server settings, with optional automatic updates
 
 ### Configuration
 
@@ -150,11 +150,17 @@ npm uninstall -g opencode
 npm install -g opencode-ai@latest
 ```
 
+Gemini structured sessions require `@google/gemini-cli` 0.11 or newer (the release that added headless `--output-format stream-json`):
+
+```bash
+npm install -g @google/gemini-cli@latest
+```
+
 ## 中文
 
 ### 概览
 
-通过浏览器远程访问和管理本地 CLI 工具的 Web 控制台。支持 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[Codex](https://github.com/openai/codex)、[OpenCode](https://opencode.ai/)、[Grok Build](https://grok.com/)、[Qoder CLI](https://docs.qoder.com/zh/cli/quick-start) 和 [Pi](https://pi.dev/)，提供终端和结构化对话双视图、会话持久化与恢复、权限管控、文件浏览和多平台客户端。
+通过浏览器远程访问和管理本地 CLI 工具的 Web 控制台。支持 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[Codex](https://github.com/openai/codex)、[OpenCode](https://opencode.ai/)、[Grok Build](https://grok.com/)、[Qoder CLI](https://docs.qoder.com/zh/cli/quick-start)、[Pi](https://pi.dev/) 和 [Gemini CLI](https://github.com/google-gemini/gemini-cli)，提供终端和结构化对话双视图、会话持久化与恢复、权限管控、文件浏览和多平台客户端。
 
 ### 安装
 
@@ -191,12 +197,18 @@ npm uninstall -g opencode
 npm install -g opencode-ai@latest
 ```
 
+Gemini 结构化会话需要 `@google/gemini-cli` 0.11 或更高版本（该版本才加入 headless 的 `--output-format stream-json`）：
+
+```bash
+npm install -g @google/gemini-cli@latest
+```
+
 ### 功能
 
 #### 核心
 
 - **双视图模式** — 终端原始输出和结构化对话视图可随时切换，同一会话两种呈现
-- **多 Provider 支持** — Claude Code、Codex、OpenCode、Grok、Qoder CLI 和 Pi 均可创建 PTY 或结构化会话
+- **多 Provider 支持** — Claude Code、Codex、OpenCode、Grok、Qoder CLI、Pi 和 Gemini CLI 均可创建 PTY 或结构化会话
 - **会话管理** — 创建、归档并携带原生上下文恢复 Claude、Codex、OpenCode、Grok、Qoder 会话；支持恢复 Claude/Codex 原生历史记录；会话列表显示摘要
 - **权限控制** — 可视化权限提示，支持逐次确认、单次批准、本轮记忆等策略
 
@@ -214,7 +226,7 @@ npm install -g opencode-ai@latest
 - **多平台客户端** — Android / iOS / macOS 原生客户端，支持加密连接码分发、自动更新检查
 - **HTTPS** — 可选自签证书，适合远程或移动端访问
 - **版本管理** — 内置更新检查与升级提示，支持 stable/beta 双通道
-- **CLI 更新** — 在服务端设置中检查并快速更新 Claude Code、Codex、OpenCode、Qoder CLI 和 Pi，也可开启自动更新
+- **CLI 更新** — 在服务端设置中检查并快速更新 Claude Code、Codex、OpenCode、Qoder CLI、Pi 和 Gemini CLI，也可开启自动更新
 
 ### 配置
 

package/dist/agent-dispatch.d.ts

@@ -3,6 +3,7 @@ import type { SessionRegistry } from "./session-registry.js";
 import type { WandStorage } from "./storage.js";
 import type { StructuredSessionManager } from "./structured-session-manager.js";
 import type { WandTask, WandTaskAgent } from "./task-types.js";
+import type { SiliconEmployee } from "./ai-team-types.js";
 import type { SessionSnapshot, WandConfig } from "./types.js";
 export interface AgentDispatchDeps {
     storage: WandStorage;
@@ -32,6 +33,8 @@ export declare function dispatchAgentForTask(deps: AgentDispatchDeps, input: {
     prompt: string;
     automationId: string;
     systemPrompt?: string;
+    employee?: SiliconEmployee;
+    employeeCandidateIndex?: number;
 }): Promise<AgentDispatchResult>;
 /**
  * 给已有会话追加一条消息。结构化会话走 sendMessage（不等整轮结束）；

package/dist/agent-dispatch.js

@@ -50,6 +50,11 @@ export async function dispatchAgentForTask(deps, input) {
             sessionSource: "automation",
             automationId: input.automationId,
             systemPrompt,
+            employeeId: input.employee?.id,
+            employeeName: input.employee?.name,
+            employeeAvatar: input.employee?.avatar,
+            employeeCandidates: input.employee?.agents,
+            employeeCandidateIndex: input.employeeCandidateIndex,
             workspaceId: group.workspaceId,
             workspaceTaskId: group.workspaceTaskId,
         });

package/dist/ai-team-runner.js

@@ -913,12 +913,14 @@ export class AiTeamRunner {
             return;
         }
         // 负责人的模型报错时停下来等用户（换模型或稍后回复即可接着来），不当成格式错误空转重试。
+        // 按真实角色身份发出正常对话气泡并展示完整报错，而不是次级 notice 小字。
         const leader = leaderOf(run.team);
         if (outcome.kind === "failed" && outcome.sessionError) {
             this.saveStep({ ...step, status: "failed", report: outcome.text, endedAt });
             this.postTurn(run, {
-                role: "assistant", notice: true, author: chatAuthor(leader, step.sessionId, this.actualAgent(leader, step)),
-                content: chatText(`负责人的模型出错：${outcome.text}\n可以去团队页换个模型，然后在群里回复一句让团队继续。`),
+                role: "assistant",
+                author: chatAuthor(leader, step.sessionId, this.actualAgent(leader, step)),
+                content: chatText(`我的模型调用失败，无法继续处理任务：\n\n\`\`\`\n${outcome.text}\n\`\`\`\n\n可以去团队设置页面为我更换可用模型，或者在群里回复我继续重试。`),
             });
             this.setStatus(run, "waiting_user", `负责人出错：${outcome.text}`);
             return;

package/dist/ai-team-types.d.ts

@@ -55,7 +55,40 @@ export interface StepDispatchInfo {
     }>;
 }
 /** 上传头像在前端缩成小图后的上限（data URL 字符数）。 */
+export interface SiliconEmployee {
+    id: string;
+    name: string;
+    duty: string;
+    prompt: string;
+    avatar: string;
+    agents: WandTaskAgent[];
+    /**
+     * 非空 = Wand 内置员工（如 "wand-ops" 系统运维）：名字/职责/人设/头像锁定，
+     * 不可归档、不可删除，只有执行候选由用户维护。
+     */
+    systemKey?: string;
+    archivedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * AI 按自然语言期望起草的员工配置：只带一个首选执行候选，
+ * 其余手动字段（头像、备用候选）仍由表单和「高级配置」负责。
+ */
+export interface SiliconEmployeeDraft {
+    name: string;
+    duty: string;
+    prompt: string;
+    agent: WandTaskAgent;
+}
 export declare const AI_TEAM_AVATAR_MAX_CHARS = 60000;
+export declare const SILICON_EMPLOYEE_AVATAR_MAX_CHARS = 60000;
+export declare const SYSTEM_EMPLOYEE_KEY = "wand-ops";
+export declare const SYSTEM_EMPLOYEE_ID = "e_wand_ops";
+export declare const SYSTEM_EMPLOYEE_NAME = "\u52E4\u52B3\u7684\u521D\u4E8C";
+/** 员工列表 / 设置页上的标识。 */
+export declare const SYSTEM_EMPLOYEE_TAG = "\u7CFB\u7EDF\u8FD0\u7EF4";
+export declare function isSystemSiliconEmployee(employee: Pick<SiliconEmployee, "systemKey"> | null | undefined): boolean;
 export interface AiTeam {
     id: string;
     name: string;
@@ -102,6 +135,7 @@ export interface AiTeamRun {
  */
 export interface AiTeamRunChatMarker {
     runId: string;
+    teamId: string;
     teamName: string;
     memberCount: number;
 }

package/dist/ai-team-types.js

@@ -25,8 +25,19 @@ export function memberAgents(member) {
 export function agentKey(agent) {
     return `${agent.provider}|${agent.model}|${agent.thinkingEffort}|${agent.mode}|${agent.kind}`;
 }
-/** 上传头像在前端缩成小图后的上限（data URL 字符数）。 */
 export const AI_TEAM_AVATAR_MAX_CHARS = 60_000;
+export const SILICON_EMPLOYEE_AVATAR_MAX_CHARS = 60_000;
+// ============ 内置「系统运维」员工 ============
+// 纯常量与判定放在这里：浏览器端要拿 Tag 和判定，不能把 server-only 的
+// system-employee.ts（依赖 node:fs）拉进前端 bundle。
+export const SYSTEM_EMPLOYEE_KEY = "wand-ops";
+export const SYSTEM_EMPLOYEE_ID = "e_wand_ops";
+export const SYSTEM_EMPLOYEE_NAME = "勤劳的初二";
+/** 员工列表 / 设置页上的标识。 */
+export const SYSTEM_EMPLOYEE_TAG = "系统运维";
+export function isSystemSiliconEmployee(employee) {
+    return employee?.systemKey === SYSTEM_EMPLOYEE_KEY;
+}
 export const AI_TEAM_ACTIVE_RUN_STATUSES = ["running", "awaiting_approval", "waiting_user"];
 /** 终态：不会再有 live 变化，runner 据此清掉该 run 的推送指纹，避免长跑服务按 run 数攒字符串。 */
 export const AI_TEAM_TERMINAL_RUN_STATUSES = ["done", "failed", "stopped"];

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "bf34f01cbac723af9bc4316787cba307ea9d083b",
-  "builtAt": "2026-09-29T12:40:12.739Z",
-  "version": "4.79.0",
+  "commit": "f8e0c448bbfdf5623cc9dc79e12b46984d1d21c6",
+  "builtAt": "2026-09-30T06:54:45.317Z",
+  "version": "4.80.0",
   "channel": "stable"
 }

package/dist/config.d.ts

@@ -7,7 +7,7 @@ import type { WandStorage } from "./storage.js";
  * 升级路径：老 JSON 里仍存有这些字段时，首次启动会被搬到 DB（见 migrateLegacyPreferencesToDb），
  * 然后下一次 saveConfig 写回 JSON 时它们会被剥离（见 stripPreferenceFields）。
  */
-export declare const PREFERENCE_KEYS: readonly ["defaultProvider", "defaultSessionKind", "defaultTaskWorktree", "defaultMode", "defaultCwd", "defaultModel", "defaultCodexModel", "defaultOpenCodeModel", "defaultGrokModel", "defaultQoderModel", "defaultPiModel", "commitCli", "commitModel", "commitAiSource", "systemAi", "systemAiCli", "systemAiModel", "defaultThinkingEffort", "structuredRunner", "language", "cardDefaults", "inheritEnv"];
+export declare const PREFERENCE_KEYS: readonly ["defaultProvider", "defaultSessionKind", "defaultTaskWorktree", "defaultMode", "defaultCwd", "defaultModel", "defaultCodexModel", "defaultOpenCodeModel", "defaultGrokModel", "defaultQoderModel", "defaultPiModel", "defaultGeminiModel", "commitCli", "commitModel", "commitAiSource", "systemAi", "systemAiCli", "systemAiModel", "defaultThinkingEffort", "structuredRunner", "language", "cardDefaults", "inheritEnv"];
 export type PreferenceKey = (typeof PREFERENCE_KEYS)[number];
 export declare function isPreferenceKey(key: string): key is PreferenceKey;
 /**
@@ -47,12 +47,13 @@ export declare function writePreferenceToStorage(config: WandConfig, storage: Wa
  */
 export declare function validateCommitAiConfig(_config: Pick<WandConfig, "commitAiSource" | "systemAi">): void;
 export declare function isExecutionMode(value: unknown): value is ExecutionMode;
-export declare function getProviderDefaultModels(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel" | "defaultPiModel">): {
+export declare function getProviderDefaultModels(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel" | "defaultPiModel" | "defaultGeminiModel">): {
     claude: string;
     codex: string;
     opencode: string;
     grok: string;
     qoder: string;
     pi: string;
+    gemini: string;
 };
-export declare function getDefaultModelForProvider(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel" | "defaultPiModel">, provider: SessionProvider | undefined): string;
+export declare function getDefaultModelForProvider(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel" | "defaultPiModel" | "defaultGeminiModel">, provider: SessionProvider | undefined): string;

package/dist/config.js

@@ -29,6 +29,7 @@ export const PREFERENCE_KEYS = [
     "defaultGrokModel",
     "defaultQoderModel",
     "defaultPiModel",
+    "defaultGeminiModel",
     "commitCli",
     "commitModel",
     "commitAiSource",
@@ -102,6 +103,7 @@ export const defaultConfig = () => ({
     defaultGrokModel: "",
     defaultQoderModel: "",
     defaultPiModel: "",
+    defaultGeminiModel: "",
     commitCli: "claude",
     commitModel: "",
     commitAiSource: "cli",
@@ -225,6 +227,14 @@ export async function loadConfigWithStorage(configPath, storage) {
     reconcileAppSecret(config, storage);
     // password: DB 优先映射到 runtime config，让 config:show 与 server.ts 都看到真值
     applyStoragePassword(config, storage);
+    // 内置「系统运维」员工：Wand 自有 AI 调用（commit message / 标题 / 提示词优化 /
+    // 员工起草）都由它执行。这里只做幂等补齐——首次按用户已有的系统 AI 工具与默认
+    // provider 建首条候选，之后候选由用户在员工设置里维护，不再回写 config。
+    storage.ensureSystemSiliconEmployee({
+        cli: config.systemAiCli,
+        model: config.systemAiModel,
+        provider: config.defaultProvider,
+    });
     // 如果 JSON 里有偏好字段（说明是老版本配置或刚迁移），重写一次干净版本
     const hasLegacyPrefs = PREFERENCE_KEYS.some((key) => key in rawInput);
     const hasLegacySecrets = "password" in rawInput || "appSecret" in rawInput;
@@ -366,6 +376,11 @@ export function applyStoragePreferences(config, storage) {
         if (typeof v === "string")
             config.defaultPiModel = v.trim();
     }
+    if (storage.hasPreference(preferenceStorageKey("defaultGeminiModel"))) {
+        const v = storage.getPreference(preferenceStorageKey("defaultGeminiModel"), defaults.defaultGeminiModel ?? "");
+        if (typeof v === "string")
+            config.defaultGeminiModel = v.trim();
+    }
     if (storage.hasPreference(preferenceStorageKey("commitCli"))) {
         const v = storage.getPreference(preferenceStorageKey("commitCli"), defaults.commitCli ?? "claude");
         if (v === "claude" || v === "codex" || v === "opencode")
@@ -495,6 +510,12 @@ export function writePreferenceToStorage(config, storage, key, value, options =
             config.defaultPiModel = v;
             break;
         }
+        case "defaultGeminiModel": {
+            const v = typeof value === "string" ? value.trim() : "";
+            storage.setPreference(dbKey, v);
+            config.defaultGeminiModel = v;
+            break;
+        }
         case "commitCli": {
             if (value !== "claude" && value !== "codex" && value !== "opencode")
                 throw new Error(`无效 commit CLI: ${value}`);
@@ -791,6 +812,7 @@ function mergeWithDefaults(input) {
         defaultGrokModel: typeof input.defaultGrokModel === "string" ? input.defaultGrokModel.trim() : defaults.defaultGrokModel,
         defaultQoderModel: typeof input.defaultQoderModel === "string" ? input.defaultQoderModel.trim() : defaults.defaultQoderModel,
         defaultPiModel: typeof input.defaultPiModel === "string" ? input.defaultPiModel.trim() : defaults.defaultPiModel,
+        defaultGeminiModel: typeof input.defaultGeminiModel === "string" ? input.defaultGeminiModel.trim() : defaults.defaultGeminiModel,
         commitCli: input.commitCli === "codex" || input.commitCli === "opencode" ? input.commitCli : "claude",
         commitModel: typeof input.commitModel === "string" ? input.commitModel.trim() : defaults.commitModel,
         commitAiSource: input.commitAiSource === "api" ? "api" : "cli",
@@ -820,6 +842,7 @@ export function getProviderDefaultModels(config) {
         grok: configuredModelId(config.defaultGrokModel),
         qoder: configuredModelId(config.defaultQoderModel),
         pi: configuredModelId(config.defaultPiModel),
+        gemini: configuredModelId(config.defaultGeminiModel),
     };
 }
 export function getDefaultModelForProvider(config, provider) {
@@ -834,6 +857,8 @@ export function getDefaultModelForProvider(config, provider) {
         return defaults.qoder;
     if (provider === "pi")
         return defaults.pi;
+    if (provider === "gemini")
+        return defaults.gemini;
     return defaults.claude;
 }
 function normalizePresetCommand(command) {

package/dist/git-quick-commit.d.ts

@@ -3,14 +3,9 @@ import { GitStatusResult, PushResult, QuickCommitResult, SessionProvider, Sessio
 export type QuickCommitErrorCode = "CWD_MISSING" | "NO_CWD" | "NOT_A_GIT_REPO" | "NO_COMMIT" | "NOTHING_TO_COMMIT" | "NOTHING_TO_PUSH" | "EMPTY_MESSAGE" | "EMPTY_TAG" | "EMPTY_AI_MESSAGE" | "AI_FALLBACK_FAILED" | "INVALID_AI_TAG" | "TAG_EXISTS" | "GIT_ADD_FAILED" | "GIT_DIFF_FAILED" | "GIT_COMMIT_FAILED" | "GIT_TAG_FAILED" | "CLAUDE_CLI_MISSING" | "CLAUDE_CLI_FAILED" | "CLAUDE_TIMEOUT";
 /** Non-blocking status implementation used by HTTP routes. */
 export declare function getGitStatusAsync(cwd: string): Promise<GitStatusResult>;
-interface QuickCommitOptions extends CommitInputOptions {
+interface QuickCommitOptions extends CommitInputOptions, QuickCommitAiOptions {
     cwd: string;
     language: string;
-    provider?: SessionProvider;
-    model?: string | null;
-    thinkingEffort?: SessionSnapshot["thinkingEffort"];
-    inheritEnv?: boolean;
-    systemAi?: import("./types.js").SystemAiConfig;
     autoMessage: boolean;
     customMessage?: string;
     tag?: string;
@@ -29,6 +24,10 @@ export interface QuickCommitAiOptions {
     thinkingEffort?: SessionSnapshot["thinkingEffort"];
     inheritEnv?: boolean;
     systemAi?: import("./types.js").SystemAiConfig;
+    /** 内置「系统运维」员工的角色设定：作为系统提示前缀注入。 */
+    opsPersona?: string;
+    /** CLI 降级链（按顺序）；未设置时只用 provider/model 这一次调用。 */
+    cliCandidates?: import("./types.js").AiCliCandidate[];
 }
 export declare class QuickCommitError extends Error {
     readonly code: QuickCommitErrorCode;
@@ -44,10 +43,12 @@ export interface CommitInputOptions {
     iterationDigest?: string;
     includeDiff?: boolean;
 }
+/** 角色设定走系统提示前缀；任务自己的输出格式与约束必须排在后面。 */
+export declare function withOpsPersona(request: AiTextRequest, persona?: string): AiTextRequest;
 /**
  * Run a lightweight AI request through the selected Commit source. API mode
- * exhausts its profile chain and then falls back once to the current-session
- * CLI. CLI mode uses only that CLI.
+ * exhausts its profile chain and then falls back once to the system employee's
+ * CLI chain. CLI mode walks that chain in order.
  */
 export declare function callConfiguredAiText(request: AiTextRequest, cwd: string, language: string, opts: QuickCommitAiOptions): Promise<string>;
 export interface GenerateCommitMessageResult {

package/dist/git-quick-commit.js

@@ -3,7 +3,7 @@ import { spawn } from "node:child_process";
 import { ClaudeRunError, runClaudePrint } from "./claude-sdk-runner.js";
 import { callSystemAiTextWithFallback } from "./system-ai.js";
 import { buildChildEnv } from "./env-utils.js";
-import { isSessionProvider } from "./session-provider.js";
+import { isSessionProvider, providerCliInstalled } from "./session-provider.js";
 import { runGitAsync as runGitAsyncBase, runGitRawAsync as runGitRawAsyncBase, getGitErrorMessage, } from "./git-utils.js";
 import { composeSystemFallback, systemPromptFlag, thinkingEffortToClaudeCliEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToGrokEffort, thinkingEffortToOpenCodeVariant, thinkingEffortToQoderEffort, thinkingEffortToPiLevel, } from "./structured-provider-common.js";
 /** provider 缺省值：无法识别时回落到 Claude。 */
@@ -422,6 +422,23 @@ function extractPiText(stdout) {
     }
     return text.trim();
 }
+/** Gemini `--output-format stream-json`：assistant message 是增量 chunk，拼接即可。 */
+function extractGeminiText(stdout) {
+    let text = "";
+    for (const line of stdout.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("{"))
+            continue;
+        try {
+            const event = JSON.parse(trimmed);
+            if (event.type === "message" && event.role === "assistant" && typeof event.content === "string") {
+                text += event.content;
+            }
+        }
+        catch { /* ignore non-protocol stdout */ }
+    }
+    return text.trim();
+}
 function buildPiTextArgs(request, opts, allowTools = false) {
     const args = ["--mode", "json", "--print", "--no-session"];
     if (!allowTools)
@@ -449,6 +466,23 @@ function buildGrokTextArgs(request, opts, allowTools = false) {
         args.push("--always-approve");
     return args;
 }
+/**
+ * Gemini CLI 没有 `--append-system-prompt`，规则走 `contentWithSystemPrompt` 并进内容；
+ * headless 下必须带 `--skip-trust`，否则未信任的工作目录会直接以 55 退出。
+ *
+ * `-p ""` 只把 CLI 钉在 headless 模式，真正的 prompt 走 stdin：commit diff 可能很大，
+ * 塞进 argv 会撞 ARG_MAX。Gemini 没有 Codex `--ephemeral` 那样的临时会话开关，
+ * 一次性调用会留在它自己的聊天记录里（Wand 不扫描 Gemini 历史，不会误当可恢复会话）。
+ */
+function buildGeminiTextArgs(opts, allowTools = false) {
+    const args = ["-p", "", "--output-format", "stream-json", "--skip-trust"];
+    const model = opts.model?.trim();
+    if (model && model !== "default")
+        args.push("--model", model);
+    if (allowTools)
+        args.push("--approval-mode", "yolo");
+    return args;
+}
 function buildQoderTextArgs(request, opts, allowTools = false) {
     const args = ["-p", request.prompt, "--output-format", "stream-json", "--no-session-persistence"];
     const model = opts.model?.trim();
@@ -595,6 +629,17 @@ async function callPiText(request, cwd, opts) {
         throw new QuickCommitError("Pi 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
     return text;
 }
+async function callGeminiText(request, cwd, opts) {
+    const stdout = await runCliText("gemini", buildGeminiTextArgs(opts), contentWithSystemPrompt("gemini", request), {
+        cwd,
+        timeoutMs: CODEX_MESSAGE_TIMEOUT_MS,
+        inheritEnv: opts.inheritEnv,
+    });
+    const text = extractGeminiText(stdout);
+    if (!text)
+        throw new QuickCommitError("Gemini 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
+    return text;
+}
 async function callCliAiText(request, cwd, language, opts) {
     const provider = defaultProvider(opts.provider);
     if (provider === "codex") {
@@ -608,6 +653,8 @@ async function callCliAiText(request, cwd, language, opts) {
         return callQoderText(request, cwd, opts);
     if (provider === "pi")
         return callPiText(request, cwd, opts);
+    if (provider === "gemini")
+        return callGeminiText(request, cwd, opts);
     return callClaudeText(request, cwd, language, opts);
 }
 async function callDirectApiText(request, systemAi) {
@@ -621,28 +668,89 @@ function aiFallbackFailed(primary, primaryError, fallbackError) {
     const fallback = primary === "直连 API" ? "CLI" : "直连 API";
     return new QuickCommitError(`${primary} 与 ${fallback} 均失败：${getGitErrorMessage(primaryError)}；${getGitErrorMessage(fallbackError)}`, "AI_FALLBACK_FAILED");
 }
+/**
+ * 多候选降级时给整条链的时间上限。原生客户端的请求宽限约 180s，
+ * 候选再多也不能把整个请求拖死；单次仍受各自 CLI 超时保护。
+ */
+const CLI_CHAIN_BUDGET_MS = 150_000;
+/** 角色设定走系统提示前缀；任务自己的输出格式与约束必须排在后面。 */
+export function withOpsPersona(request, persona) {
+    const trimmed = (persona ?? "").trim();
+    if (!trimmed)
+        return request;
+    const task = (request.system ?? "").trim();
+    return { ...request, system: task ? `${trimmed}\n\n${task}` : trimmed };
+}
+/** 链上的每条候选变成一次普通的 CLI 文本调用参数。 */
+function candidateOptions(base, candidate) {
+    return {
+        ...base,
+        provider: candidate.provider,
+        model: candidate.model ?? null,
+        thinkingEffort: candidate.thinkingEffort ?? base.thinkingEffort ?? undefined,
+    };
+}
+/** 没有候选链时，把当前 provider/model 当作唯一的候选。 */
+function singleCandidate(opts) {
+    return {
+        provider: defaultProvider(opts.provider),
+        model: opts.model ?? undefined,
+        thinkingEffort: opts.thinkingEffort ?? undefined,
+    };
+}
+/**
+ * 按顺序尝试候选：跳过没安装的 CLI，逐条收集错误，成功即返回。
+ * 只有一条候选时保持原行为（错误原样抛出，不摘要）。
+ */
+async function callCliCandidates(request, cwd, language, opts) {
+    const chain = opts.cliCandidates?.length ? opts.cliCandidates : [singleCandidate(opts)];
+    if (chain.length === 1) {
+        return callCliAiText(request, cwd, language, candidateOptions(opts, chain[0]));
+    }
+    const installed = chain.filter((candidate) => providerCliInstalled(candidate.provider));
+    const attempts = installed.length ? installed : chain;
+    const deadline = Date.now() + CLI_CHAIN_BUDGET_MS;
+    const errors = [];
+    for (const candidate of attempts) {
+        if (Date.now() > deadline) {
+            errors.push("已超过等待上限");
+            break;
+        }
+        try {
+            const text = await callCliAiText(request, cwd, language, candidateOptions(opts, candidate));
+            if (text.trim())
+                return text;
+            errors.push(`${candidate.provider}: 返回空结果`);
+        }
+        catch (error) {
+            errors.push(`${candidate.provider}: ${getGitErrorMessage(error)}`);
+        }
+    }
+    throw new QuickCommitError(`所有 CLI 候选均失败：${errors.join("；")}`, "AI_FALLBACK_FAILED");
+}
 /**
  * Run a lightweight AI request through the selected Commit source. API mode
- * exhausts its profile chain and then falls back once to the current-session
- * CLI. CLI mode uses only that CLI.
+ * exhausts its profile chain and then falls back once to the system employee's
+ * CLI chain. CLI mode walks that chain in order.
  */
 export async function callConfiguredAiText(request, cwd, language, opts) {
+    const effective = withOpsPersona(request, opts.opsPersona);
     if (opts.systemAi?.enabled) {
         try {
-            return await callDirectApiText(request, opts.systemAi);
+            return await callDirectApiText(effective, opts.systemAi);
         }
         catch (apiError) {
             try {
                 // The user selected the direct API first. If it is unavailable or
-                // empty, retry this exact request through their selected CLI.
-                return await callCliAiText(request, cwd, language, opts);
+                // empty, retry this exact request through their selected CLI chain.
+                return await callCliCandidates(effective, cwd, language, opts);
             }
             catch (cliError) {
                 throw aiFallbackFailed("直连 API", apiError, cliError);
             }
         }
     }
-    return callCliAiText(request, cwd, language, opts);
+    return callCliCandidates(effective, cwd, language, opts);
 }
 /** Read the unstaged + staged tree without touching the index. */
 async function collectWorkingTreeDiff(cwd) {
@@ -1276,7 +1384,7 @@ async function getLatestTagAtHead(cwd) {
 async function runQuickCommitFallbackCli(opts, priorError) {
     await assertGitWorkTreeAsync(opts.cwd);
     const beforeHead = await getHead(opts.cwd);
-    const request = buildFallbackPrompt(opts, priorError);
+    const request = withOpsPersona(buildFallbackPrompt(opts, priorError), opts.opsPersona);
     const provider = defaultProvider(opts.provider);
     if (provider === "codex") {
         const args = ["exec", "--ephemeral", "--json", "--color", "never", "--skip-git-repo-check", "--dangerously-bypass-approvals-and-sandbox"];
@@ -1328,6 +1436,13 @@ async function runQuickCommitFallbackCli(opts, priorError) {
             inheritEnv: opts.inheritEnv,
         });
     }
+    else if (provider === "gemini") {
+        await runCliText("gemini", buildGeminiTextArgs(opts, true), contentWithSystemPrompt("gemini", request), {
+            cwd: opts.cwd,
+            timeoutMs: QUICK_COMMIT_CLI_TIMEOUT_MS,
+            inheritEnv: opts.inheritEnv,
+        });
+    }
     else {
         const args = [
             "-p",

package/dist/models.d.ts

@@ -49,6 +49,8 @@ export interface ProviderThinkingEfforts {
     grok: ThinkingEffortLevel[];
     qoder: ThinkingEffortLevel[];
     pi: ThinkingEffortLevel[];
+    /** Gemini CLI 没有思考档位开关，只保留「不覆盖」一项，不假装能调。 */
+    gemini: ThinkingEffortLevel[];
 }
 export interface ModelCache {
     models: ClaudeModelInfo[];
@@ -57,6 +59,7 @@ export interface ModelCache {
     grokModels: ClaudeModelInfo[];
     qoderModels: ClaudeModelInfo[];
     piModels: ClaudeModelInfo[];
+    geminiModels: ClaudeModelInfo[];
     thinkingEfforts: ProviderThinkingEfforts;
     claudeVersion: string | null;
     opencodeVersion: string | null;