oc-browser-relay 1.0.15 → 1.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oc-browser-relay",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "description": "Expose a local ChromeAgent/Relay Tool API to OpenClaw as agent tools.",
   "main": "index.js",
   "openclaw": {

package/skills/oc-browser-relay-sycm/SKILL.md

@@ -61,11 +61,12 @@ description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集生
 - 会话中默认以表格形式展示抓取到的指标
 - 表头固定为 `指标`、`数值`、`环比`
 - `指标` 列严格使用 `references/sycm-field-mapping.md` 中提供的中文名，不做任何改动，不展示英文字段名或参数名
-- `数值` 列取字段 `value`
-- `环比` 列取字段 `cycleCrc` 环比 = cycleCrc × 100，然后加上 % 符号 例如：cycleCrc=0.5 → 50%，cycleCrc=40 → 4000%
+- `数值` 列取字段 `value` 
+- `环比` 列取字段 `cycleCrc` 环比 = (cycleCrc * 100) + "%" 例如：cycleCrc=0.5 → 50%，cycleCrc=40 → 4000%
 - 会话表格中只允许展示这些字段对应的指标：`uv` `pv` `cltItmCnt` `cartByrCnt` `cartItemCnt` `payAmt` `netPaymentAmount` `payByrCnt` `payRate` `payOrdCnt` `payItmCnt` `payPct` `p4pExpendAmt` `cubeAmt` `adStrategyAmt` `admCostFamtQzt` `tkExpendAmt` `rfdSucAmt` `payShopRfdAmt` `ordRfdRate` `payAmtRfdRate` `realPayrealRfdRate`,不能增加其他字段
 - 即使某个字段数据为空、缺失或未返回，也要按映射名称保留该行展示，值可为空，不能直接省略整行
 - 输出结果严格限制为以下表格中的指标，不要加其他任何数据：
+- `payRate` `ordRfdRate` `payAmtRfdRate` `realPayrealRfdRate` 这四个字段 数值  = (value * 100) + "%", 例如：`0.25` → `25.00%`
 
 | 字段 | 指标 |
 | --- | --- |

package/skills/oc-browser-relay-taobao/SKILL.md

@@ -17,6 +17,32 @@ description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集淘
 - `browser_list_runtimes`
 - `browser_list_tools`
 
+## 使用边界
+
+仅在以下场景触发本技能：
+
+- 淘宝商品详情页
+- 天猫商品详情页
+- 商品评价/评论采集
+- 商品问大家/商品问答采集
+- 商品详情导出
+- 淘宝连接排查
+
+不要用于这些场景：
+
+- 淘宝搜索页、店铺页、活动页、榜单页
+- 1688、阿里国际站、闲鱼、京东、拼多多、抖音、小红书
+- 通用网页文章、种草帖、直播间页面
+- 价格对比、推荐排序、竞品分析这类需要主观推断的请求
+
+链接判断规则：
+
+- 只接受淘宝/天猫商品详情页 URL
+- 常见可接受域名包括 `item.taobao.com` 和 `detail.tmall.com`
+- 用户提供的 `url` 必须原样传给工具，不要改写、补参数、删参数、解短链、替换域名或重新拼接
+- 用户只给商品 ID、商品标题、截图或“这个商品”而没有详情页链接时，不直接调用工具，先要求提供商品详情页 URL
+- 用户给的是搜索页、店铺页、短链跳转页或无法确认是否为商品详情页的链接时，先指出链接类型不对，再要求提供详情页链接
+
 ## 意图分流
 
 ### 商品详情和评价
@@ -28,6 +54,24 @@ description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集淘
 - 看看这个商品的详情和评价
 - 帮我多抓一些评价
 
+用户说这些时，也使用 `taobao_collect_product`：
+
+- 只抓商品详情
+- 帮我抓详情
+- 只看详情不要评论
+- 详情先抓一下，评论不要
+- 获取商品的SKU信息
+- 获取 SKU
+- 看一下 SKU
+- 帮我导出这个商品信息
+- 看看这个商品值不值得买
+
+用户说这些时，仍然使用 `taobao_collect_product`，但要带上问大家参数：
+
+- 把详情、评论、问大家一起抓下来
+- 这个商品详情和问大家都要
+- 评论和问大家都导出
+
 参数约定：
 
 - `url` 必填，必须是淘宝或天猫商品详情页
@@ -36,6 +80,18 @@ description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集淘
 - `targetAskAnswerCount` 仅在 `includeAskAnswers=true` 时生效，默认 60
 - `saveToFile` 默认 `true`，保存到 workspace `taobao/`
 
+参数策略：
+
+- `url` 一律使用用户原始输入，不做任何规范化或重写
+- 用户明确说“只抓详情”“不要评论”时，传 `targetCommentCount=0`
+- “获取 SKU”“看 SKU”“SKU 信息”都属于商品详情采集，不是单独工具，不额外切到问大家或评论意图
+- 用户明确说“多抓一些评价”时，`targetCommentCount` 建议传 200
+- 用户明确要求“详情+评论+问大家”时，传 `includeAskAnswers=true`
+- 只有在 `includeAskAnswers=true` 时才传 `targetAskAnswerCount`
+- 用户没有明确说抓多少条时，评价固定使用 `targetCommentCount=50`
+- 不要因为上一轮抓过很多条，或历史上下文里提到过更大数量，就擅自把默认值改大
+- “值不值得买”这类请求仍然先做结构化采集；不要脱离工具结果直接主观下判断
+
 ### 问大家
 
 用户说这些时，使用 `taobao_collect_ask_answers`：
@@ -43,23 +99,57 @@ description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集淘
 - 帮我采集问大家
 - 抓一下这个商品的问大家
 - 看看这个商品的问答
+- 导出这个商品的问大家
+- 看商品问答
 
 参数约定：
 
 - `url` 必填，必须是淘宝或天猫商品详情页
 - `targetAskAnswerCount` 可选，默认 50
+- `targetCommentCount` 默认不传；只有用户明确要求“问大家顺便带评论”时才传
 - `saveToFile` 默认 `true`
 
+参数策略：
+
+- `url` 一律使用用户原始输入，不做任何规范化或重写
+- 用户没有明确说抓多少条时，固定使用 `targetAskAnswerCount=50`
+- 用户明确说“问大家顺便带点评论”时，才补 `targetCommentCount`
+- 不要把“问答”“问大家”理解成评论区，也不要改用 `taobao_collect_product` 代替
+- 不要根据上一轮问大家数量或模糊的“多抓一点”把默认 50 擅自改大
+
 规则：
 
 - 默认不要把评论/评价和问大家混在一起；只有用户明确要求，或显式传了 `includeAskAnswers=true`，才在 `taobao_collect_product` 后继续采问大家
+- 用户明确说“只抓详情”“只看详情不要评论”时，使用 `taobao_collect_product`，并传 `targetCommentCount=0`
 - 用户明确说“问大家”“商品问答”“问答”时，必须使用 `taobao_collect_ask_answers`；不要改成 `taobao_collect_product`，也不要抓评价/评论代替问大家
 - 用户明确说“评价”“评论”时，才使用 `taobao_collect_product`；不要把评价需求解释成问大家
+- 用户明确说“SKU”“规格”“商品规格”时，按商品详情处理；不要把 SKU 当成独立采集类型
 - 如果用户给的是搜索页或非商品页，要直接指出并要求商品详情页链接
+- 不要修改用户输入的 URL；即使链接里带追踪参数、分享参数或其他查询参数，也不要擅自删改
 - 结果保存时保持原始 JSON，不做字段重命名
 - 用户说"多抓一些评价"时，`targetCommentCount` 建议传 200
 - 用户没有明确说抓多少条时，问大家固定使用 `targetAskAnswerCount=50`，评价固定使用 `targetCommentCount=50`
+- 当 `targetCommentCount=0` 时，表示只抓详情，不抓评论
 - 不要根据上一轮对话、历史结果或“多抓一些”的模糊印象，把默认 50 擅自改成 100、200 或其他值
+- `saveToFile` 除非用户明确要求不保存，否则保持默认 `true`
+- 返回结果时保留原始 JSON 结构；不要重命名字段、删字段、合并字段或改成自定义摘要结构
+- 如果用户要求“导出”，优先沿用工具默认落盘，不额外改写格式
+- 如果用户要求基于采集结果继续分析，可以在采集完成后单独做分析，但不能把分析结果覆盖原始数据
+- 连续多轮里，如果本轮用户只说“再抓一次”“继续抓这个商品”，默认沿用上一轮同一个商品链接和同一个采集意图；但不要擅自把“详情”升级成“详情+评论+问大家”
+
+## 输出约定
+
+- `taobao_collect_product` 的保存结果应是商品详情、评论，以及可选的问大家原始 JSON
+- `taobao_collect_ask_answers` 的保存结果应是商品详情和问大家原始 JSON
+- 采集后在会话里可以简要概括采到了什么，但不要伪造未采到的字段
+- 如果工具返回了保存路径，可直接告知保存位置
+
+## 失败处理
+
+- 页面不是商品详情页：直接指出链接不对，要求提供淘宝/天猫商品详情页 URL
+- 结果里没有评论或问大家：先按“页面无数据、加载受限或采集未完成”表述，不要臆测为商品一定没有评论/问答
+- 采集慢或失败时，先按连接问题排查；不要直接当成代码 bug
+- 用户说“打不开”“采集不了”“没数据”“帮我检查一下”时，优先使用诊断工具确认 relay、runtime、tools 是否在线
 
 ## 连接排查