dsh-plugin-wallpaper-cleanup
IdentifiedCleans a Wallpaper Engine workshop folder against a screenshot of your subscriptions: it finds the blue check badges, OCRs the tile titles, matches them to each project.json title, and moves non-subsc
dsh-plugin-wallpaper-cleanup
Wallpaper Engine 工坊清理插件。你选择 Steam 工坊内容文件夹 和 “我的订阅壁纸”截图(可多张,分页时一次选全),插件找出不属于你的壁纸文件夹,并把它们移入 Windows 回收站(可恢复)。
带图形界面:设置 → 壁纸清理,或右下角悬浮按钮。也保留两个 agent 工具,供对话里直接调用。
不依赖任何第三方 npm 包:截图识别用 Windows 自带的 Windows.Media.Ocr,回收站用 Microsoft.VisualBasic.FileIO,文件夹选择用系统原生对话框,全部通过随包携带的 PowerShell 脚本完成。因此只支持 Windows。
图形界面(推荐)
两种入口,内容完全一样:
- 右下角悬浮按钮「壁纸清理」→ 点一下直接弹出模态框(Esc 或点空白处关闭)。
- 或 设置(侧栏底部齿轮)→ 左侧 壁纸清理。
- 工坊文件夹:
- 桌面版 DSH 会调用内置的原生目录选择器;
- 普通浏览器打开时,点「选择文件夹…」会在页面里展开一个目录浏览器(驱动器 → 逐级进入 → 「使用此文件夹」);
- 也可以直接把路径粘贴到输入框。
- 订阅截图:点「选择截图…」,可以一次选中多张(订阅列表有多页时,把每一页都选中)。桌面版直接读取本地绝对路径(不复制文件);浏览器版会先上传到 DSH 数据目录。
- 点 开始扫描(每张截图约 20 秒)。插件会:
- 逐张识别每个磁贴右上角的蓝色勾选徽章,得到每一页的订阅数量;
- 用多倍率 OCR 读出每个磁贴的标题;
- 把所有页的磁贴合并后,与文件夹里的
project.json标题做 IDF 加权模糊匹配; - 列出“将保留”和“将移入回收站”两份清单。
- 核对清单后点 移入回收站(N 个),再点 确认执行。所有被移除的文件夹都进回收站,可还原。
如果某个磁贴 OCR 读不出来,页面会显示“未通过安全校验”并列出读到的文字(会标明是第几张截图的第几个磁贴)。展开“识别不准?手动补充标题”,把标题一行一个粘进去,再扫描一次即可(标题可以带 ... 截断)。
⚠️ 多页订阅列表请一次全部选中。只选其中一页时,其余页的壁纸会被当成“未订阅”,插件无法知道还有下一页;页面会在这种情况下给出“仅提供了 1 张截图”的额外警告。
安装 / 分发
从 GitHub 安装(推荐):
dsh plugin add github:jokerkenny00137/dsh-plugin-wallpaper-cleanup
也可以先克隆到本地,再用本地 bundle 安装:
plugin_manager install_bundle target: link:C:\path\to\dsh-plugin-wallpaper-cleanup
分发给别人时,把整个 dsh-plugin-wallpaper-cleanup 目录打包发过去,对方解压后用上面的命令安装即可(link: 指向解压后的目录)。安装后如果没看到“壁纸清理”,刷新一下页面(Ctrl+R)。
Agent 工具(可选)
对话里也可以让 agent 代跑:
wallpaper_cleanup_scan { "folder": "C:\\...\\431960", "screenshots": ["C:\\...\\page1.png", "C:\\...\\page2.png"] }
wallpaper_cleanup_apply { "planId": "<scan 返回的>", "confirm": true }
也兼容旧的单张写法 "screenshot": "C:\\...\\shot.png"。
scan 只生成计划不删除;apply 必须 confirm: true,计划不安全时要显式 force: true。
scan 也支持直接传 titles: ["标题1", "标题2", ...] 跳过 OCR(多页标题可以全部列进来)。
安全边界
- 只处理
folder的直接子目录,且目录名必须是纯数字(Steam 工坊 ID)。 - 必须有可读的
project.json标题,否则跳过并报告,绝不删除。 - 执行前重新检查:保留项仍在、待删项仍是直接子目录;任何异常都会整体中止。
- 只有所有截图的所有磁贴都匹配到文件夹、且数量与徽章总数一致时,才允许执行;缺一张截图、缺一个磁贴都会阻止删除。
- 只调用回收站 API,不永久删除;不碰
appworkshop_*.acf、Steam 配置或文件夹之外的任何内容。 - HTTP 接口要求同源请求头,跨站页面无法调用。
匹配原理(简述)
- 颜色聚类找出每张截图里每个磁贴右上角的蓝色勾选徽章,得到磁贴网格和该页的订阅数量。
- Windows OCR 在 3×/4×/5× 三个放大倍数下识别整张截图,按坐标把文字归到各磁贴;跨磁贴的合并行会同时喂给相邻两个磁贴。
- 对所有页的磁贴,用 IDF 加权的字符二元组覆盖率 给所有文件夹标题打分:稀有词(“通缉”“刻晴”)权重高,通用词(“明日方舟”“Wuthering Waves”)权重低,OCR 误字和多余文字不会拖垮正确匹配。
- 跨页全局贪心分配:每个磁贴最多认领一个文件夹、每个文件夹最多被一个磁贴认领;同一壁纸出现在多页时只算一次。
- 只要有一个磁贴没配上,或配上的数量与徽章总数不一致,就标记为不安全,界面会禁用删除。
限制
- Windows only;需要系统安装中文 OCR 语言包(中文 Windows 默认自带)。没有中文 OCR 时建议用“手动补充标题”。
- 截图需要是 Wallpaper Engine 默认深色主题的“已订阅/已安装”网格(蓝色勾选徽章)。自定义主题若更换了勾选颜色,请用标题模式。
- 多页订阅列表必须一次全部选中;插件无法从单页截图推断是否还有下一页,但会在这类计划上给出警告。
- 每个磁贴仍需能被 OCR 读到至少一部分文字;完全读不出的磁贴会让计划变为“不安全”,可用标题模式补齐。
Comments
Loading…
Similar plugins
✦
No screenshots
by SharpWord
Wallpaper Engine (Steam) wallpapers behind DeepSeek Harness: follow the active wallpaper or pin one from the Workshop library, with translucent panels, per-block blur and wallpaper-matched text contrast.
★ 1
MIT
JavaScript
Oct 23, 2026
dsh plugin --profile web add dsh-wallpaper-engine✦
No screenshots
Reusable skill to browse, search and download Wallpaper Engine (Steam 431960) workshop wallpapers and wire them into the DSH skin center, including bypassing the Steam HTTP block and the region-mismat
★ 0
dsh plugin --profile web add dsh-we-wallpaper-syncWallpaper Engine integration for the dsh web GUI: scan the local WE library (Steam workshop 431960 + local projects) and use its wallpapers as the page background — image/video/web rendered natively,
★ 0
↓ 247/wk
dsh plugin --profile web add dsh-wallpaper✦
No screenshots
Wallpaper backgrounds for the DSH web GUI. Windows: reads your Wallpaper Engine (Steam) library and plays video/web wallpapers behind the chat. macOS: scans the WaifuX download folder and loose media
★ 0
dsh plugin --profile web add dsh-plugin-wallpaper-engineby YRN-playmaker
一键同步壁纸引擎各类动态场景壁纸的插件,设置应用启动项。A "wallpaper engine" synchronization plugin mounted on the deepseek harness can synchronize static wallpapers
★ 32
↓ 487/wk
GPL-3.0
JavaScript
Aug 25, 2026
dsh plugin --profile web add dsh-wallpaper_shareFull-screen dynamic wallpaper from local videos and images, with live effect controls, wallpaper switching and Wallpaper Engine workshop import; settings persist automatically.
★ 0
dsh plugin --profile web add @b-tq/dsh-wallpaper
