@co0ontty/wand 4.82.0 → 4.83.1-beta.g97d7ae9

package/dist/ai-team-runner.js

@@ -3,6 +3,8 @@ import { randomUUID } from "node:crypto";
 import { appendFileSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, readSync, statSync, writeFileSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import { freezeTeamEmployees, projectTeamEmployees, teamMemberEmployee } from "./ai-team-employee-binding.js";
+import { buildAiTeamDeliverySummary } from "./ai-team-delivery.js";
 import { dispatchAgentForTask, resolveTaskDispatchTarget, sendToAgentSession, stopAgentSession, } from "./agent-dispatch.js";
 import { AI_TEAM_REPORT_DIR, aiTeamChatHistoryPath, aiTeamHandoffPath, aiTeamReportPath, buildLeaderFollowupPrompt, buildLeaderFormatRetryPrompt, buildAiTeamObjective, buildLeaderKickoffPrompt, buildMemberPrompt, leaderOf, parseLeaderDecision, renderChatHistoryFile, renderHandoffFile, } from "./ai-team-prompts.js";
 import { AI_TEAM_STARTUP_WINDOW_MS, classifyCandidateFailure, classifyStartupFailure, isDegradableWorkFailure, isModelUnknownBeforeDispatch, } from "./ai-team-availability.js";
@@ -39,10 +41,11 @@ export function createAiTeamSessionOps(deps) {
             const { session } = await dispatchAgentForTask(deps, input);
             return session.id;
         },
-        send: (sessionId, text) => sendToAgentSession(deps, sessionId, text),
+        send: (sessionId, text, teamRequestStarted) => sendToAgentSession(deps, sessionId, text, teamRequestStarted),
         stop: (sessionId) => stopAgentSession(deps, sessionId),
         snapshot: (sessionId) => deps.sessions.getLatest(sessionId),
         ownerOf: (sessionId) => deps.sessions.ownerOf(sessionId),
+        consumeUnacceptedStartup: (sessionId, requestId) => deps.structured?.consumeUnacceptedTeamStartup(sessionId, requestId) ?? false,
     };
 }
 export function createAiTeamChatOps(deps) {
@@ -101,7 +104,8 @@ export function displayAiTeam(snapshot, current) {
         updatedAt: current.updatedAt,
         members: snapshot.members.map((member) => {
             const live = byId.get(member.id);
-            return live ? { ...member, name: live.name, avatar: live.avatar } : member;
+            return live && !member.employeeId && !live.employeeId
+                ? { ...member, name: live.name, avatar: live.avatar } : member;
         }),
     };
 }
@@ -346,6 +350,7 @@ export class AiTeamRunner {
     recheckTimers = new Map();
     /** 已经确定「不降级、按既有路径记 failed」的步骤，防止 finishStep 再判一次形成回环。 */
     noDegrade = new Set();
+    teamRequestIds = new Map();
     sweepTimer = null;
     /** 脱敏参照目录只算一次：os.homedir() 读 env，configDir 随 storage 定，运行期不变。 */
     redactionDirsValue = null;
@@ -386,9 +391,10 @@ export class AiTeamRunner {
     }
     // ── 公开操作 ──
     async start(input) {
-        const team = this.storage.getAiTeam(input.teamId);
-        if (!team)
+        const definition = this.storage.getAiTeam(input.teamId);
+        if (!definition)
             throw new Error("团队不存在。");
+        const team = freezeTeamEmployees(definition, this.storage);
         const task = this.storage.getWandTask(input.taskId);
         if (!task)
             throw new Error("任务不存在。");
@@ -594,14 +600,16 @@ export class AiTeamRunner {
         const task = (binding?.workspaceTaskId
             ? this.storage.getWandTaskByWorkspaceTaskId(binding.workspaceTaskId) : null)
             ?? this.storage.getWandTask(run.taskId);
+        const displayTeam = projectTeamEmployees(displayAiTeam(run.team, currentTeam), this.storage);
         return {
             run,
+            delivery: buildAiTeamDeliverySummary({ run, steps, displayTeam, relayTurns: messages, memberStates }),
             chatTitle: aiTeamChatTitle(task?.title),
             chatTitleUpdatedAt: task?.updatedAt ?? "",
             steps,
             memberStates,
             // 别把展示字段写回 run.team：运行快照里的执行候选/职责由 runner 独立管理。
-            displayTeam: displayAiTeam(run.team, currentTeam),
+            displayTeam,
             chatTurns: messages.slice(-AI_TEAM_DETAIL_CHAT_TURNS),
         };
     }
@@ -788,6 +796,7 @@ export class AiTeamRunner {
         this.liveTimers.clear();
         this.lastLiveKey.clear();
         this.noDegrade.clear();
+        this.teamRequestIds.clear();
     }
     /** 等当前排队的所有操作跑完（测试用）。 */
     async idle() {
@@ -952,6 +961,10 @@ export class AiTeamRunner {
         // 按真实角色身份发出正常对话气泡并展示完整报错，而不是次级 notice 小字。
         const leader = leaderOf(run.team);
         if (outcome.kind === "failed" && outcome.sessionError) {
+            // Leaders keep their existing wait-for-user rule, not worker candidate fallback.
+            const requestId = this.teamRequestIds.get(step.id);
+            if (step.sessionId && requestId)
+                this.ops.consumeUnacceptedStartup?.(step.sessionId, requestId);
             this.saveStep({ ...step, status: "failed", report: outcome.text, endedAt });
             this.postTurn(run, {
                 role: "assistant",
@@ -1288,8 +1301,12 @@ export class AiTeamRunner {
                 throw new Error("成员不存在");
             if (!agent)
                 throw new Error("成员没有配置可用的 CLI 候选");
+            if (member.employeeId && !teamMemberEmployee(member))
+                throw new Error("员工执行快照缺失，不能重绑定旧运行。");
             if (reusable) {
-                await this.ops.send(reusable, prompt.message);
+                await this.ops.send(reusable, prompt.message, (_sessionId, requestId) => {
+                    this.teamRequestIds.set(step.id, requestId);
+                });
             }
             else {
                 const task = this.storage.getWandTask(run.taskId);
@@ -1301,9 +1318,15 @@ export class AiTeamRunner {
                     prompt: prompt.message,
                     automationId: `ai-team:${run.id}`,
                     systemPrompt: prompt.system,
+                    employee: teamMemberEmployee(member),
+                    employeeCandidateIndex: member.employeeId ? info.usedCandidate : undefined,
+                    teamRequestStarted: (_sessionId, requestId) => { this.teamRequestIds.set(step.id, requestId); },
                 });
                 running = { ...running, sessionId };
                 this.saveStep(running);
+                // Immediate async spawn failure can precede open() returning and the session→step link.
+                if (this.ops.snapshot(sessionId)?.status === "failed")
+                    this.ingest({ type: "status", sessionId });
             }
         }
         catch (error) {
@@ -1315,6 +1338,7 @@ export class AiTeamRunner {
                 this.disableHostKind(run.id, agent.kind);
             }
             else if (agent && step.kind === "work" && kind === "spawn-missing"
+                && (!member?.employeeId || reusable === null)
                 && !existsSync(path.join(run.cwd, step.reportPath)) && !this.noDegrade.has(step.id)) {
                 // §3.4 触发点 1：会话根本没起来，ENOENT 对 structured / pty 同样可靠（修正 B4 排除的是
                 // PTY 的异步分类）。传 `running` 而不是入参 `step`：复用会话时 sessionId 只在 running 上。
@@ -1432,6 +1456,15 @@ export class AiTeamRunner {
         const member = this.member(run.team, step.memberId);
         if (!member)
             return null;
+        const requestId = this.teamRequestIds.get(step.id);
+        const unaccepted = !!(step.sessionId && requestId
+            && this.ops.consumeUnacceptedStartup?.(step.sessionId, requestId));
+        // Bound employees may retry only this request's explicit unaccepted fact, never a text/time guess.
+        if (member.employeeId) {
+            if (!unaccepted || existsSync(path.join(run.cwd, step.reportPath)))
+                return null;
+            return { kind: "spawn-missing", reason: outcomeText };
+        }
         const info = this.infoOf(step);
         const candidates = memberAgents(member);
         const agent = candidates[info.usedCandidate];
@@ -1539,15 +1572,19 @@ export class AiTeamRunner {
     }
     /**
      * 运行停下来等用户时，用户可能刚在团队页换了成员的 CLI / 模型（比如额度用尽换一个）。
-     * 接着跑之前换成最新配置；成员被删了或没有负责人时保留原快照。
+     * 独立 CLI 团队沿用旧刷新规则；带员工链接的运行全程保留新开工时的执行快照。
      */
     refreshTeam(run) {
+        if (run.team.members.some((member) => member.employeeId))
+            return;
         const latest = this.storage.getAiTeam(run.teamId);
         if (!latest || !latest.members.some((member) => member.isLeader))
             return;
         const used = new Set(this.storage.listAiTeamSteps(run.id).map((step) => step.memberId));
         if ([...used].some((id) => !latest.members.some((member) => member.id === id)))
             return;
+        if (latest.members.some((member) => member.employeeId))
+            return;
         run.team = latest;
     }
     /**
@@ -1563,6 +1600,8 @@ export class AiTeamRunner {
             const snapshot = this.ops.snapshot(step.sessionId);
             if (!snapshot || isSessionGone(snapshot))
                 return null;
+            if ((snapshot.employeeId ?? undefined) !== member.employeeId)
+                return null;
             const candidates = memberAgents(member);
             const previous = candidates[this.infoOf(step).usedCandidate] ?? candidates[0];
             if (!previous || (agent && agentKey(previous) !== agentKey(agent)))
@@ -1722,6 +1761,12 @@ export class AiTeamRunner {
         this.notify(run);
     }
     saveStep(step) {
+        if (step.status !== "running" && step.status !== "queued") {
+            const requestId = this.teamRequestIds.get(step.id);
+            if (step.sessionId && requestId)
+                this.ops.consumeUnacceptedStartup?.(step.sessionId, requestId);
+            this.teamRequestIds.delete(step.id);
+        }
         this.storage.saveAiTeamStep(step);
     }
     notify(run) {

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

@@ -1,4 +1,5 @@
 import type { AgentActivityState } from "./mission-types.js";
+import type { AiTeamDeliverySummary } from "./ai-team-delivery-types.js";
 import type { WandTaskAgent } from "./task-types.js";
 import type { ConversationTurn } from "./types.js";
 export declare const AI_TEAM_MIN_MEMBERS = 2;
@@ -15,6 +16,8 @@ export declare function isTeamMemberRole(value: unknown): value is TeamMemberRol
 export interface AiTeamMember {
     /** 团队内唯一，形如 "m_xxxxxxxx"；Leader 派工时原样引用。 */
     id: string;
+    /** 通讯录身份链接；缺省是独立 CLI 成员，不按名字猜测。 */
+    employeeId?: string;
     name: string;
     /** 职责说明，原样写进提示词。 */
     duty: string;
@@ -62,6 +65,8 @@ export interface SiliconEmployee {
     prompt: string;
     avatar: string;
     agents: WandTaskAgent[];
+    /** 内置标签按 systemKey 固定；普通员工的标签由用户维护。旧客户端可不传。 */
+    tags?: string[];
     /**
      * 非空 = Wand 内置员工（如 "wand-ops" 系统运维）：名字/职责/人设/头像锁定，
      * 不可归档、不可删除，只有执行候选由用户维护。
@@ -87,14 +92,21 @@ 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 const SYSTEM_EMPLOYEE_TAG = "\u7CFB\u7EDF\u7528\u6237";
 export declare function isSystemSiliconEmployee(employee: Pick<SiliconEmployee, "systemKey"> | null | undefined): boolean;
 export declare const DEFAULT_EMPLOYEE_KEY = "wand-default";
 export declare const DEFAULT_EMPLOYEE_ID = "e_wand_default";
-export declare const DEFAULT_EMPLOYEE_NAME = "\u9ED8\u5951\u7684\u521D\u4E00";
-export declare const DEFAULT_EMPLOYEE_TAG = "\u9ED8\u8BA4\u4F19\u4F34";
+export declare const DEFAULT_EMPLOYEE_NAME = "\u8D5B\u535A\u864E\u599E";
+export declare const DEFAULT_EMPLOYEE_TAG = "\u9ED8\u8BA4\u7528\u6237";
 export declare function isDefaultSiliconEmployee(employee: Pick<SiliconEmployee, "systemKey"> | null | undefined): boolean;
 export declare function isBuiltinSiliconEmployee(employee: Pick<SiliconEmployee, "systemKey"> | null | undefined): boolean;
+export declare const SILICON_EMPLOYEE_MAX_TAGS = 8;
+export declare const SILICON_EMPLOYEE_TAG_MAX_CHARS = 20;
+/** 内置标识只由真实员工身份投影，不能用自定义标签冒充。 */
+export declare function siliconEmployeeTags(employee: Pick<SiliconEmployee, "systemKey" | "tags">): string[];
+/** API / storage / Web 共用：去空白、去重，保留用户顺序，不静默截断。 */
+export declare function parseSiliconEmployeeTags(value: unknown): string[];
+export declare function parseSiliconEmployeeTagInput(value: string): string[];
 export interface AiTeam {
     id: string;
     name: string;
@@ -236,6 +248,8 @@ export interface AiTeamLiveUpdate {
 }
 export interface AiTeamRunDetail {
     run: AiTeamRun;
+    /** One run's result/files/current handoffs; absent on older servers, no side effects. */
+    delivery?: AiTeamDeliverySummary;
     /** 仅供展示的群名，读取当前任务标题，不以团队名代替。 */
     chatTitle?: string;
     /** 任务标题的版本；任务改名不改变 run.updatedAt。 */

package/dist/ai-team-types.js

@@ -34,21 +34,61 @@ 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 const SYSTEM_EMPLOYEE_TAG = "系统用户";
 export function isSystemSiliconEmployee(employee) {
     return employee?.systemKey === SYSTEM_EMPLOYEE_KEY;
 }
 // 默认任务角色与系统运维分开；CLI 是执行器，角色不替换用户选定的工具/权限。
 export const DEFAULT_EMPLOYEE_KEY = "wand-default";
 export const DEFAULT_EMPLOYEE_ID = "e_wand_default";
-export const DEFAULT_EMPLOYEE_NAME = "默契的初一";
-export const DEFAULT_EMPLOYEE_TAG = "默认伙伴";
+export const DEFAULT_EMPLOYEE_NAME = "赛博虎妞";
+export const DEFAULT_EMPLOYEE_TAG = "默认用户";
 export function isDefaultSiliconEmployee(employee) {
     return employee?.systemKey === DEFAULT_EMPLOYEE_KEY;
 }
 export function isBuiltinSiliconEmployee(employee) {
     return isSystemSiliconEmployee(employee) || isDefaultSiliconEmployee(employee);
 }
+export const SILICON_EMPLOYEE_MAX_TAGS = 8;
+export const SILICON_EMPLOYEE_TAG_MAX_CHARS = 20;
+/** 内置标识只由真实员工身份投影，不能用自定义标签冒充。 */
+export function siliconEmployeeTags(employee) {
+    if (isSystemSiliconEmployee(employee))
+        return [SYSTEM_EMPLOYEE_TAG];
+    if (isDefaultSiliconEmployee(employee))
+        return [DEFAULT_EMPLOYEE_TAG];
+    return employee.tags ?? [];
+}
+/** API / storage / Web 共用：去空白、去重，保留用户顺序，不静默截断。 */
+export function parseSiliconEmployeeTags(value) {
+    if (!Array.isArray(value))
+        throw new Error("员工标签必须是数组。");
+    const tags = [];
+    for (const raw of value) {
+        if (typeof raw !== "string")
+            throw new Error("员工标签必须是文字。");
+        const tag = raw.trim();
+        if (!tag)
+            continue;
+        if (tag.length > SILICON_EMPLOYEE_TAG_MAX_CHARS) {
+            throw new Error(`每个员工标签不能超过 ${SILICON_EMPLOYEE_TAG_MAX_CHARS} 个字符。`);
+        }
+        if (/[,，、\x00-\x1f\x7f]/.test(tag))
+            throw new Error("员工标签不能包含分隔符或控制字符。");
+        if (tag === SYSTEM_EMPLOYEE_TAG || tag === DEFAULT_EMPLOYEE_TAG) {
+            throw new Error(`「${tag}」是内置标签，不可自定义。`);
+        }
+        if (!tags.includes(tag))
+            tags.push(tag);
+    }
+    if (tags.length > SILICON_EMPLOYEE_MAX_TAGS) {
+        throw new Error(`最多 ${SILICON_EMPLOYEE_MAX_TAGS} 个员工标签。`);
+    }
+    return tags;
+}
+export function parseSiliconEmployeeTagInput(value) {
+    return parseSiliconEmployeeTags(value.split(/[,，、\n]+/));
+}
 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": "b95a1ab17fe77df59a9060c24ee37e5799e38e68",
-  "builtAt": "2026-10-01T08:47:47.415Z",
-  "version": "4.82.0",
-  "channel": "stable"
+  "commit": "97d7ae95626425a23420a4f9bfabbf733d5ae73a",
+  "builtAt": "2026-10-03T02:40:52.838Z",
+  "version": "4.83.1-beta.g97d7ae9",
+  "channel": "beta"
 }

package/dist/cli.js

@@ -179,6 +179,39 @@ async function main() {
             await runAgentCliCommand(command, args, configPath);
             break;
         }
+        case "decision:configure": {
+            const { isAbsolute, join } = await import("node:path");
+            const disabling = args.includes("--disable");
+            const pythonPath = readFlagValue(args, "--python") ?? "";
+            const modelPath = readFlagValue(args, "--model") ?? "";
+            if (!disabling && (!isAbsolute(pythonPath) || !isAbsolute(modelPath)
+                || !existsSync(pythonPath) || !existsSync(join(modelPath, "model.safetensors")))) {
+                throw new Error("用法：wand decision:configure --python <Python绝对路径> --model <已下载模型目录>；或 --disable。");
+            }
+            const { config } = await loadConfigForCli(configPath);
+            config.localDecision = disabling
+                ? { enabled: false, pythonPath: config.localDecision?.pythonPath ?? "", modelPath: config.localDecision?.modelPath ?? "" }
+                : { enabled: true, pythonPath, modelPath };
+            await saveConfig(configPath, config);
+            process.stdout.write("本地决策配置已保存，重启 Wand 服务后生效。未修改系统 Python，也未下载模型。\n");
+            break;
+        }
+        case "decision:skills": {
+            const { dirname } = await import("node:path");
+            const { installDecisionSkill } = await import("./decision-skill.js");
+            const { SESSION_PROVIDERS } = await import("./provider-catalog.js");
+            const selected = readFlagValue(args, "--providers")?.split(",") ?? [...SESSION_PROVIDERS];
+            if (selected.some((provider) => !SESSION_PROVIDERS.includes(provider)))
+                throw new Error("未知CLI技能目标。");
+            const result = await installDecisionSkill(dirname(configPath), selected);
+            process.stdout.write(`${JSON.stringify(result)}\n`);
+            break;
+        }
+        case "decide": {
+            const { runDecisionCli } = await import("./decision-client.js");
+            await runDecisionCli(args.slice(1));
+            break;
+        }
         case "knowledge:remember":
         case "knowledge:search":
         case "knowledge:forget": {
@@ -234,6 +267,9 @@ Agent runtime:
   wand mission:diff <mission-id> <attempt-id>
   wand mission:review <mission-id> <attempt-id> --file <path> --body <text> [--line N]
   wand mission:review:send <mission-id> <attempt-id>
+  wand decide --stdin | --status  Use the session-bound local decision service
+  wand decision:configure --python <path> --model <dir> | --disable
+  wand decision:skills [--providers pi,claude,...]  Install managed user-level skills
   wand knowledge:remember <text> | --stdin
   wand knowledge:search [query]
   wand knowledge:forget <entry-id>

package/dist/config.d.ts

@@ -9,6 +9,20 @@ import type { WandStorage } from "./storage.js";
  */
 export declare const PREFERENCE_KEYS: readonly ["defaultProvider", "defaultSessionKind", "defaultTaskWorktree", "defaultMode", "defaultCwd", "defaultModel", "defaultCodexModel", "defaultOpenCodeModel", "defaultGrokModel", "defaultQoderModel", "defaultPiModel", "defaultGeminiModel", "commitCli", "commitModel", "systemAiCli", "systemAiModel", "defaultThinkingEffort", "language", "cardDefaults", "inheritEnv"];
 export type PreferenceKey = (typeof PREFERENCE_KEYS)[number];
+/**
+ * 每个 provider 的默认模型偏好字段。新增 provider 时只改这一处：
+ * 偏好读写、环境归一、默认模型投影都从这张表派生。
+ */
+export declare const PROVIDER_MODEL_PREFERENCE_FIELDS: {
+    readonly claude: "defaultModel";
+    readonly codex: "defaultCodexModel";
+    readonly opencode: "defaultOpenCodeModel";
+    readonly grok: "defaultGrokModel";
+    readonly qoder: "defaultQoderModel";
+    readonly pi: "defaultPiModel";
+    readonly gemini: "defaultGeminiModel";
+};
+export type ProviderModelField = (typeof PROVIDER_MODEL_PREFERENCE_FIELDS)[SessionProvider];
 export declare function isPreferenceKey(key: string): key is PreferenceKey;
 /**
  * The user's login shell from passwd, then $SHELL, then a platform default.
@@ -39,13 +53,7 @@ export declare function applyStoragePreferences(config: WandConfig, storage: Wan
 /** Write a single preference value to DB and (in-place) update the live config object. */
 export declare function writePreferenceToStorage(config: WandConfig, storage: WandStorage, key: PreferenceKey, value: unknown): void;
 export declare function isExecutionMode(value: unknown): value is ExecutionMode;
-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" | "defaultGeminiModel">, provider: SessionProvider | undefined): string;
+export declare function getProviderDefaultModels(config: Pick<WandConfig, ProviderModelField>): Record<SessionProvider, string>;
+export declare function getDefaultModelForProvider(config: Pick<WandConfig, ProviderModelField>, provider: SessionProvider | undefined): string;
+/** 把按 provider 归档的默认模型投影回各自的 `default*Model` 字段（客户端兼容字段）。 */
+export declare function providerModelFields(models: Record<SessionProvider, string>): Pick<WandConfig, ProviderModelField>;

package/dist/config.js

@@ -5,7 +5,7 @@ import os from "node:os";
 import path from "node:path";
 import process from "node:process";
 import { isRunningAsRoot } from "./env-utils.js";
-import { isSessionProvider } from "./session-provider.js";
+import { isSessionProvider, SESSION_PROVIDERS } from "./session-provider.js";
 import { isThinkingEffort } from "./structured-provider-common.js";
 const DEFAULT_CONFIG_DIR = ".wand";
 const DEFAULT_CONFIG_FILE = "config.json";
@@ -38,6 +38,24 @@ export const PREFERENCE_KEYS = [
     "cardDefaults",
     "inheritEnv",
 ];
+/**
+ * 每个 provider 的默认模型偏好字段。新增 provider 时只改这一处：
+ * 偏好读写、环境归一、默认模型投影都从这张表派生。
+ */
+export const PROVIDER_MODEL_PREFERENCE_FIELDS = {
+    claude: "defaultModel",
+    codex: "defaultCodexModel",
+    opencode: "defaultOpenCodeModel",
+    grok: "defaultGrokModel",
+    qoder: "defaultQoderModel",
+    pi: "defaultPiModel",
+    gemini: "defaultGeminiModel",
+};
+const PROVIDER_MODEL_FIELDS = Object.values(PROVIDER_MODEL_PREFERENCE_FIELDS);
+const PROVIDER_MODEL_FIELD_SET = new Set(PROVIDER_MODEL_FIELDS);
+function isProviderModelField(key) {
+    return PROVIDER_MODEL_FIELD_SET.has(key);
+}
 const PREFERENCE_KEY_SET = new Set(PREFERENCE_KEYS);
 function preferenceStorageKey(key) {
     return `pref:${key}`;
@@ -92,6 +110,7 @@ export const defaultConfig = () => ({
     ios: defaultIosIpaConfig(),
     render: defaultRenderConfig(),
     structured: { processHost: "legacy" },
+    localDecision: { enabled: false, pythonPath: "", modelPath: "" },
     cardDefaults: defaultCardExpandDefaults(),
     defaultModel: "",
     defaultCodexModel: "",
@@ -332,40 +351,13 @@ export function applyStoragePreferences(config, storage) {
         if (typeof v === "string" && v.trim())
             config.defaultCwd = v;
     }
-    if (storage.hasPreference(preferenceStorageKey("defaultModel"))) {
-        const v = storage.getPreference(preferenceStorageKey("defaultModel"), defaults.defaultModel ?? "");
-        if (typeof v === "string")
-            config.defaultModel = v.trim();
-    }
-    if (storage.hasPreference(preferenceStorageKey("defaultCodexModel"))) {
-        const v = storage.getPreference(preferenceStorageKey("defaultCodexModel"), defaults.defaultCodexModel ?? "");
-        if (typeof v === "string")
-            config.defaultCodexModel = v.trim();
-    }
-    if (storage.hasPreference(preferenceStorageKey("defaultOpenCodeModel"))) {
-        const v = storage.getPreference(preferenceStorageKey("defaultOpenCodeModel"), defaults.defaultOpenCodeModel ?? "");
-        if (typeof v === "string")
-            config.defaultOpenCodeModel = v.trim();
-    }
-    if (storage.hasPreference(preferenceStorageKey("defaultGrokModel"))) {
-        const v = storage.getPreference(preferenceStorageKey("defaultGrokModel"), defaults.defaultGrokModel ?? "");
-        if (typeof v === "string")
-            config.defaultGrokModel = v.trim();
-    }
-    if (storage.hasPreference(preferenceStorageKey("defaultQoderModel"))) {
-        const v = storage.getPreference(preferenceStorageKey("defaultQoderModel"), defaults.defaultQoderModel ?? "");
-        if (typeof v === "string")
-            config.defaultQoderModel = v.trim();
-    }
-    if (storage.hasPreference(preferenceStorageKey("defaultPiModel"))) {
-        const v = storage.getPreference(preferenceStorageKey("defaultPiModel"), defaults.defaultPiModel ?? "");
-        if (typeof v === "string")
-            config.defaultPiModel = v.trim();
-    }
-    if (storage.hasPreference(preferenceStorageKey("defaultGeminiModel"))) {
-        const v = storage.getPreference(preferenceStorageKey("defaultGeminiModel"), defaults.defaultGeminiModel ?? "");
+    for (const field of PROVIDER_MODEL_FIELDS) {
+        const dbKey = preferenceStorageKey(field);
+        if (!storage.hasPreference(dbKey))
+            continue;
+        const v = storage.getPreference(dbKey, defaults[field] ?? "");
         if (typeof v === "string")
-            config.defaultGeminiModel = v.trim();
+            config[field] = v.trim();
     }
     if (storage.hasPreference(preferenceStorageKey("commitCli"))) {
         const v = storage.getPreference(preferenceStorageKey("commitCli"), defaults.commitCli ?? "claude");
@@ -410,6 +402,14 @@ export function applyStoragePreferences(config, storage) {
 /** Write a single preference value to DB and (in-place) update the live config object. */
 export function writePreferenceToStorage(config, storage, key, value) {
     const dbKey = preferenceStorageKey(key);
+    // Default model fields share one shape (trimmed string) across every provider;
+    // handling them before the switch keeps the switch free of seven copies.
+    if (isProviderModelField(key)) {
+        const v = typeof value === "string" ? value.trim() : "";
+        storage.setPreference(dbKey, v);
+        config[key] = v;
+        return;
+    }
     switch (key) {
         case "defaultProvider": {
             if (!isSessionProvider(value))
@@ -445,48 +445,6 @@ export function writePreferenceToStorage(config, storage, key, value) {
             config.defaultCwd = v || defaultConfig().defaultCwd;
             break;
         }
-        case "defaultModel": {
-            const v = typeof value === "string" ? value.trim() : "";
-            storage.setPreference(dbKey, v);
-            config.defaultModel = v;
-            break;
-        }
-        case "defaultCodexModel": {
-            const v = typeof value === "string" ? value.trim() : "";
-            storage.setPreference(dbKey, v);
-            config.defaultCodexModel = v;
-            break;
-        }
-        case "defaultOpenCodeModel": {
-            const v = typeof value === "string" ? value.trim() : "";
-            storage.setPreference(dbKey, v);
-            config.defaultOpenCodeModel = v;
-            break;
-        }
-        case "defaultGrokModel": {
-            const v = typeof value === "string" ? value.trim() : "";
-            storage.setPreference(dbKey, v);
-            config.defaultGrokModel = v;
-            break;
-        }
-        case "defaultQoderModel": {
-            const v = typeof value === "string" ? value.trim() : "";
-            storage.setPreference(dbKey, v);
-            config.defaultQoderModel = v;
-            break;
-        }
-        case "defaultPiModel": {
-            const v = typeof value === "string" ? value.trim() : "";
-            storage.setPreference(dbKey, v);
-            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}`);
@@ -734,17 +692,16 @@ function mergeWithDefaults(input) {
         ios: normalizeIosIpaConfig(input.ios) ?? defaults.ios,
         render: normalizeRenderConfig(input.render) ?? defaults.render,
         structured: { processHost: input.structured?.processHost === "rust" ? "rust" : "legacy" },
+        localDecision: {
+            enabled: input.localDecision?.enabled === true,
+            pythonPath: typeof input.localDecision?.pythonPath === "string" ? input.localDecision.pythonPath.trim() : "",
+            modelPath: typeof input.localDecision?.modelPath === "string" ? input.localDecision.modelPath.trim() : "",
+        },
         cardDefaults: normalizeCardDefaults(input.cardDefaults),
         defaultProvider: isSessionProvider(input.defaultProvider) ? input.defaultProvider : "claude",
         defaultSessionKind: input.defaultSessionKind === "pty" ? "pty" : "structured",
         defaultTaskWorktree: typeof input.defaultTaskWorktree === "boolean" ? input.defaultTaskWorktree : defaults.defaultTaskWorktree,
-        defaultModel: typeof input.defaultModel === "string" ? input.defaultModel.trim() : defaults.defaultModel,
-        defaultCodexModel: typeof input.defaultCodexModel === "string" ? input.defaultCodexModel.trim() : defaults.defaultCodexModel,
-        defaultOpenCodeModel: typeof input.defaultOpenCodeModel === "string" ? input.defaultOpenCodeModel.trim() : defaults.defaultOpenCodeModel,
-        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,
+        ...providerModelOverrides(input, defaults),
         commitCli: input.commitCli === "codex" || input.commitCli === "opencode" ? input.commitCli : "claude",
         commitModel: typeof input.commitModel === "string" ? input.commitModel.trim() : defaults.commitModel,
         systemAiCli: isSessionProvider(input.systemAiCli) ? input.systemAiCli : undefined,
@@ -764,32 +721,33 @@ function configuredModelId(value) {
     const trimmed = (value ?? "").trim();
     return trimmed === "default" ? "" : trimmed;
 }
+/** 归一每个 provider 的默认模型：字符串则 trim，否则回落到默认值。 */
+function providerModelOverrides(input, defaults) {
+    const result = {};
+    for (const field of PROVIDER_MODEL_FIELDS) {
+        const value = input[field];
+        result[field] = typeof value === "string" ? value.trim() : defaults[field];
+    }
+    return result;
+}
 export function getProviderDefaultModels(config) {
-    return {
-        claude: configuredModelId(config.defaultModel),
-        codex: configuredModelId(config.defaultCodexModel),
-        opencode: configuredModelId(config.defaultOpenCodeModel),
-        grok: configuredModelId(config.defaultGrokModel),
-        qoder: configuredModelId(config.defaultQoderModel),
-        pi: configuredModelId(config.defaultPiModel),
-        gemini: configuredModelId(config.defaultGeminiModel),
-    };
+    const models = {};
+    for (const provider of SESSION_PROVIDERS) {
+        models[provider] = configuredModelId(config[PROVIDER_MODEL_PREFERENCE_FIELDS[provider]]);
+    }
+    return models;
 }
 export function getDefaultModelForProvider(config, provider) {
     const defaults = getProviderDefaultModels(config);
-    if (provider === "codex")
-        return defaults.codex;
-    if (provider === "opencode")
-        return defaults.opencode;
-    if (provider === "grok")
-        return defaults.grok;
-    if (provider === "qoder")
-        return defaults.qoder;
-    if (provider === "pi")
-        return defaults.pi;
-    if (provider === "gemini")
-        return defaults.gemini;
-    return defaults.claude;
+    return provider ? defaults[provider] : defaults.claude;
+}
+/** 把按 provider 归档的默认模型投影回各自的 `default*Model` 字段（客户端兼容字段）。 */
+export function providerModelFields(models) {
+    const result = {};
+    for (const provider of SESSION_PROVIDERS) {
+        result[PROVIDER_MODEL_PREFERENCE_FIELDS[provider]] = models[provider];
+    }
+    return result;
 }
 function normalizePresetCommand(command) {
     const trimmed = command.trim();

package/dist/decision-client.d.ts

@@ -0,0 +1,4 @@
+import { type DecisionRequest } from "./decision-types.js";
+/** No admin/password lookup, redirects, or implicit remote fallback. Credentials stay in headers. */
+export declare function callDecisionService(request: DecisionRequest | null, env?: NodeJS.ProcessEnv): Promise<unknown>;
+export declare function runDecisionCli(args: string[]): Promise<void>;