dsh-interface-settings（DSH 界面设置插件）

一个 DeepSeek Harness 前端插件：把「壁纸 / 区域透明 / 输入框与轨迹毛玻璃 / 模糊程度 / 启动画面」做成一站式界面设置，作为独立插件项目上传、分享，装进 DSH 即可使用。

• 不修改 DSH 源码：所有外观都通过注入 CSS 变量与规则实现；
• 一个设置面板：壁纸模糊、玻璃模糊、面板透明度、区域透明开关、启动画面模式；
• 与桌面端同一套技术方案：本插件是桌面端（dsh-desktop）界面定制能力的浏览器端移植。

功能

桌面端桥接（dsh-desktop 0.2.0）

在 dsh-desktop 壳内运行时，插件自动启用桌面端桥
（window.dshInterfaceSettings，由桌面 preload 注入）：

• 设置面板与主进程共用同一份 Electron 配置，由主进程应用（含视频壁纸/视频声音等桌面独有能力）；
• 文件选择走原生对话框（支持视频；HEVC 自动转码）；
• 启动素材为视频时，动画时长滑块上限自动 = 视频完整时长；
• 纯 web 环境自动回退为插件自管（localStorage + DOM 注入），功能不变。

开发过程

插件结构

src/
├── index.ts               node 侧插件入口（空 apply，注册到 Loader）
└── client/
    ├── index.ts           浏览器端 apply：读配置 → 注入壁纸/玻璃/启动层 → 注册设置面板
    ├── settings.ts        配置类型 + localStorage 持久化
    ├── wallpaper.ts       壁纸层注入（body::before + 变量）
    ├── glass.ts           液态玻璃 CSS + 区域透明变量 + 轨迹饱和度透明
    ├── splash.ts          启动画面层（视频/图片，时长/淡出/点击跳过）
    ├── SettingsPanel.tsx  设置面板组件
    ├── SettingsPanel.module.css
    └── locales.ts         中英文案

📦 环境依赖

Node.js >= 20
pnpm >= 9
DSH 仓库 checkout（deepseek-ai/deepseek-harness）

安装与使用

用户安装（无需 npm/pnpm，已验证）

像用量统计插件一样，把插件拷贝到 DSH 的 profile 目录即可（不需要 npm）：

# 1) 把整个插件目录（含 lib/client.js、lib/index.js、package.json）拷贝到：
#    ~/.dsh/profiles/node_modules/dsh-interface-settings/

# 2) 在 ~/.dsh/profiles/web/cordis.patch.yml 追加：
#    - insert:
#        - id: dsh-interface-settings
#          name: 'dsh-interface-settings'

# 3) 重启 dsh web（或重启桌面端应用；改 patch 也会热重载）

也可直接下载 Release 包
（dsh-interface-settings-0.2.0.tgz），解压后按上面 1) 拷贝
package/ 目录内容即可，同样无需 npm。

⚠️ 注意：不要手动替换 DSH 管理的 workspace 链接（junction/symlink），
否则后端装配会卡住。如果插件包在 DSH 仓库里（workspace 包），用上面的
patch 方式启用即可；独立拷贝的包直接放进 node_modules 也行。

重启后打开「设置 → 界面设置」即可调整外观。此路径已实测：
插件进入 manifest 且 bundle 正常服务（HTTP 200）。

开发者（在 DSH 仓库内构建）

本插件是 DSH monorepo 的 workspace 插件（peer 依赖为 workspace 包）：

# 1) 把本项目放入 packages/client/interface-settings（或作为 workspace 包引入）
# 2) 构建浏览器端 bundle
pnpm --filter dsh-interface-settings bundle
# 3) 在 host 的 cordis.yml / 插件清单中启用该插件

启用后：

• 打开「设置 → 界面设置」面板调整壁纸 / 壁纸模糊 / 玻璃模糊 / 面板透明度 /
  区域透明 / 启动画面；
• 所有改动即时预览，保存后持久化（localStorage）。

📝 使用示例

// 浏览器端 apply：读配置 → 注入外观
const settings: InterfaceSettings = loadSettings()          // 读 localStorage
applyWallpaperLayer(settings)                               // 壁纸层
applyGlassAndTransparency(settings)                         // 玻璃 + 透明
if (settings.splashMode !== 'default') applySplashLayer(settings)  // 启动画面

// 设置面板改动即时预览并保存
saveSettings(next)

⚙️ 配置说明

配置保存在浏览器 localStorage（键 dsh.interface-settings.v1）：

🧪 测试

# 在 DSH 仓库内运行插件测试
pnpm --filter dsh-interface-settings test

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建你的功能分支 (git checkout -b feature/xxx)
3. 提交你的修改 (git commit -m 'feat: 新增xxx功能')
4. 推送到分支 (git push origin feature/xxx)
5. 打开 Pull Request

📄 许可证

本项目采用 MIT 许可证。

📮 联系方式

• GitHub：https://github.com/Qiongkura
• 微信：Qiongkura

已知限制

• 配置保存在浏览器 localStorage（无主进程配置通道）；
• 启动画面在插件加载后才出现（浏览器端无 preload 时机），首次渲染前仍是
  原生加载界面；
• 壁纸视频的编码兼容性依赖 Chromium 解码能力（HEVC 建议先转 H.264）；
• 轨迹饱和度透明每 1.5s 轮询一次，超大轨迹下有一定开销。

与相关项目的关系

• 桌面端完整版（含视频壁纸协议、托盘、自动转码、启动动画 preload 版）：
  Qiongkura/dsh-desktop
• 底层平台：deepseek-ai/deepseek-harness