# 借钱记录app

**Repository Path**: yin_boning/borrowing-record

## Basic Information

- **Project Name**: 借钱记录app
- **Description**: 该App旨在为用户提供一个简单易用的工具，用于记录和管理借款与还款信息。所有数据保存在本地存储中，确保用户的隐私和数据安全。无论是借款、还款，还是相关备注，用户都可以方便地进行记录和查看。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-13
- **Last Updated**: 2025-11-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 借钱记录 App

一个简洁实用的借钱记录管理应用，帮助您清晰地管理借出和还款记录。

## 功能特性

- 📝 记录借出/还款信息
- 👥 按人员分类统计
- 📤 导出 CSV 文件（Excel 可打开）
- 📥 导入 CSV 文件
- 💾 本地数据存储
- 🎨 现代化 UI 设计

## 快速开始

### 安装依赖

```bash
npm install
# 或
pnpm install
```

### 运行项目

```bash
# H5 开发
npm run dev:h5

# Android 开发
npm run dev:app-android

# iOS 开发
npm run dev:app-ios
```

### 配置应用图标

**预览图标效果**：
在浏览器中打开 `static/icon-preview.html` 查看图标设计。

**配置步骤**：
1. 在 HBuilderX 中打开 `manifest.json`
2. 找到 "App 图标配置"
3. 选择 `static/app-icon.svg`
4. 保存配置

详细说明请查看 `ICON_SETUP.md`

### 打包 APK

**推荐使用 HBuilderX 云打包**：

1. 下载并安装 [HBuilderX](https://www.dcloud.io/hbuilderx.html)
2. 在 HBuilderX 中打开本项目
3. 配置应用图标（参考上面的步骤）
4. 点击：发行 → 原生 App-云打包
5. 选择 Android 平台，填写信息后打包
6. 打包完成后下载 APK

## 使用说明

### 添加记录

1. 点击首页右下角的 **+** 按钮
2. 选择类型（借出/还款）
3. 填写姓名、金额、日期、备注
4. 点击保存

### 查看统计

切换到"统计"标签页，查看：
- 按人员分类的统计
- 每个人的借出、已还、待收金额

### 导出数据

1. 在统计页面点击 **📤 导出**
2. 选择保存位置
3. 文件保存为 CSV 格式，可用 Excel 打开

### 导入数据

1. 在统计页面点击 **📥 导入**
2. 选择 CSV 文件
3. 自动导入记录

## 技术栈

- uni-app
- Vue 3
- Vuex 4
- Android SAF (Storage Access Framework)

## 图标配置详细说明

### 图标设计
- 📁 位置：`static/app-icon.svg`
- 🎨 设计：渐变紫色背景 + 金币 + 记账本
- 📐 尺寸：1024x1024 (SVG 矢量格式)

### 在线预览
在浏览器中打开 `static/icon-preview.html` 查看图标效果。

### 配置方法

**使用 HBuilderX（推荐）**：
1. 打开 `manifest.json`（会显示可视化界面）
2. 找到 "App 图标配置" 部分
3. 点击 "浏览" 选择 `static/app-icon.svg`
4. HBuilderX 会自动生成各种尺寸的图标
5. 保存配置

**在线工具**（如需转换为 PNG）：
- https://icon.wuruihong.com/ (一键生成各种尺寸)
- https://www.appicon.co/ (App 图标生成器)

## 注意事项

- 数据存储在本地，卸载应用会清除数据
- 建议定期导出备份数据
- Android 10+ 使用 SAF 进行文件操作
- 配置图标后需要重新打包才能生效

## 开发者

如需了解技术细节，请查看源代码注释。

## 许可证

MIT License

## 效果截图

![输入图片说明](static/258b97ed45a9bb05c9752f111af646b8.jpg)


![输入图片说明](static/4e94a45a6d43ecac89277d2ec167f3d0.jpg)