Sh1wu0814/dsh-chat-background

dsh-chat-background

License: MIT
Platform

类 VSCode background 扩展的 DeepSeek Harness 客户端插件：把一张图片作为对话界面的背景，只在聊天视图显示。

Features

- 图片固定在对话区域内（不随消息滚动），位于聊天气泡/输入框之下，不挡交互。
- 只在聊天视图（chat tab）显示：切到 trajectory、空白欢迎页、设置等界面时自动隐藏。
- 会话页头提供一键开关（记忆在 localStorage）。
- 设置界面：设置 →「对话背景」，可视化修改图片路径 / 上传图片 / 透明度 / 模糊 / 缩放 / 位置 / 平铺，保存即生效。
- 支持远程 URL / data URI / 本地图片文件。
- 删除原图不影响使用：配置或上传的本地图片会自动缓存一份到 ~/.dsh/chat-background/assets，之后始终从缓存读取；极端情况下（缓存与原图都不存在）自动回退到默认渐变背景，不会显示破图。

Install

Clone this repository, then inject it into the DeepSeek Harness host（注入，免重启）:

dev_inject_plugin path/to/dsh-chat-background

Refresh the browser page to see the effect（刷新浏览器页面即可看到效果）。

Settings UI（设置界面）

打开应用左侧栏的 设置 →「对话背景」，即可可视化配置：

- 本地图片路径：直接粘贴路径，或点「选择文件…」上传（上传的图片由宿主保存到自己的缓存目录，原图删不删都不影响）。
- 图片 URL：远程图片地址，设置后优先于本地路径。
- 不透明度 / 模糊 / 缩放 / 位置 / 平铺：实时调参。
- 仅在对话视图显示 / 启用对话背景：行为开关。

点「保存设置」后立即生效（写入 sidecar 文件 ~/.dsh/chat-background.json，无需重启）。

Configuration

配置优先级：加载器配置（cordis.yml）  设置界面保存的就是 sidecar 文件；也可以手动编辑，改完刷新页面即生效，无需重启。本地图片在配置生效时会被宿主复制到 ~/.dsh/chat-background/assets/ 作为缓存快照，对外统一由 /chat-background/image 提供。

最简单的方式——直接写 sidecar 文件：

{
"imagePath": "D:\\Pictures\\wallpaper.png",
"opacity": 0.4,
"blur": 2,
"size": "cover",
"position": "center"
}

字段说明（全部可选）：

| 字段 | 默认 | 说明 |
| --- | --- | --- |
| imageUrl | "" | 远程图片 URL 或 data: URI（设置后优先于 imagePath） |
| imagePath | "" | 本地图片绝对路径（png/jpg/gif/webp/svg/avif/bmp…） |
| enabled | true | 总开关 |
| opacity | 0.45 | 图片不透明度 0–1 |
| blur | 0 | 高斯模糊半径（px），0 = 关闭 |
| size | "cover" | CSS background-size |
| position | "center" | CSS background-position |
| repeat | "no-repeat" | CSS background-repeat |
| showOnChatOnly | true | 仅对话视图显示；false 时轨迹等其他会话 tab 也会显示 |

加载器配置示例（~/.dsh/profiles/web/cordis.patch.yml）：

- insert:
- id: dsh-chat-background
name: dsh-chat-background
config:
imagePath: 'D:/Pictures/wallpaper.png'
opacity: 0.35

Uninstall

dev_uninject_plugin dsh-chat-background

Development

npm run build        # junction 依赖 + tsc(host) + tsdown(client)
npm run smoke-test   # 不依赖 DSH 运行时，直接驱动宿主路由（配置写入 / 快照 / 上传 / 404 回退）

宿主提供的 HTTP 接口：GET /chat-background/config（读配置）、POST /chat-background/config（保存配置）、POST /chat-background/upload（上传图片）、GET /chat-background/image（图片，优先从缓存快照读取）。

构建后 dev_reload_package dsh-chat-background 热重载。

License

MIT