Ayase34/wallpaper-plugin

Skin皮肤 Native原生 ⭐ 13 MIT UI & Themes界面与主题

DeepSeek Harness的壁纸管理插件

Project Overview项目介绍

This is a native theme and wallpaper plugin built exclusively for DeepSeek Harness (DSH). It adds a new "Appearance Presets" option to DSH’s settings page after installation, enabling preset management and custom wallpaper functionality for the DSH client interface. To install the plugin from the DSH CLI, run the command dsh plugin --profile <name> add github:Ayase34/wallpaper-plugin in your terminal. You can also optionally customize the storage directories for presets and assets by adding a configuration entry to your profile’s cordis.patch.yml file. This plugin ships with a valid DSH plugin manifest, so it will be recognized automatically by DSH after installation.

The plugin is designed for DSH users who want to customize their client’s interface appearance. It supports uploading custom wallpaper assets, with a limit of 20MB per file and a maximum of 100 total assets in the library. Uploaded assets can be assigned to three different interface regions: 16:9 chat background, 1:1 settings card, and 1:5 sidebar poster, with per-region cropping, brightness adjustment, and opacity configuration. It also supports layered output for GIF animations, collage of multiple static images, and 12 AI-powered tools for conversational theme creation and adjustment. Finished themes and presets can be exported as a zip archive with all assets included, and imported fully intact on another DSH client.

The plugin is released under the open-source MIT license, so it is free to use, modify, and distribute for any purpose. Regular end users do not need any additional dependencies to run the plugin after successful installation. First-time users can get started right away by applying the default factory preset from the new Appearance Presets menu, then upload custom images and set them as chat background with one tap. Plugin developers who want to modify or build the plugin from source need to set the DSH_CHECKOUT environment variable to point to a local DSH source checkout, then run npm run build to generate the plugin output. Full end-to-end testing requires additional environment variables for Playwright and Chromium paths.

这是一款专为 DeepSeek Harness(DSH)开发的原生壁纸主题插件,为 DSH 提供主题预设管理和自定义壁纸系统功能。安装完成后,DSH 的设置页面会新增「外观预设」选项,支持一键切换主题卡片、编辑主题参数、管理壁纸素材,还提供 AI 协同换肤工具和导入导出分享功能。用户可以通过 DSH 内置 CLI 执行命令 dsh plugin --profile <name> add github:Ayase34/wallpaper-plugin 完成安装,也可自定义配置预设和素材的存储路径。

这款插件面向需要自定义 DSH 界面外观的用户,支持上传单张大小不超过 20MB、总数不超过 100 张的壁纸素材,可将素材分别分配给聊天背景、设置卡、侧栏海报三个不同界面区域,按比例裁剪并分别调整明暗、不透明度。还支持多图拼贴合成壁纸、GIF 动图分层输出,可通过 12 个对话式 AI 工具创建、应用、微调主题。

插件采用 MIT 许可证开源,普通用户无需额外依赖,安装完成后即可在设置页启用出厂预设,上传自定义图片后一键设置为聊天背景。如果是插件开发者,需要配置 DSH_CHECKOUT 环境变量指向本地 DSH 源码目录,执行 npm run build 即可完成构建,全量端到端测试还需要额外配置 Playwright 和 Chromium 路径。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 13 stars - an early-stage project星标 13,属于早期项目
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 github:Ayase34/wallpaper-plugin

把 Ayase34/wallpaper-plugin 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

wallpaper-plugin — DSH 壁纸插件

中文 | English: README.en.md

DSH(DeepSeek Harness)第三方插件:主题预设管理与壁纸系统。安装之后设置页会多一个「外观预设」的选项。

功能

  • 预设墙:卡片一键切换 + 封面 + diff 告警;工作室深度编辑(原始令牌 / CSS 补丁 / 主题注册 / 素材部件)
  • 壁纸素材库:上传图片(≤20MB/个,库上限 100 个)→ 分配给三部件(16:9 聊天背景 / 1:1 设置卡 / 1:5 侧栏海报),按固定比例裁剪、明暗分别配置、不透明度
  • 图层合成壁纸:多张小图拼贴合成;多 GIF 时间轴合成输出真动图;单个动图场景自动分层输出
  • AI 协同:12 个 preset_* / asset_* 工具(对话式换肤:创建 / 应用 / 微调 / 自纠)
  • 分享:zip 三件套导出(预设 + 封面 + 全部素材内嵌),导入完整还原(含分层规格)

安装

安装步骤

# 装入 profile
dsh plugin --profile <name> add github:Ayase34/wallpaper-plugin

插件配置(可选)

在 profile 的 cordis.patch.yml 写:

- id: wallpaper-plugin
  config:
    presetsDir: C:/你的预设目录      # 可选;默认 <dshHome>/.ui-presets
    assetsDir: C:/你的壁纸库目录     # 可选;默认 <presetsDir>/assets

快速开始

  1. 设置页 →「外观预设」→ 应用出厂预设
  2. 工作室「素材与部件」区上传图片 → 点「设为聊天背景」一键启用(自动按 16:9 裁剪)
  3. 分享:「导出 ZIP」→ 发给别人 → 对方在工作室/预设墙「导入」

开发

npm run build                # 构建 lib/core.mjs + .dsh-plugin/*(需 DSH_CHECKOUT)
npm run check:client         # 产物一致性守卫(--check)
npm test                     # 构建 + 单测(183 项)
node scripts/selfcheck.mjs   # 一键自检:构建一致性/单测/安装声明/数据完整性
node scripts/run-regression.mjs  # 全量 e2e(31 脚本;需 spike profile + 环境变量)
  • 构建依赖:DSH_CHECKOUT 必须显式指向 deepseek-harness checkout(vendor/schemastery + vendor/cosmokit 打包自包含——静态外部 import 会导致桌面端无法启动);目录生成同理:node scripts/gen-catalog.mjs --dsh <checkout>
  • e2e 环境变量(必填):UIP_PLAYWRIGHT_DIR(playwright 包目录)、UIP_CHROMIUM(chromium 可执行文件);DSH_HOME 指向隔离测试目录(e2e-home),测试一律用独立 spike profile + 端口 3180,不触碰正式 profile

许可证

MIT

← 上一个 Prev Fairy-DSH-Optimized 下一个 Next dsh-notification-center →