用途:在 ibl.ai 平台上为每个组织维护一个公开的元数据对象,应用可在其中保存自己的组织级配置,例如首页使用的智能体、应用名称、欢迎语等,无需自建数据库。平台自身的设置(默认智能体、帮助中心 URL、聊天宽度、功能开关、登录页品牌等)也存放在同一对象中。
主要能力:提供 lib/iblai/metadata.ts 中的 useOrgSettings<T>(),在 metadata.apps.<slug> 下进行带类型的读取与合并写入;提供 OrgSettingsForm 管理卡片(应用名称、欢迎语、支持链接),可挂载到 /admin/organization;vibe-starter 的 /setup 会将 defaultAgentId、appName、setupCompletedAt 存入此处,首页在 NEXT_PUBLIC_DEFAULT_AGENT_ID 为空时读取 defaultAgentId。
使用方式:若应用缺少 lib/iblai/metadata.ts,先运行 /iblai-vibe-user-metadata 第 2 步,再将 assets/org-settings.tsx 复制为 components/settings/org-settings.tsx(依赖 shadcn 的 card、input、label)。在客户端组件中导入 useOrgSettings 并传入默认值即可读取;管理员通过 update({...}) 保存,所有成员可读取。新增自定义键需扩展 OrgSettings 类型与表单,值应保持 JSON 可序列化且体积小。写入遵循 GET → 合并 → PUT,并在写入前重新读取。
适用场景:需要跨用户共享组织级配置的前端应用,如首页默认智能体、应用名称、欢迎语、支持链接等展示型设置。
限制:PUT 会整体替换对象,仅提交自有键会删除平台键(如 overall_default_mentor、help_center_url、auth_web_mentorai 及各类开关),因此必须合并后写入;元数据为公开可读,GET 无需认证,禁止存放密钥、令牌、不希望公开的价格或个人信息,仅限 ID 与展示字符串;写入需组织管理员,否则返回 403。品牌类设置(组织显示名、Logo、支持邮箱、帮助中心开关)在 SDK Account 的 Organization 标签页,默认智能体与高级菜单项在 Advanced 标签页,登录页品牌键由 /iblai-vibe-auth 写入,均不在本技能范围内。验证需运行 /iblai-vibe-ops-test,为新增页面、控件与状态在 e2e/journeys/ 添加 Playwright 测试并在 e2e/coverage.json 登记,通过 pnpm e2e:coverage、pnpm typecheck 与 pnpm test;保存前后用 curl 对比元数据,确认仅 metadata.apps.<slug> 变化且平台键完整;非管理员保存应显示提示而非崩溃。