Mohamed Boudra
bd15e40e94
* feat(website): serve paseo.sh in Simplified Chinese
Every page of the website now has a Simplified Chinese version under
/zh-CN: the interface, docs, blog posts, comparison pages, legal pages,
all changelog releases and the homepage mockup. English URLs are unchanged.
The URL alone decides the language. There is no browser-language redirect
and no stored preference, because either would have to redirect the
unprefixed English URLs that people share and search engines index.
Internal links carry the page's language instead, and hreflang alternates
point Chinese search results at /zh-CN.
Translated headings pin the English anchor with {#id}, so section links
work in both languages. content-translations.test.ts fails when a page
has no translation or a translation's headings drift from the English.
Changelog releases and plugin listings without a translation render
whole in English under a notice, so a release never waits on one.
Plugin manifests and the registry gain optional translations and
OVERVIEW.zh-CN.md fields; older clients and registries ignore them.
* feat(website): replace the native language select with an EN/ZH menu
The header showed an OS-native select whose popup did not match the site.
The trigger now shows the language abbreviated (EN, ZH) and opens a menu in
the app's dropdown style that names each language in itself, with its name
in the page language underneath. Rows are real links to the same page in
that language; arrows, Escape, outside presses and taps behave as a menu
button, and the menu keeps itself on screen when a narrow header pushes the
trigger toward an edge.
Also drops the stray space after the full-width comma in the Chinese
homepage subtitle.
* docs(website): translate main's new docs and 0.12.0 release notes
Main added Keep run workspaces to the schedules docs, rewrote plugin icons
around inline SVG, and promoted 0.12.0 with new entries. Bring the Chinese
pages and changelog in line so no section falls back to English.
* fix(server): leave plugin listing translations to the registry
The daemon rejected manifests whose translations the registry would refuse,
so a plugin main installs could fail to load here. Paseo never reads
translations; the registry validates them at publish. Docs now say which
checks are automated at publish and which are human review.
* docs(plugins): describe the registry's final overview translation discovery
* style(server): format manifest test
* test(app): measure sidebar rows one at a time
After a reload the developer error toast appears while expectVerticalOrder
measures every row at once. Each concurrent boundingBox runs the toast
locator handler, and only one of them resumes, so the poll timed out on
every attempt since #7424. Measuring sequentially keeps one action in flight.
* test(app): return sidebar row measuring to main
#7480 hides the developer toast instead of running a locator handler, so
measuring the rows concurrently no longer races it. Reverts 41ac23016.
* test(app): wait for the compact shell before opening compact Changes
The shell survives the breakpoint, so right after the resize the wide
Explorer could still be visible: the test skipped the Explorer toggle and
the tab then disappeared, or toggled at the wrong time. Wait for the
compact-shell marker, as the composer helpers do since #7424.
* docs(website): translate main's plugin file panel docs
* test(app): edit the code font size after the font family remount
A committed appearance change remounts the settings screen through
AppearanceStyleBoundary, and the new form starts from the stored size.
Filling the size before that remount lost the edit in CI.
* docs(website): translate main's client/ui import docs
Follows #7474: one /client/ui entry, StreamedText instead of useRevealedText,
SettingsGroup dropped from the settings table, and the new
'UI imports in v0.13' migration section.
* test(app): wait for the previous layout's file panel picker to leave
After a resize the old layout's picker animates out while the new one is
already mounted, so the Use button matched two elements and the strict
locator failed. Wait for the shell's layout and a single picker first.
6.3 KiB
title, description, nav
| title | description | nav |
|---|---|---|
| 常用编排工作流 | 用 Paseo 委派、并行、审查和延续 Agent 工作的提示词。 | 常用工作流 |
常用编排工作流
启用 Paseo 工具，然后让你的主 Agent 执行下面的某个工作流。请根据你的项目调整任务。Agent 配置让你可以保存设置，并说明每类工作应该使用哪个 Agent。
把工作交给另一个模型
在主聊天中继续做规划，把实现委派出去：
用 Paseo 查看我的 Agent 配置及其说明。选择一个用于实现的配置，创建一个使用 worktree 隔离的工作区，并在那里启动一个子 Agent 来实现解析器的改动。让它运行相关测试并汇报结果。
执行者会在自己的 worktree 中完成改动。如果没有合适的配置，Agent 可以发现你配置的 Provider 和模型，并告诉你它选择了什么。
分头调研
把相互独立的问题分给多个执行者：
在这个工作区中创建三个 Paseo 子 Agent。一个追踪请求路径，一个检查测试，一个查找相关的回归问题。不要编辑文件。三个都汇报后，综合它们的发现。
执行者共享你的文件，并出现在 Subagent 面板中。你的主 Agent 会把它们的发现汇总成一个回答。
并行编辑而不冲突
为每个独立的改动分配各自的 worktree：
把这两个 issue 分给两个 Paseo 子 Agent。为每个 issue 从 main 创建一个单独的、使用 worktree 隔离的工作区。查看我的配置，选择合适的实现设置，并让每个 Agent 为自己的改动运行相关检查。完成后总结两份 diff。
每个执行者编辑各自的检出。你会得到两个可以检查的改动，以及它们的检查结果。
先实现，再审查
为完成改动和评判改动选择不同的 Agent：
查看我的 Paseo 配置及其说明，找出用于实现和审查的配置。创建一个使用 worktree 隔离的工作区，并在那里启动一个实现执行者。完成后，在该工作区中启动一个独立的审查者，检查正确性、缺失的测试和不必要的复杂度。把审查结果带回这里。
审查者在一段新的对话中查看执行者的文件。如果想听取另一个模型的判断，请使用来自不同 Provider 的配置。
向另一个 Agent 发送提示词
Agent 可以通过 Agent ID 相互发送提示词，Agent ID 是 Paseo 用来指定某个 Agent 的标识符。它们可以在同一主机上跨工作区通信，包括与不是由自己启动的 Agent 通信。
- 右键点击接收方 Agent 的标签页，选择 复制 Agent ID。
- 把这个 ID 粘贴到你与发送方 Agent 的对话中，然后提出要求：
用 Paseo 把这段提示词发送给 Agent [在此粘贴 Agent ID]：“审查你工作区中解析器的改动，并报告缺失的测试用例。”
接收方 Agent 会在它现有的对话中收到这段提示词。由 Agent 发起的发送默认会引导正在进行的一轮；无法引导时则退回为中断。把 MCP 的 activeTurnBehavior 或 CLI 的 --behavior 设置为 steer 或 interrupt 可以覆盖这个默认行为。如果希望它另外回发一条消息，请把发送方的 Agent ID 也告诉它。
在底层，Agent 会用接收方的 agentId 和一段 prompt 调用 send_agent_prompt。Agent 也可以用 list_agents 发现 ID；CLI 使用 paseo send <id>。对于另一台主机，请使用远程 CLI 工作流。
检查、调整或继续工作
按需分别发送这些提示词：
总结子 Agent 们正在做什么，并标出任何被阻塞的地方。
你会在主对话中得到一份进度总结。
告诉解析器执行者添加畸形输入的用例，并重新运行它的测试文件。
执行者会在它现有的对话中继续。
取消 UI 执行者当前这一轮，但保留这个 Agent，以便我调整它的方向。
当前任务停止；执行者仍然可以接收后续提示词。
在另一台机器上工作
CLI 可以以另一台 Paseo 主机为目标。先把它连接到远程 daemon，并确定那台主机上的一个工作区。仓库和所需的 Provider 必须在那里可用。
使用我提供的远程主机和工作区，通过 Paseo CLI 在那里启动一个 Agent 调查失败的构建，检查它的输出，并在这里总结发现。不要修改文件。
执行者在远程机器上运行。请用 CLI 的全局 --host 选项指定目标；注入的 Paseo 工具作用于主 Agent 自己的主机。
用 heartbeat 让 Agent 持续工作
heartbeat 会定期提示同一个 Agent，并保留它的对话：
用 Paseo 创建一个每 10 分钟一次的 heartbeat。以小步推进这次迁移，每一步之后运行相关检查，迁移完成后删除这个 heartbeat。设置它在两小时后过期。
Agent 会按这个节奏继续任务。如果希望每次运行都使用新的 Agent，请改为创建定时任务。
工作出现在哪里
打开 Composer 附近的 Subagent 面板查看委派出去的工作。
| Paseo 子 Agent | Provider 原生子 Agent | |
|---|---|---|
| Provider | 任意已配置的 Provider | 在父 Provider 自己的体系内选择 |
| 工作区 | 当前或显式选择的工作区 | 由 Provider 管理 |
| 对话 | 可以与之对话的完整 Agent 会话 | 只读的时间线 |
| 控制 | 后续提示词、修改设置、归档或解除关系 | 生命周期由 Provider 管理 |
位于另一个工作区的 Paseo 子 Agent 仍然属于它父 Agent 的 track。它也会在自己的工作区中以标签页打开。要让它成为顶层 Agent，请在应用中或用 paseo agent detach 解除父子关系。
工作区和父子关系的规则见 MCP 参考。