Studio 在代码定义的包里把「只读」一刀切到所有类型：运行时实测接受其中 15 类的 overlay 写入，同屏还并存「可写」徽标与全部禁用的控件

[os-zhuang]

Migrated from objectstack-ai/objectstack#5768 under the file-at-destination ruling (objectstack-ai/objectstack#7167, maintainer 2026-08-10). Originally filed 2026-08-06T04:31:30Z. The full prior thread — including triage rulings and hold/restart conditions — remains on the source issue and MUST be read before acting on this card.

---

Studio dogfood 时发现（最新 main 5e3c83bd0 + objectui 5a24ad9cb89c，showcase 实例，/_console/studio/com.example.showcase/*）。

先说清楚：「代码定义的包不给在 Studio 里改」很可能是有意的产品策略（提示语「请切换或新建可写软件包后再编辑」读起来就是一条策略）。本条真正想请判定的是：这条策略与运行时的实际能力、以及 Studio 自己在同一屏上的其它显示，三者对不上。

三处证据

1）运行时明确接受其中 15 类的 overlay 写入

对同一个包 com.example.showcase：

PUT /api/v1/meta/object/showcase_account   → 403
{"error":"[NOT_OVERRIDABLE] 'object' is not allowOrgOverride in the registry.
  Overlay-allowed: view, page, dashboard, app, action, report, dataset, flow,
  translation, email_template, book, permission, position, tool, skill. ...",
 "code":"NOT_OVERRIDABLE"}

object 被正确挡住了 —— 服务端闸门是真的，不是只在 UI 上禁用（这点值得肯定，我专门验了）。但同一条报错里，服务端自己列出了 15 个 overlay-allowed 类型。挑其中一个实测：

PUT /api/v1/meta/view/showcase_task.in_progress   → 200
{"success":true,"seq":1,"state":"active",
 "message":"Saved customization overlay (env-wide, state=active) — type=view, name=showcase_task.in_progress [seq=1]"}

写进去了。 （我已把 label 改回 进行中 还原。）

2）Studio 对这 15 类一律禁用

/_console/studio/com.example.showcase/interfaces（视图 / 页面 / 看板 / 应用 —— 全是 overlay-allowed 类型）：

{"保存草稿": {"disabled": true, "title": "只读软件包 — 请切换或新建可写软件包后再编辑。"},
 "发布":     {"disabled": true, "title": "只读软件包 — 请切换或新建可写软件包后再编辑。"}}

也就是：运行时接受的写入，Studio 不让你发起。

3）同一屏上并存「可写」徽标与全部禁用的控件

/_console/studio/com.example.showcase/access，权限集 showcase_contributor 的标题行渲染成：

权限集 · showcase_contributor · 安全 · 可写 · 已授权对象 5 · 字段覆盖 3 · 历史
                                      ^^^^

而同一个屏幕上：207 个权限勾选框全部 disabled，发布 也 disabled，理由写着「只读软件包」。一个贴着「可写」的对象，它的每一个控件都是灰的。

顺带同类的一处：数据 → 表单 标签页在这个只读包里显示

布局 · 预览 · 草稿布局 · 含未保存改动

—— 在一个什么都改不了、保存草稿 是灰的包里，声称「含未保存改动」。（该处 [draggable=true] 数量为 0，拖拽本身确实被正确禁用了，所以这纯粹是文案与实际状态不符。）

请判定的问题

A. 代码定义的包里，overlay-allowed 的那 15 类到底该不该在 Studio 里可编辑？

• 若该：interfaces / access 的禁用是过度保守 —— Studio 藏起了运行时真的提供的能力（AGENTS.md Prime Directive [WIP] Enhance every detail of the designer #10 反过来的那一面：declared ≠ enforced 的镜像，这里是 delivered ≠ offered）。禁用应当按类型判定，而不是按包一刀切。
• 若不该（策略优先，避免代码包与运行时 overlay 产生漂移）：那么 2 是对的，需要修的是 1 和 3 —— 服务端为什么还接受这条写入？以及「可写」徽标不该出现在这里。

B. 无论 A 怎么判，3 都是要改的：「可写」徽标和「含未保存改动」在全禁用的界面上是误导性 affordance。

复现

1. pnpm dev（showcase），登录 admin@objectos.ai / admin123
2. 打开 /_console/studio/com.example.showcase/interfaces
   → 保存草稿 / 发布 均为 disabled，title「只读软件包 — 请切换或新建可写软件包后再编辑。」
3. 浏览器控制台：
   fetch('/api/v1/meta/view/showcase_task.in_progress',{credentials:'include'})
     .then(r=>r.json()).then(v=>{v.label='PROBE';
       return fetch('/api/v1/meta/view/showcase_task.in_progress',
         {method:'PUT',credentials:'include',headers:{'content-type':'application/json'},
          body:JSON.stringify(v)}).then(r=>r.status)})
   → 200（记得改回 '进行中'）
4. 打开 /_console/studio/com.example.showcase/access，选 showcase_contributor
   → 标题行有「可写」徽标，下方 207 个勾选框全部 disabled

本轮一并验过、确认没问题的（避免后续重复排查）

• Studio 四个面（数据 / 自动化 / 界面 / 权限）都正常渲染真实内容：对象列表 23 个、flow 列表带启用状态、导航树、权限矩阵 23×CRUD + 字段覆盖。
• 数据 的内层页签（记录 / 表单 / 验证 / 钩子 / 操作 / API / 设置）可切换；表单设计器正确渲染 12 个字段及其类型（TEXT/SELECT/CURRENCY/URL/LOCATION/DATE/JSON）。
• 打开条目时的 GET /api/v1/meta/<type>/<name>?state=draft → 404 {"code":"NO_DRAFT"} 是有意设计（错误码明确、UI 正确降级），不是缺陷。唯一可议的是不存在的条目也返回同一个 NO_DRAFT，无法区分「没有草稿」与「这个条目根本不存在」—— 单独提一句，不作为本条主张。
• 服务端对 object 的 NOT_OVERRIDABLE 拦截是真闸门，报错信息给了可执行的下一步（OS_METADATA_WRITABLE）。

影响面

Studio 编辑面。不影响已发布应用的运行时行为，也不影响数据。属于「能力可达性 + 界面自洽性」问题。

[yinlianghui]

CLAIM(B 半边) — session session_017Qqyix2QcnpUC9XeYVDzx3(objectui whole-repo PM seat),dispatching now。Branch: claude/issue-4036-studio-readonly-affordances。

执行依据:源线程 objectstack#5768 的维护者批复半裁(2026-08-06 两条):

• B 半边放行 objectui 先行(本次派发):「可写」徽标与「含未保存改动」等误导 affordance 修正——显示侧收敛到当前实际策略(包级一刀切只读)。B 落地不影响 A 的任一走向。
• A 半边仍待拍(不派、不裁):15 类该不该 Studio 可编辑属逐类产品判定,且 A2 已定方向为「Studio 维持只读、收紧服务端注册表对照 ADR-0005 修正案」(permission/flow/tool/skill 四类明文禁止 per-org override,注册表与 Accepted ADR 冲突须归一)——该复核归 spec/engine 车道。本卡 A 半入决策收件箱等待位,勿催。

本卡在 B 落地后保持 open(A 半为剩余),PR 用 Part of #4036。

Surface:Studio 编辑面的徽标/文案渲染(app-shell metadata-admin / studio 组件)+ 测试;metadata-admin 区域当前无在飞持有者。

---

Generated by Claude Code