# Rightly

**Repository Path**: sampou/rightly

## Basic Information

- **Project Name**: Rightly
- **Description**: Rightly是一款 macOS 效率工具，通过 Finder 右键扩展 + 菜单栏 App 双重形态，为用户提供全面的文件操作和系统效率功能。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-02
- **Last Updated**: 2026-06-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Rightly

macOS 效率工具，通过 **Finder 右键菜单** 和 **菜单栏** 提供快捷文件操作、剪贴板管理和文本处理。

## 功能

### Finder 右键菜单

在 Finder 中右键点击文件或文件夹，快速执行以下操作：

**终端**
- 在 Terminal 中打开
- 在 iTerm2 中打开

**路径复制**
- 复制 POSIX 路径 (`/Users/...`)
- 复制 HFS 路径 (`Macintosh HD:Users:...`)
- 复制 file:// URL
- 复制文件名（含/不含扩展名）
- 复制文件内容

**压缩解压**
- 压缩为 ZIP
- 压缩为 TAR.GZ
- 解压缩（自动识别格式）

**新建文件**
- 新建文件夹
- 新建文本文件 (.txt)
- 新建 Markdown 文件 (.md)
- 新建 JSON 文件 (.json)

**哈希计算**
- MD5
- SHA1
- SHA256

### 菜单栏面板

通过全局快捷键 `⌥↩` 呼出浮动面板：

- **剪贴板** — 历史记录管理，支持搜索和快捷粘贴
- **文本工具** — 文本转换处理
- **搜索** — 快速搜索
- **工具箱** — 常用工具集合

## 安装

1. 下载最新版 [DMG](release/) 或 [ZIP](release/)
2. 将 Rightly.app 拖入 `/Applications`
3. 首次运行后，在系统设置 → 登录项与扩展中启用 Rightly 的 Finder 扩展

## 构建

```bash
# 生成 Xcode 项目
xcodegen generate

# Debug 构建
xcodebuild -project Rightly.xcodeproj -scheme Rightly -configuration Debug build

# Release 构建
xcodebuild -project Rightly.xcodeproj -scheme Rightly -configuration Release build

# 打包（ZIP + DMG），自动递增版本号
bash scripts/build-release.sh [fix_count]
```

## 架构

```
┌─────────────────┐     IPC      ┌─────────────────┐
│  RightlyFinder   │ ──────────→ │     Rightly      │
│  (Finder 扩展)    │  共享文件     │   (菜单栏主应用)   │
│  沙箱启用         │             │   沙箱禁用         │
└────────┬────────┘             └────────┬────────┘
         │                               │
         └──────────┬────────────────────┘
                    │
          ┌─────────┴──────────┐
          │   RightlyShared     │
          │   (共享 Framework)   │
          └────────────────────┘
```

| Target | 类型 | 沙箱 | 职责 |
|--------|------|------|------|
| RightlyShared | framework | — | 共享模型、常量、配置 |
| Rightly | application | 禁用 | 主应用，执行所有操作 |
| RightlyFinder | app-extension | 启用 | 构建右键菜单，通过 IPC 委托主应用执行 |

**IPC 通信流程：**

1. FinderSync 扩展构建右键菜单
2. 用户点击菜单项 → 扩展将 `IPCMessage` 写入 App Group 共享文件
3. 主应用 `IPCManager` 通过轮询检测到消息 → 分发给 `ActionEngine`
4. `ActionEngine` 在后台线程执行实际操作（Process、FileManager 等）

**关键约束：** FinderSync 扩展运行在沙箱中，不能执行 shell 命令或直接访问文件系统，所有操作必须通过 IPC 委托主应用。

## 配置

- **开机启动** — 通过 `SMAppService` API 实现
- **菜单栏图标** — 彩色 / 单色
- **快捷键** — 面板呼出 `⌥↩`，剪贴板 `⌥⇧C`
- **Finder 菜单项** — 可按分组或单独启用/禁用
- **剪贴板历史** — 最大条目数、忽略目录等

## 项目结构

```
Rightly/
├── Rightly/           # 主应用
│   ├── Sources/App/   # 入口、AppDelegate
│   ├── Sources/Core/  # IPC、ActionEngine、权限、剪贴板
│   └── Sources/UI/    # 设置页面、面板、HUD
├── RightlyFinder/     # Finder 扩展
│   └── Sources/       # FinderSync 菜单构建
├── RightlyShared/     # 共享框架
│   └── Sources/       # 模型、常量、配置、工具类
├── scripts/           # 构建脚本、DMG 背景
├── docs/              # PRD、技术设计、测试计划
└── project.yml        # XcodeGen 项目定义
```

## 许可证

MIT