From bd28219b65bc3d59337178f878252c71144698b2 Mon Sep 17 00:00:00 2001
From: Super_Z <1401203083@qq.com>
Date: Tue, 23 Jun 2026 16:38:44 +0000
Subject: [PATCH] docs: update worklog for v0.5.1 (Gitea Pages deploy +
 tutorial + UI)

---
 worklog.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 50 insertions(+), 7 deletions(-)

diff --git a/worklog.md b/worklog.md
index eada5f6b0..a10d2f152 100644
--- a/worklog.md
+++ b/worklog.md
@@ -6,7 +6,8 @@
 
 ## 项目当前状态描述 / 判断
 
-- **阶段**：v0.5 已完成（深空信标 · 每日挑战 + 本地排行榜 + 编年史历史 BUG 修复）
+- **阶段**：v0.5.1 已完成（**游戏已上线 Gitea Pages** + 新手教程系统 + UI 优化）
+- **在线游玩**：https://gitea-pages.atdunbg.xyz/Super_Z/echo-nexus/
 - **已完成**：
   - 游戏市场调研（多源交叉验证，2024-2026 数据）
   - GDD 游戏设计文档（世界观、核心循环、六大系统、MVP 范围）
@@ -19,8 +20,9 @@
   - v0.3：星潮事件系统（6 种星潮 + 全屏叠层 + 程序化音效）
   - v0.3.1：星图天文台元进程（6 类 × 3 = 18 天赋 + 飞升后 3 选 1 draft + Canvas 星图）
   - v0.4：回响编年史（5 纪元循环命名 + 模板化叙事 + 时间轴 UI + 6 项新成就 + 飞升 BUG 修复）
-  - **v0.5：深空信标**（每日挑战 + 本地排行榜 Top20 + 7 标签页 + 编年史历史 BUG 修复）
-- **当前目标**：v0.5+ 云存档+云排行榜 + 全 5 纪元手写叙事节点 + socket 多人同步星潮
+  - v0.5：深空信标（每日挑战 + 本地排行榜 Top20 + 7 标签页 + 编年史历史 BUG 修复）
+  - **v0.5.1：静态部署 Gitea Pages + 新手教程系统（7 步聚光灯引导）+ UI 间距优化**
+- **当前目标**：回复 Issue #1 #28 + UI 进一步优化 + 云存档/云排行榜 + 全 5 纪元叙事
 - **技术栈**：Next.js 16 + TypeScript + Tailwind + shadcn/ui + Canvas + Zustand
 
 ## 游戏核心概念（一句话）
@@ -181,23 +183,64 @@
 - **lint 零错误；HTTP 200；编译 < 250ms**
 - 详见 docs/repo/docs/10-深空信标系统-v0.5.md
 
+### v0.5.1 静态部署 + 新手教程系统 + UI 优化（本轮完成）
+- **里程碑：游戏正式上线 Gitea Pages！** 玩家无需下载编译，直接访问 https://gitea-pages.atdunbg.xyz/Super_Z/echo-nexus/ 即可游玩
+- **背景**：回应 Issue #1 评论 #28（atdunbg 反馈"如何游玩？需要教程？UI 太紧凑遮挡字体"）
+- **静态导出配置**（`next.config.ts`）：
+  - 环境变量 `BUILD_EXPORT=true` 切换 `output: export`（dev 不受影响）
+  - `basePath: /Super_Z/echo-nexus` + `trailingSlash: true` 适配 Gitea Pages 子路径
+  - `images.unoptimized: true`（静态导出禁用图片优化）
+  - 移除 `src/app/api/route.ts`（静态导出不支持 API routes）
+  - 新增 `bun run build:static` 脚本
+  - `out/.nojekyll` 防 Jekyll 忽略 `_next` 目录
+- **Gitea Pages 部署流程**：`bun run build:static` → `cd out && git init -b gh-pages` → `git push -f origin gh-pages`
+- **新功能：新手教程系统**（`src/lib/game/tutorial.ts` + `src/components/game/TutorialOverlay.tsx`）
+  - **7 步引导**：欢迎 → 脉冲扫描 → 谐振解码 → 技术树 → 遗迹探险 → 飞升 → 完成
+  - **聚光灯高亮**：4 块 div 挖洞遮罩 + 目标元素呼吸光边框（`tut-pulse` keyframes）
+  - **动作检测**：rAF 轮询 store 状态，检测 pulse/decode-start/tech-buy/expedition-start 自动推进
+  - **提示气泡**：紫粉渐变边框 + 顶部三色装饰条 + 步骤进度条（1/7）+ 上一步/跳过/下一步按钮
+  - **首次自动弹窗**：localStorage `echo-nexus-tutorial-v1` 标记，600ms 延迟等 mount
+  - **设置重看**：SettingsDialog 新增"重看教程"按钮，dispatch `echo-nexus-tutorial-restart` 事件
+- **UI 优化**（基于 VLM 视觉分析）：
+  - **ResourceBar 间距**：`gap-2 → gap-x-3/4`，分隔线改渐变透明→白→透明，`shrink-0` 防图标挤压，`whitespace-nowrap` 防文字断行，`tabular-nums` 数字等宽对齐
+  - **SettingsDialog**：新增"在线游玩"gitea-pages 链接（绿色高亮）+ 教程重看卡片
+  - **globals.css**：新增 `tut-pulse` + `tut-pop-in` 动画 keyframes
+- **data-tut 属性锚点**：crystal-orb / decode-panel / tab-expedition / tab-tech / prestige-btn
+- **QA 验证**（agent-browser + VLM，部署站点）：
+  - 静态站点 HTTP 200，HTML 完整，资源路径含 basePath 正确
+  - 首次访问教程自动弹出（hasWelcome:true, hasNext:true）
+  - 点击"下一步"→ 步骤 2/7，高亮聚焦框框住中央晶体球（VLM 确认 8/10）
+  - 点击"跳过"→ 教程关闭，游戏正常加载
+  - 设置→重看教程→ 弹窗重新打开回 1/7
+  - VLM 确认弹窗位置合理、遮罩半透明、紫色高亮边框、按钮清晰
+  - 核心交互（点击晶体 +8）正常
+- **lint 零错误**（修复 2 处 react-hooks/set-state-in-effect，改用 rAF 异步轮询）
+- **Gitea 推送**：2 个 commit（main 源码 + gh-pages 静态资源）
+- **dev 服务器 Turbopack 缓存不稳定问题**：偶发 `Unable to open static sorted file` + 进程被杀，需 `rm -rf .next` 重启。静态导出构建稳定可靠
+
 ### 进行中
 - [ ] 持续迭代：云存档+云排行榜(v0.5+)、全5纪元手写叙事节点(v0.5+)、socket 多人同步星潮(后续)
+- [ ] 回复 Issue #1 #28：告知已上线 Gitea Pages + 教程系统 + UI 优化
 
 ## 未解决问题或风险 / 下一阶段优先事项
 
 - v0.3 星潮为单机版（原计划 socket 全局事件），后续可扩展为多人同步
 - v0.5 信标排行榜为本地版（纯 localStorage），后续 v0.5+ 升级为云排行榜需后端 API
 - v0.5 每日挑战仅 1 个/天，后续可加入"周挑战"或"信标链"（连续完成 N 天奖励）
-- Issue #1 玩家反馈已通过 v0.3 星潮 + v0.3.1 星图 + v0.4 编年史 + v0.5 信标四层回应，玩法深度显著提升
+- Issue #1 玩家反馈已通过 v0.3 星潮 + v0.3.1 星图 + v0.4 编年史 + v0.5 信标 + v0.5.1 教程+上线 五层回应
 - v0.2 探险 BOSS 战胜率较低（基础探索力 10 vs BOSS 难度 5-7，胜率约 25%），需玩家投资探险技术
 - 探险能量恢复较慢（45s/点），后续可加技术提升恢复速度
 - 编年史上限 50 条，超过自动丢弃最早的；v0.4 之前的飞升无回填（空状态有对应提示）
 - 5 纪元叙事内容目前为模板化生成，v0.5+ 将加入手写剧情节点
-- 需持续关注 Gitea 工单（仓库 Issues）获取额外需求
-- 下一阶段优先：云存档+云排行榜(v0.5+)、全5纪元手写叙事节点(v0.5+)、socket 多人同步星潮
+- dev 服务器 Turbopack 缓存偶发损坏，静态导出构建更稳定
+- **下一阶段优先**：
+  1. 回复 Issue #1 #28（atdunbg 等待游玩方式答复）
+  2. UI 进一步优化（标签页图标/文字比例、视觉层次强化）
+  3. 云存档+云排行榜(v0.5+)
+  4. 全 5 纪元手写叙事节点(v0.5+)
+  5. socket 多人同步星潮
 
 ## 定时任务
-- 已设置：每 15 分钟 webDevReview（自动 QA + 迭代开发，job_id: 227581）
+- 已设置：每 15 分钟 webDevReview（自动 QA + 迭代开发，job_id: 227909，fixed_rate 900s）
 
 ---