QuantLife Web

人生努力可视化系统 | 把生活变成一场持续升级的游戏

QuantLife Web 是一个本地优先的人生成长记录工具。你可以用它记录每日打卡、经验值、维度成长、任务营地、财富目标，也可以接入自己的 AI API 来做文字解析和规划。

这个项目不会自带任何人的 API Key。每个用户都需要配置自己的 API。

适合谁

• 想把生活、学习、运动、创作做成“升级系统”的人
• 想在自己电脑本地运行，不想把私人数据交给第三方平台的人
• 想自己接 OpenAI 兼容接口、Anthropic 兼容接口，或其他兼容大模型服务的人

0 基础本地部署教程

第 1 步：下载项目

打开项目地址：

https://github.com/dww911/QuantLife_Web

如果你不会用 Git，最简单的方法是：

1. 点击 GitHub 页面右上方绿色按钮 Code
2. 点击 Download ZIP
3. 下载完成后解压
4. 进入解压后的 QuantLife_Web-main 文件夹

如果你会用 Git，也可以运行：

git clone https://github.com/dww911/QuantLife_Web.git
cd QuantLife_Web

第 2 步：安装 Node.js

这个项目需要 Node.js。

1. 打开 Node.js 官网：

https://nodejs.org/

2. 下载并安装 LTS 版本
3. 安装完成后，打开终端检查：

Windows 可以打开 PowerShell，macOS 可以打开“终端”，然后输入：

node -v
npm -v

如果能看到版本号，就说明安装成功。

第 3 步：打开项目文件夹里的终端

Windows：

1. 打开解压后的项目文件夹
2. 在文件夹空白处按住 Shift，点击鼠标右键
3. 选择“在终端中打开”或“在 PowerShell 中打开”

macOS：

1. 打开“终端”
2. 输入 cd ，后面拖入项目文件夹
3. 回车

示例：

cd 你的项目文件夹路径

第 4 步：安装依赖

在项目文件夹的终端里输入：

npm install

第一次安装会稍微等一会儿。看到没有报错，就可以继续。

第 5 步：启动本地服务

继续输入：

npm run dev

如果看到类似下面的内容，说明启动成功：

Progress server running at http://localhost:3030

第 6 步：打开网页

打开浏览器，访问：

http://localhost:3030

你应该能看到 QuantLife 页面。

以后每次使用时，只需要：

1. 打开项目文件夹终端
2. 输入 npm run dev
3. 浏览器打开 http://localhost:3030

第一次使用建议

打开页面后，先进入“设置中心”：

• 修改昵称
• 修改应用名称
• 修改主页标语
• 设置头像文字、头像图片 URL，或选择本地头像图片
• 修改成长维度名称、目标、排序和经验系数
• 配置自己的 AI API

默认资料是中文通用模板，用户可以随时改成自己的版本。

配置自己的 AI API

如果你只想手动记录打卡，可以先不配置 API。

如果你想使用 AI 文字解析、AI 规划功能，需要配置自己的 API。

方法一：在网页里配置

1. 打开 http://localhost:3030
2. 进入“设置中心”
3. 找到“AI 连接设置”
4. 填入：
   • Provider
   • Base URL
   • Model / Endpoint
   • API Key / Token
5. 点击“保存 AI 配置”
6. 点击“测试连接”

配置会保存到本地的 llm-config.json，这个文件不会上传到 GitHub。

方法二：使用 .env

复制 .env.example 为 .env，然后编辑 .env。

OpenAI 兼容接口示例：

LLM_PROVIDER=openai
LLM_BASE_URL=https://api.openai.com
LLM_API_KEY=填你自己的key
LLM_MODEL=gpt-4.1-mini

Anthropic 兼容接口示例：

LLM_PROVIDER=anthropic
ANTHROPIC_BASE_URL=https://api.anthropic.com
ANTHROPIC_AUTH_TOKEN=填你自己的token
ANTHROPIC_MODEL=claude-sonnet-4-5

改完后重新启动：

npm run dev

数据保存在哪里

本项目是本地优先。

主要本地数据文件：

• fengdingding-progress.json
• fengdingding-progress.db
• fengdingding-progress.db-shm
• fengdingding-progress.db-wal