wangxilhy23/dsh-wx-skin 预览 preview

wangxilhy23/dsh-wx-skin

DeepSeek Harness(DSH)Web GUI 皮肤插件 —— 在 设置 → 皮肤 里指定图片文件夹或本地图片作为全屏磨砂背景,支持暗化、模糊与透出调节,明暗主题自动适配,跨刷新持久化。

catalog descriptioncatalog 简介 / catalog description:deepseek harness 皮肤插件。支持选择本地目录下的图片作为背景设置

Project Overview项目介绍

This is a skin theme plugin built exclusively for the DeepSeek Harness (DSH) web GUI. It adds two dedicated entries to the DSH sidebar: one for opening the skin settings panel, and another for quickly switching to the next background image without opening the panel. Users can select local bitmap images, paste a direct image URL, load a local folder of images for rotation, or pick from six built-in gradient presets. To install the plugin from npm, run the command dsh plugin --profile web add dsh-wx-skin in your DSH source checkout directory, then restart the dsh web server to activate it.

It is designed for any DSH user who wants to customize the visual look of their web-based DSH interface. After installation and a server restart, you will see the new sidebar entries, so you can click the skin entry to open the settings panel, select your preferred background source, and adjust the effect sliders in real time to get the look you want. If you set up a local folder rotation, you can choose between sequential, random, and no-repeat-in-round shuffle modes, and switch backgrounds with one click directly from the sidebar without opening the full settings panel every time.

This plugin is released under the full open-source MIT license, and it is free to use, modify, and distribute. It only works with DSH web profile installations, and it is officially compatible with DSH version 0.1.6-alpha.1 and newer. It has a few usage limits: folder rotation caps out at 2000 cached images per scan, and only supports bitmap formats like PNG, JPEG, and WebP, with no support for SVG or other vector images. All changes to host-side code require a full restart of the dsh web server to take effect.

这是一款专门为 DeepSeek Harness(DSH)Web 版打造的原生皮肤插件,可在侧栏新增「皮肤设置」和「一键换图」两个入口,支持用户自选本地图片、图片URL或本地文件夹作为全屏磨砂背景,自带六款预设渐变皮肤,还提供暗化、模糊、透出三个效果调节滑杆,自动适配DSH自带的明暗主题,所有设置都会跨刷新、重启持久保存。

这款插件面向想要自定义DSH Web界面视觉效果的用户,常规使用流程为安装完成并重启DSH后,点击侧栏「皮肤」入口打开设置面板,先选择背景来源类型,再挑选对应资源,拖动滑杆实时调整效果后即可生效。若启用本地文件夹轮播,还可设置多种切换模式,不用打开面板就能一键切换下一张背景,适合喜欢定期更换界面壁纸的用户。

本插件采用MIT许可证开源免费使用,仅支持DSH Web端,适配版本为DSH 0.1.6-alpha.1及以上,依赖DSH的插件加载机制与DOM结构。单次文件夹扫描最多缓存2000张图片,仅支持位图格式,不支持SVG等矢量图,安装后需要重启DSH Web才能生效,修改宿主端代码后也需要重启服务。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

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

CLI Install命令行安装

dsh plugin --profile web add dsh-wx-skin@0.2.1

把 wangxilhy23/dsh-wx-skin 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

🎨 dsh-wx-skin

DeepSeek Harness(DSH)Web GUI 皮肤插件 —— 在 设置 → 皮肤 里指定图片文件夹或本地图片作为全屏磨砂背景,支持暗化、模糊与透出调节,明暗主题自动适配,跨刷新持久化。

MIT License npm version

效果预览

上图为本插件实际效果演示(深蓝渐变壁纸透过半透明表面)。assets/demo.html 是自包含的演示源,可直接用浏览器打开预览。


✨ 功能特性

  • 设置里的「皮肤」页:所有皮肤设置挂进 harness 自带设置面板的官方加法页位 settings.section——点侧栏 ⚙ 设置,左栏多出「皮肤」一项,内容列按设置面板既有的内边距与滚动渲染,不再有会超出窗口的浮层。
  • 侧栏底部换图快捷键:「上一张」「下一张」以一次注册挂进官方 sidebar.footer.action 插槽(设置行上方),不打开设置也能一键换图;侧栏收成 56px 图标轨时自动变成两个图标按钮。
  • 两行路径,一个模型:设置页只有「文件夹」和「本地文件」两行,不再有「背景来源」下拉框。
    • 文件夹:当前文件夹的路径(可用 harness 宿主目录选择器,也可手填绝对路径)。
    • 本地文件:当前背景图片的完整路径;背景来自 URL 时这里显示 URL;用浏览器文件对话框选图且浏览器不给目录时显示文件名并给出提示。
    • 选文件自动带出文件夹:在「本地文件」行粘贴一个图片绝对路径并点「应用」,插件读盘扫描它所在的文件夹,把该文件设为当前背景,并按目录顺序从它继续切换。
    • 对话框选图也会接上文件夹:浏览器文件对话框不给目录,但只要已加载的文件夹里恰有一张同名图片,点「应用」时就会定位到它——背景变成那张、完整路径显示在「本地文件」行、「下一张 / 上一张」从它继续(选 bg129,下一张就是 bg130)。同名图片不止一张(递归扫到的不同子文件夹)时不做猜测,退回编码图并给出提示。
    • 选文件夹自动带出文件:加载文件夹后,当前那张的完整路径会显示在「本地文件」行。
  • 本地图片:浏览器原生文件对话框选择 PNG / JPEG / WebP / GIF / BMP,不限文件大小;按显示需要编码(≤4096px 保持原始分辨率,更大的自动缩放以保证浏览器可绘制、可持久化),选中后点「应用」生效。⚠️ 浏览器(含 Electron 43)的文件对话框不提供目录,所以这条路本身拿不到路径;文件夹已加载时按上面的「同名匹配」接上轮播,否则可把完整路径粘到「本地文件」行。
  • 图片 URL:在「本地文件」行粘贴 http(s):// 图片地址再点「应用」,即按 URL 作为背景(该行同时就是当前图片路径 / URL 的显示位)。
  • 文件夹轮播:指定一个本地文件夹(可调用 harness 的宿主目录选择器,也可手填绝对路径),插件读盘列出其中所有图片并缓存路径;「下一张」按你选的模式换图:
    • 顺序:按文件名自然排序(数值感知,img2 在 img10 之前)逐张推进,两端回绕——选到第 10 张,「下一张」就是第 11 张,「上一张」就是第 9 张;
    • 随机:从未切换的图片里等概率抽取;
    • 随机模式一轮内不重复:已切换过的图片会被记录,只有本轮图片全部切过之后才重置队列;重置后的第一张不会与当前这张重复(只有一张时除外)。顺序模式按目录顺序走,天然不会在回绕前重复。
    • 可选「包含子文件夹」;单次最多缓存 2000 张、遍历 20000 项、递归深度 6,达上限时设置页会提示已截断。
    • 上一张:顺序模式回到目录里的上一张(首张回绕到末张),随机模式回到上一次显示过的那张;无路可退时按钮与侧栏快捷键置灰。
    • 自动同步:回到页面/切回标签页、每 60 秒、以及打开设置页时都会重新读盘扫描该文件夹;新增的图片进入列表,当前图片不会被重置;已删除的图片会被移出(当前那张被删时按原序号就近落位)。
  • 背景预览:设置页顶部一块大预览(height: min(36vh, 340px) + background-size: contain),完整显示当前背景整张图(不裁切,两边留白),背景未启用时显示「未启用」。
  • 当前图片名称:设置页在「当前:」下方显示正在使用的图片名称——文件夹显示当前那张的文件名、本地图片显示所选文件名、URL 显示路径末段(如 photo.jpg);过长自动省略,悬停可看到完整路径 / URL;未启用或没有背景时不显示这一行。侧栏「下一张」快捷键的悬停提示也带上当前名称。
  • 适合度:背景图如何铺满窗口,和 Windows 壁纸的「选择适合度」同款语义:
    • 填充(默认):铺满窗口,超出的裁掉;
    • 适应:完整显示整张图,按比例缩放并留白;
    • 拉伸:拉满窗口,比例可能变形;
    • 平铺:按图片原始尺寸重复铺满;
    • 居中:按原始尺寸居中,四周留白。 (Windows 还多一个「跨区」,那是多显示器概念——浏览器只有一个视口,因此不提供。)
  • 效果调节:
    • 暗化 0–80%(黑色遮罩,保证文字可读);
    • 模糊 0–24px(背景毛玻璃);
    • 透出 0–100%(表面不透明度,越低背景越明显,默认 72%;可读性由「暗化」配合)。
  • 启用开关 + 恢复默认,一键关闭皮肤。
  • 持久化:设置同时存于 localStorage 与宿主副本 ~/.dsh/dsh-wx-skin.settings.json,刷新、重启、桌面端换端口后均自动恢复;文件夹轮播的图片列表、当前序号、本轮已用记录同样持久化(只存路径,不存图片本体,不占 localStorage 配额)。
  • 明暗主题适配:随 body[data-ds-dark-theme] 自动切换两套半透明配色;设置页自身也跟随明暗主题(暗色模式为深色控件 + 浅色文字),color-scheme 让页内的勾选框、滑杆、滚动条与页面同色系。
  • 参与 harness 生命周期:浏览器半区通过 ctx.effect 注册挂载,设置页与侧栏入口都通过官方插槽注册;client-hmr 重载或插件行停用时会被完整卸载(插槽注册、背景层、样式表全部移除,不残留、不重复)。
  • 完全独立:纯浏览器端 client 插件,不修改 DSH 仓库,不影响主界面与其它插件。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-usage-stats 下一个 Next seeker-craft →