为什么要装
WorkBuddy 本身强在「动手干活」，但联网检索这块，中文信源的召回一直是个痛点。腾讯云出的「元宝搜索」（WSA · SearchPro）正好补上这一环：全网公开资源 + 腾讯内容生态（新闻、公众号、视频号），中文 query 的召回明显比纯英文引擎好，还支持时间范围、站点定向、实时行情等垂直信源。
社区里有个零依赖的 Skill yuanbao-websearch（只用 Python 标准库，不用 pip install），几步就能接上。下面是我配通的全过程。
一、准备工作
- 已在电脑上装好 WorkBuddy（桌面端）
- 已安装 Python 3（系统自带即可，无需额外依赖）
- 一个腾讯云账号
二、全流程四步
第 1 步：去控制台拿 API KEY
打开腾讯云「元宝搜索控制台」（console.cloud.tencent.com/wsapi/index），开通服务，创建一个「服务 API KEY」。有免费额度，先用着不心疼。
第 2 步：把 Skill 装进 WorkBuddy
克隆仓库，再复制到 WorkBuddy 的 skills 目录：
git clone https://github.com/kk-495/yuanbao-websearch.git
cp -r yuanbao-websearch ~/.workbuddy-ai/skills/
国内访问 GitHub 慢，可换 Gitee 镜像：
git clone https://gitee.com/kk_495/yuanbao-websearch.git
第 3 步：配置密钥
**省事的方式是设环境变量：
export TENCENTCLOUD_WSA_APIKEY="sk-你的密钥"
Windows（PowerShell）：
[Environment]::SetEnvironmentVariable("TENCENTCLOUD_WSA_APIKEY","sk-你的密钥","User")
也可以把密钥写进 ~/.config/yuanbao-search/key，工具会自动读。注意：密钥走三级回退（参数 > 环境变量 > 配置文件），别把 sk- 开头的串提交到仓库。
第 4 步：自检
python3 scripts/yuanbao_search.py --doctor
看到 结论：一切正常 就说明密钥和连通都没问题，装好了。
三、怎么用
装好后直接在对话里让 WorkBuddy「搜一下」就会自动调用。也可以在命令行手动跑：
# 基础检索
python3 scripts/yuanbao_search.py --query "三星堆的由来"
# **近三天，20 条
python3 scripts/yuanbao_search.py --query "英伟达财报" --cnt 20 --freshness d3
# 实时行情（混合模式）
python3 scripts/yuanbao_search.py --query "贵州茅台股价" --mode 2 --industry finance
# 只搜知乎 / 排除内容农场
python3 scripts/yuanbao_search.py --query "长上下文模型评测" --site zhihu.com
# 指定日期区间 + 输出 JSON 给程序读
python3 scripts/yuanbao_search.py --query "中央经济工作会议" --freshness 2026-10-01,2026-10-23 --format json --out result.json
几个好用的点：
- --freshness d3/m3/y2 控制时效，做资讯类任务超好用
| | |
| --- | --- |
- --site zhihu.com 或 --site exclude:a.com|b.com 精准定向 / 排除
- --mode 2 能拿股价、金价、汇率、天气的结构化卡片
四、踩坑提醒
- 计费按调用次数，免费额度用完会收费，批量任务记得控量。
- 搜索结果是「候选」不是「结论」，重要事实至少两个独立来源交叉验证。
- 接口参数以腾讯云官方文档为准，可能变动。
装完之后，WorkBuddy 查资料这件事基本就「闭环」了：你只管提需求，它自己判断什么时候该联网搜、搜完还能接着干。有问题的评论区见。
链接：https://pan.quark.cn/s/f036579950ed
