# 更新日志 ✧٩(ˊωˋ*)و✧

本项目的所有重要变更都会记录在这里。
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。

---

## [0.2.0] — 2026-10-12 🌸

> **这一版的目标：把她变成一个"可以安心调"的插件** —— 从"能跑"到"经得起反复改"。

### ✨ 新增

- **完整的设置页**：调色盘（8 个预设 + 取色器 + RGB 滑块）、节奏、时段、播放模式、
  用户名、模型名、音效与女声播报，全部可视化调节 (๑˃̵ᴗ˂̵)و
- **可配置主色**：一处定义、全局传播。所有辉光 / 边框 / 弹幕都会跟着变色，
  canvas 绘制部分通过主色插值同步
- **时段系统**：正午 / 黄昏 / 夜晚三套画面，按系统时间自动切换，时段边界可编辑
- **播放模式**：首次启动 / 最小化恢复 / 两者 / 从不，四种组合
- **16 道自动化门禁**（见下）—— 改完一行命令就能知道有没有把动画改坏 ᕦ(ò_óˇ)ᕤ
- **`ARCHIVE.md`**：完整工作记录（设计决策与理由、故障全景、想改什么改哪里）
- **错误可视化**：插件抛错时会在屏幕右下角直接显示，不再静默失败

### 🔧 改进

- **登录后的白底界面动画整体延长一倍**（12.3s → 24.6s），
  预载与登录打字保持原速 —— 那是"等待与输入"，放慢只会显得卡 (｡•́︿•̀｡)
- **打字音全部改为"闷"的短音**（三角波 + 1.05kHz 低通 + 440–740Hz 音阶）
- **登录按钮音效改为明亮上扬**的"通关"音（五音上行冲刺 + 高音大三和弦）
- **女声播报响度 +20%**，并接入卷积混响
- 终端三个阶段合并为**同一个面板**，日志连续累积、不重挂、不闪 ✨
- **开屏改为"由高度模糊逐渐清晰"**：模糊 / 亮度 / 电源黑幕由同一个 rAF 循环驱动，
  彻底解决"亮度先动、画面后清晰"

### 🐛 修复

- 修复`window.atob` 在部分环境下不存在导致**女声素材静默失效**（改为三级兜底）
- 修复资源路由只服务 JS 导致**图片必然 404**（改为内联 data URI）
- 修复宿主 schema 缓存导致**设置里"选了又跳回去"**（新增浏览器本地兜底）
- 修复新 `useEffect` 写在 early return 之后导致**刷新后动画完全不播放**
- 修复 CSS 注释里的反引号**截断模板字符串**（这个坑踩了 4 次 (´;ω;`)）
- 修复登录按钮在某些时序下**卡死**（`onSubmit` 走 ref、请求不丢、状态不回退）
- 修复持续音**不随动画结束**（已整体移除，全部改为一次性音效）

### 🗑️ 移除

- **眼皮与眨眼**：用户明确要求不要，改为"模糊逐渐清晰"的开场
- **环境底噪 / 持续音**：用户明确要求去掉，全部改为一次性音效
- **对宿主 UI 的适配**（隐藏会话地图顶端的胶囊）：会把宿主 UI 弄坏，已彻底移除
- **白色交接层**（遮罩不透明 + 末尾淡出）：观感明显变差，已按用户要求回退

### ⚠️ 已知问题

- 开屏揭幕时，会话地图顶端的胶囊可能**短暂透出**。
  两次尝试修复（改宿主 DOM / 改揭幕形态）都已回退，原因是代价大于收益。
  详见 `ARCHIVE.md` 第五节 (´･_･`)

---

## [0.1.0] — 2026-10-11 🎬

> **第一个能跑的版本** —— 从零到"完整的开屏叙事"。

### ✨ 新增

- 完整的开屏时间线（约 42.6 秒）：
  黑屏 → 模糊渐清晰 → 终端启动 → 登录 → 代码编译 → AR HUD →
  文字署名 → 全屏弹幕 → 主界面浮现
- **启动终端**：自动逐字输入 `running Deepseek Harness`、
  连接工作区模型（带进度条）、预载 12 个插件（0→100 数码进度条 + 参数可视化）
- **中轴对称登录界面**：桌宠 + 用户名 + 8 位密码逐字输入，点击触发数码方块波纹
- **AR HUD**：代码编译成由中心展开的 HUD 面板
- **全屏代码弹幕**：涨满再变稀，主界面随之透出
- **8bit / chiptune 风格音效**：全部程序化合成（Web Audio），零音频素材
- **赛博线条生长**装饰（终端、控制台、署名、HUD）
- 女声播报 `welcome back, master`

---

## 🧪 关于那 16 道门禁

改完代码跑一条命令就知道有没有把动画改坏：

```bash
node .preview/run-gates.mjs "<node 路径>"
```

| 门禁 | 守着什么 |
| --- | --- |
| `check-css` | CSS 模板没被反引号截断（这个坑真实踩过 4 次） |
| `check-hooks` | React Hook 都在 early return 之前 |
| `check-classic` | 客户端能当**经典脚本**解析（`import.meta` 会让整批 bundle 连坐失效） |
| `check-config` | 宿主 Config schema 合法 |
| `check-defaults` | 客户端兜底值与宿主默认值**不漂移** |
| `check-archive` | 文档里写的默认值与实现一致 |
| `smoke-headless` | 真正求值一遍模块，抓求值期未定义变量 |
| `check-stages` | 阶段编号、映射、渲染引用三者一致 |
| `check-eyesync` | 开屏的模糊 / 亮度同源驱动 |
| `check-cover` | 已回退的"交接层"没有被加回来 |
| `check-accent` | 换色是否全局传播 |
| `check-audio` | 音效与女声不静默失效 |
| `check-hostui` | 已移除的"宿主 DOM 操作"没有被加回来 |
| `check-danmaku` | 弹幕密度包络 0 → 铺满 → 0 |
| `check-login` | 登录按钮 → 继续播放 这条路径的卡死隐患 |
| `run-login-flow` | 完整走一遍登录流程 |

---

## [未发布] — 计划中 💭

- [ ] 更多时段氛围（清晨 / 深夜）
- [ ] 可选的第二个场景图
- [ ] 导出 / 导入配色方案
- [ ] 英文界面完整翻译

---

_格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) ♡_