cyanfish-x/dsh-live2d-pets

cyanfish-x★ 4TypeScriptLast synced: 2026-08-15

Open on GitHub

Live2D 桌宠插件 for DeepSeek Harness:Agent 状态镜像 + 互动陪伴,内置宽松许可预设模型 / Live2D pet plugin: agent state mirror + interactive companion with curated permissive-license presets

README excerpt

dsh-live2d-pets 🐾 English 简体中文 DSH(DeepSeek Harness)的 Live2D 桌宠插件: 支持任意外部 URL 或本地模型地址加载 Live2D 模型 。 特性 - 模型加载 :内置 5 条策展模型(Hiyori / Haru / Mao / Mark / Natori)+ 自定义条目;可用任意 .model3.json 的 https / http URL ,或本机可达的本地模型地址 - 状态镜像 :宠物实时反映 agent 思考 / 空闲 / 出错 / 完成 / 等审批(动画 + 气泡,SSE 推送) - 人设台词 :内置六种人设(傲娇 / 元气 / 天然呆 / 三无 / 温柔治愈 / 病娇),可在插件独有 JSONC 中自定义并热切换 - 互动陪伴 :分部位触摸反应 / 拖动停靠,任务完成庆祝;HitArea 不足时按包围盒五矩形空间回退分档 - 桌宠配置设置面板 :DSH 设置 →「桌宠配置」,开关 / 尺寸 / 渲染帧率 / 人设 / 模型列表 / 开发者选项;写入 /.dsh/settings.yaml ,即时生效 - 不打扰 :默认右下角、小尺寸、可拖动、可隐藏、标签页隐藏暂停渲染、限帧渲染、低配降级静态头像 快速开始 方式一:复制提示词让 agent 安装(推荐) 把下面这段提示词复制给你的 DSH agent(在 Web GUI 对话中直接粘贴即可),它会自己安装并验证: 方式二:手动安装 在终端执行( web profile 首次使用时自动初始化): 安装后插件默认启用。启动 DSH: 浏览器打开后,右下角会出现默认宠物(尺寸 160px)。当前默认模型为 Hiyori(Live2D 官方示例模型),首次加载需联网。 自定义模型:打开设置 →「桌宠配置」→「我的模型」,填写名称与 .model3.json 地址(外网 CDN、自建静态站或本机 HTTP 服务均可)。比例与默认差较多时可展开「空间分区覆盖(可选)」按字段微调五矩形(头/身/腿居中列 + 左右臂;0–1,留空用默认);建议配合开发者选项「显示点击分区」对照色块。内置 Hiyori 已带居中分区预设。 配置设置 打开 DSH 设置 →「桌宠配置」 ,改完立刻生效,无需重启。 - 显示 :开关宠物 - 尺寸 :40–400px(默认 160) - 渲染帧率 :30 / 60 / 不限制(默认 30) - 人设台词 :切换内置或自定义人设;「自定义人设 ↗」编辑 $DSH HOME/live2d-pet-personas.json ,改完点「↻ 重新读取」 - 模型 :选内置策展模型,或在「我的模型」添加名称 + .model3.json URL(可选空间分区覆盖) - 开发者选项 :调试面板、显示点击分区色块 卸载 文档 需求 文档 …

View full README on GitHub →
Agentscubismdeepseek-harnessdesktop-petdshdsh-pluginlive2dmascotplugin

Category