用途:通过 salla_themes MCP 工具管理合作伙伴的 Salla Twilight 主题,包括列出、检查、创建、编辑和发布。主题不是应用,而是 Portal 代表合作伙伴创建并拥有的 GitHub 仓库,仓库中的 twilight.json 声明各页面/路径的组件与全局设置;主题结构只能从仓库读取,不能从主题记录读取。
主要能力:读取类操作有 list、get、github_config、categories、components、component_get、settings、screenshots、publishing 及商店列表;写入类有 create、update_details、screenshot_、component_、settings_update、publish、publish_withdraw、set_status 及商店系列。主题自身代码不属于该 MCP,需用 Salla CLI(salla theme …)。
使用方式:先执行 salla_themes action=list 确认会话与权限;用 list 加 q、status、type 缩小范围,再 get 取 theme_id;改动前用 github_config 读取 twilight.json(bundle 为 twilight-bundle.json)。创建需 name、name_ar、author_email,可选 type、theme_url、public、categories;创建会生成私有 GitHub 仓库,非幂等,超时后先 list 确认。新主题价格由服务端强制为 250,需在发布前用 update_details 修改。组件与设置写入会提交到 GitHub,settings_update 会合并,component_update 需 confirm: true。发布前需满足分类、价格大于 0、至少 4 张截图、无进行中提交、公司 ID 与服务证书已验证等条件;publish 是提交审核并冻结版本,不是直接上线。
限制:401 可能是会话过期或公司未启用主题白名单,403 是角色缺少 manage-themes;list 不受白名单限制,成功不代表可创建。写入无版本检查,可能覆盖仪表盘中的并发修改。具体字段规则与错误表见 theme-api-notes.md。