90 lines
4.0 KiB
Markdown
90 lines
4.0 KiB
Markdown
# 设计
|
||
|
||
## 1. 概述
|
||
本 App 是一个"发票助手"：扫描小票二维码 -> 打开对应 h5 页面 -> 用 AI 识别页面表单 -> 自动填入预置的开票信息 -> 用户确认提交获取发票。
|
||
|
||
> 说明：需求中的"trauri"按 **Tauri** 框架理解；AI 采用**硅基流动云端大模型 API**（cloud.siliconflow.cn，需联网）。
|
||
|
||
## 2. 技术选型
|
||
- 框架：Tauri 2.x（编译 Android APK）。
|
||
- 前端：Vue 3 + Vite（轻量、易写表单页）。
|
||
- 二维码扫描：`tauri-plugin-barcode-scanner`（调用相机）。
|
||
- h5 展示：Tauri WebviewWindow / 内嵌 iframe 加载扫描得到的 URL。
|
||
- 本地存储：Rust 侧 `rusqlite`（bundled，内置 SQLite）保存预置开票信息。
|
||
- AI 调用：Rust 侧 `command` 转发到硅基流动 HTTP 接口（OpenAI 兼容协议），密钥不暴露在前端；`reqwest` 使用 `rustls-tls`，免系统 OpenSSL 依赖。
|
||
eqwest 使用
|
||
ustls-tls 免系统 OpenSSL 依赖。
|
||
- 权限：桌面权限在 capabilities/default.json，扫码权限单独放 capabilities/mobile.json（限定 android/iOS 平台）。
|
||
- 工具链：在 WSL 中执行 Rust + Android NDK/SDK 构建。
|
||
|
||
## 3. 功能模块
|
||
### 3.1 开票信息管理
|
||
- 字段：抬头、税号、Email、（可选）地址、电话、开户行、账号。
|
||
- 支持多条，标记 1 条为默认（`is_default=1`）。
|
||
- 界面：列表 + 增/删/改 + 设为默认。
|
||
|
||
### 3.2 二维码扫描
|
||
- 点击"扫一扫"调用相机识别二维码，得到 URL。
|
||
- 得到 URL 后打开内置 WebView 展示 h5 页面。
|
||
|
||
### 3.3 AI 识别与自动填充
|
||
1. 页面加载完成后，前端注入脚本抓取表单 DOM（各 input/select 的 label、name、placeholder）。
|
||
2. 将 DOM 摘要 + 默认开票信息通过 Rust command 发送给大模型。
|
||
3. 大模型返回"字段选择器 -> 应填值"的映射（JSON）。
|
||
4. 前端按映射用注入脚本回填表单。
|
||
5. 用户核对后手动点提交。
|
||
|
||
## 4. 数据模型
|
||
```
|
||
invoice_info(
|
||
id INTEGER PK,
|
||
title TEXT, -- 抬头
|
||
tax_no TEXT, -- 税号
|
||
email TEXT,
|
||
address TEXT,
|
||
phone TEXT,
|
||
bank_name TEXT,
|
||
bank_account TEXT,
|
||
is_default INTEGER -- 1=默认，仅一条
|
||
)
|
||
```
|
||
|
||
## 5. 核心流程
|
||
```mermaid
|
||
flowchart TD
|
||
A[打开 App] --> B[扫描二维码]
|
||
B --> C[获取 URL]
|
||
C --> D[WebView 加载 h5 页面]
|
||
D --> E[抓取表单 DOM]
|
||
E --> F[DOM + 默认开票信息 发送大模型]
|
||
F --> G[返回字段映射 JSON]
|
||
G --> H[注入脚本回填表单]
|
||
H --> I[用户核对并提交]
|
||
I --> J[获取发票]
|
||
```
|
||
|
||
## 6. 关键接口（Tauri command）
|
||
- `list_invoice_info()` / `save_invoice_info()` / `delete_invoice_info()` / `set_default(id)`：信息 CRUD。
|
||
- `ai_map_fields(dom_summary, info)`：调用大模型，返回字段映射 JSON。
|
||
|
||
## 7. AI 接口配置
|
||
- 服务商：硅基流动，OpenAI 兼容 `chat/completions` 接口。
|
||
- Base URL：`https://api.siliconflow.cn/v1`
|
||
- 密钥：`sk-drqdzsdvsnqxalvwjggsexyowbertkxrgpqyeqilhkkiqemn`（当前硬编码在 Rust 层）。
|
||
- 为便于未来更换服务商，Rust 侧用一组常量集中管理：
|
||
```rust
|
||
// AI 服务配置：更换服务商时只改此处
|
||
const AI_BASE_URL: &str = "https://api.siliconflow.cn/v1";
|
||
const AI_API_KEY: &str = "sk-drqdzsdvsnqxalvwjggsexyowbertkxrgpqyeqilhkkiqemn";
|
||
const AI_MODEL: &str = "Qwen/Qwen2.5-7B-Instruct"; // 具体模型待定
|
||
```
|
||
- 调用统一走 `ai_map_fields` command，内部封装请求，切换服务商仅需改常量（及必要的请求格式适配）。
|
||
|
||
> 安全提示：密钥硬编码会被打包进 APK，存在泄露风险，仅作当前阶段方案；后续建议改为服务端代理或运行时配置。
|
||
|
||
## 8. 待确认
|
||
- 使用的具体模型名称（影响识别效果与费用）。
|
||
- 是否需要邮箱自动接收发票（仅填 Email 还是集成收件）。
|
||
- h5 页面跨域抓取 DOM 的限制处理方式。
|
||
|