智能体看板
以卡片树实时显示当前项目的 Paseo 智能体,包括状态、模型、上下文用量和父智能体发送的指令。
智能体看板以实时卡片树显示当前项目各工作区中的智能体,每个 Paseo 智能体对应一张卡片。由其他智能体启动的智能体位于父智能体右侧,以箭头相连,点按箭头即可查看父智能体发送的指令。可以作为工作区面板打开,也可以在命令中心选择 打开智能体看板。
设置
智能体看板需要 Paseo 0.15.3 或更高版本,本身不需要账号或设置。卡片标题、当前 行和指令总结由 Claude Haiku 通过守护进程所在机器上的 Claude Code CLI 生成,因此需要在该机器上安装并登录 Claude Code。插件已在 macOS 上测试。在其他系统上,Claude Code 调用可能失败,此时卡片会改为显示 Paseo 的标题和最新活动。
标题栏中的开关(Haiku 总结已开启 或 Haiku 总结已关闭)会为主机上的所有看板开启或关闭总结。关闭时插件不会调用 Claude,看板的其他功能照常可用。
卡片
- 每张卡片显示提供方图标(Claude 的标志,Codex 则为 OpenAI 的标志)、角色或提供方、匹配到的智能体配置(以配置的颜色显示图标和名称)、状态、简短标题,以及模型、推理强度和权限模式的彩色标签。推理强度从绿色(低)到红色(最高)。权限模式中,绕过或完全访问为红色,自动模式为琥珀色,计划模式为蓝色,需要确认的模式为绿色。
- 标签下方的进度条显示智能体上一轮结束后上下文窗口的占用程度,并给出百分比和 token 数。达到 50% 时变为琥珀色,达到 80% 时变为红色。
- Claude Haiku 根据智能体最近 150 条时间线记录生成标题和 当前 行(智能体未运行时为 最后)。标题(最多 40 个字符)说明本次会话在做的工作,当前(最多 60 个字符)说明智能体实际正在做什么。第一份总结到达之前,卡片显示 Paseo 的标题以及最新的工具调用、回答或思考。之后,卡片会保留上一份总结,直到新的总结取而代之。
- 智能体运行时,其最新的工具调用会实时显示。总结填入 当前 后,它显示在 工具 行,在此之前直接显示在 当前 行。智能体有待办列表时,步骤 行显示当前步骤。
- 智能体压缩上下文时,状态显示为紫色的 压缩中,压缩 行显示 正在压缩对话记录,直到压缩结束。
- 智能体在自己的会话中启动的提供方子智能体(例如 Claude 的 Agent 工具启动的子智能体)会在该智能体下方显示为一张较小的卡片,并以箭头相连。卡片显示 子智能体 和子智能体类型、任务说明、Paseo 给出的模型、推理强度和 token 数,以及 工作中、已完成、出错 或 已中断。如果 Paseo 版本的插件导航可以打开子智能体标签页,点按卡片会打开 Paseo 自带的子智能体标签页,否则会在看板上方显示该子智能体的对话,其中包括它收到的消息、它的回答、工具调用和错误,子智能体工作时每 2 秒刷新一次。在对话中点按 打开父智能体 会打开启动它的智能体。点按它的箭头会列出该子智能体收到的消息。运行中的子智能体和在智能体最近一条提示之后启动的子智能体会显示,更早的子智能体在打开 已结束的智能体(24 小时) 时显示。
- 标题栏统计所有可见的智能体、正在工作的智能体,以及因待处理的授权或出错而需要处理的智能体。子智能体不计入统计。
箭头和指令
- 两张卡片左右并排时,箭头在两张卡片相对一侧的垂直中点处连接。一张卡片在另一张上方时,箭头从父卡片底部(或顶部)中点出发,进入子卡片顶部(或底部)中点。子智能体运行时,箭头变为琥珀色,并有圆点沿箭头流向子智能体。
- 点按箭头或其中间的按钮,会在该按钮旁打开 已发送的指令 框。框中按时间先后列出父智能体发给子智能体的消息,内容读取自子智能体的完整时间线。首条指令 是委派任务的指令,之后是追加指令。你自己发给子智能体的提示不会列出。
- 开启总结时,每条指令显示 Haiku 总结的目标和最多五个要点,查看原文 可展开发送时的原文。关闭总结时直接显示原文。框的标题栏会写出两个智能体的名称,开启总结时使用总结后的标题。
- 点按框外看板上的任意位置即可关闭该框。按钮和框位于卡片之上。在桌面端和网页端,框在任何缩放比例下都保持原有大小,并在按钮周围空间较大的一侧打开,因此不会超出看板。
布局和导航
- 打开 按工作区分组 开关(默认开启)时,同一工作区的图会堆叠在一起,外面画有浅色填充的虚线框,框顶部以 Paseo 颜色显示工作区名称及其标签。框会跟随你拖动的卡片,拖动框会让该工作区的所有卡片一起移动。
- 拖动卡片可以移动它,短按卡片可以打开智能体。拖动时按住 Shift,卡片会对齐到另一张卡片的左边缘或上边缘,或另一张卡片旁边、上方、下方一个树间距的位置,否则对齐到 20px 网格。位置按智能体保存在主机上,关闭标签页后依然保留。重置布局 会把移动过的卡片放回树状布局。
- 滚动或滑动可以向任意方向移动看板(Shift + 滚轮横向移动)。按住 Ctrl 或 ⌘ 滚动,或在触控板上捏合,可以围绕指针在 25% 到 150% 之间缩放。在移动端应用中,看板改为滚动,不能缩放。重新打开标签页时,位置和缩放会重置。
- 指针位于看板上时,按 ⌘Z 或 Ctrl+Z 可撤销上一次卡片移动、工作区移动或布局重置,最多 50 步。
- 打开 已结束的智能体(24 小时) 开关后,还会显示过去 24 小时内关闭或归档的智能体,这些卡片会变暗并带有虚线边框。
- 卡片上的十字准星按钮会高亮该智能体及其祖先和后代,并使其余卡片变暗;眼睛按钮会隐藏该智能体及其后代。标题栏中的 取消高亮 可以取消高亮,另一个标题栏按钮可以重新显示隐藏的智能体。这些视图设置按标签页保存。
语言和主题
看板跟随应用语言,支持英语、韩语和简体中文。其他应用语言显示英语。Haiku 使用应用语言撰写总结,韩语、日语和中文的字数约为一半,切换应用语言后会生成新的总结。
使用浅色主题时,卡片、箭头按钮和指令框保持 Ghostty 的深色配色,背景、标题栏和工作区框则跟随主题。
数据访问
看板通过 Paseo 读取项目的智能体及其时间线、工作区以及主机上的智能体配置。卡片位置和总结开关保存在插件的主机设置中,其他视图设置保存在标签页中。
总结在守护进程所在机器上以打印模式(claude -p)运行 Claude Code,使用 Haiku 模型,从临时文件夹启动,不加载任何工具、设置或 MCP 服务器,也不保存会话。总结会消耗你的 Claude 用量。每次卡片总结会通过 Claude Code 把智能体的 Paseo 标题和最多约 6,000 个字符的最新活动发送给 Anthropic。这些活动包括提示和指令(每条最多 400 个字符)、智能体回答(最多 300 个)、工具调用及其 shell 命令、简短文件路径、搜索词和 URL(最多 200 个)、待办事项,以及错误(最多 200 个)。运行中的智能体最多每分钟总结一次,已停止的智能体只有在上次总结后时间线发生变化时才会再次总结。
在开启总结时打开指令框,还会发送框中列出的每条指令(最多取前 8,000 个字符)以生成总结。插件运行期间,每条指令文本在每种应用语言下只总结一次,调用失败时,下次框中显示该指令时会重试。同时最多运行两个 Claude 调用,每个调用 60 秒后停止。总结只保存在内存中,插件重新加载后即丢失。
为了显示子智能体卡片,插件的服务端会连接同一台机器上的守护进程,地址为 Paseo 主目录中 config.json 的 daemon.listen,并读取所显示智能体的子智能体、每个子智能体收到的消息,以及你打开对话的子智能体的完整对话。有智能体或子智能体在运行时每 2 秒读取一次,否则每 20 秒读取一次。
为了给工作区标签着色,插件会读取守护进程所在机器上的 Paseo 标签文件,即 Paseo 主目录中的 projects/workspace-labels.json(未设置 PASEO_HOME 时为 ~/.paseo)。插件只使用每个标签的名称和颜色。无法读取该文件时,标签显示为灰色。
限制
- Paseo 不记录智能体由哪个配置启动,因此卡片显示的是提供方及其固定设置(模型、权限模式、推理强度)都与智能体当前设置相同的配置。手动按某个配置设置的智能体会显示该配置,之后更改过模式或推理强度的智能体不显示任何配置。
- 除非打开 已结束的智能体(24 小时),否则已关闭和已归档的智能体会被隐藏。
- Paseo 的插件 API 没有子智能体列表,因此插件会为子智能体卡片自行连接同一台机器上的守护进程。需要密码或通过套接字监听的守护进程不会显示子智能体卡片。
- 新的智能体会放在树状布局中的默认位置,可能与你移动过的卡片重叠。
- 拖动主要面向桌面端。在触屏设备上,拖动可能与滚动冲突。



