dsh-custom-css
Manifest validdsh-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

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。
Comments
Loading…
From the same category
DeepSeek Harness plugin for Reactive Resume: bridges your resumes and job applications into a Harness session over MCP.
★ 41.7k
↓ 64/wk
MIT
Aug 24, 2026
dsh plugin --profile web add dsh-plugin-reactive-resumeby dsh-market
The plugin market inside DeepSeek Harness — browse, search, one-click install · DSH 可视化插件市场
★ 12.7k
↓ 278k/wk
MIT
TypeScript
Nov 16, 2026
dsh plugin --profile web add dshmarketby Tencent
Let AI agents use your real, logged-in browser without interrupting your work. CLI + extension for browser automation across any shell-capable AI agent.
★ 10.5k
↓ 15.7k/wk
MIT
TypeScript
Nov 16, 2026
dsh plugin --profile terminal add @wxg-prc-cpg/browser-skill-dsh-pluginby kingcharleslzy-ai
Community-maintained dsh-purge fork with host-policy patches, prompt and rule settings, diagnostics, separate update-check and install controls, and local backup/rollback.
★ 9.3k
MIT
JavaScript
Nov 16, 2026
dsh plugin --profile web add dsh-purge-communityby superdesigndev
OpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn
★ 8.2k
NOASSERTION
Python
Nov 17, 2026
dsh plugin --profile web add treg-dshby yjh051108
dsh-routing-suite — injector + router-standard kit: install the runtime injector first, then the task-aware reasoning-mode router preset (measured P1-P23).
★ 7k
MIT
JavaScript
Sep 18, 2026
dsh plugin --profile web add @dsh-external/dsh-super-injector