第零篇：Skill 安装与导入
从 GitHub 获取 Skill，一键导入到 WorkBuddy
1 从 GitHub 克隆仓库
本 Skill 托管在 GitHub 上，先克隆到本地：
git clone git@github.com:Viennacacao/Cloudlearning-assistant-skill.git2 导入到 WorkBuddy
打开 WorkBuddy
启动客户端应用
进入 Skills 管理
设置 → Skills / 技能管理
选择目录导入
选刚克隆的文件夹
~/.workbuddy/skills/cloud-video-learning/
3 导入后的文件结构
cloud-video-learning/
├── SKILL.md ← Skill 核心定义（Agent 读取）
├── README.md ← 完整文档
├── scripts/
│ ├── 21tb-login-crawler.js ← 主脚本：登录+课表+播放注入
│ ├── 21tb-course-launcher.js ← 辅助脚本：按名称/编号启动课程
│ ├── 21tb-player-embed.js ← 播放助手自动注入器
│ ├── 21tb-status-reporter.js ← 状态上报器
│ └── package.json ← Node.js 依赖
├── runtime-logs/ ← 运行日志（自动生成）
├── course-data.json ← 课表缓存（自动生成）
└── 21tb-video-helper.user.js ← 播放助手源码Agent 对话激活（最推荐 👑）
不用记命令！用自然语言跟 Agent 说就行
触发语句一览表
| 你说的话 | Agent 会做的事 |
|---|---|
| 「帮我登录 21tb 学习平台」 | 自动登录时光易学平台并展示课表 |
| 「帮我刷课」/「自动学习」 | 登录 + 启动第一门未完成课程的自动播放 |
| 「看看哪些课没学完」 | 登录 → 获取课表 → 列出所有未完成的课程 |
| 「帮我把《创新方法》学了」 | 按课程名直达该课页面并启动 16x 自动播放 |
| 「把所有课全部自动学完」 | 使用 --auto --auto-advance 连续刷完全部未完成课程 |
| 「学完了没有？/ 检查进度」 | 读取运行时日志，汇报当前播放进度和完成状态 |
| 提到「云端视频学习」「21tb」「时光易学」 | 均会激活本 Skill |
对话演示（实际使用效果）
你
帮我登录 21tb 时光易学平台，看看有哪些课没学完
Agent
正在登录 21tb 时光易学平台...
登录成功！企业：lscb 用户：006627
已获取完整课表（共 54 门）
📋 未完成课程列表（14 门）
你
帮我开始学第一门
Agent
正在打开课程：《创新方法：组合创新与交叉创新》
内置播放助手已注入（16x 倍速，自动启动=是）
🎬 课程正在自动学习中... 请保持浏览器打开。
你
（过一会儿）学完了没有？
Agent
📊 当前状态
核心优势
你完全不需要记命令、不需要开终端、不需要知道参数格式。只需要用自然语言告诉 Agent 你想做什么，它会自动读取 SKILL.md 配置、调用对应脚本、处理所有底层细节，然后把结果用人话告诉你。
第一篇：环境安装
简单几步，为工具运行准备环境
1 前置条件检查
这个工具需要 Node.js 环境。别被名字吓到，它就是一个让你能在终端运行 JavaScript 程序的东西。
检查是否已装 Node.js
打开终端（Terminal），输入以下命令并回车：
node -v如果看到版本号（如 v18.x.x），说明已经装好了！
提示 "command not found"，请继续第 2 步。
2 安装 Node.js
推荐使用 Homebrew（Mac 上最方便的包管理器）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"装好 Homebrew 后，运行以下命令安装 Node.js：
brew install node3 安装工具依赖
进入工具的脚本目录，安装 Puppeteer（浏览器自动化引擎）：
cd ~/.workbuddy/skills/cloud-video-learning/scripts
npm install puppeteer第二篇：快速上手
5 分钟跑通第一个命令
📝 你需要准备的信息
| 参数 | 含义 | 示例 |
|---|---|---|
| -e | 企业ID (Organization ID) | lscb |
| -u | 用户名 (Username) | 012345 |
| -p | 密码 (Password) | ****** |
场景一：一键全自动学习
这是最省事的模式——一条命令搞定所有事情，包括登录、选课、倍速播放和评估。
node scripts/21tb-login-crawler.js -e lscb -u 012345 -p 你的密码 --auto自动切换账号密码登录
自动进入课程中心
自动以 16 倍速播放
完成后自动提交评估
🎯 场景二：指定学习某门课
支持关键词模糊匹配，非常方便：
node scripts/21tb-login-crawler.js -e lscb -u 012345 -p 密码 -c "创新方法"第三篇：进阶玩法
让工具自动刷完所有课程
自动推进模式
工具将一门接一门地自动完成所有未完成课程，真正实现「躺平式」学习。
node scripts/21tb-login-crawler.js -e lscb -u 012345 -p 密码 --auto --auto-advance配合 --json 参数
如果你想将工具集成到其他程序或由 AI Agent 调用，可以使用结构化输出：
{
"type": "course_complete",
"timestamp": "2026-04-08T07:11:30.000Z",
"courseTitle": "文案写作的2W1H模型"
}第四篇：进度与日志
随时掌握学习动态
日志存放位置
所有运行记录均保存在以下目录：
查看当前状态
使用以下命令快速查看最新进度：
cat *.state.json | tail -1第五篇：常见问题
遇到问题？别担心，这里有答案
Q1 登录失败或提示「账号密码错误」？
请仔细检查 -p 参数中的密码是否包含特殊字符。如果包含特殊字符，请用英文引号将密码包裹起来。同时，请确认在浏览器中手动登录是否正常。
Q3 可以后台运行吗？
可以！添加 --headless 参数即可隐藏浏览器窗口。这非常适合在服务器上或者您不想被打扰时使用。
附录：参数速查表
完整的命令行参数说明
| 参数 | 用途 |
|---|---|
| -e, --enterprise | 企业ID |
| -u, --username | 用户名 |
| -p, --password | 密码 |
| -c, --course | 指定课程名（支持模糊匹配） |
| --auto | 自动学习第一门未完成的课程 |
| --auto-advance | 完成后自动开始下一门课程 |
| --headless | 隐藏浏览器窗口 |
| --json | 输出结构化 JSON 数据 |
文档版本：v1.0 | 最后更新：2026-04-08
Designed for high-efficiency learning experience.