喜马拉雅助手

1 鉴权说明

助手需要 appid 和 secret 才能连接远程工作流服务。两种提供方式：

1. 命令行参数：--appid --secret <密钥>
2. 环境变量：export XIMALAYA_APPID=xxx XIMALAYA_SECRET=xxx

两者都未提供时，脚本直接报错退出并提示用法。

关于测试账号

试用可直接用下面的公共测试账号（无需自己申请）： --appid "alex-daily"
--secret "624adc2a4524373d6ad75bff58aadd59bfd4862f7486b263e7626227ddf65960"

⚠️ 注意：该测试账号为多人共用，配额限制为每天 10 次（自然日 UTC+8 零点重置）。超量会返回 429，请省着点用。

2. 概览

2.1 核心文件：

• scripts/AgentBrowserController.js — 浏览器自动化控制器类，封装 agent-browser CLI 的所有操作
• scripts/upload.js — 上传发布入口脚本：解析命令行参数 → 启动浏览器 → 拉取工作流 → 执行上传流程
• scripts/workflow-runner.js — 工作流执行引擎：从远程拉取声明式 JSON 工作流，逐条映射到 AgentBrowserController 的方法并执行

2.2 前置依赖

1. agent-browser CLI — 已安装并可在命令行执行 agent-browser 命令。如未安装，先加载 agent-browser-core 技能。
2. Node.js 18+ — 需要 util.parseArgs 支持（Node 18.3+ 内置）。
3. 浏览器 — Playwright Chromium 或系统 Edge，脚本会自动查找并启动带 --remote-debugging-port=9222 的实例。
4. 喜马拉雅登录态 — 首次使用需手动在浏览器中扫码登录，登录后脚本使用 .browser-data 目录保持会话。推荐传入 --browser-data 指定工作空间下的共享目录，避免重复登录。

3. 上传发布

3.1 命令行用法

node scripts/upload.js <专辑名> <音频文件路径> [options]

必选位置参数：

可选 options：

3.2 使用示例

node scripts/upload.js "长城内外的故事" "D:/audio/ep01.mp3" 
  --title "第一集：山海关" 
  --desc "从山海关讲起，追溯长城防御体系的起源" 
  --imagePath "D:/audio/cover01.jpg" 
  --tags "历史,长城,故事" 
  --topic "长城" 
  --discussion "长城防御体系是智慧还是劳民伤财？" 
  --ai 
  --schedule "2026-07-12 18:01" 
  --private 
  --browser-data "D:/资料/claw/世界杯人物记/.browser-data" 
  --appid "alex-daily" --secret "your-secret-here"

3.3 执行流程

upload.js 执行以下步骤：

1. 启动浏览器（CDP connect 到 Playwright Chromium）
2. 打开喜马拉雅上传页面
3. 上传音频文件
4. 选择专辑（搜索专辑名 → 点击匹配结果）
5. 填充标题（--title）
6. 上传封面图片（--imagePath，如提供）
7. 填充节目简介（KindEditor iframe：frame 切入 → fill body → finally 切回）
8. 滚动到页面底部
9. 填充标签（逗号分隔逐个输入 + Enter）
10. 添加话题（如提供）/ 填充讨论（如提供）
11. 勾选AI生成（--ai，如提供）
12. 设置定时发布（--schedule，如提供）
13. 点击"确认发布"按钮

3.4 在 WorkBuddy 中使用

当用户说"帮我上传音频到喜马拉雅"时：

1. 确认必选信息：专辑名、音频文件路径。如缺少，用 AskUserQuestion 询问。
2. 可选信息（标题、简介、封面图片、标签、话题、讨论、私有、AI生成、定时发布）：如用户提供则带上，否则使用默认值。
3. 将 scripts/ 下全部文件（upload.js、workflow-runner.js、AgentBrowserController.js）复制到用户工作目录（或直接在 skill 目录下运行）。
4. 推荐：传入 --browser-data 指向工作空间下的 .browser-data 目录，共用登录态。
5. 执行命令：node scripts/upload.js "<专辑名>" "<文件路径>" [options]
6. 脚本输出步骤进度，完成后返回 { success: true } 或 { success: false, error: "..." }。
7. 如失败，根据错误信息排查（参见 references/ 文档）。

4. AgentBrowserController API 速查

上传脚本之外，如需编写自定义流程（编辑、删除等），可导入 AgentBrowserController 类：

import AgentBrowserController from './AgentBrowserController.js';

const controller = new AgentBrowserController({
  sessionId: 'default',
  debug: true,
  cdpPort: 9222,
  // userDataDir: '自定义浏览器数据目录'  // 默认 ./.browser-data
});

await controller.launchBrowser();
await controller.navigate('https://www.ximalaya.com/...');
const snapshot = await controller.getSnapshot();
await controller.click('input[placeholder*="标题"]');
await controller.fill('input[placeholder*="标题"]', '标题文本');
await controller.fillKindEditor('#iframe_id', '简介内容');
await controller.type('input[placeholder*="回车"]', '标签');
await controller.press('Enter');
await controller.uploadFile('D:/audio/ep01.mp3');
await controller.eval('document.title');
await controller.switchToFrame('#iframe_id');  // 或 'main' 切回
await controller.scrollToBottom();
await controller.screenshot('/output/screenshot.png');
await controller.findAndClick(snapshot, '确认发布', { exact: false, role: 'button' });
await controller.closeBrowser();

关键方法说明：