# fastbudo

**Repository Path**: llliony/fastbudo

## Basic Information

- **Project Name**: fastbudo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

---
title: FastBudo
status: active
last_updated: 2026-11-02
---

# FastBudo

免费、本地运行的 macOS 工具，支持压缩、新建文件、剪贴板历史及截图贴图。Finder 右键子菜单直接选择 ZIP、7z 或 tar.gz；设置页管理 Mac 元数据偏好。自有代码采用 MIT，第三方压缩引擎保留原许可。

当前验证环境为 Apple Silicon / macOS 27.0.1。首版不承诺其他系统或 Intel 兼容。

## 使用

把构建得到的 FastBudo.app 放到 `~/Applications`，打开后点击菜单栏 ⌘ 图标 → 设置 → 通用 →“启用 Finder 右键扩展”，在系统设置中启用 FastBudo。选中文件后，使用 **FastBudo 压缩 → ZIP / 7z / TAR.GZ**：选中格式立即压缩，不弹出选项窗口，任务状态、取消和重试在菜单栏浮窗中查看。原生子菜单依赖 Finder Sync 扩展；未启用时仍可在右键“服务”中使用三个平铺格式入口，位置由 macOS 决定。需要开机自动启动时，打开设置 → 通用中的“开机自动启动”（默认关闭），登录后自动驻留菜单栏，不弹出窗口。

右键直接压缩不设密码，输出到原文件所在目录。元数据偏好在设置页管理。解压通过 Finder 的“打开方式 → FastBudo”发起；应用不会修改默认关联。旧版“更多压缩选项”窗口已移除，当前界面不提供加密压缩入口（引擎仍支持加密）。

在 Finder 文件夹空白处或选中文件/文件夹后右键，使用 **FastBudo 新建 → 文件夹 / TXT 文件 / MD 文件 / 自定义文件…**。新项目创建在当前目录（选择项的共同父目录），不进入选中的文件夹；跨目录搜索结果不显示新建。新建后在 Finder 原地编辑名称，不弹出 FastBudo 命名窗口；回车确认，Esc 保留默认名称。自动进入编辑需要在系统设置的辅助功能中允许 FastBudo，未授权时选中新项目后手动按回车。自定义项先创建“未命名.txt”，可在 Finder 修改名称及扩展名；已有同名项目不会覆盖，会自动编号并在 Finder 中选中新项目。设置页的“新建”可调整常用后缀（最多 12 项）。常用类型通过本机通知同步，扩展缓存最近的配置；修改时保持 FastBudo 运行并重新打开右键菜单。应用刚启动时若菜单尚未刷新，请关闭后再打开一次。

默认过滤 .DS_Store 和已识别、有对应文件的 AppleDouble 元数据，不修改源文件，保留普通隐藏文件及普通 ._ 文件。保留 Mac 属性仅支持无密码 ZIP。解压结果写入独立目录，重名自动编号，不覆盖已有内容。

菜单栏 ⌘ →“剪贴板…”支持历史、搜索、分类、收藏和快捷回复。默认关闭记录，Control+Shift+V 唤起；详见[剪贴板使用与验证](docs/guides/clipboard.md)。

菜单栏 →“截图”支持区域、窗口和指定显示器全屏截图；默认 Control+Shift+S 截图，Control+Shift+P 将剪贴板图片贴到屏幕。截图后可标注、复制、保存 PNG 或贴图；历史图片右键也可“贴到屏幕”。设置 →“截图与贴图”管理快捷键与权限入口。操作和限制见[截图与贴图](docs/guides/screenshot-pin.md)。截图功能已随 0.0.7 发布，发布范围与验证见[记录](docs/validation/2026-11-02-release-0.0.7.md)。

## 格式

| 格式 | 创建 | 解压 | 已验证组合 |
|---|---|---|---|
| ZIP | 是 | 是 | 普通 ZIP、AES-256、传统 ZipCrypto 解压、标准 .z01/.zip 分卷 |
| 7z | 是 | 是 | AES-256、加密文件名、.7z.001 连续分卷 |
| tar.gz | 是 | 是 | TAR + GZIP，内容及空目录 |
| RAR | 否 | 是 | RAR4/5、加密文件名、part1.rar 分卷、旧式 .rar/.r00 分卷 |

ZIP AES 不保证被系统自带解压器打开，ZIP 文件名仍可见；7z 密码模式默认加密文件名。分卷放在同一目录，ZIP 分卷从 .zip 打开，其他格式从首卷打开。不同条目使用不同密码的特殊归档未验证。

## 构建

需要 Xcode / Command Line Tools、Apple Silicon 和 Python 3（测试用）。无运行时 Homebrew 依赖。

```bash
bash scripts/build-engine.sh
xcodebuild -scheme FastBudo -configuration Release -derivedDataPath .build/xcode build
```

结果：`.build/xcode/Build/Products/Release/FastBudo.app`。引擎从仓库内固定版本源码构建；App 用 Xcode 标准资源复制阶段打包，不关闭构建脚本沙箱。

本机自用安装前运行 `bash scripts/sign-local.sh .build/xcode/Build/Products/Release/FastBudo.app`，复用已配置的钥匙串签名身份，不再使用 ad-hoc 覆盖本机版本。首次配置、权限边界和更新注意事项见[本机固定签名](docs/guides/local-signing.md)。

已提交 Xcode 工程可直接使用。修改 project.yml 时才需要本机已有的 XcodeGen，执行 `xcodegen generate` 后提交对应工程变化。首次构建前先运行引擎构建脚本，否则资源路径尚不存在。

## 验证

```bash
python3 -m unittest discover -s Tests/Bridge -v
xcodebuild test -scheme FastBudo -destination 'platform=macOS,arch=arm64' -derivedDataPath .build/xcode
python3 -m unittest discover -s Tests/Performance -v
python3 scripts/test-low-space.py
```

最后一条仅创建、挂载并清理独立的 64 MiB 测试磁盘映像，不填满用户主盘。测试样本来自固定的 libarchive 3.8.1 发布包，来源、许可及哈希见 Tests/Fixtures/manifest.json。

提交前运行 `python3 scripts/check-private-paths.py --staged`；日常检查工作树可省略参数。发布前对每个解包后的安装包运行 `python3 scripts/check-private-paths.py --artifact <产物目录>`，同时检查主应用、扩展及内置引擎的二进制内容。Release 构建移除调试符号中的本机路径；调试产物和 dSYM 不应随安装包上传。

## 首版边界

- 不浏览或编辑包内文件，不创建分卷，不创建 RAR，不递归解压。
- 拒绝符号链接、硬链接、设备条目和冲突路径；按保守的大小写及 Unicode 等价规则检测冲突。
- 展开超过 10 GiB、100,000 条目、1000 倍压缩比或大小未知时要求确认；确认不豁免路径安全。为控制内存，超过一百万条目或引擎输出超过 64 MiB 的归档仍可能被拒绝。
- 解压使用归档快照和独立暂存目录，需要额外空间；取消或失败时清理本任务暂存内容。异常退出后可在应用查看遗留 `.fastbudo-UUID` 目录，确认没有活跃任务后自行移到废纸篓。不要删除其他目录。
- 干净分享不是完整 Mac 备份。保留属性模式已经验证扩展属性与资源叉，但不承诺跨平台还原 Mac 专有信息。
- 0.0.10 以公开 Gitee 仓库 `llliony/fastbudo` 为发行源，检查更新、校验和与安装包均来自该仓库；双架构安装包、源码包和 SHA-256 清单见 [Gitee Releases](https://gitee.com/llliony/fastbudo/releases)，验证状态见[发布记录](docs/validation/2026-11-06-release-0.0.10.md)。0.0.11.beta 为 0.0.11 的 beta 预览（无功能改动），同样在该 Releases 与官网下载页提供、验证见[发布记录](docs/validation/2026-11-06-release-0.0.11.beta.md)；因更新检查器只接受三段正式版号，beta 包不进入应用内自动更新，仅供站点手动下载。当前仅在 Apple Silicon / macOS 27 实测。安装包未经 Developer ID 签名或 Apple 公证，系统可能拦截首次启动。在「设置 → 通用 → 版本更新」手动检查，已是最新版时显示提示，否则可点击「立即更新」下载、校验、安装并重启；开启“自动下载更新”后，启动时自动检查并直接下载安装重启，不再询问。更新使用同一发布的 SHA-256 清单校验安装包；无写入权限或正在处理归档时不会安装，自动更新在任务忙或失败时静默跳过、下次启动重试。旧应用保留在原应用旁的 `.fastbudo-update-*` 目录中；启动请求失败会尝试恢复，启动后崩溃需手动恢复旧版本。

## 文档与许可

- [变更日志](CHANGELOG.md)
- [架构文档](ARCHITECTURE.md)
- [开发规则](AGENTS.md)
- [文档索引](docs/README.md)
- [第三方声明](THIRD-PARTY-NOTICES.md)
- [MIT 许可证](LICENSE)

## 双架构发布构建

每次发布同时提供 arm64 与 x86_64 ZIP；包名、签名与验证要求见 [项目规则](AGENTS.md#文档与发布)。先完成并保存 ARM 产物，再构建 Intel，避免 `.build/engine` 的架构资源相互覆盖：

```bash
MACOSX_DEPLOYMENT_TARGET=14.0 bash scripts/build-engine.sh x86_64
xcodebuild -scheme FastBudo -configuration Release -destination 'generic/platform=macOS' -derivedDataPath .build/release-x86_64 ARCHS=x86_64 ONLY_ACTIVE_ARCH=NO MACOSX_DEPLOYMENT_TARGET=14.0 build
```

Intel 包最低部署目标为 macOS 14.0；交叉编译和签名检查不代表 Intel 真机验收。回到 ARM 开发前运行 `bash scripts/build-engine.sh arm64` 恢复引擎资源。