Cloud-Ledger

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #docker #java #awesome #pytorch #mcp #ios

(★ 12)

一个单文件、零后端、本地优先、支持加密云同步的现代化个人记账应用。

Cloud-Ledger 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 💰 Cloud Ledger (云端记账本)

> **一个单文件、零后端、本地优先、支持加密云同步的现代化个人记账应用。**
>
> *A Single-File, Serverless, Local-First, Encrypted Personal Finance Tracker.*

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Vue.js](https://img.shields.io/badge/vue-3.x-green.svg)
![Tailwind](https://img.shields.io/badge/tailwind-3.x-38bdf8.svg)
![Upstash](https://img.shields.io/badge/sync-Upstash_Redis-orange.svg)

**Cloud Ledger Pro** 是一个运行在浏览器中的极简记账解决方案。它所有的代码都包含在一个 `.html` 文件中，无需安装 App，无需搭建复杂的服务器。数据默认保存在本地，同时支持通过免费的 Upstash Redis 数据库实现多端自动加密同步。

---

## ✨ 核心特性 (Features)

*   🚀 **极致轻量**：单文件 HTML，即点即用，部署简单（可托管在 GitHub Pages, Vercel 或本地直接打开）。
*   📱 **响应式设计**：完美适配手机端和电脑端，拥有类似原生 App 的流畅体验。
*   🔒 **隐私安全**：
    *   **本地优先**：数据首先存储在浏览器 LocalStorage。
    *   **端到端加密**：所有数据在上传云端前均使用 AES 算法加密，只有持有密码的你才能解密。
*   ☁️ **多端智能同步**：
    *   支持多设备（手机、电脑、平板）同时使用。
    *   **智能合并算法**：自动合并不同设备的记录，冲突时保留最新修改，绝不丢失数据。
    *   **自动保活**：内置心跳机制，防止免费的 Redis 数据库因长期不活跃被冻结。
*   📊 **强大的统计功能**：
    *   支持按 **本月/近3月/近1年/近10年** 等多维度筛选。
    *   支持 **自定义日期范围** 与 **分类/关键字** 组合查询。
    *   可视化环形图分析支出构成。
    *   列表支持分页显示 (20/50/100条)，流畅加载大量数据。
*   📂 **数据导入导出**：
    *   支持导出 JSON (完整备份)、Excel (XLSX)、CSV 格式。
    *   **智能导入**：支持导入第三方记账软件的 CSV/Excel 流水，自动去重并合并数据。
    *   **一键分享**：支持调用系统分享功能发送数据库文件。
*   🎨 **现代化 UI**：
    *   支持 **深色模式 (Dark Mode)**。
    *   美观的胶囊式分类管理，支持自定义收支分类。
    *   内置嵌入式计算器，记账更便捷。

## 📸 界面预览 (Screenshots)

## 🚀 快速开始 (Quick Start)

### 方式 1：直接使用 (本地模式)
1. 下载本仓库中的 `index.html` 文件。
2. 双击文件，用 Chrome、Safari、Edge 等现代浏览器打开。
3. 首次进入设置一个**访问密码**（用于数据加密，请务必牢记）。
4. 开始记账！数据将保存在当前浏览器的缓存中。

### 方式 2：部署到 GitHub Pages (推荐)
1. **Fork** 本仓库到你的 GitHub 账号。
2. 进入仓库的 `Settings` -> `Pages`。
3. 在 `Source` 下选择 `main` 分支（或 master 分支）并点击 Save。
4. 等待几分钟，GitHub 会生成一个专属链接（例如 `https://yourname.github.io/cloud-ledger`）。
5. 在手机和电脑上访问该链接即可使用。

## ☁️ 配置云端同步 (Upstash Redis)

为了实现多设备数据同步，我们需要一个免费的云端数据库。本应用使用 **Upstash** (Serverless Redis)。

1. **注册账号**：访问 [Upstash.com](https://upstash.com/) 并注册一个免费账号。
2. **创建数据库**：
    *   点击控制台的 **"Create Database"**。
    *   Name: `expense-tracker` (任意取名)。
    *   Region: 选择离你最近的地区（推荐 Global 或 AP 地区）。
    *   **关键点**：确保开启 **"REST API"** 选项。
3. **获取配置信息**：
    *   进入数据库详情页，向下滚动找到 **REST API** 区域。
    *   点击 `.env` 按钮或直接复制：
        *   `UPSTASH_REDIS_REST_URL` (以 https:// 开头)
        *   `UPSTASH_REDIS_REST_TOKEN` (一长串字符)
4. **在应用中填入**：
    *   打开记账本 -> 点击底部 **"设置"**。
    *   将 URL 和 Token 填入对应输入框。
    *   点击 **"测试连接"** 按钮，确保显示“连接成功”。
    *   点击 **"保存配置"**。

> **提示**：配置完成后，任何增删改操作都会自动触发后台静默同步。你也可以点击“从云端下载并合并”来手动拉取最新数据。

## 🛠️ 技术栈 (Tech Stack)

本项目完全基于原生 HTML5/JS 开发，通过 CDN 引入以下优秀库：

*   **[Vue.js 3](https://vuejs.org/)**: 核心响应式框架。
*   **[Tailwind CSS](https://tailwindcss.com/)**: 现代化实用主义 CSS 框架。
*   **[Chart.js](https://www.chartjs.org/)**: 优雅的数据可视化图表。
*   **[CryptoJS](https://cryptojs.gitbook.io/)**: AES 加密算法，保障数据安全。
*   **[SheetJS (XLSX)](https://sheetjs.com/)**: 强大的 Excel/CSV 文件读写与解析能力。
*   **[Day.js](https://day.js.org/)**: 轻量的日期时间处理库。
*   **[FontAwesome](https://fontawesome.com/)**: 精美的图标库。

## ⚠️ 数据安全与免责声明

1.  **密码即密钥**：你的所有数据都使用你设置的密码进行 AES 加密。**开发者无法找回你的密码，也无法解密你的数据**。请务必妥善保管密码。
2.  **数据归属**：所有数据仅存储在你自己的浏览器缓存和你配置的 Upstash 数据库中，不会上传到任何第三方服务器。
3.  **建议备份**：虽然有云同步，但建议定期在“设置”页面导出 JSON 文件进行本地备份。

## 🤝 贡献 (Contributing)

欢迎提交 Issue 或 Pull Request！如果你有更好的 UI 想法或功能建议，请随时分享。

1.  Fork 本仓库
2.  新建特性分支 (`git checkout -b feature/AmazingFeature`)
3.  提交更改 (`git commit -m 'Add some AmazingFeature'`)
4.  推送到分支 (`git push origin feature/AmazingFeature`)
5.  提交 Pull Request

## 📄 开源协议 (License)

本项目采用 [MIT License](LICENSE) 开源。

---

**如果觉得这个项目对你有帮助，请给一个 ⭐ Star！**

Cloud-Ledger

Cloud-Ledger 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Cloud-Ledger

Cloud-Ledger 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README