45 lines
1.9 KiB
Markdown
45 lines
1.9 KiB
Markdown
# 财务智能问答 · 微信小程序
|
||
|
||
与 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（后端限制）。
|