第二,余额功能是可选的、且只覆盖三家。 如果目标只是"看得到宠物",一笔 API key 都不用配。配了但服务商未登记余额接口时,插件不播档位动画,改为弹文字说明(第二行报 provider id)。所以出网策略可以按"是否启用余额"分成两档,没必要一上来全开。
三、凭据与配置的权限收口
这是 ECS 上最容易被忽略、后果最重的一块。README 里有几处必须知道的事实:
配置里有对话记忆。 对话的记忆持久化在 $DSH_HOME/dsh-pet/memory.json,浏览器与桌面共享同一份。这意味着这个目录的内容属于用户数据,备份与权限都要按数据处理。
配置文件格式错误不会静默。 校验在插件加载时执行——格式错误会在 DSH 控制台显式报错,不会静默运行残缺配置。这条对运维是好事:坏配置会立刻暴露,而不是带着错误跑。
覆盖语义是整体替换。 用户层配置 $DSH_HOME/dsh-pet/main-config.jsonc 给出某个字段就整体替换该字段(例如写了 animations 就用你的整份动画池),没写的字段回落包内默认。做配置版本化管理时要注意这一点——不能靠"只写差量"来控制。
接口只监听本机、无鉴权。 对外接口前缀 /dsh-pet-7340,只监听本机、无鉴权。README 对这个取舍的理由是方便其他插件驱动桌宠。从权限角度必须理解为:它的信任边界就是本机。因此:
- 安全组里不要为这个前缀开放入方向。
- 需要远程访问 DSH Web 时用 SSH 隧道:
- 如果 ECS 上有其他低权限用户或不受信任进程,要意识到它们同样能调到这套接口。
凭据方面,余额功能用的三个 key 建议走 DSH 凭据机制配置,而不要写进配置文件或用环境变量散落。这样升级与迁移时凭据面是单一的。
四、部署流程(可交接版)
把前面几条收成一个可交接的顺序:
四条要注意的边界:--profile 填 web;装完必须重启进程;headless 下没有桌面小窗是正常行为;不要在安全组开放 /dsh-pet-7340 对应端口。
五、备份与迁移
因为对话记忆与配置都在 $DSH_HOME/dsh-pet/ 下,节点迁移或重建时,这一目录是唯一需要带走的数据:备份整个 $DSH_HOME/dsh-pet/(含 main-config.jsonc 与 memory.json)。不必备份 ~/.dsh/electron/(可按平台重新探测下载)与源码安装的 lib/ 构建产物(npm run build 可重建,且 README 提醒必须跑 prepare.js 而不是裸 tsdown)。
最后一条许可提醒:代码是 MIT,但素材(动画 / 提示词 / 源视频)允许开源使用、禁止商用,且二创衍生作品须附原作者 GitHub 地址。面向客户的环境要提前确认,不要默认"开源就是随便用"。
总结
ECS 上部署桌宠的实践可以压成三句:规格不用加(低占用,把预算给出网与磁盘)、出网按需开(headless 用不到 Electron,余额只覆盖三家)、权限收口在本机(/dsh-pet-7340 只监听本机、无鉴权,用 SSH 隧道而不是开放安全组)。同类插件的中文清单与安装形态见 DeepSeek Harness Hub 插件清单。
适合与不适合
适合:要把 DSH 环境做成可交接资产的运维与平台工程师;需要给云上部署写内部规范的团队;关心凭据与用户数据落盘位置的安全实践者;准备把 DSH 环境从本地迁到云上的开发者。
不适合:只想快速看个效果、不打算管权限边界的用户;需要桌面透明小窗的场景(headless 做不到);以及打算把桌宠素材用于商业产品的团队——素材许可明确禁止商用。
标签:dsh-pet、DeepSeek Harness、阿里云、最佳实践、权限收口
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。