@co0ontty/wand 1.21.5 → 1.21.7

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,
@@ -80,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 {

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,7 +724,7 @@ export async function startServer(config, configPath) {
             defaultMode: config.defaultMode,
             defaultCwd: config.defaultCwd,
             commandPresets: config.commandPresets,
-            structuredRunner: config.structuredRunner ?? "cli",
+            structuredRunner: config.structuredRunner ?? "sdk",
             structuredRunners: [
                 { label: "Claude Structured", runner: "claude-cli-print" },
                 { label: "Codex Structured", runner: "codex-cli-exec" },
@@ -816,64 +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", "structuredRunner"];
-        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() : "";
-                }
-                else if (field === "structuredRunner") {
-                    config.structuredRunner = body.structuredRunner === "sdk" ? "sdk" : "cli";
+        // 部署字段：写 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/storage.d.ts

@@ -16,6 +16,12 @@ export declare class WandStorage {
     setConfigValue(key: string, value: string): void;
     /** Delete a config value */
     deleteConfigValue(key: string): void;
+    /** 读取偏好。未设置或 JSON 解析失败时返回 fallback。 */
+    getPreference<T>(key: string, fallback: T): T;
+    /** 写入偏好。undefined / null 视为删除。 */
+    setPreference<T>(key: string, value: T | null | undefined): void;
+    /** 判断偏好是否在 DB 中存在（区别于值为 null/false/""）。 */
+    hasPreference(key: string): boolean;
     /** Get password from database */
     getPassword(): string | null;
     /** Set password in database */

package/dist/storage.js

@@ -261,6 +261,35 @@ export class WandStorage {
     deleteConfigValue(key) {
         this.db.prepare("DELETE FROM app_config WHERE key = ?").run(key);
     }
+    // ============ Preference Methods ============
+    // Preferences 与 getConfigValue/setConfigValue 共用 app_config 表，
+    // 区别在于：preference 自动 JSON 序列化/反序列化，并按"未设置时返回 fallback"语义返回。
+    // 用于存放 UI 设置面板可改的用户偏好（defaultMode/defaultModel/cardDefaults 等），
+    // 与 JSON 配置中的部署期参数（host/port/shell 等）分开。
+    /** 读取偏好。未设置或 JSON 解析失败时返回 fallback。 */
+    getPreference(key, fallback) {
+        const raw = this.getConfigValue(key);
+        if (raw === null)
+            return fallback;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return fallback;
+        }
+    }
+    /** 写入偏好。undefined / null 视为删除。 */
+    setPreference(key, value) {
+        if (value === undefined || value === null) {
+            this.deleteConfigValue(key);
+            return;
+        }
+        this.setConfigValue(key, JSON.stringify(value));
+    }
+    /** 判断偏好是否在 DB 中存在（区别于值为 null/false/""）。 */
+    hasPreference(key) {
+        return this.getConfigValue(key) !== null;
+    }
     /** Get password from database */
     getPassword() {
         return this.getConfigValue("password");