层级与元素

已被取代(2026-10-21):Circle 里的五层界面、工作队列和登记簿已随旧服务器退役。Circle 里不出现 Hub 专用界面;Hub 的控制台是只读的四页(规划中),记录页按五要素布局,见对象标准。本文只作记录保留。

先设计 hub 的入口,再逐层深入;每一层固定用什么图、表、描述、按钮,现有工作只往里填内容。取自 Claude Code 桌面版和 Codex 桌面版的共同做法,不抄它们的皮:会话是入口,左栏是工作清单,需要人的事以内联卡片出现并在左栏聚合,证据在旁栏,动作少而固定。

五层,逐层深入

层 是什么 进入
L0 会话 Circle 的会话就是入口。hub 的工作在这里交出去,进度、证据、需要人的事以卡片回到这里 登录 hub 后的任一会话
L1 工作队列 待我审批 / 待我回应 / 我提交的 / 我负责的 / 异常。按年龄排序,逐条审阅 左栏「需要我」的计数
L2 登记簿 一个对象的记录:分面 + 计数 + 搜索。四个对象同一个模板 左栏菜单项,或队列行的对象
L3 记录详情 五格:资产 · 内容 · 审批 · 证据 · 扩展点。决定在这里做,也能在 L0 的卡片里做 登记簿一行,或卡片的「打开」
L4 证据原文 平台原样保存的返回:sha、谁、何时、哪个工具;可引用,不可改 任何 evidenceId

任何一层都能回到会话。

每层用什么

层 图 表 描述 按钮
L0 会话 无;只有内联卡片 无 事件一句话(受理 / 证据 / 过闸 / 平台核验);报错卡:错误码 + 事实 + 申请人的选择;审批卡:变更集 + 绑定三项 + 资格 批准 · 驳回 · 回应 · 打开 · 跟随
L1 队列 计数条;年龄与超 SLA 的分布 队列表:对象 · 申请 · 流程@版本 · 范围 / 产品线 · 申请人 · 年龄 · 过期 · 状态 · 资格 统计一行;资格原因 上一条 · 下一条 · 批准 · 驳回 · 保存视图
L2 登记簿 无;分面代替 登记簿表:名称 · kind · version · lifecycle · owner · 更新 对象一句话;平台约束四条 登记 · 上传 · 推送 · 交活 · 打开
L3 详情 绑定图:请求 ↔ 输入修订 / 目标身份 / 动作摘要;数据流中的位置 文件表 · 证据表 · 决定表 资产条;平台核验 vs 申请内容;资格 批准 · 驳回 · 新版本 · 停用 · 核对
L4 证据 无 原样返回(只读) sha · 谁 · 何时 · 工具 · 输入摘要 复制 id · 引用 · 下载

不在表里的元素不出现在那一层。

图只有四种

  • 数据流图:一件工作怎么走过 A C E B D,带 id。
  • 绑定图:一条审批请求钉住的三项,和它们各自指向的记录。
  • 执行拓扑:hub → worker → 资源,谁持凭据、谁碰外部系统。
  • 生命周期图:资产 draft → approved → running → retired,与审批状态的对应。

别的都用表和计数表达;不画示意性的架构图。

动作词固定,哪一层都是这几个

动作 对什么
批准 / 驳回 一条审批请求;绑定其摘要;被取代的也可驳
回应 任务等我的输入
打开 到下一层
跟随 把任务事件接回会话
核对 未知结果的 reconcile
登记 来源、资源、服务客户端
上传 原件,带 role
推送 技能包,带试跑记录
交活 把工作交给 hub
新版本 资产换字节
停用 资产 retired

没有「确认」「提交」「保存」这类不指向对象的词。


本文是 circle-hub 的设计规范之一,按 CC BY 4.0 授权:引用、借鉴须署名 Circle Hub 与 qingshanfeihu 并注明原始出处链接。见设计规范索引。