通知收集跨 Dokki 需要你关注的项目。它们是持久化的数据库行,而非仅本地 UI 状态。
通知出现在哪里
通知出现在顶栏通知中心和 AI 面板的 通知 视图中。AI 面板视图是只读的:你可以在那里打开和管理通知,但它没有消息撰写器。
Dokki 从服务器加载最近的通知,通过 Supabase 实时保持其更新,并在浏览器标签页重新获得焦点时重新获取。
通知中包含什么
通知类别包括:
提及 — 文档、评论或其他受支持界面中的用户提及。
邀请 — 工作区邀请、组织邀请和访问请求决定。
代理运行 — 已完成、失败或需要关注的背景工作。
代理关注 — 代理或工作流希望人类注意的项目。
自动化 — 与自动化相关的状态或失败通知。
系统 — 不适合其他类型的任何内容的备用类别。
每条通知可以包括标题、消息、操作者、工作区 ID、资源链接和元数据。
访问请求
私有资源的访问请求会以邀请类通知形式出现,并带有内联的 批准 和 拒绝 操作。批准会授予所请求的直接资源角色。拒绝则关闭请求并通知请求者。
相同的待处理请求也会出现在资源共享对话框内,供可以管理该资源的人查看。
阅读和清除
你可以将一条通知标记为已读、将所有通知标记为已读、清除一条通知或清除所有通知。已读状态和删除会尽最大努力同步回服务器。
未读计数来自没有 read_at 的通知。消息中心通过应用乐观更新来保持本地视图的响应性,而无需等待服务器回复返回。
主页提醒
通知在可用时会携带工作区上下文。主页可以利用该工作区上下文显示当前工作区的提醒和代理关注项目。
良好实践
将通知用作操作收件箱,而非长期存储。一旦做出决定,就将结果记录在相关文档、表格、聊天、资源或任务中。
