pi-web-ui 0.75.0 → 0.77.0

package/CHANGELOG.md

@@ -10,6 +10,59 @@
 
 ## [Unreleased]
 
+暂无未发布内容。
+
+## [0.77.0] — 2026-09-11
+
+### Added
+
+- 结构化派单工具 `delegate_task`：六段式派单（agent + TASK / EXPECTED OUTCOME / REQUIRED TOOLS / MUST DO / MUST NOT DO / CONTEXT，有最小长度）+ 服务端校验——模板不可用、缺段、太短直接报错打回，模型补全后重试。执行体复用子代理 spawn 通道（真会话、白名单、模型优先级、左栏徽标、等待/改向/停止）。前端派单卡片：卡头 ◈ agent 芯片 + 「查看子代理」一键跳转，六段式正文（脏参数不抛错）。
+- 7 个 specialist 子代理模板（移植自 oh-my-pi 内置 agents，改写为真子代理提示词）：`oracle`（只读架构/难 bug 顾问）、`librarian`（外部文档调研）、`explore`（代码库侦察）、`metis`（计划前澄清）、`momus`（计划评审）、`multimodal-looker`（PDF/图片/图表解读）、`sisyphus-junior`（单点执行）。`subagent_spawn(template=)` 直接选用；老用户已有模板文件时一次性自动补齐（sidecar 记录已播种名单，此后删除不再复活）。
+- skill 全文注入（设置 → 技能页，按技能单独勾选“全文”）：勾选的技能 `{{skills}}` 展开为正文（oh-my-pi 式 `### Skill:` / 引用描述 / 全文格式；单文件 8KB、总量 32KB 封顶，超限回落名录），不勾选的仍为名录由模型按需读取。改动下一轮即生效，随预设保存/应用。
+- Agent 工具统一开关：设置新增「工具」tab，18 个工具（持久终端 7＋子代理 7＋`edit_soft`/`delegate_task`/`ask_user_question`/`markers_list`）逐个开关，标记管理（总开关＋分组＋查询工具）也并入该 tab（原标记页移除），后端收成 `tool-manager.ts` 单一出入口（`setAgentToolEnabled`/`applyAgentToolsGating`），改动 live 生效无需 reload，随预设保存/应用；旧的终端/编辑/问卷开关自动迁移，旧客户端照常用。
+
+### Fixed
+
+- 排队气泡的 ✕ 只删一条（#113）：`removeFirstOccurrence(list, text)`（`server/queue-utils.ts`，纯函数可单测）只移除第一处匹配，`removeQueued` 的两条队列（插队 / 排队）都改用它。旧实现重建队列时用值过滤（`filter((t) => t !== text)`），同一条文本被排队两次时点一次 ✕ 会把两条一起删掉，而气泡只消失一条（要等下一次 `queue_update` 才对齐）；现在与气泡 UI、本地显示镜像、DSH 引擎的「删第一条」语义一致。回归 `tests/unit/queue-utils.test.ts`（6 例）。
+- 手机端聊天内容贴边（列内缩被算成 0）：两个原因都堵上了。① `--chat-pad` 回调到 14px（= 改前 `.msg` 自带的 14px 内边距）——中央列收敛成一条 token 时手机上取了 10px，消息文字/卡片比原来贴边 4px，输入框也跟着从 10px 调到 14px，两边仍齐平。② `--msgs-gutter` 不再只信首帧前的探针：`.messages` 挂载后改用真实元素实测并覆盖，窗口尺寸变化（含手机横竖屏）时再校一次——个别浏览器/设备上探针与真实滚动容器的 gutter 对不上，会把消息列多缩/少缩一条 gutter。另外 `.messages` 的左右内缩改成 `max(0px, calc(--chat-inset - --msgs-gutter))`、上下留白改用 `padding-block` 独立声明：相减出负值时旧写法会让整条 `padding` 声明失效（连上下留白一起丢，内容直接贴边），现在最坏只是不扣那一条 gutter。回归 `tests/chat-column-align-test.mjs` 增加「消息列不贴边」断言（内缩不得小于列留白）。
+- 输入框底部工具条在窄屏下重叠：428px 左右「思考」chip 会压到右侧的 发送/停止（流式时右侧最宽）。两处修正：① 工具条里的 chip（含外层 `.dropdown` 锚点）补上 `min-width: 0` / `flex-shrink: 1`，模型名与思考等级先收缩、再省略号截断，不再溢出到右侧按钮上（桌面窗口窄到主列放不下时同样有用）；② 纯图标阈值从 420px 提到 560px：窄屏直接隐藏 模型名/思考等级/下拉箭头，chip 放大到 34×30，只留图标（文字交给 title 悬浮）。回归 `tests/composer-overlap-test.mjs`（320–1200px 扫描，注入流式时的「排队|插队」对半胶囊，断言左侧不压右侧、胶囊 78px 且两半等宽、≤560px chip 只剩图标）。
+
+### Changed
+
+- 新增全局运行态 `web/src/app-globals.ts`（模块级 store + `useSyncExternalStore`，`useAppGlobals()` / `useIsDsh()` / `useIsManaged()`）：`engine`、`managed`、`tabs`、`appVersion`、`serverVersion` 这些「整棵树都要知道、整个连接内只变一次」的信息不再从 App 逐层传 props —— GoalBar / SettingsModal / PiSetupModal / TopBar / FooterBar / ChatInput 改读全局（DSH 的四处 gating、受管实例的更新/插件入口都不再依赖“谁记得传这个 prop”）。写入点只有一处：`use-chat.ts` 收到 `ready` 时（同步于 dispatch 之前，不会闪一帧 pi）。顺带修正 DSH 下「插队」名不副实：DSH 无 mid-run steering（prompt 一律 followUp），运行中只渲染「排队」半段（收成 38px 圆），placeholder 也换成 `placeholderStreamingQueued`（回车与点排队都是本轮结束后才发）。回归 `tests/unit/app-globals.test.ts`。
+- WebSocket 发送器也收进全局：`appSend`（`web/src/app-globals.ts` 下半部分，`use-chat` 用 `setAppSend` 装配）—— 19 个组件的 `send` prop 全部删除，`App.tsx` 少 19 处逐层传参（对话框/弹窗/面板/插件视图/终端/SCM/底栏全部自己取），`ClientMessage` 依赖也随之从这些文件消失；测试（`dsh-question-dialog.test.ts`）改用 `setAppSend` 注入并记录发出的消息，组件仍可测。两个例外是故意的：`LeftPanel` / `RightPanel` 的 prop 改名为 `panelSend`（它们拿的是 App 的包装函数，带「顺手关手机抽屉」的副作用，不能换成全局发送器）；装配写在 render 期间而非 effect —— 子组件 effect 先于父组件跑，放 effect 里装配会让「挂载即发请求」的弹窗在 appSend 还是空的时候静默丢包。
+- 全局运行态再扩三项：`ready` / `status` / `cwd`。`LeftPanel`（三个都收）、`RightPanel`（cwd）、`ChatInput`（ready）、`GlobalSearchModal`（cwd）不再要这些 prop，改从 `useAppField(key)` 单字段订阅 —— cwd 是低频字段，单字段订阅让「切项目」的通知只到真正读 cwd 的组件，不会连带重渲染只读 engine 的组件。写入点：`use-chat.ts` 里一个 effect 把 reducer 的真值镜像过去（单一来源，最多晚一帧；默认值只会是「未就绪 / 未连接 / 空目录」，看不出来）。本来就吃整个 ChatState 的 `App` / `TopBar` / `FooterBar` 仍直读 `chat.*`（自己就持有数据，不必绕一圈）。
+- 运行中发送位改成「排队｜插队」对半胶囊：空闲态那颗发送圆钮在流式中原地变形为 78×38 的蓝胶囊，两半各 38px、中间一条 1px 半透明白线——左半「排队」（列表图标，加入队列，整轮跑完才发）、右半「插队」（↑，回车语义，本回合立刻响应，与 Enter 同一条路径）。原文字版「排队」药丸及其 ≤560px「收成图标」的兜底一并删除（窄屏右侧最宽从文字药丸降到固定 78px）；空输入时整颗胶囊变暗、两半禁用（尺寸位置不动，工具条不跳），有文字或纯附件时解锁。停止语义与它们相反，仍是右侧独立的蓝圆，不并入胶囊。`tests/supplement-test.mjs` 同步改为点左半，并断言「空输入两半禁用 → 输入后解锁」。文案变更：前端新增 key `steerTip`。
+- 设置面板减负：常驻列表里的静态解释全部收进标题/开关旁的「?」悬浮提示（含 7 个「已关闭」后果说明、重试次数、子代理默认模型、全文注入说明等）；行内只保留计数、空状态、报错与动态状态（如当前转写模型）。文案 key 无增减。
+- 问卷（`ask_user_question`）不再被工具挂死看门狗剁掉：以前它跟普通工具一样被算作「一个工具跑了 20 分钟」（`PI_WEB_TOOL_TIMEOUT_MS`），到点就 abort 整轮对话并弹「工具执行超过…已自动终止」——把还在思考的用户连对话一起终止。现在按工具名豁免：问卷等的是人类回答，不是挂死的工具，收场只走用户回答/取消与会话 dispose，**不限时**。同理，问卷挂着也不再算「失联」（stall 告警默认 180s 无 SDK 事件，对该对话跳过）。同时补上「刷新/重连后问卷对话框不再消失」：`question_pending` 是即时通道，只推给提问那一刻在线的连接，刷新页面/新标签页都拿不到那条历史消息，而服务端还在阻塞等人回答；现在待答问卷同时挂在快照（`UiState.pendingQuestion`，标准引擎只带当前对话的那张，切回原对话会重推快照）上，两个引擎（标准 pi / DSH）重连后都会把面板恢复出来，由快照恢复的面板也能被快照收起（另一标签页答完/服务端取消），但即时通道弹出的面板不会被在途旧快照闪掉，已答过的问卷也不会被在途旧快照重新弹出。回归 `tests/question-bridge-test.mjs`（零 token，本地假模型驱动整条链路）+ `tests/unit/pending-question.test.ts`。
+
+<!-- auto-i18n:start -->
+### i18n
+
+- 前端新增 key（28）：`placeholderStreamingQueued`、`steerTip`、`settingsTools`、`toolsSectionTerminal`、`toolsSectionSubagent`、`toolsSectionOther`、`toolsSubagentDepHint`、`delegateTaskEnabledDesc`、`delegateTaskOffHint`、`todoListEnabledDesc`、`todoListOffHint`、`toolDescSubagentSpawn`、`toolDescSubagentGetResult`、`toolDescSubagentSteer`、`toolDescSubagentList`、`toolDescSubagentStop`、`toolDescSubagentWaitAll`、`toolDescSubagentTemplates`、`skillFullTextLabel`、`skillFullTextDesc`、`skillFullTextShort`、`delegateOpenSubagent`、`delegateSecTask`、`delegateSecExpected`、`delegateSecTools`、`delegateSecMustDo`、`delegateSecMustNotDo`、`delegateSecContext`
+- 服务端新增 key（3）：`delegate.validate.agent`、`delegate.validate.short`、`delegate.started`
+<!-- auto-i18n:end -->
+
+## [0.76.0] — 2026-09-11
+
+### Added
+
+- 桌面通知的诊断能力（默认不显示在界面上）：`sendTestNotification()` 会立刻发一条系统通知（不受「页面不在眼前」抑制影响，且带 `requireInteraction` 不会自己滑走），并汇报走的是 service worker 还是页面通知、失败原因、**浏览器到底有没有留下这条通知**（`getNotifications()`，区分「系统层面被压住」与「浏览器直接丢了」）与判定依据（焦点 / 可见性 / 是否最小化 / 空闲秒数）。界面在 `web/src/components/NotifyToggle.tsx` 的 `SHOW_NOTIFY_TEST_PANEL` 常量后面，排障时改成 `true`。
+
+### Fixed
+
+- **Windows 上窗口最小化后依然收不到任何桌面通知**（v0.75.0 只修了一半）：Win11 实测，窗口最小化后 `document.hasFocus()` 仍是 `true`、`visibilityState` 仍是 `"visible"`，连 `blur`/`visibilitychange` 都不发 —— 「只看焦点」和「焦点 **且** 可见」两种条件都在这个场景下把通知全部静默掉。现在改用只有最小化会变的那组信号判定（原生窗口矩形：`screenX/screenY` 跳到屏幕外的「最小化坐标」，`outerWidth/Height` 塌成标题栏；`isCollapsedWindow`，有单测），并且在 Windows 上额外要求「最近 2 分钟内有过页面交互」才背静默 —— 这个平台的焦点/可见性都不可信，宁可多提醒一次也不漏。非 Windows 平台行为不变（其焦点/可见性可信）。
+- 通知发送路径不再因 service worker 抛错而彻底静默：注册存在但还没 active（首次加载 / 刚更新后）时 `showNotification` 会失败，现在会退回页面通知，两者都失败也会把原因带出来（诊断按钮里看得到）。
+- 修掉「只有第一次弹、之后怎么都不弹」：通知带固定 `tag` 时，Windows 把同 tag 的新通知当成**替掉旧条目**，而且是静默的 —— 没有横幅、没有提示音，只要系统通知中心里还躺着一条 pi-web-ui 通知，后续每一条都会被无声替换（页面上看 `showNotification` 明明成功了）。现在干脆不用 tag（也不依赖 `renotify` —— 实测它在 Windows toast 这层不起作用），每条都是全新 toast；代价是通知中心里会累积几条。
+
+<!-- auto-i18n:start -->
+### i18n
+
+- 前端新增 key（9）：`notifyTest`、`notifyTestBody`、`notifyTestSent`、`notifyTestFailed`、`notifyTestState`、`notifyTestHeld`、`notifyTestDropped`、`notifyTestGateSuppressed`、`notifyTestGateOpen`
+- 前端中文变更（1）：`notifyEnableDesc`
+- 前端英文变更（1）：`notifyEnableDesc`
+<!-- auto-i18n:end -->
+
 ## [0.75.0] — 2026-09-11
 
 ### Added
@@ -372,7 +425,9 @@
 - 0.35.1（2026-08-27）：编辑重问保留附件（#18）+ 全窗口拖放（#19）。
 - 0.29.0（2026-08-23）：全局搜索弹窗（Ctrl+K）+ 消息列表惰性窗口化。
 
-[Unreleased]: https://github.com/xing-shuyin/pi-web-ui/compare/v0.75.0...main
+[Unreleased]: https://github.com/xing-shuyin/pi-web-ui/compare/v0.77.0...main
+[0.77.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.77.0
+[0.76.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.76.0
 [0.75.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.75.0
 [0.74.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.74.0
 [0.73.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.73.0

package/dist/server/agent-service.js

@@ -25,6 +25,7 @@ import { Type } from "typebox";
 import { BgServerTracker } from "./bg-servers.js";
 import { checkAll as checkAllUpdates, collectTargets, compareVersions as compareSemver, } from "./update-check.js";
 import { hasActiveSubagentRun, hasPendingWaitSubscription, shouldRetainActive } from "./wait-subscription-scan.js";
+import { removeFirstOccurrence } from "./queue-utils.js";
 import { syncPluginToolsIntoSession } from "./plugins.js";
 import { SettingsService } from "./settings-service.js";
 import { GoalService } from "./goal-service.js";
@@ -32,13 +33,16 @@ import { MarkerService } from "./marker-service.js";
 import { SlashCommandsService, parseSlash } from "./slash-commands.js";
 import { ModelAdminService } from "./model-admin.js";
 import { FilesService, MACHINE_ROOT, workspacePath } from "./files-service.js";
-import { isExtensionDisabled, isExtensionEnabled, normalizeRetryMaxAttempts, ClientStateStore, } from "./client-state.js";
-import { pick, resolveServerLang } from "./i18n.js";
+import { isExtensionDisabled, isExtensionEnabled, normalizeRetryMaxAttempts, normalizeSkillList, ClientStateStore, } from "./client-state.js";
+import { bilingual, pick, resolveServerLang } from "./i18n.js";
 import { SubagentTemplatesStore, pickTemplatePrompt } from "./subagent-templates.js";
-import { applyHeadTail, makePersistentTerminalTools, makeTerminalBashTool, stripAnsi, TERMINAL_TOOLS_GUIDANCE, TERMINAL_TOOL_NAMES, } from "./terminals.js";
+import { applyHeadTail, makePersistentTerminalTools, makeTerminalBashTool, stripAnsi, TERMINAL_TOOLS_GUIDANCE, } from "./terminals.js";
+import { applyAgentToolsGating, ASK_USER_QUESTION_TOOL_NAME, effectiveDisabledAgentTools, isTerminalGuidanceOn, MARKERS_LIST_TOOL_NAME, } from "./tool-manager.js";
 import { WebUIContext, mockThemeProxy } from "./webui-context.js";
-import { makeEditSoftTool, SOFT_EDIT_TOOL_NAME } from "./edit-soft-tool.js";
+import { decodeText } from "./text-sniff.js";
+import { makeEditSoftTool } from "./edit-soft-tool.js";
 import { collectSubagentDescendantIds, makeSubagentTools, subagentTitle, withSubagentOwner, } from "./subagents.js";
+import { makeDelegateTaskTool } from "./delegate-task.js";
 import { buildAttachmentMessages } from "./attachments.js";
 import { BUILTIN_SOUL, DEFAULT_PROMPT_TEMPLATE, buildToolsSchemaText, renderPromptTemplate, resolveSectionTexts, } from "./prompt-composer.js";
 import { serializeMessage, serializeStreamingMessage, stripTransientRetryErrors, } from "./serialize.js";
@@ -195,11 +199,11 @@ export function makeAdaptiveBashTool(killable, terminalBacked, useTerminal) {
     };
 }
 /**
- * 内置标记只读查询工具（markers_list）— 读操作仍走真工具。
+ * 任务列表只读查询工具（todo_list）— 读操作仍走真工具。
  */
 function makeMarkersListTool(getActiveId, markerSvc) {
     return {
-        name: "markers_list",
+        name: MARKERS_LIST_TOOL_NAME,
         label: "List marker state",
         description: "Read-only query of inline marker state. All WRITE operations must use inline markers ([[todo:new:...]] etc.) in the reply body — never use this tool for writes.\n只读查询内联标记状态。状态【写】操作请一律用内联标记（[[todo:new:...]] 等）写在回答正文里，不要调用本工具做写操作。",
         parameters: Type.Object({
@@ -235,7 +239,9 @@ function makeMarkersListTool(getActiveId, markerSvc) {
  * 服务于整个 agent 生命周期，这里按「已中止即拒绝」的最小语义处理，避免与其它
  * 工具的取消逻辑纠缠。
  */
-export function makeAskUserQuestionTool(clientSession) {
+export function makeAskUserQuestionTool(clientSession, 
+/** 本 runtime 所属会话：提问跟着对话走，快照只把当前对话的问卷推给客户端。 */
+ownerId) {
     const QuestionOptionSchema = Type.Object({
         label: Type.String({ description: "Display label for the option" }),
         description: Type.Optional(Type.String({ description: "Optional description shown below label" })),
@@ -255,6 +261,11 @@ export function makeAskUserQuestionTool(clientSession) {
         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.",
+        promptSnippet: bilingual("ask the user focused questions to clarify ambiguous requirements (browser dialog with options/preview)", "向用户提问以澄清含糊的需求（浏览器对话框，支持选项/预览）"),
+        promptGuidelines: [
+            bilingual("When requirements are ambiguous, use ask_user_question to ask the user instead of guessing; prefer multiple-choice options, each option may carry a preview", "需求含糊时用 ask_user_question 向用户提问而不是猜测；优先给多选选项，选项可带 preview 预览"),
+            bilingual("A cancelled question comes back as a tool error — respect it and continue without re-asking immediately", "用户取消提问会以工具错误返回——尊重取消决定，不要马上重复追问"),
+        ],
         parameters: Type.Object({
             questions: Type.Array(QuestionSchema, { description: "Questions to ask the user" }),
         }),
@@ -265,7 +276,7 @@ export function makeAskUserQuestionTool(clientSession) {
             }
             const answers = await clientSession.askUser(qs, {
                 aborted: signal?.aborted,
-            });
+            }, ownerId);
             if (answers === null) {
                 throw new Error("User cancelled the question.\n用户取消了提问。");
             }
@@ -917,14 +928,41 @@ export class ClientSession {
             piExamples: PI_DOC_PATHS.examples,
             appendFiles: this.lastSdkAppendFiles,
             windowsPersona: process.platform === "win32" ? WINDOWS_PERSONA : "",
-            terminalGuidance: this.settingsSvc.current.terminalToolsEnabled !== false ? TERMINAL_TOOLS_GUIDANCE : "",
+            terminalGuidance: isTerminalGuidanceOn(effectiveDisabledAgentTools(this.settingsSvc.current))
+                ? TERMINAL_TOOLS_GUIDANCE
+                : "",
             markersGuidance: this.markerSvc.buildGuidance(),
             // issue #91：组合模板各来源段按客户端 UI 语言渲染（英文默认）。
             lang: this.getLang(),
             contextFiles: src.contextFiles,
-            skills: src.skills,
+            skills: this.fillSkillContents(src.skills),
+            skillsFullText: normalizeSkillList(this.settingsSvc.current.skillsFullText),
         };
     }
+    /** skill 全文注入（{{skills}} 全文模式）：最好努力读名单里技能的文件正文。
+     * 单文件 8KB、总量 32KB 封顶，失败/超限/不在名单回落名录（无 content）。
+     * 名单为空时零开销：原样返回，不碰磁盘。 */
+    fillSkillContents(skills) {
+        const wanted = new Set(normalizeSkillList(this.settingsSvc.current.skillsFullText));
+        if (wanted.size === 0)
+            return skills;
+        let budget = 32 * 1024;
+        return skills.map((s) => {
+            if (!wanted.has(s.name) || !s.filePath || budget <= 0)
+                return s;
+            try {
+                const st = statSync(s.filePath);
+                if (!st.isFile() || st.size <= 0 || st.size > 8192)
+                    return s;
+                const raw = decodeText(readFileSync(s.filePath).subarray(0, Math.min(st.size, budget))).trim();
+                budget -= raw.length;
+                return raw ? { ...s, content: raw } : s;
+            }
+            catch {
+                return s;
+            }
+        });
+    }
     /** 渲染当前组合模板。模板为空且无任何覆盖时返回 undefined（用 SDK 默认拼装，
      *  零开销且与原始行为逐字节一致）。 */
     renderMainCompose(src) {
@@ -1094,6 +1132,8 @@ export class ClientSession {
     // 工具结果（agent 循环阻塞）。一次只展示一个提问（agent 阻塞在工具执行）。
     // -----------------------------------------------------------------------
     questionSeq = 0;
+    /** 待答提问（id → 载荷 + resolve）。一次正常只有一个（agent 阻塞在工具执行）；
+     *  conversationId 记录谁问的：看门狗豁免、快照恢复都靠它。 */
     pendingQuestions = new Map();
     constructor(clientId, cwd, agentDir, stateStore) {
         this.clientId = clientId;
@@ -1146,6 +1186,7 @@ export class ClientSession {
                 await this.pushSlashCommands();
             },
             applyRetryOverrides: () => this.applyRetryOverrides(),
+            applyToolGating: () => this.applyToolGating(this.session),
             promptSnapshot: () => this.promptSnapshot(),
             getMarkerState: () => ({
                 markersEnabled: this.markerSvc.current.markersEnabled,
@@ -1275,9 +1316,10 @@ export class ClientSession {
                             // GBK 老中文文件让模型改用终端按正确编码读（iconv/chcp/Get-Content）。
                             out.push(WINDOWS_PERSONA);
                         }
-                        if (this.settingsSvc.current.terminalToolsEnabled !== false) {
+                        if (isTerminalGuidanceOn(effectiveDisabledAgentTools(this.settingsSvc.current))) {
                             // 终端工具使用引导（全平台）：告诉模型什么场景该用持久终端
                             // 而不是一次性 bash——没有这段模型几乎从不主动选终端工具。
+                            // 组内工具全关时不注入（不教 AI 用不存在的工具）。
                             out.push(TERMINAL_TOOLS_GUIDANCE);
                         }
                         // bash 管道限制已并入 bash 工具自身的 description，不再作为独立提示段注入。
@@ -1395,12 +1437,17 @@ export class ClientSession {
                     ...(ownerId
                         ? makeSubagentTools(withSubagentOwner(this.subagentHost, ownerId), undefined, ownerId)
                         : makeSubagentTools(this.subagentHost)),
+                    // 结构化派单（六段式 + 服务端校验；执行体复用子代理 spawn 通道）。
+                    // owner 包装与上面同理：子代理记到真正的派发会话名下。
+                    ...(ownerId
+                        ? [makeDelegateTaskTool(withSubagentOwner(this.subagentHost, ownerId))]
+                        : [makeDelegateTaskTool(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),
+                    makeAskUserQuestionTool(this, ownerId),
                 ],
             });
             // 终端工具开关从创建起就生效（工具始终注册进注册表，只调活跃集）。
@@ -1574,7 +1621,11 @@ export class ClientSession {
                 return;
             const now = Date.now();
             for (const conv of this.convs.values()) {
-                if (!conv.stallNoticed && conv.session.isStreaming && now - conv.lastSdkEventAt > STALL_NOTIFY_MS) {
+                // 正在等用户回答的对话本就该「无声」——那是人在想，不是失联。
+                if (!conv.stallNoticed &&
+                    conv.session.isStreaming &&
+                    !this.isWaitingOnUser(conv.id) &&
+                    now - conv.lastSdkEventAt > STALL_NOTIFY_MS) {
                     conv.stallNoticed = true;
                     const mins = Math.round((now - conv.lastSdkEventAt) / 60_000);
                     this.emit({
@@ -1723,7 +1774,12 @@ export class ClientSession {
                 if (event.toolName === "bash") {
                     this.bg.snapshotBefore();
                 }
-                this.armToolWatchdog(conv, event.toolCallId);
+                // 看门狗豁免：ask_user_question 阻塞等的是「人类回答」，不是挂死的工具
+                // （默认 20 分钟会把还在思考的用户连对话一起剁掉）。它的收场自有路子：
+                // 用户回答/取消、会话 dispose（cancelPendingQuestions），不限时。
+                if (event.toolName !== ASK_USER_QUESTION_TOOL_NAME) {
+                    this.armToolWatchdog(conv, event.toolCallId);
+                }
                 // 插件扩展点：工具开始执行（异常由 emitToolEvent 隔离）。
                 this.onToolEvent?.({
                     phase: "start",
@@ -2251,6 +2307,7 @@ export class ClientSession {
             errorMessage: state.errorMessage,
             retry: conv.retryState ?? null,
             compaction: conv.compactionState ?? null,
+            pendingQuestion: this.pendingQuestionForSnapshot(),
             tools: state.tools.map((t) => t.name),
             version: ++this.version,
             piConfigured: this.isPiConfigured(),
@@ -2316,20 +2373,25 @@ export class ClientSession {
     // -----------------------------------------------------------------------
     /** 标准引擎模型调 ask_user_question：发 question_pending 给浏览器并阻塞等待
      *  question_answer。sig 为工具执行信号的当前状态（aborted → 立即 reject）。
-     *  返回 answers（用户选中/自定义），或 null（用户取消）。 */
-    askUser(questions, sig) {
+     *  返回 answers（用户选中/自定义），或 null（用户取消）。
+     *
+     *  不设超时：等的是「人类回答」，不是挂死的工具。因此也不进工具挂死看门狗
+     *  （见 tool_execution_start）、不算 stall 失联（见 startStallTimer）。 */
+    askUser(questions, sig, conversationId) {
         return new Promise((resolve, reject) => {
             if (sig?.aborted || this.disposed) {
                 reject(new Error("ask_user_question 已中止"));
                 return;
             }
             // 问卷开关（默认开）：关 → 不弹对话框，立即报错让模型得知已禁用。
-            if (this.settingsSvc.current.questionnaireEnabled === false) {
+            // 与统一工具门控双保险：工具 tab 里单独关掉 ask_user_question 也一样拒收。
+            if (this.settingsSvc.current.questionnaireEnabled === false ||
+                (this.settingsSvc.current.disabledAgentTools ?? []).includes(ASK_USER_QUESTION_TOOL_NAME)) {
                 reject(new Error("问卷功能已关闭，可在设置中重新开启"));
                 return;
             }
             const id = `q-${++this.questionSeq}`;
-            this.pendingQuestions.set(id, resolve);
+            this.pendingQuestions.set(id, { resolve, questions, conversationId });
             this.emit({
                 type: "question_pending",
                 id,
@@ -2341,22 +2403,40 @@ export class ClientSession {
      *  pendingQuestions 中键；cancelled 或未匹配（例如用户早已切走）时按「取消」处理
      *  —— 把挂起的提问全部 reject，让模型知道用户离开了。 */
     resolveQuestion(id, answers, cancelled) {
-        const resolve = this.pendingQuestions.get(id);
-        if (resolve) {
+        const pending = this.pendingQuestions.get(id);
+        if (pending) {
             this.pendingQuestions.delete(id);
-            resolve(cancelled ? null : answers);
+            pending.resolve(cancelled ? null : answers);
         }
     }
+    /** 快照侧的待答提问（UiState.pendingQuestion）：只带当前对话的问卷——切回
+     *  原对话会重推快照，对话框随之回来（重连/刷新/第二标签页的恢复通道）。 */
+    pendingQuestionForSnapshot() {
+        for (const [id, p] of this.pendingQuestions) {
+            if (p.conversationId !== undefined && p.conversationId !== this.activeId)
+                continue;
+            return { id, questions: p.questions };
+        }
+        return null;
+    }
+    /** 对话是否阻塞在等用户回答上（用于 stall 失联判定豁免）。 */
+    isWaitingOnUser(conversationId) {
+        for (const p of this.pendingQuestions.values()) {
+            if (p.conversationId === undefined || p.conversationId === conversationId)
+                return true;
+        }
+        return false;
+    }
     /** 标准引擎的 question_answer 路由入口（index.ts 经 cs.answerQuestion?. 转发）。
      *  DSH 引擎的 AgentService 也实现了同名方法，此处为 ClientSession 的转发。 */
     answerQuestion(id, answers, cancelled) {
         this.resolveQuestion(id, answers, cancelled);
         return Promise.resolve();
     }
-    /** 关闭所有挂起提问（切对话 / dispose 时清理）：以「取消」解析，避免模型挂死。 */
+    /** 关闭所有挂起提问（dispose 时清理）：以「取消」解析，避免模型挂死。 */
     cancelPendingQuestions() {
-        for (const [, resolve] of this.pendingQuestions) {
-            resolve(null);
+        for (const [, p] of this.pendingQuestions) {
+            p.resolve(null);
         }
         this.pendingQuestions.clear();
     }
@@ -2927,29 +3007,19 @@ export class ClientSession {
     async applyRuntimeSettings() {
         return this.settingsSvc.applyRuntime();
     }
-    /** 把终端工具开关应用到 session 的活跃工具集：关闭时从活跃集中剔除
-     *  terminal_*（工具仍留在注册表，重开时可直接加回）。session.reload() 与新
-     *  会话创建都会把 custom 工具加回活跃集，所以这两条路径之后都要重放本方法。 */
+    /** 统一工具门控（tool_manage 唯一落点）：按 disabledAgentTools 把目录内工具
+     *  逐个加回/剔除活跃集（工具仍留在注册表，重开可直接加回；live 生效无需
+     *  reload）。session.reload() 与新会话创建都会把 custom 工具加回活跃集，
+     *  所以这两条路径之后都要重放本方法（见 reloadSession/创建处）。 */
     applyToolGating(session) {
-        try {
-            const terminalEnabled = this.settingsSvc.current.terminalToolsEnabled !== false;
-            const softEditEnabled = this.settingsSvc.current.editSoftEnabled !== false;
-            const names = new Set(session.getActiveToolNames());
-            for (const n of TERMINAL_TOOL_NAMES) {
-                if (terminalEnabled)
-                    names.add(n);
-                else
-                    names.delete(n);
-            }
-            if (softEditEnabled)
-                names.add(SOFT_EDIT_TOOL_NAME);
-            else
-                names.delete(SOFT_EDIT_TOOL_NAME);
-            session.setActiveToolsByName([...names]);
-        }
-        catch {
-            // Session 未就绪——下次创建/reload 会再应用。
-        }
+        applyAgentToolsGating(session, effectiveDisabledAgentTools(this.settingsSvc.current));
+        // SDK 的 setActiveToolsByName 只改 agent.state.tools，不派发任何事件——门控后
+        // 主动推一次快照，否则快照里的 tools 要等下一个 SDK 事件才对齐（会话空闲时永远
+        // 等不到；回归：tests/terminal-smoke-test.mjs「agent exposes persistent terminal tools」）。
+        // 只在被门控的就是活跃会话时推（创建早期活跃对话可能还没绑定；创建流程自带快照）。
+        const active = this.convs.get(this.activeId);
+        if (active && active.session === session)
+            this.flushSnapshot();
     }
     /** 把插件 AI 工具同步进一个已存在的会话（新增/更新/移除）。
      *  实际 diff 逻辑在 plugins.ts 的 syncPluginToolsIntoSession（可单测）。 */
@@ -3265,8 +3335,10 @@ export class ClientSession {
             return;
         }
         const { steering, followUp } = s.clearQueue();
-        const keptSteering = steering.filter((t) => !(kind === "steer" && t === text));
-        const keptFollowUp = followUp.filter((t) => !(kind === "followUp" && t === text));
+        // 只移除第一条匹配：气泡 ✕ 对应的是「一条」消息，重复文本不能连带删除
+        // （旧实现用值过滤会把所有同文本项一起删掉，与本地显示镜像不一致）。
+        const keptSteering = kind === "steer" ? removeFirstOccurrence(steering, text) : steering;
+        const keptFollowUp = kind === "followUp" ? removeFirstOccurrence(followUp, text) : followUp;
         // Re-queue the survivors in original order. Guard each call so a single
         // failure can't leave the queue half-drained silently.
         for (const t of keptSteering) {

package/dist/server/client-state.js

@@ -8,6 +8,7 @@
  */
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
+import { deriveLegacy, legacyToDisabled, normalizeDisabledAgentTools } from "./tool-manager.js";
 /** 大模型 API 出错自动重试次数的默认值（SDK 默认 3）。 */
 export const DEFAULT_RETRY_MAX_ATTEMPTS = 6;
 /** 归一化重试次数：非数值回落默认，钳制到 [0, 100] 整数。 */
@@ -17,6 +18,10 @@ export function normalizeRetryMaxAttempts(v) {
         return DEFAULT_RETRY_MAX_ATTEMPTS;
     return Math.min(100, Math.max(0, n));
 }
+/** 归一化技能名单：字符串数组原样过滤；其他（含旧 bool 开关）回落空数组。 */
+export function normalizeSkillList(v) {
+    return Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
+}
 /** Stable identity of an extension for the enable/disable toggle: the npm
  *  spec for packages (survives version bumps), the resolved entry path
  *  otherwise. */
@@ -229,14 +234,23 @@ export class ClientStateStore {
             promptOverrides,
             disabledSkills: stored?.disabledSkills ?? [],
             disabledExtensions: stored?.disabledExtensions ?? [],
-            terminalToolsEnabled: stored?.terminalToolsEnabled ?? false,
+            disabledAgentTools: legacyToDisabled(stored ?? {}),
+            // 新字段已存在时遗留三开关以它为准推导（旧文件才读遗留值），保证两边一致。
+            terminalToolsEnabled: stored?.disabledAgentTools !== undefined
+                ? deriveLegacy(legacyToDisabled(stored)).terminalToolsEnabled
+                : (stored?.terminalToolsEnabled ?? false),
             terminalBash: stored?.terminalBash ?? false,
             terminalBashIdleMs: stored?.terminalBashIdleMs ?? 15_000,
-            editSoftEnabled: stored?.editSoftEnabled ?? false,
-            questionnaireEnabled: stored?.questionnaireEnabled ?? true,
+            editSoftEnabled: stored?.disabledAgentTools !== undefined
+                ? deriveLegacy(legacyToDisabled(stored)).editSoftEnabled
+                : (stored?.editSoftEnabled ?? false),
+            questionnaireEnabled: stored?.disabledAgentTools !== undefined
+                ? deriveLegacy(legacyToDisabled(stored)).questionnaireEnabled
+                : (stored?.questionnaireEnabled ?? true),
             goalModeEnabled: stored?.goalModeEnabled ?? true,
             thinkingWrap: stored?.thinkingWrap ?? false,
             toolsWrap: stored?.toolsWrap ?? true,
+            skillsFullText: normalizeSkillList(stored?.skillsFullText),
             visionBridgeEnabled: stored?.visionBridgeEnabled ?? true,
             visionBridgeModel: stored?.visionBridgeModel ?? null,
             visionBridgePromptMode: stored?.visionBridgePromptMode === "replace" ? "replace" : "append",
@@ -262,6 +276,7 @@ export class ClientStateStore {
             promptOverrides: { ...(settings.promptOverrides ?? cur.promptOverrides) },
             disabledSkills: settings.disabledSkills ?? cur.disabledSkills ?? [],
             disabledExtensions: settings.disabledExtensions ?? cur.disabledExtensions ?? [],
+            disabledAgentTools: normalizeDisabledAgentTools(settings.disabledAgentTools ?? cur.disabledAgentTools),
             terminalToolsEnabled: settings.terminalToolsEnabled ?? cur.terminalToolsEnabled ?? false,
             terminalBash: settings.terminalBash ?? cur.terminalBash ?? false,
             terminalBashIdleMs: settings.terminalBashIdleMs ?? cur.terminalBashIdleMs ?? 15_000,
@@ -270,6 +285,7 @@ export class ClientStateStore {
             goalModeEnabled: settings.goalModeEnabled ?? cur.goalModeEnabled ?? true,
             thinkingWrap: settings.thinkingWrap ?? cur.thinkingWrap ?? false,
             toolsWrap: settings.toolsWrap ?? cur.toolsWrap ?? true,
+            skillsFullText: normalizeSkillList(settings.skillsFullText ?? cur.skillsFullText),
             visionBridgeEnabled: settings.visionBridgeEnabled ?? cur.visionBridgeEnabled ?? true,
             visionBridgeModel: settings.visionBridgeModel ?? cur.visionBridgeModel ?? null,
             subagentDefaultModel: settings.subagentDefaultModel ?? cur.subagentDefaultModel ?? null,