生财有迹(Wealth Tracker)：开源个人资产分析工具，AI赋能财务洞察与安全管理

一、生财有迹（Wealth Tracker）是什么？

生财有迹（Wealth Tracker）是一款开源免费的个人资产分析应用程序，专注于解决个人资产分散于多平台的管理难题。它通过简洁易用的操作界面、丰富的数据可视化功能，帮助用户快速记录、展示资产状况并洞悉变化趋势；同时融合AI技术提供适配性财务建议，支持本地部署保障数据隐私安全，兼容多语言使用。无论是普通上班族、投资者还是注重数据安全的用户，都能通过该工具轻松掌握财务现状，无需专业财务知识即可实现高效资产管理。

在当今多元化的经济环境中，个人资产的存在形式日益复杂——银行存款、理财产品、微信支付/支付宝等移动支付余额、公积金、医保账户、余额宝等货币基金、债券、股票、基金产品、房地产、贵金属，甚至部分用户的贷款、欠款等负债，这些资产和负债往往分散在各类金融账户和服务中。更关键的是，各账户数额实时变动，想要快速、准确地掌握个人总资产状况，成为许多人面临的现实挑战。

生财有迹（Wealth Tracker）正是为应对这一痛点而生的开源应用程序。它不纠结于单笔收支的琐碎细节，而是聚焦于账户余额及整体数额，通过简化操作流程，帮助用户揭示个人资产的整体变化趋势。其核心定位是“用户专属的资产跟踪与分析工具”，既要实现“全面记录并展示用户资产状况”的基础功能，又要通过AI能力结合资产特性与当前经济环境，为用户提供适宜的财务建议。

作为开源项目，生财有迹的源代码完全开放，支持用户自主选择部署环境，既保障了数据的私密性和安全性，又具备灵活的可扩展性。无论是想快速了解自身财务现状，还是需要长期跟踪资产变化、沉淀投资经验，这款工具都能提供高效、直观的解决方案，且无需用户具备复杂的财务知识。

二、功能特色

生财有迹围绕“易用性、安全性、实用性”三大核心，打造了多项贴合用户需求的功能，覆盖资产管理的全流程，从记录、可视化到分析、决策支持，形成完整闭环：

1. 简洁易用的操作体验，零基础上手

生财有迹完全摒弃了传统财务工具的复杂操作逻辑，设计了极简的用户界面和操作流程。用户无需具备专业的财务知识，只需通过几个简单的步骤，就能完成资产的记录、更新、分类等操作。无论是添加新的资产项目（如存款、股票、基金），还是修改已有资产的金额、标签，都能在直观的界面中快速完成，极大降低了资产管理的门槛，让普通用户也能轻松上手。

2. 丰富的数据可视化，资产状况一目了然

数据可视化是生财有迹的核心优势之一。它通过图表、图形等直观形式，将用户的资产状况、变化趋势、分类分布等信息可视化呈现，避免了枯燥的数字罗列。

• 资产分布可视化：通过树状图等图表，展示不同标签、不同类型资产的占比情况，让用户清晰知道自己的资产集中在哪些领域；

• 资产变化跟踪：支持查看最近28天、98天等不同周期的资产变化数据，并用百分比标注增长或下降幅度，如“最近28天 ↑8.12%”“最近98天 ↑13.86%”，帮助用户快速感知资产动态；

• 多维度趋势展示：针对存款、基金、股票、公积金、余额宝等不同资产类型，分别展示其变化趋势，便于用户针对性分析各类资产的表现。

3. 本地部署+密码保护，数据安全双重保障

对于个人财务数据而言，隐私和安全是首要需求。生财有迹从部署方式和访问控制两方面，为数据安全提供双重保障：

• 本地部署灵活性：用户可自主选择部署环境，无论是本地电脑、私人服务器还是其他设备，数据都存储在用户自己掌控的环境中，避免了第三方平台存储带来的泄露风险，确保数据私密性和安全性；

• 密码保护功能：支持设置访问密码，用户可通过配置环境变量启用该功能，有效防止未授权访问。同时，项目还提供PEPPER_SECRET配置项，为用户密码提供更强大的加密保护，进一步强化数据安全；

• 数据重置可控：支持通过环境变量配置是否允许重置数据库，用户可根据自身需求选择，避免误操作导致的数据丢失。

4. 开源架构+社区协作，功能持续迭代

生财有迹采用完全开源的代码架构，所有源代码均托管在GitHub上，欢迎全球开发者参与贡献。这种开源模式带来了两大优势：

• 透明可信：用户可查看全部源代码，了解数据处理逻辑、功能实现方式，无需担心隐藏的安全隐患或数据泄露风险；

• 持续优化：社区开发者可通过提交PR、反馈Issues等方式，为项目添加新功能、修复bug，推动工具不断完善。目前项目已更新至3.10.0版本，后续将根据用户反馈持续迭代。

5. 多语言支持，适配全球用户

考虑到不同地区用户的使用需求，生财有迹已支持多种语言，包括简体中文、繁体中文、英文、法文、日文。后续项目团队还将根据用户反馈，添加更多语言选项，让全球用户都能无障碍使用这款工具。

6. AI财务建议，科学指导决策

生财有迹融合了AI技术，并非简单的资产记录工具，而是具备智能分析能力的财务助手：

• 个性化建议：结合每种资产的特性（如股票的波动性、基金的稳健性）和当前经济环境，为用户提供适宜的财务建议，而非通用化的模板内容；

• 适配不同场景：无论是资产配置优化、风险规避，还是投资方向参考，AI都能根据用户的资产状况给出针对性建议，帮助用户做出更科学的财务决策。

7. 财富见解记录，沉淀投资智慧

除了资产跟踪和分析，生财有迹还支持用户记录投资理财过程中的重要洞察与经验总结。这些内容将作为“智慧财富”沉淀下来，不仅能帮助用户回顾过往决策的得失，还能为未来的财务规划提供参考，形成“跟踪-分析-决策-沉淀”的完整闭环。

8. 标签分类+可视化，资产管理更精细

为了满足用户对资产精细化管理的需求，生财有迹设计了灵活的标签系统：

• 自由分类：用户可根据自身习惯为不同资产添加标签（如“短期理财”“长期投资”“应急资金”等），实现资产的个性化分类；

• 标签可视化：通过树状图等可视化图表，直观展示不同标签下的资产分布情况，让用户快速了解各类资产的占比，便于优化资产配置。

三、技术细节

生财有迹采用现代化的技术栈构建，前后端分离架构确保了功能的灵活性和扩展性，工程化工具的应用则提升了开发和部署效率。以下是详细的技术细节拆解：

1. 整体架构

项目采用前后端分离架构，分为客户端（client）和服务端（server）两大模块，通过HTTP接口实现数据交互。这种架构的优势在于前后端可独立开发、部署和迭代，同时便于后续功能扩展和维护。

2. 前端技术栈

前端聚焦于用户交互体验和数据可视化，采用轻量高效的技术组合：

• 核心框架：Svelte。作为新兴的前端框架，Svelte通过编译时技术将组件转换为高效的原生JavaScript代码，减少了运行时开销，让应用更轻量、响应更快，同时降低了样板代码的编写量；

• 构建工具：Vite。现代化的前端构建工具，具备快速冷启动、即时模块热更新等特性，极大提升了开发效率。前端默认运行在5173端口，开发时可通过http://localhost:5173访问；

• 样式解决方案：TailwindCSS + Flowbite + Flowbite-Svelte。TailwindCSS提供实用主义的CSS类，让开发者无需编写复杂CSS即可快速构建美观、响应式的界面；Flowbite和Flowbite-Svelte提供了丰富的预构建组件和模板，进一步加快了界面开发速度，同时保持了代码的可定制性和可维护性；

• 富文本编辑：tiptap。轻量、可定制的富文本编辑器，为“财富见解记录”功能提供支持，让用户能够轻松编辑和格式化文本内容；

• HTTP客户端：Axios。基于Promise的HTTP客户端，简化了前端与后端API的交互过程，支持请求拦截、响应处理等功能，确保数据交互的稳定性；

• 日期处理：Day.js。轻量级的JavaScript日期库，提供直观的API用于处理日期和时间，满足应用中资产变化时间、见解记录时间等场景的处理需求。

3. 后端技术栈

后端负责数据存储、业务逻辑处理和API提供，注重性能和稳定性：

• 运行环境：Node.js。高效的JavaScript运行环境，采用事件驱动、非阻塞I/O模型，能高效处理并发请求，适合构建轻量级后端服务；

• Web框架：Fastify。高性能的Node.js Web框架，相比传统框架具有更低的开销和更高的可扩展性，用于构建RESTful API，确保接口响应快速、稳定；

• 数据库：SQLite3。轻量级的嵌入式数据库引擎，无需额外配置即可使用，适合本地部署场景下的数据存储，简化了应用的部署和维护；

• ORM框架：Sequelize。强大的Node.js ORM框架，支持多种数据库，提供直观的API用于管理数据库关系和执行数据操作，简化了数据库开发流程，避免了直接编写SQL语句的繁琐；

• AI集成：OpenAI Node.js SDK。集成OpenAI等AI服务的API，为“AI财务建议”功能提供技术支持，实现与ChatGPT、xAI、月之暗面等AI服务的交互。

4. 工程化与部署工具

项目采用成熟的工程化工具链，确保开发、构建和部署的高效性：

• 包管理工具：pnpm。相比npm和yarn，pnpm具有更快的安装速度、更小的磁盘占用，同时支持workspace功能，便于管理多模块项目的依赖；

• 多包管理：Lerna@8.1。用于管理多包仓库的工具，配合pnpm workspace实现前后端模块的依赖管理和版本控制，简化了多模块项目的构建和发布流程；

• 容器化部署：Docker + Docker Compose。支持容器化部署，用户可通过Docker镜像快速启动应用，无需关注环境配置。Docker Compose则便于管理多容器应用，配置更易读和维护；

• 进程管理：pm2。强大的生产环境进程管理器，用于管理应用的生命周期（启动、停止、重启），同时提供监控和日志功能，便于用户了解应用运行状态。

5. 技术栈汇总表格

四、应用场景

生财有迹的功能设计贴合多种用户群体和使用场景，无论是个人还是家庭，无论是普通用户还是投资者，都能找到适合自己的使用方式：

1. 普通上班族：日常资产统筹与储蓄规划

普通上班族的资产多集中在银行存款、余额宝、公积金、工资卡等渠道，需求是清晰掌握“有多少钱”“钱都在哪里”“怎么存钱更合理”。

• 生财有迹可快速记录各类存款、货币基金等资产，通过可视化图表展示总资产和各渠道占比；

• 跟踪资产变化趋势，了解储蓄增长情况；

• AI财务建议可根据收入水平和支出习惯，推荐适合的储蓄方案（如应急资金配置、定期存款规划），帮助上班族稳步积累财富。

2. 投资者：多资产类型跟踪与投资决策辅助

投资者的资产往往涉及股票、基金、债券、贵金属等多种类型，需求是实时掌握各类资产的市值变化、整体收益情况，以及获得科学的投资建议。

• 通过标签分类功能，将不同投资产品（如“股票-科技股”“基金-指数基金”）分类管理，直观查看各类投资的占比；

• 资产变化趋势图可快速展示不同周期内的投资收益波动，帮助投资者判断投资效果；

• AI财务建议结合市场环境和资产特性，提供资产配置优化建议（如调整股票与基金的比例），同时支持记录投资见解，沉淀投资经验。

3. 自由职业者：多收入渠道资产整合管理

自由职业者的收入来源分散（如项目报酬、兼职收入、版权收益），资产可能分布在多个支付平台、银行账户中，需求是整合管理多渠道资产，掌握实际收入和资产状况。

• 生财有迹支持记录不同支付平台、银行账户的资产，实现多渠道资产统一管理；

• 标签分类可按“收入类型”“资产流动性”等维度划分，清晰了解不同收入对应的资产沉淀；

• 本地部署功能保障收入数据的隐私安全，避免敏感财务信息泄露。

4. 家庭用户：全家资产统筹与共同财务规划

家庭用户的需求是整合夫妻双方的资产（如共同房产、存款、投资），统筹家庭开支和未来规划（如育儿、养老、购房）。

• 可记录家庭各类共同资产和个人资产，通过标签区分“家庭共同资产”“个人资产”；

• 可视化展示家庭总资产和各类资产占比（如房产占比、存款占比）；

• 财富见解记录可用于记录家庭财务规划方案，AI建议可根据家庭收支情况推荐适合的理财方式（如教育金储备、养老投资）。

5. 注重隐私安全的用户：本地部署的私密资产管理

部分用户对财务数据隐私要求极高，不愿将数据存储在第三方平台，生财有迹的本地部署功能完美满足这一需求：

• 用户可将应用部署在本地电脑或私人服务器，数据完全由自己掌控；

• 配合密码保护功能，进一步防止未授权访问；

• 无需担心第三方平台数据泄露风险，安心管理个人财务。

6. 财务入门者：零门槛学习资产管理

财务入门者缺乏专业财务知识，对复杂的理财工具望而却步，生财有迹的简洁易用性使其成为入门首选：

• 无需专业知识，几步操作即可完成资产记录和管理；

• 数据可视化让财务状况直观易懂，帮助入门者建立对个人资产的清晰认知；

• AI财务建议和财富见解记录功能，可引导入门者学习科学的资产管理方法，逐步提升财务规划能力。

五、使用方法

生财有迹提供多种使用方式，包括在线体验、Docker部署、pm2部署和本地开发，用户可根据自身需求选择：

1. 在线体验（无需部署，快速试用）

为方便用户直观了解功能，项目提供在线演示版本，填充了模拟数据，无需部署即可体验：

• 体验地址：https://fund.lovejade.cn/

• 注意事项：这是公共演示环境，请勿输入任何真实的个人财务信息，避免信息泄露；

• 适用人群：想要快速了解工具功能，无需长期使用的用户。

2. Docker部署（推荐，快速便捷）

Docker部署是最推荐的方式，无需配置复杂环境，支持Windows、Mac、Linux等系统，分为docker-compose和docker run两种方式：

（1）docker-compose部署（推荐，便于管理）

步骤1：创建docker-compose.yml文件，复制以下内容（版本可根据实际情况调整）：

version: '3.8'
services:
 wealth-tracker:
  image: nicejade/wealth-tracker:latest
  container_name: wealth-tracker
  ports:
   - '8888:8888' # 端口映射，本地端口:容器端口
  volumes:
   - ./data:/app/data # 数据卷映射，本地目录存储应用数据
  restart: unless-stopped
volumes:
 data:

步骤2：在docker-compose.yml文件所在目录，打开终端执行以下命令启动服务：

docker-compose up -d

步骤3：访问应用。本地部署访问http://localhost:8888；服务器部署访问http://[Server-IP]:8888（可修改端口号，如将8888改为8080）。

（2）docker run部署（快速启动）

直接执行以下命令即可启动服务：

docker run -d -p 8888:8888 -v "$(pwd)/data:/app/data" nicejade/wealth-tracker:latest

参数说明：

• -d：后台运行容器；

• -p 8888:8888：端口映射；

• -v "$(pwd)/data:/app/data"：将容器内数据目录映射到本地，确保数据持久化。

（3）配置密码保护（可选）

如需启用密码保护，可添加环境变量配置：

docker run -d -p 8888:8888 \
 -e ALLOW_PASSWORD=true \ # 启用密码保护
 -e PEPPER_SECRET=your_secret_key \ # 自定义加密密钥
 -e CAN_BE_RESET=true \ # 允许重置数据库
 -v "$(pwd)/data:/app/data" \
 nicejade/wealth-tracker:latest

3. pm2部署（生产环境推荐）

pm2是生产环境进程管理器，适合需要长期稳定运行应用的用户： 步骤1：克隆项目仓库

git clone https://github.com/nicejade/wealth-tracker.git
cd wealth-tracker

步骤2：安装依赖工具（全局安装）

npm i pm2 pnpm lerna -g

步骤3：安装项目依赖

pnpm i

步骤4：构建并启动服务

npm run build
npm run start

相关命令：

• npm run stop：停止应用；

• npm run restart：重启应用；

• npm run logs：查看应用运行日志。

4. 本地开发（二次开发或调试）

适合有开发需求，想要自定义功能或参与项目贡献的用户： 步骤1：环境准备。需安装Node.js（版本≥16.*），推荐使用pnpm作为包管理工具； 步骤2：克隆仓库并安装依赖（同pm2部署的步骤1-3）； 步骤3：启动前端服务

cd client && npm start

前端默认运行在http://localhost:5173； 步骤4：启动后端服务

cd server && npm start

步骤5：修改代码后，前端会通过Vite热更新生效，后端需重启服务才能生效。

5. 部署方式对比表格

六、常见问题解答（FAQ）

1. 生财有迹是免费的吗？是否有收费版本？

生财有迹是完全开源免费的项目，所有核心功能（资产记录、数据可视化、AI财务建议、本地部署等）均无收费限制，也没有隐藏的付费功能或收费版本。用户可自由使用、部署和二次开发。

2. 我的财务数据会被泄露吗？数据安全有保障吗？

数据安全有双重保障：一是支持本地部署，数据存储在用户自己的设备或服务器上，不经过第三方平台；二是提供密码保护功能，可设置访问密码防止未授权访问。同时，项目开源透明，用户可查看源代码确认数据处理逻辑，无需担心隐藏的泄露风险。

3. 生财有迹支持记录哪些类型的资产？

支持记录多种类型的资产和负债，包括但不限于：银行存款、理财产品、微信支付/支付宝余额、公积金、医保账户、货币基金（如余额宝）、债券、股票、基金产品、房地产、贵金属、外部借款、贷款、欠款等。用户可通过标签分类功能，根据自身需求自定义资产类型。

4. 使用生财有迹需要专业的财务知识吗？

不需要。生财有迹的操作界面简洁易用，核心流程（记录资产、查看图表、添加标签）只需几步操作即可完成，无需任何专业财务知识。同时，AI财务建议会以通俗易懂的语言呈现，帮助普通用户理解和应用。

5. 能否导入现有资产数据？比如从银行APP、基金平台导出的数据？

目前项目暂未支持直接导入外部数据的功能，用户需要手动添加资产信息。如果有相关需求，可通过GitHub Issues向项目团队反馈，或参与项目开发提交相关功能PR。

6. 生财有迹支持多设备同步吗？

目前项目的核心部署方式是本地部署或服务器部署，多设备同步需通过访问同一部署地址实现（如服务器部署后，手机、电脑可通过浏览器访问同一IP地址）。暂不支持跨设备离线同步功能，后续可能根据用户反馈优化。

7. 生财有迹支持多语言，如何切换语言？

应用内置多语言支持（简体中文、繁体中文、英文、法文、日文），用户可在应用设置中找到语言切换选项，根据自身需求选择对应的语言。

8. 本地部署后，如何备份我的财务数据？

本地部署时，数据存储在映射的本地目录（如Docker部署的./data目录），只需备份该目录下的文件即可。如需恢复数据，只需将备份文件放回该目录，重启应用即可。

9. AI财务建议的准确性如何？可以完全依赖吗？

AI财务建议是结合资产特性和当前经济环境生成的参考性建议，旨在为用户提供决策思路，不能替代专业的财务顾问意见。用户在做出重要财务决策时，建议结合自身实际情况和专业人士的建议综合判断。

七、相关链接

• 项目GitHub仓库：https://github.com/nicejade/wealth-tracker

• 在线演示地址：https://fund.lovejade.cn/

八、总结

生财有迹（Wealth Tracker）作为一款开源免费的个人资产分析工具，精准切入了个人资产管理分散、复杂的痛点，通过“简洁易用+安全隐私+智能实用”的核心优势，为不同用户群体提供了高效的资产管理解决方案。它既具备资产记录、数据可视化、标签分类等基础功能，又融合了AI财务建议、财富见解记录等进阶功能，同时支持本地部署、多语言、密码保护等实用特性，兼顾了易用性和安全性。在技术层面，项目采用Svelte、Node.js、Docker等现代化技术栈，架构清晰、部署灵活，既适合普通用户快速上手，也支持开发者二次开发和贡献。无论是普通上班族、投资者，还是注重数据隐私的用户，都能通过生财有迹轻松掌握个人财务状况，科学规划财富，无需专业财务知识即可实现高效的资产管理。