release-publisher

English | 中文

TrailSnap 是一个智能化的 AI 相册应用，致力于帮助用户轻松记录、整理和回顾自己的出行经历。通过强大的 AI 处理能力，让每一张照片和每一段旅程都成为值得珍藏的记忆。

未来每个人（至少每个家庭）都有一个属于自己的 AI 数据中心，而相册是数据中心的一个重要数据来源，它留存了你生活中的很多瞬间，TrailSnap 致力于将这些瞬间转化为有价值的记忆，它可以帮你默默地记录下相册里的车票、景点门票，可以帮你记录旅行中的所见所闻，可以帮你自动整理出可以发朋友圈的照片（甚至帮你准备好文案），可以帮你剪一段15s的短视频······。

把旅行从"拍过"变成"可留念、可展示、可分享"。TrailSnap 做的，是让每一段出行都值得珍藏。

所以，我给这个项目命名为 《行影集》，在这里你的数据才 "真正属于你"。

🎉 在线体验：不想自己部署？可以直接访问演示站体验完整功能 👉 https://demo.siyuan.ink（账号 / 密码均为 trailsnap）

✨ 核心特色

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

🧭 功能概览

Todo List

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

2025 年度报告

2025 相册年度报告

查看预览版

🚀 快速开始

其他问题请查看软件官网：https://trailsnap.cn

桌面端安装包（最简单）

前往 Releases 页面，下载对应平台的安装包并安装即可。

Docker部署一键安装脚本

TrailSnap 提供一键安装脚本，自动完成 Docker 安装、镜像加速配置和服务部署。

Linux / macOS / WSL2：

curl -fsSL https://trailsnap.cn/install.sh | bash

Windows PowerShell：

irm https://trailsnap.cn/install.ps1 | iex

更多用法（非交互模式、GPU 加速、自定义端口等）请参考 安装文档。

Docker 手动部署

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

2. docker-compose

docker-compose.yml 配置文件（注意修改挂载路径为本地路径，不然无法扫描本地照片目录），具体可以参考 TrailSnap 文档 ：

version: '3.8'

services:
  postgres:
    image: siyuan044/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 ]
    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" ]
    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
      - TRAILSNAP_ROOT_PATH=/api
      # 改为当前主机的局域网地址后，App 可自动发现此实例
      - TRAILSNAP_PUBLIC_URL=http://192.168.1.10:3180
    depends_on:
      postgres:
        condition: service_healthy

  ai:
    image: siyuan044/trailsnap-ai:latest
    restart: always
    stop_grace_period: 15s
    expose: [ "8001" ]
    networks: [ app-network ]
    volumes:
      - ./data:/app/data        # 挂载数据目录
    environment:
      - TZ=Asia/Shanghai
    healthcheck:
      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8001/health-check', timeout=3)"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 30s

  frontend:
    image: siyuan044/trailsnap-frontend:latest
    restart: always
    # 唯一需要对外开放的端口
    ports: [ "3180:80" ]
    depends_on: [ server ]
    networks: [ app-network ]
    environment:
      - TZ=Asia/Shanghai

networks:
  app-network:
    driver: bridge

1. 启动服务

docker-compose up -d

源码部署

源码部署

📚 文档

更多详细文档请参阅 TrailSnap 文档

🔍 其他

QQ交流群

微信交流群

致谢

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

• TRAE 本来不打算做完整的相册，奈何AI太强了，于是开了10$套餐年卡，从此告别手写代码.如果你的AI写代码能力一般，可以参考一下我的提示词
• Claude Code 没钱用官方模型，用它来帮我提交代码，写写文档啥的
• [豆包]