Gemini CLI 官方安装页

在 Gemini CLI 中安装 Deyo Extension

Deyo 以 Gemini Extension 形式安装，并启用 --auto-update。Extension 内包含统一版本 1.0.11 的 Deyo Skill，最低 CLI 为 0.2.2；所有变更在重启 Gemini CLI 后生效。

默认 user scope安装时启用 --auto-update更新后重启 Gemini CLI

统一安装入口

运行 `deyo skill install --platform gemini`，由 CLI 安装官方 Git Extension。

自动更新

安装器启用 Gemini Extension 的 `--auto-update`，不固定 `--ref`，后续跟随正式发布。

安全确认

安装不使用 `--consent` 绕过来源确认，也不会直接覆盖 Gemini extension metadata。

返回文档总入口创建 API key

一步完成

直接发给 Gemini CLI 的一句话

请按 https://deyo.miaobi.fun/ai/install/gemini 的官方说明为我安装 Deyo。

安装与更新

安装带自动更新的 Gemini Extension

默认安装到 user scope。安装器使用 Gemini Extension 机制并启用 --auto-update；不会固定 --ref，也不会用 --consent 跳过来源确认。

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

deyo skill install --platform gemini
deyo skill status --platform gemini

安装或更新 Extension 后请重启 Gemini CLI。status 完全只读、离线，不会触发更新。

执行规矩

Gemini CLI 应该做什么

1. 检查 deyo 命令

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

2. 安装 Extension

执行 deyo skill install --platform gemini 安装官方 Git Extension；安装器保留 Gemini 的来源安全确认并开启自动更新。

3. 索取并保存 API key

不能猜测或伪造 API key。用户创建后执行一次 deyo auth login，以后默认复用本地配置。

4. 流式整理普通正文

普通 text 且未要求 raw 时，使用 --progress-format jsonl --stream-transcript，逐段整理稳定正文，并在终态从完整私有原稿重做，再用 skill helper 原子 no-clobber 发布 cleaned TXT；并发占位或悬空 symlink 不得覆盖。

5. 保持机器格式原样

SRT、VTT、JSON、verbose_json 和明确要求 raw 的结果不做 AI 整理；数字、日期、代码和 URL 默认保持不变。

6. 语言与服务地址

只有用户明确选择语言时才传 --language <language>；未选择时省略并由服务端和 Whisper 自动检测。默认不传 --base-url；只有明确要求本地或开发环境时才使用 http://deyo.mac-studio。

本地登录

保存 API key 的命令

deyo auth login --api-key "deyo_sk_xxx"

后续用法

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

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

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

用 deyo 转写本地文件 ./audio.mp3，输出到 ./tmp/audio.txt

常见问题

关于 Gemini CLI 安装 Deyo

Q：Gemini CLI 应该把 Deyo Extension 安装到哪里？

使用 user scope，适合跨项目复用。当前统一安装入口不接受 Gemini workspace scope；如需限制某个 workspace，应使用 Gemini Extension 自身的 enable / disable 配置，而不是改用旧的 Skill 子目录安装。

Q：安装或更新后为什么还看不到新版？

Gemini Extension 的管理操作在重启 CLI 会话后生效。请退出并重新启动 Gemini CLI，不再把会话内 Skill 刷新作为主要更新路径。

Q：Gemini CLI 怎么边转写边整理正文？

普通 text 使用 CLI 0.2.2+ 的 `--progress-format jsonl --stream-transcript`，从稳定正文事件分段整理；CLI 只写私有临时原稿，终态再从完整原稿生成 cleaned TXT。raw、SRT、VTT 和 JSON 不整理。

Q：API key 需要每次都重新提供吗？

不需要。首次获取 API key 后执行一次 `deyo auth login` 保存到本地，后续 Gemini CLI 应默认复用本地配置；只有明确要求本地/开发环境时才传 `--base-url http://deyo.mac-studio`。未明确选择语言时不要传 `--language`，由服务端和 Whisper 自动检测。