DSH 桌宠开发指南

DSH 桌宠开发指南：插件契约、隐私与素材授权

作者
DeepSeekAgent.io 编辑部
发布
更新

一个稳定的 DSH 桌宠至少包含四层：宿主事件适配、角色状态机、渲染与素材、本地设置。把它们分开，才能在 DSH 更新、换角色或增加 Live2D 时减少返工。

从最小状态机开始

先实现 idle、working、waiting、success 和 error，再按命令、搜索、编辑和测试细分姿态。连续 Tool Call 要做防抖，最终状态不能由页面文字猜测。桌宠异常时不得阻断 Agent 执行。

遵守宿主插件契约

声明准确的 engines.dsh，避免把第二套 DSH Runtime 安装进 Profile。客户端脚本应惰性初始化、可重复卸载，并通过只读资源路由加载素材。每次发布都在全新 Profile 和冷启动中验证。

隐私功能默认关闭

关键词感知、余额读取、天气、无障碍播报和语音都应是独立开关。基础状态联动无需读取聊天正文。余额功能通过本机代理返回最小数据，API Key 不进入前端。

分开标注代码与素材许可

README 需要分别说明代码、立绘、Live2D 模型、语音、音乐和字体的来源与许可。允许本地展示不等于允许重新打包或商用。插件市场页面也应展示这些字段，避免用户只看到一个笼统的 MIT 标签。

发布到桌宠市场需要哪些元数据

  • 插件名、作者、仓库与最新版本；
  • Desktop/Web 与 DSH 兼容范围；
  • 桌宠类型和功能标签；
  • 外网请求、聊天读取、余额读取说明；
  • 代码与各类素材许可证；
  • 安装、升级、卸载和数据迁移步骤；
  • 截图、资源占用和最近验证日期。

这些字段可以让市场真正支持比较与安全安装，而不只是展示漂亮预览图。

参考资料

常见问题

开发桌宠必须使用 Live2D 吗？

不需要。静态图序列更容易做到低资源占用和跨版本稳定。

插件市场可以只显示一个许可证吗？

只有代码和全部素材确实采用同一许可时才合适，否则应分项展示。

状态联动需要修改 DSH 源码吗？

优先使用插件事件和宿主结构化标记，避免直接修改内置包。