dsh-appearance
Appearance settings plugin for the dsh web profile: theme presets (Claude / GitHub / Neo-brutalism / Terminal) plus font family, code font and font-size controls, persisted in the host settings document.
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:levi52/dsh-appearance说明文档
阅读完整 README ↗🎨 DeepSeek Harness 外观插件
DeepSeek Harness Web 的外观设置插件:主题、强调色、字体、背景壁纸,一键个性化你的 Web UI。
English · 中文
特性
- 🎨 主题:浅色 / 深色 / 跟随系统 + 9 个预设主题(Claude、GitHub、新粗野主义、终端、Dracula、Tokyo Night、Gruvbox、Solarized、Material),支持自定义主题(编辑器调整 5 个关键色,其余自动推导)
- 🌈 强调色:8 个预设色 + 自定义取色器,叠加在任意主题上,自动按 WCAG 计算反色文字
- 🔤 字体:界面字体 / 代码字体(默认、无衬线、衬线、等宽、自定义),支持系统字体选择器(直接挑选电脑已装字体),字号三档缩放
- 🖼️ 背景壁纸:本地上传或粘贴 URL;历史壁纸画廊一键切换、可删除;透明度(最高纯壁纸无遮罩)与模糊度可调
- 📤 导出 / 导入:整套外观配置导出为 JSON,便于备份、分享与换机迁移
- ⚡ 快捷切换:侧边栏底部「外观」按钮即时切换主题与强调色,无需打开设置页
- 💾 自动持久化:所有设置保存到
$DSH_HOME/settings.yaml,刷新后自动恢复 - 🧩 草稿工作流:修改先入草稿,点「保存并应用」才生效,可随时放弃更改
安装
环境要求
- DeepSeek Harness(
dshCLI)已安装并运行过 Web profile - Node.js ≥ 18(开发环境为 v22)
安装步骤
# 1. 一键安装(自动注册 bundle 到 web profile + 开放设置命名空间白名单):
npm run install-plugin
# 等效于手动执行下面两步,也可用 --profile 指定其他 profile:
# dsh plugin --profile web add
# npm run fix-whitelist
# (提示:本地 link: 安装不会触发生命周期脚本,白名单需执行一次;
# registry/npm 安装时 postinstall 会自动尝试。升级/重装
# dsh-host-apiproxy 后需重新运行 fix-whitelist。)
# 2. 重启 dsh web
卸载
npm run uninstall-plugin
# 移除 bundle 并清理网关白名单;用户数据(settings.yaml 的 ui-appearance
# 段与 wallpapers/ 目录)会保留,如需彻底清除请手动删除。
纯客户端改动(主题色、字体、壁纸设置等)只需强制刷新浏览器;宿主侧改动(schema、路由)需要重启。