EVA 初号机桌宠（dsh web 常驻插件）

在 dsh Web GUI 里放一只可拖动的 Q 版（Funko Pop 风）EVA 初号机，带 NERV 同步率 HUD 与一套 离散动作。纯浏览器面插件：宿主半程是空 apply，浏览器半程通过 package.json 的 dsh.client 声明被 web 服务端发现并下发。

形体（T12 起换了表现形式）：机体不再是手写矢量块面，而是参考插画本身。pet-ref/slice-rig.py 把 pet-ref/reference.png 沿实测装甲缝切成 16 层刚体部件（切缝取自逐行游程间隙与颜色族连通域， 不是目测），16 层并集与描出的躯体掩膜完全相等：0 像素丢失、0 像素臆造。每层按 2 倍屏幕尺寸导出并以 data URI 内嵌，插件仍是单文件、无需资源路由。viewBox 0 0 300 340、渲染 240x272，躯体占 227.68 x 291 单位、宽高比 0.782 —— 就是参考图自己的比例。眼睛保留矢量（画在切片器补绘过的眼窝上）， 情绪变色/发光/眨眼照旧；脐带电缆保留矢量，因为它必须弯折。

挂载位置与层级（不要随便改）

桌宠注册在 shell.overlay slot，但渲染内容用 react-dom 的 createPortal 投到 document.body > div.eva01-portal。这不是为了好看，是必须的：shell.overlay 的祖先 overlayLayer 是 z-index:20，而 dsh-better-sidebar 的右侧面板 .W-zNGW_panel 与底部面板 .W-zNGW_bottomPanel 都是 z-index:50 且 88% 不透明 —— 桌宠在那个层叠上下文里无论把自己的 z-index 抬到多高都会被盖住（实测 z-index:2147483000 同样无效），连点击事件都被面板吃掉。

层级取值 60，有实测依据：全页常驻层只有 toggleCluster 55 / panel 50 / bottomPanel 50， 而宿主的模态框、遮罩、toast 在 100–1100。所以 60 恰好压过所有常驻面板，又仍在所有模态类 UI 之下（报错弹窗永远盖在桌宠之上）。容器 pointer-events:none + 桌宠本体 pointer-events:auto， 保证这个全屏容器不吃任何页面事件。默认落点在左下 left:24px;bottom:84px，避开右侧面板内容； 初始朝向即镜像（is-left），与「左半边镜像」规则一致，避免第一次拖拽时凭空翻面。

交互

动作系统

两层：情绪循环（永不停，float 整体浮动 13px / sway 摆头 ±5° / breathe 呼吸 1.055 / 双臂 ±7° / 线缆 ±6° / 肩甲反相 ±2° / 头侧绿鳍 ±4°（BERSERK 下改为 0.34s steps 抽动）/ 地面阴影跟随），叠加离散一次性动作。只有循环时，旁人 会觉得「没在动」——离散动作才是能被一眼看见的节拍。

共 26 个离散动作。每个动作都是「三件套」：ACTIONS 表项 + @keyframes eva01-* + .eva01-root.is-act-<名字> 选择器（注意是 is-act- 前缀，组件里拼的是 cls += " is-act-" + act）。 下表的时长/优先级/门控/权重/音效 kind 均取自 lib/client.js 的 ACTIONS 表实际值。

> T18 已组接：上表原本标「预留」的 6 个动作全部报上了真实触发点（见 T18 節）；新增的 audit-triggers.cjs 闸门保证不会再出现只有关键帧、永远跑不到的动作。

互斥规则：暴走/蓄力/撕枷/停机(5) > 颤抖/挥砍/防御(4) > 情绪反应/回弹(3) > 打招呼(2) > idle break(1) > 情绪循环。 运行中的动作会拒绝优先级更低或相等的请求，所以两个动作永不争抢同一个 transform；拖拽中一律拒绝 （机体本身就是拖拽把手）。每条关键帧的 0% 与 100% 都回到 identity，class 摘掉时不会跳变。

调试触发钩子（供自动化验证用，非 UI 功能）：

window.__eva01.play('hop')   // -> boolean，被情绪门控/优先级拒绝时返回 false，未知动作名返回 false
window.__eva01.actions       // 动作名列表
window.__eva01.state()       // { mood, act, drag }

音效

全部现场合成：振荡器 + 一块共享白噪 buffer 过 biquad，插件不带任何音频资源文件。 共 44 个 kind，硬约束由 tests/audio.mjs 断言：单层峰值 ≤ GAIN_CAP 0.12、单个配方 delay + dur ≤ 2s、同一 kind 的重叠峰值 ≤ 0.26，母线 BUS_GAIN 0.75。最响的仍是 roar （0.24 合计 → 出口 0.18）。设计依据与逐层理由见 SFX_RESEARCH.md。

T8 新增 15 个 kind（THROTTLE 为同一 kind 两次播放的最小间隔）：

三个状态型音效不走 ACTIONS[x].sound，而是在情绪层周期请求、靠 THROTTLE 自然限流： battery 在 ALERT 下每 0.9s 请求一次、1s 节流 → 实际约 1.8s 一响；s2 在 BERSERK 下每 0.9s 请求、6s 节流 → 约 6.3s 重新起一次驻留；pulse 每 1.5s 请求，BERSERK 每次都过（心率飙升）， 其余情绪过 35% 概率门 → 平均约 4s 一拍，ALERT 下让位给电池倒计时。

标「待接」的 7 个已实现并通过全部断言，只是还没有触发点（与早前的 power / hum 同一处理方式）。

状态联动

情绪读自两个来源：shell.overlay 标准 prop useSessions（会话列表：谁在跑、谁在等你），以及当前会话的对话装配——插件自己用客户端 sessions 服务把 sessions.binding(current).session 的 ConversationSnapshot 订阅下来。同步率每 0.9s 向目标值收敛：

优先级：BERSERK > ALERT > OPERATE > ACTIVE > STANDBY > IDLE。

派生规则（readFeed）：

• TOOL n —— 窗口内 tool-result 节点数 + 当前在跑的调用数。
• ⚠ PATTERN BLUE ×n —— 失败的 tool-result（isError）与 turn-error 节点计为「使徒」。
• ALERT —— 由 lastAgentError 文本变化驱动，警报持续 8 秒后自动解除并播报「使徒歼灭」。订阅建立时读到的那条错误只作基线，不报警，所以刷新页面不会为历史失败拉响警报。
• 流式 token 不触发重算：feedSig 只在节点数、在跑调用、错误文本变化时才重新折叠快照。

安装

dsh plugin --profile web add link:E:/DSH/plugins/eva-unit01

该命令会同时把包名追加到 profile package.json 的 dsh.profile.bundles。bundle 列表在启动时 读取，需要重启 dsh 才生效。

验证组合树（不启动应用）：

dsh --profile web --dump-config

测试

node tests/smoke.mjs

用假的 window.__ModuleLoader__ 与假 useSessions 快照，跑真实 React 渲染。覆盖：

• 模块形状、导出、样式表只插一次、Slot 注册参数、inject 含 slots 与 sessions；
• readFeed 快照折叠 6 例（空会话、落地工具计数、失败工具与 turn-error 计为使徒、在跑调用取名并计数、错误文本、未知形状降级为空）；
• feedSig 的流式抑制：同一节点集下 partial 变化不重算；
• subscribeFeed 真实订阅路径：首读作基线、后续变化上报、token-only 变化不重复通知、disposer 解绑、无 sessions 服务降级、binding() 抛错降级；
• moodOf 六档优先级，且标签与同步率互不重复；
• Hud 七种状态的实际标记（OP <工具名>、TOOL n、ACT n、⚠ PATTERN BLUE ×n、PWR mm:ss、进度条宽度）；
• 4 种会话快照的整机渲染，以及 apply() 注册的 overlay 入口能真实渲染；
• 样式表里每个情绪态都有对应状态规则，避免加了状态却没有视觉。

SSR 不跑 effect，所以 OPERATE/ALERT 的验证走两条可测缝：订阅逻辑用假 session face 直接驱动， HUD 标记用独立的 Hud 组件按状态渲染。

设计说明：为什么不走宿主事件

早期动态插件版本用宿主 agent/error 与 tools/result 事件驱动 ALERT 与 TOOL 计数。常驻插件的 浏览器半程没有动态包那种 Package 私有 host.call 通道，而 @deepseek-ai/dsh-api-remotes 的转发 白名单（API_REMOTE_FORWARDED_EVENTS）是构建时固定的、不含这两条事件——不改动 deployment 自带的 安装就加不进去。

但这两项能力不需要宿主通道：浏览器本来就持有当前会话的完整装配。ConversationSnapshot 直接带 nodes（含 tool-result / turn-error）、runningCalls 与 lastAgentError，所以改成从客户端 快照派生，反而比事件驱动更好：

• 刷新页面后计数不丢（快照是权威，不依赖曾经收到过哪条事件）；
• 能显示当前正在执行的工具名，事件计数做不到；
• 零宿主侧改动，宿主半程仍是空 apply。

代价：计数限于当前加载窗口内的节点（loadOlder 之前的历史不计入）。

T12：表现形式换轨 + 通知层（本轮）

1. 为什么换成贴图骨架

手写矢量追插画追不上：换轨前用同一像素管线量测，桌宠 vs 参考图是 aspect 0.912/0.782、头高占比 45.0%/35.5%、头宽高比 1.656/1.874、颈线 0.449/0.354 —— 四项全偏，而且每改一次都要重打上百个 路径坐标。改成「切参考图」后，比例不再需要调：等比贴图天然带着参考图的比例。

2. 验收数据（pet-ref/compare-fidelity.py，双图同一管线，不用硬编码常量）

measure-pet.py 里那组 REF 常量已被证伪：它的 legsplit_frac 0.744，用同一管线量参考图自己 得到的是 0.998 —— 该指标本身不可用，已改由 compare-fidelity.py 现场量测双图。

3. 关节表（由切片 bbox 导出，CSS transform-origin 与之一致）

4. 气泡与提示音（三态 + 两声）

任务结束的动作节拍改为 45% cheer / 55% salute，避免连续完成时一直敬礼。down 音重新接到 警报解除（下降双音正是「降级」语义），音效接线审计因此回到 44 kinds / 44 已接线。

5. 暴走态色彩处理（依据第二张参考图的实测配色）

第二张暴走参考图是满幅插画（白底仅 0.3%，血红背景 #da3533 占 12.7%），抠不出干净的角色掩膜 （试得的掩膜填充率仅 0.52 且贴到画面底边），因此本轮不切第二套贴图，只取它的权威配色做色彩分级： 角色主紫实测 #393172（平时 #5e369c）、灰 #616371、绿 #4a8850、暗部 #201e2a。落地为 .eva01-root.is-berserk .eva01-inner{filter:brightness(.76) saturate(.88) contrast(1.14) drop-shadow(0 0 9px rgba(216,53,51,.55))} —— brightness(.76) 把 #5e369c 压到约 #472a76， 红色投影补上背光；眼色与 A.T. 场原本就走 --eva-* 变量切换。

6. 新增 4 个动作 / 3 个音效

finflare（鳍片外张，1300ms，音 plate）、armcross（双臂交叠，1400ms，音 latch）、 lookback（回望：眼先动 → 头转 → 鳍延迟 → 电缆最后跟，2000ms，音 pivot）、cheer（跃起举臂， 1300ms，音 comms）。三个新音效按 SFX_RESEARCH.md 的分层规则（瞬态 → 本体 → 尾音）推导。

7. 本轮的诚实边界

• 本机 web_search 未配置 DEEPSEEK_API_KEY，本轮没有任何新的联网来源；新音效是声学推导而非引用。
• 本机模型无图像输入（describe_image 插件 baseURL 无效、modlens 超时），所有形象判断都是像素统计，

不含任何「我看了一眼觉得像」。视觉终审仍需你本人看一眼 GUI。

• 暴走形象目前只是色彩分级 + 既有开颌/獠牙/抖动，不是第二套贴图；要复刻那张图的姿态，需要一张

白底或透明底的暴走立绘。

T13：切片没扣干净的修复（用户报告）

用户截图指出机体带白斑/白边。查证后是切片器 v1 的两个真实缺陷，不是渲染层问题：

修复后量测（slice-rig2.py 自带审计）：

体积同时下降：base64 278KB -> 265KB，client.js 408,698 -> 395,758 字节。 回归：tests/audio.mjs 3597 断言、tests/smoke.mjs、audit-classes、t7-crosscheck.mjs 902 断言全过。

T13b：脸上被啃出透明缺口（用户第二次报告）

用户报告头部出现应为黑色却透明的区域。查证：v2 掩膜共 6 个洞，其中 5 个在脸上 （最大 985 px，x209-244 / y255-297，原图均值 RGB(142,54,116) —— 实心美术），只有 1 个 （x380-468，RGB 249,249,249）是真背景空隙。

成因是 v2 里那段颜色键剔除红色 CJK 文字块的代码：(R>200)&(G<70)&(B<70) 同时命中了角色脸上的 亮红高光（#c8262c 的 R 正好 200），再经 5x5 两次膨胀，就在高光四周啃掉约 4px 深的一圈。 而红字块本身是独立连通域，取最大连通域时天然被排除 —— 那段剔除逻辑纯属多余。同时移除了 binary_opening，它会啃细线条美术。

新增不变量（这条断言本可以第一时间拦住上面的 bug，现已内建）：每个保留为透明的洞，其原图颜色 中位数必须是近白页面（min 通道 > 225），否则直接 SystemExit 拒绝导出。

回归：audio 3597 断言、smoke、audit-classes、t7-crosscheck 902 断言全过；线上 bundle 400,421 字节。

T14：暴走正典动作集（AT 力场 / 持枪 / 振动小刀 / 出击 / 殴打使徒）

1. 五个新动作

暴走链改为正典顺序：charge(0) → roar(1560) → atopen(3160) → beatdown(4960)，末尾 7160ms， 仍在 8 秒暴走窗口内；每次交接都等上一动作结束，不会有两个动作抢同一个 transform。 ALERT 不再只是摇头：40% 持枪 / 35% 抽刀 / 25% 保留原摇头。

2. 两件手绘矢量道具

参考图里没有武器，所以枪与刀是手绘矢量（不是切片），挂在 eva01-armR 组内随臂运动， 平时 opacity:0，只在自己的动作里显形：

• eva01-rifle 托盘式步枪：机匣 + 顶部受光棱 + 枪口块 + 弹匣，另有 eva01-flash 枪口焰
• eva01-knife 振动小刀：刀身 + 刃口高光 + 刀柄
• eva01-hit 命中火花两片，放在 inner 层而非手臂组，所以不会随拳头一起旋转

3. 声画对齐（这轮特意校过，不是凑巧）

4. 四个新音效（合成参数）

5. 闸门抓到并修掉的两个真问题

1. eva01-atHex 与 eva01-beatHit 的 0%/100% 不是 identity（scale(.72)/scale(.6)），违反 「class 摘掉不得跳变」的不变量 —— 已把缩放挪到内部帧，首尾恢复 scale(1)。 2. atopen 起初给了 idle 权重且门控含 alert/berserk，使警报态与暴走态混进了闲时随机池 （危机中不该摸鱼）—— 改为 idle: 0，仍可由暴走链与 window.__eva01.play() 显式触发。

回归：audio.mjs 4054 断言 / 48 kinds、smoke.mjs、audit-classes、audit-sfx-wiring、 t7-crosscheck.mjs 1133 断言 / 31 动作 / 180 组关键帧 全过；轮廓 IoU 0.9881 未受影响 （渲染 harness 已同步剥离武器与火花图层，否则会污染轮廓量测）；线上 bundle 415,482 字节。

6. 仍未做到的

• 暴走形态依旧是色彩分级 + 开颌獠牙 + 抖动，不是第二套贴图：那张暴走图是满幅插画，抠不出

干净掩膜（见 T12 第 5 节）。要真正复刻其姿态，需要白底或透明底立绘。

• 音效仍是按声学与既有 SFX_RESEARCH.md 体例推导；本机 web_search 无凭据，**本轮依然没有新的

联网正典来源**，不要把上表当作引用。

T15：补上联网检索能力，并把正典音效调研补做完

1. 能力从哪来（没装插件也能用）

根因是 dsh 进程带着一个已死的代理（127.0.0.1:7897）：api.github.com 走它 rc=7 拒连、 走 33210 或直连都是 200。所以 web_search（还缺 key）与 find_dsh_plugin（返回空列表） 都不是坏了，是被掐住。

新增 E:\DSH\tools\websearch.py：自动探测可用路由（33210 → 7897 → 7890 → 直连）， 走 DuckDuckGo HTML 端点，零 API key、零第三方依赖（纯标准库）。三个子命令：

python E:\DSH\tools\websearch.py search "query" [n]
python E:\DSH\tools\websearch.py fetch  "https://..." [chars]
python E:\DSH\tools\websearch.py github "topic query" [n]

2. 可选插件（真实检索结果，按星数）

注意：装任何一个都改不了根因 —— 插件跑在 dsh 进程里，同样会走那个死代理。 顺序应为：先跑 E:\DSH\fix-uv\apply-uv-fix.ps1 修代理端口 → 重启 dsh → 再装插件。

3. 调研成果与对音效的实际改动

详见 SFX_SOURCES_T15.md（每条结论带来源链接）。三处实现改动：

仍无权威来源的项（A.T. 力场音、弹射音、托盘枪音）继续标注为声学推导，不冒充引用。

> T16 更新：其中 A.T. 力场音 与 托盘枪音 已在 T16 找到来源并落地（见下一節与 SFX_SOURCES_T16.md）；弹射音仍无来源。

回归：audio.mjs 4132 断言 / 49 kinds、smoke.mjs、audit-sfx-wiring、 t7-crosscheck.mjs 1133 断言 全过。

T16：把「无来源」的音效追到底 + 第一次真正的视觉终审

1. 先修能力，再干活

上一轮的两个硬限制本轮都没了：代理从死掉的 127.0.0.1:7897 改到 33210（用户级 环境变量已改，dsh 重启后继承），websearch.py 因此能真的联网；图片理解（describe_image） 配好了 Ark /api/v3 + doubao-seed-1-6-250615，实测可读图 —— T12/T14 反复声明的 「本机模型无图像输入，视觉终审仍需你本人看一眼」这条限制，本轮第一次可以自己做了。

2. 视觉终审：确认无瑕疵，但也确认了「不能听视觉模型讲细节」

把 pet-ref/pet-shot.png（桌宠渲染）与 pet-ref/reference.png（参考插画）分别交给视觉模型， 同一套提问（对象数、姿态、比例、颜色分区、瑕疵、面部细节）：

但视觉模型对细节给出了两条矛盾描述：说桌宠眼睛是「圆形、无瞳孔」、参考图是「横向椭圆、有黑色瞳孔」， 还说桌宠嘴是「咧嘴」、参考图是「闭合」。这两条被像素测量证伪（黄色连通域 bbox 与域内暗像素占比）：

两图的眼形比例与瞳孔占比几乎相同，桌宠是有瞳孔的，也没有哪一只眼睛是「横向椭圆 vs 圆形」的差别。 所以本轮没有按那两条描述改任何形状 —— 视觉模型可用于「有没有明显瑕疵」这类整体判断， 它的细节措辞不能当量测用。

3. 音效来源：一条真改动，一条认输

完整来源与摘录见 SFX_SOURCES_T16.md。

新的工艺定位（写死在文档里）：论坛一手结论是 NGE 的 TV 版音效「以现成音效库 + 混音为主」， 音响制作方为 "Audio Tanaka"。原作没录真物、我们也没录真物，所以本插件的音效永远只能是声学推导， 任何时候都不写成「复刻正典音源」。

声画对齐随之 retime（T14 第 3 节的规矩）：枪火三帧 12% / 17.5% / 23%（240 / 350 / 460ms） ＝ 音效层 delay 0.24 / 0.35 / 0.46；eva01-gunFlash / eva01-gunBody / eva01-gunArmR 三组关键帧一并改，首尾仍是 identity。

4. 顺手修掉的文档缺陷

README 里 T12 章节整段重复了两次（2590 字符逐字相同，应是上一轮 patch 的编辑事故）。 本轮删掉第二份，删除前先断言两段完全相同才动手。

5. 回归

audio.mjs 4196 断言 / 49 kinds、smoke.mjs、audit-classes（180 组关键帧、0 处缺 0%/100%）、audit-sfx-wiring、t7-crosscheck.mjs 1133 断言 / 31 动作 全过。 rifle 新增两层后单层峰值仍 ≤ 0.12、三发窗口互不重叠（0.24–0.33 / 0.35–0.44 / 0.46–0.55）。

6. 仍未做到的

• 暴走第二套贴图依旧没做：那张暴走插画是满幅背景（白底仅 0.3%），抠不出干净掩膜（T12 第 5 节），

现在图片理解虽然能用了，但它给不出掩膜，只能给描述 —— 缺的是一张白底/透明底暴走立绘。

• launch / punch 的正典来源仍缺；下一轮可追 "Audio Tanaka" 与 EvaGeeks thread 21607

（本轮抓到的正文只有提问，没有答复）。

• 6 个「预留」动作（shiver / slash / unbind / guard / shutdown / rebound）与

5 个「待接」音效（umbilical / unplug / atburst / lcl / lifeless）仍没有自动触发点。

T17：按两张参考图改暴走与 A.T. 力场（音效跟着动画走）

用户给了两张图：图 A 是初号机 Funko 手办实拍（深蓝近黑背景占 80%，手持红色长枪）， 图 B 是暴走形态插画（红底）。

1. 先说两个如实结论

两张图里都没有 A.T. 力场。 视觉模型对两图分别独立回答"未出现力场"，图 A 的颜色直方图前 12 位 全是 #000818/#081020 一类近黑（背景），也没有任何几何叠加的迹象。所以本轮 A.T. 力场的改法 依据不是这两张图，而是荧幕上的多层六边形障壁表现，这一点必须写清楚。

图 B 依然抠不出干净掩膜，第二套贴图继续不做。 这次是量出来的，不是感觉：

…