oc-browser-relay 1.0.26 → 1.0.28

package/package.json

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

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

@@ -1,13 +1,16 @@
 ---
 name: oc-browser-relay-article
-description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集任意 http/https 网页文章内容，返回页面 HTML 并保存为 Markdown。适用于所有网页文章，包括微信公众号、知乎、掘金、36氪、medium、博客、新闻页等任意网页。仅在用户明确给出网页链接，并要求获取正文、保存文章或导出文章时使用；不用于平台后台经营数据、商品详情采集或小红书搜索结果。
+description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集任意 http/https 网页文章内容。优先先抓取 cleanedHtml 和 markdownPreview，再由调用方模型提取正文并保存为 Markdown。适用于所有网页文章，包括微信公众号、知乎、掘金、36氪、medium、博客、新闻页等任意网页。仅在用户明确给出网页链接，并要求获取正文、保存文章或导出文章时使用；不用于平台后台经营数据、商品详情采集或小红书搜索结果。
 ---
 
 # 文章采集技能
 
 ## 默认工具
 
-- `get_article`
+优先使用：
+
+- `fetch_article_html`
+- `save_article_markdown`
 
 诊断时才用：
 
@@ -18,7 +21,7 @@ description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集任
 
 ## 意图分流
 
-用户说这些时，使用 `get_article`：
+用户说这些时，优先走 `fetch_article_html -> save_article_markdown`：
 
 - 帮我获取这篇文章
 - 抓一下这个链接的正文
@@ -27,26 +30,39 @@ description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集任
 - 帮我读一下这个链接
 - 把这个页面保存下来
 
+推荐流程：
+
+1. 调 `fetch_article_html({ url })` 获取 `cleanedHtml` 和 `markdownPreview`
+2. 以 `cleanedHtml` 的结构为主判断文章主标题和正文边界，以 `markdownPreview` 辅助理解文本内容
+3. 提取最终正文 Markdown 后，调 `save_article_markdown({ url, title, markdown })` 写入 workspace `articles/`
+
 参数约定：
 
 - `url` 必填，必须是有效 `http/https` 链接
-- `saveToFile` 默认 `true`
-- 默认保存为 Markdown 到 workspace `articles/article_<timestamp>.md`
-- `savePath` 可选，支持用户自定义保存路径（**仅支持 Markdown**）：
-  - **只传目录路径**，文件名由工具自动生成（标题+时间后缀），不要自行拼接文件名
-  - 可为绝对路径或相对路径（相对路径基于 workspace）
-  - 用户未指定时，**不要擅自推断或编造路径**，直接使用默认路径
-  - 仅当用户在本轮对话中明确给出保存目录时才传入 `savePath`
+- `fetch_article_html.maxLength` 未指定时默认 `180000`
 - `returnHostPatterns` 仅在用户明确要求采集后切回原页面时使用
+- `save_article_markdown.filePath` 仅在用户明确要求自定义保存位置时使用；传完整文件路径时按该路径保存，传目录时在该目录下自动生成 `<标题>_<时间戳>.md`
 
 规则：
 
-- `get_article` 适用于所有 http/https 网页，不限于微信公众号，任何公开网页均可采集
-- 采集完成后直接告知文件保存路径，不要对内容进行分析、总结、解读或提出建议
-- **只保存 Markdown 格式**，不支持保存 HTML 或其他格式；即使用户要求保存 HTML，也说明当前只支持 Markdown
-- 导出 Markdown 时，保持原文标题层级（`#` `##` `###`），不要把正文段落套进代码块，不要用反引号包裹普通文字
+- `fetch_article_html` 适用于所有 http/https 网页，不限于微信公众号，任何公开网页均可采集
+- `fetch_article_html` 返回的是 `cleanedHtml` 和 `markdownPreview`，不直接写文件
+- 必须优先依据 `cleanedHtml` 的 HTML 结构判断正文边界，不要只看 `markdownPreview` 就直接落盘
+- `markdownPreview` 仅用于辅助阅读文本，不作为正文边界判断的唯一依据
+- `save_article_markdown` 只写最终正文 Markdown，文件头需保留标题和来源 URL
+- 必须先完成正文识别，再调用 `save_article_markdown`；不要把原始 HTML、cleanedHtml、markdownPreview、页面骨架或整页转 Markdown 后直接保存
+- 提取正文时，严格去掉导航栏、侧边栏、广告、相关推荐、评论区、页脚、弹窗文案、登录提示、打开 App 提示、分享提示、版权尾注、作者卡片、标签区、上一篇/下一篇、目录锚点、面包屑、悬浮按钮等非正文内容
+- 如果页面结构混乱或边界不清，宁可少保留，也不要把明显的非正文内容写进结果
+- 标题应优先取文章主标题；不要把站点名、栏目名、按钮文案、推广语拼进标题
+- 导出 Markdown 时，保持正常标题、段落、列表、引用、表格、代码块结构；不要把整篇正文套进代码块，不要用反引号包裹普通文字
 - 图片链接保留为 `![](url)` 格式，不要转成 HTML `<img>` 标签
-- 如果采集到的内容结构混乱，只提取正文主体部分，去掉导航栏、侧边栏、广告等干扰元素
+- 非用户要求时，不要总结、改写、缩写、润色或翻译正文；只做正文提取与格式整理
+- 采集完成后直接告知文件保存路径，不要对文章内容进行分析、总结、解读或提出建议
+
+强约束：
+
+- 默认使用 `fetch_article_html -> save_article_markdown`，不要为了省事绕过正文提取步骤
+- 在调用 `save_article_markdown` 之前，必须确认 `markdown` 字段已经是可直接落盘的最终正文，而不是待进一步处理的中间结果
 
 ## 连接排查
 

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

@@ -0,0 +1,62 @@
+---
+name: oc-browser-relay-guanghe-taobao
+description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具在淘宝光合平台发布视频。仅在用户明确提到淘宝光合发布、发光合、上传视频到光合、发布到淘宝光合或光合发布连接检查时使用。
+---
+
+# 淘宝光合发布技能
+
+## 默认工具
+
+- `guanghe_taobao_publish_video`
+
+诊断时才用：
+
+- `browser_health`
+- `browser_list_tabs`
+- `browser_list_runtimes`
+- `browser_list_tools`
+
+## 意图分流
+
+### 直接发布
+
+用户提到"发光合""发布到淘宝光合""上传到光合"等发布意图时，默认使用 `guanghe_taobao_publish_video`。
+
+必需参数：
+
+- `video`，必须是本地绝对路径
+
+可选参数：
+
+- `title`（视频标题，最多 30 字）
+- `content`（视频描述，正文与话题合计最多 1000 字）
+- `topics`（话题数组，最多 4 个，例如 `["话题1", "话题2"]`）
+
+规则：
+
+- 禁止修改、润色、缩写、扩写、改写、清洗或重排用户提供的 `title` 和 `content`
+- 用户传什么标题和正文，就原样使用什么标题和正文；不得擅自补充 emoji、标点、空格、换行、话题、前后缀或营销措辞
+- 如果用户输入的标题超过 30 字，不要擅自裁剪；应明确告知用户超出限制，需要用户自己修改后再发布
+- 如果用户输入的正文与话题合计超过 1000 字，不要擅自裁剪；应明确告知用户超出限制，需要用户自己修改后再发布
+- 话题超过 4 个时，告知用户超出限制，需要用户自己减少后再发布
+- 只要用户表达的是发布意图，就默认直接发布
+- 淘宝光合暂不支持保存草稿，只能立即发布
+- 不支持定时发布；如果用户要求定时发布，告知暂不支持，只能立即发布
+
+## 连接排查
+
+用户说"为什么发不了""帮我检查一下"时，先按连接问题处理，不当成代码调试。
+
+对外统一说：
+
+- 淘宝光合连接正常，我继续帮你处理
+- 浏览器扩展还没连上，所以现在还不能发布
+- 本地连接没起来，我先帮你检查一下
+
+## 注意事项
+
+- 淘宝光合需要先登录淘宝创作者平台（https://creator.guanghe.taobao.com）
+- 首次使用可能需要扫码登录，任务会自动等待用户完成登录
+- 视频文件必须是本地绝对路径，不支持网络 URL
+- 视频宽度和高度都必须大于等于 720 像素（低于此分辨率的视频会被平台拒绝）
+- 发布入口需要 hover "发布作品" 按钮展开下拉菜单，再点击"发视频"进入发布页，任务会自动处理

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

@@ -0,0 +1,65 @@
+---
+name: oc-browser-relay-kuaishou
+description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具发布快手视频或保存快手视频草稿。仅在用户明确提到快手发布、发快手、上传视频到快手、保存快手草稿、先别发、视频文案或快手发布连接检查时使用。
+---
+
+# 快手发布技能
+
+## 默认工具
+
+- `kuaishou_publish_video`
+- `kuaishou_save_video_draft`
+
+诊断时才用：
+
+- `browser_health`
+- `browser_list_tabs`
+- `browser_list_runtimes`
+- `browser_list_tools`
+
+## 意图分流
+
+### 直接发布
+
+用户提到"发快手""发布到快手""上传到快手"等发布意图时，默认使用 `kuaishou_publish_video`。
+
+必需参数：
+
+- `video`，必须是本地绝对路径
+
+可选参数：
+
+- `content`（作品描述，正文与话题合计最多 500 字）
+- `topics`（话题数组，最多 4 个，例如 `["话题1", "话题2"]`）
+
+规则：
+
+- 禁止修改、润色、缩写、扩写、改写、清洗或重排用户提供的 `content`
+- 用户传什么正文，就原样使用什么正文；不得擅自补充 emoji、标点、空格、换行、话题、前后缀或营销措辞
+- 如果用户输入的正文与话题合计超过 500 字，不要擅自裁剪；应明确告知用户超出限制，需要用户自己修改后再发布
+- 话题超过 4 个时，告知用户超出限制，需要用户自己减少后再发布
+- 只要用户表达的是发布意图，就默认直接发布
+- 只有用户明确提到"保存草稿""先存草稿""先别发""不要发布"时，才使用 `kuaishou_save_video_draft`
+- 连续多轮里，如果用户本轮明确要求保存草稿，不要因为上一轮提过发布就继续调用 `kuaishou_publish_video`
+- 不支持定时发布；如果用户要求定时发布，告知暂不支持，只能立即发布或保存草稿
+
+### 保存草稿
+
+用户说"先存草稿""先别发"时，使用 `kuaishou_save_video_draft`。
+
+## 连接排查
+
+用户说"为什么发不了""帮我检查一下"时，先按连接问题处理，不当成代码调试。
+
+对外统一说：
+
+- 快手连接正常，我继续帮你处理
+- 浏览器扩展还没连上，所以现在还不能发布
+- 本地连接没起来，我先帮你检查一下
+
+## 注意事项
+
+- 快手需要先登录快手创作者中心（https://cp.kuaishou.com）
+- 首次使用可能需要扫码登录，任务会自动等待用户完成登录
+- 视频文件必须是本地绝对路径，不支持网络 URL
+- 快手发布页表单在视频上传完成后才会渲染出来，任务会自动等待

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

@@ -1,6 +1,6 @@
 ---
 name: oc-browser-relay-taobao
-description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集淘宝/天猫商品详情页数据，包括商品信息、评价评论和问大家。仅在用户明确提到淘宝、天猫、tb链接、item.taobao、detail.tmall、商品链接、商品详情、评价评论、问大家、商品问答、商品导出、这个商品值不值得买或淘宝连接检查时使用；不用于小红书、抖音、抖店、生意参谋、拼多多或通用网页文章。
+description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集淘宝/天猫商品详情页数据，包括商品信息、评价评论、问大家和详情图片下载。仅在用户明确提到淘宝、天猫、tb链接、item.taobao、detail.tmall、商品链接、商品详情、评价评论、问大家、商品问答、详情图片、详情图、详情大图、商品导出、这个商品值不值得买或淘宝连接检查时使用；不用于小红书、抖音、抖店、生意参谋、拼多多或通用网页文章。
 ---
 
 # 淘宝平台技能
@@ -10,6 +10,7 @@ description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集淘
 - `taobao_collect_product_detail`
 - `taobao_collect_product_comments`
 - `taobao_collect_ask_answers`
+- `taobao_collect_detail_images`
 
 仅在以下诊断场景使用：
 
@@ -65,14 +66,16 @@ description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集淘
 
 1. 先检查用户输入里是否包含可提取的淘宝链接；如果是整段分享文案，先提取其中的淘宝链接。
 2. 如果既不是淘宝/天猫商品详情页 URL，也不是可识别的淘宝分享链接，拒绝调用工具并要求提供正确链接。
-3. 如果用户意图包含“问大家”“问答”，使用 `taobao_collect_ask_answers`
-4. 如果用户意图包含“评论”“评价”，使用 `taobao_collect_product_comments`
-5. 其余商品采集请求，默认使用 `taobao_collect_product_detail`
+3. 如果用户意图包含“详情图”“详情图片”“详情大图”“详情页图片”“下载图片”“下载详情”，使用 `taobao_collect_detail_images`
+4. 如果用户意图包含“问大家”“问答”，使用 `taobao_collect_ask_answers`
+5. 如果用户意图包含“评论”“评价”，使用 `taobao_collect_product_comments`
+6. 其余商品采集请求，默认使用 `taobao_collect_product_detail`
 
 边界词说明：
 
 - “评论”“评价”“买家反馈”“用户反馈”“买家怎么说”都按评论意图处理
 - “问大家”“问答”“别人问过什么”“有人问过尺码吗”都按问大家意图处理
+- “详情图”“详情图片”“详情大图”“产品详情图”“详情页配图”“下载详情图”都按详情图片意图处理；不要和商品主图（headImageVO）混淆
 
 ### 商品详情（不含评论）
 
@@ -141,6 +144,27 @@ description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集淘
 - 纯详情请求
 - 纯评论请求
 
+### 详情图片
+
+触发条件：
+
+- 用户明确要详情图、详情图片、详情大图、详情页配图、下载详情图
+
+参数约定：
+
+- `url` 必填，必须是淘宝或天猫商品详情页
+
+参数策略：
+
+- 该工具会自动按商品标题创建子文件夹，按顺序命名图片保存到本地
+- 工具自动过滤末尾的天猫默认责任声明图（tps 图），不要让用户额外指定
+- 不要把“详情图”理解成商品主图轮播图
+
+不处理：
+
+- 商品主图、SKU 颜色图（这些归 `taobao_collect_product_detail`）
+- 评论里的图片（评论里的图片由 `taobao_collect_product_comments` 提取，不下载）
+
 规则：
 
 - 用户明确说”只抓详情””只看详情不要评论”时，使用 `taobao_collect_product_detail`
@@ -158,6 +182,7 @@ description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具采集淘
 - `taobao_collect_product_detail` 的保存结果应是商品详情原始 JSON
 - `taobao_collect_product_comments` 的保存结果应是商品详情和评论原始 JSON
 - `taobao_collect_ask_answers` 的保存结果应是商品详情和问大家原始 JSON
+- `taobao_collect_detail_images` 的保存结果是按商品标题命名的子文件夹，下载的图片按顺序命名（001.jpg、002.png 等）；返回值里包含 `productInfo`、`savedDir`、`total`、`downloaded`、`failed`
 - 采集后在会话里可以简要概括采到了什么，但不要伪造未采到的字段
 - 如果工具返回了保存路径，可直接告知保存位置
 

package/skills/oc-browser-relay-wechat-channels/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: oc-browser-relay-wechat-channels
+description: 通过本地 ChromeAgent Relay 的 OpenClaw 插件工具发布微信视频号视频或保存微信视频号草稿。仅在用户明确提到微信视频号发布、发视频号、发微信视频、上传视频到视频号、保存视频号草稿、先别发、视频标题文案或视频号发布连接检查时使用。
+---
+
+# 微信视频号发布技能
+
+## 默认工具
+
+- `wechat_wechat_channels_publish_video`
+- `wechat_wechat_channels_save_video_draft`
+
+诊断时才用：
+
+- `browser_health`
+- `browser_list_tabs`
+- `browser_list_runtimes`
+- `browser_list_tools`
+
+## 意图分流
+
+### 直接发布
+
+用户提到"发视频号""发布到视频号""上传到微信视频号"等发布意图时，默认使用 `wechat_wechat_channels_publish_video`。
+
+必需参数：
+
+- `video`，必须是本地绝对路径
+
+可选参数：
+
+- `title`（6-16 字，仅支持中英文、数字、空格及符号 《》""''：:+?？%℃；逗号可用空格代替）
+- `content`（视频描述，正文与话题合计最多 1000 字）
+- `topics`（话题数组，最多 10 个）
+
+规则：
+
+- 禁止修改、润色、缩写、扩写、改写、清洗或重排用户提供的 `title` 和 `content`
+- 用户传什么标题和正文，就原样使用什么标题和正文；不得擅自补充 emoji、标点、空格、换行、话题、前后缀或营销措辞
+- 如果用户输入的标题超过 16 字或少于 6 字，不要擅自裁剪或补充；应明确告知用户标题需要 6-16 字，需要用户自己修改后再发布
+- 如果用户输入的标题包含不支持的特殊字符（如逗号、感叹号、@、#等），应告知用户仅支持书名号、引号、冒号、加号、问号、百分号、摄氏度符号，逗号可用空格代替 需要用户自己修改后再发布
+- 如果用户输入的正文与话题合计超过 1000 字，不要擅自裁剪；应明确告知用户超出限制，需要用户自己修改后再发布
+- 话题超过 10 个时，告知用户超出限制，需要用户自己减少后再发布
+- 只要用户表达的是发布意图，就默认直接发布
+- 只有用户明确提到"保存草稿""先存草稿""先别发""不要发布"时，才使用 `wechat_wechat_channels_save_video_draft`
+- 连续多轮里，如果用户本轮明确要求保存草稿，不要因为上一轮提过发布就继续调用 `wechat_wechat_channels_publish_video`
+- 不支持定时发布；如果用户要求定时发布，告知暂不支持，只能立即发布或保存草稿
+
+### 保存草稿
+
+用户说"先存草稿""先别发"时，使用 `wechat_wechat_channels_save_video_draft`。
+
+参数和校验规则与 `wechat_wechat_channels_publish_video` 完全一致（`video` 必填，`title` 可选且 6-16 字，`content` 可选且最多 1000 字）。
+
+与发布不同的是：
+
+- 保存草稿成功后，视频号发布页会保留打开状态，方便用户继续调整封面、话题等；不要主动提示"页面即将关闭"或等待跳转
+- 如果用户随后说"现在发吧""直接发布"，不要再重新上传视频，改用当前已打开的发布页继续 `wechat_wechat_channels_publish_video` 即可
+- 保存草稿不会跳转到发布列表，也不会出现"已发表"toast；正常完成信号是"已保存"或"保存成功"toast
+
+## 连接排查
+
+用户说"为什么发不了""帮我检查一下"时，先按连接问题处理，不当成代码调试。
+
+对外统一说：
+
+- 微信视频号连接正常，我继续帮你处理
+- 浏览器扩展还没连上，所以现在还不能发布
+- 本地连接没起来，我先帮你检查一下
+
+## 注意事项
+
+- 微信视频号需要先登录微信视频号创作者中心（https://channels.weixin.qq.com）
+- 首次使用可能需要扫码登录，任务会自动等待用户完成登录
+- 视频文件必须是本地绝对路径，不支持网络 URL