分享协作与看板视图
把会话结论交付给他人,在工作区之间转移会话,并用看板跟踪多个任务的状态。
如何分享一段会话
ZeroWorks 当前关闭新建公开会话链接。分享一段新会话时,应把它变成对方能拿到、能归档、能继续编辑的产物,而不是一条临时链接。
常用的三种做法是:导出为文件、把结论整理进项目文档、把上下文附到协作平台的 issue 或 PR。第三种需要先接入对应来源,并具备该平台的写入权限。
- 先明确对方要什么:结论、完整过程,还是一份可执行的清单。
- 让 Agent 把结果整理成可交付内容,并确认其中没有夹带凭据或未公开信息。
- 按交付对象选择出口:写入项目文档,或通过已接入的来源附到 issue 与 PR。
- 交付前核对文件、页面或评论是否完整,并在自己这边保留一份副本。
试一试
请把这次排查的结论整理成一份 Markdown 文档,包含问题现象、根因、已验证的修复方式和仍需确认的事项。不要写入任何密钥、内网地址或未公开的人员信息。
分享时到底带出什么
不同的分享出口带出的内容范围不同。共同的原则是:结论由你决定是否带出,工具调用过程默认不带,本机路径、凭据与附件原文件一律不随内容流出。
| 内容 | 导出为文件 | 写入空间或项目文档 | 附到 issue 或 PR |
|---|---|---|---|
| 对话结论 | 按需挑选 | 按需挑选 | 按需挑选 |
| 工具调用与输出 | 默认不带 | 默认不带 | 默认不带 |
| 代码片段与差异 | 按需保留 | 按需保留 | 按需保留 |
| 本机文件路径 | 不保留 | 不保留 | 不保留 |
| 凭据与密钥 | 不保留 | 不保留 | 不保留 |
| 附件原文件 | 不打包 | 不打包 | 不打包 |
管理已经分发的副本
分享之后,工作台不再替你保管这些副本,它们分别落在文件、项目文档和协作平台上。需要更新内容时,请回到对应位置修改原副本,而不是在工作台里改。
| 副本位置 | 更新方式 | 撤回方式 |
|---|---|---|
| 导出的文件 | 重新导出并覆盖同名文件 | 删除该文件并清理其他副本 |
| 项目文档 | 在项目中直接修改 | 按项目的版本管理回退或删除 |
| issue 或 PR 附件 | 在平台上编辑内容或补充评论 | 按平台规则关闭评论、撤回附件或删除副本 |
| 历史公开会话 | 已有分享状态下使用更新入口,依赖原服务与管理凭据 | 使用已有分享的撤销入口并确认远端结果;失败时不能声称链接已失效 |
隐私与访问范围
- 导出文件与写入文档的内容,跟随你交付的对象;对方能拿到文件,就能看到文件里的全部内容。
- issue 与 PR 的可见性由所在平台决定,默认跟随仓库或项目的成员范围。
- 工作区与项目都是本地的整理单位,不提供团队共享盘或成员级访问控制。
- 分享前请检查是否包含密钥、本机绝对路径、未公开的人员或客户信息。
在工作区之间转移会话
需要把一段会话带到另一个工作区继续时,可以使用“发送到工作区”。目标工作区会得到一份独立副本,包含全部消息与会话元数据,并附带一段可用于上下文的摘要。
副本与原会话相互独立:在一边继续讨论,不会改动另一边。
- 打开会话的更多菜单,选择“发送到工作区”。
- 从列表中选择目标工作区,确认要转移的会话。
- 在目标工作区打开新会话,核对标题、上下文摘要与权限模式。
- 需要修改文件时,在目标工作区里重新确认目录与权限,避免误改原项目的文件。
撤销已经给出的访问
已经分发出去的副本不会因为你在工作台里删除会话而消失。撤销要按副本所在的位置逐项处理。
- 先按副本位置逐项核对:文件、空间页面、项目文档、issue 与 PR 附件。
- 删除或撤回每一份副本,并确认平台侧的链接已经失效。
- 此前由其他服务生成的公开链接,需要回到原服务单独删除。
- 如涉及凭据,按第三方服务的方式撤销对应授权,而不是只删除本地副本。
看板视图
看板把会话列表变成可拖拽的看板:每张卡片是一个会话,每一列是一个工作状态,把卡片拖到另一列就会更新它的状态。它和列表用的是同一份数据,只是换了一种更适合规划的组织方式。
- 从侧栏 Tasks 进入任务区域,在头部选择 Board;List 可以切回列表。
- 需要只规划一个项目时先选择项目筛选,确认卡片范围,再使用 New Task 或列头加号新建。
- 拖动卡片调整列位置后核对状态;列的投放状态可配置,列位置与状态徽标不必始终同名。
- 一眼看清多个会话的进行中状态。
- 通过拖拽推动会话在待办、进行中、待复核、已完成之间流转。
- 围绕同一个项目规划并排序多个任务。
- 跟踪会派生子任务的任务进度。
在看板创建正式任务
- 点击看板顶部 New Task 打开任务编辑器,填写标题、目标和可核对的验收标准。列头加号只快速创建标题卡片,需要随后进入编辑补全定义。
- 用 Manual 添加子任务和 depends_on,或用 Generate 生成后复核计划。正式任务保存为 tasks/<slug>/task.yaml,使用 nodes 与任务级 acceptance_criteria。
- 确认项目、工作目录、来源、技能、权限和模型;选择 Create 排入待办,Create and Run 才会保存后启动。Agent 的 create_task 同样只创建,不执行。
- 已定义 DAG 的卡片点击播放会启动整张任务图,展开卡片查看依赖子会话与进度。普通快速卡片的播放只派发已有待执行子会话,不能代替完整任务定义。
- 从任务编辑器的 Results 检查节点输出与最终验收;需要修改定义时回到 Definition。完整规格和恢复边界见 /docs/usage/tasks。
看板列
每一列对应一个状态。默认会为每个状态生成一列,你添加的自定义列会一并显示。
| 操作 | 说明 |
|---|---|
| 调整顺序 | 拖动列标题即可重新排列列的先后。 |
| 重命名与改色 | 从列头菜单修改列的名称和颜色,颜色在所有看板视图中共享。 |
| 设置投放状态 | 指定卡片拖入该列后应用的状态,默认与列名一致,可以覆盖。 |
| 新增按项目的列 | 在项目筛选生效时新增的列只属于该项目。 |
看板卡片
一张卡片代表一个会话。卡片保持展开,点击别处不会自动收起,方便并排比较多张卡片的细节。
| 卡片元素 | 含义 |
|---|---|
| 标题 | 会话标题,过长时会截断。 |
| 标签 | 该会话上应用的全部标签。 |
| 子任务进度 | 已完成子任务数与子任务总数。 |
| 项目色 | 会话所属项目的标识颜色。 |
项目筛选
- 从看板头部选择单个项目,看板就切换到这个项目的范围。
- 筛选生效时,看板上只出现绑定到该项目的会话。
- 筛选生效时新建的任务,默认已经带上该项目。
- 筛选期间新增的列,只作用在这个项目上。
- 清除筛选后可以看到全部项目的会话。
局限与注意事项
下面的几项决定了分享与看板当前能做到什么。了解边界,可以避免把结论交付到不合适的地方。
| 项目 | 当前情况 |
|---|---|
| 公开会话链接 | 新建分享关闭;历史分享保留更新/撤销,依赖原服务可用。 |
| 访问控制 | 分发出去的副本由所在平台决定可见性,工作台不再额外加锁。 |
| 附件 | 不会随导出或文档整理一起打包,需要单独交付。 |
| 看板与列表 | 读取同一份会话数据;列投放规则决定拖动时怎样更新状态。 |