@co0ontty/wand 1.21.4 → 1.21.7

package/dist/claude-pty-bridge.d.ts

@@ -177,16 +177,11 @@ export declare class ClaudePtyBridge extends EventEmitter {
     private finalizeResponse;
     /**
      * Find the end index of the echoed user input in the PTY buffer.
-     * The echo may contain ANSI codes between characters.
-     * Returns the index after the last character of the echo.
+     * Returns 0 if the echo cannot be fully matched.
      *
-     * Matching strategy:
-     * - Keep every printable codepoint of `userInput` (anything that is not a
-     *   control char or whitespace) for comparison. The previous version dropped
-     *   common symbols like `/`, `(`, `:`, space — which made commands such as
-     *   `ls /tmp` mismatch and start parsing the chat response from a wrong offset.
-     * - In the buffer, skip ANSI escape sequences entirely, and skip whitespace
-     *   so wrapped echoes (line continuation, padded columns) still align.
+     * Why: ANSI escapes and whitespace can interleave the echoed characters
+     * (line wrapping, padding, color codes), so matching skips them while
+     * comparing every printable codepoint of `userInput` in order.
      */
     private findEchoEndIndex;
     private cleanForChat;

package/dist/claude-pty-bridge.js

@@ -7,14 +7,9 @@
  * 2. Structured messages for chat view (parsed)
  */
 import { EventEmitter } from "node:events";
-import { stripAnsi, isNoiseLine, appendWindow, normalizePromptText, hasExplicitConfirmSyntax, hasPermissionActionContext, scorePermissionLikelihood, FALLBACK_SCORE_THRESHOLD, isSlashCommandMenu, stripForEchoMatch, skipAnsiSequence } from "./pty-text-utils.js";
+import { stripAnsi, isNoiseLine, appendWindow, normalizePromptText, hasExplicitConfirmSyntax, hasPermissionActionContext, scorePermissionLikelihood, FALLBACK_SCORE_THRESHOLD, isSlashCommandMenu, stripForEchoMatch, skipAnsiSequence, PTY_OUTPUT_MAX_SIZE } from "./pty-text-utils.js";
 // ── Constants ──
-/**
- * Hard cap on the in-memory PTY replay buffer. Aligned with the non-bridge
- * branch of `ProcessManager.start()` so a session keeps the same amount of
- * history regardless of which capture path is active.
- */
-const OUTPUT_MAX_SIZE = 200000;
+const OUTPUT_MAX_SIZE = PTY_OUTPUT_MAX_SIZE;
 const SESSION_ID_WINDOW_SIZE = 16384;
 const PERMISSION_WINDOW_SIZE = 2000;
 const AUTO_APPROVE_DELAY_MS = 350;
@@ -835,16 +830,11 @@ export class ClaudePtyBridge extends EventEmitter {
     // ── Text Processing Utilities ──
     /**
      * Find the end index of the echoed user input in the PTY buffer.
-     * The echo may contain ANSI codes between characters.
-     * Returns the index after the last character of the echo.
+     * Returns 0 if the echo cannot be fully matched.
      *
-     * Matching strategy:
-     * - Keep every printable codepoint of `userInput` (anything that is not a
-     *   control char or whitespace) for comparison. The previous version dropped
-     *   common symbols like `/`, `(`, `:`, space — which made commands such as
-     *   `ls /tmp` mismatch and start parsing the chat response from a wrong offset.
-     * - In the buffer, skip ANSI escape sequences entirely, and skip whitespace
-     *   so wrapped echoes (line continuation, padded columns) still align.
+     * Why: ANSI escapes and whitespace can interleave the echoed characters
+     * (line wrapping, padding, color codes), so matching skips them while
+     * comparing every printable codepoint of `userInput` in order.
      */
     findEchoEndIndex(buffer, userInput) {
         const inputChars = stripForEchoMatch(userInput);

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env -S node --disable-warning=ExperimentalWarning
 import process from "node:process";
-import { ensureConfig, hasConfigFile, isExecutionMode, resolveConfigPath, saveConfig } from "./config.js";
+import { hasConfigFile, isPreferenceKey, loadConfigWithStorage, resolveConfigPath, saveConfig, writePreferenceToStorage, } from "./config.js";
 async function main() {
     const args = process.argv.slice(2);
     const command = args[0] || "help";
@@ -50,8 +50,18 @@ async function main() {
             break;
         }
         case "config:show": {
-            const config = await ensureConfig(configPath);
-            process.stdout.write(`${JSON.stringify(config, null, 2)}\n`);
+            // 展示合并后的视图（JSON 部署字段 + DB 偏好字段）。
+            const { ensureDatabaseFile, resolveDatabasePath, WandStorage } = await import("./storage.js");
+            const dbPath = resolveDatabasePath(configPath);
+            ensureDatabaseFile(dbPath);
+            const storage = new WandStorage(dbPath);
+            try {
+                const config = await loadConfigWithStorage(configPath, storage);
+                process.stdout.write(`${JSON.stringify(config, null, 2)}\n`);
+            }
+            finally {
+                storage.close();
+            }
             break;
         }
         case "config:set": {
@@ -60,10 +70,26 @@ async function main() {
             if (!key || typeof value === "undefined") {
                 throw new Error("Usage: wand config:set <key> <value>");
             }
-            const config = await ensureConfig(configPath);
-            const nextConfig = setConfigValue(config, key, value);
-            await saveConfig(configPath, nextConfig);
-            process.stdout.write(`[wand] Updated ${key} in ${configPath}\n`);
+            const { ensureDatabaseFile, resolveDatabasePath, WandStorage } = await import("./storage.js");
+            const dbPath = resolveDatabasePath(configPath);
+            ensureDatabaseFile(dbPath);
+            const storage = new WandStorage(dbPath);
+            try {
+                const config = await loadConfigWithStorage(configPath, storage);
+                if (isPreferenceKey(key)) {
+                    // 偏好字段写 DB，无需重启
+                    writePreferenceToStorage(config, storage, key, value);
+                    process.stdout.write(`[wand] Updated preference ${key} in ${dbPath}\n`);
+                }
+                else {
+                    const nextConfig = setConfigValue(config, key, value);
+                    await saveConfig(configPath, nextConfig);
+                    process.stdout.write(`[wand] Updated ${key} in ${configPath}\n`);
+                }
+            }
+            finally {
+                storage.close();
+            }
             break;
         }
         case "help":
@@ -95,11 +121,19 @@ Options:
 `);
 }
 async function ensureRequiredFiles(configPath, opts = {}) {
-    const { ensureDatabaseFile, resolveDatabasePath } = await import("./storage.js");
+    const { ensureDatabaseFile, resolveDatabasePath, WandStorage } = await import("./storage.js");
     const dbPath = resolveDatabasePath(configPath);
     const hadConfig = hasConfigFile(configPath);
-    const config = await ensureConfig(configPath);
+    // 先建 DB 文件，再加载 config（loadConfigWithStorage 需要 storage 来迁移老 JSON 偏好字段并应用 DB 覆盖）。
     const createdDb = ensureDatabaseFile(dbPath);
+    const storage = new WandStorage(dbPath);
+    let config;
+    try {
+        config = await loadConfigWithStorage(configPath, storage);
+    }
+    finally {
+        storage.close();
+    }
     // 已存在的 ready 信息在 TUI 模式下由启动 banner 统一展示，此处静默；
     // 但 created 是首次创建事件，无论 TUI 与否都值得提示。
     if (!hadConfig) {
@@ -153,11 +187,11 @@ function printStartupBanner(handle) {
     process.stdout.write(lines.join("\n") + "\n");
 }
 function setConfigValue(config, key, value) {
+    // 偏好字段（defaultMode/defaultCwd/...）由调用方分流到 storage，这里只处理 JSON 字段。
     switch (key) {
         case "host":
         case "password":
         case "shell":
-        case "defaultCwd":
             return {
                 ...config,
                 [key]: value
@@ -170,14 +204,6 @@ function setConfigValue(config, key, value) {
                 ...config,
                 port: Number(value)
             };
-        case "defaultMode":
-            if (!isExecutionMode(value)) {
-                throw new Error(`defaultMode must be one of: assist, agent, agent-max, auto-edit, default, full-access, managed, native`);
-            }
-            return {
-                ...config,
-                defaultMode: value
-            };
         case "https":
             if (value !== "true" && value !== "false") {
                 throw new Error("https must be 'true' or 'false'");

package/dist/config.d.ts

@@ -1,9 +1,43 @@
 import { CardExpandDefaults, ExecutionMode, WandConfig } from "./types.js";
+import type { WandStorage } from "./storage.js";
+/**
+ * 通过 UI 设置面板可改的"用户偏好"字段。这些字段从 SQLite app_config 表读取，
+ * 不再写入 ~/.wand/config.json。JSON 只保留服务部署/启动期参数（host/port/shell 等）。
+ *
+ * 升级路径：老 JSON 里仍存有这些字段时，首次启动会被搬到 DB（见 migrateLegacyPreferencesToDb），
+ * 然后下一次 saveConfig 写回 JSON 时它们会被剥离（见 stripPreferenceFields）。
+ */
+export declare const PREFERENCE_KEYS: readonly ["defaultMode", "defaultCwd", "defaultModel", "structuredRunner", "language", "cardDefaults"];
+export type PreferenceKey = (typeof PREFERENCE_KEYS)[number];
+export declare function isPreferenceKey(key: string): key is PreferenceKey;
 export declare const defaultConfig: () => WandConfig;
 export declare function resolveConfigPath(inputPath?: string): string;
 export declare function resolveConfigDir(configPath: string): string;
 export declare function hasConfigFile(configPath: string): boolean;
 export declare function ensureConfig(configPath: string): Promise<WandConfig>;
+/** saveConfig 写出时去掉偏好字段——这些已经移到 SQLite。 */
 export declare function saveConfig(configPath: string, config: WandConfig): Promise<void>;
+/**
+ * 启动期合并 JSON + DB 偏好。语义：
+ *   1. 读 raw JSON
+ *   2. 把 JSON 中残留的偏好字段搬到 DB（只在 DB 没值时迁移）
+ *   3. mergeWithDefaults(raw) 得到 baseline
+ *   4. applyStoragePreferences 用 DB 覆盖 baseline 的偏好字段
+ *   5. 如果 JSON 里仍含偏好字段（来自 1），用 saveConfig 重写一次 JSON（剥离后）
+ */
+export declare function loadConfigWithStorage(configPath: string, storage: WandStorage): Promise<WandConfig>;
+/**
+ * 老版本 JSON 里如果还存有偏好字段，且 DB 里对应 key 没有写过，
+ * 把 JSON 的值搬到 DB。注意：必须在 mergeWithDefaults 之前操作 raw input，
+ * 这样能区分"用户显式写过 X" 和 "X 是 mergeWithDefaults 注入的默认值"。
+ */
+export declare function migrateLegacyPreferencesToDb(rawJsonInput: Partial<WandConfig> | null | undefined, storage: WandStorage): void;
+/**
+ * 用 DB 里的偏好覆盖 config 对象（in-place），返回同一个引用，
+ * 方便各 manager 持有引用后继续工作。DB 里没有的字段不动，保留 JSON 默认值。
+ */
+export declare function applyStoragePreferences(config: WandConfig, storage: WandStorage): WandConfig;
+/** 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 normalizeCardDefaults(input: unknown): CardExpandDefaults;
 export declare function isExecutionMode(value: unknown): value is ExecutionMode;

package/dist/config.js

@@ -5,6 +5,28 @@ import path from "node:path";
 import process from "node:process";
 const DEFAULT_CONFIG_DIR = ".wand";
 const DEFAULT_CONFIG_FILE = "config.json";
+/**
+ * 通过 UI 设置面板可改的"用户偏好"字段。这些字段从 SQLite app_config 表读取，
+ * 不再写入 ~/.wand/config.json。JSON 只保留服务部署/启动期参数（host/port/shell 等）。
+ *
+ * 升级路径：老 JSON 里仍存有这些字段时，首次启动会被搬到 DB（见 migrateLegacyPreferencesToDb），
+ * 然后下一次 saveConfig 写回 JSON 时它们会被剥离（见 stripPreferenceFields）。
+ */
+export const PREFERENCE_KEYS = [
+    "defaultMode",
+    "defaultCwd",
+    "defaultModel",
+    "structuredRunner",
+    "language",
+    "cardDefaults",
+];
+const PREFERENCE_KEY_SET = new Set(PREFERENCE_KEYS);
+function preferenceStorageKey(key) {
+    return `pref:${key}`;
+}
+export function isPreferenceKey(key) {
+    return PREFERENCE_KEY_SET.has(key);
+}
 export const defaultConfig = () => ({
     host: "127.0.0.1",
     port: 8443,
@@ -20,6 +42,7 @@ export const defaultConfig = () => ({
     android: defaultAndroidApkConfig(),
     cardDefaults: defaultCardExpandDefaults(),
     defaultModel: "",
+    structuredRunner: "cli",
     commandPresets: [
         {
             label: "Claude",
@@ -79,9 +102,149 @@ export async function ensureConfig(configPath) {
         return config;
     }
 }
+/** saveConfig 写出时去掉偏好字段——这些已经移到 SQLite。 */
 export async function saveConfig(configPath, config) {
     await mkdir(path.dirname(configPath), { recursive: true });
-    await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+    await writeFile(configPath, `${JSON.stringify(stripPreferenceFields(config), null, 2)}\n`, "utf8");
+}
+/**
+ * 启动期合并 JSON + DB 偏好。语义：
+ *   1. 读 raw JSON
+ *   2. 把 JSON 中残留的偏好字段搬到 DB（只在 DB 没值时迁移）
+ *   3. mergeWithDefaults(raw) 得到 baseline
+ *   4. applyStoragePreferences 用 DB 覆盖 baseline 的偏好字段
+ *   5. 如果 JSON 里仍含偏好字段（来自 1），用 saveConfig 重写一次 JSON（剥离后）
+ */
+export async function loadConfigWithStorage(configPath, storage) {
+    const dir = path.dirname(configPath);
+    await mkdir(dir, { recursive: true });
+    let rawInput = {};
+    let hadFile = false;
+    try {
+        const raw = await readFile(configPath, "utf8");
+        rawInput = JSON.parse(raw);
+        hadFile = true;
+    }
+    catch {
+        rawInput = {};
+    }
+    migrateLegacyPreferencesToDb(rawInput, storage);
+    const config = mergeWithDefaults(rawInput);
+    applyStoragePreferences(config, storage);
+    // 如果 JSON 里有偏好字段（说明是老版本配置或刚迁移），重写一次干净版本
+    const hasLegacyPrefs = PREFERENCE_KEYS.some((key) => key in rawInput);
+    if (!hadFile || hasLegacyPrefs) {
+        await saveConfig(configPath, config);
+    }
+    return config;
+}
+/** Build a JSON-safe view of WandConfig that excludes preference fields (which live in DB). */
+function stripPreferenceFields(config) {
+    const out = { ...config };
+    for (const key of PREFERENCE_KEYS) {
+        delete out[key];
+    }
+    return out;
+}
+/**
+ * 老版本 JSON 里如果还存有偏好字段，且 DB 里对应 key 没有写过，
+ * 把 JSON 的值搬到 DB。注意：必须在 mergeWithDefaults 之前操作 raw input，
+ * 这样能区分"用户显式写过 X" 和 "X 是 mergeWithDefaults 注入的默认值"。
+ */
+export function migrateLegacyPreferencesToDb(rawJsonInput, storage) {
+    if (!rawJsonInput || typeof rawJsonInput !== "object")
+        return;
+    for (const key of PREFERENCE_KEYS) {
+        if (!(key in rawJsonInput))
+            continue;
+        const value = rawJsonInput[key];
+        if (value === undefined)
+            continue;
+        const dbKey = preferenceStorageKey(key);
+        if (storage.hasPreference(dbKey))
+            continue;
+        storage.setPreference(dbKey, value);
+    }
+}
+/**
+ * 用 DB 里的偏好覆盖 config 对象（in-place），返回同一个引用，
+ * 方便各 manager 持有引用后继续工作。DB 里没有的字段不动，保留 JSON 默认值。
+ */
+export function applyStoragePreferences(config, storage) {
+    const defaults = defaultConfig();
+    if (storage.hasPreference(preferenceStorageKey("defaultMode"))) {
+        const v = storage.getPreference(preferenceStorageKey("defaultMode"), defaults.defaultMode);
+        if (isExecutionMode(v))
+            config.defaultMode = v;
+    }
+    if (storage.hasPreference(preferenceStorageKey("defaultCwd"))) {
+        const v = storage.getPreference(preferenceStorageKey("defaultCwd"), defaults.defaultCwd);
+        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("structuredRunner"))) {
+        const v = storage.getPreference(preferenceStorageKey("structuredRunner"), defaults.structuredRunner ?? "sdk");
+        if (v === "cli" || v === "sdk")
+            config.structuredRunner = v;
+    }
+    if (storage.hasPreference(preferenceStorageKey("language"))) {
+        const v = storage.getPreference(preferenceStorageKey("language"), defaults.language ?? "");
+        if (typeof v === "string")
+            config.language = v.trim();
+    }
+    if (storage.hasPreference(preferenceStorageKey("cardDefaults"))) {
+        const v = storage.getPreference(preferenceStorageKey("cardDefaults"), defaults.cardDefaults);
+        config.cardDefaults = normalizeCardDefaults(v);
+    }
+    return config;
+}
+/** 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);
+    switch (key) {
+        case "defaultMode": {
+            if (!isExecutionMode(value))
+                throw new Error(`无效执行模式: ${value}`);
+            storage.setPreference(dbKey, value);
+            config.defaultMode = value;
+            break;
+        }
+        case "defaultCwd": {
+            const v = typeof value === "string" ? value : "";
+            storage.setPreference(dbKey, v);
+            config.defaultCwd = v || defaultConfig().defaultCwd;
+            break;
+        }
+        case "defaultModel": {
+            const v = typeof value === "string" ? value.trim() : "";
+            storage.setPreference(dbKey, v);
+            config.defaultModel = v;
+            break;
+        }
+        case "structuredRunner": {
+            const v = value === "cli" ? "cli" : "sdk";
+            storage.setPreference(dbKey, v);
+            config.structuredRunner = v;
+            break;
+        }
+        case "language": {
+            const v = typeof value === "string" ? value.trim() : "";
+            storage.setPreference(dbKey, v);
+            config.language = v;
+            break;
+        }
+        case "cardDefaults": {
+            const normalized = normalizeCardDefaults(value);
+            storage.setPreference(dbKey, normalized);
+            config.cardDefaults = normalized;
+            break;
+        }
+    }
 }
 function defaultCardExpandDefaults() {
     return {
@@ -185,6 +348,7 @@ function mergeWithDefaults(input) {
         android: normalizeAndroidApkConfig(input.android) ?? defaults.android,
         cardDefaults: normalizeCardDefaults(input.cardDefaults),
         defaultModel: typeof input.defaultModel === "string" ? input.defaultModel.trim() : defaults.defaultModel,
+        structuredRunner: (input.structuredRunner === "sdk" || input.structuredRunner === "cli") ? input.structuredRunner : defaults.structuredRunner,
     };
 }
 export function isExecutionMode(value) {

package/dist/process-manager.js

@@ -8,7 +8,7 @@ import pty from "node-pty";
 import { SessionLogger } from "./session-logger.js";
 import { ClaudePtyBridge } from "./claude-pty-bridge.js";
 import { truncateMessagesForTransport } from "./message-truncator.js";
-import { appendWindow, hasExplicitConfirmSyntax, hasPermissionActionContext, normalizePromptText } from "./pty-text-utils.js";
+import { appendWindow, hasExplicitConfirmSyntax, hasPermissionActionContext, normalizePromptText, PTY_OUTPUT_MAX_SIZE } from "./pty-text-utils.js";
 import { prepareSessionWorktree } from "./git-worktree.js";
 import { getResumeCommandSessionId } from "./resume-policy.js";
 function resolveProviderFromCommand(command) {
@@ -744,7 +744,7 @@ export class ProcessManager extends EventEmitter {
                 rec.output = rec.ptyBridge.getRawOutput();
             }
             else {
-                rec.output = appendWindow(rec.output, chunk, 200_000);
+                rec.output = appendWindow(rec.output, chunk, PTY_OUTPUT_MAX_SIZE);
             }
             this.logger.appendPtyOutput(id, chunk);
             if (!rec.ptyBridge) {

package/dist/pty-text-utils.d.ts

@@ -1,6 +1,12 @@
 /**
  * Shared PTY text processing utilities for consistent ANSI stripping and noise filtering.
  */
+/**
+ * Hard cap on the in-memory PTY replay buffer. Shared between ProcessManager
+ * and ClaudePtyBridge so a session keeps the same amount of history regardless
+ * of which capture path is active.
+ */
+export declare const PTY_OUTPUT_MAX_SIZE = 200000;
 /** Strip ANSI escape sequences and control characters from raw PTY output. */
 export declare function stripAnsi(text: string): string;
 /** Lines considered as UI noise that should be excluded from chat view. */

package/dist/pty-text-utils.js

@@ -1,6 +1,12 @@
 /**
  * Shared PTY text processing utilities for consistent ANSI stripping and noise filtering.
  */
+/**
+ * Hard cap on the in-memory PTY replay buffer. Shared between ProcessManager
+ * and ClaudePtyBridge so a session keeps the same amount of history regardless
+ * of which capture path is active.
+ */
+export const PTY_OUTPUT_MAX_SIZE = 200_000;
 /** Strip ANSI escape sequences and control characters from raw PTY output. */
 export function stripAnsi(text) {
     return text

package/dist/server-session-routes.js

@@ -207,13 +207,19 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
     app.post("/api/structured-sessions/:id/messages", express.json(), async (req, res) => {
         const input = String(req.body?.input ?? "");
         const interrupt = !!req.body?.interrupt;
-        console.log("[WAND] POST /api/structured-sessions/:id/messages id:", req.params.id, "input:", input.substring(0, 50), "interrupt:", interrupt);
+        const idempotencyKey = typeof req.body?.idempotencyKey === "string" ? req.body.idempotencyKey : undefined;
+        console.log("[WAND] POST /api/structured-sessions/:id/messages id:", req.params.id, "input:", input.substring(0, 50), "interrupt:", interrupt, "idempotencyKey:", idempotencyKey);
         try {
-            const snapshot = await structured.sendMessage(req.params.id, input, { interrupt });
+            const snapshot = await structured.sendMessage(req.params.id, input, { interrupt, idempotencyKey });
             res.json(snapshot);
         }
         catch (error) {
-            res.status(400).json({ error: getErrorMessage(error, "无法发送结构化消息。") });
+            const errorCode = error?.code;
+            const status = errorCode === "duplicate_idempotency_key" ? 409 : 400;
+            res.status(status).json({
+                error: getErrorMessage(error, "无法发送结构化消息。"),
+                errorCode,
+            });
         }
     });
     // ── Tool content lazy-load endpoint ──

package/dist/server.js

@@ -13,7 +13,7 @@ import { WebSocketServer } from "ws";
 import { ensureAvatarSeed, getAvatarSvg } from "./avatar.js";
 import { createSession, revokeSession, setAuthStorage, validateSession } from "./auth.js";
 import { ensureCertificates } from "./cert.js";
-import { isExecutionMode, normalizeCardDefaults, resolveConfigDir, saveConfig } from "./config.js";
+import { isExecutionMode, PREFERENCE_KEYS, resolveConfigDir, saveConfig, writePreferenceToStorage, } from "./config.js";
 import { getCachedModels, refreshModels } from "./models.js";
 import { ProcessManager } from "./process-manager.js";
 import { SessionLogger } from "./session-logger.js";
@@ -724,6 +724,7 @@ export async function startServer(config, configPath) {
             defaultMode: config.defaultMode,
             defaultCwd: config.defaultCwd,
             commandPresets: config.commandPresets,
+            structuredRunner: config.structuredRunner ?? "sdk",
             structuredRunners: [
                 { label: "Claude Structured", runner: "claude-cli-print" },
                 { label: "Codex Structured", runner: "codex-cli-exec" },
@@ -815,61 +816,61 @@ export async function startServer(config, configPath) {
     });
     app.post("/api/settings/config", async (req, res) => {
         const body = req.body;
-        const allowedFields = ["host", "port", "https", "defaultMode", "defaultCwd", "shell", "language", "defaultModel"];
-        let changed = false;
-        for (const field of allowedFields) {
-            if (field in body && body[field] !== undefined) {
-                if (field === "port") {
-                    const p = Number(body.port);
-                    if (!Number.isInteger(p) || p < 1 || p > 65535) {
-                        res.status(400).json({ error: `无效端口号: ${body.port}` });
-                        return;
-                    }
-                    config.port = p;
-                }
-                else if (field === "https") {
-                    config.https = body.https === true;
-                }
-                else if (field === "defaultMode") {
-                    if (!isExecutionMode(body.defaultMode)) {
-                        res.status(400).json({ error: `无效执行模式: ${body.defaultMode}` });
-                        return;
-                    }
-                    config.defaultMode = body.defaultMode;
-                }
-                else if (field === "host") {
-                    config.host = String(body.host);
-                }
-                else if (field === "defaultCwd") {
-                    config.defaultCwd = String(body.defaultCwd);
-                }
-                else if (field === "shell") {
-                    config.shell = String(body.shell);
-                }
-                else if (field === "language") {
-                    config.language = typeof body.language === "string" ? body.language.trim() : "";
-                }
-                else if (field === "defaultModel") {
-                    config.defaultModel = typeof body.defaultModel === "string" ? body.defaultModel.trim() : "";
+        // 部署字段：写 JSON，需要重启服务才生效（host/port/https 影响监听，shell 影响新 PTY）
+        const deployFields = ["host", "port", "https", "shell"];
+        let touchedDeployField = false;
+        let touchedPreferenceField = false;
+        for (const field of deployFields) {
+            if (!(field in body) || body[field] === undefined)
+                continue;
+            if (field === "port") {
+                const p = Number(body.port);
+                if (!Number.isInteger(p) || p < 1 || p > 65535) {
+                    res.status(400).json({ error: `无效端口号: ${body.port}` });
+                    return;
                 }
-                changed = true;
+                config.port = p;
             }
+            else if (field === "https") {
+                config.https = body.https === true;
+            }
+            else if (field === "host") {
+                config.host = String(body.host);
+            }
+            else if (field === "shell") {
+                config.shell = String(body.shell);
+            }
+            touchedDeployField = true;
         }
-        // Handle cardDefaults separately (nested object, no restart needed)
-        if (body.cardDefaults !== undefined) {
-            config.cardDefaults = normalizeCardDefaults(body.cardDefaults);
-            changed = true;
+        // 偏好字段：写 SQLite app_config，立即热生效（manager 持有 config 同一引用）。
+        // defaultMode 单独做严格校验以保留 400 错误响应，其余字段走 writePreferenceToStorage 的统一类型化处理。
+        if (body.defaultMode !== undefined && !isExecutionMode(body.defaultMode)) {
+            res.status(400).json({ error: `无效执行模式: ${body.defaultMode}` });
+            return;
         }
-        if (!changed) {
+        for (const field of PREFERENCE_KEYS) {
+            if (!(field in body) || body[field] === undefined)
+                continue;
+            try {
+                writePreferenceToStorage(config, storage, field, body[field]);
+            }
+            catch (err) {
+                res.status(400).json({ error: getErrorMessage(err, `字段 ${field} 校验失败`) });
+                return;
+            }
+            touchedPreferenceField = true;
+        }
+        if (!touchedDeployField && !touchedPreferenceField) {
             res.status(400).json({ error: "没有可更新的配置字段。" });
             return;
         }
-        // cardDefaults-only changes don't need restart
-        const restartRequired = allowedFields.some((f) => f in body && body[f] !== undefined);
         try {
-            await saveConfig(configPath, config);
+            if (touchedDeployField) {
+                await saveConfig(configPath, config);
+            }
             const { password: _pw, ...safeConfig } = config;
-            res.json({ ok: true, config: safeConfig, restartRequired });
+            // 只有部署字段才需要重启；偏好字段已经热生效。
+            res.json({ ok: true, config: safeConfig, restartRequired: touchedDeployField });
         }
         catch (error) {
             res.status(500).json({ error: getErrorMessage(error, "保存配置失败。") });

package/dist/session-logger.d.ts

@@ -35,6 +35,8 @@ export interface ShortcutLogContext {
 export declare class SessionLogger {
     private readonly baseDir;
     private readonly dirs;
+    /** Cached on-disk size of hot-path log files so we can rotate without stat'ing on every chunk. */
+    private readonly logSizes;
     private readonly shortcutLogMaxBytes;
     constructor(configDir: string, shortcutLogMaxBytes?: number);
     private ensureDir;
@@ -67,6 +69,6 @@ export declare class SessionLogger {
     deleteSession(sessionId: string): void;
     /** Append a shortcut key interaction log entry (for analyzing auto-confirm gaps) */
     appendShortcutLog(sessionId: string, shortcutKey: string, tailLines: string, ctx?: ShortcutLogContext): void;
-    /** Truncate shortcut log by keeping only the most recent half of entries */
+    /** Truncate shortcut log by keeping only the most recent half of entries. Returns the new on-disk size. */
     private truncateShortcutLog;
 }