finai/miniapp/README.md

财务智能问答 · 微信小程序

与 web 端共用后端 (code/backend) 的 ADP 问答能力，提供登录 + AI 问答两页：

• 登录页：手机号 + 短信验证码（测试账号 13800000000 / 123456）
• 问答页：文字输入、语音输入（同声传译 STT）、上传图片；SSE 流式呈现回答

目录

miniapp/
├─ app.js / app.json / app.wxss       # 全局配置
├─ project.config.json                # 开发者工具项目配置
├─ sitemap.json
├─ utils/
│  └─ request.js                      # 请求 / 上传 / SSE 流封装
└─ pages/
   ├─ login/                          # 登录页
   └─ chat/                           # 问答页

运行

1. 打开 微信开发者工具，导入本目录 (code/miniapp/)。
2. 后端启动 (code/backend)：uvicorn app.main:app --host 0.0.0.0 --port 8000
3. 在 app.js 的 globalData.apiBase 中填写后端可达地址：
   • 真机预览时必须是 HTTPS 域名，且在小程序管理后台配置 request / uploadFile 合法域名。
   • 开发者工具中调试：勾选 详情 → 本地设置 → 不校验合法域名，即可直连 http://localhost:8000。
4. 语音识别使用官方插件 微信同声传译 (WechatSI)，app.json 已注册，首次使用需在小程序后台“设置 → 第三方设置 → 插件管理”中确认可用（AppID wx069ba97219f66d99）。

依赖的后端接口

用途	方法	路径
发送短信验证码	POST	/api/auth/sms-code
登录	POST	/api/auth/login
上传图片	POST	/api/chat/upload-image
流式问答 (SSE)	POST	/api/chat/stream

注意事项

• SSE 使用 wx.request 的 enableChunked + onChunkReceived，需要基础库 2.20.1+。
• wx.chooseMedia 需要基础库 2.10.0+。
• 图片单次最多 4 张，仅支持 PNG/JPG（后端限制）。