[文档] 独立候选工作单元（WorkCell）组合设计基线

[TablewareBox]

Outcome

将 #181 拆票前的完整候选工作单元（WorkCell）设计恢复为独立、长期维护的设计文档，避免 Wayfinder 父地图和子议题正文继续承载整份跨协议设计。

对齐范围

• 以 [Wayfinder] WorkCell 组合定义、注册编译与分层 Action 暴露 #181 于 2026-08-04 17:18（Asia/Shanghai）的拆票前最后完整正文为历史基线；
• 对齐 [候选工作单元（WorkCell）D1] 定义身份、AST 与双向创作 #182–[候选工作单元（WorkCell）D3] 启用参数、启动解析与敏感配置（Secret）合同 #184 已接受的 D1–D3 决策；
• 固化 D3-02=A：零覆盖不创建或持久化空 params 文件/记录，但始终生成并持久化脱敏候选启用快照（Activation Snapshot）；
• 固化 D3-03=A：一次启用最多接受一个外部覆盖对象；多个来源冲突失败，不做隐式叠加；
• 固化 D3-04=A：Phase 0 仅支持 Python-only 零外部参数路径，完整 v1 保留单一外部来源合同；
• 固化 D3-05：复用 -g/--graph 作为唯一启动定义来源参数，不新增 --workcell；
• 固化 D3-06=A：-g/--graph 严格按 .py、.json、.graphml 后缀分派，未知或无后缀失败，不做内容探测；
• 固化 D3-07=A：一个 .py 启动文件恰好声明一个顶层 @workcell 根定义，零个或多个失败；
• 固化 D3-08=A：任意已登记设备作者句柄只消费已发布目录的 init_param_schema.config，不另建合同；
• 固化 D3-09～D3-13=A：公开参数闭集、封闭候选启用请求（Activation Request）、v1 文件启动、实例部署字段和 SecretRef 合同；
• 固化 D3-14～D3-15=A：Uni-Lab OS 内容寻址快照权威和候选启用解析器（Activation Resolver）唯一深模块接口；
• 固化 D1-06～D1-07=A：失败关闭 AST allowlist、PackageCatalog fqid/revision/digest 与稳定 member_id；
• 固化 D1-09～D1-11=A：单草稿 CAS/完整语义 diff、显式 .py 与 clean-wheel parity、Draft → Candidate → Published 原子发布；
• D1-08 仍待确认，已依据现有启动 JSON 把候选规则修订为字段级集合顺序和遗留 Adapter seam；
• 保留 D4、D5 并发和 G1 为待确认；
• 将候选计划生成器（Plan Generator）明确留在推迟范围，不纳入 v1 门槛；
• 补回物理位置与旋转、直接 Python 启动、受控双向创作、嵌套组合、启动解析、敏感配置（Secret）与工作流支持动作（Workflow-backed Action）的整体边界。

影响

仅新增设计文档，不改变运行时代码。GitHub Issues 继续拥有决策状态与验收权威；文档保存整体设计，后续决策应同步修订文档。

关联：#181 #182 #183 #184 #185 #186 #187

Agent report

agent_report:
  stage: protocol-definition
  reporter: Codex
  execution_mode: agent
  agent_product: Codex
  agent_name: WorkCell independent design document alignment
  model: GPT-5
  input_refs:
    - https://github.com/Uni-Lab-OS/Uni-Lab-Core/issues/181
    - https://github.com/Uni-Lab-OS/Uni-Lab-Core/issues/182
    - https://github.com/Uni-Lab-OS/Uni-Lab-Core/issues/183
    - https://github.com/Uni-Lab-OS/Uni-Lab-Core/issues/184
    - https://github.com/Uni-Lab-OS/Uni-Lab-Core/issues/185
    - https://github.com/Uni-Lab-OS/Uni-Lab-Core/issues/186
    - https://github.com/Uni-Lab-OS/Uni-Lab-Core/issues/187
  result: aligned-design-document-pr
  human_reviewer: 昌珺涵