# Jarvis

**Repository Path**: majorx/Jarvis

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-14
- **Last Updated**: 2026-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智慧管家平台 · Jarvis03

<p align="center">
  <strong>账单、物品、照片 —— 一个应用，把生活秩序打点好。</strong>
</p>

<p align="center">
  你的数据只留在你的电脑里。可迁移、可备份、可掌控。
</p>

---

## 为什么是 Jarvis？

记账 App 只能记账，相册 App 只能看照片。但真实生活是缠在一起的：一笔消费可能对应一件新入手的物品、一张票据或一次旅行照片。**Jarvis03** 把**记账、物品、图片**放进同一间「书房」：一个窗口、一套数据、一个你说了算的存储位置。

- **全在本地**：SQLite 单文件，不依赖云账号，不担心隐私。数据库路径可自定义，换电脑就拷走文件夹。
- **一个入口，三种秩序**：首页三张卡片——记好每一笔账、管好每一件物、理好每一张图。侧栏清晰，不打扰、不臃肿。
- **为「长期使用」而做**：深色/浅色主题、无边框窗口、通知与操作留痕、预算与愿望清单与冲动管控…… 细节为习惯服务，而不是为功能堆砌。

如果你在找一款**真正本地、可扩展、愿意自己部署或二次开发**的桌面管家，Jarvis03 想成为那个选项。

---

## 先看一眼界面

### 首页：三张卡片，三个世界

一键进入记账、物品、图片。没有多余步骤，没有弹窗打扰。

![首页](docs/screenshots/00.png)


### 记账：不止记一笔，更要看得清

![记账模块](docs/screenshots/03.png)
![记账模块](docs/screenshots/04.png)

### 物品：从「买了啥」到「还剩多少」

![物品管理](docs/screenshots/05.png)
![物品管理](docs/screenshots/06.png)

### 图片：网格、时间轴、地图、日历

![图片管理](docs/screenshots/07.png)
![图片管理](docs/screenshots/08.png)
![图片管理](docs/screenshots/09.png)

### 主题与布局（可选）

![主题与布局](docs/screenshots/01.png)
![主题与布局](docs/screenshots/02.png)
---

## 三大模块详解

### 记账模块：钱花在哪、存到哪，你说了算

**一句话**：不只记流水，更要看清趋势、管住冲动、存下愿望——数据 100% 在本地，路径与备份完全可控。

| 分类 | 功能 | 亮点 |
|------|------|------|
| **快速操作** | 财务总览、新增记账、扫描票据（预留） | 侧栏实时展示**本月支出分类**环形图与 **TOP3 分类**，记完账立刻看到占比变化 |
| **账单管理** | 账单列表与详情、分类管理、账户管理、定期账单 | **定期账单**支持月付/周付等周期，到期不遗漏；多账户、多支付方式，真实还原消费场景 |
| **统计分析** | 收入分析、支出分析、预算分析 | **ECharts 图表**：收入/支出趋势、预算执行率、分类占比一目了然，支持按年月筛选 |
| **特色功能** | 愿望清单、冲动管控、预算管理、AI 记账（预留） | **愿望清单**：目标金额 + 已存进度 + 预计达成时间，为梦想存钱；**冲动管控**：冷静期提醒，下单前多一道「刹车」；**预算管理**：分类预算、超支预警 |
| **数据与安全** | 数据安全、设置 | **数据库保存位置**可自定义：选择新文件夹即可复制迁移，换电脑数据跟着走；**导出 Excel/CSV/JSON**、**自动备份**与从备份恢复，重要操作写入**通知中心**可追溯 |

---

### 物品管理模块：家里有什么、快过期了没，一屏看清

**一句话**：从「买了啥」到「还剩多少」「日均花多少」「啥时候该补货」——支持列表/网格/详情多种视图，右侧实时展示分类资产占比与统计。

| 分类 | 功能 | 亮点 |
|------|------|------|
| **快速操作** | 物品总览、新增物品 | 新增时支持**名称、类别、购买日期、价格、数量、保质期/使用周期、低库存阈值、标签、备注**，一次录入长期有效 |
| **物品管理** | 物品列表、分类管理 | **列表 / 网格 / 详情**自由切换；分类管理自定义类别，资产按类聚合 |
| **统计分析** | 资产统计、成本分析 | **资产统计**：分类总价值、占比环形图；**成本分析**：自动算**日均成本**、消耗趋势，钱花在哪儿更清晰 |
| **提醒管理** | 临期提醒、低库存提醒 | **临期提醒**：保质期/使用周期临近或已过期，一页列出，带角标数量；**低库存提醒**：低于设定阈值自动上榜，补货不靠脑子记 |
| **设置** | 库存与显示相关设置 | 右侧栏可折叠，展示**分类资产占比图**与**分类统计列表**，随时掌握家当分布 |

---

### 图片管理模块：按时间、按地点、按相册，怎么找都顺手

**一句话**：本地图库不依赖云、不担心隐私；网格/日历/地图多视角浏览，相册与标签自由组织，收藏与回收站、搜索与幻灯片一应俱全。

| 分类 | 功能 | 亮点 |
|------|------|------|
| **快速操作** | 照片总览、导入照片、日历检索 | **总览**展示月度照片统计与存储空间；**导入**从本地目录批量入库，支持 EXIF、缩略图；**日历检索**点选某天直达当日照片 |
| **照片浏览** | 网格视图、地图视图 | **网格**：缩略图瀑布流，支持时间轴式分组；**地图**：按拍摄地理位置落点，旅行照片按地点回顾 |
| **相册管理** | 我的相册、收藏、最近添加 | 自定义相册、**私密相册**、**收藏**、**最近添加**，多维度整理；照片可归属多相册、多标签 |
| **工具** | 搜索、标签管理、回收站、设置 | **搜索**按关键词/标签/时间筛选；**标签管理**统一打标签；**回收站**误删可恢复；从预览可进入**幻灯片**沉浸浏览 |
| **右侧统计** | 月度照片统计、存储空间 | 右侧栏展示**月度照片数量**柱状图、**总大小**与**收藏数量**，数据感十足 |

---

## 你会用到的能力（按场景说）

| 场景 | Jarvis03 能做什么 |
|------|-------------------|
| **想搞清楚钱花哪儿了** | 快速记账 + 分类/账户/支付方式，收入/支出/预算分析图表，定期账单不遗漏。 |
| **想管住手、存下钱** | 预算管理、愿望清单与存款进度、冲动管控（冷静期提醒）。 |
| **想数据永远在自己手里** | 数据库单文件、路径可改、可复制迁移；导出 Excel/CSV/JSON、自动备份与恢复。 |
| **想管好家里的东西** | 物品录入与分类、资产统计、成本与日均消耗、临期与低库存提醒。 |
| **想照片不乱、又好找** | 导入本地照片、相册与标签、网格/时间轴/地图/日历/幻灯片、收藏与回收站、搜索。 |
| **想晚上用着不刺眼** | 深色/浅色主题切换，写入偏好，全局一致。 |
| **想重要操作有据可查** | 顶部通知中心、重要操作自动写入通知、Toast 与确认框统一交互。 |

---

## 技术栈（为长期维护与二次开发而选）

- **前端**：Vue 3（Composition API + `<script setup>`）+ TypeScript + Vue Router + Pinia + Vite + ECharts / vue-echarts  
- **桌面**：Electron 30.x + electron-builder（Windows NSIS、macOS dmg、Linux）  
- **数据**：better-sqlite3，单文件 `Jarvis.db`，默认在应用 userData 下的 `Jarvis` 目录，可在「数据安全」中修改路径并迁移。

---

## Release 下载

当前版本：**v1.0.0**

请前往 [Releases](https://gitee.com/majorx/Jarvis/releases/tag/v1.0.0) 页面下载对应平台的压缩包。

| 系统 | 下载文件 | 运行方式 |
|------|----------|----------|
| **Windows** | `win-unpacked.rar` | 解压后双击目录内的可执行文件运行 |
| **Linux** | `linux-unpacked.rar` | 解压后进入该目录，在终端执行：`./jarvis --no-sandbox` |

---

## 快速开始

**环境**：Node.js 建议 v20+（LTS），系统支持 Windows / macOS / Linux。

```bash
git https://gitee.com/majorx/Jarvis.git
cd Jarvis03
npm install
npm run dev
```

**打包安装包**：

```bash
npm run build
```

产出在 `release/<version>/`（如 Windows 的 `.exe`、macOS 的 `.dmg`、Linux 的 `linux-unpacked`）。仅打 Linux 可用 `npm run build:linux`。

**若 better-sqlite3 报错**（如 NODE_MODULE_VERSION 不匹配）：执行 `npm run rebuild`，必要时删掉 `node_modules` 后重新 `npm install` 再 `npm run rebuild`。

---

## 数据库与路径

- **默认路径**：Windows `%APPDATA%/Jarvis/Jarvis/Jarvis.db`，macOS `~/Library/Application Support/Jarvis/Jarvis/Jarvis.db`，Linux `~/.config/Jarvis/Jarvis/Jarvis.db`。  
- **自定义**：记账模块 → 数据安全 → 「数据库保存位置」：选择新文件夹可复制当前库并切换；「恢复默认」只改回默认路径（不复制，相当于新库）。配置写在 userData 的 `db-path.json`。

---

## 项目结构（便于二次开发）

```
Jarvis03/
├── electron/              # 主进程、preload、SQLite 与 IPC
│   ├── main.ts, preload.ts
│   └── db/sqlite/        # 表结构、services、ipc
├── src/
│   ├── views/            # 首页、记账/物品/图片视图
│   ├── components/       # common、accounting、inventory、photo
│   ├── composables/      # useToast、useConfirm、usePhotoQuery 等
│   ├── stores/, router/
│   └── ...
├── docs/screenshots/     # 截图放这里
└── build/                # 应用图标
```

---

## 常见问题

- **better-sqlite3 加载失败** → `npm run rebuild` 或 `npx electron-rebuild`，必要时重装依赖再 rebuild。  
- **Windows 打包 icon 报错** → 确保 `build/icon.ico` 为合法 ICO（可从 `build/icon.png` 生成多尺寸 .ico）。  
- **改数据库路径后看不到原数据** → 「选择文件夹」会复制并切换；「恢复默认」不复制，只切回默认路径。要保留数据请先备份或先用「选择文件夹」迁移。

---

## 路线图

- **已完成**：记账（含预算、愿望清单、冲动管控、分析、数据安全与路径）、物品（录入、统计、提醒）、图片（导入、多视图、相册与标签）、全局主题与帮助/反馈。  
- **计划中**：AI 记账、扫描票据（OCR）、物品批量导入、导出增强、云端同步、多语言等。

---

## 反馈与贡献

欢迎 Issue 和 Pull Request。若 Jarvis03 对你有用，不妨点个 Star，让更多人看到「数据在本地」的另一种可能。

- 邮箱：majorx@yeah.net  
- 微信：Dan7752999O_o  
- Gitee：https://gitee.com/majorx/Jarvis  

---

## 许可证

MIT License，详见 [LICENSE](LICENSE)。

---

<p align="center">
  <strong>智慧管家平台 (Jarvis03)</strong> — 记账、物品、图片一体，数据在本地，路径你说了算。
</p>