dsh-pet 配置生成器与故障排查
装了看不到、出现两只、黑底、消失回不来——按症状查解决方案。附在线配置生成器。
在线配置生成器
生成的是字段参考片段：先备份配置，再把字段合并到现有宠物对象中，保留其他字段和其他宠物，不要整份覆盖文件或 pets 数组。默认文件为 ~/.dsh/dsh-pet/main-config.jsonc；设置过 DSH_HOME 时以实际目录为准。详细步骤见配置说明。
选「两者」会让同一只宠物在网页和桌面各出现一次，看到两只别慌。
屏幕宽度的 15%–25% 比较合适。4K 屏可以往大调。
离屏幕边缘留多少空。
水平 24
垂直 10
碎碎念
桌宠会自己念叨，消耗 token
改完要验证。历史 #167 在 0.3.7 报告过保存失败，当前版本仍应核对实际值。
改完用 curl http://127.0.0.1:<端口>/dsh-pet-7340/config 确认一下，
401/403 请查访问鉴权，不能直接判断保存失败。或者编辑原文件对应字段后重启验证；上面的片段不能代替你的完整配置。
常见故障
装好了但桌面上不显示
网页里有、桌面没有？区分助手未启动、崩溃和窗口未显示。
出现两只大肥鱼
常见原因是 both 双端显示，也可能来自多个宿主实例。
设成「都不显示」后彻底消失
托盘和宠物一起没了，界面找不到入口。三种方法改回来。
这个站是什么
dsh-pet（大肥鱼桌宠）是 DeepSeek Harness 的桌面宠物插件，GitHub 上 官方仓库可查看项目与安装说明。
官方文档也涵盖配置与运行功能，本站集中整理装完之后： 桌面模式起不来、两只宠物、黑底、改完设置不生效。本站已核对 2026-11-03 资料快照中的 179 条 GitHub issue；历史反馈不代表当前版本仍有同样问题。
本站把它们按症状重新整理了一遍，每个页面写清三件事：你会看到什么 → 为什么 → 怎么修。
本站是第三方整理，与 dsh-pet 作者无关。内容来自官方 issue，如与最新版本不符，以官方文档为准。 发现问题或补充，欢迎去 官方仓库 反馈。