Q: 为什么自主智能体在发布进度更新文本后会中途停止任务？

这是一个已知 bug（v0.13.6）：agent-runtime 的 `runLoop` 会将任何工具调用数为零的助手消息视为最终答案，并发出 `agent_end` 事件。当模型遵循系统提示词的指示，在下一批工具调用之前先写一句简短的进度说明——但该文本以 `finish_reason: "stop"` 流式输出且未附带 `tool_call`——循环检测到 `toolCalls.length === 0`，便会过早终止运行。临时解决方法：手动发送后续提示（例如 "continue"）以恢复任务。正式修复方案（任选其一）：1）修补 `runLoop`，使其在自主模式下，当助手消息包含文本但没有工具调用、也没有明确的任务完成标记时，触发一次自动继续/提醒（类似于 sidecar.js 中现有的 `pendingSilentTurnRerun`/`SILENT_TURN_NUDGE` 恢复机制），而非终止运行。2）修改协作系统提示词，加入要求："始终在与文本更新相同的消息中发出工具调用；绝不在同一轮次中只宣布操作而不附带相应的工具调用，否则执行将终止。"

Question 1

为什么当父菜单使用 backdrop-filter（blur）时，我的 position: fixed 子菜单会出现错位？

Accepted Answer

根本原因：带有 `backdrop-filter`（非 `none`）的元素会成为其所有 `position: fixed` 后代的包含块（containing block），因此子菜单会相对于菜单而非视口进行定位——导致弹出菜单偏移、出现水平滚动条以及溢出空白区域。修复方法：通过 React Portal 将子菜单渲染到 `document.body`，使其脱离菜单的盒树（box tree），从而让 `fixed` 重新锚定到视口： ```tsx {openSubmenuItem ? createPortal(

, document.body, ) : null} ``` 由于子菜单不再是根菜单的 DOM 子节点，需要做两项后续调整：(1) 在根菜单的 `onPointerLeave` 中，将位于 Portal 子菜单内的 `relatedTarget` 视为仍在菜单内部，否则当鼠标移入子菜单时子菜单会被关闭；(2) 在子菜单面板本身上添加 `onPointerLeave`，当指针同时离开两者时将其关闭。键盘导航无需更改——React 事件会沿 React 树冒泡，因此根菜单的 `onKeyDown` 和 `closest('[role="menu"]')` 仍然有效。另外，还需在根菜单调整大小/滚动时重新定位子菜单，使其跟随触发行。请注意，当祖先元素带有 `transform` 或 `zoom` 时也会出现同样的破坏，而 Portal 修复方案可以覆盖所有这些情况。

Question 2

如何修复在 Windows 开发检出环境上运行 vitest 时出现的 'EPERM: operation not permitted, symlink' 错误和路径断言测试失败？

Accepted Answer

这些是测试夹具（test-fixture）的 bug（不是产品 bug），由 PR #1803 修复，并已作为 commit d1df8bba0 合并到 main。请拉取最新的 main（在 0.21.0-beta.4 之后）并重新运行：`cd packages/host-runtime && pnpm exec vitest run src/launch-resolver.test.ts` 和 `cd packages/agent-runtime && pnpm exec vitest run src/native-pi-session.test.ts -t sessionDir`。修复内容：（1）launch-resolver 测试不再硬编码 POSIX 路径 `/data/scratch/s1`——它改用宿主平台的 `join()` 来构建预期路径，从而匹配 Windows 上的 `\data\scratch\s1`；（2）sessionDir 符号链接（symlink）夹具现在会捕获 `EPERM` 并优雅地降级/跳过，遵循现有的 `createSymlinkOrSkip` 约定，同时在符号链接可用的环境中保留完整的符号链接覆盖。如果无法更新，可采用以下变通方法：启用 Windows 开发者模式（设置 → 隐私和安全性 → 开发者选项）以授予文件符号链接权限，或者在 WSL/Linux 下运行这些测试套件。

Question 3

为什么在 PI-Desktop 中切换会话后,未保存的 AskTool 复选框选择会消失?

Accepted Answer

PI-Desktop 0.20.1 中的已知 bug（在 v0.21.0-beta.4 中仍然存在）。AskTool 卡片仅将草稿答案保存在 AskToolCard.tsx 内组件局部的 useState 中。切换会话会卸载该卡片（因为 pendingAsk 按 activeSessionId 过滤），因此所有已勾选的选项都会重置，卡片也会回到第 1 个问题。待处理的 ask 本身仍保留在 store 中，但草稿并未存储在任何地方，因此没有任何内容可以恢复。临时解决方法：在切换会话之前提交 AskTool 卡片——一旦切换，丢失的选择将无法恢复。永久修复（适用于从源代码构建的开发者）：将草稿从组件状态中提升到按 requestId 划分的缓存中，例如模块作用域中的 Map，或在 apps/desktop/src/lib/pending-asks.ts 中 ask 队列旁边添加一个 AskDrafts = Record slice。在挂载时从缓存的草稿初始化 useState，通过监听 [drafts, index, request.requestId] 的 useEffect 写回缓存，并在卡片完成时（包括 ASKTOOL_NOT_FOUND 路径）删除对应条目，以避免残留过期草稿。

Question 4

为什么活动组会在回合结束时自动折叠并隐藏工具输出？

Accepted Answer

根本原因：在 `apps/desktop/src/features/chat/transcript/ActivityGroup.tsx` 中，分组的展开状态绑定到了 `live`（`isActive || topologyLive`），它会在回合结束的那一刻翻转为 `false`。由于 `useAutomaticDisclosure` 将 `open` 解析为 `choice?.open ?? automaticOpen`，任何用户从未点击过的分组都会自动折叠（仅限多工具分组；单项分组得以幸免，因为 `visibleItems.length <= 1` 保持为 true）。修复方案：将分组框架与 `live` 解耦——把 disclosure 调用替换为 `useAutomaticDisclosure(hasSubagentTopology ? true : visibleItems.length <= AUTOMATIC_OPEN_MAX_ITEMS, revealRequest, disclosureKey(...))`。内部的工具行仍然以折叠状态开始（`ToolRow` 使用 `useAutomaticDisclosure(false, …)`），并且 `DisclosureCollapseRail` 仍允许用户手动折叠。更通用的修复是将单个布尔值拆分为 `defaultOpen`（交互之前的初始状态）和 `collapseWhenIdle`（是否在空闲时自动折叠）。面向最终用户的变通方法：点击已折叠的分组行以重新展开工具输出。

Question 5

为什么自主智能体在发布进度更新文本后会中途停止任务？

Accepted Answer

这是一个已知 bug（v0.13.6）：agent-runtime 的 `runLoop` 会将任何工具调用数为零的助手消息视为最终答案，并发出 `agent_end` 事件。当模型遵循系统提示词的指示，在下一批工具调用之前先写一句简短的进度说明——但该文本以 `finish_reason: "stop"` 流式输出且未附带 `tool_call`——循环检测到 `toolCalls.length === 0`，便会过早终止运行。临时解决方法：手动发送后续提示（例如 "continue"）以恢复任务。正式修复方案（任选其一）：1）修补 `runLoop`，使其在自主模式下，当助手消息包含文本但没有工具调用、也没有明确的任务完成标记时，触发一次自动继续/提醒（类似于 sidecar.js 中现有的 `pendingSilentTurnRerun`/`SILENT_TURN_NUDGE` 恢复机制），而非终止运行。2）修改协作系统提示词，加入要求："始终在与文本更新相同的消息中发出工具调用；绝不在同一轮次中只宣布操作而不附带相应的工具调用，否则执行将终止。"

PI-Desktop

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐