pi-web-ui 0.86.2 → 0.87.0

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

@@ -31,7 +31,7 @@ import { homedir } from "node:os";
 import { BgServerTracker } from "../bg-servers.js";
 import { ClientStateStore, DEFAULT_RETRY_MAX_ATTEMPTS } from "../client-state.js";
 import { normalizeUiLayout } from "../client-state.js";
-import { FilesService, workspacePath } from "../files-service.js";
+import { FilesService, workspacePath, desktopDirWire } from "../files-service.js";
 import { QuiesceRejectedError } from "../agent-service.js";
 import { NATIVE_COMMANDS, parseSlash } from "../slash-commands.js";
 import { bilingual, pick, resolveServerLang } from "../i18n.js";
@@ -42,9 +42,19 @@ import { previewKind } from "../text-sniff.js";
 import { launchOrigin, toServiceInfo } from "../launch-origin.js";
 import { DshRuntime, loadDeepSeekKey } from "./dsh-client.js";
 import { DshStreamAccumulator, assistantMessageEventToUiMessage, toolResultEventToUiMessage, userMessageEventToUiMessage, } from "./dsh-serialize.js";
-import { firstUserText, findSessionFilesForCwd, readSessionLog, replayEventsToMessages } from "./dsh-sessions.js";
+import { firstUserText, findSessionFilesForCwd, readSessionLog, replayEventsToMessages, sessionLogPermission, sessionLogPreset, } from "./dsh-sessions.js";
+import { generatePresetClones, PRESET_DEFAULT_ID } from "./preset-clones.js";
+import { dshContextUsage, lastUsageFromEvents, normalizeDshUsage } from "./dsh-usage.js";
 const SNAPSHOT_INTERVAL_MS = 60;
+/** 用户主目录（wire 格式）：进程内不变，模块加载时求值一次（右栏 🏠）。 */
+const HOME_WIRE = homedir().replace(/\\/g, "/");
+/** 桌面目录（wire 格式）：进程内不变，不存在则空串 → 前端不渲染 🖥️。 */
+const DESKTOP_WIRE = desktopDirWire(HOME_WIRE);
 const MAX_OPEN_CONVERSATIONS = 8;
+/** 新会话默认权限预设（沙箱内 + 无审批弹窗；无头运行的当前行为，保持不变）。 */
+const PERMISSION_DEFAULT_PRESET = "workspace-write-never";
+/** 前端提供的三档（官方 workspace-write 走 ask，无应答者时是死路，不提供）。 */
+const PERMISSION_OFFERED = ["read-only", "workspace-write-never", "danger-full-access"];
 const DEFAULT_CONV_TITLE = "新对话";
 const DEFAULT_CONV_TITLE_EN = "New chat";
 const DEFAULT_MODEL = "deepseek-v4-flash";
@@ -119,6 +129,8 @@ const DEFAULT_SETTINGS = {
     disabledPlugins: [],
     uiLayout: {},
     reviewPrompt: "",
+    defaultAgentPreset: PRESET_DEFAULT_ID,
+    defaultPermissionPreset: PERMISSION_DEFAULT_PRESET,
     quickPhrases: [],
     quickPhrasesEnabled: true,
 };
@@ -173,6 +185,16 @@ export class DshClientSession {
     settings = { ...DEFAULT_SETTINGS };
     /** 最近一次从运行时拉取的技能清单（UiSkillInfo，含 enabled 由 disabledSkills 推导）。 */
     skillsCache = [];
+    /** 运行时世代（每次 start 成功 +1；conv.assignedGen 用它判断 preset/assign 是否过期）。 */
+    runtimeGen = 0;
+    /** Agent 预设名录缓存（运行时 preset/list；unavailable/空 = legacy，UI 隐藏预设条）。 */
+    agentPresets = [];
+    agentPresetDefault = PRESET_DEFAULT_ID;
+    agentPresetsAvailable = false;
+    /** 权限选项表缓存（组合静态；空 = 未就绪/legacy，前端隐藏权限条）。 */
+    permissionOptions = [];
+    /** clone 出来的预设 id（roster 名录校验用；空 = 未生成，走 legacy）。 */
+    presetCloneIds = [];
     files;
     bg;
     /** 插件扩展点（index.ts 注入）。 */
@@ -253,20 +275,28 @@ export class DshClientSession {
                 reviewPrompt: savedSettings.reviewPrompt,
                 quickPhrases: savedSettings.quickPhrases ?? [],
                 quickPhrasesEnabled: savedSettings.quickPhrasesEnabled ?? true,
+                defaultAgentPreset: savedSettings.defaultAgentPreset ?? PRESET_DEFAULT_ID,
+                defaultPermissionPreset: savedSettings.defaultPermissionPreset && PERMISSION_OFFERED.includes(savedSettings.defaultPermissionPreset)
+                    ? savedSettings.defaultPermissionPreset
+                    : PERMISSION_DEFAULT_PRESET,
             };
         }
         // 第一个 conversation = 新会话（每客户端独立 sessionId，避免多标签页/多
         // 客户端共享同一 JSONL 互相串会话）。历史会话经 switch_session 恢复。
         cs.makeRuntime();
-        const first = cs.addConversation(`web-${randomUUID().slice(0, 12)}`, cwd, false);
+        const first = cs.addConversation(`web-${randomUUID().slice(0, 12)}`, cwd, false, cs.settings.defaultAgentPreset);
         cs.activeId = first.id;
         cs.attachRuntimeEvents();
         // 每次启动成功（含初次/换模型/watchdog 重启）后重新注册插件工具桥，
         // 因为重 spawn 后的 ctx.tools 是全新的，需要重新 sync 插件工具。
         cs.runtime.onStarted = () => {
+            cs.runtimeGen += 1;
             void cs.syncPluginTools();
             void cs.pushDisabledSkillsToRuntime();
             void cs.refreshSkillsFromRuntime();
+            void cs.refreshAgentPresets();
+            void cs.refreshPermissionOptions().catch(() => { });
+            void cs.refreshActivePermission().catch(() => { });
         };
         // P0-1 watchdog：意外退出（非 kill/close 主动触发）→ 限频自动重启，保持可用。
         cs.runtime.onExit = (code, signal, intentional) => {
@@ -322,6 +352,8 @@ export class DshClientSession {
         for (const conv of this.convs.values()) {
             conv.isStreaming = false;
             conv.streaming = null;
+            // 直播帧能力跟着运行时进程走：重启后重新探测（换运行时版本也能回落到持久 assistant/chunk）。
+            conv.liveChunks = false;
         }
         const now = Date.now();
         if (now - this.runtimeRestart.windowStart > DshClientSession.RUNTIME_RESTART_WINDOW_MS) {
@@ -447,12 +479,37 @@ export class DshClientSession {
         }
     }
     makeRuntime() {
+        // Agent 预设 clone（file: 改写 shipped 预设，供 preset-plane patch 的 roster 用）。
+        // 成功 → 下发 patch（预设时代）；失败/null → 不下发（回落 legacy 单组合）。
+        let presetPatch;
+        try {
+            const clones = generatePresetClones(this.dataDir);
+            if (clones) {
+                presetPatch = clones.patchFile;
+                if (clones.warnings.length > 0) {
+                    console.error(`[dsh] preset clone warnings: ${clones.warnings.join("; ")}`);
+                }
+                this.presetCloneIds = clones.presetIds;
+            }
+            else {
+                this.presetCloneIds = [];
+            }
+        }
+        catch (err) {
+            console.error(`[dsh] preset clone 生成失败，回落 legacy: ${err.message}`);
+            this.presetCloneIds = [];
+        }
         this.runtime = new DshRuntime({
             cwd: this.cwd,
             provider: "deepseek-official",
             model: this.model,
             sessionRoot: this.sessionRoot,
             dataDir: this.dataDir,
+            agentDir: this.agentDir,
+            env: {
+                ...(presetPatch ? { PI_WEB_DSH_PRESET_PATCH: presetPatch } : {}),
+                PI_WEB_DSH_CUSTOM_PROMPT: this.settings.customSystemPrompt.trim(),
+            },
         });
     }
     attachRuntimeEvents() {
@@ -463,6 +520,11 @@ export class DshClientSession {
                 if (method === "session.event") {
                     this.handleSessionEvent(params);
                 }
+                else if (method === "assistant.stream") {
+                    // 新版运行时（0.1.1-rc.2 之后）的直播流：wrapper 把 agent/assistant-stream 帧转成
+                    // assistant.stream 通知（老运行时的持久 assistant/chunk 已不存在）。
+                    this.handleAssistantStream(params);
+                }
                 else if (method === "session.status") {
                     this.handleSessionStatus(params);
                 }
@@ -683,11 +745,15 @@ export class DshClientSession {
         return title === DEFAULT_CONV_TITLE || title === DEFAULT_CONV_TITLE_EN;
     }
     /** 新建（或切换）一个 conversation。existing 的 sessionId 续聊最近 JSONL。 */
-    addConversation(sessionId, cwd, replay = true) {
+    addConversation(sessionId, cwd, replay = true, preset) {
         const id = this.nextConversationId();
         const conv = {
             id,
             sessionId,
+            agentPreset: this.resolvePreset(preset),
+            presetLocked: false,
+            assignedGen: -1,
+            permissionPreset: null,
             dsGoal: null,
             goal: this.makeGoalStatus(),
             title: this.defaultTitle(),
@@ -707,17 +773,36 @@ export class DshClientSession {
             () => this.getLang()),
             toolStartTimes: new Map(),
             tokens: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+            usageSeen: false,
+            liveChunks: false,
+            streamAnchor: 0,
+            streamTurn: 0,
         };
         if (replay) {
             // 从磁盘 JSONL 回放历史消息（DSH 事件流不重放历史）。
             try {
                 const files = findSessionFilesForCwd(this.sessionRoot, cwd).filter((f) => basename(dirname(f)) === sessionId);
                 if (files.length > 0) {
-                    const { events } = readSessionLog(files[0]);
+                    const { header, events } = readSessionLog(files[0]);
                     conv.messages = replayEventsToMessages(events);
                     for (const m of conv.messages)
                         conv.messageIds.add(m.id);
                     conv.title = firstUserText(events, this.getLang());
+                    // 回放定预设：日志记录（selected 事件/header）> 调用方指定 > 默认。
+                    const logged = sessionLogPreset({ header, events });
+                    conv.agentPreset = this.resolvePreset(logged ?? preset);
+                    // 权限预设同理：permission/preset 事件最后一条为准（无则 null，激活时拉取）。
+                    conv.permissionPreset = sessionLogPermission({ header, events });
+                    // 底栏统计：日志里最后一次 usage（新版在 assistant/message.usage，0.1.1 在
+                    // assistant/chunk 的 usage chunk）→ 切回历史会话立刻有上下文 / 缓存命中数字。
+                    const loggedUsage = lastUsageFromEvents(events);
+                    if (loggedUsage) {
+                        conv.tokens = loggedUsage;
+                        conv.usageSeen = true;
+                    }
+                    // 有历史消息 = 已开始的会话，预设锁定（官方语义）。
+                    if (conv.messages.length > 0)
+                        conv.presetLocked = true;
                 }
             }
             catch {
@@ -806,6 +891,8 @@ export class DshClientSession {
                     conv.streaming = null;
                     this.appendMessage(conv, msg);
                 }
+                // 新版运行时的 usage 挂在这条持久事件上（老运行时没有 → undefined 保持原统计）。
+                this.applyUsage(conv, ev.data.usage);
                 break;
             }
             case "tool/result": {
@@ -838,38 +925,14 @@ export class DshClientSession {
                 break;
             }
             case "assistant/chunk": {
+                // 老运行时（0.1.1-rc.2）的持久直播 chunk；新版运行时没有这个事件（改发
+                // agent/assistant-stream 直播帧）→ 过渡期两边都在时只认直播帧，避免喂两遍。
+                if (conv.liveChunks)
+                    break;
                 const chunk = ev.data?.chunk;
                 if (!chunk)
                     break;
-                if (chunk.type === "usage") {
-                    const u = chunk.usage;
-                    conv.tokens.input = u.inputTokens ?? 0;
-                    conv.tokens.output = u.outputTokens ?? 0;
-                    conv.tokens.cacheRead = u.cacheReadTokens ?? 0;
-                    conv.tokens.cacheWrite = u.cacheWriteTokens ?? 0;
-                    break;
-                }
-                if (!conv.streaming) {
-                    conv.streaming = new DshStreamAccumulator(ev.seq, ev.data?.turn ?? 0);
-                }
-                conv.streaming.apply(chunk);
-                // message_delta 实时通道：本机快速完成时 60ms 延迟快照总被
-                // assistant/message 抢跑（streaming 从未被捕捉）——delta 直接
-                // 走独立通道，保证逐 token 渲染（前端 patch streamingMessage）。
-                if (conv.id === this.conv.id && (chunk.type === "text-delta" || chunk.type === "reasoning-delta")) {
-                    this.emit({
-                        type: "message_delta",
-                        conversationId: conv.id,
-                        seq: ++conv.deltaSeq,
-                        messageId: conv.streaming.id,
-                        usage: null,
-                        assistantMessageEvent: {
-                            type: chunk.type === "text-delta" ? "text_delta" : "thinking_delta",
-                            contentIndex: chunk.index,
-                            delta: chunk.text,
-                        },
-                    });
-                }
+                this.applyStreamChunk(conv, chunk, ev.seq, ev.data?.turn ?? 0);
                 break;
             }
             case "tool/call": {
@@ -939,6 +1002,85 @@ export class DshClientSession {
             this.scheduleSnapshot();
         }
     }
+    /**
+     * 新版运行时的直播帧处理。运行时逐 chunk 发 `agent/assistant-stream`（agent scope，
+     * host 侧要 `{ global: true }` 才收得到），wrapper（goal-rpc.mjs）转成本通知：
+     *   { type: "start" | "chunk" | "end", attemptId, revision, index, time, chunk }
+     * chunk 形状与老运行时的 `assistant/chunk.data.chunk` 同构 → 共用 applyStreamChunk。
+     */
+    handleAssistantStream(params) {
+        const conv = this.findConv(params.sessionId);
+        const frame = params.frame;
+        // 别家客户端的会话 / 子代理会话（不在本客户端 convs 里）→ 忽略。
+        if (!conv || !frame || typeof frame.type !== "string")
+            return;
+        conv.lastEventAt = Date.now();
+        if (frame.type === "start") {
+            // 新 attempt（含重试）→ 换锚点，丢掉上一 attempt 的累计内容（与官方 dsh-web 一致）。
+            conv.liveChunks = true;
+            conv.streaming = null;
+            conv.streamAnchor = typeof frame.time === "number" && Number.isFinite(frame.time) ? frame.time : Date.now();
+            conv.streamTurn = typeof frame.turn === "number" ? frame.turn : 0;
+            this.scheduleSnapshot();
+            return;
+        }
+        if (frame.type !== "chunk")
+            return; // end：结算由 assistant/message / turn/end 清
+        conv.liveChunks = true;
+        const chunk = frame.chunk;
+        if (!chunk)
+            return;
+        if (!conv.streamAnchor) {
+            // 没收到 start（重连晚到）→ 用首帧补锚点。
+            conv.streamAnchor = typeof frame.time === "number" && Number.isFinite(frame.time) ? frame.time : Date.now();
+            conv.streamTurn = typeof frame.turn === "number" ? frame.turn : 0;
+        }
+        this.applyStreamChunk(conv, chunk, conv.streamAnchor, conv.streamTurn);
+        // 60ms 节流快照：与持久事件那条路一样，让 isStreaming / streamingMessage 进快照
+        // （delta 通道只负责内容增量，靠它保证状态一致 + 背压时仍能收敛）。
+        this.scheduleSnapshot();
+    }
+    /**
+     * 一个 model stream chunk → 会话：usage 进底栏统计，其余进 streamingMessage 累计器 +
+     * 实时 delta 通道（message_delta）。两条投递路径（老 assistant/chunk / 新直播帧）共用。
+     *
+     * @param anchorId - streamingMessage id 的锚（老 = chunk 事件 seq；新版 = 首帧 time）。
+     * @param turn - 所属 turn（累计器 id 用）。
+     */
+    applyStreamChunk(conv, chunk, anchorId, turn) {
+        if (chunk.type === "usage") {
+            this.applyUsage(conv, chunk.usage);
+            return;
+        }
+        if (!conv.streaming)
+            conv.streaming = new DshStreamAccumulator(anchorId, turn);
+        conv.streaming.apply(chunk);
+        // message_delta 实时通道：本机快速完成时 60ms 延迟快照总被 assistant/message 抢跑
+        // （streaming 从未被捕捉）→ delta 直接走独立通道，保证逐 token 渲染
+        // （前端 patch streamingMessage）。只推给当前对话，其他对话靠快照。
+        if (conv.id === this.conv.id && (chunk.type === "text-delta" || chunk.type === "reasoning-delta")) {
+            this.emit({
+                type: "message_delta",
+                conversationId: conv.id,
+                seq: ++conv.deltaSeq,
+                messageId: conv.streaming.id,
+                usage: null,
+                assistantMessageEvent: {
+                    type: chunk.type === "text-delta" ? "text_delta" : "thinking_delta",
+                    contentIndex: chunk.index,
+                    delta: chunk.text,
+                },
+            });
+        }
+    }
+    /** usage → 底栏统计（最近一次模型调用口径；缺字段 / 非对象保持原值）。 */
+    applyUsage(conv, usage) {
+        const next = normalizeDshUsage(usage);
+        if (!next)
+            return;
+        conv.tokens = next;
+        conv.usageSeen = true;
+    }
     handleSessionStatus(params) {
         const conv = this.findConv(params.sessionId);
         if (!conv)
@@ -1047,18 +1189,15 @@ export class DshClientSession {
                 total: tokens.input + tokens.output + tokens.cacheRead + tokens.cacheWrite,
             },
             cost: estimateCost(tokens),
-            contextUsage: {
-                tokens: tokens.input + tokens.output + tokens.cacheRead,
-                contextWindow: DSH_CONTEXT_WINDOW,
-                percent: DSH_CONTEXT_WINDOW > 0
-                    ? Math.min(100, ((tokens.input + tokens.output + tokens.cacheRead) / DSH_CONTEXT_WINDOW) * 100)
-                    : null,
-            },
+            // 最近一次请求的 prompt + 输出（usageSeen=false → tokens=null，前端显示 `—`）。
+            contextUsage: dshContextUsage(conv.usageSeen ? tokens : null, DSH_CONTEXT_WINDOW),
         };
         return {
             clientId: this.clientId,
             cwd: this.cwd,
             workspaceRoots: this.roots,
+            homeDir: HOME_WIRE,
+            desktopDir: DESKTOP_WIRE,
             sessionId: conv.sessionId,
             conversationId: this.activeId,
             rev,
@@ -1073,12 +1212,15 @@ export class DshClientSession {
             },
             thinkingLevel: this.thinkingLevel,
             availableThinkingLevels: ["high"],
+            agentPreset: { id: conv.agentPreset, name: this.presetName(conv.agentPreset), locked: conv.presetLocked },
+            permission: conv.permissionPreset ?? null,
             queue: { steering: conv.queue.steering, followUp: conv.queue.followUp },
             pendingQuestion: this.pendingQuestionForSnapshot(),
             tools: [],
             version: ++this.version,
-            piConfigured: !!loadDeepSeekKey(),
-            piAgentInstalled: false,
+            piConfigured: this.isDshConfigured(),
+            // DSH 不需要 pi CLI：报 true 让 PiSetupModal 跳过“安装 pi”步骤，直达填 key 表单。
+            piAgentInstalled: true,
             stats,
         };
     }
@@ -1093,6 +1235,10 @@ export class DshClientSession {
         this.emitConversations();
         this.emitGoalStatus();
         this.pushSettings();
+        this.pushAgentPresets();
+        this.pushPermission();
+        void this.refreshPermissionOptions().catch(() => { });
+        void this.refreshActivePermission().catch(() => { });
         this.bg.push();
         this.pushTerminals();
     }
@@ -1195,6 +1341,9 @@ export class DshClientSession {
                 messageCount: conv.messages.length,
                 isStreaming: conv.isStreaming,
                 isSubagent: false,
+                // DSH Agent 预设（左栏徽标/详情用；pi 引擎不填）。
+                agentPreset: conv.agentPreset,
+                presetLocked: conv.presetLocked,
             });
         }
         // issue #145：流式集合签名变化 → 通知其他客户端重推（左栏「另一处正在运行」近实时）
@@ -1216,13 +1365,17 @@ export class DshClientSession {
         });
     }
     /** 语义同 pi 引擎的 newChat：true = 当前活动对话是可接收首条的空白新对话
-     *  （/new <prompt> 靠它决定要不要把首条提示发出去）。 */
-    async newChat() {
+     *  （/new <prompt> 靠它决定要不要把首条提示发出去）。preset = 新会话预设
+     *  （复用空白会话时等价一次空白切换）。 */
+    async newChat(preset) {
         if (this.quiesceBlocked())
             return false;
         const active = this.conv;
         if (active.messages.length === 0 && active.terminals.list().length === 0) {
-            this.flushSnapshot();
+            if (preset)
+                await this.selectAgentPreset(preset);
+            else
+                this.flushSnapshot();
             return true;
         }
         for (const conv of this.convs.values()) {
@@ -1230,7 +1383,10 @@ export class DshClientSession {
                 continue;
             if (conv.messages.length === 0) {
                 this.switchConversation(conv.id);
-                this.flushSnapshot();
+                if (preset)
+                    await this.selectAgentPreset(preset);
+                else
+                    this.flushSnapshot();
                 return true;
             }
         }
@@ -1247,13 +1403,14 @@ export class DshClientSession {
         // 旧对话保留（listed 生命周期简化：不主动移除）。
         const prevModel = this.model;
         active.listed = active.isStreaming || active.terminals.list().length > 0 || active.promptedSinceActive;
-        const conv = this.addConversation(`chat-${randomUUID().slice(0, 12)}`, this.cwd, false);
+        const conv = this.addConversation(`chat-${randomUUID().slice(0, 12)}`, this.cwd, false, preset);
         this.activeId = conv.id;
         this.model = prevModel;
         this.emitConversations();
         this.emitGoalStatus();
         this.pushTerminals();
         this.flushSnapshot();
+        void this.refreshActivePermission().catch(() => { });
         return true;
     }
     async switchConversation(id) {
@@ -1286,6 +1443,8 @@ export class DshClientSession {
         this.emitGoalStatus();
         this.pushTerminals();
         this.flushSnapshot(true);
+        // 切会话带上权限值（cwd 变化走运行时重启，onStarted 会重拉）。
+        void this.refreshActivePermission().catch(() => { });
     }
     removeConversation(id) {
         const conv = this.convs.get(id);
@@ -1438,6 +1597,20 @@ export class DshClientSession {
                 return;
             conv.promptedSinceActive = true;
             conv.lastEventAt = Date.now();
+            // Agent 预设：运行时世代过期 → 重登 preset/assign（创建时消费；
+            // 已存在会话的登记永不消费，重启后新运行时建会话时正好用上）。
+            if (conv.assignedGen !== this.runtimeGen) {
+                try {
+                    await this.runtime.assignPreset(conv.sessionId, conv.agentPreset);
+                    conv.assignedGen = this.runtimeGen;
+                }
+                catch {
+                    /* legacy/运行时未就绪：创建走默认；best effort */
+                }
+            }
+            // 新会话默认权限预设（与当前一致时 apply 无事件零噪音）。
+            await this.ensurePermissionDefault(conv);
+            this.flushSnapshot();
             const blocks = await this.buildContentBlocks(sysPrefix ? `${sysPrefix}${text}` : text, attachments);
             // 乐观落地用户消息（id 用暂定值；user/message 事件到达时按内容去重）。
             const optimistic = {
@@ -1463,6 +1636,11 @@ export class DshClientSession {
             else {
                 await this.runtime.prompt(conv.sessionId, blocks);
             }
+            // 首轮用户发言送达 → 预设锁定（官方语义；回放会话建时已锁）。
+            if (!conv.presetLocked) {
+                conv.presetLocked = true;
+                this.emitConversations();
+            }
         }
         catch (err) {
             this.emit({
@@ -1486,7 +1664,7 @@ export class DshClientSession {
     }
     /** 新建 fork 会话并切换到它（DSH 无法原地续聊旧会话）。 */
     forkConversation(prev) {
-        const fork = this.addConversation(`fork-${randomUUID().slice(0, 12)}`, this.cwd, false);
+        const fork = this.addConversation(`fork-${randomUUID().slice(0, 12)}`, this.cwd, false, prev.agentPreset);
         fork.title = prev.title;
         this.activeId = fork.id;
         // P2-19：原会话有 active goal（DSH same-session 语义）→ 提示随会话存档。
@@ -2240,6 +2418,19 @@ export class DshClientSession {
     async uploadFile(dirRel, name, data) {
         await this.files.uploadFile(dirRel, name, data);
     }
+    /** 文件树右键菜单：新建/重命名/删除/复制移动（FilesService 直透传）。 */
+    async createEntry(dir, name, kind) {
+        await this.files.createEntry(dir, name, kind);
+    }
+    async renameEntry(path, newName) {
+        await this.files.renameEntry(path, newName);
+    }
+    async deleteEntry(path) {
+        await this.files.deleteEntry(path);
+    }
+    async copyEntry(src, destDir, move) {
+        await this.files.copyEntry(src, destDir, move);
+    }
     async completePath(input) {
         await this.files.completePath(input);
     }
@@ -2481,6 +2672,7 @@ export class DshClientSession {
             reviewPrompt: this.settings.reviewPrompt,
             quickPhrases: this.settings.quickPhrases,
             quickPhrasesEnabled: this.settings.quickPhrasesEnabled,
+            defaultAgentPreset: this.settings.defaultAgentPreset,
         });
         // 仅系统提示词变化才重启运行时（DSH_PERSONA 由 launcher env 注入）；
         // 其他设置（开关/隐藏插件等）只存不回写运行时。
@@ -2502,7 +2694,10 @@ export class DshClientSession {
             : this.settings.promptMode === "append" && custom
                 ? `\n\n${custom}`
                 : "";
-        this.runtime.env = { ...this.runtime.env, DSH_PERSONA: persona };
+        // 自定义提示词双通道：DSH_PERSONA（host 部署人设；预设 persona 会 shadow 它，
+        // minimal 更全压住）+ PI_WEB_DSH_CUSTOM_PROMPT（独立 host section，随
+        // standard/ptc/cordis 下发；minimal 下被 complete 压住，官方语义）。
+        this.runtime.env = { ...this.runtime.env, DSH_PERSONA: persona, PI_WEB_DSH_CUSTOM_PROMPT: custom };
         if (this.runtime.alive) {
             return this.runtime.restart(this.model).catch(() => {
                 /* keep old runtime */
@@ -2519,6 +2714,255 @@ export class DshClientSession {
             textEn: "The DSH engine does not support pi extension hot-reload",
         });
     }
+    // -----------------------------------------------------------------------
+    // Agent 预设（dsh-web 四模式；Node 侧是真相源，运行时只负责挂载）
+    // -----------------------------------------------------------------------
+    /** 从运行时拉取预设名录（每次启动后跑；失败/legacy → UI 隐藏预设条）。 */
+    async refreshAgentPresets() {
+        try {
+            const res = await this.runtime.listPresets();
+            if (res.unavailable || !Array.isArray(res.presets) || res.presets.length === 0) {
+                this.agentPresets = [];
+                this.agentPresetsAvailable = false;
+                this.agentPresetDefault = PRESET_DEFAULT_ID;
+            }
+            else {
+                this.agentPresets = res.presets;
+                this.agentPresetDefault = res.defaultPreset || PRESET_DEFAULT_ID;
+                this.agentPresetsAvailable = true;
+            }
+        }
+        catch {
+            this.agentPresets = [];
+            this.agentPresetsAvailable = false;
+            this.agentPresetDefault = PRESET_DEFAULT_ID;
+        }
+        this.pushAgentPresets();
+        this.flushSnapshot();
+    }
+    /** 校验一个预设 id（名录 healthy 优先；legacy/未知 → 默认）。 */
+    resolvePreset(requested) {
+        if (requested) {
+            const hit = this.agentPresets.find((p) => p.id === requested && !p.broken);
+            if (hit)
+                return hit.id;
+            // 名录还没拉到（启动中）但 clone 有它 → 先信 clone，挂载期再定。
+            if (this.presetCloneIds.includes(requested))
+                return requested;
+        }
+        const def = this.settings.defaultAgentPreset;
+        if (def) {
+            const hit = this.agentPresets.find((p) => p.id === def && !p.broken);
+            if (hit)
+                return hit.id;
+            if (this.presetCloneIds.includes(def))
+                return def;
+        }
+        return PRESET_DEFAULT_ID;
+    }
+    /** 推送预设名录 + 默认（attach/变化后；legacy 下 presets 空，前端隐藏）。 */
+    pushAgentPresets() {
+        this.emit({
+            type: "dsh_presets",
+            presets: this.agentPresets.map((p) => ({ ...p })),
+            defaultPreset: this.resolvePreset(),
+        });
+    }
+    /** 新会话默认预设（设置面板；非法 id 拒绝并提示）。 */
+    async setDefaultAgentPreset(preset) {
+        const hit = this.agentPresets.find((p) => p.id === preset && !p.broken);
+        const valid = hit ? hit.id : this.presetCloneIds.includes(preset) ? preset : null;
+        if (!valid) {
+            this.emit({
+                type: "notice",
+                level: "warning",
+                text: `未知预设「${preset}」，默认预设未改`,
+                textEn: `Unknown preset "${preset}"; default preset unchanged`,
+            });
+            return;
+        }
+        this.settings.defaultAgentPreset = valid;
+        this.stateStore.saveSettings(this.clientId, { defaultAgentPreset: valid });
+        this.pushSettings();
+        this.pushAgentPresets();
+        this.flushSnapshot();
+    }
+    /** 空白会话切换预设（首轮后锁定，官方语义；失败按 code 出双语 notice）。 */
+    async selectAgentPreset(preset) {
+        const conv = this.conv;
+        if (conv.presetLocked || conv.messages.length > 0) {
+            conv.presetLocked = true;
+            this.emit({
+                type: "notice",
+                level: "warning",
+                text: `会话已开始，预设锁定为「${this.presetName(conv.agentPreset)}」（空白会话可切换）`,
+                textEn: `Session already started; preset locked to "${this.presetName(conv.agentPreset)}" (only blank sessions can switch)`,
+            });
+            this.flushSnapshot();
+            return;
+        }
+        const target = this.resolvePreset(preset);
+        if (target === conv.agentPreset) {
+            this.flushSnapshot();
+            return;
+        }
+        try {
+            const res = await this.runtime.selectPreset(conv.sessionId, target);
+            if (!res.ok) {
+                if (res.code === "agent-preset/locked")
+                    conv.presetLocked = true;
+                this.emit({
+                    type: "notice",
+                    level: "warning",
+                    text: `预设切换失败：${res.code === "agent-preset/locked" ? "会话已开始，预设已锁定" : (res.message ?? res.code ?? "未知错误")}`,
+                    textEn: `Preset switch failed: ${res.code === "agent-preset/locked" ? "session already started; preset is locked" : (res.message ?? res.code ?? "unknown error")}`,
+                });
+                this.flushSnapshot();
+                return;
+            }
+            conv.agentPreset = res.preset ?? target;
+            this.emitConversations();
+            this.flushSnapshot();
+        }
+        catch (err) {
+            this.emit({
+                type: "notice",
+                level: "error",
+                text: `预设切换失败：${err.message}`,
+                textEn: `Preset switch failed: ${err.message}`,
+            });
+        }
+    }
+    /** 预设显示名（名录 name > id；供 notice/前端回退）。 */
+    presetName(id) {
+        return this.agentPresets.find((p) => p.id === id)?.name ?? id;
+    }
+    // -----------------------------------------------------------------------
+    // 权限预设（三档；官方 /permission 弹窗同源，Node 侧只做值守 + 转发）
+    // -----------------------------------------------------------------------
+    /** 校验三档值（非法 → 默认；组合里没有也照默认，前端按 options 取交集展示）。 */
+    resolvePermissionPreset(requested) {
+        if (requested && PERMISSION_OFFERED.includes(requested))
+            return requested;
+        const def = this.settings.defaultPermissionPreset;
+        if (def && PERMISSION_OFFERED.includes(def))
+            return def;
+        return PERMISSION_DEFAULT_PRESET;
+    }
+    /** 推选项表 + 默认（组合静态，options 为空 = 运行时未就绪/legacy，前端隐藏）。 */
+    pushPermission() {
+        this.emit({
+            type: "dsh_permission",
+            options: this.permissionOptions.map((o) => ({ ...o })),
+            defaultPreset: this.settings.defaultPermissionPreset,
+        });
+    }
+    /** 拉取权限选项表（运行时启动/重建后跑一次；失败 → 空，前端隐藏）。 */
+    async refreshPermissionOptions() {
+        try {
+            const res = await this.runtime.getPermission(this.conv.sessionId);
+            this.permissionOptions = Array.isArray(res.options) ? res.options : [];
+        }
+        catch {
+            this.permissionOptions = [];
+        }
+        this.pushPermission();
+    }
+    /** 拉取当前会话的权限预设值（激活/创建/切换/重启后跑；失败保持 null）。 */
+    async refreshActivePermission() {
+        const conv = this.conv;
+        try {
+            const res = await this.runtime.getPermission(conv.sessionId);
+            const cur = typeof res.currentValue === "string" ? res.currentValue : null;
+            if (cur && cur !== conv.permissionPreset) {
+                conv.permissionPreset = cur;
+                this.flushSnapshot();
+                return;
+            }
+            if (cur)
+                conv.permissionPreset = cur;
+        }
+        catch {
+            /* 运行时未就绪：保持 null/旧值 */
+        }
+        this.flushSnapshot();
+    }
+    /** 新会话默认权限预设（设置面板；非法值拒绝并提示）。 */
+    async setDefaultPermissionPreset(preset) {
+        if (!PERMISSION_OFFERED.includes(preset)) {
+            this.emit({
+                type: "notice",
+                level: "warning",
+                text: `未知权限预设「${preset}」，默认未改`,
+                textEn: `Unknown permission preset "${preset}"; default unchanged`,
+            });
+            return;
+        }
+        this.settings.defaultPermissionPreset = preset;
+        this.stateStore.saveSettings(this.clientId, { defaultPermissionPreset: preset });
+        this.pushPermission();
+        this.flushSnapshot();
+    }
+    /** 首轮 prompt 前：新会话应用 per-client 默认（与当前一致时 apply 无事件零噪音）。 */
+    async ensurePermissionDefault(conv) {
+        const target = this.resolvePermissionPreset();
+        try {
+            if (!conv.permissionPreset) {
+                const res = await this.runtime.getPermission(conv.sessionId);
+                if (typeof res.currentValue === "string" && res.currentValue)
+                    conv.permissionPreset = res.currentValue;
+            }
+            if (conv.permissionPreset && conv.permissionPreset !== target) {
+                const res = await this.runtime.setPermission(conv.sessionId, target);
+                if (res.ok)
+                    conv.permissionPreset = res.currentValue || target;
+            }
+        }
+        catch {
+            /* legacy/运行时未就绪：best effort */
+        }
+    }
+    /** 当前会话切换权限预设（热切换，无需重启；失败按 code 出双语 notice）。 */
+    async setPermissionPreset(preset) {
+        const conv = this.conv;
+        const target = this.resolvePermissionPreset(preset);
+        if (preset !== target) {
+            this.emit({
+                type: "notice",
+                level: "warning",
+                text: `未知权限预设「${preset}」，已回落「${target}」`,
+                textEn: `Unknown permission preset "${preset}"; fell back to "${target}"`,
+            });
+        }
+        try {
+            const res = await this.runtime.setPermission(conv.sessionId, target);
+            if (!res.ok) {
+                this.emit({
+                    type: "notice",
+                    level: "warning",
+                    text: `权限切换失败：${res.message ?? res.code ?? "未知错误"}`,
+                    textEn: `Permission switch failed: ${res.message ?? res.code ?? "unknown error"}`,
+                });
+                this.flushSnapshot();
+                return;
+            }
+            conv.permissionPreset = res.currentValue || target;
+            if (Array.isArray(res.options) && res.options.length > 0) {
+                this.permissionOptions = res.options;
+                this.pushPermission();
+            }
+            this.emitConversations();
+            this.flushSnapshot();
+        }
+        catch (err) {
+            this.emit({
+                type: "notice",
+                level: "error",
+                text: `权限切换失败：${err.message}`,
+                textEn: `Permission switch failed: ${err.message}`,
+            });
+        }
+    }
     async savePreset(name) {
         const presets = this.stateStore.getPresets(this.clientId);
         const existing = presets.find((p) => p.name === name);
@@ -3187,6 +3631,15 @@ export class DshClientSession {
             detail: pick(this.getLang(), "DSH 引擎不需要 pi CLI", "The DSH engine does not need the pi CLI", "dsh.engine.no.cli"),
         });
     }
+    /** DSH 是否就绪：auth.json 的 deepseek key 或环境变量 DEEPSEEK_API_KEY 任一即可。 */
+    isDshConfigured() {
+        return !!loadDeepSeekKey(this.agentDir) || !!process.env.DEEPSEEK_API_KEY;
+    }
+    /** 下拉框里的 deepseek-official 归一到 auth.json 的 deepseek 槽位（loadDeepSeekKey 只读它）。 */
+    normalizeDshProvider(provider) {
+        const pid = provider.trim();
+        return pid === "deepseek-official" ? "deepseek" : pid;
+    }
     async setProviderApiKey(provider, apiKey) {
         const key = apiKey.trim();
         if (!key) {
@@ -3203,7 +3656,7 @@ export class DshClientSession {
             catch {
                 /* new file */
             }
-            auth[provider.trim()] = { type: "api_key", key };
+            auth[this.normalizeDshProvider(provider)] = { type: "api_key", key };
             mkdirSync(dirname(authPath), { recursive: true });
             writeFileSync(authPath, JSON.stringify(auth, null, 2) + "\n");
             this.emit({
@@ -3226,7 +3679,7 @@ export class DshClientSession {
         }
     }
     async clearProviderApiKey(provider) {
-        const pid = provider.trim();
+        const pid = this.normalizeDshProvider(provider);
         try {
             const authPath = join(this.agentDir, "auth.json");
             const auth = JSON.parse(readFileSync(authPath, "utf8"));
@@ -3255,6 +3708,27 @@ export class DshClientSession {
             });
         }
     }
+    startProviderOAuth(_provider) {
+        this.emit({
+            type: "notice",
+            level: "warning",
+            text: "当前引擎不支持 OAuth 登录",
+            textEn: "The current engine does not support OAuth login",
+        });
+    }
+    replyProviderOAuth(_flowId, _promptId, _value) { }
+    cancelProviderOAuth(_flowId) { }
+    listProviderOAuthFlows() {
+        this.emit({ type: "provider_oauth_flows", flows: [] });
+    }
+    async logoutProviderOAuth(provider) {
+        this.emit({
+            type: "provider_oauth_logout_result",
+            provider,
+            ok: false,
+            error: "当前引擎不支持 OAuth 登录",
+        });
+    }
     async listModelsConfig() {
         this.emit({ type: "models_config", providers: [] });
     }
@@ -3289,8 +3763,11 @@ export class DshClientSession {
                 {
                     id: "deepseek-official",
                     name: pick(this.getLang(), "DeepSeek 官方", "DeepSeek Official", "dsh.provider.deepseek.official"),
-                    configured: !!loadDeepSeekKey(),
-                    source: loadDeepSeekKey() ? "stored" : undefined,
+                    configured: this.isDshConfigured(),
+                    source: loadDeepSeekKey(this.agentDir) ? "stored" : process.env.DEEPSEEK_API_KEY ? "environment" : undefined,
+                    supportsApiKey: true,
+                    supportsOAuth: false,
+                    usingOAuth: false,
                 },
             ],
         });