跳到主要内容
ZeroWorks

分享协作与看板视图

把会话结论交付给他人,在工作区之间转移会话,并用看板跟踪多个任务的状态。

如何分享一段会话

ZeroWorks 当前关闭新建公开会话链接。分享一段新会话时,应把它变成对方能拿到、能归档、能继续编辑的产物,而不是一条临时链接。

常用的三种做法是:导出为文件、把结论整理进项目文档、把上下文附到协作平台的 issue 或 PR。第三种需要先接入对应来源,并具备该平台的写入权限。

  1. 先明确对方要什么:结论、完整过程,还是一份可执行的清单。
  2. 让 Agent 把结果整理成可交付内容,并确认其中没有夹带凭据或未公开信息。
  3. 按交付对象选择出口:写入项目文档,或通过已接入的来源附到 issue 与 PR。
  4. 交付前核对文件、页面或评论是否完整,并在自己这边保留一份副本。
试一试

请把这次排查的结论整理成一份 Markdown 文档,包含问题现象、根因、已验证的修复方式和仍需确认的事项。不要写入任何密钥、内网地址或未公开的人员信息。

分享时到底带出什么

不同的分享出口带出的内容范围不同。共同的原则是:结论由你决定是否带出,工具调用过程默认不带,本机路径、凭据与附件原文件一律不随内容流出。

内容导出为文件写入空间或项目文档附到 issue 或 PR
对话结论按需挑选按需挑选按需挑选
工具调用与输出默认不带默认不带默认不带
代码片段与差异按需保留按需保留按需保留
本机文件路径不保留不保留不保留
凭据与密钥不保留不保留不保留
附件原文件不打包不打包不打包

管理已经分发的副本

分享之后,工作台不再替你保管这些副本,它们分别落在文件、项目文档和协作平台上。需要更新内容时,请回到对应位置修改原副本,而不是在工作台里改。

副本位置更新方式撤回方式
导出的文件重新导出并覆盖同名文件删除该文件并清理其他副本
项目文档在项目中直接修改按项目的版本管理回退或删除
issue 或 PR 附件在平台上编辑内容或补充评论按平台规则关闭评论、撤回附件或删除副本
历史公开会话已有分享状态下使用更新入口,依赖原服务与管理凭据使用已有分享的撤销入口并确认远端结果;失败时不能声称链接已失效

隐私与访问范围

  • 导出文件与写入文档的内容,跟随你交付的对象;对方能拿到文件,就能看到文件里的全部内容。
  • issue 与 PR 的可见性由所在平台决定,默认跟随仓库或项目的成员范围。
  • 工作区与项目都是本地的整理单位,不提供团队共享盘或成员级访问控制。
  • 分享前请检查是否包含密钥、本机绝对路径、未公开的人员或客户信息。

在工作区之间转移会话

需要把一段会话带到另一个工作区继续时,可以使用“发送到工作区”。目标工作区会得到一份独立副本,包含全部消息与会话元数据,并附带一段可用于上下文的摘要。

副本与原会话相互独立:在一边继续讨论,不会改动另一边。

  1. 打开会话的更多菜单,选择“发送到工作区”。
  2. 从列表中选择目标工作区,确认要转移的会话。
  3. 在目标工作区打开新会话,核对标题、上下文摘要与权限模式。
  4. 需要修改文件时,在目标工作区里重新确认目录与权限,避免误改原项目的文件。

撤销已经给出的访问

已经分发出去的副本不会因为你在工作台里删除会话而消失。撤销要按副本所在的位置逐项处理。

  1. 先按副本位置逐项核对:文件、空间页面、项目文档、issue 与 PR 附件。
  2. 删除或撤回每一份副本,并确认平台侧的链接已经失效。
  3. 此前由其他服务生成的公开链接,需要回到原服务单独删除。
  4. 如涉及凭据,按第三方服务的方式撤销对应授权,而不是只删除本地副本。

看板视图

看板把会话列表变成可拖拽的看板:每张卡片是一个会话,每一列是一个工作状态,把卡片拖到另一列就会更新它的状态。它和列表用的是同一份数据,只是换了一种更适合规划的组织方式。

  1. 从侧栏 Tasks 进入任务区域,在头部选择 Board;List 可以切回列表。
  2. 需要只规划一个项目时先选择项目筛选,确认卡片范围,再使用 New Task 或列头加号新建。
  3. 拖动卡片调整列位置后核对状态;列的投放状态可配置,列位置与状态徽标不必始终同名。
  • 一眼看清多个会话的进行中状态。
  • 通过拖拽推动会话在待办、进行中、待复核、已完成之间流转。
  • 围绕同一个项目规划并排序多个任务。
  • 跟踪会派生子任务的任务进度。

在看板创建正式任务

  1. 点击看板顶部 New Task 打开任务编辑器,填写标题、目标和可核对的验收标准。列头加号只快速创建标题卡片,需要随后进入编辑补全定义。
  2. 用 Manual 添加子任务和 depends_on,或用 Generate 生成后复核计划。正式任务保存为 tasks/<slug>/task.yaml,使用 nodes 与任务级 acceptance_criteria。
  3. 确认项目、工作目录、来源、技能、权限和模型;选择 Create 排入待办,Create and Run 才会保存后启动。Agent 的 create_task 同样只创建,不执行。
  4. 已定义 DAG 的卡片点击播放会启动整张任务图,展开卡片查看依赖子会话与进度。普通快速卡片的播放只派发已有待执行子会话,不能代替完整任务定义。
  5. 从任务编辑器的 Results 检查节点输出与最终验收;需要修改定义时回到 Definition。完整规格和恢复边界见 /docs/usage/tasks。

看板列

每一列对应一个状态。默认会为每个状态生成一列,你添加的自定义列会一并显示。

操作说明
调整顺序拖动列标题即可重新排列列的先后。
重命名与改色从列头菜单修改列的名称和颜色,颜色在所有看板视图中共享。
设置投放状态指定卡片拖入该列后应用的状态,默认与列名一致,可以覆盖。
新增按项目的列在项目筛选生效时新增的列只属于该项目。

看板卡片

一张卡片代表一个会话。卡片保持展开,点击别处不会自动收起,方便并排比较多张卡片的细节。

卡片元素含义
标题会话标题,过长时会截断。
标签该会话上应用的全部标签。
子任务进度已完成子任务数与子任务总数。
项目色会话所属项目的标识颜色。

项目筛选

  • 从看板头部选择单个项目,看板就切换到这个项目的范围。
  • 筛选生效时,看板上只出现绑定到该项目的会话。
  • 筛选生效时新建的任务,默认已经带上该项目。
  • 筛选期间新增的列,只作用在这个项目上。
  • 清除筛选后可以看到全部项目的会话。

局限与注意事项

下面的几项决定了分享与看板当前能做到什么。了解边界,可以避免把结论交付到不合适的地方。

项目当前情况
公开会话链接新建分享关闭;历史分享保留更新/撤销,依赖原服务可用。
访问控制分发出去的副本由所在平台决定可见性,工作台不再额外加锁。
附件不会随导出或文档整理一起打包,需要单独交付。
看板与列表读取同一份会话数据;列投放规则决定拖动时怎样更新状态。