# 🎤 医生端语音自动填表 - 快速开始

## ⚡ 3分钟快速体验

### 第1步：启动后端服务

```bash
cd /Users/destiny/dev/emoon/demos/playwright_demo
./start-backend.sh
```

或者：
```bash
mvn spring-boot:run
```

**验证：** 打开浏览器访问 http://localhost:8080

---

### 第2步：安装浏览器扩展

#### Chrome/Edge 浏览器：

1. 复制以下地址到地址栏：
   ```
   chrome://extensions/
   ```
   或
   ```
   edge://extensions/
   ```

2. 开启右上角的"开发者模式"

3. 点击"加载已解压的扩展程序"

4. 选择文件夹：`medical-voice-extension`

5. 完成！扩展已安装

---

### 第3步：开始使用

1. **访问演示页面：** http://localhost:8080/

2. **找到按钮：** 页面右下角有 "🎤 语音输入" 按钮

3. **点击按钮并说话：**
   ```
   患者张三，35岁，男，咳嗽发烧3天
   ```

4. **查看效果：** 表单自动填写完成！

---

## 🎯 在真实 HIS 系统使用

1. 打开医院的 HIS 系统页面

2. 点击右下角的 "🎤 语音输入" 按钮

3. 说出医患对话内容

4. 系统自动识别并填写表单

**示例对话：**
```
医生：您好，请报一下您的姓名、年龄和联系电话。
患者：我叫张三，今年35岁，电话是13800138000，男性。
医生：您今天来是因为什么不舒服？
患者：我咳嗽、发烧已经3天了，还伴有咽痛。
```

---

## 📚 详细文档

- **快速配置指南：** 查看 `浏览器扩展配置指南.md`
- **详细使用教程：** 查看 `EXTENSION_SETUP_GUIDE.md`
- **项目修改总结：** 查看 `项目修改总结.md`

---

## 🔧 配置说明

### 后端服务配置

**文件：** `src/main/resources/application.yml`

```yaml
# 外网模式（默认）
dashscope:
  enabled: true
  api-key: sk-your-api-key
  model: qwen-plus

# 内网模式（生产环境）
qwen-internal:
  enabled: false
  base-url: http://your-internal-server:port
```

### 浏览器扩展配置

**文件：** `medical-voice-extension/content.js`

```javascript
const CONFIG = {
  BACKEND_URL: 'http://localhost:8080',  // 修改后端地址
  API_ENDPOINT: '/api/extract'
};
```

---

## 🐛 遇到问题？

### 扩展按钮没有出现
- 刷新页面
- 检查扩展是否启用：`chrome://extensions/`
- 按 F12 打开控制台查看错误

### 语音识别不工作
- 确保使用 Chrome/Edge 浏览器
- 检查麦克风权限
- 查看控制台错误信息

### 表单没有自动填写
- 确认后端服务已启动
- 访问 http://localhost:8080 验证服务
- 查看控制台网络请求

---

## ✨ 核心功能

- 🎤 **语音输入**：使用浏览器内置语音识别
- 🤖 **智能提取**：调用千问大模型提取医疗信息
- ✍️ **自动填表**：智能匹配表单字段并填写
- 🔒 **数据安全**：完全内网部署，数据不出医院

---

## 📞 技术支持

查看详细文档：
- `浏览器扩展配置指南.md` - 快速配置指南
- `EXTENSION_SETUP_GUIDE.md` - 完整使用教程
- `项目修改总结.md` - 技术实现说明

---

## 🎉 开始使用

现在就开始体验吧！

1. 启动服务：`./start-backend.sh`
2. 安装扩展：`chrome://extensions/`
3. 打开页面：http://localhost:8080
4. 点击按钮说话
5. 查看自动填写效果

**祝你使用愉快！** 🎊