dsh-pet-guardian-dragon

LIMITATIONS

Known limitations

1. **美术是真生图 + 真抠图，但仍非「分部件骨骼动画」**。现在是 NVIDIA FLUX.1-dev 生成、绿幕抠出的独立透明素材（少女主体 / 守护龙影 / 头像 256 / 回眸 / 投喂 / 走路四帧），龙影作为独立元素浮游并参与点击回眸与投喂特效。但每张素材是整图而非分层（发丝/裙摆没有单独图层），因此**走路是用四帧整图按相位循环**模拟踏步，而不是骨骼驱动的连续步态；发丝与裙摆也没有独立运动。 2. **动作变体是文生图产物，不是真正的图生图**。任务原本指定 kontext 图生图，但该端点在本账号上只接受预注册的 `example_id`（完整实测见上文），所以所有变体都是用**锁定的角色设定表 + 原始种子 seed=7** 独立生成的。各帧在发色/瞳色/精灵耳/皇冠+蓝花/裙装配色/镰刀上一致，但**并非像素级同一角色**：皇冠尖角形状、裙摆纹样细节、鞋子等仍有小幅差异；走路四帧之间也存在这类差异。更麻烦的是**模型会逐帧重新决定提示词没写到的细节**——镰刀怎么拿、穿不穿鞋——所以姿态提示词必须显式钉住道具与服装（见上文「两个必须钉住的地方」）。若日后该账号开通了真正的图生图能力，把 `gen-actions.py --method img2img` 接上即可，脚本与后续管线都不用改。 3. **走路是四帧相位驱动，不是逐帧动画**。contact-A / passing-A / contact-B / passing-B 四个关键帧按累计横向位移循环，帧间靠 0.1s 交叉淡化与 2px 纵向起伏过渡。再提高流畅度就要为更多相位生成独立立绘，成本线性增长，且每多一帧都会推高内联体积（当前四帧合计约 116 KB）。 4. **思考与干活未区分**。两者都由「有会话 running」驱动，只是动画速度不同。要区分需要读推理 partial / 运行中工具（`useConversation` 的 `views.get('chat').legacy`），但该 hook 只在 `session` 作用域可用，悬浮层的 root 作用域拿不到，需要额外设计。 5. **未做 Live2D**。当前是静态图 + CSS 变换。要真 Live2D 需引入 `pixi-live2d-display` 与 Cubism Core，并注意模型与 Cubism 的商用授权条件。 6. **未在真实浏览器里目视确认**。启动图与资源提供都已验证，但「桌宠画出来、拖得动、特效正确」需要你在浏览器里目视确认。代码已包在 React 错误边界里：万一某个 DSH 版本的 slot 契约变化导致渲染抛错，只让桌宠消失，不会连累 AppFrame。 7. **`dsh.client.inject` 的改动要重启才生效**。启动图里当前仍是最初声明的三个 inject 边（宿主对包元数据有缓存）。实测这三个包都存在且组合成功，所以留着也无害；下次重启后会变成空列表。 8. **走的是 patch 层挂载，未进 profile 清单**。DSH Desktop 有一项 profile 一致性审计，它看的是 `profiles/web/package.json`（`dependencies` / `dsh.profile.bundles`），**不认 patch 层**。所以它可能记一条 `profile inconsistency: … is installed but declared nowhere in the profile manifest`。实测这不影响加载（本插件确实进了启动图并被正常提供），当前日志里也**没有**本插件的此类记录。若想彻底消除，等 pnpm 可用时执行 `dsh plugin --profile web add link:<本目录绝对路径>` 即可（受限环境下禁止子进程命名管道，pnpm 会报 `spawn EPERM`，因此这一步无法在受限环境中完成）。