xgent-app-release · App 版本自助发布

这个 skill 用在 App 自己的 repo 里（门户代码不在你手上，也不需要在）。目标是：把构建好的前端 一次推上门户的某个 listing，并让「线上跑的是哪一版」在控制台上可辨认。

每次提交在门户侧落成一条发布提案，按内容自动定级：

• 自动通过档：dist（前端产物）· version · deployDescriptor.image · 展示字段 （name / tagline / desc / icon / color / cat / navItems / dashboardWidgets）· requiredEnvNotes（env 键的说明）—— 自动通过并应用清单/产物；后端与网关需分别确认，且每次留档（时间 + diff + 令牌前缀）。
• 审核档：其余一切（scopes / ACL 清单 / 依赖 / 跨应用授权 / 服务地址 / 席位 / 授权文案 scopeLabels / iframe 指向 embedUrl / 部署形态 / 部署前置 env 键清单 requiredEnv / 服务账号身份 serviceAccount.clientId / 嵌进门户管理面的管理页 adminPages / service 租户配置 tenantConfig / OAuth 标准发现 oauthDiscovery / 首次接入）都会改变权限面， ⇒ 提交成功但进入平台管理员的「发布审核」队列，批准前库里一字不动。 被拒绝时 status 与 --wait 都能看到原因。
• helpEntry（版头那枚帮助按钮）按【值】分档，同一个字段两种命运：写 App 内路由 （"/help"）是自动通过档——改一条自家路由不该等人审；写外站文档 （"https://docs.example.com"）进审核档——门户版头等于替这个域名背书。