DSH 桌面客户端装桌宠：插件、Electron 桌面形态与「怎么冒出两只」的排查

本文实测环境Windows DeepSeek Harness 官方桌面客户端Electron。文中的用户目录统一写成%USERPROFILE%、%LOCALAPPDATA%本地监听端口写成端口属于脱敏写法。插件本身是公开包dsh-pet仓库见文末。起因看上了一个 DSH 桌宠插件一只 Q 版小人平时在屏幕上自己走动、点一下有反应、能拖起来扔出去还会显示余额、在你干活的时候跟着切状态。装的过程本身不复杂一条命令。但装完遇到了一个很典型的困惑——屏幕上出现了两只一模一样的宠物。我要的是住在桌面上的那只不想要网页里那只。这篇按时间顺序记两件事一是这个插件完整的安装路径它和普通插件不太一样会额外拉一个 Electron 运行时二是那两只到底是怎么来的、怎么一眼分清哪只是哪只。第一步先确认你在哪个 profile 里装DSH 的插件按 profile 隔离。桌面客户端读的是desktop命令行dsh web读的是web两边互不相通。装错房间的现象是命令成功、日志干净、界面上什么都没有。先问环境变量不用猜Get-ChildItem env: | Where-Object Name -like DSH_*关键的三项DSH_HOME %USERPROFILE%\.dsh DSH_PROFILE desktop DSH_PROFILE_DIR %USERPROFILE%\.dsh\profiles\desktopDSH_PROFILEdesktop就是答案。插件的 README 写的是「照你实际在用的那个填」所以这里必须填desktop不能照抄 README 示例里的web。另外通用的dsh命令按设计不接管desktopprofile——这台机器上实测会直接拒绝。要操作它得用桌面客户端随包自带的那个 CLI$dsh $env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd记住这个变量后面安装和卸载都用它。第二步安装以及那个 347 MB 的附加动作 $dsh plugin --profile desktop add dsh-pet这就是一次普通的 pnpm 安装不用手工改任何配置文件。装完 profile 的package.json里依赖和插件清单都自动写好了{ dependencies: { dsh-pet: ^0.3.6 }, dsh: { profile: { bundles: [ deepseek-ai/dsh-base, deepseek-ai/dsh-web-app, dshmarket, dsh-pet ] } } }这个插件特殊的地方在于它有「桌面形态」。一般插件分宿主半区和客户端半区两半这个插件多了一半它可以把宠物画在一个脱离浏览器的独立透明窗口里。代价是要有 Electron 运行时。首次拉起桌面形态时插件会自己探测本机有没有可用的 Electron找不到就走官方electron/get下载一份%USERPROFILE%\.dsh\electron\ # 运行时落地目录本次实测 347 MB %LOCALAPPDATA%\electron\Cache\ # 安装包下载缓存本次实测 495 MB两个数字放这儿是让你对装个小桌宠的空间成本有个预期。下载是后台进行的Electron 不可用时插件只打日志告警不影响浏览器里的形态。第三步display决定宠物住在哪装完第一件事是配display。这是每只宠物的必填字段四个值值含义web只住在浏览器页面里overlaydesktop只住在桌面独立小窗里both两个都显示none都不显示包内默认配置给的是both。这就是「两只」的来源。一份宠物定义、两个渲染外壳浏览器半区把宠物画在页面 DOM 里定位是页面坐标 角落 边距桌面半区为每只宠物各开一个独立透明窗口窗口跟随宠物移动。两个外壳共用同一份配置和同一套行为所以两只长得一模一样、动作也同步——看起来特别像配置写重了其实配置里就一只。改配置有两条路生效时机完全不同这是这次真正踩到的坑在 DSH 设置页「桌宠配置」里改点保存。保存会写用户配置并让宿主重启桌面窗口网页端也会重新拉一次配置——即时生效。直接编辑配置文件%USERPROFILE%\.dsh\dsh-pet\main-config.jsonc。这个文件是用户覆盖层优先于包内默认。但网页端只在页面加载时读一次配置没有变更推送你把both改成desktop存盘桌面那只照旧网页里那只也不会自己消失。我走的是第 2 条路于是遇到了标题里那个场景。修法很简单二选一刷新一下 DSH 页面CtrlR——页面重新拉配置overlay 那只消失只剩桌面那只或者打开设置页点一次保存。刷新只重载界面不会丢当前会话。以后凡是手改配置文件都记得补这一步。第四步怎么一眼分清哪只是桌面、哪只是网页这才是这次最值得记下来的部分。两只摆在一起光看长相完全分不出来——同一份素材、同一套动画。可靠的判据是它们各自属于哪个进程、占据哪块屏幕区域。第一步列出有窗口的进程Get-Process | Where-Object { $_.MainWindowTitle -ne } | Select-Object ProcessName, Id, MainWindowTitle输出里会同时出现桌面客户端和桌宠的 Electron 助手窗口标题写得很直白ProcessName Id MainWindowTitle DeepSeek Harness 22452 ... — DeepSeek Harness electron 13892 dsh-pet 桌宠桌面模式那个electron进程就是桌面形态的载体。它的命令行也可以直接看(Get-CimInstance Win32_Process -Filter Nameelectron.exe).CommandLine...\electron.exe ...\dsh-pet\runtime\electron-helper\main.js第二步拿到桌面窗口的矩形。下面这段枚举可见顶层窗口并输出进程、尺寸、位置Add-Type -AssemblyName System.Windows.Forms Add-Type -TypeDefinition using System; using System.Text; using System.Runtime.InteropServices; public class Win { [DllImport(user32.dll)] public static extern bool EnumWindows(Cb cb, IntPtr l); [DllImport(user32.dll)] public static extern bool IsWindowVisible(IntPtr h); [DllImport(user32.dll)] public static extern uint GetWindowThreadProcessId(IntPtr h, out uint pid); [DllImport(user32.dll)] public static extern bool GetWindowRect(IntPtr h, out R r); [StructLayout(LayoutKind.Sequential)] public struct R { public int L, T, Rr, B; } public delegate bool Cb(IntPtr h, IntPtr l); public static System.Collections.Generic.Liststring List() { var o new System.Collections.Generic.Liststring(); EnumWindows((h, l) { if (!IsWindowVisible(h)) return true; uint pid; GetWindowThreadProcessId(h, out pid); R r; GetWindowRect(h, out r); o.Add(pid (r.Rr - r.L) x (r.B - r.T) r.L , r.T); return true; }, IntPtr.Zero); return o; } } [Win]::List()我这台机器上桌宠那个进程的窗口是924x744 1967,147。这个数字能反推而且推得很干净。插件给每只宠物开的窗口尺寸是宠物包围盒 四周外扩半个身位宠物宽size、高size × 9/16外扩round(size × 0.5)。我的配置里size 462宽 462 231×2 924 高 round(259.9 21.7) 462 744一字不差。窗口尺寸算得出来就说明这只确实是桌面形态按配置生成的。第三步用位置对齐。两只宠物在屏幕上的纵坐标大致是桌面窗口内容区147 231 378起到147 744 - 231 660止网页 overlay配置里marginY: 100落在视口顶部约100 ~ 360区间。对照截图下方那只y ≈ 519落在桌面窗口的内容区里上方那只y ≈ 250落在网页 overlay 的位置上。下方 桌面宠物上方 网页残留。把这套流程抽出来就是一句可复用的话配置里只写了一只宠物屏幕上出现两只时不要怀疑配置写重了先按进程和窗口矩形把两只归位。第五步卸载与清理 $dsh plugin --profile desktop remove dsh-pet插件的用户数据不随卸载删除需要的话自己清路径作用%USERPROFILE%\.dsh\dsh-pet\用户配置main-config.jsonc、对话记忆、自定义动画和表情包%USERPROFILE%\.dsh\electron\桌面形态用的 Electron 运行时体积最大%APPDATA%\dsh-pet-electron-helper\桌面窗口缓存与主屏缩放缓存可删会自动重建三个都能删也都不会再影响浏览器里的形态。这次得到的两条经验一、装带桌面形态的插件先想清楚住在哪。display这个字段值四个默认both网页和桌面各画一只。装完第一件事就该核对它而不是等看到两只再回头找原因。二、配置文件和设置页是两条不同的生效路径。设置页保存会带动宿主重启窗口 前端重载直接改配置文件只覆盖数据不会触发任何重载。凡是手改配置都要补一次刷新或保存。文中结论的状态说明已验证desktopprofile 的安装命令可正常执行并自动写入依赖与dsh.profile.bundles桌面形态首次运行会自动下载 Electron 运行时到%USERPROFILE%\.dsh\electron\桌面窗口尺寸与配置中的size按包围盒 半身位外扩公式严格吻合display从both改为desktop后刷新页面网页 overlay 消失且桌面宠物不受影响。已验证本机实测通用dsh命令不接管desktopprofile——这类 profile 由客户端独占管理需使用随包 CLI。未验证其他 DSH 版本与插件版本的 profile 行为是否完全一致插件长期稳定性以上步骤在 macOS / Linux 下的等价路径本文只覆盖 WindowsmacOS 播放透明视频还需要改用.mov素材。待长期观察桌面形态与浏览器形态共用一份窗口缓存目录同时开启时可能互相影响插件自身只告警。关联本文涉及的插件为公开包dsh-petnpm仓库见 GitHub - PC2005-cloud/dsh-pet: DSH 桌面宠物一行命令装好即用的透明动画小桌宠支持多开、大小位置随心配置还内置 DIY 素材链能用 AI 视频自造专属宠物 · GitHub。