setup

用途

Setup 用于为 Lexsis 店面工作流建立一份持久、可复用的店铺地图。后续的店面技能在做出页面决策之前，会先读取这份上下文。该技能是只读的：它解析 Lexsis 数据并写入本地 Markdown/CSS 上下文文件，不会创建页面或生产资产。

主要能力

连接并解析 Lexsis 工作区、店铺与主题。
读取品牌上下文、品牌套件、导航与设计指南。
分页读取商品目录，必要时按批次补充商品详情。
读取评论可用状态与活跃评论集合。
基于已验证的品牌/店铺数据、目录模式、商家备注和用户确认信息构建用户画像上下文。
将结果写入结构化的本地文件，并保留来源与刷新日期。

使用方式

使用以下精确动作槽位：

身份：lexsis_workspace.list、lexsis_workspace.get、lexsis_workspace.stores
品牌与主题：lexsis_brand.context、lexsis_brand.brand_kit、lexsis_brand.list_themes、lexsis_brand.get_theme、lexsis_brand.navigation、lexsis_design.guide
目录：lexsis_catalog.list、lexsis_catalog.get
证明可用性：lexsis_catalog.reviews_status、lexsis_catalog.review_collections

当动作参数不熟悉时，先解析该路由/动作的 schema 再调用。目录查找无结果并不代表连接失败；域调用才是权威来源。

写入的店铺上下文结构

work/storefront/
+-- setup.md
+-- stores/
    +-- <workspace-id>/
        +-- <store-id>/
            +-- brand.md
            +-- design.md
            +-- products.md
            +-- persona.md
            +-- rules.md
            +-- themes/
                +-- <theme-id>.css

路径中使用 id，标题中使用名称。绝不混合不同工作区、店铺或主题的上下文。

流程

选择范围：读取已有的 work/storefront/setup.md；调用工作区相关动作；按名称和域名展示选项；仅在存在多个有效选项或用户想保存多个时询问用户；解析主题并记录一个默认工作区、店铺和主题。
读取店铺上下文：读取工作区详情、品牌上下文、品牌套件、导航、所选主题、设计指南；分页读取商品目录直到没有下一页游标；读取评论状态并分页读取活跃评论集合；将已验证的 MCP 事实与商家确认的本地备注合并，明确标记未解决或推断的信息。
写入店铺文件：先写入临时同级路径，验证绑定和必需标题后再替换旧文件；始终最后写入 setup.md，使其索引不会指向不完整的刷新。

文件契约

使用以下精确标题，保持文字紧凑，优先使用短表格：

setup.md：默认项、已保存店铺、上下文映射、不完整上下文。
brand.md：绑定与来源、身份、定位、信息层级、语气与词汇、视觉识别、导航、已知客户顾虑、开放问题。
design.md：绑定信息，以及 Lexsis 返回的精确设计指南。不要重写、规范化或合并返回的指南。
products.md：快照、产品表格、目录缺口。每个产品一行，价格和可用性标注为带日期的快照。
persona.md：绑定与置信度、市场背景、画像索引、各画像详情（快照、行为、顾虑与障碍、触发因素与期望结果、语言、决策标准、所需证明、产品与品类映射、证据、开放问题）。
rules.md：声明台账、语言控制、保证/配送/退货/交付、优惠与定价控制、认证与受监管内容、评论可用性、活跃评论集合、商家决策、需要确认的未知项。
themes/<theme-id>.css：保存该主题返回的精确 theme_css，不同主题保持独立文件。

验证

返回前需确认：每个保存的店铺路径包含全部五个 Markdown 文件和至少一个所选主题 CSS 文件；文件绑定中的 id 与路径及 setup.md 匹配；默认项解析到同一层级中已保存的条目；目录分页到达终止游标；每个产品在 products.md 中只出现一次；画像使用稳定 id 和证据标签；不可用的域出现在 setup.md 中；未保存凭据、授权值、客户记录、完整评论文本、图像二进制或原始产品 JSON。

报告 work/storefront/setup.md 路径；已保存的工作区、店铺和主题名称；默认项；已刷新的域和日期；每个店铺的产品数和画像数；不完整的上下文、失败的 MCP 读取和待用户确认项。

适用场景

适用于需要为 Lexsis 店面建立或刷新结构化店铺上下文的场景，供后续店面技能在页面决策前读取。

限制

只读操作，不创建页面或生产资产。
不复制客户记录或完整评论文本。
不保存凭据、授权值、图像二进制或原始产品 JSON。
后续技能不会自动调用 /setup。
关于收费、价格、平台支持范围等信息暂未提供。