用途:面向 polaris-app-home 表面的 Polaris Web Components(<s-*>)组件目录与规则参考,用于编写或编辑该界面的标记。组件查找、文档搜索与代码校验通过 /shopify-dev-mcp 完成。
主要能力与规则:涵盖布局结构(s-app、s-page、s-section、s-stack、s-grid、s-box、s-divider、s-app-nav、s-query-container)、排版内容、动作(s-button、s-link、s-clickable、s-menu 等)、表单、反馈状态、媒体、嵌入表面与覆盖层、表格以及 App Bridge API。规则包括:不使用已弃用组件;<s-link> 仅用于导航,动作使用 <s-button> 或 <s-clickable>;showOverlay()/hideOverlay() 是 <s-modal>、<s-popover> 上的 DOM 方法而非 App Bridge API;SpacingKeyword/SizeKeyword 从 small-500 到 large-500 递增。
使用方式:先在组件目录查找组件,若缺失则调用 /shopify-dev-mcp 的 search_docs_chunks(api_name: "polaris-app-home"),不要使用 fetch_full_docs;按规则和常见模式编写标记;再通过 validate_component_codeblocks(api: "polaris-app-home")校验,同一产物连续两次校验失败则停止并向用户反馈错误。常见模式包括图标按钮、可折叠盒子、带标签的分隔线等。
限制:文档标注 fetch_full_docs 在该表面已弃用;<s-skeleton-body-text> 不存在,加载态应使用 <s-spinner>;部分属性有严格取值(如 s-button-group 的 gap 仅 base/none)。具体版本、平台与费用信息暂未提供。