xieluyang912/dsh-live2d-widget ↗★ 1

dsh-live2d-widget

支持多角色切换、自定义台词与模型导入的Live2D挂件 适合喜爱Live2D角色、想要在Web界面添加可交互二次元挂件的用户。

包名
dsh-live2d-widget
兼容性
待验证
版本
1.2.0
许可证
NOASSERTION
最近更新
2026年9月29日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:xieluyang912/dsh-live2d-widget

Usage

After opening DSH a character appears in the bottom-left corner. The round L2D button at her top-right opens the control panel.

SectionWhat it does
ModelClick any entry to switch instantly. Entries marked 导入 are yours; × deletes them.
大小Overall size (0.4× – 2.2×). This resizes the canvas, so the character grows with it and is never cropped.
适配How much of the canvas the model fills (0.1 – 3.0). Mainly for imported models; the bundled ones are pre-calibrated, so 1 is right.
左右 / 上下Fine position inside the canvas (−2 – 2).
透明Overall opacity (15 – 100).
左右翻转 / 换边Mirror, and swap between the bottom-left and bottom-right corners.
随机动作 / 随机表情Poke the model on demand (greyed out when it has no motions or expressions).
恢复默认Reset the current model's size, fit, position and appearance to the built-in defaults.
隐藏模型Tuck it away; Ctrl+Shift+L brings it back.
点击台词Collapsible: bubble toggle, dwell time, line editor.
导入自己的模型Collapsible: the three import paths.

Three ways to set a value

Every number can be set three ways, and all three stay in sync:

  1. Drag the slider — the obvious one.
  2. Type a number — into the field on the right; commit with Enter or by clicking away. Out-of-range values clamp to the limit, and unparsable text reverts to the value still in effect.
  3. Press and drag the number sideways — scrubbing (about 320px sweeps the whole range). If you press and release without moving, the field focuses so you can type instead.

Speech bubble

  • Expand 点击台词 and tick 点击模型时说话; clicking the model then pops a random line.
  • In the text box, one line per message. "保存台词" commits, "恢复默认台词" restores the character's built-in persona, "试说一句" previews immediately.
  • 停留 controls how long the bubble stays up (2 – 20s).
  • Lines are stored per model, so each character can have its own voice.
  • Switching models also greets you with a line.

The shipped lines are written in character — Rem says 「雷姆,会一直相信你的。」, Sagiri says 「哥哥,你回来啦……」, Histoire says 「知识,就是力量哦。」.

Dragging and shortcuts

Hold the model and drag it wherever you like; it is remembered. A drag never also fires a line. Placing it near the top of the screen is fine — the panel shrinks itself so it stays on screen.

ActionEffect
Drag the modelMove it (remembered)
Single click the modelSay a line
Ctrl+Shift+LShow / hide the model
Click the L2D buttonOpen / close the control panel