@youweichen/pi-web-ui 0.45.0

package/dist/server/settings-service.js

@@ -0,0 +1,395 @@
+/**
+ * Settings service — 从 agent-service.ts 抽出（系统提示词 / 技能插件开关 /
+ * 目标审查提示词 / 预设 / 视觉桥偏好）。设置持久化在 client-state.json 按客户端隔离。
+ *
+ * 经 SettingsHost 回调与 ClientSession 解耦：本模块只管「设置状态 + 面板推送 +
+ * 预设存取 + 何时需要 reload」，真正动 runtime 的 session.reload() 走宿主回调
+ * （reloadSession 里还会刷新斜杠命令目录）。
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+import { extensionKey } from "./client-state.js";
+import { findVisionModels, SYSTEM_PROMPT } from "./vision-bridge.js";
+export class SettingsService {
+    host;
+    settings;
+    presets;
+    knownSkills = new Map();
+    knownExtensions = new Map();
+    /** 流式中改了需要 reload 的设置 → agent_end 后延迟应用（防拆毁运行中 run）。 */
+    pendingReload = false;
+    constructor(host) {
+        this.host = host;
+        this.settings = host.stateStore.getSettings(host.clientId);
+        this.presets = host.stateStore.getPresets(host.clientId);
+    }
+    get current() {
+        return this.settings;
+    }
+    get reviewPrefs() {
+        return {
+            reviewPrompt: this.settings.reviewPrompt,
+            reviewDisabledSkills: this.settings.reviewDisabledSkills,
+        };
+    }
+    hasPendingReload() {
+        return this.pendingReload;
+    }
+    consumePendingReload() {
+        const v = this.pendingReload;
+        this.pendingReload = false;
+        return v;
+    }
+    /** 判断某个 skill 名是否仍存在于磁盘任何来源（agent 区 / 项目 .pi / 祖先
+     *  .agents/skills / npm 包内 skills）。被禁用且文件已删除的名字不应再
+     *  出现在设置面板，也不应留在持久化记录里。 */
+    skillStillOnDisk(name) {
+        const cwd = this.host.cwd();
+        const agentDir = this.host.agentDir();
+        const check = (base) => existsSync(join(base, name)) || existsSync(join(base, `${name}.md`));
+        // ① 用户区 <agentDir>/skills ② 项目 .pi/skills
+        if (check(join(agentDir, "skills")))
+            return true;
+        if (check(join(cwd, ".pi", "skills")))
+            return true;
+        // ③ 祖先链 .agents/skills（SDK collectAncestorAgentsSkillDirs 语义，最多上溯 6 层）
+        let dir = cwd;
+        for (let i = 0; i < 6 && dir !== dirname(dir); i++, dir = dirname(dir)) {
+            if (check(join(dir, ".agents", "skills")))
+                return true;
+        }
+        // ④ npm 包内 skills（agent 级 + 项目级，含 @scope 两级子包）
+        for (const npmRoot of [
+            join(agentDir, "npm", "node_modules"),
+            join(cwd, ".pi", "npm", "node_modules"),
+        ]) {
+            try {
+                for (const entry of readdirSync(npmRoot, { withFileTypes: true })) {
+                    if (!entry.isDirectory())
+                        continue;
+                    if (!entry.name.startsWith("@")) {
+                        if (check(join(npmRoot, entry.name, "skills")))
+                            return true;
+                    }
+                    else {
+                        for (const sub of readdirSync(join(npmRoot, entry.name), { withFileTypes: true })) {
+                            if (sub.isDirectory() && check(join(npmRoot, entry.name, sub.name, "skills"))) {
+                                return true;
+                            }
+                        }
+                    }
+                }
+            }
+            catch {
+                // npm 目录不存在/不可读 → 不是来源
+            }
+        }
+        return false;
+    }
+    push() {
+        const disabledSkills = new Set(this.settings.disabledSkills);
+        const reviewDisabledSkills = new Set(this.settings.reviewDisabledSkills);
+        const disabledExts = new Set(this.settings.disabledExtensions);
+        let loadedSkillNames = null;
+        try {
+            const loadedSkills = this.host.getSession().resourceLoader.getSkills().skills;
+            const loadedExts = this.host.getSession().resourceLoader.getExtensions().extensions;
+            loadedSkillNames = new Set(loadedSkills.map((s) => s.name));
+            // Prune entries that no longer exist on disk AND aren't disabled
+            // (e.g. a skill/extension file was deleted). Disabled entries are
+            // kept so they can be re-enabled even when filtered out of the loader.
+            const keepSkills = new Set([
+                ...loadedSkills.map((s) => s.name),
+                ...this.settings.disabledSkills,
+            ]);
+            const keepExts = new Set([
+                ...loadedExts.map((e) => extensionKey(e)),
+                ...this.settings.disabledExtensions,
+            ]);
+            for (const name of [...this.knownSkills.keys()]) {
+                if (!keepSkills.has(name))
+                    this.knownSkills.delete(name);
+            }
+            for (const id of [...this.knownExtensions.keys()]) {
+                if (!keepExts.has(id))
+                    this.knownExtensions.delete(id);
+            }
+            for (const s of loadedSkills) {
+                this.knownSkills.set(s.name, {
+                    name: s.name,
+                    description: s.description,
+                    enabled: true,
+                });
+            }
+            for (const e of loadedExts) {
+                const id = extensionKey(e);
+                const p = e.sourceInfo?.path ?? e.path;
+                this.knownExtensions.set(id, {
+                    id,
+                    name: e.sourceInfo?.origin === "package" && e.sourceInfo.source
+                        ? e.sourceInfo.source
+                        : basename(p),
+                    path: p,
+                    enabled: true,
+                });
+            }
+        }
+        catch {
+            // Session not ready yet — keep whatever we already know.
+        }
+        // 清理“源文件已删除”的禁用残留记录：磁盘上已不存在的技能名从
+        // disabledSkills / reviewDisabledSkills 持久化记录中移除——否则每次
+        // 推送都会把已删除的 skill 以灰条形式永恒地补回面板（“关闭过的
+        // skill 被一直记录”）。session 未就绪时保守跳过。
+        if (loadedSkillNames !== null) {
+            const stale = [
+                ...new Set([...this.settings.disabledSkills, ...this.settings.reviewDisabledSkills]),
+            ].filter((name) => !loadedSkillNames.has(name) && !this.skillStillOnDisk(name));
+            if (stale.length > 0) {
+                this.settings.disabledSkills = this.settings.disabledSkills.filter((n) => !stale.includes(n));
+                this.settings.reviewDisabledSkills = this.settings.reviewDisabledSkills.filter((n) => !stale.includes(n));
+                this.host.stateStore.saveSettings(this.host.clientId, {
+                    disabledSkills: this.settings.disabledSkills,
+                    reviewDisabledSkills: this.settings.reviewDisabledSkills,
+                });
+            }
+        }
+        // Disabled entries that still exist on disk are re-added (with the
+        // last-known description) so they can be re-enabled; entries whose
+        // source file was deleted are dropped instead of being resurrected.
+        for (const name of this.settings.disabledSkills) {
+            if (this.knownSkills.has(name))
+                continue;
+            if (!this.skillStillOnDisk(name))
+                continue;
+            this.knownSkills.set(name, { name, description: "", enabled: false });
+        }
+        for (const id of this.settings.disabledExtensions) {
+            if (!this.knownExtensions.has(id)) {
+                this.knownExtensions.set(id, {
+                    id,
+                    name: id.startsWith("npm:") ? id : basename(id),
+                    path: "",
+                    enabled: false,
+                });
+            }
+        }
+        const skills = [...this.knownSkills.values()]
+            .map((s) => ({ ...s, enabled: !disabledSkills.has(s.name) }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        const reviewSkills = [...this.knownSkills.values()]
+            .map((s) => ({ ...s, enabled: !reviewDisabledSkills.has(s.name) }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        const extensions = [...this.knownExtensions.values()]
+            .map((e) => ({ ...e, enabled: !disabledExts.has(e.id) }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        this.host.emit({
+            type: "settings_state",
+            settings: {
+                promptMode: this.settings.promptMode,
+                customSystemPrompt: this.settings.customSystemPrompt,
+                terminalToolsEnabled: this.settings.terminalToolsEnabled,
+                terminalBash: this.settings.terminalBash,
+                terminalBashIdleMs: this.settings.terminalBashIdleMs,
+                thinkingWrap: this.settings.thinkingWrap,
+                toolsWrap: this.settings.toolsWrap,
+                visionBridgeEnabled: this.settings.visionBridgeEnabled,
+                visionBridgeModel: this.settings.visionBridgeModel,
+                visionBridgePromptMode: this.settings.visionBridgePromptMode,
+                visionBridgePrompt: this.settings.visionBridgePrompt,
+                reviewPrompt: this.settings.reviewPrompt,
+                reviewDisabledSkills: [...this.settings.reviewDisabledSkills],
+                disabledPlugins: [...(this.settings.disabledPlugins ?? [])],
+                // The built-in prompts, so the replace-mode editors can prefill the
+                // text they would otherwise replace (empty until the resource-loader
+                // has run once for the system prompt).
+                defaultSystemPrompt: this.host.effectiveDefaultSystemPrompt(),
+                effectiveSystemPrompt: this.host.effectiveSystemPrompt(),
+                visionBridgeDefaultPrompt: SYSTEM_PROMPT,
+                visionModels: this.collectVisionModels(),
+                disabledSkills: [...this.settings.disabledSkills],
+                disabledExtensions: [...this.settings.disabledExtensions],
+                skills,
+                reviewSkills,
+                extensions,
+                presets: this.presets.map((p) => ({ ...p })),
+            },
+        });
+    }
+    /** Vision-capable configured models, for the settings-panel picker. */
+    collectVisionModels() {
+        try {
+            return findVisionModels(this.host.getSession().modelRuntime).map((m) => ({
+                provider: m.provider,
+                id: m.id,
+                label: m.label,
+            }));
+        }
+        catch {
+            // Session not ready yet — the picker stays empty until next push.
+            return [];
+        }
+    }
+    /** Persist + apply a partial settings update (prompt text/mode, toggles). */
+    async set(partial) {
+        const needsReload = partial.promptMode !== undefined ||
+            partial.customSystemPrompt !== undefined ||
+            partial.disabledSkills !== undefined ||
+            partial.disabledExtensions !== undefined ||
+            partial.terminalToolsEnabled !== undefined;
+        if (partial.promptMode !== undefined)
+            this.settings.promptMode = partial.promptMode;
+        if (partial.customSystemPrompt !== undefined) {
+            this.settings.customSystemPrompt = partial.customSystemPrompt;
+        }
+        if (partial.disabledSkills !== undefined) {
+            this.settings.disabledSkills = partial.disabledSkills;
+        }
+        if (partial.disabledExtensions !== undefined) {
+            this.settings.disabledExtensions = partial.disabledExtensions;
+        }
+        // 插件开关是纯 UI 隐藏（不进 needsReload——运行时无需重载）。
+        if (partial.disabledPlugins !== undefined) {
+            this.settings.disabledPlugins = partial.disabledPlugins;
+        }
+        if (partial.terminalToolsEnabled !== undefined) {
+            this.settings.terminalToolsEnabled = partial.terminalToolsEnabled;
+        }
+        if (partial.terminalBash !== undefined) {
+            this.settings.terminalBash = partial.terminalBash;
+        }
+        if (partial.terminalBashIdleMs !== undefined) {
+            this.settings.terminalBashIdleMs = Math.max(0, Math.floor(partial.terminalBashIdleMs) || 0);
+        }
+        if (partial.thinkingWrap !== undefined) {
+            this.settings.thinkingWrap = partial.thinkingWrap;
+        }
+        if (partial.toolsWrap !== undefined) {
+            this.settings.toolsWrap = partial.toolsWrap;
+        }
+        if (partial.visionBridgeEnabled !== undefined) {
+            this.settings.visionBridgeEnabled = partial.visionBridgeEnabled;
+        }
+        if (partial.visionBridgeModel !== undefined) {
+            this.settings.visionBridgeModel = partial.visionBridgeModel ?? null;
+        }
+        if (partial.visionBridgePromptMode !== undefined) {
+            this.settings.visionBridgePromptMode = partial.visionBridgePromptMode;
+        }
+        if (partial.visionBridgePrompt !== undefined) {
+            this.settings.visionBridgePrompt = partial.visionBridgePrompt;
+        }
+        if (partial.reviewPrompt !== undefined) {
+            this.settings.reviewPrompt = partial.reviewPrompt;
+        }
+        if (partial.reviewDisabledSkills !== undefined) {
+            this.settings.reviewDisabledSkills = partial.reviewDisabledSkills;
+        }
+        this.host.stateStore.saveSettings(this.host.clientId, this.settings);
+        this.push();
+        if (needsReload)
+            await this.applyRuntime();
+    }
+    /** Save the CURRENT settings as a named preset (overwrites if exists). */
+    async savePreset(name) {
+        const n = name.trim();
+        if (!n) {
+            this.host.emit({ type: "notice", level: "error", text: "预设名称不能为空" });
+            return;
+        }
+        const preset = {
+            name: n,
+            promptMode: this.settings.promptMode,
+            customSystemPrompt: this.settings.customSystemPrompt,
+            disabledSkills: [...this.settings.disabledSkills],
+            disabledExtensions: [...this.settings.disabledExtensions],
+            terminalToolsEnabled: this.settings.terminalToolsEnabled,
+            terminalBash: this.settings.terminalBash,
+            terminalBashIdleMs: this.settings.terminalBashIdleMs,
+            reviewPrompt: this.settings.reviewPrompt,
+            reviewDisabledSkills: [...this.settings.reviewDisabledSkills],
+        };
+        const existing = this.presets.findIndex((p) => p.name === n);
+        if (existing >= 0)
+            this.presets[existing] = preset;
+        else
+            this.presets.push(preset);
+        this.host.stateStore.savePresets(this.host.clientId, this.presets);
+        this.push();
+    }
+    /** Replace the current settings with the named preset and apply it. */
+    async applyPreset(name) {
+        const p = this.presets.find((x) => x.name === name);
+        if (!p) {
+            this.host.emit({ type: "notice", level: "error", text: `预设不存在：${name}` });
+            return;
+        }
+        this.settings = {
+            promptMode: p.promptMode,
+            customSystemPrompt: p.customSystemPrompt,
+            disabledSkills: [...p.disabledSkills],
+            disabledExtensions: [...p.disabledExtensions],
+            // 旧版持久化的预设可能没有该字段——保留当前值。
+            terminalToolsEnabled: p.terminalToolsEnabled ?? this.settings.terminalToolsEnabled,
+            // 终端接管偏好随预设走；旧预设缺字段时保留当前值。
+            terminalBash: p.terminalBash ?? this.settings.terminalBash,
+            terminalBashIdleMs: p.terminalBashIdleMs ?? this.settings.terminalBashIdleMs,
+            reviewPrompt: p.reviewPrompt ?? this.settings.reviewPrompt,
+            reviewDisabledSkills: [
+                ...(p.reviewDisabledSkills ?? this.settings.reviewDisabledSkills),
+            ],
+            // 纯 UI 偏好不进预设——保留当前值。
+            thinkingWrap: this.settings.thinkingWrap,
+            toolsWrap: this.settings.toolsWrap,
+            // Presets don't capture vision-bridge prefs — keep the current ones.
+            visionBridgeEnabled: this.settings.visionBridgeEnabled,
+            visionBridgeModel: this.settings.visionBridgeModel,
+            visionBridgePromptMode: this.settings.visionBridgePromptMode,
+            visionBridgePrompt: this.settings.visionBridgePrompt,
+        };
+        this.host.stateStore.saveSettings(this.host.clientId, this.settings);
+        this.push();
+        await this.applyRuntime();
+    }
+    /** Remove a named preset. */
+    async deletePreset(name) {
+        this.presets = this.presets.filter((p) => p.name !== name);
+        this.host.stateStore.savePresets(this.host.clientId, this.presets);
+        this.push();
+    }
+    /**
+     * Make settings changes effective in the running runtime. The resource-loader
+     * overrides read this.settings at call time, so a reload re-applies them.
+     * Reloading mid-stream would tear down the in-flight run — defer instead.
+     */
+    async applyRuntime() {
+        if (this.host.isDisposed())
+            return;
+        if (this.host.isStreaming()) {
+            this.pendingReload = true;
+            this.host.emit({
+                type: "notice",
+                level: "info",
+                text: "当前回复进行中，设置将在回复结束后自动应用",
+            });
+            return;
+        }
+        await this.applyReload();
+    }
+    /** session.reload() + refresh the slash-command catalog + push state. */
+    async applyReload() {
+        try {
+            await this.host.reloadSession();
+            this.push();
+            this.host.flushSnapshot();
+            this.host.emit({ type: "notice", level: "info", text: "设置已应用" });
+        }
+        catch (err) {
+            this.host.emit({
+                type: "notice",
+                level: "error",
+                text: `设置应用失败：${err.message}`,
+            });
+        }
+    }
+}

package/dist/server/slash-commands.js

@@ -0,0 +1,263 @@
+/** Slash commands implemented natively by the web server (the pi CLI's built-in
+ * interactive commands like /model and /new are NOT handled by the SDK's
+ * prompt() — without this they'd be sent to the model as plain text). Keep in
+ * sync with exec(). */
+export const NATIVE_COMMANDS = [
+    { name: "new", description: "新建对话", descriptionEn: "New chat" },
+    { name: "model", description: "切换模型", descriptionEn: "Switch model", argumentHint: "[名称]", argumentHintEn: "[name]" },
+    { name: "compact", description: "压缩上下文", descriptionEn: "Compact context", argumentHint: "[说明]", argumentHintEn: "[instructions]" },
+    { name: "cwd", description: "切换工作目录", descriptionEn: "Switch workspace", argumentHint: "<路径>", argumentHintEn: "<path>" },
+    {
+        name: "thinking",
+        description: "设置思考强度",
+        descriptionEn: "Set thinking level",
+        argumentHint: "<off|low|medium|high|xhigh|max>",
+        argumentHintEn: "<off|low|medium|high|xhigh|max>",
+    },
+    { name: "resume", description: "刷新会话列表", descriptionEn: "Refresh session list" },
+    { name: "reload", description: "重新加载扩展、技能与模板", descriptionEn: "Reload extensions, skills & templates" },
+    { name: "help", description: "显示全部命令", descriptionEn: "Show all commands" },
+    { name: "copy", description: "复制上一条助手回复", descriptionEn: "Copy last assistant reply" },
+    { name: "pi-web-ui:quit", description: "退出服务", descriptionEn: "Quit server (supervisor will restart)" },
+];
+/** Parse a prompt into "/command args" — returns null when it isn't one. */
+export function parseSlash(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith("/"))
+        return null;
+    const m = trimmed.match(/^\/([^\s]+)\s*([\s\S]*)$/);
+    if (!m || !m[1])
+        return null;
+    return { name: m[1], args: m[2].trim() };
+}
+export class SlashCommandsService {
+    host;
+    constructor(host) {
+        this.host = host;
+    }
+    /**
+     * Catalog of slash commands for the chat input: web-native builtins first,
+     * then the SDK's invokable commands for the ACTIVE conversation (extension
+     * commands, prompt templates, skills) — the same set the SDK expands when a
+     * prompt text starts with "/" (see AgentSession.prompt).
+     */
+    async push() {
+        const commands = [];
+        const seen = new Set();
+        for (const c of NATIVE_COMMANDS) {
+            commands.push({ ...c, source: "builtin" });
+            seen.add(c.name);
+        }
+        try {
+            const s = this.host.getSession();
+            // Extension commands — the SDK already suffixes collisions with builtin
+            // names ("new:2"), and those still reach the SDK since exec() only
+            // intercepts the exact native names.
+            for (const cmd of s.extensionRunner.getRegisteredCommands()) {
+                if (seen.has(cmd.invocationName))
+                    continue;
+                commands.push({
+                    name: cmd.invocationName,
+                    description: cmd.description,
+                    source: "extension",
+                });
+                seen.add(cmd.invocationName);
+            }
+            // Prompt templates: /templatename args
+            for (const t of s.promptTemplates) {
+                if (seen.has(t.name))
+                    continue;
+                commands.push({
+                    name: t.name,
+                    description: t.description,
+                    source: "prompt",
+                });
+                seen.add(t.name);
+            }
+            // Skills: /skill:name args
+            for (const skill of s.resourceLoader.getSkills().skills) {
+                const name = `skill:${skill.name}`;
+                if (seen.has(name))
+                    continue;
+                commands.push({
+                    name,
+                    description: skill.description,
+                    source: "skill",
+                });
+                seen.add(name);
+            }
+        }
+        catch {
+            // Session not ready yet — native-only catalog still serves the picker.
+        }
+        // UI 插件注册的命令（host.registerCommand）——全局，不依赖会话就绪。
+        for (const cmd of this.host.pluginCommands?.() ?? []) {
+            if (seen.has(cmd.name))
+                continue; // 与内置/扩展重名时先到先得（内置优先）
+            commands.push({
+                name: cmd.name,
+                description: cmd.description,
+                descriptionEn: cmd.descriptionEn,
+                argumentHint: cmd.argumentHint,
+                argumentHintEn: cmd.argumentHintEn,
+                source: "plugin",
+            });
+            seen.add(cmd.name);
+        }
+        this.host.emit({ type: "slash_commands", commands });
+    }
+    /** Run a native slash command (see NATIVE_COMMANDS). Returns false when the
+     *  name is not a native command (the prompt falls through to the SDK). */
+    async exec(name, args) {
+        switch (name) {
+            case "new":
+                await this.host.newChat();
+                return true;
+            case "model": {
+                if (!args) {
+                    const current = this.host.getSession().model;
+                    this.host.emit({
+                        type: "notice",
+                        level: "info",
+                        text: current
+                            ? `当前模型：${current.name}（${current.provider}/${current.id}）。用法：/model <名称>`
+                            : `用法：/model <名称>`,
+                    });
+                    return true;
+                }
+                const query = args.toLowerCase();
+                const available = await this.host.getSession().modelRuntime.getAvailable();
+                // Prefer an exact "provider/id" match, else id/name substring.
+                const exact = available.find((m) => m.provider + "/" + m.id === args.trim());
+                const matches = exact
+                    ? [exact]
+                    : available.filter((m) => m.id.toLowerCase().includes(query) ||
+                        m.name.toLowerCase().includes(query) ||
+                        m.provider.toLowerCase().includes(query));
+                if (matches.length === 0) {
+                    this.host.emit({
+                        type: "notice",
+                        level: "error",
+                        text: `没有匹配到模型：${args}（可用模型见顶栏模型列表）`,
+                    });
+                    return true;
+                }
+                const pick = matches[0];
+                if (matches.length > 1) {
+                    this.host.emit({
+                        type: "notice",
+                        level: "warning",
+                        text: `找到 ${matches.length} 个匹配模型，已选用：${pick.name}（精确匹配请用 provider/id）`,
+                    });
+                }
+                await this.host.setModel(`${pick.provider}/${pick.id}`);
+                return true;
+            }
+            case "compact":
+                try {
+                    await this.host.getSession().compact(args || undefined);
+                }
+                catch (err) {
+                    this.host.emit({
+                        type: "notice",
+                        level: "error",
+                        text: `压缩上下文失败：${err.message}`,
+                    });
+                }
+                return true;
+            case "cwd":
+                if (!args) {
+                    this.host.emit({
+                        type: "notice",
+                        level: "info",
+                        text: `当前工作目录：${this.host.cwd()}。用法：/cwd <路径>`,
+                    });
+                }
+                else {
+                    await this.host.setCwd(args);
+                }
+                return true;
+            case "thinking": {
+                const ALIAS = {
+                    off: "off",
+                    minimal: "minimal",
+                    low: "low",
+                    medium: "medium",
+                    high: "high",
+                    xhigh: "xhigh",
+                    max: "max",
+                    关闭: "off",
+                    极简: "minimal",
+                    低: "low",
+                    中: "medium",
+                    高: "high",
+                    极高: "xhigh",
+                    最大: "max",
+                };
+                const level = ALIAS[args.trim().toLowerCase()];
+                if (!level) {
+                    this.host.emit({
+                        type: "notice",
+                        level: "error",
+                        text: `无效的思考强度：${args || "（空）"}。可用：off / minimal / low / medium / high / xhigh / max`,
+                    });
+                    return true;
+                }
+                this.host.setThinking(level);
+                return true;
+            }
+            case "resume":
+                await this.host.refreshSessions();
+                this.host.emit({
+                    type: "notice",
+                    level: "info",
+                    text: "会话列表已刷新，请在左侧「历史对话」中选择",
+                });
+                return true;
+            case "reload":
+                try {
+                    // Re-discovers extensions / skills / prompt templates from disk and
+                    // re-pushes the picker catalog (the CLI's /reload semantics).
+                    await this.host.getSession().reload();
+                    // reload() 会把 custom 工具加回活跃集——重放设置门控（终端开关等）。
+                    this.host.afterReload?.();
+                    await this.push();
+                    this.host.emit({
+                        type: "notice",
+                        level: "info",
+                        text: "已重新加载扩展、技能与提示模板",
+                    });
+                }
+                catch (err) {
+                    this.host.emit({
+                        type: "notice",
+                        level: "error",
+                        text: `重新加载失败：${err.message}`,
+                    });
+                }
+                return true;
+            case "pi-web-ui:quit": {
+                this.host.emit({
+                    type: "notice",
+                    level: "info",
+                    text: "正在退出 pi-web-ui… supervisor 将自动重启服务",
+                });
+                setTimeout(() => {
+                    const didSchedule = this.host.onQuit?.() ?? false;
+                    if (!didSchedule) {
+                        setTimeout(() => process.exit(0), 100);
+                    }
+                }, 300);
+                return true;
+            }
+            case "help":
+            case "copy":
+                // Client-side UI actions — the client handles them before sending;
+                // swallow here so the SDK never sees them as plain prompt text.
+                return true;
+            default:
+                // 插件命令：拦截执行（纯配置动作，与内置命令同级，不到 SDK）。
+                return (await this.host.execPluginCommand?.(name, args)) ?? false;
+        }
+    }
+}