SuperAPI AI 工具集

salla-app-ui-builder

前端与建站

查看项目

更新于 10-16 01:26

技能介绍

用途:用于定制 Salla 应用在 App Store 中面向商家的上架/落地页。该页面由有序区块组成(App Information、Features、Reviews、Brands、FAQ、Stats 等,由 init/catalog 动态揭示),全部通过 app_page_builder MCP 工具编写,没有 REST 端点或 token。

主要能力:app_page_builder 提供 9 个 action,典型流程为 app_publish action=open 打开草稿 → app_page_builder action=init 播种必需区块 → action=list → action=show 查看区块元素键 → action=set 写入值 → action=add/remove/sort 调整。工具负责的字段:name、description、logo、screenshots、benefits。short_description 属于 publication 的 basic_information(50–200 字符),通过 app_publish → salla-publication-consistency 编写。

媒体:图片元素引用已上传的媒体 id,先用 salla_upload 传 source_url 得到整数 id,再在元素 set 值中放 [{ id, url }]。尺寸要求:logo 1:1 且 ≥250×250 px;screenshots ≥3 张,每张 263×350 px;benefit images 恰好 3 张;banner 可选;embedded_image 仅嵌入式应用,最小 710×260 px(推荐 1420×520),最大 512 KB。这些约束在保存时由服务端校验,action=set 不符会返回 error.fields。

限制与注意:需先有草稿(app_publish action=open);App Information 是唯一固定区块,始终第一且不可移除;App Plans 始终以占位形式渲染但非可编辑区块,需通过发布流程定价步骤填充;联系方式在 publication 的 contact_information;多语言元素含 ar/en;image 与 richtext 会作为公开内容渲染,仅用可信、已净化的资源。图片必须真实:缺失时应先向用户索取,不得凭空生成真实感图片;用户拒绝时可用明确标记的占位图,但必须告知合作方在 Portal 提交前替换。区块 id 与元素键为示例,调用时用 action=catalog / action=show 确认。相关技能:salla-publication-consistency、salla-app-builder、salla-app-settings、salla-docs。