dsh-live2d-pets
适用于 DeepSeek Harness 的 Live2D 宠物插件：富有个性的智能体伴侣——跟随会话状态、可切换人格、支持自带模型
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:cyanfish-x/dsh-live2d-pets#6af6f021354afbf30394e363f23caafc800f2b28
Live2d Pets 以 dsh-live2d-pets 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
给 DeepSeek Harness 请了个看板娘：你思考它歪头，你完成它撒花，还能摸头！
.model3.json 的 https / http URL，或填写本机绝对路径（如 C:/models/foo/foo.model3.json，由插件 Host 转成同源 HTTP 加载）；自定义模型可配置动画映射，把模型原生动作组挂到状态/互动部位~/.dsh/settings.yaml，自定义人设与自定义模型存于 ~/.dsh/live2d-pet/ 插件私有 JSONC 文件，即时生效把下面这段提示词复制给你的 DSH agent（在 Web GUI 对话中直接粘贴即可），它会自己安装并验证：
请帮我安装 dsh-live2d-pets 插件（DSH 的 Live2D 桌宠插件）：
1. 执行 dsh plugin --profile web add dsh-live2d-pets 安装
2. 执行 dsh plugin --profile web list，确认 dsh-live2d-pets 出现在已安装列表中
3. 告诉我安装结果；如果失败，请附上错误信息
在终端执行（web profile 首次使用时自动初始化）：
dsh plugin --profile web add dsh-live2d-pets
安装后插件默认启用。启动 DSH：
dsh web
浏览器打开后，右下角会出现默认宠物（尺寸 160px）。当前默认模型为 Hiyori（Live2D 官方示例模型），首次加载需联网。
自定义模型：打开设置 →「桌宠配置」→「我的模型」，填写名称与 .model3.json 地址（外网 CDN、自建静态站、本机 HTTP 服务，或本机绝对路径如 C:/models/foo/foo.model3.json 均可；本地路径由插件 Host 通过 /pet-local-models/... 同源路由加载）。可展开 「空间分区覆盖」 按字段微调五矩形（头/身/腿居中列 + 左右臂；0–1，留空用默认），或展开 「动画映射」 实时解析模型动作组，为状态/互动部位选择动作组；建议配合开发者选项「显示点击分区」对照色块。内置 Hiyori 已带居中分区预设。
打开 DSH 设置 →「桌宠配置」，改完立刻生效，无需重启。
$DSH_HOME/live2d-pet/personas.jsonc，改完点「↻ 重新读取」.model3.json URL（可选空间分区覆盖 / 动画映射）；自定义模型存于 $DSH_HOME/live2d-pet/custom-models.jsoncdsh plugin --profile web remove dsh-live2d-pets
| 需求 | 文档 |
|---|---|
| 英文 README | [README.en.md](README.en.md) |
| 产品意图 | [docs/intent/live2d-pet-plugin.md](docs/intent/live2d-pet-plugin.md) |
| 行为规格 | [docs/spec/live2d-pet-v01.md](docs/spec/live2d-pet-v01.md) |
| 架构决策 | [docs/adr/](docs/adr/)（渲染栈见 ADR-003） |
| 调研记录 | [docs/research/](docs/research/)（设置面板接入机制见 settings-tab.md） |
shell.overlay 悬浮层（视觉层 Popover 顶层，ADR-005），设置页注册于 settings.section（ADR-002）agent/* 事件 → 同源 SSE /api/live2d-pet/events（ADR-006）；标签页隐藏 / 失焦暂停渲染ctx.settings（~/.dsh/settings.yaml 用户层覆盖 base）；自定义人设 ~/.dsh/live2d-pet/personas.jsonc、自定义模型 ~/.dsh/live2d-pet/custom-models.jsonc 由插件直接读写；传输走插件自身 API /api/live2d-pet/settings（settingsScope wire 白名单限制，见 research 3.4/3.5）[src/presets/presets.jsonc](src/presets/presets.jsonc)）