salla-docs

用途：在 Salla 文档体系中快速找到正确的参考页面与 API 架构。Salla 文档涵盖应用开发、商户/后台 API、Twilight 主题与店面等多领域，本技能用于定向检索。\n\n主要能力：\n1. 优先使用领域技能：每个 Salla 技能内嵌自有深链与经验证的差异点；若已有技能覆盖主题，应优先遵循该技能（如 salla-app-expert 按意图路由），本技能用于技能无法回答时。\n2. API 结构查询：端点的确切请求/响应或事件 payload schema，打开 docs.salla.dev 上的作用域页面，读取其内联 OpenAPI 规范作为字段名与类型的权威来源。许多端点页在 ```yaml 块中嵌入完整 OpenAPI 3.x 规范，包含 openapi、info、servers、paths、components、securitySchemes、security 及请求/响应 schema、字段类型、枚举、必填字段。读取 https://docs.salla.dev/<id>.md 页面的 openapi: YAML 块即为权威契约（例：https://docs.salla.dev/5394153e0.md 对应 POST /orders/options）。\n3. 当前参考工作流（校验与升级检查）：在 references/docs-map.md 中找到资源，拉取实时 https://docs.salla.dev/<id>.md，读取内联 OpenAPI 块，用于对照实时 schema 校验（字段名、类型、枚举、必填），循环机制见 salla-api-core；升级检查时对比当前规范与应用使用情况并展示可用升级；始终实时拉取而非缓存形态，遇到 404 说明句柄已重新编号，需通过索引重定位。\n4. 主题与作用域入口：提供 OAuth 2.0、Webhooks 与事件列表、应用事件（生命周期）、App Functions 概览与支持事件、店面事件（snippets）、通信应用 payload、Embedded SDK 模块、商户/后台 API 参考等入口链接；应用设置表单见 salla-app-settings 技能；React 主题（Twilight 引擎）见 salla_themes_docs 工具或 https://docs.salla.dev/twilight/react/llms.txt。\n5. 兜底重定位：https://docs.salla.dev/llms.txt 为完整 LLM 索引，大部分内容不在应用开发范围内，仅在句柄 404 时用于定位作用域页面。\n\n限制与注意：商户 API 参考端点众多，只打开所需资源；Twilight React 内部（路由、hooks、组件、插槽、store API 客户端、Salla CLI）在独立文档集中，使用 salla_themes_docs 工具（action=search、action=read，action=list 获取索引）或读取作用域索引后以 Markdown 打开单页，切勿加载 llms-full.txt；店面 snippet UI 或原生店面 UI 合规请路由至 salla-snippets 或 salla-storefront-ui。数值 URL 为可能被重新编号或移动的稳定句柄，使用前需确认页面为当前版本。