# opencode-voice-extension

**Repository Path**: qiangge_666/opencode-voice-extension

## Basic Information

- **Project Name**: opencode-voice-extension
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-01
- **Last Updated**: 2026-02-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎤 OpenCode Voice Input Extension

为 OpenCode Web 界面添加语音输入功能的浏览器扩展。

## ✨ 功能特性

- 🎙️ **语音输入** - 点击麦克风按钮或使用快捷键开始语音输入
- 🌐 **多语言支持** - 支持中文（zh-CN）和英文（en-US）
- ⌨️ **快捷键** - `Ctrl+Shift+V`（Mac: `Cmd+Shift+V`）快速切换语音输入
- 👁️ **视觉反馈** - 录制时有脉冲动画和状态提示
- 🔒 **本地处理** - 使用 Web Speech API，无需服务器
- 📱 **响应式设计** - 适配桌面和移动设备

## 📦 安装方法

### Chrome / Edge 浏览器

1. 打开 Chrome 扩展页面：`chrome://extensions/`
2. 开启右上角的"开发者模式"
3. 点击"加载已解压的扩展程序"
4. 选择 `opencode-voice-extension` 文件夹
5. 扩展已安装完成！

### Firefox 浏览器

1. 打开 Firefox 调试页面：`about:debugging`
2. 点击"此 Firefox"
3. 点击"临时载入附加组件"
4. 选择 `manifest.json` 文件
5. 扩展已安装完成！

## 🚀 使用方法

1. 启动 OpenCode Web 界面：
   ```bash
   opencode web
   ```

2. 在浏览器中打开 OpenCode Web 界面（通常是 `http://localhost:8080`）

3. 使用语音输入：
   - 点击右下角的 🎤 麦克风按钮
   - 或使用快捷键 `Ctrl+Shift+V`
   - 开始说话
   - 停顿 3 秒后自动停止，或再次点击按钮停止

4. 识别的文字会自动输入到聊天框中

## ⚙️ 配置选项

在 `content.js` 中可以修改以下配置：

```javascript
const CONFIG = {
  languages: ['zh-CN', 'en-US'],  // 语言设置
  autoStopDelay: 3000,            // 自动停止延迟（毫秒）
  placeholderText: '🎤 点击说话或按 Ctrl+Shift+V'
};
```

## 🔧 故障排除

### 麦克风无法访问
- 确保浏览器已授予麦克风权限
- 检查系统麦克风设置

### 语音识别不准确
- 确保在安静的环境中使用
- 说话清晰，语速适中
- 检查浏览器语言设置

### 扩展无法加载
- 确认已开启开发者模式
- 检查文件路径是否正确
- 查看浏览器控制台错误信息

## 🌟 浏览器兼容性

- ✅ Chrome 90+
- ✅ Edge 90+
- ✅ Firefox 88+
- ⚠️ Safari 14.1+（部分支持）

## 📝 技术说明

- 使用 Web Speech API 进行语音识别
- 支持 Chrome 和 Edge 的原生语音识别引擎
- 无需外部 API 密钥或服务器
- 完全本地处理，保护隐私

## 📄 文件结构

```
opencode-voice-extension/
├── manifest.json      # 扩展配置
├── content.js         # 主脚本
├── styles.css         # 样式文件
├── icons/             # 图标文件
│   ├── icon16.svg
│   ├── icon48.svg
│   └── icon128.svg
└── README.md          # 说明文档
```

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📜 许可证

MIT License