pi-web-ui 0.68.1 → 0.68.2

package/dist/server/agent-service.js

@@ -14,7 +14,7 @@ import { spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync, rmSync, statSync, mkdirSync, watch } from "node:fs";
-import { basename, dirname, join, resolve, sep } from "node:path";
+import { basename, delimiter, dirname, join, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, createBashTool, createLocalBashOperations, getAgentDir, SessionManager, VERSION, } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
@@ -35,7 +35,7 @@ import { WebUIContext, mockThemeProxy } from "./webui-context.js";
 import { makeEditSoftTool, SOFT_EDIT_TOOL_NAME } from "./edit-soft-tool.js";
 import { makeSubagentTools, subagentTitle, } from "./subagents.js";
 import { buildAttachmentMessages } from "./attachments.js";
-import { BUILTIN_SOUL, DEFAULT_PROMPT_TEMPLATE, renderPromptTemplate, resolveSectionTexts, } from "./prompt-composer.js";
+import { BUILTIN_SOUL, DEFAULT_PROMPT_TEMPLATE, buildToolsSchemaText, renderPromptTemplate, resolveSectionTexts, } from "./prompt-composer.js";
 import { serializeMessage, serializeStreamingMessage, stripTransientRetryErrors, } from "./serialize.js";
 import { loadCommands, saveCommandsFile, TerminalManager } from "./terminals.js";
 const SNAPSHOT_INTERVAL_MS = 60;
@@ -215,6 +215,67 @@ function makeMarkersListTool(getActiveId, markerSvc) {
         },
     };
 }
+/**
+ * 标准 pi 引擎的 ask_user_question 工具：模型调用时把问题桥到浏览器（复用 DSH
+ * 引擎的 question_pending/question_answer 协议，前端 DshQuestionDialog 富渲染），
+ * 阻塞 agent 循环直到用户在浏览器回答或取消。
+ *
+ * 标准 SDK 没有内建 ask_user_question，故由 pi-web-ui 以 customTool 注册（与
+ * bash/edit 同机制）。DSH 引擎走 goal-rpc 的 userQuestions provider，两者互不
+ * 冲突（各引擎各走各的）。
+ *
+ * askUser 签名带 {aborted} 快照而非完整 AbortSignal：customTool 的 execute 信号
+ * 服务于整个 agent 生命周期，这里按「已中止即拒绝」的最小语义处理，避免与其它
+ * 工具的取消逻辑纠缠。
+ */
+export function makeAskUserQuestionTool(clientSession) {
+    const QuestionOptionSchema = Type.Object({
+        label: Type.String({ description: "Display label for the option" }),
+        description: Type.Optional(Type.String({ description: "Optional description shown below label" })),
+        preview: Type.Optional(Type.String({
+            description: "Optional preview rendered below when this option is selected (markdown or HTML — use for mockups/code/config).",
+        })),
+    });
+    const QuestionSchema = Type.Object({
+        id: Type.String({ description: "Unique identifier for this question" }),
+        question: Type.String({ description: "The full question text to display (markdown/HTML ok)" }),
+        detail: Type.Optional(Type.String({ description: "Optional detail/context shown under the question" })),
+        header: Type.Optional(Type.String({ description: "Optional short header for this question" })),
+        options: Type.Optional(Type.Array(QuestionOptionSchema, { description: "Available options to choose from" })),
+        multiSelect: Type.Optional(Type.Boolean({ description: "Allow selecting multiple options (default: false)" })),
+    });
+    return {
+        name: "ask_user_question",
+        label: "Ask the user",
+        description: "Ask the user focused questions to pin down ambiguous requirements. Use for clarifying the task, confirming decisions, or getting preferences. Each question renders a browser dialog with markdown/HTML rich text; options may carry a `preview`. Submit or cancel to resume.",
+        parameters: Type.Object({
+            questions: Type.Array(QuestionSchema, { description: "Questions to ask the user" }),
+        }),
+        execute: async (_id, params, signal) => {
+            const qs = params.questions;
+            if (!Array.isArray(qs) || qs.length === 0) {
+                throw new Error("ask_user_question requires at least one question");
+            }
+            const answers = await clientSession.askUser(qs, {
+                aborted: signal?.aborted,
+            });
+            if (answers === null) {
+                throw new Error("用户取消了提问");
+            }
+            // 工具结果：把每道题的回答拼成简洁文本给模型，同时留 details 供 UI 展示。
+            const lines = answers.map((a) => {
+                const q = qs.find((q) => q.id === a.id);
+                const label = a.selected.join(", ");
+                const custom = a.custom?.trim() ? ` (wrote: ${a.custom.trim()})` : "";
+                return `${q?.header ?? q?.id ?? a.id}: ${label || "(no selection)"}${custom}`;
+            });
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+                details: { answers },
+            };
+        },
+    };
+}
 /**
  * 插件结构化工具 → SDK ToolDefinition。
  * execute 返回值宽容处理：{content,details} 原样收编；字符串/对象包成文本块。
@@ -868,6 +929,7 @@ export class ClientSession {
             const active = sess.getActiveToolNames();
             const snippets = {};
             const guidelines = [];
+            const schemaEntries = [];
             for (const name of active) {
                 const def = sess.getToolDefinition(name);
                 if (!def)
@@ -876,6 +938,11 @@ export class ClientSession {
                     snippets[name] = def.promptSnippet;
                 if (def.promptGuidelines)
                     guidelines.push(...def.promptGuidelines);
+                schemaEntries.push({
+                    name,
+                    description: def.description,
+                    parameters: def.parameters,
+                });
             }
             const loader = sess.resourceLoader;
             const texts = resolveSectionTexts(this.composeInputs({
@@ -895,7 +962,7 @@ export class ClientSession {
             const ovs = this.settingsSvc.current.promptOverrides ?? {};
             const hasOverride = Object.values(ovs).some((v) => typeof v === "string" && v.trim());
             const rendered = !tpl && !hasOverride ? undefined : renderPromptTemplate(tpl || DEFAULT_PROMPT_TEMPLATE, texts, ovs);
-            return { texts, full: rendered ?? sess.systemPrompt };
+            return { texts, full: rendered ?? sess.systemPrompt, toolsSchema: buildToolsSchemaText(schemaEntries) };
         }
         catch {
             // Session not ready yet.
@@ -905,7 +972,7 @@ export class ClientSession {
     /** 设置面板预览用的 host 回调（见 SettingsHost.promptSnapshot）：完整生效提示词
      *  + 各来源默认（自动）内容。会话未就绪时给空值，面板保持可编辑但不预览。 */
     promptSnapshot() {
-        return this.sessionPromptSnapshot() ?? { full: "", texts: {} };
+        return this.sessionPromptSnapshot() ?? { full: "", texts: {}, toolsSchema: "" };
     }
     /** Web-facing extension UI context (widgets, notifications). */
     webUi = new WebUIContext((msg) => this.emit(msg));
@@ -1000,6 +1067,14 @@ export class ClientSession {
     subagentTemplates;
     /** 内置标记服务（todo/notify/svc/rename 等，可全局/分组开关）。 */
     markerSvc;
+    // -----------------------------------------------------------------------
+    // 用户提问桥（标准 pi 引擎的 ask_user_question customTool）：与 DSH 引擎的
+    // question_pending/question_answer 同协议。模型调 ask_user_question 工具 →
+    // 本桥发 question_pending 给浏览器 → 等 question_answer → resolve/reject
+    // 工具结果（agent 循环阻塞）。一次只展示一个提问（agent 阻塞在工具执行）。
+    // -----------------------------------------------------------------------
+    questionSeq = 0;
+    pendingQuestions = new Map();
     constructor(clientId, cwd, agentDir, stateStore) {
         this.clientId = clientId;
         this.cwd = cwd;
@@ -1276,6 +1351,10 @@ export class ClientSession {
                     ...makeSubagentTools(this.subagentHost),
                     // 内置标记只读查询工具（todo/svc 状态查询，写操作走内联标记）。
                     makeMarkersListTool(() => this.activeId, this.markerSvc),
+                    // 标准引擎的 ask_user_question：模型调用 → 浏览器富渲染问卷（复用 DSH
+                    // 的 question_pending/question_answer 协议，前端 DshQuestionDialog）。
+                    // DSH 引擎不经此（它走 goal-rpc 的 userQuestions provider）。
+                    makeAskUserQuestionTool(this),
                 ],
             });
             // 终端工具开关从创建起就生效（工具始终注册进注册表，只调活跃集）。
@@ -2168,6 +2247,55 @@ export class ClientSession {
     resolveDialog(id, value) {
         this.webUi.resolveDialog(id, value);
     }
+    // -----------------------------------------------------------------------
+    // 用户提问桥（标准 pi 引擎 ask_user_question customTool）
+    // -----------------------------------------------------------------------
+    /** 标准引擎模型调 ask_user_question：发 question_pending 给浏览器并阻塞等待
+     *  question_answer。sig 为工具执行信号的当前状态（aborted → 立即 reject）。
+     *  返回 answers（用户选中/自定义），或 null（用户取消）。 */
+    askUser(questions, sig) {
+        return new Promise((resolve, reject) => {
+            if (sig?.aborted || this.disposed) {
+                reject(new Error("ask_user_question 已中止"));
+                return;
+            }
+            // 问卷开关（默认开）：关 → 不弹对话框，立即报错让模型得知已禁用。
+            if (this.settingsSvc.current.questionnaireEnabled === false) {
+                reject(new Error("问卷功能已关闭，可在设置中重新开启"));
+                return;
+            }
+            const id = `q-${++this.questionSeq}`;
+            this.pendingQuestions.set(id, resolve);
+            this.emit({
+                type: "question_pending",
+                id,
+                questions,
+            });
+        });
+    }
+    /** 前端回答模型提问（question_answer → 恢复 askUser 的 Promise）。id 需匹配
+     *  pendingQuestions 中键；cancelled 或未匹配（例如用户早已切走）时按「取消」处理
+     *  —— 把挂起的提问全部 reject，让模型知道用户离开了。 */
+    resolveQuestion(id, answers, cancelled) {
+        const resolve = this.pendingQuestions.get(id);
+        if (resolve) {
+            this.pendingQuestions.delete(id);
+            resolve(cancelled ? null : answers);
+        }
+    }
+    /** 标准引擎的 question_answer 路由入口（index.ts 经 cs.answerQuestion?. 转发）。
+     *  DSH 引擎的 AgentService 也实现了同名方法，此处为 ClientSession 的转发。 */
+    answerQuestion(id, answers, cancelled) {
+        this.resolveQuestion(id, answers, cancelled);
+        return Promise.resolve();
+    }
+    /** 关闭所有挂起提问（切对话 / dispose 时清理）：以「取消」解析，避免模型挂死。 */
+    cancelPendingQuestions() {
+        for (const [, resolve] of this.pendingQuestions) {
+            resolve(null);
+        }
+        this.pendingQuestions.clear();
+    }
     /**
      * Whether the pi agent has at least one usable model. ModelRuntime's
      * available snapshot already accounts for models.json, auth.json, env-var
@@ -2188,65 +2316,32 @@ export class ClientSession {
      * probe). Cached machine-wide (same binary for every client) for 10s —
      * the check is only rerun after install or when the cache expires.
      *
-     * The probe runs ASYNCHRONOUSLY in the background: this getter serves the
-     * last known value and never blocks the event loop. It previously used
-     * spawnSync here, which could deadlock the whole server on Android/Termux:
-     * fork() inside a multi-threaded process (websocket handlers + snapshot
-     * serialization are active) occasionally left the forked child stuck
-     * between fork and exec (futex_wait) while the blocked main thread sat in
-     * spawnSync's pipe_read — the server kept running but stopped accepting
-     * connections. Observed reproducibly on Android/Termux (Node 26).
+     * The probe is FORK-FREE: it scans PATH for the pi executable instead of
+     * spawning `pi --version`. Do not reintroduce a spawn here — ANY fork on
+     * the main thread of this multi-threaded server can deadlock the whole
+     * process on Android/Termux (issue #78): libuv's uv_spawn blocks its
+     * caller reading the child's error pipe, and that pipe never closes when
+     * the forked child deadlocks between fork and exec. This applies to
+     * asynchronous spawns too — the previous async probe reproduced the hang.
      */
     static piCliProbe = null;
-    static piCliProbePending = false;
     static PI_CLI_PROBE_TTL_MS = 10_000;
     isPiCliInstalled() {
         const now = Date.now();
         const cached = ClientSession.piCliProbe;
         if (cached && now - cached.at < ClientSession.PI_CLI_PROBE_TTL_MS)
             return cached.installed;
-        ClientSession.refreshPiCliProbe();
-        return cached?.installed ?? false;
+        const installed = ClientSession.piCliOnPath();
+        ClientSession.piCliProbe = { at: now, installed };
+        return installed;
     }
-    static refreshPiCliProbe() {
-        if (ClientSession.piCliProbePending)
-            return;
-        ClientSession.piCliProbePending = true;
-        let proc;
-        try {
-            proc = spawn("pi", ["--version"], {
-                stdio: "ignore",
-                // Windows: `pi` resolves to a pi.cmd shim — spawn can only
-                // exec those through a shell (else ENOENT).
-                shell: process.platform === "win32",
-            });
-        }
-        catch {
-            ClientSession.piCliProbe = { at: Date.now(), installed: false };
-            ClientSession.piCliProbePending = false;
-            return;
+    static piCliOnPath() {
+        const dirs = (process.env.PATH ?? "").split(delimiter);
+        for (const dir of dirs) {
+            if (dir && existsSync(join(dir, "pi")))
+                return true;
         }
-        const finish = (installed) => {
-            ClientSession.piCliProbe = { at: Date.now(), installed };
-            ClientSession.piCliProbePending = false;
-        };
-        const timer = setTimeout(() => {
-            try {
-                proc.kill();
-            }
-            catch {
-                /* already exited */
-            }
-            finish(false);
-        }, 5000);
-        proc.on("error", () => {
-            clearTimeout(timer);
-            finish(false);
-        });
-        proc.on("close", (code) => {
-            clearTimeout(timer);
-            finish(code === 0);
-        });
+        return false;
     }
     static invalidatePiCliProbe() {
         ClientSession.piCliProbe = null;
@@ -4327,6 +4422,8 @@ export class ClientSession {
         this.files.unwatchDir();
         this.files.unwatchGit();
         this.webUi.dispose();
+        // 关闭所有挂起的用户提问（dispose 时以「取消」解析，避免模型挂死）。
+        this.cancelPendingQuestions();
         this.bg.stop();
         for (const conv of this.convs.values()) {
             this.clearAllToolWatchdogs(conv);

package/dist/server/client-state.js

@@ -200,10 +200,11 @@ export class ClientStateStore {
             promptOverrides,
             disabledSkills: stored?.disabledSkills ?? [],
             disabledExtensions: stored?.disabledExtensions ?? [],
-            terminalToolsEnabled: stored?.terminalToolsEnabled ?? true,
+            terminalToolsEnabled: stored?.terminalToolsEnabled ?? false,
             terminalBash: stored?.terminalBash ?? false,
             terminalBashIdleMs: stored?.terminalBashIdleMs ?? 15_000,
             editSoftEnabled: stored?.editSoftEnabled ?? false,
+            questionnaireEnabled: stored?.questionnaireEnabled ?? true,
             thinkingWrap: stored?.thinkingWrap ?? false,
             toolsWrap: stored?.toolsWrap ?? true,
             visionBridgeEnabled: stored?.visionBridgeEnabled ?? true,
@@ -230,10 +231,11 @@ export class ClientStateStore {
             promptOverrides: { ...(settings.promptOverrides ?? cur.promptOverrides) },
             disabledSkills: settings.disabledSkills ?? cur.disabledSkills ?? [],
             disabledExtensions: settings.disabledExtensions ?? cur.disabledExtensions ?? [],
-            terminalToolsEnabled: settings.terminalToolsEnabled ?? cur.terminalToolsEnabled ?? true,
+            terminalToolsEnabled: settings.terminalToolsEnabled ?? cur.terminalToolsEnabled ?? false,
             terminalBash: settings.terminalBash ?? cur.terminalBash ?? false,
             terminalBashIdleMs: settings.terminalBashIdleMs ?? cur.terminalBashIdleMs ?? 15_000,
             editSoftEnabled: settings.editSoftEnabled ?? cur.editSoftEnabled ?? false,
+            questionnaireEnabled: settings.questionnaireEnabled ?? cur.questionnaireEnabled ?? true,
             thinkingWrap: settings.thinkingWrap ?? cur.thinkingWrap ?? false,
             toolsWrap: settings.toolsWrap ?? cur.toolsWrap ?? true,
             visionBridgeEnabled: settings.visionBridgeEnabled ?? cur.visionBridgeEnabled ?? true,

package/dist/server/dsh/dsh-agent-service.js

@@ -104,10 +104,11 @@ const DEFAULT_SETTINGS = {
     customSystemPrompt: "",
     disabledSkills: [],
     disabledExtensions: [],
-    terminalToolsEnabled: true,
+    terminalToolsEnabled: false,
     terminalBash: false,
     terminalBashIdleMs: 15_000,
     editSoftEnabled: false,
+    questionnaireEnabled: true,
     thinkingWrap: false,
     toolsWrap: true,
     disabledPlugins: [],
@@ -221,6 +222,7 @@ export class DshClientSession {
                 terminalBash: savedSettings.terminalBash,
                 terminalBashIdleMs: savedSettings.terminalBashIdleMs,
                 editSoftEnabled: savedSettings.editSoftEnabled,
+                questionnaireEnabled: savedSettings.questionnaireEnabled ?? true,
                 thinkingWrap: savedSettings.thinkingWrap,
                 toolsWrap: savedSettings.toolsWrap,
                 disabledPlugins: savedSettings.disabledPlugins ?? [],
@@ -443,6 +445,11 @@ export class DshClientSession {
                 else if (method === "question.pending") {
                     // 模型 ask_user_question → 转发给浏览器对话框（deadline = 服务端超时时间戳）。
                     const params0 = params;
+                    // 问卷开关（默认开）：关 → 不弹框，立即取消让模型得知已禁用。
+                    if (this.settings.questionnaireEnabled === false) {
+                        void this.answerQuestion(params0.id, [], true);
+                        return;
+                    }
                     this.emit({
                         type: "question_pending",
                         id: params0.id,
@@ -461,6 +468,7 @@ export class DshClientSession {
                                     options: q.options.map((o) => ({
                                         label: String(o.label ?? ""),
                                         ...(typeof o.description === "string" ? { description: o.description } : {}),
+                                        ...(typeof o.preview === "string" ? { preview: o.preview } : {}),
                                     })),
                                 }
                                 : {}),
@@ -2060,6 +2068,7 @@ export class DshClientSession {
             terminalBash: this.settings.terminalBash,
             terminalBashIdleMs: this.settings.terminalBashIdleMs,
             editSoftEnabled: this.settings.editSoftEnabled,
+            questionnaireEnabled: this.settings.questionnaireEnabled,
             thinkingWrap: this.settings.thinkingWrap,
             toolsWrap: this.settings.toolsWrap,
             visionBridgeEnabled: false,
@@ -2073,6 +2082,8 @@ export class DshClientSession {
             promptOverrides: {},
             effectiveSystemPrompt: this.settings.customSystemPrompt,
             promptSourceDefaults: {},
+            // DSH 引擎不接标准 pi 的 customTool 工具 schema（走 goal-rpc），此处给空。
+            toolsSchema: "",
             visionBridgeDefaultPrompt: "",
             visionModels: [],
             skills: this.skillsCache,
@@ -2108,6 +2119,8 @@ export class DshClientSession {
             this.settings.terminalBashIdleMs = partial.terminalBashIdleMs;
         if (partial.editSoftEnabled !== undefined)
             this.settings.editSoftEnabled = partial.editSoftEnabled;
+        if (partial.questionnaireEnabled !== undefined)
+            this.settings.questionnaireEnabled = partial.questionnaireEnabled;
         if (partial.thinkingWrap !== undefined)
             this.settings.thinkingWrap = partial.thinkingWrap;
         if (partial.toolsWrap !== undefined)
@@ -2135,6 +2148,7 @@ export class DshClientSession {
             terminalBash: this.settings.terminalBash,
             terminalBashIdleMs: this.settings.terminalBashIdleMs,
             editSoftEnabled: this.settings.editSoftEnabled,
+            questionnaireEnabled: this.settings.questionnaireEnabled,
             thinkingWrap: this.settings.thinkingWrap,
             toolsWrap: this.settings.toolsWrap,
             disabledPlugins: this.settings.disabledPlugins,

package/dist/server/dsh/runtime/runtime-root.mjs

@@ -66,18 +66,24 @@ export async function resolveRuntimeBase() {
 		const base = runtimeBaseFor(adjacent);
 		if (base) return base;
 	}
+	// PATCHED (pi-web-ui #78 / Android-Termux deadlock): this used to run
+	// spawnSync("npm", ["root", "-g"]) as a last resort — a synchronous fork
+	// inside a multi-threaded process, which can deadlock on Android/Termux
+	// (child stuck between fork and exec while the caller blocks on libuv's
+	// spawn error pipe). Compute the npm global root without spawning instead.
 	try {
-		const { spawnSync } = await import("node:child_process");
-		const res = spawnSync(process.platform === "win32" ? "npm" : "npm", ["root", "-g"], {
-			encoding: "utf8",
-			timeout: 15_000,
-			windowsHide: true,
-			...(process.platform === "win32" ? { shell: true } : {}),
-		});
-		const root = String(res.stdout ?? "").trim();
-		if (root) {
-			const base = runtimeBaseFor(root);
-			if (base) return base;
+		const prefixCandidates = [
+			process.env.NPM_CONFIG_PREFIX,
+			process.env.npm_config_prefix,
+			join(dirname(process.execPath), ".."),
+		];
+		for (const prefix of prefixCandidates) {
+			if (!prefix) continue;
+			for (const root of [join(prefix, "lib", "node_modules"), join(prefix, "node_modules")]) {
+				if (!existsSync(root)) continue;
+				const base = runtimeBaseFor(root);
+				if (base) return base;
+			}
 		}
 	} catch {
 		/* fall through */

package/dist/server/index.js

@@ -16,7 +16,7 @@
  *   all share one conversation list per project.
  *   PI_CODING_AGENT_DIR  pi config dir (auth/models/skills) — passed to the SDK
  */
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { stat } from "node:fs/promises";
 import { createServer } from "node:http";
 import { createConnection } from "node:net";
@@ -36,6 +36,7 @@ import { startControlServer } from "./control-socket.js";
 import { scheduleUploadCleanup } from "./uploads.js";
 import { ensureWindowsBash, windowsBashDir } from "./ensure-bash.js";
 import { listThemes, resolveThemeFile } from "./themes.js";
+import { installPack, isKnownPack, listPacks, readPackFile, removePack } from "./locales.js";
 import { PluginManager, resolvePluginClientFile, } from "./plugins.js";
 import { McpBridge } from "./mcp-bridge.js";
 /** 从 CLI 参数中取 flag 值：支持 --flag value 与 --flag=value 两种写法。
@@ -76,6 +77,19 @@ const ALLOW_ORIGINS = (process.env.PI_WEB_ALLOW_ORIGINS ?? "")
  *  Authorization: Bearer / X-PI-Token 头、?token= 查询参数或 pi_web_token cookie
  *  任一匹配即可；供 0.0.0.0 / 反代等暴露场景兜底，未设置则行为不变。 */
 const AUTH_TOKEN = process.env.PI_WEB_TOKEN?.trim() ?? "";
+/** 语言包下载根（语言包仓库的 raw 文件地址；版本 tag 优先、main 兜底，见 locales.ts）。 */
+const LOCALE_BASE_URL = process.env.PI_WEB_LOCALE_BASE_URL?.trim() || "https://raw.githubusercontent.com/xing-shuyin/pi-web-ui";
+/** 本包版本 —— 下载语言包时优先取同版本 tag，保证 key 对齐。 */
+const APP_VERSION = (() => {
+    try {
+        // 注意：此处不能用下面的 pkgRoot 常量（TDZ）——直接调函数声明（已提升）。
+        const pkg = JSON.parse(readFileSync(join(resolvePkgRoot(), "package.json"), "utf8"));
+        return pkg.version ?? "";
+    }
+    catch {
+        return "";
+    }
+})();
 // Root of the SDK default per-project session dirs — chat transcripts live in
 // <SESSION_DIR_ROOT>/--<cwd>--/, shared with the pi CLI/TUI (getAgentDir
 // honors PI_CODING_AGENT_DIR).
@@ -252,6 +266,51 @@ const USER_THEMES_DIR = join(DATA_DIR, "themes");
 app.get("/api/themes", (_req, res) => {
     res.json({ themes: listThemes(BUILTIN_THEMES_DIR, USER_THEMES_DIR) });
 });
+// 语言包：核心只随包发布中英，其余按需下载到 <dataDir>/locales/<code>.json。
+// 手工放进去的同名 JSON 也会被识别（离线安装）。PI_WEB_TOKEN 鉴权自动覆盖。
+app.get("/api/locales", (_req, res) => {
+    res.json({ packs: listPacks(DATA_DIR) });
+});
+app.get("/api/locales/:code", (req, res) => {
+    const code = String(req.params.code ?? "");
+    if (!isKnownPack(code)) {
+        res.status(404).end("unknown locale");
+        return;
+    }
+    const pack = readPackFile(DATA_DIR, code);
+    if (!pack) {
+        res.status(404).end("locale not installed");
+        return;
+    }
+    res.setHeader("Cache-Control", "no-cache");
+    res.json(pack);
+});
+app.post("/api/locales/:code/install", async (req, res) => {
+    const code = String(req.params.code ?? "");
+    if (!isKnownPack(code)) {
+        res.status(400).json({ error: `unknown locale: ${code}` });
+        return;
+    }
+    try {
+        const meta = await installPack(DATA_DIR, code, { baseUrl: LOCALE_BASE_URL, version: APP_VERSION });
+        res.json({ ok: true, ...meta });
+    }
+    catch (e) {
+        res.status(502).json({ error: e instanceof Error ? e.message : String(e) });
+    }
+});
+app.delete("/api/locales/:code", (req, res) => {
+    const code = String(req.params.code ?? "");
+    if (!isKnownPack(code)) {
+        res.status(404).end("unknown locale");
+        return;
+    }
+    if (!removePack(DATA_DIR, code)) {
+        res.status(404).end("locale not installed");
+        return;
+    }
+    res.json({ ok: true });
+});
 // Serve a theme's full CSS file so the frontend can swap the whole stylesheet.
 // Registered before the SPA catch-all below (otherwise it'd return index.html).
 app.get("/themes/:id.css", (req, res) => {
@@ -826,6 +885,7 @@ wss.on("connection", (ws) => {
                     terminalBash: msg.terminalBash,
                     terminalBashIdleMs: msg.terminalBashIdleMs,
                     editSoftEnabled: msg.editSoftEnabled,
+                    questionnaireEnabled: msg.questionnaireEnabled,
                     thinkingWrap: msg.thinkingWrap,
                     toolsWrap: msg.toolsWrap,
                     visionBridgeEnabled: msg.visionBridgeEnabled,