Sparq 开发者中心

plugin.yaml 保存插件身份与协议兼容范围；Manifest 声明组件、入口和宿主贡献。Local 插件随宿主编译，Remote 插件通过独立进程提供能力。

按生命周期装配服务，将 HTTP 路由、Schema Resource 和 Capability 接入对应边界，避免在模板或界面层承载业务规则。

theme.yaml 声明主题身份与视图映射，views/ 保存 Blade 模板，assets/ 保存样式、脚本和图片，第三方许可放入 licenses/。

通过布局与局部模板复用页头、页脚和导航。静态资源使用 asset() 生成地址；模板读取宿主提供的视图上下文，不直接访问数据库。

平台账户接口使用 Bearer Token。请求头传入 Authorization: Bearer TOKEN，当前用户入口为 GET /cloud-api/usercenter/v1/me。

将令牌保存在受控环境中，不写入公开仓库或主题资源。按 HTTP 状态与响应业务码处理错误：401 表示需要有效身份，403 表示权限不足，429 表示请求受限。

使用 Schema 声明资源字段、选项、校验和视图，通过 Runtime 连接后端业务处理，再由 Schema Renderer 生成管理界面。

迁移、资源协议和业务事务分别由其所属模块负责；普通内容页面与宿主管理界面沿用各自的展示边界。

插件按 build、package、publish 组织交付。构建检查清单与依赖，打包消费构建产物，发布将版本与源码包提交至平台审核。

发布前检查版本、依赖、资源许可与授权范围，并在实际宿主中验证安装和调用。主题发布同时维护模板市场清单与运行时主题清单。

首先确认宿主版本、插件运行模式及所需依赖，再按请求链路检查路由、身份、权限与能力调用。

保留错误信息、复现步骤和最小示例。反馈问题时注明版本和运行环境，避免公开密钥、令牌或用户数据。