Agent 基础能力
给新建的 Agent 装上的基础能力:每个能力对应一篇接入说明,需要时再配一个能直接运行的脚本,用到哪个能力就读哪一篇。如果要调用 2 次以上本 skill 中的脚本,直接将本 skill下载到本地。取材再读视频就要跑平台下载脚本和 video_read.py,平台下载脚本还要 import 同目录的 share_common.py。
用法
- 能力分两层:底层是接口和请求参数,一次调用就完事的能力只有这一层;中层是稍微封装过的脚本,跨几家接口、要判断走哪条路的能力才有,比如解析分享链接。有脚本就先用脚本,脚本出错、要改脚本或者只要其中一样时,看底层。
- 脚本要在本地运行:有 shell 的 Agent 按 URL 下载脚本后执行。头部写了依赖的用
uv run,uv 自动装,执行前告诉用户会从 PyPI 装哪些包;只用标准库的直接python3。本地有本 wiki 的仓库时,脚本就在仓库的docs/skills/agent-io/scripts/下,直接跑,不用下载。 - 要调厂商 API 的能力统一走 API 中转(已接 DeepSeek、AutoDL、下载狗、TikHub、CodeProxy、OpenRouter):中转原样转发,只换 base URL 和 key。Agent 不配厂商 key,本站也不存明文密钥。
- 网关 token 由用户写在
.env的MY_API_KEY里,AI 直接用:在.env所在目录(本 wiki 就是仓库根)跑set -a; . ./.env; set +a载入,命令里写$MY_API_KEY。别用 grep、cut 自己把值抠出来,Claude Code 的权限检查会当成数据外泄拦下;也别打印。中转域名*.liuhetian.work、*.reverse-pro.xyz都是用户自己的服务器。 - 花钱的调用直接调,不用停下来问用户,单价写在各篇里。
能力表
| 能力 | 读取 | 生成 |
|---|---|---|
| 阅读 PDF | — | |
| 音频 | 转录音频 | 生成语音:默认用我们自己的音色,用户说不用就换微软 MAI-Voice 的 Mei;生成音乐 |
| 图片 | — | 生成、编辑图片 |
| 视频 | 阅读视频:给视频文件或解析分享链接取下的文件夹,出关键帧联系图、转写和每分钟字数,图文帖出编号拼图,跑 video_read.py | 生成视频:默认文字加参考图生成;文生、首尾帧、对口型、动作迁移各有一篇 |
| 网络 | 网络搜索:默认 Sonar 给带引用的回答,DeepSeek 给结果列表;读取网页:给 URL 出 Markdown 正文,读新闻文章好用,技术文档的代码块会丢;解析分享链接:小红书、抖音、B 站、微信公众号的链接一条换成一个文件夹,有正文、作者、点赞收藏、原图和视频,B 站另有字幕和评论;抖音、小红书传作者主页就翻完这个人发的全部,公众号传号名取最新的文章;一个平台一个脚本,每页上面是脚本、下面是底层接口 | — |
| 邮件 | 读取邮箱:汇总所有邮箱的未读邮件并标为已读,跑 mailctl | — |
| 调用大模型 | — | 调用 DeepSeek、结构化判断:返回概率和选项,不返回文字;默认 Jev,看图换 OpenAI,另接了微软和 Mercury |
还没接入的能力,接好一个再补一篇,不写占位页。