Claude 官方安装页

在 Claude 中安装 Deyo Plugin

Deyo CLI 会合并 Deyo 官方 marketplace、安装统一版本 1.0.11 的 Claude Plugin，并为该 marketplace 设置 autoUpdate: true；最低 CLI 为 0.2.2，同名异源配置会拒绝覆盖。

默认 user scopemarketplace autoUpdate: true更新后 reload 或新会话生效

统一安装入口

运行 `deyo skill install --platform claude`，无需手工编辑 Claude settings。

自动更新

Claude 启动时刷新已开启 autoUpdate 的 marketplace，并更新其中已安装的 Deyo Plugin。

冲突保护

同名 marketplace 若来自其他源，安装会停止并保留现状，不会静默覆盖用户配置。

返回文档总入口创建 API key

一步完成

直接发给 Claude 的一句话

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

安装与更新

使用 Deyo CLI 安装 Claude Plugin

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

deyo skill install --platform claude
deyo skill status --platform claude

官方 Git source 是 casatwy/deyo-skill。安装器会合并 deyo-official marketplace、安装 deyo@deyo-official，并设置 autoUpdate: true。同名异源配置会拒绝覆盖；status 只读、离线，不会触发更新。

执行规矩

Claude 应该做什么

1. 使用统一安装入口

执行 deyo skill install --platform claude。官方 Git source 是 casatwy/deyo-skill，不要直接编辑 Claude plugin cache。

2. 开启自动更新

安装器会为 Deyo marketplace 设置 autoUpdate: true。Claude 启动后刷新并更新 Plugin；收到提示后执行 /reload-plugins，或开始新会话。

3. 索取一次 API key

用户需要在 Deyo 个人中心创建自己的 API key，再提供给 Claude；不要伪造、猜测或长期明文回显。

4. 保存到本地

收到 API key 后，执行一次 deyo auth login。此后 Claude 应默认复用本地配置，而不是每次重复索取。

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。

本地登录

保存 API key 的命令

deyo auth login --api-key "deyo_sk_xxx"

常见问题

关于 Claude 安装 Deyo

Q：Claude 安装完成后需要自己再敲 CLI 吗？

通常不需要。插件装好且 API key 已保存后，你可以直接告诉 Claude 要处理哪个链接或本地文件、输出什么格式，它会调用本地 deyo 完成任务。

Q：Claude Plugin 如何自动更新？

安装器会为 Deyo marketplace 设置 `autoUpdate: true`。Claude 启动后在后台刷新并更新，出现更新提示时执行 `/reload-plugins`，或开始新会话。

Q：Claude 安装页为什么还会提到 CLI？

因为 Claude plugin 最终也是通过本地的 Deyo CLI 调用服务，所以需要先确保 `@casatwy/deyo >= 0.2.2` 可用，并把 API key 保存到本地。默认使用生产服务和 CLI 默认配置，只有明确要求本地/开发环境时才传 `--base-url http://deyo.mac-studio`；只有用户明确选择语言时才传 `--language <language>`。

Q：如果 plugin 安装失败怎么办？

保留原始错误交给 Claude 或人工排查，不要自行修改全局 git、SSH 或 npm 配置，也不要手动绕过官方 marketplace 流程。

后续用法

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

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

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

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