feat: 补充图片记账、交易渠道管理与前端偏好文档

- 新增「交易渠道管理」指南与「前端用户偏好」开发文档，并加入侧边栏导航
- 图片记账：补充多图上传、实时识别进度、结果勾选导入与「来源图片」回看，AI 配置新增视觉模型说明
- 数据模型补充 t_channel、t_ai_config/t_ai_image 等表与「类型+金额+时间」去重键说明，表数更新为 21 张
- API 文档补充 /api/channel、/api/transaction/batch、/api/ai/record/image(/stream)、/api/ai/image、/api/ai/channel 等接口
- 截图脚本新增渠道页、图片记账、来源图片与渠道 AI 辅助截图，并放宽导航超时

dev/data-model.md

@@ -1,6 +1,6 @@
 # 数据模型
 
-系统共 **18 张表**，覆盖用户、记账、标签、规则、AI、通知、邮箱账单与日志审计。所有表主键为自增 `id`，表间关系均为**逻辑外键**（通过 `user_id`、`category_id` 等字段在应用层维护，未声明物理外键）。
+系统共 **21 张表**，覆盖用户、记账、渠道、标签、规则、AI、通知、邮箱账单与日志审计。所有表主键为自增 `id`，表间关系均为**逻辑外键**（通过 `user_id`、`category_id` 等字段在应用层维护，未声明物理外键）。
 
 ## 表清单
 
@@ -10,12 +10,15 @@
 | 用户 | `t_user_preference` | 每用户多条的用户偏好（键值） |
 | 记账 | `t_category` | 收支分类（收入/支出，含图标与排序） |
 | 记账 | `t_transaction` | 收支记录（核心表） |
+| 记账 | `t_channel` | 用户自定义交易渠道（内置渠道由枚举维护） |
 | 标签 | `t_tag` | 标签 |
 | 标签 | `t_transaction_tag` | 交易-标签关联（多对多） |
 | 规则 | `t_rule` | 自定义归类规则 |
 | 规则 | `t_rule_tag` | 规则-标签关联（多对多） |
-| AI | `t_ai_config` | 每用户一条的 AI 配置 |
+| AI | `t_ai_config` | 每用户一条的 AI 配置（含视觉模型） |
 | AI | `t_ai_usage` | AI 调用用量记录 |
+| AI | `t_ai_image` | 图片记账上传的截图及其解析摘要 |
+| AI | `t_ai_image_transaction` | 图片与解析生成交易的关联 |
 | 通知 | `t_notification_config` | 每用户一条的提醒配置 |
 | 通知 | `t_notification_channel` | 通知渠道 |
 | 通知 | `t_notification_log` | 通知发送日志 |
@@ -34,7 +37,9 @@
 | t_user | 1 : N | t_category | user_id |
 | t_user | 1 : N | t_transaction | user_id |
 | t_user | 1 : N | t_tag | user_id |
+| t_user | 1 : N | t_channel | user_id |
 | t_user | 1 : N | t_rule | user_id |
+| t_user | 1 : N | t_ai_image | user_id |
 | t_user | 1 : N | t_notification_channel | user_id |
 | t_user | 1 : N | t_email_bill_config | user_id |
 | t_user | 1 : N | t_email_bill_sender_rule | user_id |
@@ -57,6 +62,10 @@
 | t_transaction | N : M | t_tag | 中间表 t_transaction_tag（联合唯一） |
 | t_category | 1 : N | t_rule | rule.category_id（命中目标分类） |
 | t_rule | N : M | t_tag | 中间表 t_rule_tag（联合唯一） |
+| t_ai_image | 1 : N | t_ai_image_transaction | image_id |
+| t_transaction | 1 : N | t_ai_image_transaction | transaction_id |
+
+> 交易记录通过 `channel` 编码关联渠道：内置渠道编码取自 `ChannelType` 枚举，自定义渠道编码取自 `t_channel.code`（用户内唯一），因此渠道改名不影响历史记录。
 
 ### 通知与邮箱账单
 
@@ -84,7 +93,7 @@
 | external_no | 外部账单交易号，导入去重 |
 | transaction_time | 交易发生时间 |
 | include_in_stats | 是否计入统计（默认 1） |
-| raw_data | 账单导入原始 JSON（手动记录为空） |
+| raw_data | 原始字段 JSON（账单导入的原始账单行，或图片记账由模型提取的原始字段；手动记录为空） |
 
 关键索引：唯一索引 `uk_user_external (user_id, external_no)` 实现导入去重；`idx_user_time (user_id, transaction_time)` 支撑按时间查询与统计。
 
@@ -97,6 +106,25 @@
 
 `name`、`enabled`、`sort_order`（优先级）、`type`、`keyword`、`min_amount`、`max_amount`、`category_id`。
 
+### t_channel（自定义交易渠道）
+
+| 字段 | 说明 |
+|---|---|
+| user_id | 所属用户 |
+| code | 渠道编码，后端生成（`CUSTOM_` + 随机串），稳定不变，交易记录按此关联 |
+| name | 渠道名称，用户可修改 |
+| sort_order | 排序序号，数值越小越靠前 |
+
+唯一索引 `uk_channel_user_code (user_id, code)`、`uk_channel_user_name (user_id, name)` 分别保证用户内编码与名称唯一。仅存放用户自建渠道，内置渠道由 `ChannelType` 枚举维护。
+
+### t_ai_config / t_ai_image
+
+- `t_ai_config`：每用户一条，含 `enabled`、`api_key`、`base_url`、`model` 与 **`vision_model`**（图片记账使用的视觉模型，默认 `deepseek-flash`）。
+- `t_ai_image`：图片记账上传的截图，一次上传可产生多条（最多 5 张），含 `user_id`、`file_path`（相对应用运行目录，落盘于 `data/ai-images/`）、`mime_type`、`file_size`、`width`、`height`、`model`（解析所用视觉模型）、`summary`（识别摘要）、`record_count`（该图识别出的记录数）。
+- `t_ai_image_transaction`：图片与交易记录的关联，含 `image_id`、`transaction_id`，唯一索引 `uk_ai_image_transaction (image_id, transaction_id)`；每笔记录按模型标注的来源图分别建立关联。
+
+> **去重键**：图片记账与批量导入使用「收支类型 + 金额 + 交易时间（到秒）」作为业务去重键（`TransactionDedupUtils`），用于标记疑似重复并在导入时跳过，弥补这类记录没有外部交易号的不足。
+
 ### t_user_preference
 
 按用户存储的键值偏好：`pref_key` 为偏好键（如 `billSourceIncludeInStats`、`excludedDisplayStyle`），`pref_value` 为标量字符串或 JSON。唯一索引 `uk_user_pref (user_id, pref_key)` 保证每个用户每个偏好仅一条。未配置时由应用回退系统默认值。
@@ -129,5 +157,5 @@ IMAP 连接信息（`host`/`port`/`use_ssl`/`username`/`password`/`folder`）、
 ## 初始化与迁移
 
 - 应用启动时由 `SchemaInitializer` 执行对应建表脚本（幂等）。
-- 建表脚本只做 `CREATE TABLE IF NOT EXISTS`，无法修改已有库的列；需要就地变更列名时由 `SchemaMigrator` 在启动/切换数据源时**幂等迁移**（如 `t_transaction.payment_method` → `channel`，MySQL 用 `information_schema`、SQLite 用 `PRAGMA table_info` 检测）。
+- 建表脚本只做 `CREATE TABLE IF NOT EXISTS`，无法修改已有库的列；需要就地变更列名或新增列时由 `SchemaMigrator` 在启动/切换数据源时**幂等迁移**（如 `t_transaction.payment_method` → `channel` 改名、`t_ai_config.vision_model` 加列；MySQL 用 `information_schema`、SQLite 用 `PRAGMA table_info` 检测列是否存在）。
 - 新用户注册时由 `DefaultDataInitializer` 初始化默认分类、标签与邮箱发件人规则。