# 致博 24 小时成长打卡项目

## 目标

在 `G:\致博世界` 下单独建立一个 HTML 原型，用来记录致博一天 24 小时里的生活、学习、休息和娱乐情况。这个工具先不做复杂后端，先把真实使用场景跑通：随时补记、即时反馈积分、用数据引导时间利用，并把积分和小动物养成、娱乐兑换连接起来。

## 需求实录

- 需要单独一个文件夹记录 24 小时情况。
- 可以随时创建打卡，任意插入某个时刻的信息。
- 示例场景：16 点记录写作业，17 点记录完成。
- 每次打卡要有积分反馈，积分用于奖励激励。
- 积分未来可以在 App 里养小动物，或者做一些娱乐事情。
- 希望记录致博的生活学习情况，用数据引导他正确利用时间。
- 当前阶段先以 HTML 形式设计。
- 过程中的思路和整理实录写入 `项目.md`。

## 设计思路

1. 把一天设计成“24 小时成长星盘”，不是普通流水账。
2. 左侧是随时打卡表单，可以精确到分钟，也可以点击 24 小时星盘上的小时点补记。
3. “开始”和“完成”分开记录，尤其适合作业、阅读、运动等任务，完成后形成闭环。
4. 积分不只是累计数字，还连接到右侧的成长伙伴和奖励兑换。
5. 娱乐不做绝对禁止，而是设计成可兑换、可记录、可复盘的行为。
6. 数据引导不批评孩子，而是提醒下一步：作业是否闭环、娱乐是否过多、学习后是否需要运动、睡前是否需要复盘。

## 当前实现

- `index.html`：单文件 HTML 原型，可直接用浏览器打开。
- 本地数据保存在浏览器 `localStorage`，刷新后不会丢失。
- 支持日期切换、任意时间打卡、快速插入示例、删除记录、复制记录再填。
- 支持状态式打卡：一键进入“写作业、阅读、运动、家务整理”等状态，再从正在进行卡片里选择实际完成时间并标记完成。
- 支持 24 小时环形视图和横向小时轴。
- 支持自动估分和手动调整反馈积分。
- 支持学习分钟、完成次数、获得积分、可用积分统计。
- 支持用积分兑换养成、娱乐、亲子游戏和周末奖励储蓄。
- 支持导出 JSON，方便后续迁移到 App 或后端。

## 积分规则草案

- 作业、阅读、运动、家务、亲子等正向行为有不同基础分。
- “完成”比“开始”更高分，鼓励把事情做完。
- 持续时间达到 20、45、75 分钟会获得额外加分。
- 状态能量较好时有小额加分。
- 娱乐也能记录，但积分较低，重点是让娱乐从“无意识消耗”变成“有边界兑换”。

## 使用方式

1. 打开 `index.html`。
2. 日常使用优先点左侧“一键状态打卡”，比如“开始写作业”。
3. 完成时在正在进行卡片里确认实际完成时间，再点“完成”。
4. 如果需要补充备注、调分或记录特殊事件，再使用下方精细表单。
5. 在中间查看一天 24 小时的分布。
6. 在右侧查看数据引导和积分伙伴。
7. 积分足够后，可以兑换养成或娱乐奖励。

## 后续扩展

- 增加周视图、月视图和连续习惯统计。
- 增加家长模式和孩子模式，家长配置规则，孩子只看任务和奖励。
- 增加小动物更多形态、装饰物和成长故事。
- 增加“作业计划”和“完成复盘”模板。
- 接入 App 或后端账号后，可以同步多设备数据。
- 加入更温和的提醒语音或桌面通知。

## 本次制作记录

- 2026-06-03：确认当前项目根目录下没有 `说明.md`，因此本次新建独立工具文件夹，不修改现有游戏文件。
- 2026-06-03：建立 `致博24小时打卡` 文件夹。
- 2026-06-03：完成 `index.html` 原型和本 `项目.md` 文档。
- 2026-06-03：根据使用反馈，把“先填开始、再填完成”的表单逻辑升级为“进入状态、标记完成”的一键打卡逻辑，并支持选择实际完成时间。
- 2026-06-09：在 `Open Design` 目录下建立高保真 UI 设计图，不覆盖根目录现有 `index.html` 功能原型。
- 2026-06-09：视觉方向采用 `modern-minimal`，以白色产品界面、清晰网格、蓝色主操作和学习/生活/娱乐/休息状态色为基础，避免把儿童成长工具做成低龄玩具风。
- 2026-06-09：按“每个用户屏幕单独 HTML 文件”的方式拆分：`Open Design/index.html` 作为入口；桌面端包含首页总览、24 小时打卡、积分伙伴/兑换、数据复盘、家长规则设置；Android 端同步提供 5 个对应屏幕。
- 2026-06-09：设计重点继续围绕真实使用场景：孩子优先看到“下一步该做什么”，家长在规则页配置积分、提醒和娱乐边界；打卡页保留一键状态、实际完成时间、补记表单、积分预估；兑换页把积分连接到成长伙伴、娱乐兑换、亲子游戏和周末储蓄。
- 2026-06-09：第二轮精细设计：强化 `Open Design` 的共享视觉系统，增加今日主行动、闭环步骤、时间能量分布、奖励库存、手机安全区滚动和更明确的交互反馈。
- 2026-06-09：桌面端精修重点从“页面齐全”升级为“管理台可用”：首页突出 16:00 作业待完成这条主线；打卡页强调开始/完成闭环；奖励页增加伙伴等级、娱乐边界、周末储蓄；复盘页加入非批评式判断；规则页说明孩子端只看下一步。
- 2026-06-09：Android 端精修重点从“桌面缩小版”改为“孩子单手使用”：首页只保留主行动、少量统计和伙伴状态；打卡页增加横向时间选择；奖励页突出还差多少分和娱乐额度；复盘页改成睡前 1 分钟；规则页作为家长模式保留简短开关。
- 2026-06-09：在正确项目目录下创建 `.NET 10` MAUI 工程 `ZhiboGrowthMaui`，基于 `Open Design` 的桌面和 Android 设计实现原生 MAUI 原型，支持电脑端运行并保留手机端目标。
- 2026-06-09：MAUI 版本已通过 Windows TFM 构建和运行验证，窗口标题为“致博成长打卡”。此前误建到 `G:\Dotnet\工作可能\06.09.信访、` 的信访 MAUI 工程不是本项目交付内容。
- 2026-06-09：按“功能自己思考一遍”的要求继续优化 MAUI 版，把原先静态展示升级为可交互状态机：一键进入状态、选择实际完成时间、按用时计分、兑换扣分、保存复盘、规则开关联动提示，并再次通过 Windows 构建和运行验证。
- 2026-06-09：根据“基础 UI 如果设计不好就很丑，HTML 设计稿样式已经到位，MAUI 也要可商用”的反馈，MAUI 版引入 `Syncfusion.Maui.Toolkit 1.0.10`，把主按钮、状态打卡卡片、指标卡和进度条升级为成熟控件，并建立 `ZhiboGrowthMaui\OpenDesign对照.md` 作为 UI 对照与验收文档。
- 2026-06-09：重建 `ZhiboGrowthMaui\Resources\Styles\Styles.xaml`，保留 Open Design 的色彩和卡片体系，避免 MAUI 模板默认样式影响产品质感；Windows TFM 构建再次通过，0 warning / 0 error。
- 2026-06-09：根据“给孩子使用进度学习，UI 至关重要”的反馈，MAUI 第一屏进一步从家长报表调整为孩子任务面板：使用“关卡 / 星分 / 伙伴奖励距离”的语言，新增当前关卡与伙伴等待卡，弱化复杂统计，让孩子打开后先知道下一步行动。
- 2026-06-09：继续强化孩子端首屏为“任务台”：当前关卡显示开始时间、完成奖励和进度条；伙伴区域显示等级、状态、能量百分比和奖励距离；手机窄屏增加底部导航，隐藏桌面侧栏；Windows TFM 构建通过，0 warning / 0 error。
- 2026-06-10：根据构建提示执行 `dotnet workload restore`，补齐并更新 Android/iOS/MacCatalyst/MAUI Windows/wasm workloads；Windows TFM 构建继续通过。Android 命令行构建确认需要 `JavaSdkDirectory=C:\Program Files\Android\Android Studio\jbr`，并需通过 ASCII 路径 junction `C:\CodexWork\ZhiboGrowthMaui` 避开中文路径导致的 `APT2265`；`net10.0-android` 构建通过，0 warning / 0 error。
- 2026-06-10：为满足 Visual Studio 直接编译运行要求，在 MAUI 项目内新增 `Directory.Build.props`，让 Windows 下所有目标框架统一使用 `C:\CodexBuild\ZhiboGrowthMaui\` 作为构建中间目录和输出目录，并自动使用 Android Studio JBR；从原始 `G:\致博世界\...` 项目路径执行 Android 构建已通过，0 warning / 0 error，Windows TFM 也通过。
- 2026-06-10：继续按商用 UI 要求修正 MAUI 菜单体系：桌面侧栏、手机底部导航以及页面剩余操作按钮统一替换为 Syncfusion `SfButton`，避免原生按钮和 Syncfusion 控件混搭导致质感不一致；Android 与 Windows 构建均通过。
- 2026-06-10：根据安卓设计稿修正 MAUI 导航逻辑：桌面侧栏和手机底部导航统一为 `首页 / 打卡 / 奖励 / 复盘 / 规则` 五入口；`奖励` 锚定成长伙伴和兑换区，`复盘` 锚定睡前 1 分钟，`规则` 锚定家长规则，底部导航点击后会同步选中态并滚动到正确区块。
- 2026-06-10：继续把 MAUI 页面空间升级为 Syncfusion Toolkit 控件：侧栏、首页、任务台、内部任务卡、指标卡、打卡、时间地图、时间轴、奖励、复盘、规则和手机底部导航均使用 `SfCardView`；操作按钮、导航按钮和规则开关使用 `SfButton`；XAML 中已无原生 `<Button>` 和 `<Switch>`。
- 2026-06-10：按“MAUI Blazor Hybrid 能否同时出网页版”的方向重构为四项目 `.slnx`：`ZhiboGrowth.Core` 放积分、打卡、规则和数据模型；`ZhiboGrowth.Shared` 放共用 Razor 组件、CSS 和打卡 UI；`ZhiboGrowth.Web` 作为可发布浏览器网页版；`ZhiboGrowthMaui` 作为 MAUI Blazor Hybrid App。
- 2026-06-10：新增 `ZhiboGrowth.slnx`，其中只包含 `ZhiboGrowth.Core`、`ZhiboGrowth.Shared`、`ZhiboGrowth.Web`、`ZhiboGrowthMaui` 四个项目；`ZhiboGrowth.Shared` 引用 `Core`，`Web` 与 `Maui` 同时引用 `Shared` 和 `Core`。
- 2026-06-10：`ZhiboGrowthMaui` 从原生 XAML 首页切换为 `BlazorWebView` 承载 `ZhiboGrowth.Shared.ZhiboApp`，Shell 当前入口为 `HybridPage`；旧 `MainPage.xaml` 保留为历史备用，不再作为默认入口。
- 2026-06-10：将核心界面样式统一放入 `ZhiboGrowth.Shared\wwwroot\zhibo-growth.css`，Web 和 MAUI WebView 都加载同一份 CSS，避免出现网页和 App 视觉不一致。
- 2026-06-10：验证 `ZhiboGrowth.Web` 构建通过，0 warning / 0 error；`ZhiboGrowthMaui` 的 Windows 目标和 Android 目标构建通过，均为 0 warning / 0 error。Android 最低支持版本调整为 24.0，以符合 BlazorWebView 平台支持边界。
- 2026-06-10：根据“现在还是根据 PC 页面在做，应该根据安卓页面来做；导航页面要跳转对应页面，不是把所有东西放在一个页面”的反馈，重构 `ZhiboGrowth.Shared`：`ZhiboApp` 改为 Router，新增 `Home / Checkin / Rewards / Review / Rules` 五个独立 Razor 路由页面，底部导航使用真实 URL 跳转。
- 2026-06-10：页面结构对齐 `Open Design\android`：首页只保留主行动、统计、时间摘要和伙伴；打卡页承载事项选择、完成时间和补记；奖励页承载伙伴等级和兑换；复盘页承载睡前判断和一句话；规则页承载家长规则与开关。
- 2026-06-10：Web 路由更新为扫描 `ZhiboGrowth.Shared` 组件程序集，并删除 Web 项目原占位首页，避免 `/` 路由冲突；MAUI Hybrid 仍以 `ZhiboApp` 为 RootComponent，但现在进入的是 Shared Router。Web、Windows MAUI、Android MAUI 构建均通过，0 warning / 0 error。