dsh-bg-skin

DSH (DeepSeek Harness) 背景皮肤插件：把 DSH 界面的白色背景替换为图片，图片半屏居中、只覆盖对话区域，AI 输出卡片保持不透明便于阅读。默认皮肤是随插件分发的 assets/ds.jpeg——安装即见，无需任何配置；可选 imagePath 换成你自己的图，删除图片后自动回退默认皮肤，插件始终可用。

功能

• 🖼️ 默认使用随插件分发的 assets/ds.jpeg（仓库自带，安装即见）
• 🛟 无绝对路径依赖：可选的 imagePath 覆盖配置；配置的图片被删除/不可读时，自动回退到内置 ds.jpeg，DSH 不受影响
• 📐 图片按视口宽度 50% 居中显示，固定不随滚动
• 💬 AI 输出消息卡片完全不透明（--dsw-alias-bg-layer-1/2 alpha=1），文字清晰可读
• 🌗 亮 / 暗模式各有底色兜底（图片之外的区域不会露白）
• 📦 纯 JS、零依赖、无构建步骤；图片每次请求实时读取，替换图片无需重启

安装

前置：已装好 DSH（dsh web 能正常运行），Node.js ≥ 20。

方式一：git 通道（官方 CLI）

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

装完重启 dsh web 并硬刷新浏览器（Ctrl+Shift+R）。

如果 dsh 不在 PATH：npx -y --package @deepseek-ai/dsh dsh plugin --profile web add github:jinzhengen964-cmyk/dsh-bg-skin

pnpm 若拦截构建脚本，在 ~/.dsh/profiles/web 下运行 pnpm approve-builds --all（本插件无原生依赖，一般无需）。

方式二：源码 link（本地开发）

1. git clone https://github.com/jinzhengen964-cmyk/dsh-bg-skin.git
2. ~/.dsh/profiles/web/package.json 的 dependencies 写 "dsh-bg-skin": "link:<克隆目录绝对路径>"
3. 把 "dsh-bg-skin" 追加到 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles
4. 在 ~/.dsh/profiles/web 执行 pnpm install
5. 重启 dsh web + 硬刷新

换自己的图（可选）

默认不需要任何配置——安装后看到的就是随插件分发的 assets/ds.jpeg。

想换成自己的图片时，在 web profile 的 cordis.patch.yml（~/.dsh/profiles/web/cordis.patch.yml）给 bg-skin 条目加 config.imagePath（绝对路径，或相对 dsh web 工作目录的相对路径）：

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

• 配置的图片不存在/不可读 → 自动回退到内置 assets/ds.jpeg，插件与 DSH 正常运行
• 换图：直接覆盖该文件即可（每次请求实时读取，无需重启）；改路径后重启 dsh web 生效

自定义代码

想改什么	改哪里
默认皮肤图片	替换 assets/ds.jpeg（或改 lib/index.js 的 BUNDLED_IMAGE_PATH）
图片大小 / 位置	lib/client.js 的 background-size / background-position（当前 50% auto 居中）
面板透明度 / AI 输出	lib/client.js 的 theme.overrideTokens 取值
最终兜底（内置图也失效时）	lib/index.js 的 FALLBACK_SVG（任意 SVG）
路由路径	lib/index.js 的 ROUTE_PATH（与 lib/client.js 的 IMAGE_URL 保持一致）

改完重启 dsh web 生效（仅 client 改动时也可只硬刷新）。

卸载

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

或从 ~/.dsh/profiles/web/package.json 删除依赖与 bundle 条目后 pnpm install。

License

MIT