# 更新日志

## 0.51.2 · 2026-10-25

- 修复官方 DeepSeek Harness 客户端驾驶员加载进度前半段停在 0%、随后跳到约 60%：`dsh-app://` 转发会移除 Content-Length，音频总时长可能迟至播放后半段才变为有限值。
- 构建时从两段原 MP3 的有效 MPEG 帧采样数生成准确时长，浏览器元数据未就绪时用于进度分母；播放位置继续读取 currentTime，durationchange 到达时立即校准，不新增音频请求或预解码开销，不修改素材字节和启动时序。
- 修复黑底打字引导与驾驶员选择页之间的瞬间闪烁：选择页使用单次 Web Animations 淡入，清理标题归位状态时不再重新触发第二段 CSS 入场动画；连续帧检查确保选择页与标题保持可见和稳定。
- 扩展 NaN／Infinity／迟到时长、前半段进度和两位驾驶员真实 MP3 回归；保留应答串行、后台暂停、异常重试、语音 ended 后交接与清理行为。

## 0.51.1 · 2026-10-25

- 修复 macOS 桌面端启用主题后窗口拖不动：全屏装饰与启动层优先挂到宿主 `#root`，避免被 body 直属 portal 的 `no-drag` 规则覆盖。
- 启动时仅隔离祖先链上的兄弟节点，保留启动控件可用，并在退出时恢复宿主原有 inert 状态。
- 启动背景提供窗口拖动；头像、插入栓和两者之间的整条拖放路径，以及语言、音乐、跳过等控件保留普通指针操作。
- 提示音观察器同时监听 body 与当前 root 的直接子节点，并在 root 更换时重新绑定，防止重播叠音及退出后提醒无法恢复。
- 新增 macOS 拖动区域与无 root 回退回归，扩展真实 root 下的启动、拖放、模态隔离与提示音测试；保持界面、素材和启动时序不变。

## 0.51.0 · 2026-10-24

- 驾驶员选择前新增 GIF 同色黑底打字引导，复用两位驾驶员本地线稿与 02／00 编号，不新增图像资源。
- 打字完成后标题从中央归位至选择页左上角，黑底和角色点缀淡出，选择界面渐显；与同步完成时的机械舱门区分。
- 新阶段支持跳过、Escape、后台与减少动态效果；归位期间隔离交互，退出、重播、缩放和卸载回收文字动画及定时器。
- 接入两位驾驶员的原始欢迎 MP3，正常启动完成、舱门退场后播放，聊天可立即操作；重播、后台和卸载回收声音，取消／跳过不触发。
- 从用户提供的打字音轨截取 1.05 秒，为逐字标题添加音效，不降低背景音乐；跳过或后台时立即停止。
- 插入栓保持 14° 装配倾角，筒体轮廓与光照固定、表面标识绕长轴缓慢旋转；装载时平滑归正，减少动态效果下静止。
- 彻底删除试验性的舱门烟雾及相关样式和生成逻辑，保留原有双侧舱门与输入框交接。
- 资源清单、来源说明和启动流程文档同步更新，新增音频按统一规范随包提供。

## 0.50.1 · 2026-10-24

- 项目与包名统一为 dsh-plugin-eva-theme，客户端模块 id 与挂载声明同步更新。
- README 和包描述明确 DSH / DeepSeek Harness、EVA、明日香与绫波丽，仓库地址统一为 seaison/dsh-plugin-eva-theme。
- 保留原有设置、启动会话标记和语言存储命名空间，重命名不重置用户偏好。


## 0.50.0 · 2026-10-24

- 按类型整理全部资源，统一小写短横线命名；assets/manifest.json 记录摘要与大小，PNG、MP3 与原 NERV SVG 原始字节保持不变。
- 大媒体改用同源静态服务，支持内容摘要缓存、ETag 和音频分段读取；客户端从约 19.5 MB 缩至约 231 KB。完整运行包保留全部语音与已获维护者再分发授权的启动背景音乐。
- 等高线计算移至 Worker，保留相同几何函数回退；预解码驾驶员图像、提前准备启动音源、缓存拖动尺寸，降低装载时主线程阻塞，不改动视觉设计与语音时序。
- 测试台归入 tests/，开发工具归入 tools/，截图与参考稿归入 docs/；清理重复启动截图、过期截图工具与系统缓存。
- 新增资源与发布包完整性验证、可重复性能采样和本地发布命令；更新安装、开发、素材来源和 GitHub 发布说明。

本项目遵循[语义化版本](https://semver.org/lang/zh-CN/)。

## [0.49.0] —— 2026-10-24，未发布

- 接入用户提供的四段原始 MP3：明日香／绫波丽各一段人工审核提醒和任务完成提醒，播放时按当前暗色／亮色主题选择，随包嵌入。
- 审核提示只订阅 DSH 的 uiSession.sessionStatus，筛选仍可回答的 approval；按会话和审核标识去重，处理后停止未播完或排队的提醒。任务完成订阅已载入主会话的 binding.eventSource，只接受新增 turn/end 且 reason.kind 为 completed；历史替换、翻页、重复事件、取消、失败与子智能体不误播，不代替用户做审核决定。
- 提示音用独立单音源串行播放，排队的审核优先，启动序列期间暂缓；浏览器阻止播放时在下一次用户操作重试仍有效的提醒，过期、静音或卸载后取消。事件、音源、计时与订阅完整回收。
- 设置新增默认开启的「角色提示音」及审核／完成两种试听；开关自动保存。增加四份 MP3 真实解码与状态／去重／异常／生命周期回归。

## [0.48.0] —— 2026-10-24，未发布

- 根据用户提供的插入栓概念图重绘随包 SVG：白色长筒密封外壳、橙金圆弧端盖、角色色环、金色锁定宽环、石墨护套及橙色整流片，补齐分段接缝、检修盖、机体喷字与 A10／L.C.L. 标注。编号随预览角色切换 02／00。
- 插入栓采用 14° 倾斜装配，驾驶员轮廓与观察舱共用比例和坐标；依据装载区宽高等比缩放，避免窄窗口中头像偏移或端盖裁切。保留原拖放命中区域、选择应答和启动语音时序。
- 修复「选择你的驾驶员」被全局明朝标题样式覆盖的问题，统一完整中文宋体字库、基线和字距，标题与下方说明左对齐；覆盖三语标题、窄屏与矮窗口的布局回归。

## [0.47.0] —— 2026-10-24，未发布

- 接入用户提供的明日香「私に任せなさい！」与绫波丽「……指示をください。」两段选择应答，按住头像即触发，拖动不重复；点击与键盘选择同样可用。换选时停止旧来源，快速装载等待应答完整结束后再播放原启动语音，期间显示三语应答状态并为背景音乐降音。
- 应答错误／播放受阻自动降级，过期播放回调不影响新角色；取消、后台、跳过、重播及卸载释放短音源、监听和计时，后台期间等待手动继续原长语音。
- 驾驶员配色预览增加 0.65 秒底色／文字／SVG／边框平滑过渡、0.7 秒接続扫光与同步页淡入；快速切换替换旧扫光，动画不拦截拖放，减少动态效果时直接切换。
- 扩展真实 MP3 应答至启动的完整串行播放、每次手势一次触发、角色替换、失败及后台处理，以及颜色插值、过渡结束和扫光清理回归。

## [0.46.0] —— 2026-10-24，未发布

- 启动页角色中文名、英文名、编号与语音同步色共用主主题色板，明日香红色 #ff354d、绫波丽蓝色 #176b91；卡片和同步页配套使用各自暗色／亮色表面、正文与次级字色，修复粉红／浅蓝及白字与主题不一致。焦点边框跟随各自角色。
- GIF 帧延迟由 80ms 缩短为 40ms，2 倍速单轮 1.92 秒，循环两轮；开场总时长保持 3.84 秒，后续三秒警报及语音时序不变。仅在内嵌副本修改延迟／循环，源文件、调色板、透明标记与压缩画面保留原字节。
- 新增实际内嵌 GIF 的无损／时序检查，覆盖中英文名字与实际主题主色相等、深浅底文字对比度，以及完整开场不提前结束的回归。

## [0.45.0] —— 2026-10-24，未发布

- 驾驶员选择与语音同步页面新增中文／日本語／English 按钮，立即切换标题、角色名、提示、按钮、异常状态与无障碍说明，保存偏好。切换保留音乐、语音时钟和进度，继续使用用户提供的原始日语语音。
- 认证舱背景重绘为橙色动态等高线：同一连续高度场的山峰、谷地和波纹产生不规则起伏，截线用矢量曲线平滑，保持轮廓连续。20fps 更新，后台与减少动态效果时静止，交接及卸载取消动画帧和监听器。
- 重排右上角语言与音量／跳过操作，覆盖三语窄屏、矮窗口、偏好记忆、播放中切换、错误／重试翻译及等高线生命周期回归。

## [0.44.0] —— 2026-10-24，未发布

- 原 GIF 之后新增约 3 秒黑底红色 NERV 警报，按用户参考图绘制六边形 EMERGENCY、上下三角标、大号 NERV、双行标语及实时时钟；画面和六边形错开明暗渐变，叠加轻微颗粒与扫描纹理，末尾淡出并衔接驾驶员选择。
- SVG 随包嵌入，适配横竖窗口；背景音乐连续播放，新增「跳过警报」，支持 Escape、后台与减少动态效果，衔接及退出时清理时钟、定时器与图案。
- 启动回归覆盖完整 GIF／警报／选择顺序、三秒时长、背景音乐位置连续、模态焦点、跳过、后台与退出清理。

## [0.43.0] —— 2026-10-24，未发布

- 接入通过网易云音乐客户端下载的鷺巣詩郎《EM20#070720》原版 MP3（320kbps、44.1kHz、约 3 分 55 秒），随本地主题嵌入，覆盖 GIF 开场、驾驶员选择和启动衔接。
- 选择阶段以 28% 音量循环播放，角色语音开始时平滑降低至 7.5%，保留独立语音时钟；舱门开启期间淡出，进入聊天时停止并释放音源。跳过、重播、后台和卸载也会取消音频与音量渐变。
- 增加启动背景音乐的独立静音／开启按钮。自动播放受阻时保持启动流程可用，在用户操作后重试；音轨异常不阻塞驾驶员选择或聊天。
- 增加背景 MP3 真实解码、语音降音、静音、播放受阻、后台、进入聊天与卸载停止回归，两套角色以真实音频播放核对。

## [0.42.0] —— 2026-10-24，未发布

- 驾驶员选择与语音同步改为铺满应用视口的 NERV 认证舱，随窗口尺寸调整内容，保留左插入栓、右侧上下驾驶员。背景加入神经连接环、NERV 叶徽、机体编号、插入栓刻度与互锁标记、警戒条纹和 MAGI 三机标识；装载后同步切换角色色与背景头像。
- 语音页面增加同步环和装载信息，环形读数、数字与原进度条都读取同一真实音频进度；为窄屏和矮窗口压缩排版，继续／重试与跳过保持可操作。
- 进入聊天改为约 1.6 秒的双侧舱门解锁，真实聊天和角色背景保持原位，末段细边框引导至输入框；移除旧圆形黑幕与飞行立绘。过渡结束才释放宿主交互并聚焦输入，支持 Escape、后台与卸载清理；减少动态效果时直接进入。
- 修复真实拖放在 Chromium 丢失指针捕获后无法装载：由文档层接续移动／放手，并按最终坐标命中插入栓；离开窗口或取消时回收浮影。编辑器解除交互隔离后下一帧补齐焦点交接。
- 扩展全屏尺寸、语音环、短窗口控件与舱门几何回归，保留真实 MP3 完整播放、拖放及宿主模态弹窗回归。

## [0.41.1] —— 2026-10-24，未发布

- 修复绫波丽角色名字形基线不齐：中央教条区、驾驶员选择与启动名称共用中文宋体优先字库，避免简体字与日文汉字落入不同字体。
- 「深度求索中」、活动过程提示、鲸尾与文字扫光随当前角色换色：明日香红色／浅珊瑚高光，绫波丽蓝色／蓝色高光；保留宿主动画和完成提示的静态语义色，核对两套文字对比度。
- 播放器 NERV SVG 徽记由固定坐标改为圆环中心定位，消除上偏 4px，并覆盖最小／默认／最大倍率下的同心回归。

## [0.41.0] —— 2026-10-24，未发布

- 启动流程改为「GIF → 驾驶员选择 → 插入栓装载／角色语音 → 背景衔接 → 聊天」。保留两倍原 GIF；左侧绘制 EVA 插入栓，右侧上下显示明日香／绫波丽闭眼透明线稿，支持拖入、点击及键盘选择。
- 通过 DSH 官方 theme.setTheme 保存对应暗色／亮色主题，全部 UI 同步切换；接入用户提供的两段 MP3，进度跟随实际音频位置与时长，语音 ended 后才执行约 1.2 秒背景立绘衔接并聚焦聊天输入框。
- 增加模态焦点管理、宿主交互隔离及恢复、后台暂停与继续、播放异常重试、跳过／Escape、重播和卸载清理；减少动态效果时保留静态驾驶员选择并跳过 GIF／衔接动画。
- 设置新增「重新选择驾驶员」入口；新头像和语音无损随包嵌入，增加启动测试台，覆盖真实 MP3 解码、真实点击触发完整播放、拖放、独立语音、真实时钟进度、异常与生命周期。

## [0.40.0] —— 2026-10-24，未发布

- 检测到音源首次出现或来源切换时，播放器显示 650ms「音源接続 / SOURCE LINK」分段载入效果，跟随当前角色配色；控制区始终可用，点击后立即结束遮罩，系统减少动态效果时直接显示。
- 去除控制后的等待光标和全按钮禁用。暂停／继续立即切换图标与机械动画；切歌立即显示方向和内部警戒条纹，连续操作按顺序发送，失败时回滚并清除剩余动作。
- 系统媒体控制在同一次 JXA 调用中核对来源并发送动作，省去控制前的完整元数据查询；点击控制即取消旧轮询，控制后异步校准并隔离过期缓存；系统短暂返回旧状态时最多 1.5 秒校准，避免图标闪回。保留来源切换保护及 Music／Spotify 回退。
- 增加慢响应、快速连续点击、过期查询、控制失败回滚、主题载入效果与减少动态效果回归，宿主测试使用模拟进程桥，不操作真实播放器。

## [0.39.0] —— 2026-10-24，未发布

- 丰富大号 02／00 背景图案：02 增加装甲分层、斜切警示、型号铭文与细节标记；00 增加同心分段环、刻度、原型机铭文与红色定位点，继续随主题和背景强度切换。
- 计费状态及倒计时文字按低谷绿色、高峰红色显示，周末与假日使用低谷配色；标签改为中性底色，核对两种主题下的状态文字对比度。

## [0.38.1] —— 2026-10-24，未发布

- 修复启用皮肤后远程控制叉号无法关闭：将非模态的显示设置改为 region，避免隐藏面板占用宿主 dialog 栈，触发远程控制的嵌套关闭保护。
- 宿主模态弹窗打开时暂时隐藏皮肤立绘和组件，关闭后自动恢复；覆盖两种主题和显示设置展开／收起状态的关闭回归。

## [0.38.0] —— 2026-10-24，未发布

- 原 NERV 开机 GIF 显示尺寸扩大为两倍（256px → 512px），窄窗口按可用宽高等比收小。
- 两种主题均使用素材同色纯背景，仅播放原 GIF 一轮（3.84 秒）后直接结束；移除人物动画实现及未使用的动作素材。

## [0.37.0] —— 2026-10-23，未发布

- 时钟与仪表的尺寸范围统一为 0.6–5，步长统一为 0.05；拖动相同距离、加减按钮和方向键均产生一致的倍率变化。
- 时钟、中央教条区与 TPS 共用基准宽度；恢复默认后均为 1.5 倍且实际等宽，相同倍率下保持等宽。保留已保存的倍率与时钟原有大小，移除旧标签宽度测量及探针逻辑。
- 设置面板从仪表簇中独立出来，桌面放在会话左侧，窄屏使用底部抽屉，避免右侧组件放大时遮住预览或带动面板移动。
- 常用「组件尺寸」「角色背景」直接显示，「装饰与排版」默认折叠；增加单项恢复默认、清晰倍率／百分比、加减按钮及显式关闭，固定标题和底部操作，移除界面内的 Console 操作提示。
- 覆盖统一步长、加减／键盘／重置、面板位置稳定、组件避让、折叠、关闭焦点和多视口回归。

## [0.36.0] —— 2026-10-23，未发布

- 删除四角压暗的设置、遮罩节点、CSS 与默认配置；删除动态效果总开关及全局控制分支，面板减为 10 个开关、4 个滑杆。开机 GIF 与播放状态动画继续运行，并遵循系统减少动态效果偏好。
- 自动清理旧配置中的废弃选项和根标记，保留有效设置与时钟倍率标尺，防止刷新后恢复废弃功能。
- 移除旧壁纸枚举控件的构建与刷新分支；删除 4 张已被当前角色预览替代的历史截图、2 张无引用的局部预览，并停止生成后者。
- 更新文档、目录说明和回归覆盖，核对旧配置迁移、重播取消、后台暂停、系统减少动态效果与卸载回收。

## [0.35.3] —— 2026-10-23，未发布

- 两套主题的半身线稿从原位置向右移动自身宽度的 1/6，偏移量随立绘尺寸变化，继续保持底部贴输入框。

## [0.35.2] —— 2026-10-23，未发布

- 清除两套主题输入卡片外层的宿主铺底渐变与重复区域阴影，去掉输入框两侧的矩形色块。
- 清除会话列表底部使用不同底色的淡出层，去掉明日香主题插件市场上方的色块。
- 在布局测试台还原宿主输入区外层与侧栏淡出层，核对两套主题下的透明绘制。

## [0.35.1] —— 2026-10-23，未发布

- 去掉输入框中推理等级的独立徽章边框与底色，保留文字和模型选择交互。
- 新会话保留按钮最外侧大框，将样式限定到按钮，去掉内部标签与内容容器形成的多层小框；保留悬停底色与键盘焦点提示。

## [0.35.0] —— 2026-10-23，未发布

- 放大左侧半身立绘，以会话区域半宽为目标；高度不足时等比收小，保证头部完整显示。
- 立绘底部改为紧贴输入框上沿，随输入框高度、侧栏和页面缩放调整；补偿两张原图底部的透明留白，使腰部线条实际贴边。
- 扩展几何回归，核对贴边位置、目标尺寸和半身比例。

## [0.34.0] —— 2026-10-23，未发布

- 按用户动作参考，将左侧角色立绘改为侧身回望的半身线稿，露出侧脸、画面截到腰部；保留各自发型和战斗服。
- 更新明日香／绫波丽两张透明 PNG 和对应生成提示词，以 2:3 半身比例布局，最大 320×480 CSS 像素，并随可用视口缩小。
- 保留主题自动切换、背景开关与强度、点击穿透和全屏收起行为，重新核对两种模式与缩放适配。

## [0.33.0] —— 2026-10-23，未发布

- 在角色背景左侧增加明日香与绫波丽的背影线稿立绘，随暗／亮模式切换，保留原右侧 02／00 几何背景。
- 线稿按角色主色绘制，透明内部、右缘轻羽化；共用背景开关与强度滑杆，窄屏降低强度，右栏全屏时收起。
- 根据会话区域和可见视口调整位置与尺寸，保持宿主正文排版、组件倍率、输入与辅助技术行为。
- 使用内置 image_gen 生成两张透明 PNG，原文件与完整提示词随包保存，扩展素材同步检查，运行时不依赖网络或生成目录。
- 回归覆盖真实 PNG 解码、主题切换、背景关闭与强度为零、侧栏变化、窄屏、全屏与页面缩放。

## [0.32.0] —— 2026-10-23，未发布

- 根据用户提供的明日香角色图重配暗色 UI：以战斗服红与黑色为主，绿色领口与橙金发色点缀；替换原酒红底、珊瑚红与蓝色方案。亮色绫波丽配色保留。
- 开机动画改为与 GIF 底色精确匹配的 #000101 全屏纯色背景，仅居中播放原 GIF；移除卡片、文字、载入条、扫描效果和额外退场动画，完整一轮后直接结束。
- NERV SVG 保留在时钟标题和播放器中心，中央教条区只显示当前角色；保留重播、静态模式、后台与卸载回收行为。
- 核对 46 个文本与状态对比度组合，覆盖两种模式下纯背景、实际 GIF 解码、居中适配与播放周期。

## [0.31.0] —— 2026-10-23，未发布

- 将用户提供的 NERV GIF 设置为开机动画：256×256、48 帧、3.84 秒完整播放后淡出，补充角色文字、分段载入条和局部扫描动画。
- 将原始 NERV SVG 添加到时钟标题、播放器机械环中心和开机卡片底部，随角色配色；中央教条区保留当前角色标识。
- 素材原文件随插件打包，由同步工具无损嵌入客户端，运行时不依赖桌面文件、网络图床或宿主重启；检查同步与真实帧时长。
- 设置增加「重播开机动画」，保持每会话仅首次自动播放；关闭动态效果、系统减少动态效果、切到后台和卸载均释放 GIF 与计时器。
- 验证真实图片解码、连续重播、播放中切换角色、完整播放和淡出回收，以及不同视口下的开机卡片适配。DSH Desktop 2.0.17 已实测重播。

## [0.30.0] —— 2026-10-23，未发布

- 改为双角色主题：暗色明日香（深酒红／珊瑚红／琥珀与蓝色点缀），亮色绫波丽（瓷白／冰蓝／红色点缀），自动跟随 DSH 外观与系统模式。
- 重配全部 107 个官方 UI 令牌，统一侧栏、输入框、权限／模型栏、菜单、设置、代码区、时钟、播放器及开机序列。body 提供角色色桥，portal 与覆盖层内外共享颜色。
- 中央教条区简化为当前角色的载入标识，移除原时刻、视口、字号、色板读数与方块流；右栏全屏时保留小型角色设置入口。
- 移除高能预警与 MAGI 三贤人背景，换成明日香的 02 双斜切与绫波丽的 00 细环矢量点缀，保留背景开关与强度设置。
- 保留完成栏警戒线、用户缩放设置、计费／余额、TPS、系统音乐识别和媒体控制；切换角色不重建组件或重置设置。
- DSH Desktop 2.0.17 实测两种模式及设置页面，测试后恢复原先跟随系统。覆盖连续双向切换、已打开的 portal、权限与模型栏同色、组件尺寸与 12 组视口缩放。
- 46 个文本／状态对比度组合通过，36 个可解析令牌保持宿主明暗极性；更新双主题色卡与模拟数据预览。

## [0.29.0] —— 2026-10-23，未发布

- 统一暗色主题下输入框的权限与模型选择栏：黑底、亮黄文字与边框、左侧红色警戒条纹。
- 两栏共用悬停、展开、按下和键盘焦点颜色；模型名、推理等级与图标统一前景色，保留等级标记。
- 保留宿主按钮尺寸与选择交互；DSH Desktop 2.0.17 确认界面配色，客户端 187 项检查通过。

## [0.28.0] —— 2026-10-23，未发布

- 恢复「已完成，用时……」下方斜纹警戒线。DSH 的任务过程按钮使用 `[data-turn-process]` 与底边框，旧规则只覆盖 hr，未作用于该组件。
- 新规则使用稳定属性，警戒带绘制在原有底部留白中；保留按钮高度、完成文字和过程折叠交互，不依赖 CSS 构建哈希。
- 按用户要求移除测绘网格与顶边压力线的选项、面板开关、样式及 DOM；清理旧设置和根元素标记。
- DSH Desktop 2.0.17 确认 1 秒与 2 秒的真实完成栏均显示警戒线；回归覆盖禁用状态、类名变化、按钮高度与折叠操作。

## [0.27.0] —— 2026-10-23，未发布

- 时钟以当前旧倍率 0.6 的实际尺寸作为新的默认 1.5，保持视觉大小并腾出向下调节空间。
- 新滑杆范围 0.6–5，步进 0.025；下限为默认实际尺寸的 40%，上限保留旧版最大实际尺寸。
- 旧时钟倍率自动换算并保存单位标记，保留其他设置，刷新只迁移一次；播放器与时钟继续同倍率、无尺寸跳变。
- 客户端验证旧 0.6／0.65／2 的尺寸迁移、刷新及缩小范围，布局回归覆盖新上下限。

## [0.26.0] —— 2026-10-23，未发布

- 时钟改为「時刻管制」面板，采用与播放器一致的黑底橙框、警戒条纹与边角标记。
- 主时间使用带暗色底段的七段数字，放大时分、弱化秒数；日期／星期、本地时区与 UTC 分栏。
- 新增跟随真实系统秒数的分段刻度，复用现有每秒更新，不增加定时器；保留用户倍率与播放器在时钟下方的定位。
- 本地时区格式改为 UTC±HH:MM，正确显示半小时与四分之一小时时区；UTC 显示精确到秒。
- 解码灯排明确标记为 DECODE，空闲使用中性色，避免让正常走时看起来处于红色停机状态。
- DSH Desktop 2.0.17 实测时钟与播放器组合界面；浏览器回归核对七段引用、信息分栏与缩放关系。

## [0.25.0] —— 2026-10-23，未发布

- 音乐播放器改为 NERV「音声管制」终端：黑底橙框、警戒条纹、六角核心和机械双环，曲名与演出者分层显示。
- 播放时双环反向阶梯旋转、状态格阶梯变化；暂停立即冻结，显示 HOLD；关闭动态效果或减少动态效果时静态显示。
- 分段进度条保留系统真实进度，增加辅助技术可读的进度值；三个控制按钮保留中文名称和清晰键盘焦点。
- 保留系统音乐自动识别、时钟下方位置、用户设定倍率与页面同步缩放。
- DSH Desktop 2.0.17 实测新界面、网易云曲目信息与暂停／继续播放；浏览器回归检查播放动画、暂停冻结与静态模式。

## [0.24.0] —— 2026-10-23，未发布

- TPS 移至中央教条区正下方，与仪表同宽、同倍率；时钟移到原 TPS 的右上位置。
- 按用户要求取消输入栏避让与组件自动收缩，保留设定倍率，随 DSH 原生页面缩放同步放大／缩小。
- 音乐改为系统播放检测：正在播放后显示在时钟下方，暂停保留继续播放／上一首／下一首，来源结束后隐藏。移除本地文件入口。
- macOS 使用固定 JXA 系统媒体桥，覆盖网易云和浏览器媒体会话；不可用时回退 Music／Spotify，其他系统隐藏。
- 控制前重新核对媒体来源；固定动作与独立参数避免脚本插值，卸载取消进程与请求。
- DSH Desktop 2.0.17 实测网易云曲目识别、暂停、上一首、下一首和原生页面缩放。
- 布局回归覆盖固定倍率、TPS／时钟／播放器相对位置、系统播放状态与控制。

## [0.23.0] —— 2026-10-23，未发布

### 修复

- 金额只接受有限数值与非空十进制字符串，空值／布尔值不再误报为零余额。
- 峰谷边界前一秒不再跳过最近切换；未覆盖年份的高峰也标记为推算。
- 音乐在时钟关闭时仍定位到会话头部；外部来源消失后完整恢复本地标题、时间与暂停状态。
- 优先识别正在播放的音乐应用，暂停的 Music 不再压过正在播放的 Spotify；控制动作拒绝继承属性。
- 余额请求增加 10 秒超时；宿主与客户端卸载均取消请求。音乐进程在卸载时取消，失败不会误报控制成功。
- 音乐路由与凭据服务独立注入，非 macOS 不启动 osascript。
- 选项统一校验类型与范围；卸载清除全局 API、全部主题缩放变量与延迟任务。
- 交互控件移出 aria-hidden 范围，开关补名称，设置打开／Escape 关闭时管理焦点。

### 缩放与性能

- 组件共用可见视口与宿主实测布局，响应窗口、页面放大、侧栏变化、输入框增高与节点替换。
- 仪表保留完整／精简／抬升档位，并按可用空间临时缩放；保留用户目标倍率，空间恢复后回到目标尺寸。
- 时钟与音乐统一定位；窄屏简化播放器并隐藏 TPS，避免组件之间及与输入卡片重叠。
- 设置面板保持独立尺寸，按可见空间限宽限高并滚动，绘制在 TPS 上方。
- 分屏时组件留在会话区域；右栏全屏时收起时钟／音乐／TPS，只保留设置入口。
- 秒级读数改为每秒更新；页面隐藏时暂停采样、查询与装饰动画。音乐无来源时降频至 10 秒。
- DSH 内部节点使用集中管理的语义属性／可读后缀钩子，移除构建哈希依赖；自检按页面上下文判断。
- 新增背景强度与静态显示选项，系统减少动态效果偏好覆盖所有主题动画。

### 验证

- 89 项宿主纯逻辑断言、16 项真实宿主路由断言、174 项浏览器行为断言。
- 新增 Chrome 布局测试台：12 组 CSS 视口／DPR，含真实页面放大 150%、组件尺寸极值、侧栏与输入框变化。
- DSH Desktop 2.0.17 实机验证启停、原生缩放、左右侧栏、右栏全屏、尺寸极值和设置入口；测试后恢复原有设置。
- README 同步当前选项与限制；新截图明确标为布局测试台，不冒充真实 DSH 会话。

## [0.22.0] —— 未发布

### 变更：背景换成第 5 级「高能預警」画面

按用户给的参考图重做背景，**原来的三张壁纸（AT 力场 / 生命之树 / 太阳系）全部删除**。

| 参考图要素 | 落地 |
| --- | --- |
| 两侧蜂窝平铺的 WARNING 六边形（交替倒置） | SVG `<pattern>` 平铺，中央用 `<mask>` 抠空 |
| 「高能預警 / EMERGENCY / 非戦闘人員 迅速避難」横幅 | 拉长六边形 + 两侧「警報」方块（斜纹） |
| MAGI 三贤人六边形 + 白色「検証中」印章 | Melchior 1 / Casper 3 / Balthasar 2，下中那枚叠住上面两枚 |
| 中央 NERV 叶徽 | 夹在两枚上六边形之间 |
| 红 + 白 + 黑 | `#ff1a1a` / `#f2f2f2` / 黑（**颜色还原**） |

**闪烁**：三组**互相独立**的硬闪（`steps(1)`，EVA 告警屏是硬闪不是呼吸灯）——
平铺慢闪 3s、警報斜纹快闪 1s、検証中印章中速 1.8s；并尊重 `prefers-reduced-motion`。

### 为什么不用掩膜了

之前三张壁纸都是「掩膜 + `currentColor`」：整块一个颜色、**没法单独驱动某个局部**，
而这张图要**分区闪烁**。所以改成在层里放一段**真 SVG**（5.9KB），红/白各是各自的填充色，
闪烁只挂在对应的 `<g>` 上。整层 `opacity:.5`：红色读得清，正文也压得住。

选项 `wallpaper` 回到布尔（面板里「高能預警背景」开关）。

### 三个自己踩的坑

1. **蜂窝间距算错**：尖顶六边形是「行距 1.5R、行内 √3R」，我写成了反的 ✗。
   更糟的是我随后用**错误的判据**去"验证"（以为中心距 < 2R 就是重叠 —— 六边形共边相邻
   的距离其实是 **√3R**）✗。最后改用 SVG `<pattern>`，让浏览器保证平铺正确。
2. **`String(options.wallpaper)` 写出 `"true"`**：选项从枚举改回布尔后，那行手写的属性
   还在 ✗ → 值成了 `"true"` 而不是 `"on"`。已把它回归 `OPTION_ATTRS`，由统一循环写 on/off。
3. **自己的断言没恢复现场**：一条行为断言结尾用 `removeAttribute` 却**没有恢复**，
   把后面一条断言读到的值清空了 ✗。已改成存原值再恢复。

（另有一次**没加断言的替换静默失败** —— 老毛病，已按惯例每条替换都断言。）

### 测试

浏览器侧断言随旧壁纸一起重写：新增「背景是 inline SVG（非掩膜）」「三种分区闪烁都是
steps(1) 且尊重 reduced-motion」「红/白是各自填充色」「开关能关掉（行为断言）」
「pattern 与 MAGI 三贤人都在 DOM 里」；删掉旧壁纸的四态/自转/reduced-motion 断言。
宿主侧不变（73 项）。

断言：宿主侧 73 项 + 浏览器侧 164 项。

## [0.21.0] —— 未发布

### 新增：显示**其它音乐平台**正在播放的内容

浏览器半边读不到别的应用在放什么（`navigator.mediaSession` 只描述当前文档自己的媒体），
所以这件事由**宿主半边**做 —— macOS 上 Apple Music 与 Spotify 都支持 AppleScript：

- `GET /dsh-eva-magi/nowplaying.json`：跑一段**固定**的 osascript 问系统，
  返回 `{app, state, playing, title, artist, album, duration, position}`，带 1.5 秒缓存；
- `POST /dsh-eva-magi/nowplaying`：`{action}` 只接受 `playpause / next / previous`，
  播放器名**不从请求里取**（用当前正在播放的那个），且仍走白名单；
- 客户端每 2 秒问一次：**外部有播放 → 界面被它接管**（曲名/艺人/时间/进度全部是真值，
  标题行右端显示来源 `Spotify`），**按钮变成遥控器**，**圆轮只在它真的在放时才转**；
  外部没了 → 安静回落到本地文件模式。

**安全**：脚本是固定字符串、不做任何插值；控制动作走 app + action 双重白名单，
插值前再校验一次；路由沿用余额那条的同一道栅栏（回环 Host / 拒 cross-site / 同源 Origin）。
`tests/verify-host.mjs` 里加了 8 条**注入防护**断言（含把 `; do shell script …` 拼进
app 名与 action 的用例）。

**已知边界**：只认识**支持 AppleScript 的播放器**（macOS 上主要是 Music 与 Spotify）。
其它平台系统层面没有可脚本化接口，读不到 —— 这时播放器会安静回落，**不会显示假数据**。
首次读取时 macOS 会弹**自动化权限**询问，允许后才读得到。

### 圆轮更像参考图

对照参考图重画（共四版）：实心轮改成**亮色实心盘 + 暗色的六边形/辐条/轮毂压在上面**
（之前画成亮六边形，不对）；六边形加大、辐条缩短。

### 修复

- **播放/暂停图标写反了**：按钮在播放中显示的是 ▶（应该显示 ⏸）。这是看实机截图才发现的；
  已修，并加了一条断言禁止再写反（未播放 → ▶ / 播放中 → ⏸）。

### 测试

- 宿主侧：46 → **73** 项（新增「正在播放」解析 13 项 + 控制脚本白名单与注入防护 14 项）。
- 浏览器侧：167 → **168** 项（新增图标方向断言）。

## [0.20.0] —— 未发布

### 新增：音乐播放器（样式仿用户给的参考图）

时钟下方新增一块播放器：深红底 + 柠绿 + 橙，**两个圆轮**（左描边 / 右实心亮盘 +
暗色六边形）、两个时间、两个圆点分隔、进度条（橙填充 + 柠绿轨）、三个方块按钮。

**是真的能放**，不是摆设：

- 点曲名区（或未选曲时点任意按钮）弹出**本地文件选择**，可多选成播放列表；
- 用隐藏的 `<audio>` + 对象 URL 播放，**音频不经过任何网络**；
- **播放时两个圆轮才转** —— 用 `animation-play-state` 切换，元素不重排、不重绘；
- 均衡器小条在播放时跳动；播放/暂停按钮的两个图标按状态互换；
- 上一首 / 下一首（列表内循环）、进度条**点击跳转**、当前时间/总时长、曲名（去掉扩展名）；
- 这是全插件少数几个**可交互**元素（layer 本身 `pointer-events:none`，这里显式开
  `pointer-events:auto`）；卸载时暂停音频并释放对象 URL，不留还在响的声音；
- 紧贴时钟下方、左缘对齐，用时钟**缩放后**的实际底边定位，所以调大时钟也不会叠上；
  播放器自己也跟着「时钟尺寸」一起缩放。

新增选项 `music`（默认开）。

### 修复

- **日期超出框线**：右栏 104 → 118px、日期字号 13 → 12px，并加 `overflow:hidden` 兜底。
  实测日期宽 78px、框内宽 94px（改后 108px），不再有溢出风险。

### 过程记录

补丁脚本这次连崩两次，根因是**先转义引号、后按未转义的串切分**（顺序反了）。
已改成每步独立落盘，不再出现「前面几步白做」。

### 测试

新增 4 条断言：播放器结构（2 圆轮 + 3 按钮 + audio + file input）、圆轮默认 `paused`
且播放时 `running`（并确认 `mp-spin` 关键帧存在）、`.eva-mp` 显式 `pointer-events:auto`、
音乐开关关闭时播放器 `display:none`（行为断言）。
计数断言随新选项更新（选项 16 → 17、开关 12 → 13）。

断言：宿主侧 46 项 + 浏览器侧 167 项。

## [0.19.1] —— 未发布

### 变更

- **大时钟尺寸可调**：新增选项 `clockScale`（面板里「时钟尺寸」滑杆，0.6–2.0，
  步进 0.05，默认 1），与「仪表尺寸」并列但**互相独立** —— 想单独放大时钟不必连仪表一起动。

  缩放用 `transform: scale()`、**`transform-origin: 0 0`**：面板的左缘/上缘是对齐到
  正文区的，以中心缩放会把对齐位置带偏。实测三种尺度：

  | 尺度 | 面板尺寸 | 左上角 |
  | --- | --- | --- |
  | 1.0 | 392×148 | [280, 50] |
  | 1.4 | 549×207 | **[280, 50]** |
  | 0.75 | 294×111 | **[280, 50]** |

- **时间显示 + 下方灯排作为整体，与右侧「日付 / DATE」框对齐到同一条水平中线**：
  `.eva-cp-main` 加 `align-items:center`，左栏整体在右栏高度里垂直居中。实测三种尺度下
  **中线差均为 0**：

  | 尺度 | 左栏中线 | 日付框中线 | 差 |
  | --- | --- | --- | --- |
  | 1.0 | 135 | 135 | 0 |
  | 1.4 | 169 | 169 | 0 |
  | 0.75 | 114 | 114 | 0 |

- 顺带修一处瑕疵：日期/UTC 在框里**折行**（`2026-` / `10-04`），已加 `white-space:nowrap`
  （104px 的框放得下 10 个等宽字符）。

### 测试

新增 3 条断言：时钟尺寸滑杆的参数（0.6–2 / 0.05）、改尺寸会写进 `--eva-clock-scale`
且 `transform-origin` 为左上角、左栏 `align-items:center`。
两条计数断言随新选项更新（选项 15 → 16、滑杆 2 → 3）。

断言：宿主侧 46 项 + 浏览器侧 163 项。

## [0.19.0] —— 未发布

### 新增：七段大时钟（复刻「内部 / 外部」电源面板那块显示）

按用户要求在**正文区左上角**（会话头部正下方）加一块面板，形态照参考图：

| 参考图要素 | 落地 |
| --- | --- |
| 亮黄七段数码管 | `HH:MM:SS` 六位，每秒刷新 |
| `活動限界まで` 那行标签 | `現在時刻` + `SYSTEM TIME` |
| `STOP / SLOW / NORMAL / RACING` 灯排 | 跟着**真实解码速度**走（与 TPS 波形同源信号）：0 → STOP、<40 → SLOW、<160 → NORMAL、其余 RACING |
| 右侧 `内部 / 主電源供給 / 外部` 三块（上下带红黑危险条纹） | `内部`（危险条纹 + 本地 UTC 偏移）、`日付 / DATE`（真实日期）、`外部`（危险条纹 + 真实 UTC 时间） |

**七段的画法**：一个数字由 7 段「六边形」路径拼成，段间缝隙靠给每段描一圈黑边
切出来（比逐段留白好控制）；10 个字形定义在 `<defs>` 里各一份，六个位每秒只切换
自己的 `<use href="#eva-dN">` —— 每小时 3600 次属性写入，开销可以忽略。

**位置**：对齐到正文区左上角，而**不是写死坐标** —— 会话头部的左缘 = 正文列左缘，
侧栏宽度又是可变的。实测对齐误差 0（面板 [280,50]、头部左缘 280 / 下缘 40）。

新增选项 `clock`（默认开），可在面板里关掉。

### 两个自己踩的坑

1. **类名撞车（较严重）**：我把面板命名为 `.eva-clock`，但插件**早就在用这个类名**
   表示 HUD 里那个「時刻」读数 ✗ 于是我写的 `position:absolute;left:0;top:0;width:392px`
   **把 HUD 的時刻读数拽到了屏幕左上角** ✗，JS 也抓到了错误的元素。
   实机证据：那个「时钟」元素的 `innerHTML` 是 `11:58:31`、盒子 392×37。
   已全部改名为 `.eva-clockpanel` + `.eva-cp-*`，并确认 HUD 读数恢复、仍显示
   `12:02:49`。
   > 改名脚本还误伤了测试台里一条**旧**断言（它也查 `.eva-clock`）—— 被测试套件当场抓住。
2. **位置停在 [0,0]**：`placeClock()` 在挂载时量会话头部，而头部是**应用异步渲染**的，
   那一刻量不到 ✗。已把定位并入每秒的定时器（顺带还能跟上侧栏宽度变化）。

### 测试

- 新增 4 条断言：面板结构（6 位七段 + 4 灯 + 日期/时区/UTC）、字形引用形如 `#eva-dN`、
  日期是真实值而非占位符、`<defs>` 里 10 个字形齐全。
- 两条计数断言随新增选项更新（选项 14 → 15、面板开关 11 → 12）。

断言：宿主侧 46 项 + 浏览器侧 160 项。

## [0.18.1] —— 未发布

### P8 结案：那条「蓝线」不存在

早前审计时我曾报告「输入框左下有一条细蓝线」（列为 P8）。本次逐项排查后确认
**它是误判，不是缺陷**，附证据：

| 检查 | 结果 |
| --- | --- |
| 全 DOM 扫描蓝色系颜色（背景/边框/阴影/描边/填充 12 项） | **0 条** |
| 输入框底部一线 `elementFromPoint` 逐点命中（x 300–900 / y 870–906） | 全是 `div.…_scroll`，无蓝色元素 |
| 全屏 1600×913 逐像素（canvas 解码截图） | 蓝色像素 **0** |
| 四种交互状态（初始 / 聚焦输入 / 输入后 / 全选） | **全部 0** |
| 回头扫那张旧截图 | 蓝色像素只有 81 个，**全在右上角 x1480–1490 / y20–30**（`rgb(10,115,145)`，app 工具栏图标），与输入框无关 |
| 旧截图输入框区域裁切（未经二次压缩）放大查看 | 蓝色像素 **0**；那个位置是**红橙色的斜向警戒装饰** |

结论：这条「蓝线」来自**我自己查看缩放版 JPEG 截图时的彩色压缩伪影误判**。

### 新增验证技法（写进 docs/architecture.md）

判断「屏幕上到底有没有某个颜色」时不要靠肉眼看看缩放图 —— 把截图**塞回浏览器用
canvas 解码**逐像素判定，不需要任何图像库；拿到坐标后还能用 `elementFromPoint`
把像素映射回 DOM。附带记录了这次误报的完整排查过程作为教训。

断言：宿主侧 46 项 + 浏览器侧 156 项（本次无代码改动，纯文档）。

## [0.18.0] —— 未发布

### 新增（P5）：启动自检

皮肤里有若干装饰**只能用哈希类名**（DSH 用 CSS-module，类名形如 `tPVXea_sectionLabel`）。
DSH 一升级，这些选择器就可能悄悄失效 —— **样式不生效但不报任何错**，极难发现。

现在挂载后延迟 4 秒做一次体检：把 12 条钩子（官方 `data-slot` + 哈希类名 + 类名后缀）
逐一查一遍，缺了必需的那几条就在控制台列出来。

- **全部命中时保持安静** —— 正常使用不该看到任何输出。
- 每条钩子标注 `required`：占位符（仅输入框为空时存在）、侧栏分组标题、弹出菜单
  （需先打开过一次）标为可选，缺了不算问题。
- 只有当「**至少认出一个钩子**、但必需的缺了」才输出 —— 一个都没认出来说明当前不在
  应用页面里（例如测试台），此时同样保持安静。
- 暴露只读体检接口，可随时手动调用：

  ```js
  __EVA_MAGI_THEME__.diagnose()
  // { checked: 12, missing: [{ what, sel, required }] }
  ```

**实测**（真实应用，1600×1000）：

```
checked: 12 · missing: 1
  [可选] 弹出菜单（需先打开过一次）    ← 本次没开过菜单，符合预期
必需钩子 9 条全部命中（含 4 条哈希类名依赖）
4 秒自检窗口内控制台输出：无     ← 全部命中时保持安静
```

### 文档（P6）：补齐配色体系

新增 `docs/architecture.md` 的「配色体系：四个角色（v0.13 起）」与 README 的「配色」一节：

- **角色层**（固定字面量）：面板/结构 **亮黄 `#ffe600`**、数据 主题橙、正常/盈余 绿、
  危险/否定 **红 `#ff2d2d`**、警示胶带 琥珀；
- **令牌层**（跟随明暗）：仪表 / 标签 / 壁纸结构线走 `--dsw-alias-*`；
- **壁纸用设定色**：AT 力场 `#ff9500`、生命之树 `#ffc400`、太阳系回落主题橙；
- 三条配套规矩：结构与数据必须分色、黑底贴片用字面量、贴片必须限定深色主题。

### 测试

- 新增 4 条自检断言：`diagnose()` 存在且返回 `{checked, missing}`、确实在查 DOM
  （测试台没有应用结构 → 应当全部未命中）、清单覆盖已知哈希类名依赖并标注 `required`、
  传入自定义 `document` 时按传入的查。
- 两条 effect 计数断言随新增的自检 effect 更新（4 → 5；第二实例 3 → 4）。

断言：宿主侧 46 项 + 浏览器侧 156 项。

## [0.17.2] —— 未发布

### 变更

- **删除左侧边栏右缘那条多余的黄色线条**（用户指出它与警示带重合）。

  那是 `inset -1px 0 0 0 #ffe600` 画的 1px 硬边黄线，与琥珀警示带并排贴在同一条边上。
  同时把警示带**改回贴齐右缘**（`background-position:right 1px center` → `right center`）——
  这 1px 内移当初就是为了给那条黄线让位，线删了就不该再留缝隙。

  **实测**：

  ```
  box-shadow        none          ← 黄线已消失（它本来就是用 box-shadow 画的）
  background-position 100% 50%    ← 警示带贴齐右缘
  background-size   5px 100%
  条纹基色          color(srgb 1 0.8 0 / 0.4)   ← 琥珀 40%，与屏幕底部那条一致
  侧栏尺寸          280×913        ← 未变
  ```

  顺带核对了侧栏规则里已无其它黄线 / 边框（`ffe600` 与 `box-shadow` 出现次数均为 0）。

断言：宿主侧 46 项 + 浏览器侧 152 项（没有断言依赖那条黄线，无需改动）。

## [0.17.1] —— 未发布

### 变更

- **壁纸改用设定里的代表色**（用户要求），不再统一用 UI 主题橙 `#ff6a00`。

  | 壁纸 | 设定出处 | 代表色 |
  | --- | --- | --- |
  | AT 力场 | 使徒展开的屏障 —— 琥珀橙的六角光壁 | `#ff9500` |
  | 生命之树 | 中央教条区地面刻印 / OP 里那棵树 —— 金琥珀 | `#ffc400` |
  | 太阳系 | **非设定素材**（自己加的），没有"设定色"可取 | 沿用主题橙 `var(--eva-accent)` |

  **实现**：基础规则改成 `color: var(--eva-wall, var(--eva-accent))`，
  每个壁纸在自己的规则里给 `--eva-wall` 赋值 —— 一处定义、互不影响，
  没有专属色的素材自动回落主题橙。

  **实测**：

  ```
  atfield  --eva-wall=#ff9500  渲染色 rgb(255,149,0)  不透明度 0.08
  tree     --eva-wall=#ffc400  渲染色 rgb(255,196,0)  不透明度 0.08
  solar    --eva-wall=#ff6a00  渲染色 rgb(255,106,0)  不透明度 0.08
  ```

  这三个颜色是**固定字面量**（设定色本来就与主题无关，不该跟着明暗变）；
  8% 不透明度下在深浅两套主题里都只是极淡的染色，不影响可读性。

断言：宿主侧 46 项 + 浏览器侧 152 项。

## [0.17.0] —— 未发布

### 新增

- **壁纸改成可切换的 EVA 素材**（用户：「壁纸要体现 EVA 的元素」）。面板里新增一格
  **「壁纸」**，点一下循环：**AT 力场 → 生命之树 → 太阳系 → 关闭**。

  | 取值 | 素材 | 说明 |
  | --- | --- | --- |
  | `atfield`（默认） | **AT 力场** | 全屏六角晶格 + 中心同心六边形与六向辐条；缓慢自转 |
  | `tree` | **生命之树** | セフィロト十个质点 + 22 条路径的线稿图；**静置不转**（设定图转起来反而怪） |
  | `solar` | 太阳系俯视图 | 原有的那套（保留） |
  | `off` | 关闭 | — |

  - AT 力场用 SVG **`<pattern>` 平铺**：**1980 字节**，比逐条 path 版（17555 字节）
    **小 8.7 倍、视觉等价**（掩膜是光栅化使用，pattern 完全可用）。
  - 生命之树**按高度定尺寸**（`auto min(94vh,1020px)`）：它是竖长图、图形只占掩膜宽度
    约三分之一，按宽度定会显得又小又空。
  - 颜色仍走 `background:currentColor` + 掩膜，跟随主题色；不透明度仍是 8%。

### ⚠️ 一处不兼容（但迁移是安全的）

`rings`（布尔）**改成了 `wallpaper`（枚举）**。`loadOptions` 只在**类型一致**时才采用
已保存的值，所以旧的布尔值会被**自动忽略、回落到新默认值 AT 力场** —— 不会报错、
不会卡住。代价是：如果你的壁纸本来是**关着**的，升级后会被打开（改名 + 改成默认 AT 力场）。

### 两个自己踩的坑

1. **AT 力场第一次是全白的** —— 拼 SVG 时我以为末尾是 `</svg>`，其实末尾是最后一条
   `<path>`，`[:-6]` 把它截断了、`<g>` 也没闭合，**Chrome 直接拒绝渲染整个 SVG**。
   现在生成脚本里加了 `xml.etree` 解析校验 + `<g>` 配对断言，不再靠肉眼。
2. **pattern 版第一次是反的** —— `<pattern>` 里的 path **没有显式 `fill="none"`**，
   继承了默认的**黑色填充**；而 `stroke`/`fill` **不会从外层 `<rect>` 继承进 pattern 内容**。
   把 fill/stroke 显式写在 pattern 内部的 path 上才对。

### 测试

- 面板断言从 switch 改为四态循环（默认 AT 力场 → 点一下生命之树 → 循环到关闭时
  `aria-checked=false` → 再点回到 AT 力场），并断言每次切换都写进 `data-eva-wallpaper`
  与 localStorage。
- 新增壁纸四态规则的结构断言（铺满型用 `cover`、生命之树按高度且 `animation:none`、
  `off` 时 `display:none`）。
- 顺带修了三处**断言自身的毛病**：① 印章断言原先切 `chrome` 开关，而关掉 chrome 会把
  **整个覆盖层连同面板一起藏起来**，反而测不准 → 改用默认就存在的两种印章状态；
  ② `.eva-sw` 的选择器要排除四态循环控件（它语义上不是 switch）；
  ③ 读 `style.mask`（简写 getter）对只写长属性的规则会返回空串 → 改读 `mask-size` 等长属性。

断言：宿主侧 46 项 + 浏览器侧 152 项。

## [0.16.4] —— 未发布

### 修复

- **侧栏警示带的亮度与屏幕底部那条对齐**（用户要求）。

  原因：两条的亮度表达方式不同 ——
  `.eva-hazard`（底部）用 **`opacity:.4`** 把整条压暗；而侧栏那条是画在
  `.WYye1W_root` 的 `background-image` 上、**全不透明**，所以侧栏明显更亮。

  侧栏**不能**对元素用 `opacity`（会把整个侧栏内容一起淡化），
  所以把这 40% **折进颜色本身**：

  ```css
  color-mix(in srgb, var(--dsw-alias-state-warn-primary) 40%, transparent)
  ```

  合成结果与底部的 `opacity:.4` **完全等价**（琥珀 40% alpha）。

  **实测**：

  | | 元素 opacity | 条纹基色 | 有效 alpha |
  | --- | --- | --- | --- |
  | 屏幕底部 | `0.4` | `rgb(255,204,0)` 琥珀 | **0.4** |
  | 左侧边栏 | `1` | `color(srgb 1 0.8 0 / 0.4)` | **0.4** |

  基色同一个琥珀（255,204,0）、有效 alpha 都是 0.4 → **合成结果相同**。

### 断言相应改准

原来那条断言要求两条渐变**逐字符相同** —— 现在两条用**不同写法表达同一亮度**，
这个不变量已经不成立。改成断言**数值等价**：

```
侧栏 color-mix 里的百分比  ==  底部元素的 opacity
```

即断言「亮度一致」这个**真正的不变量**，而不是锁死实现写法（哪种写法都行）。

断言：宿主侧 46 项 + 浏览器侧 147 项。

## [0.16.3] —— 未发布

### 变更

- **P4：三条警示带的带宽统一为 5px**（输入框那条原来是 6px，是唯一不一致的一条；
  权限块与侧栏本来就是 5px）。

- **侧栏右缘的警示条纹换成「屏幕底部那条警示带」的同款**（用户要求）：
  原来是输入框那支红（`#ff2d2d`、3px/3px 斜纹），现在与 `.eva-hazard` 完全一致 ——
  **主题令牌 `state-warn-primary`（暗色 `#ffcc00` 琥珀）+ 5px/5px 斜纹**。
  侧栏这条是整屏高的「警示胶带」，与底缘那条同族更协调；用主题令牌所以深浅两套都跟着变。

- 顺带把侧栏那条**内移 1px**（`background-position:right 1px center`）：
  右缘那 1px 留给硬边黄线，两者不再叠在一起（底部那条警示带没有东西压着它，
  这里也让它完整可见）。

### 实测

```
输入框卡片   带宽 5px 100%   条纹 rgb(255,45,45)  红
权限选择器   带宽 5px 100%   条纹 rgb(255,45,45)  红
左侧边栏     带宽 5px 100%   条纹 rgb(255,204,0) 琥珀
屏幕底部     带宽 auto       条纹 rgb(255,204,0) 琥珀

侧栏条纹 === 底部警示带条纹 ?  ✓ 完全一致
```

### 测试两侧各加一条断言

1. 三条带的带宽都必须是 `5px 100%`；
2. **侧栏那条的渐变定义必须与底部警示带逐字符相同** —— 它们同属「警示胶带」一族，
   改了其中一条就得同步另一条，这条断言把两者锁在一起。

另外记一个 CSSOM 的坑：`.eva-hazard` 用的是 `background` **简写且内含 `var()`**，
而 CSSOM **无法把含 `var()` 的简写展开成 longhand** —— `style.backgroundImage` 会返回
**空字符串**。所以断言改用「规范化后的原始声明文本」比对，而不是读 longhand。

断言：宿主侧 46 项 + 浏览器侧 147 项。

## [0.16.2] —— 未发布

### 修复

- **P3：侧栏分组标题补上亮黄**（上一版漏掉了）。

  实测确认根因：`data-slot="sidebar.panellist"` 这类 slot **只是 portal 锚点、不是容器** ——
  插件标题的真实祖先链是 `nav.WYye1W_panelList → div.WYye1W_root`，
  **根本不在那个 slot 底下**，所以早先那条 `[data-slot="sidebar.panellist"] > * > button`
  永远匹配不到。

  **改法**：DSH 的类名是 CSS-module 的 `Hash_name` 形式，于是改用**可读后缀**匹配 ——
  `[data-slot="sidebar"] [class*="_panelTitle"]` / `[class*="_sectionLabel"]` /
  `[class*="_panelRow"]` / `[class*="_sectionHeader"]`。哈希前缀变了也不受影响，
  比写死 `.tPVXea_sectionLabel` 稳健得多；作用域锚在 `[data-slot="sidebar"]`
  （实测它确实是侧栏一切的祖先）。

  **同时纠正一处我上次报告里的错误**：「未分组」**不是分组标题**，它是 workspace 行
  （`_projectText`，与普通工作区行共用同一组件），无法单独选中 ——
  保持行标题原色以保证可读，没有硬上色。

  **实测**：

  ```
  插件标题     rgb(255,230,0)  weight 700  spacing 1.4px
  插件行(按钮) rgb(255,230,0)
  工作区标题   rgb(255,230,0)  weight 700
  工作区区段头 rgb(255,230,0)
  未分组(行)   rgb(232,228,220)   ← 保持原色
  ```

### 过程记录：反引号禁忌我又犯了一次

在 CSS 注释里写了反引号 —— 整段 CSS 是 JS 模板字符串，反引号**提前结束字符串**，
语法直接错。`node --check` 立刻抓到（这条守卫有效，但拦在写入之后，太晚）。
已把这条禁忌写进 `docs/architecture.md` 的显眼位置（连同「注释里也不要写 `${`」）。

断言：宿主侧 46 项 + 浏览器侧 145 项。

## [0.16.1] —— 未发布

### 修复

- **P1：黑底贴片样式全部限定在深色主题** —— 修复浅色主题下文字不可读的真实缺陷。

  从 0.13.0 起，输入框 / 侧边栏 / 弹出菜单用的是**字面量**黑底 + 亮黄
  （复刻 EVA「内部/外部」面板，有意不跟随主题）。但在浅色主题下：

  ```
  label-primary  浅色 #16181c（近黑）
  面板底色        color-mix(#000 88%) ≈ 近黑
  → 对比度 ≈ 1.05:1，文字等于看不见
  ```

  受影响：侧栏会话标题/分组标题、输入框内文字、弹出菜单。

  **修法**：28 条规则的选择器统一加上 `body[data-ds-dark-theme]` 作用域 ——
  这**正是 app 自己切换明暗用的属性**（查了 app 源码：它的令牌块与
  `[data-ds-dark-theme] [data-menu-material]` 菜单样式都挂在该属性下），
  所以作用域与官方机制完全一致。

  **实测**（移除该属性以模拟浅色路径）：

  | | 输入框底色 | 输入文字 | 模型名 | 侧栏底色 |
  | --- | --- | --- | --- | --- |
  | 深色 | `color(srgb 0 0 0 / 0.88)` | 白 | 绿 | 黑 |
  | 移除标记 | **`rgb(255,255,255)`** | app 原生命令色 | 原生命令色 | **`rgb(249,250,251)`** |
  | 恢复深色 | 黑 | 白 | 绿 | 黑 |

  即：浅色下**我的黑底面板整体退场**，回落为 app 原生外观（近白底 + 近黑字，可读）。

  插件原有的皮肤（令牌 / HUD / 标签 / 太阳系）**不加作用域** —— 它们用主题令牌，
  两套主题都正常。

### 测试

- 新增守卫断言：所有「黑底贴片」规则必须带该作用域，缺一即失败（现有 28 条全覆盖）。
- **修了一个测试台保真度问题**：测试台原先不给 `body` 加 `data-ds-dark-theme`，
  导致深色作用域的规则在测试台里**永不生效** —— 之前那些断言只查 CSS 文本所以侥幸通过，
  但任何查计算样式的断言都会**失真地通过**。现已补上。

断言：宿主侧 46 项 + 浏览器侧 143 项。

## [0.16.0] —— 未发布

### 变更

- **左侧边栏统一为「内部 / 外部」面板语言**（与输入框同一套：黑底 + 硬边黄线 +
  红黑危险条纹 + 亮黄强调）。

  | 部位 | 钩子 | 做法 |
  | --- | --- | --- |
  | 侧栏面板本体 | `.WYye1W_root`（**哈希，尽力而为**） | 黑底 + 右缘 1px 硬边黄线 + 右缘 5px 红黑危险条纹 |
  | 品牌 logo / 名字 | `data-slot="sidebar.brand.mark"` / `.brand.name`（官方） | 亮黄；名字再加大写 + 等宽 + 字距 |
  | 新会话按钮 | `.WYye1W_newSession`（**哈希，尽力而为**） | 黑底黄框、悬停黄底 |
  | 设置 / 页脚动作 / 面板按钮 | `data-slot="sidebar.settings"` / `.footer.action` / `.panellist`（官方） | 亮黄 |
  | 会话行的前导标记 | `data-slot="sidebar.session.row.leading"`（官方） | 暗黄；**标题本身不动**，保证可读 |

  颜色仍用字面量。实测侧栏面板仍是 **280×913**、内容列起点仍是 **280px**。

### 一处结构性限制（值得记下来）

侧边栏**没有 `data-sidebar-left` 这类钩子**（只有右侧栏有）。可用的稳定钩子是
`data-slot` 系列（`sidebar` / `sidebar.brand.*` / `sidebar.session.row.*` …），
**但它们全部带 `display:contents`（0×0 盒子）** —— 只能靠继承与后代选择器生效，
**给不了侧边栏本体的背景/边框**（那层是哈希类名 `.WYye1W_root`）。

所以这一版分两档处理：**面板本体用哈希类名（尽力而为，类名一变就静默失效、
不会弄坏任何东西）**，**文字与强调用 data-slot 稳定钩子**。
断言里加了一条守卫：侧边栏规则**不得触碰 width/height/padding/display/position**
（slot 是 `display:contents`，一旦被改就会塌掉）。

断言：宿主侧 46 项 + 浏览器侧 141 项。

## [0.15.1] —— 未发布

### 变更

按用户要求调整三处颜色：

| 部位 | 改前 | 改后 |
| --- | --- | --- |
| 模型名 | 暗灰（`label-secondary`） | **#7cff4f** —— 与「峰谷时段」标签栏**同一个绿** |
| 推理等级 | 橙（`brand-primary`） | **#ff2d2d 红字**（+ 红描边、红光晕、悬停红底） |
| 输入正文 | 亮黄 #ffe600 | **白色 #fff**（光标也白，去掉黄色光晕） |

**绿色是实测比对过的**：峰谷/休日标签栏用的是 `--dsw-alias-state-success-primary`，
暗色主题下取值即 `rgb(124,255,79)` = #7cff4f；模型名写字面量取同一个值
（不用令牌的理由还是那条：输入框是黑底贴片，浅色主题下该令牌是暗绿 #1f8f3a，
压在黑底上读不清）。

红色沿用输入框右缘危险条纹的同一支红，保持整块内部一致。
面板本身的黄色（硬边黄框、暗黄占位符）保持不变。

实测：模型名 `rgb(124,255,79)` / 峰谷标签 `rgb(124,255,79)`（同一个绿）、
推理等级 `rgb(255,45,45)`、输入正文与光标 `rgb(255,255,255)`、
输入卡片仍 **877×98**。

### 一条断言被改准

原断言写的是「这些规则**必须出现** `--dsw-alias-` 令牌」—— 那是把实现细节
当成了不变量。改成本选择器改用字面量后它假失败。**真正的不变量只有一条**：
出现过的变量必须都是主题令牌（`--dsw-*`），或干脆不用变量。已改成这个形式。

断言：宿主侧 46 项 + 浏览器侧 138 项。

## [0.15.0] —— 未发布

### 变更

- **整个输入框（含点开的选项菜单）统一为 EVA「内部 / 外部」面板语言**
  （延续 0.14.0 的权限选择器）。

  | 部位 | 钩子 | 做法 |
  | --- | --- | --- |
  | 输入卡片 | `[data-composer-card]`（官方） | 黑底 + 硬边黄框（inset）+ **右缘 6px 红黑危险条纹** |
  | 输入区 | `[data-composer-input]`（官方） | 亮黄正文 + 黄色光标 |
  | 占位符 / + 按钮 / 发送按钮 | 哈希类名（**尽力而为**） | 暗黄占位符；+ 按钮黑底黄圈；发送按钮黄底黑字 |
  | 弹出菜单 | `role="menu"` + `data-menu-material` | 黑底 + 硬边黄框；读数行照参考图 `CODE : 258` 排：**标签亮黄加粗、值等宽暗黄**；项悬停黄底 |

  **尺寸一律不动**：实测卡片仍是 **877×98**、输入框整行仍是 **98px**。
  颜色仍是字面量（黑底贴片，理由同 0.14.0）。

  「+ 按钮 / 发送按钮 / 占位符」没有稳定钩子，只能用哈希类名做尽力而为的样式 ——
  类名一变这些样式就**静默失效**（不会弄坏任何东西），这是刻意的取舍，已在注释里逐条标注。

### 两个自己踩的坑（都被工具逮住）

1. **注释里写了反引号** —— 本段 CSS 是 JS 模板字符串，反引号把字符串**提前截断**，
   整份客户端脚本语法错误。`node --check` 直接抓到（所以那轮实机验证全是 `undefined`）。
   已在注释里写明这条禁忌。
2. **特异性打平、被更靠后的旧规则盖掉** —— 本项目更靠后有一条
   `:is([role=dialog],[role=menu],[role=listbox])` 的弹层橙描边规则，与
   `[role=menu]` 的**特异性完全相同**（0,2,1），靠源码顺序它赢：实测菜单描边被染成
   橙色 `rgb(255,106,0)`。加上官方属性 `data-menu-material`（→ 0,3,1）后与顺序无关地生效。

  > 附带一条测试教训：断言里用 `selectorText.includes('[role="menu"]')` 过滤时，
  > `:is([role="dialog"],[role="menu"],…)` **也含这个子串**，会误判；必须显式排除 `:is(`。

断言：宿主侧 46 项 + 浏览器侧 138 项。

## [0.14.0] —— 未发布

### 新增

- **访问模式（权限）选择器改用 EVA「内部 / 外部」电源面板的设计语言**
  （用户提供参考图：黑底 + 亮黄大字 + 硬边黄框 + 红黑危险条纹）。

  - 钩子同样是官方的 `data-slot="conversation.input.permission"`（不是 `Vg9r4q_*`
    这类哈希类名）；按钮在 `span` 里，所以用后代选择器 `[data-slot=…] button`。
  - 落地：黑底面板（86% 黑）+ **亮黄 #ffe600** 粗体字（带微光）+ **硬边黄框**
    （`box-shadow: inset`，不占布局）+ **左缘 5px 红黑危险条纹**
    （`background-image` + `background-size:5px 100%` 画在原内边距里，不挤文字）。
    图标与箭头的 `currentColor` 随之变黄。
  - 悬停：底色转黄、外圈加辉光。

  **颜色是字面量而不是主题令牌**，这是有意的：这块是"仪表贴片"而非主题表面，
  黑底上的亮黄/亮红在任何主题下都可读；而浅色主题的 `state-warn` 是暗琥珀，
  压在黑底上根本读不清。代价是不跟随主题 —— 已在注释里写明理由。

  **只碰绘制类属性**：实测控件仍是 **104×28**、输入框整行仍是 **98px**。

### 实测（1600×1000 视口）

```
控件 104×28（未变）· 文字色 rgb(255,230,0) · 字重 700 · 字距 1.04px
黑底 color(srgb 0 0 0 / 0.86) · 危险条纹 repeating-linear-gradient(45deg, rgb(255,45,45)…)
条纹尺寸 5px 100% 位置 0% 50% · 黄框 rgb(255,230,0) 0 0 0 1px inset
输入框整行高度 98px（未变）
```

断言：宿主侧 46 项 + 浏览器侧 134 项。

## [0.13.0] —— 未发布

### 新增

- **模型 / 推理等级选择器改用 EVA 语言**（用户提问「可以修改吗」→ 可以，已实现）。
  - 钩子用的是**官方的 `data-slot="conversation.input.model"`**（不是 `VYXhfG_*`
    这类哈希类名），所以对版本变化有韧性。
  - 结构是 `button` 下依次「图标 svg / 模型名 span / 推理等级 span / 箭头 svg」，
    因此用 `span:first-of-type` / `span:last-of-type` 定位。
  - **模型名**：等宽 + 大写 + 字距拉开（EVA 系统标签的排法）。
  - **推理等级**：做成硬边小印章（橙色），与操作面板里的 承認/否定 同一套印章语言；
    悬停时整块加内描边、印章反白。
  - **只碰绘制类属性**：颜色 / 字体 / 字距 / 内描边（`box-shadow: inset`，不占布局）。
    实测控件高度仍是 28px、输入框整行高度仍是 98px —— 布局没有被挤动
    （宽度因大写与字距从 208 → 226，右对齐控件，无副作用）。

### 踩到的坑（同类第二次）

`var(--eva-accent)` 只定义在 `.eva-magi-layer` 上，而**模型选择器在输入框里、
属于层外** → `color` 声明被丢弃、`color-mix()` 拿到非法颜色导致**整条
`box-shadow` 被丢弃**（实测读到 `"none"`，颜色也没上，而且**不报任何错**）。

层外元素必须用主题令牌 `--dsw-alias-*`（由主题服务内联在 `<body>` 上）。
上次是开机序列的 NERV 标志踩的同一个坑。已写进 `docs/architecture.md`，
并在测试台加了两条守卫断言：选择器样式块不得出现 `var(--eva-*)`、
不得触碰 width/height/padding/font-size/display。

断言：宿主侧 46 项 + 浏览器侧 131 项。

## [0.12.2] —— 未发布

### 变更

- **操作面板里的 `ON / OFF` 换成参考图的判决印章：承認（青绿实心）/ 否定（红色描边）。**
  只改这一处 —— 分组标题、选项卡布局、其它装饰一律不动。

  - 新增 `--eva-magi:#6ef3d0`（EVA MAGI 界面的标志青绿）。它是固定造型色、
    不在主题令牌里，所以用字面量；橙色 `--eva-accent` 仍是主题驱动的。
  - 承認 = 青绿实心 + 暗字；否定 = 透明底 + 红色描边文字（`state-error-primary`，
    主题驱动，浅/深色都跟着变）。
  - **尺寸不变**：`min-width:40px` 本来就容得下两个汉字，实测两种状态的盒子
    都是 40×17，面板高度 562px 与改前一致，布局一点没动。
  - `aria-checked` 与原 `title` 保留原语义，不影响可达性。
  - CSS 里状态规则放在通用 `:hover` 之后 —— 否则 hover 的橙色会盖掉状态色。

### 实测（1600×1000 视口）

```
承认  bg rgb(110,243,208)  color rgb(5,38,31)   40×17
否定  bg rgba(0,0,0,0)     color rgb(255,59,48) 40×17
11 个开关文本：承認 承認 否定 承認 否定 承認 否定 承認 承認 承認 承認
```

断言：宿主侧 46 项 + 浏览器侧 128 项。

## [0.12.1] —— 未发布

### 变更

- **太阳系装饰铺满全屏并缓慢自转**：
  - 掩膜改为 `cover`，画面被轨道纹理填满、外圈自然溢出屏幕边缘；
  - **240 秒自转一圈**（1.5°/秒）。用 `transform: rotate()` 而不是动
    `mask-position` —— transform 走 GPU 合成、不重绘，动 mask 位置会每帧重绘整屏；
    `transform-origin` 对准掩膜里太阳的位置，于是**太阳不动、行星绕它转**；
  - 用**一个 142vmax 的正方形**承载（`sqrt(2)` 的上取整）。这一步是关键：
    元素若仍是 `inset:0` 的矩形，自转到一定角度时矩形四角会露出"没画到的边"，
    外圈轨道会被切成直线。正方形边长 ≥ 视口对角线 → **任意角度都盖住视口**；
  - 土星环改为**对称环**（去掉原来的 -22° 倾角）：整图自转时，倾斜环会看起来
    像环自己在打转；
  - 尊重系统的「减少动态效果」设置（`prefers-reduced-motion` 时停转，也顺带省电）。

### 实测（1600×913 视口）

| 检查 | 结果 |
| --- | --- |
| 元素中心 | (800, 420) = `50% 46%` = 掩膜里太阳的位置 |
| 布局尺寸 | 2272×2272（142vmax） |
| 半边长 / 最远视口角距离 | 1136 / 940 → **余量 196px** |
| **任意旋转角都盖住视口** | **true**（这正是上面那个正方形的作用） |
| 实际转速 | 5 秒 +7.50°、6 秒 +9.000°（= 360°/240s） |
| 不透明度 / 掩膜 | 0.08 / `cover` |

### 两个"自己坑自己"的记录

1. 验证覆盖时用 `getComputedStyle().left + width/2` 算元素中心 —— 漏掉了
   `margin-left:-71vmax` 那段偏移，于是算出 `coversAtAnyRotation: false`，
   看起来像产品 bug。改用**旋转包围盒的中心**（旋转不改变中心）才算对。
2. 断言用 `cssText` 正则匹配 `animation: eva-orbit 240s linear infinite` 假失败 ——
   `cssText` 会把简写重排成 `240s linear 0s infinite normal none running eva-orbit`。
   改用 CSSOM 逐属性断言。

断言：宿主侧 46 项 + 浏览器侧 126 项。

## [0.12.0] —— 未发布

### 变更

- **「同心雷达环」改为「太阳系俯视图」**（同一个开关，键名仍沿用 `rings` ——
  用户已保存过这个设置，改名会让他们的开关状态回到默认）。
  内容是**俯视视角的简单线稿**：中心实心太阳 + 外圈光晕、6 条轨道、
  轨道上的 6 颗行星，外加土星的小椭圆环与地球的一颗月球 —— 共 16 个形状，
  data URI 仅 **1411 字符**（相比 NERV 标志那版 30KB，轻得多）。

  实现沿用已验证的掩膜技法：SVG 里线稿画成**白色描边**，只当掩膜用，
  实际颜色由 `background:currentColor` 提供 → 自动跟随主题色；
  尺寸 `min(78vh,900px)`、位置 `center 46%`，与原来同心环同一套定位。
  不透明度取 **0.08**，与原来（accent 11% × opacity .5 ≈ 5.5%）同档的微弱水印。

  面板标签同步改为「太阳系俯视图 / 线稿」。

### 实测（1600×1000 视口）

| 检查 | 结果 |
| --- | --- |
| 元素尺寸 | 1600×913（`inset:0` 铺满） |
| 不透明度 | 0.08 |
| 掩膜 | 已加载，尺寸 712px（= 78vh），位置 50% 46% |
| 面板标签 | 太阳系俯视图 |
| 开关联动 | `rings=off` → `display:none` |

断言：宿主侧 46 项 + 浏览器侧 123 项。

## [0.11.1] —— 未发布

### 修复

- **TPS 波形面板不再随读数位数改变大小**。读数（当前值 / PEAK / AVG）原来是自由宽度，
  数字从 1 位涨到 4 位时会把「TPS / DECODE」标签挤来挤去，甚至可能换行把面板撑高。
  现在：面板高度写死 78px（1 边框 + 21 头 + 37 波形 + 18 脚 + 1 边框）、
  `overflow:hidden`；头/脚显式 `line-height` + `white-space:nowrap`；
  三处读数各给固定槽位（`min-width` + 右对齐 + `tabular-nums`）。

  实测四种读数下的面板尺寸：`—` / `88888` / `1234567` / **40 个字符**，
  **全部是 201×117，一点不变**。

### 变更

- **两个方形指示灯改为常亮**（不再闪烁）：TPS 面板头部的 5px 方块、
  下方仪表「■ NERV」的 6px 方块。`eva-blink` 关键帧保留 ——
  峰谷临近切换（≤30 分钟）时状态标签的闪烁预警仍在用。

断言：宿主侧 46 项 + 浏览器侧 123 项（新增"两个方块无动画"与
"面板尺寸不随读数位数变化"两条，后者把宽度也一起断言了）。

## [0.11.0] —— 未发布

### 新增

- **右上角 TPS / 解码速度波形面板**（MAGI-1 正下方），与下方仪表盘**共用同一条
  右边缘（实测都是 1582）、同宽**，并跟随它的尺寸（`hudScale`）与「仪表」开关。
  面板内容：闪烁状态点 + 「波形 / TPS · DECODE」+ 当前值 + 网格示波区 + 折线 +
  PEAK / AVG。`pointer-events:none`，不会挡到应用。

  **数据来源与算法**：DSH 的 `sessionStats` 投影（界面上那个「257 tok/s」就是它算的：
  `decodeTokens / (decodeMs / 1000)`）。但那是**会话累计均值**，直接画出来几乎是条
  直线 —— 所以改成每 400ms 采样投影的原始分量、按间隔求**增量**，得到该区间内的
  瞬时解码速度，44 个采样点滚动成波形。纵轴自适应、保底 60 tok/s（空闲时不把噪声
  放大成满屏）。面板 `title` 里写着 `decodeTokens / decodeMs / 瞬时值`，便于排查。

  会话 id 取自会话区域的 `data-conversation-session` 属性；`sessions` 服务同样用
  子作用域 `ctx.inject(["sessions"], ...)` 可选注入 —— 服务缺失时皮肤照常工作，
  只是波形没有数据。

### 踩到的两个坑（都写进注释了）

1. **CSS 插错了位置**：插入锚点用了 `.eva-tags{`，结果匹配到
   `.eva-corner-stack[data-fit="compact"] .eva-tags{display:none}` 里的那一处 ——
   整段 TPS 样式被塞进了那条规则，变成只在 compact 档位生效（平时完全没样式，
   面板铺满整个视口宽）。教训：CSS 锚点要选**唯一且带上下文**的串。
2. **定位父级不同**：TPS 面板原本写在顶栏标记里，它的定位父级是顶栏容器，
   与下方仪表盘（直接挂在 layer 上）不是同一个 —— `right:18px` 算出来差 6px。
   改成把它 `appendChild` 到 layer 下即对齐。另外补了 `box-sizing:border-box`，
   否则 1px 边框还会再差 2px。

断言：宿主侧 46 项 + 浏览器侧 121 项。

## [0.10.1] —— 未发布

### 变更

- **背面的余额标签占满正面两条标签的总高度**，数字相应放大。
  实测（布局 px，除以缩放后的真实排版尺寸）：

  | | 宽 | 高 |
  | --- | --- | --- |
  | 正面两条合计 | 134 | 44（18 + 5 间隙 + 21） |
  | 背面余额标签 | 134 | **44** |

  - 数字从 11px 放大到 **22px** 粗体 + 辉光；
  - 标签**改竖排**（数字在上、名称「残高」在下）：这样宽度只由数字决定（≈95px），
    若保持并排，放大后的数字加名称会超过锁定的 134px —— 锁定值被推大，
    默认 1.5 倍下就会被挤出右下角。
  - 因为只是**高度**变大、宽度没变，锁定值仍是 134px、`fit` 仍是 `full`、
    整栈宽度仍是 201px（实测确认）。

## [0.10.0] —— 未发布

### 移除

- **自动适配窗口**（`hudAutoScale`）整体删除 —— 用户反馈不实用。
  仪表尺寸完全按用户设定，窗口变化时不再自动缩放（右下角的自动避让仍然保留：
  留白不够会降级为 compact / 抬到输入框上方）。
  一并删掉 `AUTO_SCALE_FLOOR`、`appliedScale`、`--eva-hud-scale-eff` 与那个空转的
  `applyScale` 辅助函数。
- **`pricing` 开关及其"关闭态"文案**删除 —— 用户反馈不实用，直接常显当前峰谷状态即可。
  原来关掉它会退回静态装饰文案（`警戒態勢 / NORMAL`、`記録 / LOG`），这套连同
  锁定探针里的对应项、以及 `data-state="off"` 的样式一起删掉。

### 变更

- **背面的两个余额标签合并成一个**，用原来上面那个标签的样式（暗底橙字 LED）。
  背面只有一个标签，所以在那一格里垂直居中 —— 整块高度仍由正面（两个标签）决定，
  翻面时高度不变。

### 实测（1600 宽窗口）

| 检查 | 结果 |
| --- | --- |
| 正面恒为实时峰谷（无开关） | `休日料金 HOLIDAY` + `4日05:52:56 切换` |
| 背面标签数 | **1**（`¥13.82 残高`，201×29） |
| 窗口 1400 / 1200 下的倍率 | **恒为 1.5**（不再自动缩放；角落不够时照常 lifted） |
| 8 秒自动翻回 | 1.8s / 4.8s 为背面 → 9.0s 回到正面 |

### 踩到的坑

- 删自动适配时漏掉了 `applyScale` 辅助函数，它仍引用已删除的 `appliedScale` ——
  一调用就 `ReferenceError`。编译期看不出来（`node --check` 过），是残留检查
  （grep `appliedScale` 仍有 2 处命中）抓到的。

断言：宿主侧 46 项 + 浏览器侧 116 项。

## [0.9.0] —— 未发布

### 移除

- **「今日已用」功能整体删除**（用户要求，不留备份）：
  - 宿主半边删掉 `session/event` 用量记录器与响应里的 `usage` 字段；
  - 浏览器半边删掉价目表、计费函数、日界计算、汇总函数及其导出；
  - 测试台删掉相关的 20 项记账断言。
  宿主半边现在只做一件事：提供只读余额路由。

### 变更

- **翻面后两行都显示余额**：第一行 `¥13.92 残高`（主读数）、第二行 `¥13.92 可用`。
  原来第二行是「今日已用」，功能删除后改为同样显示余额。
- **翻面 8 秒后自动翻回**正面（`AUTO_FLIP_BACK_MS = 8000`）。
  用的是同一个 CSS `transition`，所以来回动画完全一致；中途再点一下也会即时翻回，
  并取消待执行的定时器。插件卸载时同样清掉定时器。

### 实测（1600 宽窗口）

| 时刻 | 面 | 第一行 | 第二行 | 栈宽 |
| --- | --- | --- | --- | --- |
| 翻面前 | front | — 残高 | — 可用 | 201px |
| 1.8s | back | ¥13.92 残高 | ¥13.92 可用 | 201px |
| 4.8s | back | ¥13.92 | ¥13.92 | 201px |
| 9.0s | **front**（自动翻回） | — | — | 201px |

宽度全程 201px、标签几何 201×29 与 201×32 均未变。

### 踩到的坑

- 测试台的 Chrome 启动参数是 `--virtual-time-budget=4000`，而「8 秒后自动翻回」
  这条用例要等 8.5 秒 —— 预算不够时页面会被提前 dump，读到的是 `not-run`，
  看起来像"测试台整个挂了"。预算提到 25000 即恢复（虚拟时间下等待是瞬时的，
  所以并不会拖慢正常跑：整跑仍是 0.9 秒）。

## [0.8.1] —— 未发布

### 修复

- **开关 `pricing` 不再改变仪表宽度**（用户反馈）。
  根因：宽度锁定**故意排除**了 `pricing:false` 时那套静态文案，因为它宽 153px、
  超过倒计时的 134px —— 含进锁定会把锁定值推大、默认 1.5 倍下把仪表挤出右下角。
  当时记为"可接受"，但用户要求不变，于是把**文案本身收窄**到锁定值之内：
  `警戒態勢 通常 / 会話記録 / TRANSCRIPT` → `警戒態勢 / NORMAL` + `記録 / LOG`，
  并把这两条加回锁定探针 —— 现在"开关不改变宽度"是被锁定**保证**的，不是碰巧。
  实测：开启 / 关闭 / 复原三种状态栈宽都是 **201px**。

### 新增

- **自动适配窗口**（`hudAutoScale`，默认开，面板里可关）。
  窗口变窄/变矮时把整栈**整体缩小**以留在右下角，而不是丢标签块或跑出角落；
  倍率下限与滑杆下限一致（0.7），缩到下限仍放不下才退回 lifted。

  实测（窗口宽度 → 有效倍率）：

  | 窗口宽 | 有效倍率 | 档位 | 栈宽 |
  | --- | --- | --- | --- |
  | 1600 | 1.50 | full | 201px |
  | 1400 | 1.24 | full | 166px |
  | 1200 / 1050 / 900 | 0.70（下限） | lifted | 94px |

  实现上引入 `--eva-hud-scale-eff`（实际生效倍率）与 `--eva-hud-scale`（用户设定）
  两个量：用户设定是上限，适应窗口时只减不增；设置面板按 `--eva-hud-scale-inv` 反向
  抵消，所以面板尺寸始终不变。

### 踩到的坑

- 自动适配的**顺序**很关键：必须先量出输入框位置、算出真实留白，再定倍率。
  第一版用的是 `window.innerWidth`（整个视口 1600px），算出来 11 倍 → 永远不缩，
  窗口变窄时照样丢标签（实测 1400/1200 下 eff 仍是 1.5，才发现的）。

## [0.8.0] —— 未发布

### 新增

- **余额数字突出显示**（按要求**不动两个标签的位置和尺寸**）。
  只用绘制类属性：暗底 + 橙色字、字重加粗、`text-shadow` 辉光、
  `box-shadow` 内描边（不占布局）+ 外发光。字号/内边距/行高一行未改。
  实测标签仍是 **201×29**，与改动前一致；只有 `background` 从橙变成 `rgb(11,11,11)`、
  字色变成橙色 accent。
- **今日已用：本地记账（token 数 × 价目表）**。
  - 宿主半边订阅 `session/event`，把 `assistant/message` 事件里的
    `{inputTokens, outputTokens, cacheReadTokens, cacheWriteTokens}` 连同模型名与
    时间戳记成精简记录（**只记 token 数与模型名，不记任何对话内容**），
    保留 36 小时、上限 400 条，随余额一起回传。
  - 计价在浏览器半边做：价目表与峰谷规则只有这一份，宿主不复制 ——
    否则同一套规则维护两处，改一处忘一处就会算错钱。
  - 计价口径：命中 = `cacheReadTokens × 0.02/0.04`、未命中 = `inputTokens +
    cacheWriteTokens × 1/2`、输出 = `outputTokens × 4/8`（元/百万，空闲/高峰；
    Pro 档为 3 倍）。逐条按**各自时刻**的峰谷价计算。
  - 同一 (turn, step) 只取最后一次：重试会在日志里留下多条 `assistant/message`，
    全加会把同一轮算两遍。
  - 一次翻面只发**一次**请求，同时刷新余额与今日已用。
  - 界面标注「按价目表本地概算，非账单」——价目表硬编码，官方调价即过期。

### 已验证 / 未验证（如实记录）

- ✅ 计价逻辑：132 项断言，含北京日界、峰谷两档、重试去重、Pro 档、逐条按各自时刻计价、
  缺字段不产生 NaN、无记录显示 ¥0.00。
- ✅ 宿主路由：实机确认返回 `usage: []` 且无报错。
- ✅ 余额突出显示：实机确认几何未变（201×29）、配色已变。
- ⚠️ **未验证**：`session/event` 是否真的把用量事件送到宿主。
  我想在测试实例里真发一条消息来产生用量，但 **CDP 驱动输入框没成功**
  （探针返回 `undefined`、页面里没出现用户气泡）——所以"记录数 0"证明不了订阅有问题。
  这一步需要在真实界面里发一条消息来确认：翻面看「今日」是否变成正数。

### 踩到的坑（都写进注释了）

- `remote.session` 这类**作用域远程服务必须写进 inject 才会被建立**；只注
  `"remote.session"` 时访问 `scope.remote` 会抛 `cannot get property "remote" without inject`，
  而单独取 `scope["remote.session"]` 拿到的是通用代理（没有 `listSessions`）。
  两者要**一起注入**（官方 settings-account 也是 `["remote","remote.account"]`）。
- 客户端的方法名与宿主不同：客户端是 `list`/`page`/`projections`，
  宿主是 `listSessions`/`readSessionState`；`page` 还要驱动 `{address, throughSeq}` 游标分页。
  最终没走客户端读取这条路，改用宿主 `session/event` 事件流。
- `.eva-tag--balance` 的样式规则写在基础规则 `.eva-tag` **之前**，同权重被后者盖掉
  （底色仍是橙）——改用 `.eva-tag.eva-tag--balance` 提权，不依赖源码顺序。

## [0.7.2] —— 未发布

### 修复

- **峰谷状态与倒计时变化时，右下角整块不再抽动。** 状态文案会随峰谷在
  空闲料金 / 週末料金 / 休日料金 / 高峰料金 PEAK RATE 之间切换（字数不同），
  倒计时跨过 24 小时还会丢掉「N日」前缀 —— 宽度一变整块仪表就抖一下；
  而上一版刚把三条对齐，抖动会波及全部三条，比不对齐时更显眼。

  做法：把整栈宽度**锁定**成「最宽可能内容」的宽度（`min-width`）。

  - 用**离屏探针**量（`position:absolute; width:max-content`，挂在 body 上），
    而不是就地量真实标签：就地量会受当前档位影响 —— 挂载瞬间标签还没参与排版，
    量到的是仪表的自然宽度（102px），锁了个偏小的值等于没锁（实测踩到过）。
  - 只遍历**会自发变化**的形态：四种状态文案 + 倒计时（带/不带天数）+ 余额背面。
    刻意不把 `pricing` 关掉时的那套静态文案算进来 —— 它不会自己变，而且明显更宽
    （153px，会让默认 1.5 倍直接降级成 lifted）。
- **推算标记（推定）从文字改为纯样式**（虚线下划线 + 悬停提示）。加「推定 」会把
  状态标签撑到 140px、超过倒计时的 134px，整栈跟着加宽 6px —— 而默认 1.5 倍下
  就差这 6px 把仪表挤出右下角。改成样式后宽度一点不变，信息也没丢。
- 呼吸余量 6px → 4px（`GUTTER` 24 → 22），给锁定后的宽度留出裕量。

### 实测（1600 宽窗口、默认 1.5 倍）

| 文案变化 | 三条宽度 | 档位 |
| --- | --- | --- |
| 休日料金 / 4日06:39:56 | 201px | full |
| 高峰料金 / 88日88:88:88 | 201px | full |
| 空闲料金 / 23:59:59（无天数） | 201px | full |
| 週末料金 / 1日00:00:00 | 201px | full |
| 警戒態勢 通常 / 会話記録（手动关 pricing） | 205px | full |

只有最后一行会变宽，而它是面板里的显式操作，不是自发抽动。

### 一条操作经验

改客户端半边后**要重启 DSH 实例才生效**，而且实测观察到 DSH 对客户端 bundle
有**一次滞后的缓存**（本次改动在下一轮重启才被浏览器拿到）。所以「实机验证」
必须以实际渲染出来的数值为准，不能以"文件已改"为准 —— 这次就是靠反复量
`min-width` 才发现 `≈` 那版根本没到浏览器。

## [0.7.1] —— 未发布

### 变更

- **右下角三条（两条标签栏 + 中央教条区仪表）宽度对齐成一整块矩形。**
  此前栈是 `align-items: flex-end`，各元素按自身内容宽度右对齐，左右边缘参差 ——
  两条标签彼此不等宽，仪表又比它们窄，视觉上是"三块零碎"而不是一块仪表盘。

  改法：栈与标签面都改为 `align-items: stretch`，标签内部再用
  `justify-content: space-between` 让主文案贴左、副文案贴右。

  **关键点：整栈宽度没有变化**（栈宽本来就由最宽的那个标签决定），
  所以避让逻辑量到的数值与改前完全一致 —— 纯视觉修正，不影响档位判定。
  实测（缩放 1.5）：三条的 left/right 都是 1396 / 1582，宽度都是 186px；
  翻到余额背面同样对齐。

## [0.7.0] —— 未发布

### 变更

- **仪表默认尺寸 1.35 → 1.5**，滑杆范围 **0.7–1.6 → 0.7–2.3**（1.5 正好是范围中点）。
  滚轮上限同步放开。
- 倒计时副文案「至切换」→「切换」：1.5 倍是新的默认，得给标签块留出余量。

### 新增

- **`lifted` 档位：放大到角落塞不下时，整栈抬到输入框上方**，而不是整块消失。
  这是为「更多放大空间」专门加的 —— 上限到 2.3 之后，1.8 倍以上连 `compact`
  都进不了角落，而**设置面板是仪表的子元素**，仪表一 `display:none` 会把面板
  一起藏掉，用户就再没有入口把尺寸调回来（只能开 Console）。抬升守住了
  「不压输入框」的前提，也不会把人锁在门外；代价是那一档会盖住右侧一小块正文。
  抬上去若顶到屏幕上沿，再退一档 `lifted-compact`（收掉标签块）。

### 修复

- **避让基宽改为实测自校正**。此前写死 full=134 / compact=112，而改过一次标签
  文案后 compact 实际是 117 —— 判定照样通过，但**仪表真的压到了输入框 2px**
  （实测于 1.8 倍）。现在记住两档各自量到的宽度，并用 4px 滞后避免阈值抖动。
- 面板 `maxHeight` 的单位错误：`below` 是栈局部坐标系的量，而"屏幕上方还剩多少"
  是视口量，混用会在放大/抬升档位下把面板顶出屏幕。改为统一换算到视口坐标。
- 清掉一处幽灵引用：`fitCorner` 里残留的 `dragging`（拖动吸附那版已被撤回，
  声明早就不存在）。

### 实测（1600 宽窗口）

| 缩放 | 档位 | 遮挡输入框 | 标签块 |
| --- | --- | --- | --- |
| 1.5（默认） | full | 否 | 显示 |
| 1.8 | lifted | 否 | 显示 |
| 2.0 | lifted | 否 | 显示 |
| 2.3 | lifted | 否 | 显示 |

2.3 倍下面板仍可打开且完整在屏内（top=14）。

### 说明

- 断言：宿主侧 46 项 + 浏览器侧 108 项。

## [0.6.0] —— 未发布

### 新增

- **点击右下角两个标签块 → 3D 翻转 → 背面显示账户余额剩余**（如 `¥5.77 残高`）。
  今日已用按约定留空（显示 `—`）：官方没有这个字段，它只存在于按 token 逐日累计的
  本地账本里，本插件不复刻一套会过期的价目表。
- **宿主半边从空实现变为一条只读余额路由**（`/dsh-eva-magi/balance.json`）：
  客户端按设计读不到密钥，所以余额只能由宿主取。
  ```
  点击标签 → fetch 本机路由 → ctx.credentials.resolve("DEEPSEEK_API_KEY")
           → GET https://api.deepseek.com/user/balance → 解析 balance_infos
  ```
  带 60 秒缓存与并发合并；失败时返回明确原因（未配置密钥 / HTTP 401 / 网络失败），
  界面据此显示，**不编造数字**。
- **请求栅栏**（`lib/host-balance.mjs`）：Host 必须回环、拒 `Sec-Fetch-Site: cross-site`、
  带 Origin 时须同源、非 GET/HEAD 回 405。没有这三道，任意网页都能把你的余额读走。
- `tests/verify-host.mjs`：宿主侧 46 项断言（含 DNS 重绑定、`127.0.0.1.evil.example`
  后缀混淆、userinfo 混淆、跨源 Origin、以及"只认能确定的数字"）。

### 修复（两个都是实机跑出来、单测与浏览器测试台都够不到的）

- **`cannot get property "credentials" without inject`**：路由处理器里用了外层 `ctx`，
  而它没声明过 `credentials` 注入。改用子作用域 `scope`。
- **`credentials.resolve()` 返回的是 `{ value, source }`，不是裸字符串**。
  写成 `"Bearer " + resolved` 会发出 `Bearer [object Object]`，
  官方接口回 401 而错误信息只说"认证失败"—— 排查花了很久。
  现在收敛到可单测的 `secretOf()`。

### 安全事件与教训

调试 401 时我加了个临时探针，本意是"只报形态不报值"，但顺手把
`JSON.stringify(resolved)` 也带上了 —— **那把 API Key 明文打进了会话记录**。
探针已删除，但教训写进了代码注释：**凭据永远不进日志、错误信息或调试响应**，
排查形态只报类型与长度。

### 说明

- 宿主半边**刻意不把 `webServer`/`credentials` 写进 `exports.inject`**，
  而是用子作用域 `ctx.inject([...], scope => ...)`：写进顶层会让整个插件在缺少
  这些服务的组合里永远等不到依赖 —— 连皮肤都不会出现。现在服务缺失只是那一面
  显示「未対応」。
- 断言：宿主侧 46 项 + 浏览器侧 104 项。

## [0.5.1] —— 未发布

### 变更

- **仪表默认尺寸改为 1.35**（原为 1）。为了让标签块在放大后仍放得下，同时把倒计时
  文案收窄了一档：`4日 08:22:03 / 空闲终了` → `4日08:22:03 / 至切换`（省约 15px）。
  否则 149×1.35 = 201px 会正好顶到避让阈值，标签块会被自动收掉 —— 那等于
  刚加上的峰谷标签在默认视图里消失。

### 修复

- **设置面板不再跟着仪表一起放大。** 面板是仪表簇的子元素，会继承它的
  `transform: scale()` —— 调仪表的视觉大小，不该顺带把设置面板的字号和控件也放大。
  修法是给面板加反向倍率 `scale(1 / --eva-hud-scale)`，origin 取自己的右下角，
  抵消后仍贴着仪表的右上角。实测：缩放 1.0 与 1.35 下面板的视觉宽度都是 300px。
- 避让阈值算法重构：把「右边距 18 + 呼吸 6」显式写成 `GUTTER`，基宽改为实测的
  full ≈ 134px / compact ≈ 112px。此前的常量 155 是收窄前的旧值，偏保守 ——
  它会让仪表在放大后过早降级。
- 面板定位的 `bottom` 是栈局部坐标系里的量，缩放后需要除以倍率才能正好贴在仪表上方。

### 说明

- 断言 91 → 93 项（默认值改为 1.35、反向倍率写入、面板反向缩放规则）。

## [0.5.0] —— 未发布

### 新增

- **右下角仪表可放大缩小**：面板里新增「仪表尺寸」滑杆（0.7–1.6，步进 0.05），
  也可以在仪表上 **Cmd/Ctrl + 滚轮**直接缩放。缩放走 `transform` + 固定右下角
  `transform-origin`，所以放大时它从角落里长出来、不会漂。
- **避让阈值随缩放同步放大**：仪表放大后需要的留白也变大，不够就自动降级
  （先丢标签块、再整块收起）—— 放大的代价是被收起来，而不是压住输入框。
  实测 1600 宽窗口：1.0 / 1.3 为 `full`（与输入框间距 60 / 15px），
  1.4 / 1.6 降为 `compact`（46 / 22px），**四档均不遮挡输入框**。
- 面板的 range 控件改为按规格声明 `min`/`max`/`step`（此前是写死的 0–1）。

### 说明

- **滚轮只在 Cmd/Ctrl 按下时才拦截**。不按修饰键时连 `preventDefault` 都不调用，
  直接放行给应用 —— 否则在输入框旁边滚动会被误缩放，那比"少一个快捷方式"糟得多。
- 避让阈值用的是实测基宽（full ≈ 150px、compact ≈ 112px），刻意不用
  "量当前宽度"的写法：compact 时量到的是 compact 宽度，会让"该不该升回 full"
  变成来回抖动的反馈环。
- 断言 85 → 91 项（新增缩放默认值、滑杆范围与步进、写入与持久化、
  transform 实现、以及"缩放不影响浓度滑杆置灰"）。
- **拖动吸附这次没做**（用户撤回了那部分需求）。它与缩放交织在一起，
  为控制改动面先只上缩放；那部分工作保留在 `git stash`（`stash@{0}`）里，需要时可恢复。

## [0.4.0] —— 未发布

### 新增

- **右下两个标签块改为实时资讯**：
  - 状态块：DeepSeek 当前峰谷计费状态 —— 高峰＝琥珀「高峰料金 / PEAK RATE」、
    空闲＝数据绿「空闲料金」、周末＝「週末料金」、法定节假日＝「休日料金」；
    距切换 ≤30 分钟时闪烁预警。
  - 倒计时块：当前状态的剩余时间（跨天写作「4日 08:22:03」），副文案标出
    「高峰终了 / 空闲终了」。
- 规则与 `dsh-whale-widget` 同源（DeepSeek 官方计费文档 + 国务院节假日安排）：
  高峰＝北京时间周一至周五（不含法定节假日）9:00–12:00、14:00–18:00，其余全部空闲。
  **全部本地推算：不联网、不读账号。**
- `pricing` 开关（面板与 Console 都有）：关掉后退回原来的静态装饰文案
  「会話記録 / 警戒態勢」。
- 早期峰谷界面预览（旧截图已由当前角色预览替代）。

### 说明

- **节假日优先于周末**：国庆里的周六报「休日」而不是「週末」——否则标签写着周末、
  倒计时却是整个假期的长度，自相矛盾。这个顺序差异是有意与挂件实现不同的地方。
- 节假日清单只覆盖 2026 年；超出覆盖范围时状态照旧推算，副文案标「推定」如实说明。
- 断言 72 → 85 项。新增 13 项**峰谷规则单测**（导出纯函数，用已知时刻断言：
  高峰窗口两端、午前空档、周末、法定节假日、周末与假期重叠、调休上班的周六、
  下一切换点、以及未覆盖年份的 inferred 标记）。
  写用例时我自己挑错了日期——最初用 2026-10-05（周一）当高峰样例，
  但那天落在国庆假期内，实现返回 holiday 才是对的，被测试当场抓出来。

## [0.3.0] —— 未发布

### 新增

- **设置面板：点右下角仪表簇即可调出。** 11 个开关 + 扫描线浓度滑杆 + 「全部重設」，
  分组为「结构装饰 / 质感 / 形状与排版」。改动即时生效并写入 `localStorage`。
  - 面板与 Console 钩子**共用同一条写入通道**（`setOption`），所以两边改的是同一份状态，
    面板开着时从 Console 改值，控件会跟着刷新。
  - **可点性只开在仪表和面板上**：整个装饰层仍是 `pointer-events:none`，
    所以装饰依然不会抢走应用的点击。自动避让逻辑保证了仪表的左缘永远在输入框右缘之外，
    因此这个"可点"不会盖住发送/暂停按钮。
  - 面板比仪表宽得多（298px），所以自己也有一套避让：输入框贴底时整体抬到它上方，
    并按剩余高度收紧 `max-height`。实测 1600×913 下面板 [1282,204,300,530]、
    输入框 [496,785,877,98]，**零重叠**。
  - 扫描线关闭时浓度滑杆置灰（`data-dim`），保持行高稳定。
  - 面板里**刻意不列 `hud` 自己**：面板是仪表的一部分，关掉仪表就没了入口。
- 早期设置面板实机预览（旧截图已由当前角色预览替代）。

### 变更

- 断言 57 → 72 项（新增 15 项面板测试：可点性、面板结构、开关改值 / 持久化、
  滑杆、Esc 关闭、点外部关闭）。

## [0.2.3] —— 未发布

### 变更

- **场同步带（`beam`）默认关闭。** 用户问「屏幕上从上往下滚动的白线是什么」——
  用 `document.getAnimations()` 逐条查证，全场唯一全宽上下移动的元素就是它：
  1600×150 的 `linear-gradient(透明, rgba(255,255,255,.035), 透明)`，9 秒扫一遍。
  它是模仿 CRT 垂直回扫的装饰；扫描线关掉之后，它成了屏幕上唯一的横向移动物，
  反而变成噪音。同样只翻默认值，`set("beam", true)` 可开回。
- 断言 56 → 57 项（新增场同步带默认状态断言）。

## [0.2.2] —— 未发布

### 变更

- **CRT 扫描线默认关闭**（用户实测后要求先去掉）。功能没删，只是默认值翻了：
  `__EVA_MAGI_THEME__.set("scanlines", true)` 可以随时开回来，
  `scanlineStrength` 仍然照旧生效。暗角、同心雷达环、场同步带不受影响。
- 浏览器半边断言同步调整：默认值断言改成「关」，`set` 的用例改成「打开」——
  默认关之后，这一步才真的验到了 setter（之前默认开，`set(false)` 和默认值撞在一起，
  测不出 setter 是否有效）。`reset()` 的断言也补上了硬边一项。

## [0.2.1] —— 未发布

修掉用户在自己界面上实测反馈的两个问题。

### 修复

- **去掉一条多余的 L 形线条。** 0.2.0 给 `[data-sidebar-right-panel]` 加了
  `inset 0 0 0 1px` 描边，而那个面板是**全高透明层**（x 从屏幕正中到右缘、y 全高）：
  于是它的左边在屏幕正中画出一条竖线、上边在顶端画出一条横线，拼成一个毫无意义的
  L 形。教训：**装饰只能画在真的会绘制出来的表面上**——元素的几何范围不等于可见范围。
- **右下角仪表簇不再遮挡输入框与发送/暂停按钮。** 实测输入框卡片右缘在 x=1373，
  而仪表簇原本宽 263px、左缘在 x=1319，**压住了 54px**——发送/暂停按钮正落在里面。
  两处改动：
  - **收窄**：时钟去掉百分秒（`HH:MM:SS.cc` → `HH:MM:SS`）、读数由 2×2 改单列、
    标签文案缩短，宽度 263 → 139px。1600 宽窗口下与输入框的间距从 −54px 变成 **+70px**。
  - **自动避让**：JS 量输入框卡片的实际位置，把右侧可用留白写进 `data-fit`。
    空间不够先丢标签块（`compact`，实测 1280 宽时 117px、间距 15px），
    再不够整块隐藏（`hidden`，实测 1040 宽时触发）。
    之所以必须动态算：输入框是「在正文列里居中且有最大宽度」的，窗口越窄留白越少，
    任何固定角落的装饰都会压上去——而它压住的恰好是控件。

### 变更

- 浏览器半边断言 55 → 56 项（新增自动避让档位断言）。

## [0.2.0] —— 未发布

「0.1.0 只有令牌与质感，EVA 元素太少」的直接回应。补上一层结构性装饰，
并把验证方式从「等用户目测」换成「起独立实例 + CDP 截图 + 自动断言」。

### 新增

- **结构装饰层**（`chrome`）：内嵌发丝框架、四角 L 标、左右刻度尺（带游标扫描高光）、
  底部危险条纹、顶边压力线与刻度、四角规格编号（`0471 / GEHIRN`、`MAGI-1 / 三賢人`）、
  CRT 三枪色散（红/青各偏移 1px）。
- **仪表簇**（`hud`）：右下角 NERV 状态盘 —— 竖排明朝体「中央教条区」、橙底反白标签块、
  四路**真实**读数（时刻 / 视口尺寸 / 会话正文字号 / 当前色板）、16 格方块流动画。
- **开机序列**（`boot`）：每次会话首次加载放一段「NERV — MAGI SYSTEM / LINK ESTABLISHED」
  接续画面（明朝体大字 + 进度方块），约 2.6 秒后淡出；`pointer-events:none`，从不挡操作。
- **同心雷达环**（`rings`）与**走行的场同步带**（`beam`）。
- **应用元素装饰**：顶栏分隔线、输入卡片橙色外圈（聚焦整圈点亮）、会话列表选中项
  左侧橙条、主区域环境光、键帽/代码块/`hr`/滚动条/浮层/焦点环。
- `tools/shoot.mjs`：给真实 GUI 截图。用 CDP 真实等待 + `Page.captureScreenshot`，
  因为 `chrome --screenshot` 配 `--virtual-time-budget` 在带 WebSocket 的活应用上永不返回。
- 早期深色／开机画面的**真实 GUI 截图**（旧文件已由当前角色预览替代），
  补上 0.1.0「没有截图」的短板。

### 变更

- 装饰层挂钩改用应用自己的 `data-*` 语义属性（`data-conversation-header`、
  `data-composer-card`、`data-sidebar-right-panel`、`data-dockkit-surface` …），
  不再依赖 CSS Modules 的哈希类名。
- 元素装饰只用不改布局、不覆盖应用样式的属性（`box-shadow` / `outline` /
  `border-color` / `letter-spacing`），刻意避开 `::before`/`::after` 与 `background-image`。
- 选项从 8 个增加到 13 个；浏览器半边测试从 40 项增加到 55 项断言。

### 修复

- 第一版标签分别放在右上与左下，实测**盖住了应用的侧栏折叠按钮与「设置」**。
  改为右下角单一纵向叠层，由 flex 保证互不重叠。装饰绝不能压住控件。

## [0.1.0] —— 未发布

首个版本。

### 新增

- 覆盖 DSH 客户端主题层全部 **107 个 `--dsw-alias-*` 别名令牌**，深浅两套配色：
  - 深色：MAGI / 中央教条区——底色 `#08090a`、主色 `#ff6a00`、数据绿 `#7cff4f`、
    警戒红 `#ff1e1e`、暖白正文 `#e8e4dc`、橙色发丝线边框。
  - 浅色：EVA 技术资料纸质版——暖白图纸 `#f2efe8`、压深的橙 `#c94f08`。
- 装饰层：CRT 扫描线、暗角、顶边主色压力线、可选 48px 测绘网格。
- 形状层：圆角归零（`--dsw-radius-*`），可关。
- 排版层：`h1~h3` 汉字走明朝体（拉丁仍为系统无衬线）；全局等宽数字。
- 8 个运行时选项，通过 `__EVA_MAGI_THEME__` 全局钩子调整，选择持久化到 `localStorage`。
- `tools/build-docs.mjs`：由 `lib/client.js` 生成 `docs/theme-tokens.md` 与 `docs/palette.html`，
  保证文档与实现同源；`--check` 模式用于校验。
- `tests/fixtures/client.html` + `tools/run-browser-tests.mjs`：浏览器半边的端到端测试。
  在真实 DOM 里模拟 `__ModuleLoader__` 与 `ctx`，跑完 `apply()` 的注册 / 注入 / 挂载 /
  选项 / 回收全流程，共 40 项断言；无头 Chrome 执行，退出码可用于 CI（无 Chrome 时跳过）。

### 修复

- 移除 `dsh.client.inject` 里对官方主题包的引用，并移除 `peerDependencies`。
  浏览器半边不 `require` 任何模块、只依赖 Cordis 的 `theme` 服务注入，声明模块级依赖
  与包级 peer 依赖只会给安装/启动图多加两次解析要求——而解析失败是「响的」，
  代价不成比例。
- 新增 `tests/verify-manifest.mjs`：把「包名 / 模块 id / patch name 三处一致」
  「`exports["./client"]` 与 `main` 指向的文件真实存在」这类**装错就静默失效**的
  不变量钉成测试，并接入 `npm test`。
- 新增 `tests/verify-contrast.mjs`：WCAG 对比度（46 个组合）+ 覆盖前后的浅/深极性
  一致性（36 个不透明令牌）。它在写这一版时抓到三个真实缺陷，全部已修（见下）。

### 配色修正（由对比度/极性检查抓出）

- 浅色 `label-tertiary` `#6b7178` → `#626970`：对比度 4.29:1 → 4.85:1（正文阈值 4.5）。
- 浅色 `label-caption` `#949aa1` → `#7c828a`：对比度 2.47:1 → 3.38:1（UI 文本阈值 3.0）。
- `brand-primary-invert` 的浅/深极性与官方相反（官方浅色 `#0f1115` / 深色 `#f9fafb`），
  改为 `#0a0a0a` / `#e8e4dc`。该令牌在官方 bundle 里找不到消费方，因此只保证极性同向。

### 说明

- 宿主半边是空实现：皮肤不写任何宿主侧状态、不注册设置项、不接触会话数据。
- 令牌覆盖走官方 `ctx.theme.overrideTokens()` 通道。原因见
  [`docs/architecture.md`](docs/architecture.md)：主题快照是以 inline style 写到 `<body>` 上的，
  纯 CSS 覆盖不会生效。