CLI
适合批量脚本、本地自动化和服务端调用。安装 `@casatwy/deyo` 后，通过 `deyo auth login` 保存 API key 即可发起转写。
开发者与 AI 工作流
Deyo CLI、API key 与 AI 安装文档
如果你不想每次都在网页里粘贴链接，可以把 Deyo 接到终端、脚本、Codex、Claude 或 OpenClaw，让同一套转写能力直接进入自己的工作流。
CLI 适合终端、脚本和服务端调用API key 创建后可本地保存并长期复用Codex、Claude、OpenClaw 都有官方安装入口
选择使用方式
CLI 更适合你自己在终端里跑命令；Skill 更适合直接把安装 URL 和需求交给 Codex 或 Claude；OpenClaw 更适合在自己的 workspace 里安装和管理 skill。
CLI
CLI 的安装与使用
安装 deyo
先选择一个你常用的包管理器安装 deyo，安装完成后执行一次 deyo --help 确认命令可用。
npm install -g @casatwy/deyo
deyo --helppnpm add -g @casatwy/deyo
deyo --helpyarn global add @casatwy/deyo
deyo --helpbun install --global @casatwy/deyo
deyo --helpdeno install --global --compile -A --name deyo npm:@casatwy/deyo
deyo --help获取 API Key
登录后进入 /me/api-keys 页面，先输入一个用途名称，例如“本地 CLI”，再点击“创建 API key”。创建成功后，完整 key 只会展示这一次，请立即复制，下一步直接保存到本地。
首次保存 API Key
创建完 API key 后，只需要执行一次下面这条命令。之后 CLI 会优先复用本地配置，不需要每次重复传 --api-key。
deyo auth login --api-key "deyo_sk_xxx"常见用法
保存过 API key 后，最常见的命令就是下面三条。
deyo --language zh -O ./out.txt "https://www.youtube.com/watch?v=xxxx"
deyo --language zh --format srt -O ./out.srt "https://www.bilibili.com/video/BVxxxx"
deyo --language en "https://www.youtube.com/watch?v=xxxx"常用参数与命令
deyo auth login- 把 API key 保存到本地，推荐作为首次配置命令。
deyo auth status- 查看当前 API key 和服务地址来源，不会回显完整 key。
--api-key- 可选。临时覆盖本地配置或环境变量时再传。
-O/--output- 指定输出文件；不传时结果会直接打印到终端。
--language- 常用值：中文
zh，英文en。不传时默认是zh。 --format- 支持
text、srt、vtt、json、verbose_json。 --source- 支持
xiaoyuzhou、ximalaya、bilibili、douyin、xiaohongshu、youtube、apple-podcasts、twitter。 DEYO_API_KEY- 如果你更偏向环境变量，也可以把 key 放到这里，CLI 会自动读取。
Skill
AI skill 的安装与使用
deyo skill 的作用，是让 Codex 或 Claude 直接帮你调用 Deyo CLI 完成转写。推荐方式不是手工翻设置，而是把安装入口或官方说明直接交给 AI。
适合什么场景
如果你更习惯直接对 AI 说需求，而不是自己在终端里敲命令，skill 会更省事。你只需要把安装入口、目标链接、输出格式和语言要求告诉 AI，它就可以帮你完成整条链路。
一句话交给 AI 安装 Deyo Skill
请按 https://deyo.miaobi.fun/ai/install/codex 的官方说明为我安装 deyo skill。安装后怎么说
用 deyo 把这个 B 站链接转成中文文字稿，输出到 ./tmp/out.txt
用 deyo 把这个 YouTube 链接转成英文文字稿，并导出成 srt 字幕官方安装 URL
https://deyo.miaobi.fun/ai/install/codex如果 AI 需要 skill 源地址
Codex 安装页会优先让 AI 使用 Deyo 官方说明；如果它需要进一步拉取 skill 本体，可以使用下面这个 Git 地址。
https://github.com/casatwy/deyo-skill.git一句话交给 AI 安装 Deyo Skill
请按 https://deyo.miaobi.fun/ai/install/claude 的官方说明为我安装 deyo plugin。安装后怎么说
用 deyo 把这个 B 站链接转成中文文字稿，输出到 ./tmp/out.txt
用 deyo 把这个 YouTube 链接转成英文文字稿，并导出成 srt 字幕官方 marketplace URL
https://deyo.miaobi.fun/ai/install/claude/marketplace.json手工命令备用
npm install -g @casatwy/deyo
claude plugin marketplace add https://deyo.miaobi.fun/ai/install/claude/marketplace.json
claude plugin install deyo@deyo-official 如果 claude plugin install 失败，请把原始错误交给 Claude 让它停下来告诉你，不要自行修改全局 git / SSH / npm 配置。
配套说明页
https://deyo.miaobi.fun/ai/install/claude常见问题
Q：`claude plugin install` 报权限错误？
把原始错误反馈给 Claude，让它停下来告知你；不要自行修改全局 git / SSH / npm 配置，也不要手动绕行下载。
Q：如何换一个新的 API key？
先执行 `deyo auth logout`，再执行 `deyo auth login --api-key '<new-key>'`。
Q：如何检查 deyo 是否已安装？
执行 `command -v deyo` 或 `deyo --version`（`@casatwy/deyo >= 0.1.2` 开始支持）。
OpenClaw
OpenClaw 的安装入口
一句话交给 AI 安装 Deyo Skill
请按 https://deyo.miaobi.fun/ai/install/openclaw 的官方说明，在当前 workspace 里为我安装 deyo skill。安装后怎么说
用 deyo 把这个 B 站链接转成中文文字稿，输出到 ./tmp/out.txt
用 deyo 把这个 YouTube 链接转成英文文字稿，并导出成 srt 字幕官方安装 URL
https://deyo.miaobi.fun/ai/install/openclawAI 安装页
Codex、Claude、OpenClaw 都有独立官方安装页，适合把安装 URL 或说明直接交给 AI 自动完成环境配置。
统一结果能力
网页、CLI 和 AI 工作流都共享同一套来源支持、语言设置和字幕导出能力，输出依旧可落到纯文本、TXT、SRT、VTT。
官方安装入口
如果你已经确定要把 Deyo 接到具体工具里，可以直接进入下面的官方安装页。它们更适合作为搜索落地页，也适合直接交给 AI 执行。
常见问题
关于 Deyo CLI 与 AI 安装
CLI 和网页支持的是同一套来源吗？
是。同样支持小宇宙、喜马拉雅、B站、抖音、小红书、YouTube、Apple Podcasts、Twitter/X 这 8 类来源，CLI 和网页复用同一套服务端能力；Twitter/X 文本 / 图片推文同样不会进入转写。
API key 创建后要怎么使用？
登录后在个人中心创建 API key，完整 key 只展示一次。建议马上执行一次 `deyo auth login` 保存到本地，后续 CLI 和 AI 工作流会优先复用本地配置。
应该选 CLI、Codex、Claude 还是 OpenClaw？
你自己在终端里跑命令时选 CLI；希望 AI 代你安装和执行时选 Codex 或 Claude；想把 skill 管理在当前 workspace 里时选 OpenClaw。
安装完成后能做什么？
安装完成后可以直接让 Deyo 把链接转成中文或英文文字稿，也可以导出 SRT、VTT 等字幕格式，用于脚本、内容整理或 AI 协作。