nexsjournal/dsh-customui-plugin

README 摘要

dsh-customui-plugin（个性化） 给 DeepSeek Harness（DSH）网页版加一个 「个性化」设置页 ：自定义侧边栏 Logo、空对话欢迎区（Logo + 文案）、对话区域背景图。 修改实时生效，无需重启 DSH。 功能 设置项 说明 左上角 Logo 替换侧边栏左上角的品牌标识（侧边栏展开状态）。建议横版 SVG，显示高度 24px。 欢迎区 Logo 替换空对话欢迎区的小鱼图标，显示高度 34px。 欢迎区文案 留空保持原版欢迎语；填写后仅显示该文案（Logo 可同显）。 对话背景图 铺在对话区域（消息 + 输入框）后的背景，支持「铺满/完整显示」与 0–80% 暗化（提高文字可读性）。建议 1600×900（16:9 横版）。 每个图片项都支持 上传本地图片 （客户端自动压缩：位图缩放到 ≤1920px、转 JPEG/PNG；SVG 原样保留）或 粘贴图片链接 （https URL）。 实时生效的原理 纯浏览器端 DOM 覆盖，不改宿主构建： - 用 稳定的设计常量 做锚点（不是会随构建变化的哈希 class 名）： - 品牌字标 svg[viewBox="0 0 182 24"] - 欢迎区小鱼 svg[viewBox="0 0 23.16 17.04"] - 对话区域 [data-conversation-scroll] - MutationObserver 监听 DOM，React 重渲染 / 切换会话 / 侧边栏折叠后再把自定义补回来；应用逻辑幂等，不会无限循环。 - 配置写入 DSH 设置命名空间 customui （随 profile 持久化），命名空间一变更立即重新应用 —— 所以在设置页里改，界面马上变。 安装 需要已有一个 DSH web 部署（ dsh web 或桌面版）。 等价的手工步骤（ -w 必需：profile 是 pnpm workspace 根）： 然后重启 DSH 一次。 说明： 1. 插件启动时会把 customui 设置命名空间幂等地加入 Web 设置页的 api-proxy 白名单 （ dsh-host-apiproxy 的 WEB SETTINGS NAMESPACES ），因此「个性化」导航项与设置写入在 下一次启动 后出现； 2. 之后所有配置修改都是热生效的，不再需要重启； 3. 卸载： dsh plugin --profile web rm dsh-customui-plugin 后重启，再点「恢复默认」清掉已存配置。 桌面版更新（覆盖安装）会重置 api-proxy 白名单文件，重启后插件会再次自动打补丁。 开发 - 无构建步骤： lib/index.js （宿主侧，注册设置 + 打白名单补丁）、 lib/client.js （浏览器侧，设置页 + 实时应用）均为纯 JS。 …

分类