Deyo CLI 与 Deyo Skill
CLI 负责登录、上传、转写、进度协议和 Whisper 原稿；Skill 负责让 Codex、Claude、Gemini CLI、OpenClaw 正确调用 CLI，并在符合条件的 text 场景整理正文。两者独立安装、独立版本、独立更新。
选择使用方式
CLI 负责登录、上传、转写、进度协议和 Whisper 原稿；Skill 负责让四个平台正确调用 CLI。两者独立安装、独立版本、独立更新。
CLI 的安装与使用
安装 deyo
先选择一个你常用的包管理器安装 CLI 0.2.x。安装完成后执行 deyo --version；CLI 与 Skill 的版本号彼此独立。
npm install -g @casatwy/deyo@^0.2.0
deyo --versionpnpm add -g @casatwy/deyo@^0.2.0
deyo --versionyarn global add @casatwy/deyo@^0.2.0
deyo --versionbun install --global @casatwy/deyo@^0.2.0
deyo --versiondeno install --global --compile -A --name deyo npm:@casatwy/deyo@^0.2.0
deyo --version获取 API Key
登录后进入 /me/api-keys 页面，先输入一个用途名称，例如“本地 CLI”，再点击“创建 API key”。创建成功后，完整 key 只会展示这一次，请立即复制，下一步直接保存到本地。
首次保存 API Key
创建完 API key 后，只需要执行一次下面这条命令，把 key 保存到本地。API key 读取优先级是 --api-key -> DEYO_API_KEY -> 本地配置；普通使用不需要每次重复传 --api-key。服务地址默认使用生产服务和 CLI 默认配置，只有明确本地/开发环境时才传 --base-url http://deyo.mac-studio。
deyo auth login --api-key "deyo_sk_xxx"常见用法
保存过 API key 后，可以直接处理受支持的具体单集、视频或单条内容，也可以上传单个本地音视频文件。Apple Podcasts 节目主页、小宇宙播客主页和 B站合集会返回 422，并提示改用具体单集或视频。
deyo -O ./out.txt "https://www.youtube.com/watch?v=xxxx"
deyo --format srt -O ./out.srt "https://www.bilibili.com/video/BVxxxx"
deyo ./audio.mp3
deyo --file "./audio.mp3" -O ./audio.txt
deyo --file "./audio.mp3" --mime-type "audio/mpeg" -O ./audio.txt
deyo --language en "https://www.youtube.com/watch?v=xxxx"通过 CLI 提交微信视频号
授权范围与账号安全
视频号功能默认关闭，仅在服务已启用时可用。CLI 使用既有 API key，不新增视频号 login / status 命令，也不接收 Cookie。
deyo --source wechat_channels -O ./wechat.txt '<官方链接>' 如果全站共享授权不可用，CLI 会打印并尝试用系统浏览器打开短时 Deyo HTTPS 页面；无图形界面环境可将 URL 复制到其他设备。完成页面授权后，CLI 按服务端的 retryAfterMs 轮询状态，并只重放一次原始提交。完整 Cookie 不经过 CLI；Deyo 只在服务端加密保存三个必要 Cookie 字段，并在单次解析时传给 Whisper，不写入日志或业务记录。CLI 也不从参数、stdin、环境变量、配置文件或剪贴板读取 Cookie。
常用参数与命令
deyo auth login- 把 API key 保存到本地，推荐作为首次配置命令；默认不需要保存服务地址。
deyo auth status- 查看当前 API key 和服务地址来源，不会回显完整 key。
--api-key- 可选。临时覆盖环境变量或本地配置时再传，优先级最高。
--base-url- 可选。普通使用不要传；只有明确本地/开发环境时才用
http://deyo.mac-studio。 -O/--output- 指定输出文件；不传时结果会直接打印到终端。
--file- 显式指定一个本地音频或视频文件；也可以直接写
deyo ./audio.mp3。 --mime-type- 可选。自动识别不可靠时，用它明确文件媒体类型，例如
audio/mpeg。 --language- 可选。只有明确选择语言时才传
--language <language>；不传时由服务端和 Whisper 自动检测，不再默认指定中文。 --format- 支持
text、srt、vtt、json、verbose_json。 --source- 用于强制链接来源；支持
xiaoyuzhou、ximalaya、bilibili、douyin、xiaohongshu、youtube、apple-podcasts、twitter、tiktok、wechat_channels。本地文件不需要传。 - 节目主页与合集
- Apple Podcasts 节目主页、小宇宙
/podcast/主页、B站 Bangumi / UGC 合集不能整套转写。CLI/API 会在任务复用、余额检查和分钟扣减前返回 422；请改用 Apple?i=单集、小宇宙/episode/或 B站具体视频链接。 --progress-format- 支持
auto、text、jsonl；AI 代跑上传或长转写任务时使用jsonl，读取后转述进度，不直接粘贴原始事件。 --stream-transcript- CLI 0.2.2+ 可选能力，默认关闭。只支持最终
text且必须搭配--progress-format jsonl；正文事件只写 stderr，stdout /-O仍是最终 Whisper 原稿。 DEYO_API_KEY- 如果你更偏向环境变量，也可以把 key 放到这里；优先级低于
--api-key，高于本地配置。 - 本地文件边界
- 只支持单个普通音视频文件；不支持目录、glob、stdin、批量队列或断点续传。本地文件固定按
upload来源提交。 - 计费与字幕直出
- 链接转写和本地上传都需要 API key 鉴权；完整转写会扣减分钟余额。YouTube 命中可直接使用的字幕时会直出结果；节目主页与合集的 422 分支同样不扣分钟、不创建转写任务。
一句话交给 Codex
请按 https://deyo.miaobi.fun/ai/install/codex 的官方说明为我安装 Deyo。安装与检查
deyo skill install --platform codex
deyo skill status --platform codex默认安装到 user scope。Codex 通过 Git marketplace 管理 Deyo Plugin；安装或宿主刷新后，请新建 thread 以加载新版 bundled Skill。
官方标识
Git source 固定为 casatwy/deyo-skill。普通用户只需使用上面的 deyo skill 命令，不需要手工改 Codex 配置。
https://github.com/casatwy/deyo-skill.git
https://deyo.miaobi.fun/ai/install/codex一句话交给 Claude
请按 https://deyo.miaobi.fun/ai/install/claude 的官方说明为我安装 Deyo。安装与检查
deyo skill install --platform claude
deyo skill status --platform claude 默认 user scope。安装器合并 deyo-official marketplace、安装 deyo@deyo-official，并设置 autoUpdate: true；同名异源配置会拒绝覆盖。
更新后生效
Claude 启动时刷新开启自动更新的 marketplace。收到更新提示后执行 /reload-plugins，或开始新会话。
/reload-plugins
https://deyo.miaobi.fun/ai/install/claude一句话交给 Gemini CLI
请按 https://deyo.miaobi.fun/ai/install/gemini 的官方说明为我安装 Deyo。安装与检查
deyo skill install --platform gemini
deyo skill status --platform gemini 默认 user scope。安装器使用官方 Git source 创建 Gemini Extension，并启用 --auto-update；不固定 --ref，也不使用 --consent 跳过安全确认。
更新后重启
Gemini Extension 的安装和更新在重启 CLI 会话后生效。旧的 Skill 子目录安装与会话内刷新方式不再是主要路径。
https://deyo.miaobi.fun/ai/install/gemini一句话交给 OpenClaw
请按 https://deyo.miaobi.fun/ai/install/openclaw 的官方说明为我安装 Deyo。安装与检查
deyo skill install --platform openclaw
deyo skill status --platform openclaw 默认 global scope，并固定安装 owner-qualified 的 @casatwy/deyo。不会使用裸 slug、--all 或 --force；安装后只通过显式 /deyo 调用。
调用时安全更新
不创建 Cron。显式 /deyo 调用时最多每 24 小时做一次 verify-only 检查；没有新版或检查失败时继续旧任务。发现 ClawHub security pass/clean 的新版后，先显示 exact 候选并在当前请求询问；没有明确同意就不更新。明确同意后才执行受限的 owner-qualified 单项 update 并再次验证 latest；候选变化必须重新确认，更新成功或结果不确定则要求重新调用 /deyo。
deyo skill update --platform openclaw --scope global --confirm-latest 'update @casatwy/deyo to latest now'https://deyo.miaobi.fun/ai/install/openclawDeyo CLI
负责 API key 登录、链接或本地文件提交、进度 JSONL、Whisper 原稿和 text / SRT / VTT / JSON 输出。
Deyo Skill
负责平台调用约定和 text 整理。Skill 1.0.11 要求 CLI >=0.2.2，但 Skill 与 CLI 的版本号不需要相同。
安全更新
安装和状态检查统一通过 `deyo skill` 命令；CLI 不直接覆盖平台 cache 或 lockfile，遗留安装只有在官方历史哈希完全匹配时才迁移。
官方安装入口
如果你已经确定要把 Deyo 接到具体工具里，可以直接进入下面的官方安装页。它们更适合作为搜索落地页，也适合直接交给 AI 执行。
关于 Deyo CLI 与 Deyo Skill
CLI 和网页支持的是同一套来源吗？
是。网页和 CLI 共用同一套服务端来源与计费规则，支持 10 类平台链接、HTTPS 音频/视频文件直链和单个本地音视频上传。
节目主页或合集可以整套转写吗？
不可以。网页解析页会为 Apple Podcasts 节目主页、小宇宙播客主页和 B站 Bangumi / UGC 合集展示摘要，但不展示单集或视频清单，也不进入支付、分钟扣减或转写任务。CLI/API 会在任务复用和计费前返回 HTTP 422，请改用具体单集或视频链接。
API key 创建后要怎么使用？
登录后在个人中心创建 API key，完整 key 只展示一次。建议马上执行一次 `deyo auth login` 保存到本地，后续 CLI 和 AI 工作流会优先复用本地配置。
CLI 与 Skill 要保持相同版本吗？
不需要。当前 CLI 0.2.3 与 Skill 1.0.11 属于两条独立版本线；Skill 只声明最低 CLI 版本 0.2.2。四个平台的 Skill 版本会保持一致。
没有指定语言时要传 `--language` 吗？
不要传。只有用户明确选择语言时才传 `--language <language>`；未选择时省略该参数，由服务端和 Whisper 自动检测。
`deyo skill status` 会触发更新吗？
不会。status 完全只读、离线，只报告当前平台、来源、scope 和版本状态。更新由平台原生机制或 OpenClaw 调用时的节流检查完成。
Deyo Skill 如何保持更新？
Codex 由 Plugin / marketplace 管理并在新 thread 使用新版；Claude marketplace 开启 autoUpdate；Gemini Extension 使用 --auto-update，更新后重启；OpenClaw 不建 Cron，只在显式 `/deyo` 调用时最多每 24 小时做一次 verify-only 检查，发现 security pass/clean 的新版后必须取得用户明确同意才更新。
CLI 支持批量上传或断点续传吗？
不支持。CLI 当前只支持单条链接或单个本地音视频文件；目录、glob、stdin、批量队列和断点续传都不是当前能力。