跳到主要内容
ZeroWorks

状态

用状态把对话放进工作流:开放状态留在收件箱,已关闭状态进入归档,每个工作区可以有自己的状态集合。

状态如何工作

状态是每条对话在流程中的位置标记:新对话创建时会落到一个默认状态,随着推进你可以不断把它挪到下一个状态,直到这件事结束。

状态分成两类,分类直接决定它出现在列表的哪一侧:开放状态留在收件箱里,代表还需要你关注的活跃对话;已关闭状态进入归档,代表已经完成或不再需要的对话。

分类含义出现在
开放还需要关注与处理的活跃对话收件箱 / 活跃列表
已关闭已完成或不再需要的对话归档

默认状态

工作台出厂自带五个状态,覆盖了从想法到收尾的常见路径。你可以直接使用,也可以在保留结构的前提下改成自己的说法与颜色。

状态分类含义
待办清单开放暂时放一放的想法与任务
待处理开放已经准备好开始做的事
待复核开放等复核或等反馈的事
已完成已关闭顺利完成并交付的事
已取消已关闭不再需要的事

状态的三种类型

状态按可编辑程度分成三类:固定状态不能删除或改名,默认状态可以改颜色、图标与名称但不能删除,自定义状态则完全由你决定,不用了可以随时删掉。

  • 固定状态:待处理、已完成、已取消。这三个是工作流的基础状态,不能删除或改名,但可以换颜色与图标。
  • 默认状态:待办清单、待复核。随工作台一起提供,可以调整外观与叫法,但不能删除。
  • 自定义状态:你自己新增的状态,名称、颜色、图标、分类都能改,也可以在不再需要时删除。

按工作区配置

状态是按工作区配置的:不同项目、不同团队可以各有一套状态集合,互不干扰。配置文件放在该工作区目录下的 statuses 子目录里,图标单独存放在同级的 icons 目录。

试一试

~/.zero-works/workspaces/{workspace-id}/statuses/config.json ~/.zero-works/workspaces/{workspace-id}/statuses/icons/

修改对话的状态

任何时候都可以在对话列表的状态菜单里切换状态,切换立即生效,不需要额外的保存操作。

多数情况下状态同时承担归档作用:移到「已完成」或「已取消」这类已关闭状态,对话就进入归档;移回开放状态则重新回到收件箱。

  • 推进中的事:先留在开放状态里,用「待复核」标记需要你过目的部分。
  • 真正结束的事:移到「已完成」,让它离开收件箱,同时保留完整记录以便回溯。
  • 放弃的事:移到「已取消」,和「已完成」区分开,方便日后统计。

自定义状态

需要更贴合团队流程的状态时,可以直接编辑工作区里的状态配置文件。配置用 JSON 描述,每个状态包含标识、显示名、颜色、图标与分类等字段。

  • 标识:全小写短横线形式,例如 in-progress,同一工作区内不能重名。
  • 颜色:可以写系统的语义色名(accent、destructive、info 等),也可以写自定义颜色对象区分浅色与深色两套取值。
  • 图标:可以直接写一个表情符号,也可以写本地文件名或图片地址,本地图标放在 icons 目录里按状态标识命名。
  • 分类:open 让对话留在收件箱,closed 让它进入归档。
  • order:状态在列表里的排序位置;defaultStatusId:新会话默认落在哪个状态。
试一试

{ "version": 1, "statuses": [ { "id": "todo", "label": "待办", "category": "open", "isFixed": true, "isDefault": false, "order": 0 }, { "id": "done", "label": "已完成", "category": "closed", "isFixed": true, "isDefault": false, "order": 1 }, { "id": "cancelled", "label": "已取消", "category": "closed", "isFixed": true, "isDefault": false, "order": 2 }, { "id": "in-progress", "label": "进行中", "color": "accent", "icon": "🚧", "category": "open", "isFixed": false, "isDefault": false, "order": 3 } ], "defaultStatusId": "todo" }

校验与常见问题

配置文件在加载时会被校验,格式或字段不合法时不会生效,工作台会保留上一份可用配置而不是用坏配置覆盖它。

  • 状态标识必须是全小写短横线形式,且同一工作区内唯一。
  • 配置里必须保留 todo、done、cancelled 这三个固定状态,缺一个整份配置都不会生效,工作台会退回默认状态集合。
  • 固定状态不能被删除或改名;默认状态不能被删除。
  • 颜色必须是系统语义色名或自定义颜色对象,两者不要混着写。
  • 分类只能是 open 或 closed 两个取值。