Shots Studio 将你混乱的截图文件夹转变为一个智能、有序的归档库。
现在借助 Gemma 的设备端 AI（on-device AI），你可以在离线状态下处理截图——更快、更私密，且无需依赖网络。

---

什么是 Shots Studio？

是否曾因找不到急需的截图而焦头烂额？
Shots Studio 为你的截图集合带来AI 驱动的搜索、智能标签和无缝整理功能。

使用 Shots Studio，你可以：

• 按内容搜索截图——而不仅限于文件名。
• 使用 AI 自动添加或生成标签（tags）。
• 将相关截图归入自定义的合集（collections）。
• 利用最新的 Gemma 设备端模型，完全离线运行 AI，实现更快、以隐私优先的处理。

---

下载

---

核心功能

• AI 驱动搜索
  通过截图中包含的文字、物体或主题进行查找——即使从未打过标签。

• 智能标签
  让 AI 推荐标签，或手动添加自己的标签，保持整洁有序。

• 合集（Collections）
  将相关截图分组，便于快速浏览。

• 自主选择 AI 模式

  • Gemma 设备端 AI → 私密、离线、即时结果。
  • Gemini 2.0 Flash / Gemini 2.5 Pro → 云端加速或深度分析。

• 离线 AI 处理
  使用内置的 Gemma 模型无需联网即可处理截图——兼顾隐私与速度。

• 开源（Open Source）
  透明、社区驱动、可自由修改。

---

工作原理与隐私

默认情况下，Shots Studio 会将你的截图数据发送至 Google 的 Gemini API 进行云端分析。
如需优先保障隐私，请切换至 Gemma 设备端 AI——所有数据均不会离开你的手机。

更多详情：Gemini API 隐私政策。

---

为什么选择 Shots Studio？

• 清理相册杂乱 —— 告别无尽滚动。
• 即时访问 —— 像搜索笔记一样搜索截图。
• AI 可自定义 —— 云端或离线，由你决定。
• 隐私优先 —— 离线 AI 意味着数据不会离开你的设备。
• 社区共建 —— 100% 开源。

---

快速开始

1. 选择 AI 模式

   • 若使用云端 AI：获取 Gemini API 密钥。
   • 若使用离线 AI：在设置中启用 Gemma 设备端 AI（无需 API 密钥）。

2. 安装应用

   • 从 Releases 或 F-Droid 下载。
   • 在设备上安装 APK 文件。

3. 授予权限
   允许存储访问权限，以便扫描和处理截图。

4. 运行 AI 处理
   点击 AI ⚡ 按钮，分析截图并自动打标签。

---

贡献代码

我们欢迎任何形式的贡献——代码、新功能、Bug 修复或文档改进。
请参阅 CONTRIBUTING.md，或直接发起讨论/PR。

---

设置 Git Hooks

git config core.hooksPath scripts/git-hooks

克隆仓库后运行一次此命令，即可启用项目专属的 Git hooks。

Shots Studio 快速上手指南

环境准备

• 系统要求：Android 8.0（API 26）及以上
• 存储权限：需授予应用访问媒体文件的权限，用于扫描截图
• AI 模式选择：
  • 云端 AI（Gemini）：需网络连接 + Gemini API Key
  • 本地 AI（Gemma）：无需网络，依赖设备算力，推荐中高端 Android 设备以获得流畅体验

💡 国内用户建议优先使用 Gemma 本地模式，避免网络限制并保障隐私。

安装步骤

方式一：从 F-Droid 安装（推荐国内用户）

# 在 F-Droid 应用商店中搜索 "Shots Studio"
# 或直接访问：
https://f-droid.org/en/packages/com.ansah.shots_studio/

方式二：从 GitHub Releases 下载 APK

# 访问最新发布页（可配合代理加速）
https://github.com/AnsahMohammad/shots-studio/releases/latest

下载 shots-studio-*.apk 文件后，在手机上安装即可。

⚠️ 首次安装可能提示“未知来源”，请在系统设置中临时允许安装。

基本使用

1. 首次启动
   打开应用，授权存储权限，应用将自动扫描 Pictures/Screenshots 目录。

2. 选择 AI 模式

   • 进入 设置 → AI 引擎
   • 推荐选择 “Gemma On-Device”（完全离线，无需配置）

3. 处理截图
   返回主界面，点击右下角 ⚡ AI 按钮，应用将自动：

   • 分析截图内容
   • 生成智能标签（如“账单”、“聊天记录”、“错误提示”等）
   • 支持后续按内容关键词搜索

4. 搜索与整理

   • 在顶部搜索框输入文字（如“快递”、“密码”），即可找到相关截图
   • 长按截图可手动添加标签或归入自定义“合集（Collections）”

✅ 至此，你已成功启用 Shots Studio 的核心功能：离线 AI 智能管理截图。