# ff5-updater

**Repository Path**: johnpeng/ff5-updater

## Basic Information

- **Project Name**: ff5-updater
- **Description**: FF5家庭记账更新站
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-08
- **Last Updated**: 2026-11-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 发行版, 更新站, 工具

## README

# FF5 家庭记账

家庭记账、多人协作，多设备局域网直连同步，账目只留在自己设备上。

FF5 是一款面向家庭与个人的轻量记账工具，支持 **HarmonyOS、Windows、macOS**，同一局域网内多台设备配对后即可增量同步，数据不上传云端。

---

## 下载

| 平台 | 版本 | 安装包 | 下载 |
| --- | --- | --- | --- |
| **macOS**（Intel x64） | 5.7.0 | `FF5-5.7.0-macos-x64.dmg`（5.7 MB） | [下载](https://gitee.com/johnpeng/ff5-updater/releases/download/v5.7.0/FF5-5.7.0-macos-x64.dmg) |
| **macOS**（Apple Silicon arm64） | 5.7.0 | `FF5-5.7.0-macos-arm64.dmg`（5.4 MB） | [下载](https://gitee.com/johnpeng/ff5-updater/releases/download/v5.7.0/FF5-5.7.0-macos-arm64.dmg) |
| **Windows**（x64） | 5.7.0 | `FF5-5.7.0-windows-x64-setup.exe` | [下载](https://gitee.com/johnpeng/ff5-updater/releases/download/v5.7.0/FF5-5.7.0-windows-x64-setup.exe) |
| **Windows**（x64，MSI） | 5.7.0 | `FF5-5.7.0-windows-x64.msi` | [下载](https://gitee.com/johnpeng/ff5-updater/releases/download/v5.7.0/FF5-5.7.0-windows-x64.msi) |
| **HarmonyOS** | 5.6.9 | 华为应用市场安装 | 已上架，搜索「FF5家庭记账」（5.7.0 待上架） |

> 校验值：[macOS x64 SHA256](https://gitee.com/johnpeng/ff5-updater/releases/download/v5.7.0/SHA256SUMS-macos-x64) ｜ [macOS arm64 SHA256](https://gitee.com/johnpeng/ff5-updater/releases/download/v5.7.0/SHA256SUMS-macos-arm64) ｜ [Windows SHA256](https://gitee.com/johnpeng/ff5-updater/releases/download/v5.7.0/SHA256SUMS-windows-x64)
> 全部安装包汇总在 [发行版 v5.7.0](https://gitee.com/johnpeng/ff5-updater/releases/tag/v5.7.0)。

---

## 安装方法

### macOS

1. 下载对应架构的安装包：Intel 芯片用 `FF5-5.7.0-macos-x64.dmg`，Apple Silicon 用 `FF5-5.7.0-macos-arm64.dmg`
2. 双击打开，把 **FF5** 拖入「应用程序」文件夹
3. 首次启动若提示"无法验证开发者"：在「访达」中右键点击 FF5 → 选择「打开」→ 再点「打开」即可
   - 或执行命令：`xattr -d com.apple.quarantine /Applications/FF5.app`
4. 系统要求：macOS 11 及以上（Intel / Apple Silicon 均为原生包）

### Windows

1. 下载 `FF5-5.7.0-windows-x64-setup.exe`（推荐），或使用 MSI 包 `FF5-5.7.0-windows-x64.msi`
2. 双击安装，按向导完成；首次启动如提示"未知发布者"或"Windows 已保护你的电脑"，选择"更多信息 → 仍要运行"
3. 系统要求：Windows 10 及以上（x64）；缺少 WebView2 时安装程序会提示安装
4. 数据目录：`%APPDATA%\cn.mx.ff5`，卸载不会自动删除

> 安装包未做代码签名，出现"未知发布者"提示属正常现象，可用 `SHA256SUMS` 校验文件完整性。详见 `downloads/windows/README.md`。

### HarmonyOS

通过**华为应用市场**搜索「FF5家庭记账」安装，当前线上版本 5.6.9，5.7.0 已构建完成待上架（新增 12 种语言支持）；支持手机、平板与 HarmonyOS PC（2in1），后续版本在应用市场内自动更新。
鸿蒙调试包为设备绑定签名，无法通过文件直接安装到其他设备，请勿从本仓库下载鸿蒙安装包。

---

## 功能特性

- **记一笔**：收入 / 支出，金额、科目、经手人、日期、备注一次填完
- **收支明细**：按月、年、类型、科目、经手人多维筛选，金额千分位展示
- **首页统计**：收支双色柱状图、经手人排行与占比、一级科目构成
- **年度预算**：按科目逐年设预算，一级科目自动汇总子科目，显示已用与达成率
- **家庭成员**：多人共同记账，统一汇总
- **多设备同步**：同一局域网配对直连，增量传输、加密通道，离线可记账
- **多语言**：简体中文、繁体中文、英语、日语、韩语、法语、德语、西班牙语、葡萄牙语、俄语、阿拉伯语、印地语，随系统语言自动切换，未匹配时使用英语
- **数据自持**：账目仅存本地数据库，不上传云端，无广告、无会员、无内购

---

## 版本记录

| 版本 | 平台 | 说明 |
| --- | --- | --- |
| 5.7.0 | HarmonyOS | 新增 12 种语言界面与内置科目本地化，随系统语言自动匹配、未匹配默认英语；多终端中转变更同步与断档自愈；同步周期调整为 10 秒；同步服务/自动同步默认开启；预算备注可编辑；密码框自动聚焦、弹窗高度自适应；成员性别中文展示；鸿蒙电脑默认 16:9 窗口 |
| 5.7.0 | macOS / Windows | 多终端中转变更同步与断档自愈；同步检测周期调整为 10 秒；首批提供 Apple Silicon 原生安装包 |
| 5.6.9 | HarmonyOS | 修复配对加入家庭时全量复制偶发失败、配对与自动同步并发冲突、多网卡设备记录到不可达地址等问题 |
| 5.6.8 | HarmonyOS | 修复明细页同一天增删记录后列表不刷新、表单弹窗残留上次输入 |
| 5.6.7 | HarmonyOS | 首个应用市场上架版本 |
| 5.6.6 | macOS / Windows | 桌面端上一发布版本 |

---

## 隐私

不收集任何个人信息，不集成第三方 SDK，数据仅保存在本机。
完整条款见 [隐私政策](privacy.md)。

---

## 关于联网

记账、明细、预算等核心功能**无需联网**即可使用；仅"多设备同步 / 添加固定对端"需在同一局域网内联网。应用**不访问互联网上的任何服务器**，数据不经过开发者。

---

## 联系

- 开发者：John Peng
- 邮箱：josh_73_9@hotmail.com
- 问题反馈：本仓库 Issues 或应用市场评论区