Jonah-Wu23/dsh-bg-carousel

Name: Jonah-Wu23/dsh-bg-carousel
Author: Jonah-Wu23

插件Plugin 原生Native ⭐ 2 MIT

DeepSeek Harness 背景轮播插件：把工作区 backgrounds 目录的图片设为背景并自动轮播 (MIT)

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-bg-carousel 是 DSH 混合型背景轮播插件，自动扫描工作区 backgrounds 目录的 jpg、png、webp、gif、bmp、svg 图片，通过侧边栏面板提供缩略图预览、点击切换、自动轮播及 2–120 秒间隔设置；背景经宿主 API 以 base64 下发并用 body::before 全屏渲染。适合想为工作区添加可轮换背景图时使用。注意单张图片限制 12 MiB，安装需 pnpm 且重启后生效。

dsh-bg-carousel is a hybrid DSH plugin that turns images in the workspace backgrounds directory into full-screen backgrounds. It scans jpg, png, webp, gif, bmp, and svg files, serves them through a host JSON API as base64 data URLs, and adds a sidebar panel for thumbnail preview, manual switching, auto-carousel, and 2–120 second interval settings. Use it when you want rotating workspace backgrounds. Note: images are limited to 12 MiB, and installation requires pnpm plus a restart.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-bg-carousel】【https://github.com/Jonah-Wu23/dsh-bg-carousel】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin add github:Jonah-Wu23/dsh-bg-carousel

把 Jonah-Wu23/dsh-bg-carousel 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

2.5 KB · 缓存于 2026-08-27 05:41:53 · 2.5 KB

dsh-bg-carousel

DeepSeek Harness 背景轮播插件（标准 dsh bundle）：把工作区 backgrounds 目录里的图片作为背景，自动轮播。

混合型插件（hybrid）：宿主端提供 /dsh-bg/api JSON API，客户端在侧边栏底部注册「🖼 背景」入口，打开控制面板。

功能

自动扫描 {workspaceRoot}/backgrounds（或 {workspaceRoot}/workspace/backgrounds）目录下的图片（jpg / png / webp / gif / bmp / svg）
侧边栏「🖼 背景」按钮打开面板：缩略图预览、点击切换、自动轮播开关、轮播间隔设置（2–120 秒）
背景以 CSS body::before 全屏覆盖方式渲染，半透明遮罩保证界面可读性
图片经宿主 API 以 base64 data URL 下发，无需额外静态资源路由

安装（标准 bundle，一键 `dsh plugin add`）

本插件是标准 dsh bundle（package.json 声明 dsh.bundle.patch），安装后由 profile 自动归入 bundle 层，无需任何手动注入。

方式一：GitHub Release tgz（推荐）

dsh plugin add https://github.com/Jonah-Wu23/dsh-bg-carousel/releases/download/v0.1.0/dsh-bg-carousel-0.1.0.tgz

方式二：git 源

dsh plugin add github:Jonah-Wu23/dsh-bg-carousel

方式三：本地目录 / tgz

dsh plugin add ./dsh-bg-carousel-0.1.0.tgz
# 或
dsh plugin add /path/to/dsh-bg-carousel

dsh plugin add 需要 pnpm 在 PATH 中。安装后重启 dsh 即生效；dsh plugin rm @dsh-external/dsh-bg-carousel 可卸载。

使用

把图片复制到工作区的 backgrounds 目录
在侧边栏底部点击「🖼 背景」打开面板
点「刷新」加载图片；点击缩略图切换背景，勾选「自动轮播」并按设定间隔循环

API

宿主在 {workspaceRoot} 下挂载 prefix /dsh-bg/api：

方法	路径	说明
GET	`/list`	返回图片列表与当前设置
POST	`/image`	按文件名返回 base64 data URL（限制 12 MiB）
POST	`/settings`	更新轮播间隔（1500–120000 ms）与开关

发布与构建

打 tag v* 自动触发 GitHub Actions 构建 dsh-bg-carousel-<version>.tgz 并附加到 Release（见 .github/workflows/release.yml）
手动构建：npm pack（files 已包含 lib/、cordis.patch.yml、README、LICENSE）
本地重编源码：DSH_CHECKOUT=<dsh 源码 checkout> bash scripts/build.sh（依赖 dsh 仓库内的 tsc 与类型包；仓库内置 lib/ 为已构建产物，可直接使用）

License

MIT

渲染基于仓库 Jonah-Wu23/dsh-bg-carousel 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install