# S - 智能截图助手
## 项目概述
S 是一个 macOS 应用,帮助用户快速截取屏幕内容并使用 AI 进行智能分析。只需三指双击屏幕即可开始捕获,AI 会自动识别截图内容并整理成结构化笔记,支持保存到 Notion 等平台。
**核心价值**:让截图内容变得可搜索、可整理、可复用。
## 安装/运行步骤
### 开发者安装
1. **克隆项目**
```bash
git clone [项目地址]
cd S
```
2. **安装依赖**
- 使用 Xcode 14+ 打开 `S.xcodeproj`
- Xcode 会自动下载所需的依赖包
3. **添加 Sparkle(可选,用于自动更新)**
```
File → Add Package Dependencies...
URL: https://github.com/sparkle-project/Sparkle
```
4. **运行应用**
- 在 Xcode 中选择 `S` scheme
- 点击 Run (⌘+R)
### 普通用户安装
1. 下载 `S.app` 文件
2. 拖拽到应用程序文件夹
3. 首次运行可能需要允许权限
## 主要功能
### 📸 智能截图
- **三指双击触发** - 在任意界面快速截图
- **自动 AI 分析** - 识别文字、图片、界面元素
- **结构化输出** - 自动分类为笔记和任务
### 📝 内容管理
- **收藏夹** - 美观的卡片式界面展示所有截图
- **Notion 同步** - 一键保存到 Notion 数据库
- **搜索过滤** - 按类型、时间快速查找
### 🔄 自动更新
- **Sparkle 集成** - 自动检查并安装更新
- **安全签名** - EdDSA 签名确保更新安全
## 技术栈
### 前端界面
- **SwiftUI** - 现代化的声明式 UI 框架
- **AppKit 混合** - 处理系统级功能(菜单栏、窗口)
### AI 服务
- **Gemini API** - Google 的多模态 AI 模型
- **VLM (Vision Language Model)** - 理解图片内容
### 数据存储
- **本地存储** - Application Support 目录保存截图和历史
- **UserDefaults** - 用户偏好设置
- **JSON** - 轻量级数据序列化
### 认证服务
- **OAuth 2.0** - 安全的第三方登录
- **Notion API** - 连接 Notion 工作区
- **Supabase** - 用户认证(可选)
### 自动更新
- **Sparkle 2.x** - macOS 标准的自动更新框架
- **EdDSA 签名** - 安全的更新验证
## 使用流程
1. **启动应用** - 菜单栏出现 ✨ 图标
2. **三指双击** - 在任意位置截图
3. **AI 分析** - 自动识别内容并分类
4. **查看结果** - 在收藏夹中查看结构化笔记
5. **导出保存** - 同步到 Notion 或其他平台
## 开发说明
- **最低系统要求**:macOS 12.0+
- **开发工具**:Xcode 14+
- **架构模式**:MVVM + Service Layer
- **设计风格**:日式现代极简主义
## 文件结构
```
S/
├── S/
│ ├── App/ # 应用入口和生命周期
│ ├── Views/ # UI 界面
│ ├── Services/ # 业务逻辑服务
│ ├── Models/ # 数据模型
│ └── Resources/ # 资源文件
├── S.xcodeproj # Xcode 项目文件
└── README_CN.md # 本文档
```
## 许可证
本项目采用 MIT 许可证。详见 LICENSE 文件。
---
**S - 让每一张截图都变得有价值** ✨