@co0ontty/wand 4.88.0 → 4.89.0-beta.gde0b3cd

package/dist/local-model-setup.js

@@ -7,6 +7,7 @@ import { LAYA_FILES, LAYA_REPOSITORY, layaFileUrl } from "./laya-model-manifest.
 import { ModelFileStore } from "./model-file-store.js";
 import { runModelSetup } from "./model-setup-process.js";
 import { speechModel } from "./speech-models.js";
+import { speechSupport } from "./speech-support.js";
 import { systemEnvValue } from "./env-utils.js";
 import { decisionHardware } from "./decision-hardware.js";
 import { DECISION_EXPERT_ID } from "./decision-expert-identity.js";
@@ -20,6 +21,8 @@ export class LocalModelSetupService {
     jobs = new Map();
     sequence = 0;
     disposed = false;
+    speechEnableRevision = 0;
+    supportCache = null;
     constructor(deps) {
         this.deps = deps;
         this.files = new ModelFileStore(deps.fetch);
@@ -55,6 +58,7 @@ export class LocalModelSetupService {
         const hardware = decisionHardware();
         const operation = this.operations.get("laya") ?? null;
         const selected = speech.models.find((value) => value.id === speech.settings.model);
+        const support = await this.speechSupport(speech.runtime.available);
         return {
             laya: { kind: "laya", label: "LAYA 本地决策", supported,
                 reason: !supported ? hardware.message
@@ -62,12 +66,38 @@ export class LocalModelSetupService {
                 enabled: decision.enabled, model: LAYA_REPOSITORY, modelSize: this.manifest.reduce((sum, file) => sum + file.size, 0),
                 downloaded: model.downloaded, runtimeAvailable: !!python, initialized: decision.state === "ready", busy: this.jobs.has("laya") || decision.queued > 0 || decision.state === "loading",
                 operation: operation ? { ...operation } : null, hardware, decisionEmployeeId: DECISION_EXPERT_ID },
-            speech: { kind: "speech", label: "服务端语音识别", supported: ["darwin", "linux", "win32"].includes(process.platform), reason: speech.reason,
+            speech: { kind: "speech", label: "服务端语音识别", supported: support.supported, supportReason: support.reason, reason: speech.reason,
                 enabled: speech.settings.enabled, model: speech.settings.model, modelSize: selected?.size ?? 0,
                 downloaded: selected?.downloaded ?? false, runtimeAvailable: speech.runtime.available, initialized: speech.initialized === true,
                 busy: speech.busy || this.jobs.has("speech"), operation: this.operations.has("speech") ? { ...this.operations.get("speech") } : null },
         };
     }
+    speechSupport(runtimeAvailable) {
+        if (!this.supportCache || this.supportCache.expires < Date.now() || this.supportCache.runtimeAvailable !== runtimeAvailable) {
+            this.supportCache = { expires: Date.now() + 30_000, runtimeAvailable, value: (this.deps.speechSupport ?? speechSupport)(runtimeAvailable) };
+        }
+        return this.supportCache.value;
+    }
+    async setSpeechEnabled(enabled) {
+        const revision = ++this.speechEnableRevision;
+        const settingsRevision = this.deps.speech.settingsRevision();
+        if (this.disposed)
+            throw new DecisionError("UNAVAILABLE", "模型管理已关闭。", 503);
+        if (!enabled) {
+            this.cancel("speech");
+            this.deps.speech.configure({ enabled: false });
+            return;
+        }
+        const status = await this.deps.speech.status();
+        const support = await this.speechSupport(status.runtime.available);
+        if (revision !== this.speechEnableRevision || this.disposed || settingsRevision !== this.deps.speech.settingsRevision())
+            return;
+        if (!support.supported)
+            throw new DecisionError("UNSUPPORTED", support.reason || "本机不支持语音识别。", 409);
+        if (status.busy || status.download?.phase === "downloading")
+            throw new DecisionError("BUSY", "语音识别或模型下载正在进行，请稍后启用。", 409);
+        this.start("speech", "activate", {});
+    }
     parse(kind, raw) {
         if (!raw || typeof raw !== "object" || Array.isArray(raw))
             throw new DecisionError("INVALID_REQUEST", "模型操作参数无效。");
@@ -90,6 +120,8 @@ export class LocalModelSetupService {
             throw new DecisionError("UNAVAILABLE", "模型管理已关闭。", 503);
         if (kind === "laya" && !this.supported())
             throw new DecisionError("UNSUPPORTED", `LAYA-MLX 需要 Apple Silicon macOS 与 Metal；${decisionHardware().message}`, 409);
+        if (kind === "laya" && action === "activate")
+            throw new DecisionError("INVALID_REQUEST", "一键启用仅用于语音识别。");
         const input = this.parse(kind, raw);
         if (this.jobs.has(kind))
             throw new DecisionError("BUSY", "该模型已有安装任务，请等待或取消。", 409);
@@ -119,6 +151,8 @@ export class LocalModelSetupService {
         timer.unref();
         const signal = abort.signal;
         const phase = (value, message) => this.update(kind, id, { phase: value, message });
+        let activationMaintenance = false;
+        const settingsRevision = this.deps.speech.settingsRevision();
         try {
             if (kind === "laya") {
                 let model = await this.layaModel();
@@ -170,7 +204,7 @@ export class LocalModelSetupService {
             }
             else {
                 const selected = input.model ?? this.deps.speech.settings().model;
-                if (action === "download") {
+                if (action === "download" || action === "activate") {
                     phase("downloading", "下载并校验语音模型");
                     await this.deps.speech.startDownload(selected);
                     while (true) {
@@ -188,7 +222,12 @@ export class LocalModelSetupService {
                         });
                     }
                 }
-                else {
+                if (action !== "download") {
+                    if (action === "activate") {
+                        signal.throwIfAborted();
+                        this.deps.speech.acquireMaintenance();
+                        activationMaintenance = true;
+                    }
                     const status = await this.deps.speech.status();
                     signal.throwIfAborted();
                     const backend = input.backend === "auto" || !input.backend ? process.platform === "darwin" ? "metal" : "cpu" : input.backend;
@@ -207,22 +246,30 @@ export class LocalModelSetupService {
                             await rm(work, { recursive: true, force: true }).catch(() => { });
                         }
                     }
-                    phase("initializing", "加载所选语音模型并用合成静音检查，未启用识别或重启服务");
-                    await this.deps.speech.initializeModel(selected, signal);
+                    phase("initializing", action === "activate" ? "正在检查语音模型，完成后自动启用。" : "加载所选语音模型并用合成静音检查，未启用识别或重启服务");
+                    await this.deps.speech.initializeModel(selected, signal, action === "activate" ? "auto" : undefined);
+                    if (action === "activate") {
+                        signal.throwIfAborted();
+                        if (settingsRevision !== this.deps.speech.settingsRevision())
+                            throw new DecisionError("SETTINGS_CHANGED", "语音设置已由其他操作修改，本次启用已取消。");
+                        this.deps.speech.configure({ enabled: true, acceleration: "auto" });
+                    }
                 }
             }
             signal.throwIfAborted();
-            phase("completed", action === "download" ? "模型下载及完整性校验完成；可继续初始化" : "运行时和模型初始化检查完成；启用状态保持不变");
+            phase("completed", action === "activate" ? "服务端语音识别已启用。" : action === "download" ? "模型下载及完整性校验完成；可继续初始化" : "运行时和模型初始化检查完成；启用状态保持不变");
         }
         catch (error) {
             const cancelled = signal.aborted;
             const message = cancelled ? "安装任务已取消，完整文件保留，可重试" : error instanceof DecisionError || (error instanceof Error && /请先|校验|自定义|独立/.test(error.message))
                 ? error.message : "安装或初始化失败，请检查网络、编译工具/Python版本、磁盘空间和平台能力，再重试。";
             this.update(kind, id, { phase: cancelled ? "cancelled" : "failed", message, ...(cancelled ? {} : { error: message }) });
-            if (kind === "speech" && action === "download" && cancelled)
+            if (kind === "speech" && (action === "download" || action === "activate") && cancelled)
                 this.deps.speech.cancelDownload();
         }
         finally {
+            if (activationMaintenance)
+                this.deps.speech.releaseMaintenance();
             clearTimeout(timer);
         }
     }

package/dist/local-model-types.d.ts

@@ -3,7 +3,7 @@ export type LocalModelKind = "laya" | "speech";
 export type ModelSetupPhase = "downloading" | "verifying" | "runtime" | "initializing" | "completed" | "failed" | "cancelled";
 export interface ModelSetupOperation {
     id: number;
-    action: "download" | "initialize";
+    action: "download" | "initialize" | "activate";
     phase: ModelSetupPhase;
     message: string;
     received: number;
@@ -14,6 +14,7 @@ export interface LocalModelStatus {
     kind: LocalModelKind;
     label: string;
     supported: boolean;
+    supportReason?: string | null;
     reason: string | null;
     enabled: boolean;
     model: string;

package/dist/process-manager.d.ts

@@ -3,6 +3,7 @@ import { EventEmitter } from "node:events";
 import { WandStorage } from "./storage.js";
 import { ExecutionMode, ProcessEventHandler, SessionProvider, SessionSnapshot, SessionSource, WandConfig } from "./types.js";
 import { type PermissionResolution } from "./claude-pty-bridge.js";
+import type { EmployeeTextDeps } from "./employee-text.js";
 import { type PtyTerminalSnapshot, type PtyHistoryPage } from "./pty-terminal-state.js";
 import { samplePtyForegrounds } from "./pty-foreground.js";
 import { type TerminalHost } from "./terminal-host.js";
@@ -34,6 +35,7 @@ export declare const PTY_TURN_IDLE_MS = 3000;
  */
 export declare const PTY_FOREGROUND_SAMPLE_MS = 1000;
 export interface ProcessManagerOptions {
+    free?: EmployeeTextDeps["free"];
     /** Overrides the non-Claude PTY turn quiet window (tests use a short one). */
     ptyTurnIdleMs?: number;
     /** Overrides the foreground-process-group sampling interval (tests use a short one). */
@@ -55,6 +57,7 @@ export declare class ProcessManager extends EventEmitter {
     private readonly ptyForegroundSampleMs;
     /** Foreground probe; injectable so tests can drive it without a real process table. */
     private readonly probePtyForegrounds;
+    private readonly free;
     private readonly resolveDecisionEvaluate;
     /** 24h archive scan timer */
     private archiveTimer;
@@ -177,7 +180,7 @@ export declare class ProcessManager extends EventEmitter {
      */
     setSessionModel(id: string, model: string | null): SessionSnapshot;
     /**
-     * 归档会先停掉还在跑的终端，但保留会话 ID 和 provider session id，恢复时用它们续上。
+     * 归档只写标记，保留正在运行的终端、会话 ID 和 provider session id。
      * 取消归档只清标记；重新拉起由恢复入口负责。
      */
     setSessionArchived(id: string, archived: boolean): SessionSnapshot;

package/dist/process-manager.js

@@ -563,6 +563,7 @@ export class ProcessManager extends EventEmitter {
     ptyForegroundSampleMs;
     /** Foreground probe; injectable so tests can drive it without a real process table. */
     probePtyForegrounds;
+    free;
     resolveDecisionEvaluate;
     /** 24h archive scan timer */
     archiveTimer = null;
@@ -595,6 +596,7 @@ export class ProcessManager extends EventEmitter {
         this.ptyTurnIdleMs = options.ptyTurnIdleMs ?? PTY_TURN_IDLE_MS;
         this.ptyForegroundSampleMs = options.ptyForegroundSampleMs ?? PTY_FOREGROUND_SAMPLE_MS;
         this.probePtyForegrounds = options.samplePtyForegrounds ?? samplePtyForegrounds;
+        this.free = options.free;
         this.resolveDecisionEvaluate = options.resolveDecisionEvaluate ?? (() => undefined);
         this.terminalHost = terminalHost ?? new InProcessTerminalHost();
         this.logger = new SessionLogger(configDir || path.join(process.env.HOME || process.cwd(), ".wand"), config.shortcutLogMaxBytes);
@@ -1229,7 +1231,7 @@ export class ProcessManager extends EventEmitter {
                     ai: resolveSystemAiContext({
                         provider: groupProvider, runner: undefined, command: providerCliCommand(groupProvider),
                         structuredState: undefined, selectedModel: null, thinkingEffort: opts?.thinkingEffort,
-                    }, this.config, this.storage.getSystemSiliconEmployee()),
+                    }, this.config, this.storage.getSystemSiliconEmployee(), this.free),
                     cwd: resolveSessionCwd(cwd, this.config.defaultCwd),
                     language: this.config.language,
                 });
@@ -1775,13 +1777,10 @@ export class ProcessManager extends EventEmitter {
         return this.snapshot(record);
     }
     /**
-     * 归档会先停掉还在跑的终端，但保留会话 ID 和 provider session id，恢复时用它们续上。
+     * 归档只写标记，保留正在运行的终端、会话 ID 和 provider session id。
      * 取消归档只清标记；重新拉起由恢复入口负责。
      */
     setSessionArchived(id, archived) {
-        if (archived && this.mustGet(id).status === "running") {
-            this.stop(id);
-        }
         const record = this.mustGet(id);
         record.archived = archived;
         record.archivedAt = archived ? (record.archivedAt ?? new Date().toISOString()) : null;
@@ -2354,7 +2353,7 @@ export class ProcessManager extends EventEmitter {
             input: prompt,
             cwd: record.cwd,
             language: this.config.language,
-            ai: resolveSystemAiContext(record, this.config, this.storage.getSystemSiliconEmployee()),
+            ai: resolveSystemAiContext(record, this.config, this.storage.getSystemSiliconEmployee(), this.free),
             readNativeTitle: () => readNativeSessionTitle(resolveSessionProvider(record), record.claudeSessionId, record.cwd),
             hasNativeTitle,
             onGenerating: (generating) => {

package/dist/render-daemon-client.d.ts

@@ -108,6 +108,8 @@ export declare class RenderDaemonClient implements TerminalHost {
         sessions: TerminalSessionState[] | null;
     }>;
     requestShutdownDrain(): Promise<void>;
+    /** Explicit confirmed maintenance only; does not shut down the daemon itself. */
+    interruptMaintenanceSessions(): Promise<void>;
     connect(): Promise<void>;
     private open;
     /**

package/dist/render-daemon-client.js

@@ -233,6 +233,12 @@ export class RenderDaemonClient {
     async requestShutdownDrain() {
         await this.request("shutdown", { mode: "drain" });
     }
+    /** Explicit confirmed maintenance only; does not shut down the daemon itself. */
+    async interruptMaintenanceSessions() {
+        const sessions = await this.listSessions();
+        await Promise.all(sessions.filter(session => session.status === "running")
+            .map(session => this.request("kill", { sessionId: session.sessionId, signal: "SIGTERM" })));
+    }
     connect() {
         if (this.disposed)
             return Promise.reject(new Error("Render client disposed"));

package/dist/server-daemon-maintenance-routes.d.ts

@@ -0,0 +1,8 @@
+import type { Express, Request, RequestHandler } from "express";
+import type { DaemonMaintenance } from "./daemon-maintenance.js";
+export declare function registerDaemonMaintenanceRoutes(app: Express, options: {
+    requireAdmin: RequestHandler;
+    canForceUpdate(req: Request): boolean;
+    maintenance: Pick<DaemonMaintenance, "status" | "forceUpdate">;
+    log(error: unknown): void;
+}): void;

package/dist/server-daemon-maintenance-routes.js

@@ -0,0 +1,19 @@
+export function registerDaemonMaintenanceRoutes(app, options) {
+    const { maintenance } = options;
+    app.get("/api/daemon-maintenance", (req, res) => {
+        res.set("Cache-Control", "no-store").json({ ...maintenance.status(), canForceUpdate: options.canForceUpdate(req) });
+    });
+    app.post("/api/daemon-maintenance/force-update", options.requireAdmin, async (req, res) => {
+        if (req.body?.confirmInterrupt !== true) {
+            res.status(400).json({ error: "请先确认中断正在执行的任务。" });
+            return;
+        }
+        try {
+            res.set("Cache-Control", "no-store").json(await maintenance.forceUpdate());
+        }
+        catch (error) {
+            options.log(error);
+            res.status(409).json({ error: "强制更新未完成，执行可能仍在停止或组件暂不可用。系统会在空闲后自动重试。", ...maintenance.status() });
+        }
+    });
+}

package/dist/server-employee-routes.d.ts

@@ -1,5 +1,6 @@
 import type { Express } from "express";
 import { type SiliconEmployee, type SiliconEmployeeDraft } from "./ai-team-types.js";
+import type { OpenRouterFreeModelsService } from "./openrouter-free-models.js";
 import type { WandStorage } from "./storage.js";
 import type { WandTaskAgent } from "./task-types.js";
 import type { WandConfig } from "./types.js";
@@ -17,6 +18,7 @@ export declare function registerSiliconEmployeeRoutes(app: Express, deps: {
     storage: WandStorage;
     notifyEmployeeChanged?: (employeeId: string) => void;
     config?: WandConfig;
+    free?: Pick<OpenRouterFreeModelsService, "resolveForCall">;
     /** 测试注入点：默认按系统 AI 配置真实调用模型。 */
     generateDraft?: (request: EmployeeDraftRequest) => Promise<SiliconEmployeeDraft>;
     /** 测试注入点：CLI 可用性探测。 */

package/dist/server-employee-routes.js

@@ -1,8 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { AI_TEAM_MAX_CANDIDATES, SILICON_EMPLOYEE_AVATAR_MAX_CHARS, agentKey, isBuiltinSiliconEmployee, parseSiliconEmployeeTags, siliconEmployeeTags, } from "./ai-team-types.js";
 import { getErrorMessage } from "./error-utils.js";
-import { DECISION_EXPERT_KEY, isLocalDecisionModel } from "./decision-expert-identity.js";
-import { OPENROUTER_FREE_SELECTOR, isOpenRouterFreeSelector } from "./openrouter-free-selection.js";
 import { asyncRoute } from "./express-async.js";
 import { bodyObject, sendRouteError, text } from "./server-request.js";
 import { parseTaskAgent } from "./server-task-routes.js";
@@ -14,7 +12,7 @@ import { SESSION_PROVIDERS } from "./session-provider.js";
 import { DEFAULT_WAND_TASK_AGENT_KIND } from "./task-types.js";
 import { EMPLOYEE_KNOWLEDGE_MAX_ENTRIES } from "./employee-knowledge-types.js";
 /** 员工起草没有会话上下文，按「默认 provider」解析，与任务标题 / 提示词优化一致。 */
-function employeeDraftAiOptions(storage, config) {
+function employeeDraftAiOptions(storage, config, free) {
     if (!config)
         return {};
     const provider = config.defaultProvider ?? "claude";
@@ -25,7 +23,7 @@ function employeeDraftAiOptions(storage, config) {
         command: provider === "qoder" ? "qodercli" : provider,
         selectedModel: null,
         thinkingEffort: config.defaultThinkingEffort,
-    }, config, storage.getSystemSiliconEmployee());
+    }, config, storage.getSystemSiliconEmployee(), free);
 }
 function sendEmployeeError(res, error, context) {
     const message = getErrorMessage(error, "硅基员工操作失败。");
@@ -99,23 +97,23 @@ export function parseSystemEmployeeAgents(value, existing) {
     if (body.systemKey !== undefined && body.systemKey !== existing.systemKey) {
         throw new Error("该员工是内置的，身份不可修改。");
     }
-    if (!Array.isArray(body.agents))
+    return parseEmployeeAgents(body.agents);
+}
+/** One validation owner for every employee candidate list, including legacy single agents. */
+function parseEmployeeAgents(value) {
+    if (!Array.isArray(value))
         throw new Error("请提供执行候选数组（CLI / SDK）。");
-    if (body.agents.length === 0)
+    if (value.length === 0)
         throw new Error("至少需要一个执行候选。");
-    if (body.agents.length > AI_TEAM_MAX_CANDIDATES) {
+    if (value.length > AI_TEAM_MAX_CANDIDATES) {
         throw new Error(`最多 ${AI_TEAM_MAX_CANDIDATES} 个执行候选。`);
     }
-    const agents = body.agents.map((rawAgent) => {
+    const agents = value.map((rawAgent) => {
         const parsed = parseTaskAgent(rawAgent ?? {});
         if (!parsed)
             throw new Error("请选择有效的 CLI 工具或 Wand Agent。");
         if (parsed.kind !== "structured")
             throw new Error("硅基员工只支持结构化会话。");
-        if (existing.systemKey === DECISION_EXPERT_KEY && (parsed.provider !== "pi" || parsed.engine !== "sdk"
-            || !(isLocalDecisionModel(parsed.model) || parsed.model === OPENROUTER_FREE_SELECTOR || isOpenRouterFreeSelector(parsed.model)))) {
-            throw new Error("决策专家仅支持 LAYA 或 Wand 免费分组的决策候选；请使用 Wand 内部执行入口。");
-        }
         return parsed;
     });
     if (new Set(agents.map(agentKey)).size !== agents.length) {
@@ -132,40 +130,16 @@ export function parseSiliconEmployeeInput(value, existing, now) {
     const prompt = text(body.prompt);
     if (prompt.length > 20_000)
         throw new Error("员工设定 Prompt 不能超过 20000 个字符。");
-    let agents;
-    if (Array.isArray(body.agents)) {
-        if (body.agents.length === 0)
-            throw new Error("至少需要一个执行候选。");
-        if (body.agents.length > AI_TEAM_MAX_CANDIDATES) {
-            throw new Error(`最多 ${AI_TEAM_MAX_CANDIDATES} 个执行候选。`);
-        }
-        agents = body.agents.map((rawAgent) => {
-            const parsed = parseTaskAgent(rawAgent ?? {});
-            if (!parsed)
-                throw new Error("请选择有效的 CLI 工具或 Wand Agent。");
-            if (parsed.kind !== "structured")
-                throw new Error("硅基员工只支持结构化会话。");
-            return parsed;
-        });
-    }
-    else if (body.agents !== undefined && body.agents !== null) {
+    let candidates;
+    if (Array.isArray(body.agents))
+        candidates = body.agents;
+    else if (body.agents !== undefined && body.agents !== null)
         throw new Error("候选执行配置必须是数组。");
-    }
-    else if (body.agent !== undefined && body.agent !== null) {
-        const singleAgent = parseTaskAgent(body.agent);
-        if (!singleAgent)
-            throw new Error("请选择有效的 CLI 工具或 Wand Agent。");
-        if (singleAgent.kind !== "structured")
-            throw new Error("硅基员工只支持结构化会话。");
-        agents = [singleAgent];
-    }
-    else {
+    else if (body.agent !== undefined && body.agent !== null)
+        candidates = [body.agent];
+    else
         throw new Error("至少需要一个执行候选。");
-    }
-    const seenKeys = new Set(agents.map(agentKey));
-    if (seenKeys.size !== agents.length) {
-        throw new Error("执行候选存在重复。");
-    }
+    const agents = parseEmployeeAgents(candidates);
     const avatar = parseAvatar(body.avatar, name);
     const tags = parseSiliconEmployeeTags(body.tags === undefined ? existing?.tags ?? [] : body.tags);
     const id = existing?.id ?? `e_${randomUUID().replace(/-/g, "")}`;
@@ -203,7 +177,7 @@ export function registerSiliconEmployeeRoutes(app, deps) {
         const available = availableEmployeeProviders(resolveDefaults().provider, isProviderAvailable);
         return available.length ? available : [...SESSION_PROVIDERS];
     };
-    const generateDraft = deps.generateDraft ?? ((request) => generateSiliconEmployeeDraft(request.expectation, employeeDraftAiOptions(storage, config), {
+    const generateDraft = deps.generateDraft ?? ((request) => generateSiliconEmployeeDraft(request.expectation, employeeDraftAiOptions(storage, config, deps.free), {
         cwd: config?.defaultCwd || process.cwd(),
         language: config?.language ?? "",
         existingNames: request.existingNames,

package/dist/server-file-routes.js

@@ -10,6 +10,7 @@ import { asyncRoute } from "./express-async.js";
 import { sendRouteError } from "./server-request.js";
 import { isBlockedFolderPath, isPathWithinBase, normalizeFolderPath } from "./middleware/path-safety.js";
 import { parseBoundedInteger } from "./request-limits.js";
+import { runGitRawAsync } from "./git-utils.js";
 const execAsync = promisify(exec);
 const DIRECTORY_MAX_ITEMS = 200;
 const MAX_TEXT_PREVIEW_SIZE = 512 * 1024;
@@ -593,7 +594,10 @@ export function registerFileRoutes(app, deps) {
         const cwd = typeof req.query.cwd === "string" ? req.query.cwd : defaultCwd;
         const maxDepth = parseBoundedInteger(req.query.depth, 5, 0, 8);
         const maxResults = parseBoundedInteger(req.query.limit, 50, 1, 200);
-        const ignoredDirectories = new Set([".git", "node_modules", ".next", "dist", "build", "coverage", ".wand-uploads", ".wand-team"]);
+        const includeGenerated = req.query.includeGenerated === "true";
+        // Internal metadata remains excluded even when the user opts into generated files.
+        const ignoredDirectories = new Set([".git", ".wand", ".wand-uploads", ".wand-team"]);
+        const generatedDirectories = new Set(["node_modules", ".next", "dist", "build", "coverage"]);
         const maxVisitedEntries = 20_000;
         let resolvedCwd;
         try {
@@ -612,38 +616,70 @@ export function registerFileRoutes(app, deps) {
             return;
         }
         try {
+            let gitIgnored = new Set();
+            try {
+                const ignored = await runGitRawAsync(["ls-files", "--others", "--ignored", "--exclude-standard", "--directory", "-z"], resolvedCwd, { timeout: 2_000, maxBuffer: 2 * 1024 * 1024 });
+                gitIgnored = new Set(ignored.split("\0").filter(Boolean).map((entry) => path.resolve(resolvedCwd, entry.replace(/\/$/, ""))));
+            }
+            catch {
+                // Ordinary directories and hosts without Git still retain the existing known-directory exclusions.
+            }
             const results = [];
+            const deferred = [];
             const queryLower = query.toLowerCase();
             let visitedEntries = 0;
-            async function searchDir(dirPath, currentDepth) {
-                if (currentDepth > maxDepth || results.length >= maxResults || visitedEntries >= maxVisitedEntries)
-                    return;
-                const entries = await readdir(dirPath, { withFileTypes: true });
-                for (const entry of entries) {
-                    if (results.length >= maxResults || visitedEntries >= maxVisitedEntries)
-                        break;
-                    visitedEntries += 1;
-                    if (entry.isDirectory() && ignoredDirectories.has(entry.name))
+            async function searchDir(dirPath, currentDepth, generated = false) {
+                const directories = [{ path: dirPath, depth: currentDepth }];
+                for (let index = 0; index < directories.length && visitedEntries < maxVisitedEntries; index += 1) {
+                    const directory = directories[index];
+                    if (directory.depth > maxDepth)
                         continue;
-                    const entryPath = path.join(dirPath, entry.name);
-                    const matchIndex = entry.name.toLowerCase().indexOf(queryLower);
-                    if (matchIndex !== -1) {
-                        results.push({
-                            path: entryPath,
-                            name: entry.name,
-                            type: entry.isDirectory() ? "dir" : "file",
-                            matchScore: matchIndex,
-                        });
+                    const entries = await readdir(directory.path, { withFileTypes: true });
+                    for (const entry of entries) {
+                        if (visitedEntries >= maxVisitedEntries)
+                            break;
+                        visitedEntries += 1;
+                        if (entry.isDirectory() && ignoredDirectories.has(entry.name))
+                            continue;
+                        const entryPath = path.join(directory.path, entry.name);
+                        if (!generated && entry.isDirectory() && generatedDirectories.has(entry.name)) {
+                            if (includeGenerated)
+                                deferred.push({ path: entryPath, name: entry.name, depth: directory.depth + 1 });
+                            continue;
+                        }
+                        if (!generated && gitIgnored.has(entryPath))
+                            continue;
+                        const matchIndex = entry.name.toLowerCase().indexOf(queryLower);
+                        if (matchIndex !== -1) {
+                            results.push({
+                                path: entryPath,
+                                name: entry.name,
+                                type: entry.isDirectory() ? "dir" : "file",
+                                matchScore: matchIndex,
+                                generated,
+                                depth: directory.depth,
+                            });
+                        }
+                        if (entry.isDirectory() && directory.depth < maxDepth)
+                            directories.push({ path: entryPath, depth: directory.depth + 1 });
                     }
-                    if (entry.isDirectory())
-                        await searchDir(entryPath, currentDepth + 1);
                 }
             }
             await searchDir(resolvedCwd, 0);
-            results.sort((a, b) => a.matchScore !== b.matchScore
-                ? a.matchScore - b.matchScore
-                : a.name.localeCompare(b.name));
-            res.json({ results: results.slice(0, maxResults), query, cwd: resolvedCwd });
+            // Complete the project-file pass before dependencies can consume the bounded result budget.
+            for (const directory of deferred) {
+                if (visitedEntries >= maxVisitedEntries)
+                    break;
+                const matchScore = directory.name.toLowerCase().indexOf(queryLower);
+                if (matchScore !== -1)
+                    results.push({ path: directory.path, name: directory.name, type: "dir", matchScore, generated: true, depth: directory.depth - 1 });
+                await searchDir(directory.path, directory.depth, true);
+            }
+            results.sort((a, b) => Number(a.generated) - Number(b.generated)
+                || Number(b.name.toLowerCase() === queryLower) - Number(a.name.toLowerCase() === queryLower)
+                || a.depth - b.depth || a.matchScore - b.matchScore || a.name.localeCompare(b.name));
+            res.json({ results: results.slice(0, maxResults), query, cwd: resolvedCwd,
+                truncated: results.length > maxResults || visitedEntries >= maxVisitedEntries });
         }
         catch (error) {
             sendRouteError(res, error, "搜索失败。可能原因：路径不存在或权限不足。");

package/dist/server-local-model-routes.js

@@ -51,6 +51,18 @@ export function registerLocalModelRoutes(app, deps) {
             next(error);
         }
     });
+    app.patch("/api/local-models/speech/settings", deps.requireAdmin, async (req, res, next) => {
+        try {
+            if (!req.body || Array.isArray(req.body) || Object.keys(req.body).length !== 1 || typeof req.body.enabled !== "boolean") {
+                throw new DecisionError("INVALID_REQUEST", "仅允许修改语音启用状态。");
+            }
+            await deps.models.setSpeechEnabled(req.body.enabled);
+            res.status(202).json(await deps.models.status());
+        }
+        catch (error) {
+            next(error);
+        }
+    });
     const errors = (error, _req, res, _next) => {
         if (error instanceof DecisionError || error instanceof SpeechError) {
             res.status(error.status).json({ error: error.message, code: error.code });

package/dist/server-session-routes.d.ts

@@ -3,6 +3,7 @@ import { ProcessManager } from "./process-manager.js";
 import { StructuredSessionManager } from "./structured-session-manager.js";
 import { WandStorage } from "./storage.js";
 import { ExecutionMode, ProcessEvent, SessionSnapshot, SessionSource, WandConfig } from "./types.js";
+import type { OpenRouterFreeModelsService } from "./openrouter-free-models.js";
 import { toSessionListItemDTO } from "./session-transport.js";
 import { type ProviderHistoryDeleter, SessionRegistry } from "./session-registry.js";
 import { type PiRecommendationRuntime } from "./server-pi-recommendation-routes.js";
@@ -46,6 +47,6 @@ export interface SessionDirectoryTreeResponse {
 }
 export declare function buildSessionListPage(sessions: SessionSnapshot[], offset: number, limit: number): SessionListPage;
 export declare function buildSessionDirectoryTree(sessions: SessionSnapshot[], customNames?: ReadonlyMap<string, string>): SessionDirectoryTreeResponse;
-export declare function registerSessionRoutes(app: Express, processes: ProcessManager, structured: StructuredSessionManager, storage: WandStorage, defaultMode: ExecutionMode, config: WandConfig, sessions: SessionRegistry, onSessionCreated?: (cwd: string | undefined | null) => void, onCompletionViewed?: (event: ProcessEvent) => void, decisions?: PiRecommendationRuntime): void;
+export declare function registerSessionRoutes(app: Express, processes: ProcessManager, structured: StructuredSessionManager, storage: WandStorage, defaultMode: ExecutionMode, config: WandConfig, sessions: SessionRegistry, onSessionCreated?: (cwd: string | undefined | null) => void, onCompletionViewed?: (event: ProcessEvent) => void, decisions?: PiRecommendationRuntime, free?: Pick<OpenRouterFreeModelsService, "resolveForCall">): void;
 export declare function registerClaudeHistoryRoutes(app: Express, processes: ProcessManager, storage: WandStorage): void;
 export {};