dsh-live2d-avatar
可切换的 Live2D 虚拟形象舞台和 DeepSeek Harness 桌面伴侣。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-live2d-avatar@0.3.0Live2d Avatar 以 dsh-live2d-avatar 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
dsh-live2d-avatar 为 DeepSeek Harness（DSH）提供可切换的 Live2D 对话舞台、轨迹展示和桌宠模式。它不替代 DSH 的对话、Agent、记忆、工具或历史记录，只负责角色的视觉表现和可选的语音交互。
可以让 DSH Agent 执行：
请帮我安装 dsh-live2d-avatar 插件，并确认安装后可以打开“形象”视图。
也可以手动安装：
dsh plugin --profile web add dsh-live2d-avatar
dsh web
打开一个非空对话后，选择“形象”即可看到内置 Haru。卸载：
dsh plugin --profile web remove dsh-live2d-avatar
在普通 dsh web 中，桌宠会显示为页面内的可拖动浮层。在 TokensCowork Desktop 中，插件可以创建透明、无边框、置顶的独立窗口，因此主窗口最小化或被其他应用遮挡时，角色仍可显示在 Windows 桌面上。
独立窗口仍依赖正在运行的 TokensCowork Desktop；退出客户端后桌宠也会关闭。桌宠和舞台会使用当前形象设置，包括模型、角色名、缩放和位置。
🐣 第一次用、想一步步照做？ 完整的分步操作（怎么判断、怎么配 Electron、怎么验证、常见问题）见 桌面端桌宠模式使用说明。
新版 DSH Desktop 把 DSH Host 整体放进了 Electron 的 utilityProcess 子进程，而 BrowserWindow 属于主进程 API，Host 里拿不到。因此本插件不再由 Host 直接建窗，而是由 Host 拉起一个独立的 Electron 伴生进程（companion），由它创建透明、无边框、置顶的桌宠窗口并加载 /avatar/pet。
Host 会按以下顺序探测可用的 Electron 二进制，找到后用它启动伴生进程；都找不到时自动退回页面内桌宠：
companionElectronPath）DSH_LIVE2D_AVATAR_ELECTRON 指向的 Electronvendor/<platform>-<arch>/（或 vendor/）目录下的 Electron（不进 Git，不随包发布）process.execPath，仅当没有打包为 app.asar 时）PATH 上的 Electron打包安装的 TokensCowork 不携带独立的通用 Electron 二进制，因此真实用户的独立桌宠需要提供上表第 1–3 项之一（例如把 electron.exe 放到 vendor/win32-x64/、设置 DSH_LIVE2D_AVATAR_ELECTRON，或在“形象”设置里填写路径）。未提供时桌宠作为页面内浮层显示，并在界面给出文档提示。
页面内桌宠始终作为兜底保留：只有桌面引擎可用时才启用独立伴生窗口。
在“形象”设置中可以配置：
.model.json 或 .model3.json 文件也可以把模型目录放在插件的 assets/models/<名称>/ 下。由于模型目录会由本机 DSH 服务提供给浏览器，请只选择专用模型目录，不要选择包含隐私文件的宽泛目录。
未知模型会使用通用 profile；基础渲染、口型同步和模型自带的点击动作仍可工作。更细致的表情到动作映射属于后续版本，不影响第一版使用自定义模型。
内置 Haru 使用 Live2D 的 Free Material License，具体授权请阅读 assets/models/haru/NOTICE.md。Haru 的授权不包含在本项目 MIT 许可证中。
表情控制 prompt 会让当前对话中的 LLM 在台词前输出 Live2D 表情和动作指令。它可能改变发送给模型的 prompt，因此属于可选且具有侵入性的功能：
第一版不要求所有用户都能使用语音功能。ASR 和 TTS 默认关闭，视觉舞台、模型和桌宠不依赖语音服务。
启用后，可以填写自己部署的 ASR/TTS HTTP API 地址。当前实现优先兼容 ModelDeck 使用的接口格式；其他服务和渠道会在后续版本逐步支持，也欢迎通过 Issue 提出需求。录音只会发送到用户配置的 ASR 地址，回复文本只会发送到用户配置的 TTS 地址。
API 密钥不会填写到浏览器设置中，只支持从 DSH host 的环境变量读取。请仅配置自己信任的 http(s) 地址，并注意语音数据和文本会离开本机发送到该服务。
pnpm install
pnpm check
pnpm build
pnpm test
pnpm watch
本地安装到 DSH Web profile：
dsh plugin --profile web add link:C:\path\to\dsh-live2d-heroine
dsh --profile web
发布前检查项见 docs/release-checklist.md。
插件代码使用 MIT 许可证，见 LICENSE。内置 Haru 示例素材由 Live2D Inc. 提供并受其单独授权条款约束；请同时阅读 NOTICE.md 以及 Live2D Free Material License。