Deyo 网址

播客和视频转文字稿： https://deyo.miaobi.fun

Deyo Skill

English Version

deyo 是一个同时面向 Codex / OpenAI Agents、Claude Code 和 OpenClaw 的 skill，用来指导代理优先通过已安装的 deyo 命令行工具完成链接转写，而不是走网页界面。

它覆盖了 deyo CLI 的安装、一次性 API key 登录、本地配置检查、链接转写命令拼装、AI 可见进度同步，以及常见故障处理规则。

deyo/SKILL.md 复用同一份主说明文件，同时兼容 Codex / OpenAI Agents、Claude Code 和 OpenClaw 所使用的 skill 规范，仅 agents/ 下的元信息按平台拆分。

适用场景

在以下情况下使用这个 skill：

• 用户想安装或配置 deyo
• 用户想通过 deyo 转写一个链接
• 用户想保存一次 API key，避免后续每次重复传参
• 用户想确认 --source、--format、-O、stdout 输出、CLI 进度或 AI 对话里的进度播报行为

核心规则

• 优先使用系统里已安装的 deyo 命令
• 如果 deyo 不存在，或 deyo --help 里还没有 --progress-format，先安装或升级已发布包 @casatwy/deyo
• 生产环境默认使用 CLI 自带的服务地址 https://deyo.miaobi.fun
• 只有用户明确要求本地开发环境时，才传 --base-url http://deyo.mac-studio
• 不要虚构 API key；如果用户没有提供，要求用户先到 /me/api-keys 创建
• 用户提供 API key 后，用 deyo auth login --api-key '...' 保存到本地，方便后续复用
• 除非用户明确要求其他结果语言，否则默认追加 --language zh
• 只要是 AI 代跑且可能持续一段时间的转写任务，默认追加 --progress-format jsonl
• AI 不要把原始 JSONL 直接贴给用户，而是要把任务创建、状态切换、关键百分比和最终结果转述给用户
• 如果 task.created 表示 mode: subtitles 或 resultReady: true，要明确告诉用户这是“直接命中字母/字幕”，不会进入长时间转写

命令速查

安装 CLI：

npm install -g @casatwy/deyo

保存 API key：

deyo auth login --api-key 'deyo_sk_xxx'

检查本地登录状态：

deyo auth status

清除本地登录状态：

deyo auth logout

执行转写：

deyo [--source <name>] [--language <value>] [--format <value>] [--progress-format <value>] [-O <path>] <url>

输出规则

• 如果未传 -O，最终转写结果输出到 stdout
• 如果未传 --format，CLI 会根据输出文件后缀自动推断格式
• .txt -> text
• .srt -> srt
• .vtt -> vtt
• .json -> json
• 进度和状态信息写入 stderr
• --progress-format auto 是默认值
• 当 stderr 是 TTY 时，auto 会保留当前的单行原地刷新体验
• 当 stderr 不是 TTY 时，auto 会退化成逐行文本进度，避免输出控制字符污染日志或代理输出
• --progress-format jsonl 会在 stderr 上输出一行一个 JSON 事件，适合 AI 读取并向用户转述

推荐工作流

1. 先确认机器上是否已安装 deyo
2. 先用 deyo --help 确认本机 CLI 已支持 --progress-format
3. 确认目标链接、输出格式和输出路径
4. 如果本地尚未登录，向用户索取 API key 并执行 deyo auth login
5. 仅在需要时区分生产环境或本地开发环境
6. 除非用户明确指定其他语言，否则追加 --language zh
7. 仅在强制指定平台有帮助时才加 --source
8. AI 代跑长任务时追加 --progress-format jsonl
9. 运行最终命令，并把任务创建、状态切换、关键百分比与最终结果同步给用户

示例

安装已发布的 CLI：

npm install -g @casatwy/deyo

保存 API key：

deyo auth login --api-key 'deyo_sk_xxx'

输出中文文本文件：

deyo --language zh -O ./tmp/transcript.txt 'https://www.youtube.com/watch?v=xxxx'

AI 友好的结构化进度模式：

deyo --language zh --progress-format jsonl -O ./tmp/transcript.txt 'https://www.youtube.com/watch?v=xxxx'

强制使用 YouTube 源并导出 SRT：

deyo --language zh --source youtube --format srt -O ./tmp/out.srt 'https://youtu.be/xxxx'

直接从 stdout 读取 JSON：

deyo --language zh --format json 'https://www.bilibili.com/video/BVxxxx'

故障排查

• deyo: command not found：先安装 @casatwy/deyo
• 缺少 API key。请传 --api-key、设置 DEYO_API_KEY，或先执行 deyo auth login：让用户先在 /me/api-keys 创建 key，再执行 deyo auth login
• API key 无效或不存在：要求用户重新生成有效 key
• 剩余分钟不足：当前账号分钟余额不足
• 如果用户反馈没有进度更新，先确认 deyo --help 是否已经包含 --progress-format；如果没有，先升级 CLI
• 如果任务创建后很快结束，优先判断是否是直接返回字幕的场景，而不是长时间转写链路
• 如果中途丢失实时进度，留意 CLI 是否输出了“事件流中断，回退到轮询状态”的提示

在 Claude Code 中使用

Claude Code 会从 ~/.claude/skills/<name>/SKILL.md 加载 skill，本仓库的 deyo/SKILL.md 已符合该规范，安装方式有两种：

用户级（全机可用）：

mkdir -p ~/.claude/skills
ln -snf "$(pwd)/deyo" ~/.claude/skills/deyo

项目级（只在当前仓库可用）：

mkdir -p .claude/skills
ln -snf "$(realpath ./deyo)" .claude/skills/deyo

安装完成后，Claude Code 会在匹配场景中自动建议调用，也可以显式触发：

/deyo 帮我把这个 YouTube 链接转成中文 SRT

Claude 侧的元信息（display name、默认提示词等）记录在 deyo/agents/claude.yaml，与 openai.yaml 平行，互不影响。

在 Codex / OpenAI Agents 中使用

参考 deyo/agents/openai.yaml，按 Codex / OpenAI Agents 的 skill 注册流程加载 deyo/SKILL.md 即可。

在 OpenClaw / ClawHub 中使用

如果你已经在使用 OpenClaw，推荐优先用它自带的 openclaw skills 命令从 ClawHub 安装 deyo。ClawHub 是 OpenClaw 的公开 skill 注册表；如果你只想单独搜索或备用安装，也可以直接使用 clawhub CLI。

先确保机器上已经有 deyo 命令：

npm install -g @casatwy/deyo

推荐方式：在当前 workspace 安装 skill：

openclaw skills search "deyo"
openclaw skills install deyo

安装后，执行一次 API key 登录：

deyo auth login --api-key 'deyo_sk_xxx'

后续更新所有已安装 skills：

openclaw skills update --all

如果你更偏向单独使用 ClawHub CLI，也可以这样做：

npm install -g clawhub

clawhub search "deyo"
clawhub install deyo

安装完成后，就可以在 OpenClaw 对话里直接提需求，例如：

用 deyo 把这个 YouTube 链接转成中文 SRT

在 Gemini CLI 中使用

Gemini CLI 原生支持读取包含 frontmatter 的 SKILL.md。可以通过以下命令安装：

用户级（全机可用）：

gemini skills install "$(pwd)/deyo" --scope user

项目级（只在当前仓库可用）：

gemini skills install "$(realpath ./deyo)" --scope workspace

安装后，请在 Gemini 交互式会话中执行 /skills reload 使其生效。相关说明记录在 deyo/agents/gemini.yaml。

目录结构

skill_/
├── README.md
├── README.en.md
└── deyo/
    ├── SKILL.md
    └── agents/
        ├── openai.yaml
        ├── claude.yaml
        └── gemini.yaml

相关文件

• deyo/SKILL.md：skill 的主说明文件，定义适用场景、规则和示例（同时兼容 Codex、Claude Code、OpenClaw 与 Gemini CLI）
• deyo/agents/openai.yaml：OpenAI Agents 侧的显示名、简述和默认提示词配置
• deyo/agents/claude.yaml：Claude Code 侧的显示名、安装路径与触发方式说明
• deyo/agents/gemini.yaml：Gemini CLI 侧的安装说明及相关元信息说明