opencode语音通知插件怎么装？社区插件实战推荐

1. 为什么你需要语音通知插件

你有没有过这样的经历：在终端里跑一个耗时的代码分析任务，然后切去写文档、查资料，结果等了半天才发现任务早就完成了？或者正在调试一个复杂函数，想确认某次重构是否成功，却得反复切回终端看输出？

OpenCode 的语音通知插件就是为这种真实场景而生的——它不抢你注意力，但会在关键节点“开口说话”，用一句清晰的提示告诉你：“代码已重构完成”“测试全部通过”“错误已定位”。

这不是炫技，而是把 AI 编程助手真正变成你工作流里的“无声协作者”。它不打断你，只在该出现的时候出现；不依赖视觉，让双手和眼睛继续专注在 IDE 或文档上；更关键的是，整个过程完全离线、本地运行，你的代码从不离开本机。

下面我们就从零开始，手把手带你装好这个实用插件，并让它真正为你服务。

2. OpenCode 是什么：终端里的 AI 编程搭档

2.1 它不是另一个 Web IDE

OpenCode 是一个 2024 年开源的 AI 编程助手框架，用 Go 写成，核心理念就三句话：终端优先、多模型、隐私安全。

它不像很多 AI 工具那样必须打开浏览器、登录账号、上传代码。OpenCode 直接在你的终端里启动，像 ls 或 git 一样自然。输入 opencode，回车，TUI 界面立刻展开——Tab 切换不同 Agent（比如 build 模式做代码补全，plan 模式做项目规划），光标所到之处，LSP 自动加载，跳转、补全、诊断实时生效。

更重要的是，它不绑定任何厂商。你可以一键切换 Claude、GPT、Gemini，也可以接入本地模型，比如我们接下来要用的 Qwen3-4B-Instruct-2507。

2.2 它为什么值得你花 5 分钟安装

• 50k+ Star，MIT 协议：社区活跃，商用无顾虑
• 零代码存储：默认不记录任何代码片段或上下文，可完全离线运行
• Docker 隔离执行：每个模型、每个插件都在独立容器中运行，安全又干净
• 40+ 社区插件：从 Google AI 搜索、令牌分析，到我们今天要装的语音通知，全部一键启用

一句话选型：想要一个免费、离线、能听会说的终端 AI 编码助手？直接 docker run opencode-ai/opencode 就行。

3. 准备工作：快速部署 OpenCode + Qwen3-4B 模型

3.1 一键启动 OpenCode（Mac/Linux）

确保你已安装 Docker 和 Docker Compose：

# 拉取并运行官方镜像
docker run -it --rm \
  -p 8080:8080 \
  -v "$HOME/.opencode":/root/.opencode \
  -v "$PWD":/workspace \
  --name opencode \
  opencode-ai/opencode

运行后，终端会自动进入 OpenCode 的 TUI 界面。按 q 退出，我们先不急着用，因为默认模型是远程调用，我们要换成本地的 Qwen3-4B。

3.2 本地部署 Qwen3-4B-Instruct-2507（vLLM 加速版）

我们用 vLLM 提供高性能推理服务，比原生 Transformers 快 3–5 倍，显存占用更低：

# 创建模型服务目录
mkdir -p ~/opencode-models/qwen3-4b && cd ~/opencode-models/qwen3-4b

# 拉取 vLLM 镜像并启动服务（需 NVIDIA GPU）
docker run --gpus all --rm -d \
  -p 8000:8000 \
  -v "$(pwd)":/models \
  --name qwen3-vllm \
  vllm/vllm-openai:latest \
  --model Qwen/Qwen3-4B-Instruct \
  --tensor-parallel-size 1 \
  --dtype bfloat16 \
  --enable-prefix-caching \
  --max-num-seqs 256

验证服务是否就绪：
打开浏览器访问 http://localhost:8000/docs，能看到 OpenAI 兼容的 API 文档页，说明服务已正常运行。

3.3 配置 OpenCode 使用本地模型

在你的项目根目录（或任意你想工作的目录）新建 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "qwen3-4b",
      "options": {
        "baseURL": "http://localhost:8000/v1"
      },
      "models": {
        "Qwen3-4B-Instruct-2507": {
          "name": "Qwen3-4B-Instruct-2507"
        }
      }
    }
  }
}

保存后，再次运行 opencode，它会自动读取该配置，将所有请求转发给本地 vLLM 服务。你可以在 TUI 右上角看到模型名称已变为 Qwen3-4B-Instruct-2507。

4. 安装语音通知插件：三步搞定，全程离线

4.1 插件原理：它到底做了什么

语音通知插件（@opencode/plugin-speech）本质是一个轻量级事件监听器。它不修改任何核心逻辑，只是在 OpenCode 的几个关键生命周期钩子上注册回调：

• onTaskComplete：当一次代码生成、重构或测试执行结束时
• onError：当 Agent 报出语法错误或运行异常时
• onPlanReady：当项目规划 Agent 输出完整方案时

触发后，它调用系统原生语音合成（macOS 用 say，Linux 用 espeak-ng，Windows 用 PowerShell Add-Type -AssemblyName System.Speech），把文本转成语音播放。全程不联网、不传数据、不依赖云服务。

4.2 安装步骤（Mac 用户）

# 1. 进入 OpenCode 插件目录（首次运行会自动创建）
cd ~/.opencode/plugins

# 2. 安装语音插件（npm 包管理）
npm install @opencode/plugin-speech@latest

# 3. 启用插件（编辑 ~/.opencode/config.yaml）
echo 'plugins:
  - "@opencode/plugin-speech"' >> ~/.opencode/config.yaml

验证：重启 opencode，在 TUI 底部状态栏应看到 speech: enabled 字样。

4.3 Linux 用户适配（Ubuntu/Debian）

语音引擎需手动安装 espeak-ng：

sudo apt update && sudo apt install -y espeak-ng

# 然后同 Mac 步骤安装插件
cd ~/.opencode/plugins
npm install @opencode/plugin-speech@latest
echo 'plugins:
  - "@opencode/plugin-speech"' >> ~/.opencode/config.yaml

小技巧：如果你希望语音更自然，可以加一行配置指定音色：

plugins:
  - "@opencode/plugin-speech"
pluginOptions:
  speech:
    voice: "en-us+m3"  # 英式女声（espeak-ng 支持列表见 man espeak-ng）

4.4 Windows 用户（WSL2 环境）

推荐使用 WSL2 + Ubuntu 子系统（体验最接近原生）：

# 在 WSL2 中执行
sudo apt install -y espeak-ng
cd ~/.opencode/plugins
npm install @opencode/plugin-speech@latest
echo 'plugins:
  - "@opencode/plugin-speech"' >> ~/.opencode/config.yaml

注意：WSL2 默认无法播放声音，需额外配置 PulseAudio 或使用 Windows 原生终端（如 Windows Terminal + Ubuntu）。若追求简单，建议直接用 Windows Terminal 运行 OpenCode（官方提供 Windows 二进制包）。

5. 实战演示：让语音通知真正帮你提效

5.1 场景一：重构完成后自动播报

在 OpenCode TUI 中，按 Tab 切到 build 模式，用方向键选中一段函数，按 r 触发重构。稍等 2–3 秒，你会听到：

“重构完成。已将循环逻辑提取为独立函数，命名建议：calculateTotalPrice。”

同时终端显示重构后的代码。你不用盯着屏幕等结果，可以继续写注释或查文档。

5.2 场景二：单元测试失败即时提醒

在 build 模式下，选中测试文件，按 t 运行测试。如果某个断言失败，语音会立刻说：

“测试未通过。第 42 行：预期返回 true，实际返回 null。请检查 userAuth.validateToken() 调用。”

你甚至不用看哪一行错——语音已把关键信息精准传达。

5.3 场景三：自定义通知（改几行代码就能实现）

插件支持自定义触发条件。打开 ~/.opencode/plugins/node_modules/@opencode/plugin-speech/index.js，找到 onTaskComplete 函数，在 say(text) 前加判断：

if (task.type === 'refactor' && task.success) {
  say(`重构成功！耗时 ${task.durationMs} 毫秒`);
} else if (task.type === 'test' && !task.success) {
  say(`测试失败！${task.error.message.split('\n')[0]}`);
}

保存后重启 OpenCode，通知内容就按你写的逻辑来。

6. 进阶技巧：让语音更懂你

6.1 调整语速与音量（Mac）

系统级控制，无需改插件：

# 降低语速（默认 200，范围 100–300）
defaults write com.apple.speech.synthesis.voice.Alex SpeechRate 160

# 提高音量（默认 100，范围 0–100）
defaults write com.apple.speech.synthesis.voice.Alex Volume 90

6.2 多语言支持（Qwen3 本就支持）

Qwen3-4B-Instruct-2507 原生支持中英双语。你在提示词里写中文，语音就播中文；写英文，就播英文。比如：

• 输入：“把这段 Python 代码改成 Rust，保持逻辑一致” → 语音播中文
• 输入：“Refactor this function to use async/await” → 语音播英文

无需额外配置，模型自动识别。

6.3 静音时段设置（避免打扰）

在 ~/.opencode/config.yaml 中添加：

pluginOptions:
  speech:
    muteHours: [22, 7]  # 晚上 10 点到早 7 点静音
    muteOnFocus: true   # 当终端失去焦点时自动静音

这样深夜加班或会议共享屏幕时，就不会突然冒出一句“代码已生成”。

7. 总结：一个插件，三种改变

7.1 它解决了什么根本问题

• 注意力碎片化：不用反复切屏确认状态，语音在后台默默同步进度
• 反馈延迟感：从“看输出”变成“听结果”，响应更快、更直觉
• 隐私焦虑：全程本地，连麦克风都不用开，只输出不输入

7.2 你真正获得的能力

• 5 分钟内完成部署：Docker + npm，无编译、无依赖冲突
• 完全离线运行：代码、模型、语音引擎，全部在你机器上
• 可定制可扩展：改几行 JS 就能定义自己的播报逻辑
• 社区持续更新：插件仓库每周都有新功能（比如下周将支持语音唤醒）

7.3 下一步建议

• 尝试启用另一个高价值插件：@opencode/plugin-google-search，让 AI 在写代码时实时查最新 API 文档
• 把 opencode.json 配置提交到团队 Git 仓库，让所有成员一键获得统一开发体验
• 如果你用 VS Code，可以搭配 opencode-vscode 插件，在编辑器侧边栏直接调用 Agent

编程不该是孤独的敲击键盘。当你让 AI 开口说话，它就不再是工具，而成了你身边那个总在恰当时机递上一杯咖啡、提醒你该休息、并在你卡住时轻声说“试试这样”的搭档。

---

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。