iPolloWork Docs

工作区与智能体

理解每个任务背后的会话、本地运行时、文件、浏览器和权限边界。

iPolloWork 会话是一个任务的持续上下文。它将对话与文件、工具执行、浏览器状态、生成产物和当前打开的工作界面连接起来。

会话所有权会话是工作边界,而不只是对话线程

会话关联意图、工具活动和一个可编辑产物界面,同时不会把每个任务变成全局工作区变更。

01
意图

要发生什么

任务结果

清晰的目标、所有者、仓库或工作区以及审核预期。

对话

应与任务保持关联的上下文与决策。

02
执行

如何发生

本地运行时

通过本地服务和受支持的 OpenCode sidecar 路由任务工作。

工具

文件、浏览器、Skill、插件和 MCP 调用都保持在任务边界内。

03
产物

什么可被审核和编辑

工作界面

代码、Design、Video、浏览器输出或其他会话归属结果。

活动证据

结果会在拥有它的界面中重新打开并检查。

会话中保存什么

层级责任
会话任务指令、对话、活动记录和当前工作上下文。
本地服务路由智能体请求、管理本地项目状态,并提供本地 API。
OpenCode执行底层智能体运行时,可独立升级。
工作界面渲染并编辑代码、设计产物、视频合成、浏览器工作和任务输出。
权限在文件、浏览器、工具和连接器动作执行前呈现所需授权。

保持任务范围清晰

当任务更换了仓库、所有者、目标或权限边界时,应新建会话。若只是修改同一个产物或决定,则保留在现有会话中继续。

这对 Design 和 Video 尤其重要。它们的产物由会话拥有,因此新任务不会无声地修改之前的项目。

以下任意条件改变时应新建会话:工作区路径、拥有工作的用户或团队、主要输出、预期权限级别或产物类型。对同一成果的审核、修正、延展或替代版本应保留在同一会话中。这样既不会丢失相关上下文,也避免一个模糊而宽泛的会话取得无关工作的权限。

有意识地使用扩展能力

Skill、插件、MCP 服务和浏览器自动化都是任务能力的扩展。只添加当前结果真正需要的能力,并保持授权范围尽可能窄。若任务需要自定义模型或 MCP 服务,请先完成 模型、工具与 MCP 配置。

可选的 Cloud 连接

本地 iPolloWork 不要求账号。iPolloCloud 是身份、组织、权益、托管 Worker、管理和商业 App 的可选控制平面,不位于本地智能体执行路径中。

桌面端与 UI  ->  本地 iPolloWork server  ->  OpenCode runtime
       |
       +-> 可选的 iPolloCloud 身份与控制请求
会话审核环路只有当归属界面可检查时,智能体工作才算完成

一段回复只是中间状态。持久结果是可审核的产物和明确的变更记录。

  1. 01定域

    根据工作区、结果与权限边界选择现有会话或新建会话。

  2. 02执行

    使用本地运行时以及当前请求所需、已批准的能力。

  3. 03打开

    在 Code、Design、Video、浏览器或对应任务界面中呈现结果。

  4. 04继续或关闭

    在会话中保留后续修改;结果和证据清晰后再归档。

有关运行时本身,请阅读 运行时生命周期。有关本地文件和工作区端点,请阅读 Local Server 参考