跳到主要内容
Codex 安装
Codex 官方安装页

在 Codex 中安装 Deyo Plugin

Deyo 以 Git marketplace plugin 形式接入 Codex。CLI 负责转写,Plugin 内的 Skill 负责正确调用;安装和更新由 Codex 管理,新 thread 加载新版。

默认 user scopeCodex 管理 marketplace 与 plugin安装或更新后从新 thread 使用

统一安装入口

运行 `deyo skill install --platform codex`,由 CLI 安全配置 Deyo marketplace/plugin,不直接改 Codex cache 或 lockfile。

更新方式

Codex 管理 Git marketplace 的刷新和 Plugin 更新。新版 bundled Skill 会在新 thread 中加载。

版本关系

Plugin 内的 Skill 与其他三个平台统一为 1.0.11;CLI 仍独立维护,最低要求为 0.2.2。

一步完成

直接发给 Codex 的一句话

请按 https://deyo.miaobi.fun/ai/install/codex 的官方说明为我安装 Deyo。
执行规矩

Codex 应该做什么

1. 安装 deyo 命令

如果本机还没有 deyo,或版本低于 0.2.2、help 中没有 --stream-transcript,就先安装或升级 @casatwy/deyo

2. 安装 Codex Plugin

执行 deyo skill install --platform codex,由 CLI 配置官方 Git marketplace/plugin;不要直接覆盖 Codex cache 或 lockfile。

3. 索取一次 API key

向用户索取 Deyo API key,不能凭空猜测或伪造;用户需要在 Deyo 个人中心创建。

4. 保存到本地

收到 API key 后,立即执行一次 deyo auth login,以后就不要要求用户每次重复提供。

5. 流式整理普通正文

普通 text 且用户未要求 raw 时,加 --progress-format jsonl --stream-transcript,让 CLI 只写权限受限的临时原稿;逐段整理稳定正文,reset 时发编号更正段,终态从完整原稿重做并用 skill helper 原子 no-clobber 发布 cleaned TXT。并发占位或悬空 symlink 不得覆盖;SRT/VTT/JSON/raw 保持原样。

6. 语言与服务地址

只有用户明确选择语言时才传 --language <language>;未选择时 CLI 与请求体都省略语言字段,由服务端和 Whisper 自动检测。默认使用生产服务,不主动传 --base-url;只有明确要求本地/开发环境时才使用 --base-url http://deyo.mac-studio

安装与更新

使用 Deyo CLI 管理 Codex Plugin

npm install -g @casatwy/deyo@^0.2.0
deyo --version

deyo skill install --platform codex
deyo skill status --platform codex

Git source 固定为 https://github.com/casatwy/deyo-skill.git。Codex 管理 marketplace 刷新和 Plugin 更新;安装或更新后请从新 thread 开始使用。status 只读、离线,不会触发更新。

本地登录

保存 API key 的命令

deyo auth login --api-key "deyo_sk_xxx"
后续用法

安装完成后可以直接这样说

用 deyo 把这个 B 站链接转成中文整理稿,输出到 ./tmp/out.txt

用 deyo 把这个 YouTube 链接转成英文文字稿,并导出成 srt 字幕

用 deyo 转写本地文件 ./audio.mp3,输出到 ./tmp/audio.txt
常见问题

关于 Codex 安装 Deyo

Q:Codex 安装 Deyo Plugin 后能直接转写什么?

安装完成后,Codex 可以直接调用 Deyo 处理小宇宙、喜马拉雅、B站、抖音、小红书、YouTube、Apple Podcasts、Twitter/X 视频推文和 TikTok 单条公开视频链接,也可以处理单个本地音视频文件,并输出 text、srt、vtt、json、verbose_json 等结果。

Q:为什么安装后要新建 thread?

Codex 的 bundled skills 和 tools 在新会话启动时加载;安装或 marketplace 更新后,新建 thread 才能稳定使用新版 Deyo Plugin。

Q:API key 需要每次都重新提供吗?

不需要。首次获取 API key 后执行一次 `deyo auth login` 保存到本地,后续 Codex 应默认复用本地配置;只有明确要求本地/开发环境时才传 `--base-url http://deyo.mac-studio`。只有用户明确选择语言时才传 `--language <language>`,否则省略并自动检测。

Q:`deyo skill status --platform codex` 会更新 Plugin 吗?

不会。status 只做离线只读检查;它不会刷新 marketplace,也不会修改 Codex 配置、cache 或 lockfile。