像素人生 Pixel Life

像素人生是一款像素画风的微习惯养成 App。当前目标是先做一个能在小米 13 Pro 上连续使用 21 天的 Android 试用版：每天完成一个很小的行动，写一句回想，获得星屑/心火，并让小屋、地图、成就和回顾产生温和反馈。

当前状态

• 平台：Expo + React Native + TypeScript
• 当前主线：Android 21 天试用版
• 已验证：npm run check:trial、Android release APK 构建、APK 已安装到小米 13 Pro；本轮设备会话在截图后断开，最新前台启动仍待设备重新连接复核
• 已实现：今日打卡、小屋、地图、回顾、单锚收入动作、明日预演、自定义习惯、收入结果回填、存档导入导出、星屑商店 MVP、天气/光照/季节、触觉反馈、音效与背景音乐设置
• 暂不做：账号云同步、复杂商城、付费、社交排名、大地图战斗

快速开始

npm install
npm run version:check
npm run typecheck
npm run web

Web 预览通常打开：

http://localhost:8081

Expo 开发服务器：

npm run start

版本号管理

版本入口是 version.json。发布前只改这一条线，不手动分散改原生工程：

npm run version:patch
npm run version:check

• version：面向用户的 SemVer 版本，例如 0.1.0
• androidVersionCode：Android 安装包递增整数，只能增加
• iosBuildNumber：iOS 构建号，字符串形式递增
• releaseChannel：当前发布线，试用版为 trial

npm run version:check 会校验 version.json、package.json、package-lock.json、app.json 和 Android Gradle 是否一致。

Android Release

Android 本地 release 构建使用 android/ 工程。Windows 本机验证时使用 JDK 17 和 Android SDK 后运行：

$env:JAVA_HOME='C:\Program Files\Eclipse Adoptium\jdk-17.0.20.8-hotspot'
$env:ANDROID_HOME='C:\android-sdk-pelvicfloor'
$env:ANDROID_SDK_ROOT='C:\android-sdk-pelvicfloor'
$env:PATH="$env:JAVA_HOME\bin;C:\android-sdk-pelvicfloor\platform-tools;$env:PATH"
cd android
.\gradlew.bat app:assembleRelease -x lint -x test --no-daemon --console=plain -PreactNativeDevServerPort=8081 '-PreactNativeArchitectures=arm64-v8a'

安装到已连接 Android 手机：

& 'C:\android-sdk-pelvicfloor\platform-tools\adb.exe' install -r "C:\Users\shasi\Documents\ChatGPT\pixel-step-gitee\android\app\build\outputs\apk\release\app-release.apk"

目录结构

src/
  components/   可复用 UI 与游戏反馈组件
  screens/      今日、小屋、地图、回顾页面
  state/        本地状态、日期滚动、习惯生命周期、环境时间
  data/         习惯、故事、商店、称号、素材注册表
  services/     音频、提醒等平台服务
  theme/        颜色、间距、触控尺寸等 token
assets/
  pixel/        运行时像素素材
  audio/        运行时音效与背景音乐
  external-src/ 原始素材归档，本地保留但不进仓库
android/        Expo prebuild 后的 Android 原生工程
docs/           设计、发布、素材、维护文档
scripts/        素材生成与筛选脚本

关键文档

• 当前权威逻辑链：docs/current-logic-review-and-roadmap.md
• 维护与发布交接：docs/project-maintenance.md
• 21 天试用范围：docs/21-day-trial-scope.md
• 手机试用发布计划：docs/trial-release-plan.md
• 素材来源与许可证：docs/asset-attribution.md
• 开发进度：docs/development-progress.md

维护原则

1. 先稳定 21 天主链路，再扩展新模块。
2. 所有运行时素材从 src/data/assetManifest.ts 注册。
3. 新增状态字段必须考虑旧存档迁移。
4. 音效、触觉、动画只能增强轻压力反馈，不能制造催促感。
5. 外部素材必须记录来源和许可证，不使用商业游戏解包素材。

发布状态

截至 2026-08-18，当前 master 已推送到 Gitee：

https://gitee.com/klsing/pixel-step.git

Android release APK 已构建并安装到小米 13 Pro；本轮设备断开导致最新启动截图尚未完成复核。iOS/TestFlight 尚未执行。