DSH PNG 桌宠

Windows-only DeepSeek Harness（DSH）桌宠插件。DSH 负责会话和模型；此插件只启动本地 WPF 桌宠 Helper，并通过 stdin/stdout JSON Lines 通信。

• GitHub: https://github.com/comfylies/dsh-png-pet
• DSH 插件社区: https://github.com/topics/dsh-plugin

请求批准与问卷（本地构建 v0.3.0）

在 DSH 设置 → 桌宠 →「请求批准的位置」选择：

• Web（默认）：在原生 Web 回答，桌宠保留状态提示。
• 桌宠：当前选中会话的受限批准与兼容问卷可直接在桌宠处理。问卷支持最多 8 题、每题最多 8 个选项、单选/多选和最多 1000 字的自定义回答；分页保留本次草稿，提交后等待 Host 确认。
• Web + 桌宠：两处同步显示，桌宠卡只读，最终在 Web 回答；可点击「打开 DSH」。本版本尚不支持两个界面同时抢答。

问卷只使用 DSH 正式提问接口的用户可见字段，内容和草稿不保存。超限、计划审阅或带扩展说明的题目保留在 Web；取消、会话切换、超时或 Helper 关闭会清理桌宠请求。协议为 v18，安装后需重启 DSH。

常驻极简对话（v0.3.0）

• 右键桌宠，勾选「对话框常驻」：立即显示半透明极简窗口，输入框始终可见，隐藏发送和附件按钮。再次双击桌宠会聚焦输入框。
• 收起时仅显示输入框，窗口高度随输入内容调整；点击窗口顶部横线才展开最近一条助手回复，再点击收起。展开高度为 520 DIP，上限为 560 DIP 且受屏幕工作区限制，长回复仍可用滚轮浏览。
• Enter 发送，Shift+Enter 换行，Esc 停止生成。Ctrl+V 可粘贴截图，显示可移除的附件标签；每次最多 4 个附件，单张 PNG 不超过 2 MB。普通文本粘贴与拖入附件仍可用。
• 取消勾选恢复完整对话列表和按钮，此时可点击 × 关闭对话。常驻选择仅在本次 Helper 运行期间有效。截图仅暂存内存，通过现有 DSH 图片附件能力发送。

当前公开安装入口指向 v0.3.0；安装后需要重启 DSH 才会加载新插件。

外置人物形象（v0.3.0）

右键桌宠 →「人物形象…」→「添加 GIF / PNG」或「添加角色目录」。预览后调整名称、头顶位置与脚底基线，点击「导入并使用」。已经导入的人物可即时切换、恢复默认或移除。

新增人物保存在 %LOCALAPPDATA%\DshPngPet\Characters，不进入插件包或 EXE；删除原素材、升级插件后仍可使用。GIF 导入时转换为本机 PNG 帧并保留逐帧时长。单个 GIF 在各状态共用，缺少状态动作时回退该人物待机，真实状态仍由气泡显示。导入素材不会自动抠图。

角色目录格式、限制及共享规则见 外置人物使用说明。

开发环境

• Node.js 22.19 或更新版本
• .NET 10 SDK
• DeepSeek Harness CLI（仅用于实际集成验证）

npm install
npm test
dotnet test pet-helper.Tests\PetHelper.Tests.csproj --no-restore
npm run build:helper
npm run test:package

构建结果位于 runtime/bin/win32-x64/pet-helper.exe，并以 .NET 自包含单文件形式发布。

一行安装到其他电脑

项目提供 scripts/install.ps1，自动准备兼容的 Node/DSH/pnpm、校验并安装预编译插件、创建稳定的桌面启动入口。接收者不需要安装 .NET SDK 或编译源码。

在 Windows PowerShell 中运行以下一行命令安装 v0.3.0：

& ([scriptblock]::Create((irm 'https://github.com/comfylies/dsh-png-pet/releases/download/v0.3.0/install.ps1')))

也可从 v0.3.0 Release 下载 install.ps1、release.json 和 .tgz，放在同一目录后运行下方本地安装命令。

开发者可生成本地发布目录：

npm run package:release

产物是 dist\packages 中的 install.ps1、release.json 和版本化 .tgz。将这三个文件交给接收者，在该目录运行一行：

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -Manifest .\release.json

发布脚本通过 -BaseUrl 生成带地址的在线入口。具体参数、重复安装、更新、卸载及发布操作见 一行安装与发布。首次使用仍需在 DSH 中配置用户自己的模型和工作区。

安装到 DSH Desktop

DSH Desktop 使用同一套 DSH Web 插件组合；插件清单保持 dsh.client.platform: "web"，不需要也不能改成 desktop。先启动一次 DSH Desktop 让它初始化 Desktop profile，然后完全退出 Desktop，再在 PowerShell 中执行：

$latest = Get-ChildItem .\dist\packages\dsh-png-pet-*.tgz | Sort-Object LastWriteTimeUtc -Descending | Select-Object -First 1
New-Item -ItemType Directory -Force C:\dsh-packages | Out-Null
Copy-Item -LiteralPath $latest.FullName -Destination C:\dsh-packages\dsh-png-pet-current.tgz -Force
& C:\Users\root\AppData\Roaming\npm\dsh.cmd plugin --profile desktop remove dsh-png-pet
& C:\Users\root\AppData\Roaming\npm\dsh.cmd plugin --profile desktop add C:\dsh-packages\dsh-png-pet-current.tgz
& C:\Users\root\AppData\Roaming\npm\dsh.cmd plugin --profile desktop list

重新打开 DSH Desktop 后，桌宠插件才会加载。安装器也支持 -Profile desktop；该模式只安装到 Desktop profile，不会尝试用 CLI 启动 Electron Desktop。

开发目录的旧启动入口

以下方式用于已有开发目录；一行安装器创建的 DSH Pet 快捷方式不依赖源码目录。

双击启动桌宠（Web profile）

安装并启用插件后，可以直接双击项目根目录的 启动 DSH 桌宠.vbs。它会隐藏控制台并启动 dsh web --no-open，因此不会自动打开浏览器；桌宠会在 DSH 完成插件加载后出现。

启动器优先使用全局安装的 DSH：

npm install -g @deepseek-ai/dsh

未检测到全局安装时，它会回退使用 npx -y @deepseek-ai/dsh。首次运行需要网络下载，日常使用仍建议全局安装以固定并加快启动。

如需在桌面创建一个真正的 Windows 快捷方式（.lnk），在项目根目录执行一次：

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\new-dsh-pet-shortcut.ps1

脚本默认创建 桌面\启动 DSH 桌宠.lnk，如果同名快捷方式已存在会停止而不会覆盖。该快捷方式只负责启动 DSH；请从 DSH 的退出操作退出 Host，桌宠会随之有序关闭。

动画资源

• 动作清单位于 pet-helper/Assets/pet-animations.json。
• 用户提供的透明 PNG 帧放入 pet-helper/Assets/Animations/<动作键>/，并在清单中按顺序引用；动作在对应状态持续时只在本地循环播放。
• 每个动作可有 1–64 张帧；帧间隔由 Helper 按 round(1000 / 帧数) 毫秒独立计算（8 张为 125 ms）。单帧动作静态显示，不需要用重复图片补足 8 张。
• 每个包含帧的 v3 Clip 必须声明 statusAnchor，例如 "statusAnchor": { "x": 0.5, "y": 0.12 }。x、y 是 0–1 的归一化坐标，表示该 Clip 统一画布中角色头顶的中点；状态气泡会以该点为基准显示在头顶上方。
• 所有帧应导出到相同尺寸的透明画布，并以脚底作为统一基线。statusAnchor 只按 Clip 的第一帧头顶测量一次，状态气泡在整段动画中固定不动，因此呼吸、眨眼和轻微上下浮动不会让气泡抖动。旧版 v1 清单继续以默认锚点兼容读取；新增坐姿、趴姿或跳跃 Clip 时，只需按首帧的头部位置调整 statusAnchor。
• 缺少动作素材时会回退到 idle；开启减少动态效果时固定显示动作的第一帧。
• 仓库当前仅包含默认 idle 素材，尚未提供其他动作帧。
• 添加 PNG 或修改清单后，运行 npm run build:helper 和 npm pack，重新安装生成的插件包并重启 DSH Harness；源资源不会动态部署到已运行的 Harness。

本机桌宠交互

直接运行 runtime/bin/win32-x64/pet-helper.exe 后：

• 按住角色左键拖动可移动位置；位置会在下次启动时恢复。
• 右键可选择 75%、100%、125% 或 150% 缩放，也可重置大小和位置。
• 在“设置 → 桌宠 → 趣味功能”可开启角色物理化。它采用固定标准重力；拖拽后松手可抛出角色，使用 0–100% 线性弹力滑块控制边界反弹。开启“减少动态效果”会暂停物理效果。
• 右键“隐藏”后，双击通知区域的 DSH PNG 桌宠 图标或选择“显示桌宠”可恢复。
• 右键“关闭桌宠”或托盘“退出桌宠”会彻底结束进程。
• 单击桌宠可输入消息并发送到“设置 → 桌宠”中选择的 DSH 会话；发送状态会显示在气泡中。
• 可在同一设置页开启回复预览，并将预览长度设置为 80–2000 个字符（默认关闭、480 字符）。

隐私边界

该插件不读取 API Key、不直接请求模型服务、不创建 HTTP 或 WebSocket 端口。桌宠输入与可选的模型回复预览仅经本地 stdin/stdout JSON Lines 暂存，不写入日志、文件或设置；预览只处理关联回合的普通文本增量。

协议 v18 的状态气泡只支持固定活动标签：思考中…、工作中…、思考中/工作中 和 输出中…；活动文本来自插件固定枚举映射，绝不来自 DSH 会话正文。仅 DSH 的用户可见文本块（text-delta 或 text）显示“输出中…”；思维链、工具块和未知形状仍显示“思考中…”。新的工具调用会立即切回工作状态。