前言¶

DeepSeek Harness (DSH) 为智能体开发者提供了强大的环境支持，但默认界面较为单一。开发者往往希望为 Agent 赋予更具个性的视觉呈现。Background Studio 旨在解决这一问题，为 DSH 提供一套完整的自定义背景与动态壁纸系统，从简单的图片替换到复杂的 Wallpaper Engine 集成，均可实现。

它是什么¶

这是一个由 Antiboday 维护的 DSH 插件，核心价值是将动态壁纸引擎引入 DeepSeek Harness。插件遵循 MIT 许可证，通过插件目录和 GitHub 仓库发布。它不仅允许用户修改应用背景，还支持导入 Wallpaper Engine 内容，并提供音频可视化功能。

核心功能¶

该插件提供以下能力：

• 自定义背景与动态壁纸引擎：支持多种壁纸格式和渲染方式。
• Turn-navigator 音乐波形：当 DSH 播放音效或通知时，聊天侧边的导航条会随音频跳动。
• 四种背景模式：支持图片、透明、毛玻璃和动画四种模式，每种模式均可独立配置。
• Wallpaper Engine 工作坊导入：支持直接扫描 Steam Workshop 内容文件夹，一键转换壁纸。
• 主题氛围提示：当壁纸与系统主题色冲突时，插件会提供调整建议。
• 全国际化支持：界面语言跟随 DSH 系统设置。
• 隐私设计：所有路由被回环围栏限制，活动桥仅读取回合元数据。

安装与启用¶

推荐使用 GitHub 标签安装。在 DSH 中执行以下命令：

github:antiboday/dsh-plugin-bg-studio#v0.4.2

如果命令行安装失败（提示供应链冷却期相关错误），建议下载官方发布的 .tgz 压缩包，然后在 DSH 的“插件”菜单中选择“从本地包安装”，并指定压缩包的绝对路径。

典型用法¶

开发者可以通过创建壁纸 Bundle 来扩展功能。

编写壁纸 Bundle¶

创建一个目录，并在其中放入 manifest.json 和相应的资源文件。

manifest.json 示例：

{
  "format": "dsh-wallpaper/1",
  "name": "My Wallpaper",
  "description": "…",
  "author": "you",
  "type": "video",            // video | web | canvas | character
  "entry": "bg.mp4",          // video: file · web: html file · canvas: "scene:nebula"
  "tone": "dark",             // optional: dark | light
  "states": {                 // character only
    "idle": ["nap", "wag"],
    "busy": ["type"]
  }
}

Web 壁纸交互¶

网页壁纸可以通过 window 消息接收 Agent 活动状态。代码示例：

window.addEventListener('message', (ev) => {
  const d = ev.data
  if (d?.source === 'dsh-bg-studio' && d?.type === 'activity') {
    // d.state: 'idle' | 'busy' | 'overloaded'
  }
})

角色 Bundle¶

对于角色动画，需要配置 mascot.json 定义精灵图帧，并将其与任务状态机（idle, busy, overloaded）关联。

注意事项¶

• 隐私与权限：插件运行在 DSH 进程权限下，所有路由被回环围栏限制，活动桥仅读取回合元数据，不涉及会话内容。
• Turn-navigator 依赖：音乐波形功能需要 DSH 0.2.0-rc 及以上版本。
• 更新生效：修改配置或更新插件后，若行为未变更，需完全退出 DSH（包括系统托盘）并重启。
• 供应链冷却期：若安装失败提示 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION，可能是由于依赖包发布未满 24 小时，建议等待冷却期过后重试。

结语¶

Background Studio 为 DSH 提供了从静态背景到动态壁纸的完整视觉定制方案。无论是简单的图片替换，还是复杂的 Wallpaper Engine 集成，该插件都能显著提升 Agent 的个性化体验。更多详情请参考插件目录页或 GitHub 仓库。