deepseekplugins

DeepSeek Harness plugin

dsh-custom-css

DSH WebUI 自定义 CSS 插件：共享样式、冲突保护与本地文件导入

Tools & Capabilities
Jump to install

Source facts

Repository
AnacondaKC/dsh-custom-css
Latest update
Aug 13, 2026
Category
Tools & Capabilities
GitHub stars
3
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/AnacondaKC/dsh-custom-css
Plugin: dsh-custom-css
Author: AnacondaKC

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-custom-css

DSH WebUI 自定义 CSS 插件（官方 bundle 形态，client-half 插件）。

在设置面板新增「外观 / Custom CSS」页：粘贴任意 CSS 即时改变 WebUI 观感，样式持久化到宿主设置（$DSH_HOME/settings.yaml），所有访问该 GUI 的浏览器共享，多浏览器实时同步。

功能

  • 粘贴/编辑 CSS 后 500ms 防抖自动保存到宿主，所有浏览器实时同步
  • revision 乐观并发控制：远端修改与本地草稿冲突时暂停自动保存，用户可选择采用远端版本或显式覆盖
  • 保存、同步、冲突和错误状态反馈；失败后可手动重试或放弃草稿
  • 可导入 .css 文件，或上传 JPEG/PNG/WebP 背景图（压缩后以 data URI 存入 CSS，CSS 总量上限 1,048,576 个字符）
  • 安全模式：URL 带 ?dsh-custom-css=off 时本页不注入自定义样式，设置页仍可用于恢复
  • 读、写均走 trusted-host 信任模型：本机与 --trusted-host 声明的远程地址都可修改共享样式
  • 未保存草稿存于本浏览器 localStorage，刷新不丢失
  • 中英文案
  • 附带旗舰演示主题 examples/dsh-aurora-nexus.css，完整覆盖官方语义色、排版、动效、阴影、滚动条与 Shiki 接口

旗舰演示主题：Aurora Nexus

![Aurora Nexus 主题效果](examples/dsh-aurora-nexus.png)

[examples/dsh-aurora-nexus.css](examples/dsh-aurora-nexus.css) 是本项目的完整能力演示：同时适配亮色/暗色，覆盖全部官方 --dsw-alias-*、--dsw-specific-*、静态色阶、排版、动效、阴影、滚动条和 Shiki token，并通过官方主题标记、ARIA role、data-* 与少量集中管理的 CSS Modules 选择器增强主框架、侧栏、会话、输入栏、设置、弹窗、菜单、Markdown、代码块和轨迹视图。

使用方式：打开「设置 → 自定义CSS」，复制该文件全文并粘贴。插件会将样式保存到宿主并同步给所有连接到当前 DSH GUI 的浏览器。主题不加载远程字体或图片，并完整处理 prefers-reduced-motion、高对比度和强制色模式。

架构

src/index.ts         host half：注册 settings namespace `dsh-custom-css` + 双 RPC 通道
src/rpc.ts           读通道 /dsh-custom-css-read（trusted-host）+ 写通道 /dsh-custom-css-write（trusted-host）
src/client/          browser half：设置页 + 样式注入（<style data-plugin>）+ 宿主同步

宿主设置经自定义 RPC 读写（Web 设置 API api.settings.* 只服务白名单 namespace，插件 namespace 不可达）。

构建与挂载

pnpm build                                        # tsc + tsdown + 产物校验
dsh plugin --profile web add /path/to/dsh-custom-css
dsh --profile web --dump-config | grep custom-css # 确认进入 bundles
# 重启 dsh web 后生效；浏览器 DevTools 检查：
#   window.__DSH_BOOT__.entries 含 dsh-custom-css
#   document.head 出现 <style data-plugin="dsh-custom-css">

开发态 dsh web --dev 下改 src/client/** 后重新构建，浏览器经内置 client-hmr 原地热替换（无需刷新）。

测试

pnpm test   # RPC 契约 + controller 状态机（冲突/草稿/权限）

恢复路径

  • 样式异常：URL 加 ?dsh-custom-css=off 打开本页；随后清空输入框或关闭开关并保存
  • 配置损坏：删除 $DSH_HOME/settings.yaml 中 dsh-custom-css 段后重启
  • 安全提示：CSS 和背景图会同步给同一宿主的所有浏览器。仅应向受信任的 --trusted-host 访问者开放该 GUI，勿粘贴来源不明的 CSS。
Back to searchOpen GitHub repository

More related plugins

View category