dsh-bg-skin：DSH 界面背景皮肤插件

前言¶

DeepSeek Harness (DSH) 的核心架构基于插件化。对于习惯自定义界面风格的开发者或用户，默认的白色背景往往显得单调。dsh-bg-skin 插件旨在解决这一痛点，将 DSH 界面的白色背景替换为本地图片，并提供自动回退机制，确保在任何情况下界面都不会露白。

插件介绍¶

这是一个将 DSH 界面背景替换为图片的趣味换装插件。由 jinzhengen964-cmyk 维护。它提供了一张默认图片 (assets/ds.jpeg)，并允许通过配置覆盖，同时具备亮/暗模式底色兜底和 AI 输出卡片不透明等特性。

核心功能¶

• 默认皮肤：默认使用仓库自带的 assets/ds.jpeg，安装后无需配置即可生效。
• 覆盖与回退：支持在 cordis.patch.yml 中配置 imagePath。若配置的图片不存在或不可读，插件会自动回退到内置图片，保证界面可用。
• 布局与显示：图片按视口宽度的 50% 居中显示，且固定不随滚动。
• 可读性保障：AI 输出消息卡片设置为完全不透明，配合亮/暗模式底色兜底，确保文字在任何背景下清晰可见。
• 技术实现：纯 JavaScript 实现，零依赖，无构建步骤。图片实时读取，修改图片或路径无需重启 dsh web。

安装与启用¶

前置要求：已安装 DSH (dsh web)，环境需满足 Node.js ≥ 20。

执行以下命令安装：

dsh plugin --profile web add github:jinzhengen964-cmyk/dsh-bg-skin

安装完成后，重启 dsh web 并在浏览器中硬刷新（Ctrl+Shift+R）即可看到效果。

典型用法¶

1. 默认使用：安装后默认使用 assets/ds.jpeg，无需任何操作。
2. 自定义图片：在 ~/.dsh/profiles/web/cordis.patch.yml 中配置 imagePath。

    - id: bg-skin
      name: 'dsh-bg-skin'
      config:
        imagePath: 'C:/path/to/photo.jpg'

支持绝对路径，或相对于 `dsh web` 工作目录的相对路径。

3. 回退机制：删除配置的图片文件，或将其设置为不可读，插件会自动回退到默认皮肤。
4. 卸载：使用卸载命令移除插件。

dsh plugin --profile web remove dsh-bg-skin

注意事项¶

• 版本要求：Node.js ≥ 20。
• 包管理器：使用 pnpm 时，如果遇到构建脚本拦截，需在 ~/.dsh/profiles/web 目录下运行 pnpm approve-builds --all（本插件无原生依赖，通常无需此操作）。
• 开发调试：修改代码后需重启 dsh web 才能生效。
• 路径支持：配置图片路径时，支持相对路径。

结语¶

该插件通过极简的配置实现界面个性化，同时保证了系统的健壮性。如需查看更多细节或提交反馈，可访问其 GitHub 仓库或技能库目录页。

• GitHub: https://github.com/jinzhengen964-cmyk/dsh-bg-skin
• 目录页: https://www.skillhub.cn/plugins/jinzhengen964-cmyk/dsh-bg-skin