# TrailSnap

**Repository Path**: gitsharp/TrailSnap

## Basic Information

- **Project Name**: TrailSnap
- **Description**: TrailSnap (行影集) | AI-Powered open-source photo album for travel & life memories.（AI赋能的开源相册工具，珍藏旅行与生活点滴）
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: https://trailsnap.cn/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
    <a href="https://github.com/LC044/TrailSnap/stargazers">
        <img src="https://img.shields.io/github/stars/LC044/TrailSnap.svg" />
    </a>
    <a href="https://trailsnap.cn/" target="_blank">
        <img alt="GitHub forks" src="https://img.shields.io/github/forks/LC044/TrailSnap?color=eb6ea5">
    </a>
    <a href="https://trailsnap.cn/" target="_blank">
        <img src="https://img.shields.io/badge/TrailSnap-行影集-blue.svg">
    </a>
    <a target="_blank" href="https://trailsnap.cn/">
        <img alt="Hits" src="https://hits.b3log.org/LC044/trailsnap.svg">
    </a>
    <a href="https://trailsnap.cn/" target="_blank">
        <img src="https://img.shields.io/github/license/LC044/TrailSnap" />
    </a>
    <a href="https://github.com/LC044/TrailSnap/releases" target="_blank">
        <img alt="GitHub release (with filter)" src="https://img.shields.io/github/v/release/LC044/TrailSnap">
    </a>
    <a href="https://trailsnap.cn/" target="_blank">
      <img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/siyuan044/trailsnap-frontend?color=3eb370">
    </a>

[English](README.md) | **中文**

</div>

> TrailSnap 是一个智能化的 AI 相册应用，致力于帮助用户轻松记录、整理和回顾自己的出行经历。通过强大的 AI 处理能力，让每一张照片和每一段旅程都成为**值得珍藏的记忆**。
>
> 未来每个人（至少每个家庭）都有一个属于自己的 AI 数据中心，而相册是数据中心的一个重要数据来源，它留存了你生活中的很多瞬间，TrailSnap 致力于将这些瞬间转化为有**价值的记忆**，它可以帮你默默地记录下相册里的车票、景点门票，可以帮你**记录旅行中的所见所闻**，可以帮你自动整理出可以发朋友圈的照片（甚至帮你准备好文案），可以帮你剪一段15s的短视频······。
>
> 把旅行从"拍过"变成"可回味、可分享、可沉淀"。TrailSnap 想做的，正是让每一段出行都值得珍藏。
>
> 所以，我给这个项目命名为 **《行影集》**，在这里你的数据才 "真正属于你"。

<br/>
  <a href="https://trailsnap.cn">
    <img src="doc/image/demo.png" title="Main Screenshot">
  </a>
<br/>

## ✨ 核心特色

- **📷 智能相册**: 足迹地图、人物识别、智能分类、OCR识别、智能搜索。
- **🚆 行程记录**: 特有的火车票、行程、景区/演唱会门票管理功能，自动识别票据信息。（正在开发中）
- **🤖 AI 赋能**: 一句话让AI帮你生成旅行日记。（待开发）
  - AI自动剪视频生成VLOG
  - AI修图，自动识别高质量照片

![homepage](doc/image/homepage.png)

## 🧭 功能概览

| 功能 | 实现情况 | 描述                                                                |
| --- | --- |-------------------------------------------------------------------|
| **Agent**| √ | 与AI大模型进行对话，一键生成旅行日记                                             |
| **cli** | √ | 提供命令行界面，方便AI操作 |
| **SKILL** | √ | 支持接入OpenClaw、Claude Code等平台，实现自动任务执行                                 |
| **车票识别** | √ | 支持识别照片中的火车票和行程单，自动提取行程信息                                         |
| **年度报告** | √ | 自动生成2025年的出行统计报告，包括照片墙、出行城市、出行景点、行程时间轴、线路里程等                     |
| **AI分析** | √ | 使用大模型分析照片内容，生成描述和评分，做成电子画廊                                       |
| **那年今日** | √ | 查看往年今天的照片，按图片评分排序、自动播放往年值得回忆的照片                                  |
| **旅行日志** | 待开发 | 支持用户手动输入或 AI 识别出的行程信息，生成旅行日志                                     |
| **点亮的城市** | √ | 查看所有上传的照片中出现的城市，点击城市可以查看该城市的所有照片                                 |
| **去过的景区** | √ | 统计去过的5A级景区，点击景区可以查看该景区的所有照片，也可以自定义景区位置，自动筛选在景区范围内的照片             |
| 添加外部文件夹 | √ | 可以添加外部文件夹作为数据源，TrailSnap 会自动扫描并索引其中的照片和视频                        |
| live photo | √ | 支持iphone、vivo、oppo、小米等手机型号                                        |
| **时间轴** | √ | 丝滑的时间轴滚动效果                                                       |
| 足迹相册 | √ | 可以在地图上查看所有上传的照片，点击照片可以查看详情，也可以按省、市、区单独查看（支持列表视图、地图视图、时间轴视图、轨迹视图） |
| 人脸识别 | √ | 支持识别照片中的人物，自动添加人物标签                                              |
| 场景智能分类 | √ | 支持根据照片中的场景自动分类，例如：夜景、宠物、美食、自拍等                                   |
| 智能搜索 | √ | 支持根据照片中的人物、画面内容、时间等进行搜索                                          |
| 标签 | √ | 支持手动添加和删除标签，也可以根据 AI 识别结果自动添加标签                                  |
| 条件相册 | √ | 支持根据标签、场景、人物、地点等条件筛选照片，生成自定义相册                                   |
| 智能相册 | √ | 支持根据照片中的内容自动生成相册，例如："我和女朋友在海边的自拍"等                               |

### Todo List

- [x] 支持回收站功能，用户可以恢复已删除的照片。
- [ ] 支持MCP协议，用户可以通过MCP协议与TrailSnap进行通信。
- [x] 支持skills，可以接入OpenClaw、Claude Code等平台。
- [ ] 更丰富的行程管理功能，例如：支持演唱会门票、景区门票、酒店订单、电影票等。
- [ ] 更全面的AI能力，例如：支持AI自动剪视频生成VLOG、支持AI修图，AI生成旅行日记等。

## 2025 年度报告

2025 相册年度报告

[查看预览版](https://siyuan.ink/annual-report)

![年度报告](./doc/image/年度报告.jpg)

## 🚀 快速开始

### docker一键启动

1. 确保已安装 Docker 和 Docker Compose。

2. docker-compose

docker-compose.yml 配置文件（注意修改挂载路径为本地路径，不然无法扫描本地照片目录），具体可以参考 [TrailSnap 文档](https://trailsnap.cn/docs/guide/install.html) ：

```yml
version: '3.8'

services:
  postgres:
    image: pgvector/pgvector:pg18-trixie
    container_name: postgres_container
    restart: always
    environment:
      TZ: Asia/Shanghai
      POSTGRES_DB: trailsnap
      POSTGRES_USER: trailsnap
      POSTGRES_PASSWORD: trailsnap
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --lc-collate=C --lc-ctype=C"
      PGDATA: /var/lib/postgresql/data/pgdata
    networks: [ app-network ]
    ports:
      - "5532:5432"
    volumes:
      - ./pg_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U trailsnap -d trailsnap -p 5432"]
      interval: 5s
      timeout: 5s
      retries: 5
      start_period: 10s

  server:
    image: siyuan044/trailsnap-server:latest
    restart: always
    expose: [ "8000" ]
    ports: [ "8800:8000" ]
    networks: [ app-network ]
    volumes:
      - ./data:/app/data        # 挂载数据目录
      - F:\Photos:/app/Photos/  # 挂载本地照片目录
    environment:
      - TZ=Asia/Shanghai
      - DB_URL=postgresql://trailsnap:trailsnap@postgres:5432/trailsnap
      - RAILWAY_DB_URL=postgresql://trailsnap:trailsnap@postgres:5432/railway
      - AI_API_URL=http://ai:8001
    depends_on:
      postgres:
        condition: service_healthy
        restart: true

  ai:
    image: siyuan044/trailsnap-ai:latest
    restart: always
    expose: [ "8001" ]
    ports: [ "8801:8001" ]
    networks: [ app-network ]
    volumes:
      - ./data:/app/data        # 挂载数据目录
    environment:
      - TZ: Asia/Shanghai

  frontend:
    image: siyuan044/trailsnap-frontend:latest
    restart: always
    ports: [ "8082:80" ]
    depends_on: [ server ]
    networks: [ app-network ]
    environment:
      - TZ=Asia/Shanghai

networks:
  app-network:
    driver: bridge
```

3. 启动服务

```bash
docker-compose up -d
```

### 源码部署

[源码部署](http://localhost:5173/docs/dev/guide.html)

## 📚 文档

更多详细技术文档请参阅 [TrailSnap 文档](https://trailsnap.cn/docs/dev/guide.html)

## 🔍 其他

### QQ交流群

<img src="./doc/image/QQ1.jpg" alt="QQ交流群" width="200px">

### 致谢

本项目90%以上的代码由AI生成

- [TRAE](https://www.trae.ai/) 本来不打算做完整的相册，奈何AI太强了，于是开了10$套餐年卡，从此告别手写代码.如果你的AI写代码能力一般，可以参考一下我的[提示词](https://trailsnap.cn/docs/dev/prompt/2025-12-25.html)
- [Claude Code](https://www.claude.ai/) 没钱用官方模型，用它来帮我提交代码，写写文档啥的
- [豆包](https://www.doubao.com/) 满嘴胡话，但还是能提出建设性意见的
- [ChatGPT](https://chat.openai.com/) 用于教豆包做AI
- [InkTime](https://github.com/dai-hongtao/InkTime) InkTime 是一个可自托管的墨水屏电子相框。它用AI分析你的照片库，按值得回忆度打分，并按"历史上的今天"自动生成每日最具回忆价值的照片，让沉睡的记忆重新被看见

## 🌟 Star History

[![Star History Chart](https://api.star-history.com/svg?repos=LC044/TrailSnap&type=Date)](https://star-history.com/?utm_source=bestxtools.com#LC044/TrailSnap&Date)

## 🤝 贡献者

<a href="https://github.com/lc044/TrailSnap/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=lc044/TrailSnap" />
</a>

## 📖 贡献指南

欢迎提交 Pull Request！请阅读 [贡献指南](CONTRIBUTING.md) 了解开发环境设置、代码规范和提交流程。