playwright_demo/QUICK_START.md

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

⚡ 3分钟快速体验

第1步：启动后端服务

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

或者：

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

# 外网模式（默认）
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

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. 查看自动填写效果

祝你使用愉快！ 🎊