前言¶

DeepSeek Harness（DSH）采用“一切皆插件”的设计理念，在关注代理逻辑与对话能力的同时，Web 界面的视觉呈现同样影响开发体验。dsh-soft-glass-ui 是一个非官方的视觉层插件，它通过装饰现有的 DOM 节点，为 DSH 提供软玻璃质感的视觉主题。

插件简介¶

• 名称：dsh-soft-glass-ui
• 维护者：Zzc269
• 许可：MIT
• 定位：趣味换装类插件，仅提供视觉样式与呈现行为，不涉及逻辑变更。

核心功能¶

该插件覆盖了 DSH Web 界面的多个核心状态：
* 覆盖范围：Home（首页）、conversations（对话）、trajectory（轨迹）、settings（设置）、menus（菜单）、dialogs（对话框）及相关 Web UI 状态。
* 主题支持：提供 Light（浅色）和 Dark（深色）主题切换。
* 长草稿处理：针对对话输入框，将长草稿限制在内部滚动区域内，保留圆角裁剪效果，并为底部的统计行预留紧凑的底部安全区域。
* 行为隔离：仅修改视觉样式，不改变 Harness Agent、Session、Tools、Permissions、存储、凭证或模型运行时的任何行为。

安装与启用¶

从发布归档安装插件需要指定本地路径：

dsh plugin --profile web add <path-to-dsh-soft-glass-ui.tgz>

安装完成后，重启 Web 进程以使样式生效。

Windows 快速操作¶

对于 Windows 用户，仓库提供了命令行包装脚本，可自动处理 Harness 检出路径、pnpm 环境及端口占用问题。

• install.cmd：停止 Harness 进程，移除旧版/当前主题，安装插件，启动 Harness 并打开浏览器。
• uninstall.cmd：停止 Harness，移除 Soft Glass 及旧版主题，恢复原始 UI。
• start.cmd：启动 Harness（默认端口 3081），或检测已运行实例。
• stop.cmd：停止检测到的 Harness 进程。
• status.cmd：显示 Harness 目录、pnpm 路径、已安装主题、归档哈希、端口占用及命令行信息。

可选参数：
* -HarnessRoot：指定 Harness 检出路径。
* -Port：指定端口号。
* -NoOpen：安装后不自动打开浏览器。

注意：脚本会自动将 pnpm 加入子进程 PATH，避免安装插件时报错 pnpm is not recognized。

移除与回滚¶

若需移除插件或回滚到原始界面，执行：

dsh plugin --profile web remove dsh-soft-glass-ui

重启 Web 进程后，原始 Harness UI 应自动恢复。

源码构建¶

在兼容的 Harness 检出目录下，将此目录放置于 plugins/soft-glass-ui，然后执行构建：

pnpm run build

构建过程会使用 Harness 的 client-bundle 预设，并运行 release sanitizer 以移除构建机器路径。

兼容性与架构¶

• 兼容版本：
  • DeepSeek Harness: 0.1.0-rc.5
  • Node.js: ^22.19.0 或 >=24.0.0
  • 平台: Web profile
  • 视口: 1440 x 900, DPR 1
• 架构说明：插件使用 DSH 客户端插件注入路径，通过添加 data-softglass-* 属性装饰现有 DOM 节点，并应用 scoped CSS 模块。卸载时会自动移除装饰与样式标签，不替换或修补核心源文件。
• 日志位置：运行日志写入 %LOCALAPPDATA%\SoftGlassUI\logs。

注意事项¶

• 非官方项目：该社区项目与 DeepSeek 或 Kelivo 项目无隶属、赞助或背书关系。
• 兼容性提示：虽然当前已验证兼容 DSH 0.1.0-rc.5，但与后续 Harness 版本的兼容性并未保证，需在升级后重新测试。
• 端口占用：脚本不会自动停止占用所选端口的未知进程，需手动处理冲突。

资源链接¶

• GitHub 仓库：https://github.com/Zzc269/dsh-soft-glass-ui
• 插件目录：https://www.skillhub.cn/plugins/Zzc269/dsh-soft-glass-ui