功能清单
本文档列出 TrailSnap（行影集）的完整功能列表，帮助你快速了解应用的所有能力。
如何理解功能状态
下方功能以当前项目能力为准。需要 AI 服务、外部模型或较高硬件资源的功能，会在说明中标出；路线图中的能力请以“待开发功能”为准，不应视为当前版本承诺。
当前能力与使用条件
| 能力 | 当前状态 | 使用条件 / 注意事项 |
|---|---|---|
| 照片浏览、相册、时间轴、元数据 | 可用 | 需先完成照片导入或扫描 |
| 人脸、OCR、场景分类、相似/重复检测 | 可用 | 需要 AI 服务；处理时间受图库规模和硬件影响 |
| 地图、足迹、5A 景区 | 可用 | 依赖照片定位信息和地图配置 |
| 火车票、飞机票等票据能力 | 可用 | 识别效果依赖照片清晰度与票据类型 |
| AI 助手、外部模型、Agent CLI | 可选 | 需配置模型或 Token；外部模型可能传输数据到服务商 |
| 自动 Vlog、智能精修等增强创作 | 规划中 | 不应作为当前版本的可用能力 |
1. 相册管理
1.1 基础功能
| 功能 | 说明 |
|---|---|
| 照片上传 | 支持多文件上传，自动生成缩略图 |
| 照片浏览 | 瀑布流/网格视图，支持筛选和过滤 |
| 照片灯箱 | 全屏照片查看器，带导航功能 |
| 照片元数据 | EXIF 数据提取与展示 |
| Live Photo | 支持 iPhone、Vivo、OPPO、小米等手机的实况照片 |
| 回收站 | 软删除功能，支持恢复已删除的照片 |
1.2 智能分类
| 功能 | 说明 |
|---|---|
| 人脸识别 | 基于 InsightFace 的人物识别与聚类 |
| 场景分类 | 自动分类为夜景、宠物、美食、自拍等场景 |
| OCR 识别 | 从照片中提取文字信息 |
| 相似照片检测 | 查找视觉上相似的照片 |
| 重复照片清理 | 基于哈希值的重复照片检测与清理 |
| AI 照片分析 | AI 生成照片描述和评分 |
2. AI 能力
| 功能 | 说明 |
|---|---|
| AI 助手对话 | 与 AI 大模型对话，智能检索相册内容 |
| 智能相册生成 | 根据描述自动生成相册（如"我在海边的自拍"） |
| 那年今日 | AI 推荐往年今天最具回忆价值的照片 |
| 智能搜索 | 支持按人物、内容、时间、地点等维度搜索 |
| 内置 AI 连接 | 开箱即用的内置多模态模型（MiniCPM-V-4_6），无需额外配置 |
| 本地 LLM 托管 | 支持通过 llama.cpp 托管自定义模型，数据不出本机 |
| 多模型支持 | 支持连接多个 AI 大模型（OpenAI、Ollama 等） |
3. 足迹与地图
| 功能 | 说明 |
|---|---|
| 足迹地图 | 在交互式地图上查看所有照片 |
| 点亮的城市 | 统计并展示去过的城市，支持省/市/区县级别 |
| 去过的景区 | 追踪去过的 5A 级景区，支持添加自定义景区 |
| 足迹时间轴 | 按时间轴展示不同地点的照片 |
| 轨迹视图 | 将一段时间内的地点连接起来，展示移动轨迹 |
| 离线地图 | 支持下载多国离线地图数据 |
4. 行程票据
4.1 火车票
| 功能 | 说明 |
|---|---|
| 火车票识别 | OCR 自动识别照片中的火车票信息 |
| 火车票管理 | 增删改查火车票记录 |
| 纸质票样式 | 仿真火车票展示（红票/蓝票样式） |
| 火车票导出 | 支持导出为 PNG、CSV、JSON 格式 |
4.2 飞机票
| 功能 | 说明 |
|---|---|
| 飞机票识别 | 识别照片中的行程单截图 |
| 飞机票管理 | 增删改查飞机票记录 |
| 机票统计 | 按城市、距离、时长等维度统计 |
4.3 票据统计
| 功能 | 说明 |
|---|---|
| 年度票据报告 | 出行统计摘要 |
| 城市统计 | 去过的城市及照片数量 |
| 距离统计 | 旅行总里程 |
| 乘客筛选 | 按乘客筛选票据记录 |
5. 相册类型
| 相册类型 | 说明 |
|---|---|
| 普通相册 | 传统相册功能，按时间线组织 |
| 智能相册 | AI 根据描述自动生成 |
| 人物相册 | 人脸识别后的人物照片集合 |
| 位置相册 | 按地理位置组织的照片 |
| 场景分类相册 | 按场景类型（夜景、美食等）分类 |
| 条件相册 | 支持按标签、场景、人物、地点等条件筛选生成 |
6. 年度报告
| 功能 | 说明 |
|---|---|
| 照片墙 | 年度照片拼图展示 |
| 照片日历 | 按日期展示年度照片 |
| 城市榜单 | 去过的城市排名 |
| 景区榜单 | 去过的景点排名 |
| 行程时间轴 | 年度行程时间线 |
| 线路里程 | 旅行线路与总里程 |
| 季节分析 | 春夏秋冬各季节照片统计 |
| 消费统计 | 机票、火车票消费统计 |
| 最佳照片 | 年度 AI 评分最高的照片 |
7. 工具箱
| 功能 | 说明 |
|---|---|
| 照片批量转移 | 将照片批量移动或复制到指定目录 |
| 照片自动整理 | 按时间（年/月/日）、人物、类别、地点整理到对应目录，支持平铺或递归目录结构 |
| 修改照片元数据 | 支持根据文件名修改图片的拍摄时间 |
| 相似照片清理 | 查找并清理视觉相似的照片 |
| 重复照片清理 | 清理完全重复的照片 |
| 质量清理 | 根据 AI 评分清理低质量照片 |
8. 用户管理
| 功能 | 说明 |
|---|---|
| 用户认证 | 登录、注册、密码重置 |
| 多用户支持 | 用户之间数据隔离 |
| 外部图库 | 添加外部文件夹作为数据源 |
| 令牌管理 | API 令牌配置，支持免登录访问 |
| 任务管理 | 后台任务监控与管理 |
9. 系统特性
| 功能 | 说明 |
|---|---|
| 侧边栏导航 | 可折叠的侧边栏，支持全局搜索 |
| 主题色自定义 | 天空蓝、翡翠绿、紫罗兰、玫瑰红、琥珀橙 5 种主题色，全局一键切换 |
| 深色模式 | 支持深色/浅色模式切换 |
| 响应式设计 | 移动端友好的界面 |
| Docker 部署 | 一键部署前端、后端、数据库、AI 服务 |
| SKILL 支持 | 可接入 OpenClaw、Claude Code、Hermes Agent 等平台 |
| ONNX Runtime | AI 服务全部迁移至 ONNX Runtime，移除冗余依赖 |
10. 待开发功能
| 功能 | 说明 |
|---|---|
| 图片编辑 | 裁剪、旋转、添加文字、添加标签等 |
| 自动旅行日志 | 根据照片自动生成旅行记录 |
| 朋友圈九宫格 | 自动生成可分享的九宫格图片和文案 |
| MCP 协议支持 | MCP 协议通信 |