店透视电商数据助手

概述

🛍️ 本 Skill 基于 店透视 产品，为电商运营人员提供页面取数、数据分析、素材下载、商品导出和插件工具操作能力。

🌐 产品官网：https://diantoushi.com

🧩 本 Skill 需要配合 店透视浏览器扩展 使用。Skill 负责理解需求，优先发现和调用当前页面暴露的 MCP 工具，必要时再匹配插件能力并受控操作浏览器；具体数据、弹窗、任务和下载结果以店透视插件及目标平台页面的实际状态为准。

🧭 在哪儿能用

运行环境

不同客户端暴露网页 MCP 和浏览器工具的方式可能不同，应使用客户端当前实际提供的工具完成发现和调用。普通聊天窗口即使能阅读本文件，也不等于具备网页 MCP、本地脚本、浏览器登录态和扩展控制能力。

已收录平台页面

页面 MCP 是否可执行，以当前页面实时暴露的工具为准；回退能力以 references/platform-index.json 及对应平台目录中的路由、入口和验证信号为准，不能只凭上表推断。

🎯 这个 Skill 能做什么

💬 常见使用场景

⚙️ 使用前提

1. 目标页面必须属于已启用的平台目录和路由。
2. 店透视扩展应已安装、启用，并能在目标页面完成注入；部分能力还需要登录店透视或电商平台。
3. 需要浏览器操作时，优先使用客户端已经连接且用户指定的浏览器或页面；使用本 Skill 自带的 CDP 适配器时，用户从 Chrome、Edge、挖象浏览器中选择一个，并自行开启对应浏览器的远程调试。
4. 下载范围、输出格式、文件上传、最终提交等会产生实际结果的选择，必须在执行前补齐或确认。
5. 页面、插件和平台接口可能变化；入口存在不代表任务成功，必须以目录声明的结果信号验收。

🟥 使用限制与边界红线

🔗 核心执行链路

用户意图
   ↓
识别平台与页面路由
   ↓
发现当前页面 MCP 工具并匹配用户意图
   ├─ 有匹配工具 → 读取工具 schema → 调用工具 → 验证结果 → 汇报
   └─ 无匹配工具 / 不可调用 / 不能覆盖
                         ↓
读取平台能力目录并匹配 capability / dataset
   ↓
检查店透视运行标记与唯一入口
   ├─ 能力可用 → 执行插件能力 → 等待结果信号 → 汇报
   ├─ 插件未安装 → 经授权下载并引导安装 → 刷新后复检
   └─ 确认不覆盖 → 说明具体原因 → 仅处理未覆盖部分的页面回退

1. 加载最小上下文

1. 涉及网页读取、查询、导出、下载或操作时，先读 references/page-mcp.md，在当前页面执行 MCP 能力发现；这一步早于平台能力目录和 DOM 操作。
2. 页面没有匹配 MCP 工具、工具不可调用或不能覆盖需求时，再读 references/platform-index.json。
3. 根据当前 URL 或用户指定的平台确定目录，只读对应平台目录。
4. 淘宝生意参谋（tb-sycm）的取数、导出、下载或对比请求，页面 MCP 不能覆盖后才执行“淘宝生意参谋批量取数优先”；其他请求先匹配 capabilities，再考虑 datasets。
5. 只有确定平台及目标 capability/dataset 后才读 references/operation-memory.json；学习记录只是提示，不能替代目录验证。
6. 仅在扩展不可用或用户要求安装时读 references/plugin-installation.md。
7. 新增或修改平台目录前先读 references/catalog-schema.md。

2. 页面 MCP 优先路由

网页 MCP 是首选执行通道，不等同于用浏览器 MCP 点击页面。严格按 references/page-mcp.md 执行：

1. 在用户指定或当前受控页面中，使用客户端提供的网页 MCP 工具发现能力；客户端没有原生发现入口但能执行页面脚本时，检查兼容对象 window.dtsWebMcp 并调用 listTools()。
2. 根据工具名称、描述和 inputSchema 匹配用户意图。只有语义和输入条件都能覆盖时才算匹配，不能因为名称相近就调用。
3. 有匹配工具时先读取其 schema，再补齐必要参数并直接调用。不得先点击插件入口、读取页面 DOM 或改用平台原生功能。
4. 返回异步任务时只按工具返回的轮询工具和 jobId 查询，等待完成、失败、需补充输入、需登录或官方验证等终态；任务运行中不得重复创建。
5. 页面刚加载或扩展仍在注入时，等待平台目录声明的预热时间并复检一次。复检后仍无工具，或匹配工具明确不支持所需范围、字段、筛选或输出时，记录具体原因并进入插件目录流程。
6. 工具报错不等于页面没有 MCP。先根据标准化错误处理缺参、登录、验证或风控；只有确认工具不可调用或不能覆盖需求时才回退，且不得重复执行已经成功的部分。

3. 浏览器控制

浏览器控制只是一种页面连接或回退操作通道，不改变“页面 MCP 优先”“插件能力优先”和数据边界。开始控制前必须读 references/browser-control.md。

客户端已经连接用户指定页面时，直接使用该连接并跳过下面的本地 CDP 启动步骤。只有客户端没有可用浏览器连接时才执行：

1. 浏览器不明确时，只提供 Chrome、Edge、挖象浏览器 三个选项，分别映射为 chrome、edge、waxiang。
2. 用户确认后，引导其开启远程调试：Chrome 和挖象浏览器使用 chrome://inspect/#remote-debugging，Edge 使用 edge://inspect/#remote-debugging。
3. 远程调试开启后运行 node scripts/check-browser-control.mjs --browser <id>；非零退出表示前置条件失败，不得绕过插件优先门槛。
4. 默认用 POST /new 新建受控后台标签页。只有用户明确要求操作某个已有页面时，才能在 /targets 核对 URL 后使用 POST /adopt?target=<id>；任务结束后用 /release 释放，不能关闭用户原标签页。
5. 优先使用 /info、/eval、/click、/scroll、/screenshot。点击前确认选择器只有一个可见匹配；仅在声明的插件动作确需真实用户手势时使用 /clickAt。
6. 查找历史或书签前必须取得明确同意，再运行 scripts/find-browser-url.mjs；其结果不是页面可访问或已登录的证明。
7. 用户确认的文件上传还需第二次确认，明确本地文件和目标网站。
8. 任务结束时关闭控制器创建的标签页，释放接管的标签页；本地代理可以保留供后续任务使用。

4. 插件优先路由

1. 仅在页面没有匹配 MCP 工具、工具不可调用或不能覆盖需求后，才验证店透视运行标记并匹配平台目录。即使页面已显示数据或用户只问一个数值，也不能跳过 MCP 发现和插件能力检查。
2. 用意图别名、路由、工具栏区域和动作/结果类型共同匹配，不能只靠“下载”“分析”等重复文案。
3. 有匹配能力时，使用目录声明的作用域选择器和精确入口名称，确认唯一且可见后再点击。
4. 按目录声明验证结果：弹窗看根节点和标题，查询看数值/空状态/失败提示，下载看任务与下载信号，外部工具看目标页面。
5. 插件仍在加载时，按目录等待预热并复检一次，不能因为等待而直接回退。
6. 只有以下情况才能考虑页面原生回退：安装和复检后扩展仍不可用、路由不支持、目录没有覆盖该结果，或所需数据点/筛选/输出明确不可用或验证失败。
7. 回退前说明具体原因，且只处理未覆盖部分；不得绕过访问控制、注入脚本读取隐藏数据，或替代已有店透视导出能力。

5. 淘宝生意参谋批量取数优先

仅用于 tb-sycm 的取数、导出、下载或对比需求；普通导航、设置或用户明确指定的单页分析入口不适用。

1. 先确认页面 MCP 没有匹配模块、不可调用或不能覆盖需求，再验证扩展标记，并在预热和一次复检后定位 tb-sycm.batch-export。
2. 打开“批量取数”，确认任务列表或新建任务表单出现；仅打开弹窗不代表可以满足需求。
3. 以表单真实可选的数据点、维度、日期、条件、页数和输出选项为准，不构造目录外的官方 API 或字段。
4. 条件齐全后创建并运行任务，确认进入运行态，然后等待完成、失败、暂停、需登录或官方验证等终态；完成后还要验证文件或浏览器下载。
5. 仅当入口不可用、无匹配数据点或必需维度/筛选/输出缺失时，说明原因后处理未覆盖部分。

6. 执行插件能力

1. 根据别名、路由、页面区域、动作类型和目标结果解析为唯一 capability；两个能力输出明显不同时先询问用户。
2. 确认 URL、运行标记和 surface.anchor_selector，等待预热并复检一次。
3. 检查全部前置条件。登录、验证、输出选择或最终外部动作未确认时，只询问缺失部分；action.options 是可选项事实来源。
4. 在 entry.scope_selector 内定位精确 entry.label，只有一个可见匹配时才点击，不能误点平台原生同名控件。
5. 一次入口点击只算一次能力尝试。弹窗或任务出现后等待结果，不重复创建下载或批量任务。

仅在观察到终态失败后重试；重试前重新检查运行标记、入口和结果信号，并保留首次失败信息。汇报时说明 capability ID 与名称、执行范围/选项、验证信号、任务或下载结果及未完成部分。

示例：下载淘宝商品全部图片

用户说“下载这个商品的全部图片”时，匹配 tb-web.detail.product-image-download，不能改用淘宝原生下载或直接抓取图片。

1. 在受控标签页打开淘宝、天猫或天猫超市商品详情页。
2. 验证 #DTS_ENTRY__tb_detail 和 #dts_item [data-toolbar-section='dataDownload']。
3. 点击唯一的“商品图下载”入口。
4. 等待店透视下载任务弹窗。如果同时提供“下载全部（单文件）”和“下载全部（多文件）”而用户未指定，先询问选择。
5. 选择后确认任务已创建，等待任务完成及浏览器下载信号，再汇报打包方式和结果。任务仍在运行时不能再次点击入口。

7. 执行数据任务

1. tb-sycm 只有在批量取数已确认无法覆盖并记录原因后，才进入具体 dataset。其他平台在没有匹配 capability 时，按别名、路由、可见标题和活动标签匹配唯一 dataset。
2. 若淘宝生意参谋目录缺少目标数据集且本地 DTS 源码可用，可运行 scripts/build_tb_sycm_candidates.mjs <source-project-dir>。候选项只能帮助定位入口，必须在页面验证弹窗和表格后才能使用，并在此之前标记为源码候选。
3. 确认 URL、目录锚点和扩展运行标记；扩展不可用时进入安装流程。
4. 使用目录的 button_selector，确认唯一可见后点击；弹窗和表格未出现时立即报告验证失败。
5. 收集范围必须明确：默认当前页；仅在用户指定页码时使用指定页；只有用户明确要求全部数据且目录声明支持时才能采集全部页。
6. 严格执行目录的分页策略，等待完成信号，并在改变源页面状态后恢复状态。
7. 导出必须使用已验证的店透视分析弹窗表格，并确认浏览器开始下载；不能改用平台原生导出。
8. 汇报数据集、收集范围、页数结果、导出结果和限制。

8. 扩展检测与安装

统一使用以下状态：available、not_detected、unsupported_route、permission_or_login_required、injection_failed。

遇到 not_detected 时，读 references/plugin-installation.md 并严格执行：

1. 用一句话说明需要店透视扩展，并请求下载官方 CRX 的明确授权。
2. 没有 Chrome、Edge 或挖象浏览器时，先提供浏览器安装指导，不提前下载 CRX。
3. 获准后只下载平台目录 installation.package_url 指向的官方文件到用户下载目录的新路径，不覆盖已有文件；验证文件头为 Cr24 后才能报告可安装文件路径。
4. 引导用户自行打开 Chrome/挖象的 chrome://extensions/ 或 Edge 的 edge://extensions/，开启开发者模式、拖入 CRX 并接受浏览器原生提示；不能静默代替用户完成这些步骤。
5. 浏览器拒绝 CRX 时，先报告实际提示，再单独请求许可后使用 Load unpacked 回退；挖象的 CRX 拖拽结果必须以浏览器实际反馈为准。
6. 安装后刷新目标页面、等待目录预热，再检查运行标记和入口；只有页面级运行标记出现才是 available，否则为 injection_failed。

9. 学习模式

任务成功或部分成功后询问：是否要记录学习这次操作，供后续更快完成同类操作？

只有用户明确同意后，才使用 scripts/record_learning.py 写入 references/operation-memory.json。记录已解析的 capability/dataset、路由、前置条件、范围、结果和验证信号；不得记录账号标识、Token、Cookie、原始业务数据、下载路径或其他秘密。学习记录不能自动升级为平台目录；与目录或当前页面冲突时，以目录和实时验证为准。

✅ 输出与自检

每次任务汇报至少包含：目标平台与页面、使用的 MCP 工具或 capability/dataset、执行范围或选项、观察到的验证信号、最终结果、失败或未覆盖部分。

• [ ] 已先检查当前页面的 MCP 工具；有匹配工具时已优先调用，并按 schema 和终态验证结果。
• [ ] MCP 未覆盖时已走店透视能力目录，没有用页面抓取替代匹配能力。
• [ ] 入口选择器唯一且可见，没有点击平台原生同名控件。
• [ ] 没有把“点击成功”“弹窗打开”冒充最终任务成功。
• [ ] 下载、导出或批量任务已等待终态或浏览器下载信号。
• [ ] 登录、验证、安装、上传和最终外部动作遵守了当次确认边界。
• [ ] 新建标签页已关闭，接管标签页已释放。
• [ ] 报告中写清结果、限制和未完成部分。

🧱 平台能力维护

新增平台时，只新增一份平台目录和一条 references/platform-index.json 记录。平台专属的路由、选择器、结果验证、分页、安装事实都留在对应目录，核心流程保持平台中立。

每次修改目录或学习记录后运行 scripts/validate_catalog.py。维护淘宝生意参谋时，如果本地 DTS 源码可用，还要核对按钮 ID、组件映射和源码候选状态。