# LifePlanner

**Repository Path**: fromyuhu/life-planner

## Basic Information

- **Project Name**: LifePlanner
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-14
- **Last Updated**: 2026-06-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Life Planner

人生倒计时与规划目标管理。支持 **Chrome 插件**、**Android APK**、**Web 预览**，以及 **鸿蒙 NEXT App**。

> **鸿蒙 4.x 手机**（如 4.2）请使用 **Android APK** 安装，见下方 [Android APK 安装](#android-apk-安装)。

同步方式：

- **Chrome 账号同步**：`chrome.storage.sync`（仅 Chrome 之间）
- **局域网同步**：PC 做主机，手机/Web/插件通过 WiFi 连接（见 [docs/lan-sync.md](docs/lan-sync.md)）
- **每日一语**：「今日」Tab 显示中英双语语录（见 [docs/quotes.md](docs/quotes.md)）

## 环境要求

- **Node.js** 20+
- **Chrome 插件**：Google Chrome 或 Chromium 内核浏览器
- **Android APK**：JDK 21+、Android SDK（一键安装见下方）
- **鸿蒙 NEXT App**：DevEco Studio 5.0+、HarmonyOS NEXT SDK（API 12+，**不适用于鸿蒙 4.x**）

## 快速开始（开发者）

```bash
npx pnpm install
npx pnpm test
npx pnpm build:ext             # 构建 Chrome 插件
npx pnpm build:apk             # 构建 Android APK（鸿蒙 4.x / 安卓）
bash scripts/build-apk.sh      # 一键检查环境 + 构建 APK（推荐）
```

---

## Chrome 插件安装

### 1. 构建插件

在项目根目录执行：

```bash
npx pnpm install
npx pnpm build:ext
```

构建成功后，产物位于 `apps/extension/dist`。

### 2. 加载到 Chrome

1. 打开 Chrome，地址栏输入 `chrome://extensions/` 并回车
2. 右上角开启 **开发者模式**
3. 点击 **加载已解压的扩展程序**
4. 选择目录：`apps/extension/dist`（选 dist 文件夹本身，不是上级目录）
5. 加载成功后，工具栏会出现 **开放人生** 图标

### 3. 开始使用

- 点击工具栏图标打开弹窗
- 首次使用先设置 **人生参数**，再添加 **规划目标**
- 弹窗在切换标签页时可能关闭，可点右上角 **在标签页打开** 获得更稳定的编辑体验
- 工具栏徽章会显示人生剩余天数

### 4. 更新插件

代码有改动时重新构建并刷新：

```bash
npx pnpm build:ext
```

回到 `chrome://extensions/`，在「开放人生」卡片上点击 **重新加载**。

### 5. 同步（可选）

- **Chrome 账号同步**：在插件面板勾选自动同步，或手动推送/拉取（需 Chrome 已登录并开启浏览器同步）
- **局域网同步**：PC 运行 `npx pnpm lan-sync`，在插件「局域网同步」面板填写地址和配对码（详见 [docs/lan-sync.md](docs/lan-sync.md)）

---

## Android APK 安装

适用于 **鸿蒙 4.x / 安卓** 手机，完整说明见 [apps/android/README.md](apps/android/README.md)。

### 1. 准备环境

- **JDK 21+**
- **Android SDK**（若报错 `SDK location not found`，先执行下面 SDK 安装）

```bash
# 安装 Android SDK（约 1–2 GB，仅需一次）
bash apps/android/scripts/setup-android-sdk.sh
export ANDROID_HOME=~/Android/Sdk
export PATH=$ANDROID_HOME/platform-tools:$PATH

# Java 21（Capacitor 7 需要）
sudo apt install openjdk-21-jdk
export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
```

### 2. 构建 APK

**一键脚本（推荐，自动检查/安装依赖并编译）：**

```bash
bash scripts/build-apk.sh
```

构建并安装到已连接手机：

```bash
bash scripts/build-apk.sh --install
```

或：

```bash
npx pnpm build:apk:all
npx pnpm build:apk:all -- --install
```

手动分步构建：

```bash
npx pnpm install
npx pnpm build:apk
```

产物路径：

```
apps/android/android/app/build/outputs/apk/debug/app-debug.apk
```

### 3. 安装到手机

**ADB 安装**（手机开启 USB 调试后）：

```bash
adb install -r apps/android/android/app/build/outputs/apk/debug/app-debug.apk
```

**或手动安装**：将 APK 传到手机，在文件管理器中点击安装（需允许「未知来源」）。

### 4. 与 PC 同步

与 Web/插件相同：PC 运行 `npx pnpm lan-sync`，在 App 内「局域网同步」面板配置地址和配对码。

---

## 鸿蒙 NEXT 安装（仅 HarmonyOS NEXT 设备）

当前需通过 DevEco Studio 编译安装到真机（尚未上架应用商店）。

### 方式一：一键运行到手机（推荐）

手机已通过 USB 连接时：

1. 启动 **DevEco Studio**
2. **File → Open** → 选择 `apps/harmonyos`
3. 首次打开若提示签名：菜单 **File → Project Structure → Project → Signing Configs**，勾选 **Automatically generate signature**（自动生成调试签名）
4. 顶部设备下拉框应显示你的华为手机；若未显示：
   - 确认手机已开启 USB 调试并允许电脑调试
   - DevEco 菜单 **Tools → Device Manager** 查看设备状态
5. 点击绿色 **Run（运行）** 按钮，等待编译完成，App 会自动安装并启动

### 方式二：先编译 HAP，再命令行安装

适合需要把安装包拷给他人，或重复安装同一版本。

1. 在 DevEco 中 **Build → Build Hap(s)/APP(s) → Build Hap(s)**
2. 编译成功后，安装包路径类似：

```
apps/harmonyos/entry/build/default/outputs/default/entry-default-signed.hap
```

3. 使用 HarmonyOS SDK 自带的 `hdc` 安装到已连接手机：

```bash
# 查看已连接设备
hdc list targets

# 安装（将路径替换为实际 HAP 文件）
hdc install entry/build/default/outputs/default/entry-default-signed.hap
```

> `hdc` 位于 DevEco 安装的 SDK 目录下，例如：
> `~/Huawei/Sdk/openharmony/toolchains/hdc`
> 也可在 DevEco **Settings → SDK** 中查看 SDK 路径。

### 环境要求

1. 安装 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/) 5.0 或更高版本
2. 首次启动后，按向导安装 **HarmonyOS NEXT SDK**（API 12+）

### 手机端开启调试（真机）

1. **设置 → 关于手机**，连续点击 **版本号** 开启开发者模式
2. **设置 → 系统 → 开发者选项**，开启 **USB 调试**
3. 数据线连接电脑，手机上允许调试授权

### 开始使用

- 首次打开先设置 **人生参数**（出生日期、预期寿命）
- 在 **规划目标** 区域添加、查看、删除目标
- 倒计时每秒刷新，目标按剩余时间从短到长排序

### 与 PC 同步（可选）

1. PC 在项目根目录执行 `npx pnpm lan-sync`
2. 确保手机和 PC 连接 **同一 WiFi**
3. 在手机 App **局域网同步（PC 主机）** 面板，填入 PC 终端显示的地址和配对码
4. 点击 **推送到 PC** 或 **从 PC 拉取**

详细说明见 [docs/lan-sync.md](docs/lan-sync.md)。

### 常见问题

| 问题 | 处理 |
|------|------|
| DevEco 找不到设备 | 检查 USB 调试是否开启，换线/换口，或 **Tools → Device Manager** 查看 |
| 编译报错 SDK 缺失 | DevEco → Settings → SDK，安装 HarmonyOS NEXT API 12+ |
| 签名报错 | File → Project Structure → Signing Configs → 勾选自动调试签名 |
| 局域网同步连不上 | 确认同一 WiFi、PC 防火墙放行 8765 端口、配对码无误 |

---

## 交付物

| 端 | 目录 | 适用设备 | 同步 |
|----|------|----------|------|
| Chrome 插件 | `apps/extension` | 桌面 Chrome | Chrome 账号 + 局域网 |
| Android APK | `apps/android` | **鸿蒙 4.x / 安卓** | 局域网（PC 主机） |
| Web 预览 | `apps/web` | 浏览器 | 局域网（PC 主机） |
| 鸿蒙 NEXT App | `apps/harmonyos` | HarmonyOS NEXT 真机 | 局域网（PC 主机） |
| PC 同步服务 | `apps/lan-sync-server` | PC | HTTP 主机 |

## 局域网同步

完整步骤见 [docs/lan-sync.md](docs/lan-sync.md)。

1. PC 执行 `npx pnpm lan-sync`（终端会显示二维码）
2. 复制终端显示的地址和配对码，或手机 **扫码连接**
3. 在手机/Web/插件「局域网同步」面板填写并保存
4. 点击推送或拉取

## Chrome 账号同步

Chrome 插件另支持 `chrome.storage.sync`，适合多台 Chrome 之间自动同步（无需 PC 服务）。

## 项目结构

```
packages/core/           # 倒计时引擎、备份格式
packages/lan-sync/       # 局域网同步协议
packages/ui/             # 共享 React UI
apps/lan-sync-server/    # PC 同步服务 CLI
apps/android/            # Android APK（Capacitor）
apps/extension/          # Chrome 插件
apps/harmonyos/          # 鸿蒙 NEXT App
apps/web/                # Web 预览
```

## 开发约定

见 `.cursor/rules/` 与 `.cursor/AGENTS.md`。