播客订阅源管理技能

使用该技能可在 agent sandbox 中管理 huisheng.fm 的播客订阅源（Podcast Feed）。此技能直接调用用户作用域的 REST API，而非通过 MCP 端点调用。

入口点

相对于已安装技能的根目录解析可执行文件：

./scripts/run_huisheng.sh --help

./scripts/run_huisheng.sh 是本技能包中唯一的可执行脚本。它自包含，直接使用 curl 调用固定的 REST API。请勿硬编码路径如 /mnt/skills/ 或 ~/.codex/...。

在修改 API 相关逻辑前，请先运行：

./scripts/run_huisheng.sh doctor

诊断 API 故障前请务必先运行 doctor。若输出中显示 hasCurl: false，表示 sandbox 无法发起 HTTP 请求；若显示 hasToken: false，表示命令执行环境中未提供 HUISHENG_API_TOKEN 环境变量。

当 agent 运行时在独立的 sandbox 工作目录中执行命令时，请将 scripts/run_huisheng.sh 复制到该 sandbox 内，并从复制后的位置运行。该脚本不依赖任何同级文件。

认证

sandbox 必须提供以下环境变量：

HUISHENG_API_TOKEN

每次 API 请求均携带以下请求头：

Authorization: Bearer 

切勿在面向用户的输出中打印完整的 token。

固定 API 地址

API URL 固定，无需用户配置：

https://huisheng.fm/api

常用命令

列出所有订阅源：

./scripts/run_huisheng.sh list-feeds

创建一个订阅源：

./scripts/run_huisheng.sh create-feed --json '{"title":"Daily Brief","siteUrl":"https://example.com"}'

列出指定订阅源下的所有节目（episodes）：

./scripts/run_huisheng.sh list-episodes 

为指定订阅源创建一个节目：

./scripts/run_huisheng.sh create-episode  --json-file ./episode-payload.json

操作规则

• 必须依赖 HUISHENG_API_TOKEN；不得自行定义备用 token 变量名。
• 不得向用户索取 API URL；统一使用 https://huisheng.fm/api。
• 所有操作均视为用户作用域。一个 token 仅能访问经认证的仪表盘用户所拥有的 Podcast Feed。
• JSON 参数应保持结构化 JSON 格式。对于较长的 episode 数据载荷，请使用 --json-file 参数指定文件。
• 若指定的 feed 未找到，应优先执行 list-feeds 查看可用列表，而非假定 feed 具有全局可见性。

参考文档

仅当需要查阅端点列表时，请阅读 references/api.md。