dsh-effort-mosaic 1.0.7 → 1.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +144 -0
- package/README.md +68 -18
- package/icon.svg +16 -0
- package/lib/client.js +904 -204
- package/package.json +16 -3
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
# 更新日志
|
|
2
|
+
|
|
3
|
+
按版本倒序。每条按「新增 / 修复 / 质量」归类;没有的分类省略。
|
|
4
|
+
|
|
5
|
+
## 1.1.8 — 2026-11-18
|
|
6
|
+
|
|
7
|
+
### 修复
|
|
8
|
+
|
|
9
|
+
- **最高档滑块光晕熄灭太直接**:`.dem-knob::after` 的提升光晕原来进入和退出共用 `.18s`,`data-burst` 一撤就立刻归零。现在进入走 `.16s ease-out` 保持点亮跟手,退出单独走 `1.05s cubic-bezier(.37,0,.22,1)`,光晕先保持一点厚度再慢慢散掉。粒子和霓虹共用同一层光晕,两套风格同时生效。
|
|
10
|
+
|
|
11
|
+
### 质量
|
|
12
|
+
|
|
13
|
+
- 新增「光晕退出慢呼吸、进入仍跟手」结构断言;离线断言 **175 项全部通过**。
|
|
14
|
+
|
|
15
|
+
## 1.1.7 — 2026-11-18
|
|
16
|
+
|
|
17
|
+
### 修复
|
|
18
|
+
|
|
19
|
+
- **霓虹最高档先露出整条彩色,再播一次擦除**:落位时 `data-max=1` 会先让紫色渐变层整层显形,而此时 `codexGo` 还没置位、擦除盖板停在 `static`(`translateX(-100%)`),所以先看到满轨紫,再被盖板从头擦一遍。新增 `data-run='hold'`:落位到最高档、点火前,蓝盖板先停在满覆盖位置;`fireBurst` 切到 `run=1` 后盖板再从 0 向左退,紫色一次性露出。首次打开就在最高档仍保持 `static`,不额外播动画。
|
|
20
|
+
|
|
21
|
+
### 质量
|
|
22
|
+
|
|
23
|
+
- 新增「最高档落位先保持蓝盖板」结构断言;离线断言 **174 项全部通过**。
|
|
24
|
+
|
|
25
|
+
## 1.1.6 — 2026-11-18
|
|
26
|
+
|
|
27
|
+
### 修复
|
|
28
|
+
|
|
29
|
+
- **最高档滑块右缘两个橙色直角**:填充/粒子层的收口遮罩原先通过根节点 `--dem-tail-mask` 展开,里面的 `var(--dem-fill-tail-x)` 会在 `documentElement` 上提前按默认 `100%` 冻结,导致填充实际从未被裁到滑块圆心。现在遮罩直接声明在 `.dem-fill` / `.dem-mosaic-clip` 上,变量在各自元素本地解析;空心环用 `[data-knob-shape='ring']` 单独补圆盘收口。
|
|
30
|
+
- **填充右端圆角比滑块外缘小 1px**:`fillTailRadiusOf()` 实心形状改取滑块外缘半径(圆角方 30px = 10px,圆/胶囊 = 15px),空心环取内半径 12px;即使遮罩失效,右端也不会比滑块更方而露出直角。
|
|
31
|
+
- **每次打开浮层滑块从 0 档划到真实档位**:首帧量宽阶段仍可能按 0 档计算,且目录快照可能晚一拍。`ConnectedTrack` 现在优先从官方菜单行的当前档位名取初始落点;两处都未就绪时用 `data-ready=0` 先隐藏轨道,显形第一帧仍关闭过渡,下一帧才恢复动画。
|
|
32
|
+
|
|
33
|
+
### 质量
|
|
34
|
+
|
|
35
|
+
- 填充与粒子裁切层改为同一套元素内遮罩,避免根变量冻结;补 `[data-knob-shape='ring']` 圆盘遮罩闸门。
|
|
36
|
+
- 离线断言 **173 项全部通过**。
|
|
37
|
+
|
|
38
|
+
## 1.1.5 — 2026-11-18
|
|
39
|
+
|
|
40
|
+
### 文档
|
|
41
|
+
|
|
42
|
+
- README 新增 **霓虹轨道宣传图**:用插件真实 CSS、真实蓝紫渐变和真实白点参数渲染,不再只有马赛克示意图;宣传图生成器现在输出 `hero / shapes / neon` 三张。
|
|
43
|
+
- 补齐 npm 的 `homepage` / `bugs` 元数据;移除已归档的 `.workbuddy/` 旧忽略项。无运行时变化。
|
|
44
|
+
|
|
45
|
+
## 1.1.4 — 2026-11-18
|
|
46
|
+
|
|
47
|
+
### 修复
|
|
48
|
+
|
|
49
|
+
- **每个档位松手后向右抖一下**:拖动时松手起点取的是上一帧渲染位置(`shownPctRef`),指针已经停在档位上、React 最后一帧还没提交时,吸附会从这个偏左的旧位置补一小段到右侧。`beginSettle` 现在接收松手瞬间的指针位置作为起点;落位时先保持 `data-snapping=1` 把最终位置定格,下一帧再恢复 CSS 过渡,不再让旧的 `left` 被 `.3s` 过渡追着走。
|
|
50
|
+
- **霓虹滑块边缘透出轨道蓝**:霓虹填充之前用 `mask-image:none` 关掉了收口遮罩,填充一直铺到滑块外缘,白色圆钮的抗锯齿边与蓝底混出一条彩边;最高档还会多出 1px 轨道外溢。现在霓虹填充也走 `TAIL_MASK`,竖切位置由 `calc(100% - var(--dem-knob-tail-inset))` 反推;端点改为严格内切,旋钮投影从蓝灰改成中性深色。
|
|
51
|
+
- **圆角滑块边缘渗色**:白瓷环壁原来取 `pal.stops[0]`(强调色的浅色阶),暖色强调色下会变成一圈浅橙红;现在白瓷固定用中性 `#dde3ec`。旋钮外圈再加 1px 中性护栏,盖住圆角压在填充上时露出的那一角,填充仍铺到滑块下方,不靠缩短色轨解决。
|
|
52
|
+
- **白瓷旋钮左缘残留 1px 粉红过渡**:1px 中性护栏的外沿仍会与轨道填充在抗锯齿边缘混色,实机采样为 `rgb(225,141,144)`。外圈再补 1px 中性外沿(总 2px),同一位置变为 `rgb(222,225,234)`,无轨道色;填充仍铺到滑块下方,色轨同步不变。
|
|
53
|
+
- **色轨跟不上滑块**:上一版把旋钮位置改成 `translate`(合成层),填充宽度仍是 `width`(布局层),两条渲染路径速度不一致,换档时色轨会晚于滑块。现在旋钮回到 `left`,与 `width` 共用同一条布局 / 绘制路径和同一条 `.3s` 曲线,色轨和滑块同步。
|
|
54
|
+
- **霓虹最高档提前点火**:拖动到 97% 就播烟花,此时滑块离端头还有约 8px,烟花后继续右移。端头判定收到精确 1,不再提前。
|
|
55
|
+
|
|
56
|
+
### 质量
|
|
57
|
+
|
|
58
|
+
- **点击换档第一帧不再被宿主写入堵住**:`landByCss` 原先只 `setLocalIndex`,要等 React 提交才改 DOM,点击后第一帧还停在旧位置;现在 pointerup 同帧把目标像素直接写到旋钮 `--dem-knob-x` 和填充 `width`,CSS 过渡立即起跑。宿主的 `access.select` 是同步桥,实测一次写入会让渲染线程停 0.1–0.3s,所以档位落库延后 360ms,并在 `requestIdleCallback` 空闲时执行;连续点击会取消上一档的延迟窗口,只落最后一次,浮窗提前关闭则在卸载时补写。真机 Quick Click 日志:每一下 pointerup 后第一帧 3–8ms,色轨与滑块同帧。
|
|
59
|
+
- **点击 / 键盘换档在档位前"顿一下"**:点击原先把弹簧曲线(`TAP_OMEGA`)跑到底,临界阻尼的尾巴会在档位前减速、再补最后几像素。现在点击 / 键盘都改走 `.dem-knob / .dem-fill` 的 `.3s` CSS 过渡:判最近档位,从当前 DOM 位置平滑滑过去,没有 rAF 收尾、没有末段补量。拖动松手仍保留带初速的临界阻尼吸附。
|
|
60
|
+
- **两种轨道手感统一**:删除霓虹专属的提前收工分支,粒子轨与霓虹轨共用同一条拖动吸附曲线;点击 / 键盘也共用同一条 CSS 过渡。以后调手感只改一处。
|
|
61
|
+
- **换档同步**:旋钮位置保持 `left`,和填充 `width` 同走布局路径;不再为了合成层把旋钮单独换成 `translate`。原有 `.3s` 曲线、点亮动画和粒子动画均未改动。
|
|
62
|
+
- **霓虹粒子放大**:漂流白点直径 2px → 3px,烟花火星 2–4.4px → 2.8–5.2px;数量、透明度、漂移和爆炸关键帧保持不变。
|
|
63
|
+
- **粒子轨道填充跟手**:粒子墙的 rAF 不再每帧覆写 `.dem-fill` 的宽度。之前每帧把宽度目标重设到滑块当前(尚未走完)的位置,`.3s` 过渡被一直拖在后面;现在填充只由 React 提交值 / `writeTargetPct` 驱动,粒子容器单独逐帧跟滑块。切换轨道风格时也会销毁/重建粒子墙,避免从霓虹切回马赛克后没有墙。
|
|
64
|
+
- 离线断言 **170 项**,新增点击 CSS 路径、pointerup 同帧写目标像素、宿主写入延后 / 空闲落库、连续换档取消上一档、拖动 rAF 路径、精确端头、收口遮罩、端点内切、收尾过渡、霓虹粒子尺寸、白瓷环壁中性色、旋钮同步定位、双层中性外沿、粒子墙不覆写填充宽度、切换轨道风格重建墙等结构闸门。
|
|
65
|
+
|
|
66
|
+
## 1.1.3 — 2026-11-18
|
|
67
|
+
|
|
68
|
+
### 修复
|
|
69
|
+
|
|
70
|
+
- **关闭思考强度浮窗后轨道永久消失**:`ConnectedTrack` 的卸载清理引用了声明在 `EffortTrack` 里的 `burstTimerRef`,关闭浮窗时抛 `ReferenceError`,React 提交阶段连带卸掉 `SlotComponent` 整棵子树,再打开菜单连「推理等级」行都不再渲染。清理已移回 `EffortTrack` 自己的 effect。
|
|
71
|
+
- **每次打开浮窗,滑轨从最左端划到真实档位**:首次挂载 `width=0`,旋钮先按 0 宽算在最左(`left≈14px`);`useLayoutEffect` 量到真实宽度后改到真实位置,`.dem-knob` 的 `left .3s` 把这次测量修正当成换档过渡播放。现在首次量宽的那一帧临时关闭旋钮 / 填充过渡,等这一帧画完再恢复,正常切档动画不受影响。
|
|
72
|
+
|
|
73
|
+
### 质量
|
|
74
|
+
|
|
75
|
+
- `exports.__internals` 只在 `__DEM_TEST_HOOK__` 下挂出,正式 bundle 不再暴露测试接口。
|
|
76
|
+
- 补齐宣传图生成器依赖的 `knobRadiusOf` 导出,`tools/make-promo.mjs` 恢复可运行;导出面闸门同时检查测试与工具两边的引用。
|
|
77
|
+
- 离线断言增至 **152 项**,新增「卸载清理不越界」「首次量宽关闭过渡」「无测试钩子不导出内部接口」等结构闸门。
|
|
78
|
+
|
|
79
|
+
## 1.1.2
|
|
80
|
+
|
|
81
|
+
### 修复
|
|
82
|
+
|
|
83
|
+
- 菜单关闭即拆桥导致切档后再开轨道消失:旧行仍在 DOM 里就保留挂载,下次打开同一行直接复用。
|
|
84
|
+
- 同一输入区存在多个弹层时,按菜单内容认准「推理等级」行,不再依赖 `aria-expanded` 猜测。
|
|
85
|
+
|
|
86
|
+
### 质量
|
|
87
|
+
|
|
88
|
+
- 补结构断言锁定「菜单关闭但旧行仍连接」时的保留挂载行为。
|
|
89
|
+
|
|
90
|
+
## 1.1.1
|
|
91
|
+
|
|
92
|
+
### 修复
|
|
93
|
+
|
|
94
|
+
- 当前模型没有声明 `reasoning.efforts` 或目录正在重建时,不再留下一条空轨道:交还官方行,等档位回来再挂。
|
|
95
|
+
- 输入区同时存在多个弹层时不再误拆轨道。
|
|
96
|
+
|
|
97
|
+
## 1.1.0
|
|
98
|
+
|
|
99
|
+
### 新增
|
|
100
|
+
|
|
101
|
+
- **霓虹**轨道风格(详情页面板可切换,默认仍是马赛克):平涂强调色胶囊;最高档是蓝 → 紫的整条渐变,由同色蓝盖板向左擦出,配滑块脚下 18 颗烟花与 14 颗右 → 左漂移白点。
|
|
102
|
+
|
|
103
|
+
### 修复
|
|
104
|
+
|
|
105
|
+
- 直边与圆角衔接的毛边:遮罩加 1px 斜坡、圆心吸附设备像素、环壁改用 inset 阴影、收口半径跟随滑块形状。
|
|
106
|
+
- 烟花之后滑块仍会余移。
|
|
107
|
+
- 拖动时粒子层掉帧:动画只动 `transform`,固定数量的节点在模块加载时一次建好。
|
|
108
|
+
|
|
109
|
+
## 1.0.7
|
|
110
|
+
|
|
111
|
+
- 移除滑块 28 档,只保留 30 / 34。
|
|
112
|
+
- 包名改回 `dsh-effort-mosaic`,与仓库名统一。
|
|
113
|
+
|
|
114
|
+
## 1.0.6
|
|
115
|
+
|
|
116
|
+
- 优化粒子出格:粒子层盒子改为与可见带同高,纵向格子按带高切分;非越界档位或关闭越界时方块不再溢出轨道上下边界。
|
|
117
|
+
|
|
118
|
+
## 1.0.5
|
|
119
|
+
|
|
120
|
+
- 修复切到最高档时滑块未到位、粒子先点亮的问题:点亮排队到滑块落位后再播。
|
|
121
|
+
|
|
122
|
+
## 1.0.4
|
|
123
|
+
|
|
124
|
+
- 版本与 npm 首次发布对齐。
|
|
125
|
+
- 宣传图生成脚本迁入 `tools/`,清理工作区。
|
|
126
|
+
|
|
127
|
+
## 1.0.3
|
|
128
|
+
|
|
129
|
+
- 修复散射左端帽漏粒子。
|
|
130
|
+
- 越界衔接与冷启动改为平滑阻尼。
|
|
131
|
+
|
|
132
|
+
## 1.0.2
|
|
133
|
+
|
|
134
|
+
- 版式面板副标题去掉「默认值就是设计稿定稿值」。
|
|
135
|
+
|
|
136
|
+
## 1.0.1
|
|
137
|
+
|
|
138
|
+
- 清理死代码:删除重复声明的 `STILL_ZONE`、从未调用的 `rgbaOf()`。
|
|
139
|
+
- 补 MIT LICENSE 正文与 `repository` 字段。
|
|
140
|
+
- `.gitignore` 补 `*.tgz`、`*.log`、`.DS_Store`、`Thumbs.db`。
|
|
141
|
+
|
|
142
|
+
## 1.0.0
|
|
143
|
+
|
|
144
|
+
- 首个版本:马赛克粒子轨道、5 种滑块 × 2 档尺寸 × 4 种填充、4 套点亮动画、4 套越界动画、版式面板,档位表跟随当前模型声明。
|
package/README.md
CHANGED
|
@@ -11,13 +11,19 @@
|
|
|
11
11
|
<img src="https://img.shields.io/badge/dependencies-0-4a84ff" alt="zero dependencies">
|
|
12
12
|
</p>
|
|
13
13
|
|
|
14
|
-
<p align="center">接管 DSH
|
|
14
|
+
<p align="center">接管 DSH 模型菜单里的「推理等级」那一行,换成一条滑轨。两套风格任选:<b>马赛克粒子墙</b> 或 <b>霓虹</b>。</p>
|
|
15
15
|
|
|
16
|
-
右侧贴着滑块的那一段是严丝合缝的静止墙;越往左,方块越早脱离网格,向左漂、上下散、逐渐淡出;档位越高跑得越快,到最高档点亮一次。
|
|
16
|
+
**马赛克**(默认)—— 右侧贴着滑块的那一段是严丝合缝的静止墙;越往左,方块越早脱离网格,向左漂、上下散、逐渐淡出;档位越高跑得越快,到最高档点亮一次。
|
|
17
|
+
|
|
18
|
+
**霓虹** —— 平涂强调色的胶囊轨道;切到最高档时,一块同色蓝盖板向左退场,把蓝→紫的整条渐变「擦」出来,同时滑块脚下炸一圈火星、14 颗白点由右向左漂过。白点直径 3px,火星 2.8–5.2px,比初版大一圈,远看不再像灰尘。
|
|
19
|
+
|
|
20
|
+
<p align="center">
|
|
21
|
+
<img src="https://cdn.jsdelivr.net/gh/xiaobaga281/dsh-effort-mosaic@main/docs/neon.png" alt="霓虹轨道:平涂强调色,最高档蓝到紫擦除渐变" width="100%">
|
|
22
|
+
</p>
|
|
17
23
|
|
|
18
24
|
- **看得见强度** —— 一条连续轨道比 Off / Low / High / Max 四个字直观
|
|
19
25
|
- **手感连续** —— 拖动跟手不跳档;松手按临界阻尼收口;点击只判最近档位,不先跳到指针
|
|
20
|
-
- **最高档有代价感** ——
|
|
26
|
+
- **最高档有代价感** —— 马赛克默认只有开满时粒子才飞出轨道,四套越界动画;霓虹是擦除 + 烟花
|
|
21
27
|
- **可调到底** —— 5 种滑块 × 2 档尺寸 × 4 种填充,颜色与幅度都能改
|
|
22
28
|
|
|
23
29
|
档位表不写死:跟随当前模型在 `reasoning.efforts` 里声明的档位;模型没声明就不接管这一行(fail-open)。最高档时,输入框胶囊里的档位名会染成品牌蓝。
|
|
@@ -46,12 +52,13 @@ dsh plugin --profile web add "github:xiaobaga281/dsh-effort-mosaic"
|
|
|
46
52
|
|
|
47
53
|
| 操作 | 行为 |
|
|
48
54
|
|---|---|
|
|
49
|
-
| 按住拖动 |
|
|
50
|
-
| 松手 | 吸附到最近档位,约 0.25s
|
|
51
|
-
| 点击轨道 |
|
|
52
|
-
| `←` `→` `↑` `↓` / `Home` `End` | 相邻档位 /
|
|
55
|
+
| 按住拖动 | 两档之间完全自由跟手(横向超过 5px 才算拖动,之前滑块一像素不动) |
|
|
56
|
+
| 松手 | 吸附到最近档位,约 0.25s;松手位置正好在档位上时不动,不再向右补一段 |
|
|
57
|
+
| 点击轨道 | 判定离指针最近的档位;pointerup 同帧把目标像素写到旋钮和填充,滑块立即起 `.3s` CSS 过渡,不等待 React 提交 |
|
|
58
|
+
| `←` `→` `↑` `↓` / `Home` `End` | 相邻档位 / 首尾档,同样走 `.3s` CSS 过渡 |
|
|
59
|
+
| 档位落库 | 点击/键盘的宿主写入延后 360ms,并在渲染线程空闲时执行;连续换档只保留最后一次目标,点完立刻关浮窗也会在卸载时补写 |
|
|
53
60
|
|
|
54
|
-
拖动只改本地显示位置,松手那一下才写回官方设置(120ms
|
|
61
|
+
拖动只改本地显示位置,松手那一下才写回官方设置(120ms 节流,失败自动回滚)。**拖动松手仍走同一条临界阻尼吸附曲线**(保留指尖初速);**点击 / 键盘换档走同一条 `.3s` CSS 过渡**(离散操作,平滑到位即可)。点击的 pointerup 同帧会把目标像素直接写进 DOM,宿主档位则延后 360ms、等渲染线程空闲再落库,避免同步桥堵住第一帧;连续换档只保留最后一次目标。两种轨道共用这两条路径 —— 以后调手感只改一处,粒子轨和霓虹轨一起变。切到最高档时,点亮动画等滑块滑到位再播。
|
|
55
62
|
|
|
56
63
|
## 视觉
|
|
57
64
|
|
|
@@ -63,8 +70,11 @@ dsh plugin --profile web add "github:xiaobaga281/dsh-effort-mosaic"
|
|
|
63
70
|
<img src="https://cdn.jsdelivr.net/gh/xiaobaga281/dsh-effort-mosaic@main/docs/shapes.png" alt="五种滑块:圆 / 环 / 方形 / 胶囊 / 细棒" width="100%">
|
|
64
71
|
</p>
|
|
65
72
|
|
|
66
|
-
|
|
67
|
-
|
|
73
|
+
**四种点亮动画**(最高档触发,两套风格都有):能量波 / 扫描线 / 爆散 / 呼吸。马赛克那组还带一次粒子瞬时提速;霓虹沿用同一套语义,但峰值更低(紫渐变的亮度天花板比浅蓝低,1.55 倍会烧成白块),且不做饱和变化。
|
|
74
|
+
|
|
75
|
+
**四套越界动画**(仅马赛克,默认仅最高档):飞沫 / 飘散 / 坠落 / 潮汐 —— 右 1/5 是死区,越往左逃逸比例越高、飞得越远。
|
|
76
|
+
|
|
77
|
+
切到 **霓虹** 后轨道是平涂强调色;最高档填充是逐点采样自原版的蓝→紫渐变(`#2546D0 → #B37DFF → #724CE9`),由一块同色蓝盖板向左移「擦」出来 —— 盖板右缘 96px 渐变到全透明,所以边界是软的,没有接缝。
|
|
68
78
|
|
|
69
79
|
## 自定义版式
|
|
70
80
|
|
|
@@ -72,6 +82,7 @@ dsh plugin --profile web add "github:xiaobaga281/dsh-effort-mosaic"
|
|
|
72
82
|
|
|
73
83
|
| 项 | 取值 | 默认 |
|
|
74
84
|
|---|---|---|
|
|
85
|
+
| 轨道风格 | 马赛克 / 霓虹 | 马赛克 |
|
|
75
86
|
| 滑轨强调色 | 6 个预设 + 任意 hex | `#4A84FF` |
|
|
76
87
|
| 最高档字符 | 跟随强调色 / 自定义 | 跟随强调色 |
|
|
77
88
|
| 滑块形状 | 圆 / 环 / 方 / 胶囊 / 细棒 | 圆 |
|
|
@@ -86,39 +97,78 @@ dsh plugin --profile web add "github:xiaobaga281/dsh-effort-mosaic"
|
|
|
86
97
|
|
|
87
98
|
整套配色由强调色派生(填充渐变、粒子、光晕同源),不会出现"轨道变了、粒子还是旧蓝"。设置留在 `localStorage` 的 `dsh-effort-mosaic:settings:v1`,面板底部可一键恢复默认。
|
|
88
99
|
|
|
100
|
+
### 两种轨道风格
|
|
101
|
+
|
|
102
|
+
| 风格 | 轨道 | 最高档 | 粒子越界 |
|
|
103
|
+
|---|---|---|---|
|
|
104
|
+
| **马赛克**(默认) | 像素方块墙,越往左越散 | 四套点亮动画任选 | ✅ 飞沫 / 飘散 / 坠落 / 潮汐 |
|
|
105
|
+
| **霓虹** | 平涂强调色胶囊 | 蓝→紫擦除渐变 + 滑块脚下烟花 + 14 颗右→左漂流白点 | ❌ 不提供 |
|
|
106
|
+
|
|
107
|
+
粒子越界是马赛克风格独有的能力:切到霓虹后,面板里的「粒子越界 / 越界动画 / 越界幅度」整组会消失。**其余设置两套通用** —— 强调色、滑块形状/大小/填充、点亮样式与强度/速度都照常生效,只是霓虹的点亮作用在紫渐变上、用更低的峰值:强度决定四套动画的亮度峰值,速度决定动画时长(定时器同步跟随,不会把慢速档拦腰截断)。
|
|
108
|
+
|
|
109
|
+
霓虹最高档的渐变**跟着强调色走**:默认强调色下逐点等于原版采样值(`#2546D0 → #B37DFF → #724CE9`),换成红/绿主题后整条渐变按同一 RGB 偏移平移,得到同结构的红紫/绿紫渐变;滑块脚下的火星与底纹也跟着强调色变。
|
|
110
|
+
|
|
111
|
+
两套风格在 CSS 层面完全隔离:所有 `.dem-codex*` 规则都挂 `[data-rail='codex']` 前缀,冒烟测试里有一条断言专门盯着这件事,防止以后串味。
|
|
112
|
+
|
|
89
113
|
## 实现要点
|
|
90
114
|
|
|
91
115
|
改动前值得知道的几条约束(都是踩过坑的地方):
|
|
92
116
|
|
|
93
117
|
1. **右端收口不能用 `clip-path`** —— 它只有轴对齐四条边,半圆端帽会露方角。用 `TAIL_MASK` + `mask-clip: no-clip`;否则 mask 默认的 `border-box` 会把飞出轨道的方块整片裁掉。
|
|
94
|
-
2.
|
|
95
|
-
3. **点亮等落位**:`shownIndex`
|
|
118
|
+
2. **拖动吸附是临界阻尼闭式解**:松手 ω=22(带指针初速),收尾时间取 `9.5/ω`,写死上限会在末尾剩几个像素硬跳。点击 / 键盘换档不走这条曲线,直接走 `.dem-knob / .dem-fill` 的 `.3s` CSS 过渡 —— 离散操作平滑到位即可,弹簧尾巴反而会在档位前"顿一下"。
|
|
119
|
+
3. **点亮等落位**:`shownIndex` 是乐观档位,点下去就变;拖动由 `beginSettle` 在滑块进入目标 1% 时播,点击 / 键盘由 `landByCss` 的 330ms 兜底定时器播,否则光先铺完、滑块才到。
|
|
96
120
|
4. **墙区的格子首帧也要写 `transform`**(`c.placed`),否则天生就在墙区的那几列永久停在轨道 `(0,0)`,看着像"多了一颗不动的蓝方块"。
|
|
97
121
|
5. **写 DOM 前对 `x / y / scale / op` 做有限性兜底**:任何一个 `NaN` 都会让浏览器丢弃整条 `transform`。
|
|
98
122
|
6. **越界强度是阻尼值**,每帧朝目标指数逼近(进 τ=0.24s / 退 τ=0.17s);换成"线性进度 + 缓动"会在退档末尾先呆住再急收。
|
|
123
|
+
7. **索引到最高档 ≠ 滑块到位**:索引在点下去那一刻就变,滑块还要靠弹簧滑 0.22s。霓虹的变色与烟花绑定的是 `landedTop = 索引到顶 && 没在吸附 && 没在拖动`,否则烟花会在旧位置炸、滑块再追上去。
|
|
124
|
+
8. **两种轨道共用同一条落位判定**:索引到最高档不等于滑块到位,点亮绑定 `landedTop`;进入目标 1% 才兑现。霓虹不再有"提前收工"分支 —— 手感只维护一份,粒子轨和霓虹轨一起调。
|
|
125
|
+
9. **松手起点用最新指针位置**:`shownPctRef` 是上一帧渲染值,直接拿它起吸附会在松手后又向右补一小段;`beginSettle` 接收 `fromOverride`,并用 `data-snapping` 把最终位置先定格、下一帧再恢复过渡。
|
|
126
|
+
10. **端点严格内切**:`travel = 轨道宽 − 滑块宽`,`pct=1` 时滑块右缘正好贴轨道宽;不再用 `+2 / −1` 让两端各出界 1px(最高档的蓝色薄边就是它)。
|
|
127
|
+
11. **霓虹填充也套收口遮罩**:填充竖切位置用 `calc(100% - var(--dem-knob-tail-inset))` 从自身宽度反推,CSS 过渡期间也跟手;滑块外缘只与轨道底色接触,不会混出蓝边。旋钮投影改成中性深色,避免蓝灰影沿圆边染出"轨道色渗出"的假象。
|
|
128
|
+
12. **遮罩边缘必须有 1px 斜坡**:`mask-image` 从 `#000` 直接切 `transparent` 是硬切换,落在亚像素坐标上就是锯齿。写成 `calc(x - .5px) → calc(x + .5px)`(径向 −1px),再把圆心吸附到设备像素,边缘才不抖。
|
|
129
|
+
13. **环壁用 inset 阴影画,不用 border**:border 由边框绘制器单独栅格化,压在渐变填充上会留一道 1px 浅缝,圆边的抗锯齿也会断。
|
|
130
|
+
14. **收口位置跟着形状走**:圆 / 环 / 圆角方 / 胶囊都切在滑块圆心,填充必须铺到滑块下方;只有比带高还窄的 `blade` 把竖切退到左缘,否则棒子两侧会露出方角。圆角滑块压在填充上时露出的那一角,由旋钮外圈 1px 中性护栏盖住。
|
|
131
|
+
15. **粒子动画只能动 `transform`**:霓虹的 14 颗白点如果动画 `left`,每帧都要重排整棵子树(里面还压着带遮罩的填充),必掉帧;改成等宽空壳 + `translateX` 走合成层。这 14 颗与 18 颗火星的节点也必须在模块加载时建一次,不能每次渲染重建。白点 3px、火星 2.8–5.2px。
|
|
132
|
+
16. **旋钮位置用 `left`,和填充 `width` 同一条布局路径**:旋钮若单独改成 `translate`(合成层),填充宽度还在主线程重排,两条渲染路径速度不一致,换档时就会看到色轨滞后。两者都走 `left` / `width` 和同一条 `.3s` 曲线;WAAPI 的 `scale` 脉冲仍走 `transform`。
|
|
133
|
+
17. **霓虹的「点亮强度 / 速度」必须落到自己的 CSS 变量上**:只喂 `burstPower` 是不够的(那是马赛克粒子引擎),紫渐变的 filter 峰值和时长由 `--dem-neon-peak-* / --dem-neon-dur-*` 控制,点亮定时器也要按同一个时长收尾。
|
|
134
|
+
18. **点击的第一帧必须同步写 DOM,宿主写入要延后**:`landByCss` 先把目标像素直接写到旋钮 `--dem-knob-x` 和填充 `width`,等 React 提交就晚了半拍。宿主的 `access.select` 是同步桥,实测一次写入会让渲染线程停 0.1–0.3s;所以档位落库延后 360ms,并在 `requestIdleCallback` 空闲时执行。连续点击会取消上一档的延迟窗口,只落最后一次;浮窗提前关闭则在卸载时补写。
|
|
99
135
|
|
|
100
136
|
## 开发
|
|
101
137
|
|
|
102
138
|
```sh
|
|
103
|
-
|
|
104
|
-
node tools/make-promo.mjs # 重新生成 docs/
|
|
139
|
+
npm test # 175 项离线断言(桩件里真跑 bundle)
|
|
140
|
+
node tools/make-promo.mjs # 重新生成 docs/ 下三张宣传图(真实 CSS 渲染)
|
|
105
141
|
```
|
|
106
142
|
|
|
107
143
|
```
|
|
108
144
|
lib/client.js 全部实现(CJS closure bundle,无构建步骤)
|
|
109
145
|
lib/index.js 宿主侧:零逻辑,只做产物审计
|
|
110
146
|
cordis.patch.yml host 图里插入这一行(`- insert: - id: effort-mosaic`)
|
|
147
|
+
icon.svg 插件图标(详情页 / 列表)
|
|
111
148
|
docs/*.png README 宣传图
|
|
112
149
|
tools/make-promo.mjs 宣传图生成器
|
|
113
150
|
test/smoke.mjs 冒烟测试,不进 npm 包
|
|
151
|
+
CHANGELOG.md 完整版本记录
|
|
152
|
+
README.md / LICENSE 说明与许可
|
|
114
153
|
```
|
|
115
154
|
|
|
155
|
+
`npm publish` 只带 `package.json` 的 `files` 白名单:`lib/`、`cordis.patch.yml`、`icon.svg`、`README.md`、`CHANGELOG.md`、`LICENSE`。测试、宣传图生成器和临时诊断文件都不进包。
|
|
156
|
+
|
|
157
|
+
修改 `lib/client.js` 后必须重启 DSH 宿主:宿主在启动时按 bundle 计算 `rev`,只刷新页面会继续请求旧 `rev` 并返回 404,看起来像插件没有加载。
|
|
158
|
+
|
|
116
159
|
## 更新日志
|
|
117
160
|
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
- **1.
|
|
161
|
+
完整记录见 [CHANGELOG.md](./CHANGELOG.md)。
|
|
162
|
+
|
|
163
|
+
- **1.1.8** — 修复最高档滑块光晕熄灭太直接:进入保持快,退出改为 1.05s 呼吸式衰减;粒子和霓虹同时生效。
|
|
164
|
+
- **1.1.7** — 修复霓虹最高档先露整条紫色、再播擦除的问题:落位后蓝盖板先满覆盖,点火时再从 0 向左退,只擦一次。
|
|
165
|
+
- **1.1.6** — 修复最高档滑块右缘的橙色直角:遮罩改为填充/粒子层本地解析,右端圆角取滑块外缘;修复打开浮层时从 0 档划到真实档位。
|
|
166
|
+
- **1.1.5** — 文档维护:新增霓虹轨道宣传图(真实 CSS 渲染),补齐 npm `homepage` / `bugs` 元数据;无运行时变化。
|
|
167
|
+
- **1.1.4** — 修复白瓷旋钮边缘仍残留 1px 轨道色;粒子轨填充不再被 rAF 每帧覆写,切换轨道风格会重建粒子墙;补齐点击/拖动与色轨同步、档位吸附、精确端头点亮和霓虹粒子尺寸。
|
|
168
|
+
- **1.1.3** — 修复关闭浮窗后轨道消失、每次打开从最左端划到真实档位;测试接口不再进入正式 bundle。
|
|
169
|
+
- **1.1.2** — 菜单关闭时保留挂载,切档后再开可复用。
|
|
170
|
+
- **1.1.1** — 无档位 / 目录重建时交还官方行;多弹层不再误拆轨道。
|
|
171
|
+
- **1.1.0** — 新增霓虹轨道风格。
|
|
122
172
|
|
|
123
173
|
## 兼容性
|
|
124
174
|
|
package/icon.svg
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
|
|
2
|
+
<!-- 左侧散开的马赛克粒子:越靠近滑块越大越密 -->
|
|
3
|
+
<rect x="4.7" y="16.9" width="2.2" height="2.2" rx="0.55" fill="url(#mosaic)"/>
|
|
4
|
+
<rect x="8.2" y="16.5" width="3" height="3" rx="0.75" fill="url(#mosaic)"/>
|
|
5
|
+
<rect x="12.6" y="16.1" width="3.8" height="3.8" rx="0.9" fill="url(#mosaic)"/>
|
|
6
|
+
<!-- 轨道 -->
|
|
7
|
+
<rect x="15.6" y="16.2" width="15.8" height="3.6" rx="1.8" fill="url(#mosaic)" opacity="0.5"/>
|
|
8
|
+
<!-- 滑块:贴住轨道右端(最高档) -->
|
|
9
|
+
<rect x="21.8" y="10.3" width="9.6" height="15.4" rx="4.8" fill="url(#mosaic)"/>
|
|
10
|
+
<defs>
|
|
11
|
+
<linearGradient id="mosaic" x1="18" y1="9" x2="18" y2="27" gradientUnits="userSpaceOnUse">
|
|
12
|
+
<stop stop-color="#54ECE7"/>
|
|
13
|
+
<stop offset="1" stop-color="#658EFF"/>
|
|
14
|
+
</linearGradient>
|
|
15
|
+
</defs>
|
|
16
|
+
</svg>
|