dawsondx/dsh-custom-logo

dawsondx★ 2JavaScriptLast synced: 2026-08-19

Open on GitHub

DSH web plugin: replace branding (favicon + sidebar logo) with your own images via an in-app upload panel

README excerpt

上传两张图,换掉 DeepSeek Harness 整套品牌标识 English · 简体中文 给 DeepSeek Harness(dsh)换上你自己的品牌:安装后侧边栏底部多一个「品牌」按钮,选一张方形图、一张横向宽图,插件自动裁切缩放并替换 favicon 与侧边栏 Logo—— 免切图、免重启、升级不丢 。 两张图,三处生效 - 浏览器标签页 — 方形图居中裁切为 favicon,收藏夹图标同步更新 - 展开侧边栏 — 横向宽图等比缩放,以 42px 高度替换原生文字标 - 折叠窄栏 — 方形图缩为 36px 圆形图标 图片处理全部在浏览器端完成,上传后页面自动刷新生效,不需要重启服务,也不需要手动准备任何尺寸的切图。 安装 方式一:从 npm 安装(推荐) 方式二:直接从 GitHub 添加 方式三:clone 后安装(审阅源码 / 参与贡献) 安装后重启 dsh( dsh start --profile web 或你的启动脚本),侧边栏底部即出现「品牌」按钮。 使用 1. 点击侧边栏底部「品牌」按钮 2. 「网页图标」卡片 → 选择图片 → 自动处理并刷新 3. 「侧边栏 Logo」卡片 → 选择图片 → 自动处理并刷新 4. 不满意随时重传;想回原版点「恢复默认」 两张卡片的当前图会以缩略图预览;面板支持中英文,跟随 dsh 界面语言。 工作原理 - 客户端把选中的图片用 canvas 缩放为标准 PNG(方形 256×256 居中裁切;宽图 ≤1080×126 等比),POST 到本机 dsh 服务 - 服务端写入 /branding/ ( logo-128.png / logo-64.png / logo-wide.png ),原子落盘 - 每次 index 请求时动态注入:favicon 重写 + CSS 隐藏原生 SVG(按稳定的 viewBox 属性匹配,不受构建哈希/类名顺序影响)、以背景图绘制自定义 Logo,URL 带 ?v= 自动破缓存 - 图片保存在 dsh 用户目录而非插件包内,插件升级不丢品牌图;dsh 升级也不覆盖本插件(patch 层挂载在用户 profile) 安全性 - 上传/重置接口仅接受 loopback 来源 (校验 peer socket 地址,非可伪造的 Host 头),局域网访问者无法改你的品牌图 - 仅接受 PNG(魔数校验),单次上传上限 8MB,文件名白名单,不接受任意路径写入 常见问题 上传后没变化? 硬刷新一次(Ctrl+Shift+R)。注入 URL 已带版本号,一般普通刷新即可。 宽图比例多少合适? 侧边栏品牌区高 42px,3:1(如 126×42、540×180)最饱满;更宽的图会按高度等比缩窄,不会变形。 折叠窄栏的图标好小? 窄栏是 36px 圆形位,方形图会被缩到这个尺寸,建议…

View full README on GitHub →
Skins / UIbrandingcustom-logodeepseekdeepseek-harnessdeepseek-harness-plugindshdsh-pluginfavicon

Category