鲸创 AgentHub

一、技能包简介

Web 工具策略（web-tools-guide） 是面向 WorkBuddy 的智能体上网能力增强技能。它让 AI 在「搜索信息 / 抓取网页 / 访问网站 / 处理热点新闻」等场景下，按最优策略自动选择工具，并在工具失败时按既定链路优雅降级，全程向用户透明说明。

核心能力

场景	首选工具	说明
没有网址，需要搜索	web_search	新闻、热点、查资料、比较信息
有网址，静态内容	web_fetch	文章、博客、技术文档、API、RSS
上述失败 / 需要结构化数据	opencli	CLI 直连 70+ 主流网站，秒级返回
全都不行（JS 渲染/登录/截图）	browser	浏览器自动化，最后兜底

包内文件清单

web-tools-guide-skill/
├── 用户教程.md                     ← 本文件
├── 安装脚本.bat                   ← Windows 一键安装
├── 安装脚本.sh                    ← macOS / Linux 一键安装
└── skills/
    └── web-tools-guide/
        ├── SKILL.md               ← 技能主文档（含完整决策流程）
        ├── references/
        │   ├── opencli-guide.md   ← opencli 使用指引
        │   ├── web-search-config.md  ← 搜索 API 配置流程
        │   └── well-known-sites.json ← 常用网站地址索引
        └── scripts/
            └── setup-opencli.sh   ← opencli 环境自动安装脚本

二、安装步骤（三步完成）

第 1 步：解压

将压缩包解压到任意目录（建议路径中不要包含中文和空格）。

第 2 步：导入技能到 WorkBuddy

方式 A：一键安装（推荐）

Windows：双击运行 安装脚本.bat
macOS / Linux：在终端执行 bash 安装脚本.sh

脚本会自动把 skills/web-tools-guide 目录复制到 WorkBuddy 的用户技能目录（~/.workbuddy/skills/）下，完成后重启 WorkBuddy 即可。

方式 B：手动导入

打开 WorkBuddy 的技能管理界面（左侧菜单「技能」或设置中的技能入口）；
选择「导入技能 / 从文件夹导入」；
选中本包内的 skills/web-tools-guide 文件夹；
按界面提示完成导入，重启 WorkBuddy。

说明：本技能属于「用户级技能」，导入后对所有项目生效；如需仅在当前项目生效，将 web-tools-guide 文件夹放入该项目的 .workbuddy/skills/ 目录即可。

第 3 步：验证安装

重启 WorkBuddy 后，向 AI 发送任意上网类指令，例如：

帮我查一下今天的微博热搜

如果 AI 能正确响应并开始检索，说明技能已生效。也可以在对话中直接问「你现在有没有加载 web-tools-guide 技能」。

三、环境自动配置说明

本技能包内置了环境自动配置机制，WorkBuddy 会根据技能文档自动完成相关环境安装，用户基本无需干预：

1. opencli 环境（自动安装）

opencli 是技能链路中的关键 CLI 工具（覆盖 70+ 主流网站）。首次使用前，AI 会检测本机是否已安装 opencli：

未安装：AI 会自动运行 skills/web-tools-guide/scripts/setup-opencli.sh 完成安装（CLI 安装 + 浏览器桥接插件下载 + 浏览器加载），全程幂等可重复执行；
已安装：直接跳过。

若你希望提前手动安装，可自行在终端执行：
bash skills/web-tools-guide/scripts/setup-opencli.sh

2. 搜索服务 API（按需配置）

web_search 功能需要配置一个搜索服务的 API Key（二选一，均可）：

提供商	官网	Key 前缀	特点
Tavily	https://app.tavily.com	`tvly-`	国际内容效果好，每月 1000 次免费
Kimi / Moonshot	https://platform.moonshot.cn	`sk-`	中文内容效果佳

配置方式：当 AI 第一次执行搜索且未检测到 Key 时，会主动向你展示配置引导。你只需提供 API Key（回复如 tvly-xxxx 或 sk-xxxx），AI 会按 references/web-search-config.md 中的流程自动完成配置与验证。

如果你暂时不想配置，可回复「暂不配置」，AI 会自动切换到备选方案（web_fetch 直取 + 浏览器），功能仍然可用，只是体验稍弱。

3. 浏览器能力（按需）

涉及登录、JS 渲染页面、截图时，AI 会使用浏览器自动化。登录操作会先征求你的授权，敏感操作（发帖、删除、支付）会二次确认，请放心使用。

四、使用指南

常见触发场景

搜索类：帮我查一下 XX、XX 的最新新闻、今天有什么热点
抓取类：打开这个网址看看、这篇文章讲了什么
榜单类：看看微博热搜 / 知乎热榜 / B站热门
数据类：查一下 XX 网站的资料

工具选择透明化

AI 在切换工具时会明确告知原因，例如：

「搜索结果返回的页面被反爬拦截，我改用命令行直连方式获取结构化数据。」

降级链路

所有工具均失败时，AI 会如实说明原因并给出替代建议，不会静默降级或伪造结果。

五、常见问题（FAQ）

Q1：安装脚本提示权限不足？ macOS/Linux 下请先执行 chmod +x 安装脚本.sh，或用 bash 安装脚本.sh 方式运行；Windows 下右键「以管理员身份运行」。

Q2：导入后技能没生效？ 请确认导入目录结构正确（需包含 SKILL.md），并重启 WorkBuddy。也可手动检查 ~/.workbuddy/skills/web-tools-guide/SKILL.md 是否存在。

Q3：opencli 安装失败？ 多为网络问题（脚本需从 GitHub 下载插件）。请检查网络后重试；脚本幂等，重复执行安全。

Q4：不想用 opencli / 浏览器，只用搜索和抓取可以吗？ 可以。技能链路的降级逻辑完全兼容：web_search / web_fetch 始终可用，opencli 与 browser 仅在需要时启用。

Q5：API Key 安全吗？ API Key 仅保存在你本机的配置中，用于调用搜索服务，不会上传到任何第三方服务器。

六、技术支持

本技能包由我司提供技术支持。如遇问题，请联系技术支持团队并提供以下信息：WorkBuddy 版本、操作系统版本、报错截图。

灵犀网络

产品介绍