这个游戏算是完成我小时候的开发游戏梦吧！
LifeGame 是一款使用 Wails 2、Go 和 Vue 3 开发的桌面人生模拟游戏。玩家可以伴随可静音的内置背景音乐，进行市场交易、股票投资、创业、银行业务、古董收藏、购置房车、医疗、约会以及多种小游戏，并通过年度推进完成一局人生。
项目当前只维护一套代码、数据库、配置和媒体目录结构，不提供历史数据库、历史配置或旧资源路径的兼容与迁移。
- 桌面容器：Wails 2.10.2
- 后端：Go 1.25、SQLite（
modernc.org/sqlite）、YAML - 前端：Vue 3、Vite 3、Pinia、Vue Router、Element Plus、ECharts
- 测试：Go Test、Node Test、Playwright、原生 AT-SPI 冒烟测试
- Go 1.25+
- Node.js 20+，CI 使用 Node.js 22
- Linux 桌面构建需要 GTK3 和 WebKitGTK 4.1
Ubuntu/Debian 可安装：
sudo apt-get update
sudo apt-get install libgtk-3-dev libwebkit2gtk-4.1-dev安装与项目版本一致的 Wails CLI：
go install github.com/wailsapp/wails/v2/cmd/wails@v2.10.2
export PATH="$PATH:$(go env GOPATH)/bin"
wails version
wails doctor安装前端依赖：
cd frontend
npm ci
cd ..启动开发模式：
wails devLinux 使用 WebKitGTK 4.1 时启动命令为：
wails dev -tags webkit2_41如果不想全局安装 Wails，也可以把下文的 wails 替换为固定版本命令：
go run github.com/wailsapp/wails/v2/cmd/wails@v2.10.2例如 wails build 等价于：
go run github.com/wailsapp/wails/v2/cmd/wails@v2.10.2 build所有命令都应在包含 wails.json 的项目根目录执行，默认产物位于 build/bin/。
macOS 或 Windows：
wails buildLinux（本项目使用 WebKitGTK 4.1）：
wails build -tags webkit2_41Windows x64，适用于大多数 Windows 10/11 电脑：
wails build -platform windows/amd64 -o LifeGame-windows-amd64.exeWindows ARM64：
wails build -platform windows/arm64 -o LifeGame-windows-arm64.exe也可以一次生成两个架构；Wails 会自动给两个文件添加架构后缀：
wails build -platform windows/amd64,windows/arm64生成 Windows NSIS 安装包前，先在 Mac 安装 NSIS：
brew install nsis
wails build -platform windows/amd64 -webview2 embed -nsis-webview2 embed 会嵌入 WebView2 引导安装程序，发布包会略微增大，但目标电脑缺少 WebView2 时安装更方便。交叉编译完成后，仍应在对应架构的真实 Windows 环境中进行启动和功能测试。
Apple Silicon（M1/M2/M3/M4）：
wails build -platform darwin/arm64Intel Mac：
wails build -platform darwin/amd64同时支持 Apple Silicon 和 Intel 的 Universal 应用：
wails build -platform darwin/universal对外分发 macOS 应用时还需要使用 Apple Developer 证书签名并公证。
Wails v2 的 Linux 桌面程序依赖 GTK、WebKitGTK 和 CGO，不能从 macOS 直接交叉编译。请在对应 Linux 机器、虚拟机或 CI runner 上执行：
# Linux x64
wails build -platform linux/amd64 -tags webkit2_41
# Linux ARM64
wails build -platform linux/arm64 -tags webkit2_41-skipbindings 会跳过重新生成 Go 与前端 JavaScript 之间的绑定文件，即 frontend/wailsjs/。只修改 Vue、CSS、图片、音乐、游戏数值或 Go 方法内部实现，且没有改变前端可调用接口时，可以用于缩短重复构建时间：
wails build -platform windows/amd64 -skipbindings新增、删除或修改 services.App 的公开方法、方法参数、返回值、响应结构或 Wails Bind 列表后，必须至少运行一次不带 -skipbindings 的 dev 或 build：
wails build -platform windows/amd64如果无法确定绑定是否变化，直接不加 -skipbindings 最稳妥，只会增加少量构建时间。
后端测试和静态检查：
go test -count=1 ./...
go vet ./...前端状态/契约测试和生产构建：
cd frontend
npm test
npm run build首次运行浏览器 E2E 前安装 Chromium：
cd frontend
npm run test:e2e:install
npm run test:e2eE2E 会连接真实 Wails 后端，并使用临时家目录，避免改动开发者真实的 ~/.lifegame。原生 Linux 桌面冒烟测试需要先构建应用：
go run github.com/wailsapp/wails/v2/cmd/wails@v2.10.2 build -tags webkit2_41
cd frontend
npm run test:native更详细的前端测试说明见 frontend/README.md。
程序以当前用户家目录下的 .lifegame 作为唯一运行时数据目录：
~/.lifegame/
├── config.yaml # 当前游戏参数
├── lifegame.db # 当前参考数据和存档
├── audio/
│ └── lifegame-theme.wav # 可替换的循环背景音乐
└── images/ # 可由用户直接替换的运行时图片
├── datinginfo/
│ ├── dating-careers/
│ ├── dating-scenes/
│ ├── dating-moments/
│ └── dating-partner/
│ ├── female/
│ └── male/
├── antiqueinfo/
├── carinfo/
│ ├── cars/
│ └── car-moments/
└── houseinfo/
├── houses/
└── house-moments/
运行时规则：
- 首次启动会创建默认配置和当前数据库，并将内置图片、音乐分别释放到
~/.lifegame/images/和~/.lifegame/audio/。 - 后续启动优先读取
.lifegame外部媒体；已有文件不会被内置资源覆盖，缺少的文件才会补齐。 /images/...、/audio/...与.lifegame中对应目录后面的相对路径完全一致。- 配置和数据库在启动时加载，修改后必须完全退出并重新启动游戏。
- 编辑数据库前应先退出游戏并备份；程序不转换历史数据库或历史存档。
- 删除整个
.lifegame会丢失配置、自定义图片和存档。再次启动虽然会生成默认内容，但不会恢复已删除的个人存档。
例如：
界面地址：/images/datinginfo/dating-partner/female/11.webp
运行文件：~/.lifegame/images/datinginfo/dating-partner/female/11.webp
内置来源：frontend/public/images/datinginfo/dating-partner/female/11.webp
音乐地址：/audio/lifegame-theme.wav
运行文件：~/.lifegame/audio/lifegame-theme.wav
内置来源：frontend/public/audio/lifegame-theme.wav
更换背景音乐时，完全退出游戏，用同名的 PCM WAV 文件覆盖 ~/.lifegame/audio/lifegame-theme.wav 后重新启动。音乐会使用 AudioBuffer 首尾无缝循环；自定义音乐自身也应剪辑成首尾自然衔接的循环段。
约会对象共有七种造型。基础目录是职业装，其余造型必须替换同名子目录文件：
female/11.webp # 职业装/默认形象
female/homewear/11.webp # 居家装
female/qipao/11.webp # 旗袍/国风
female/cosplay/11.webp # Cosplay
female/swimwear/11.webp # 泳装
female/sleepwear/11.webp # 睡衣
female/romantic/11.webp # 情趣睡衣
如果图片修改后界面没有变化，请依次确认：文件名和扩展名未改变、修改的是当前造型目录、游戏已完全退出、启动的是本项目最新构建的 build/bin/LifeGame，而不是其他目录中的旧程序。
LifeGame/
├── main.go # Wails 启动、窗口和外部媒体服务
├── user_assets.go # 内置图片/音乐首次释放
├── core/ # 游戏状态、纯规则、配置和数值计算
├── internal/db/ # SQLite 表结构、默认数据和查询
├── services/ # Wails 对外业务接口与类型化响应
├── frontend/
│ ├── src/components/ # 页面、对话框和小游戏组件
│ ├── src/stores/ # Pinia 游戏状态
│ ├── src/utils/ # 前端场景、礼物、换装等映射
│ ├── public/images/ # 发布包内置图片源
│ ├── public/audio/ # 发布包内置背景音乐
│ └── tests/ # 前端契约测试
├── scripts/ # 图片处理和原生测试辅助脚本
└── wails.json # Wails 项目配置
继续优化、添加功能或交给 AI 修改前，请先完整阅读 DEVELOPMENT_GUIDE.md。该手册记录了当前架构、游戏规则边界、数据源、图片索引、扩展流程、验证要求以及 AI 协作约定。
项目功能和游戏设计以项目所有者提出的需求为准。开发者或 AI 可以指出问题和方案，但不应在没有需求确认的情况下自行改变玩法、数值、关系规则或视觉方向。
GitHub Actions 会执行 Go 测试、go vet、前端契约测试、生产构建和真实后端 Playwright E2E。原生 AT-SPI 测试作为 Linux 桌面发布前检查保留。
v1.0.0：最初版本 v1.1.0：完善了很多，包括约会对象、房车、音乐背景等，以及修复一些BUG
MIT License