DeepSeek Harness 通用 UI 个性化设置插件 (dsh-customization-settings)

DeepSeek Harness (DSH) 采用模块化架构，允许通过插件扩展功能。UI 个性化是提升使用体验的重要一环。dsh-customization-settings 插件旨在为 DSH 提供通用的 UI 个性化设置入口。它通过扩展设置面板的结构，为后续接入壁纸、主题色等具体功能做准备。

插件概况¶

名称：dsh-customization-settings
作者：T-MKT
许可证：MIT
功能定位：通用 UI 个性化设置

核心功能¶

该插件目前主要完成基础框架的搭建：

新增“外观”大类：在 DSH 的“设置”面板左侧新增“外观”分类，图标与“通用设置”保持一致。
集成设置组件：引入 @deepseek-ai/dsh-client-ui-settings，作为后续功能开发的底层组件。
规划功能：计划支持壁纸、主题色、字体与排版、模糊材质等个性化选项。

安装与启用¶

由于插件尚未发布到 npm，安装过程需要从本地仓库进行。

前置条件¶

Node.js 版本要求：>=22.19.0
已安装 DeepSeek Harness 并配置好 Web Profile

步骤 1：本地安装¶

将插件仓库添加到 Web Profile 的 node_modules 目录中：

dsh plugin --profile web add <repo-path>

步骤 2：启用插件¶

启用方式有两种，选择其一即可：

方式 A：追加至组合包列表（推荐）

编辑 Web Profile 的 package.json，找到 "dsh": { "profile": { "bundles": [...] } } 字段，将 "dsh-customization-settings" 追加到数组中。

"dsh": {
  "profile": {
    "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-customization-settings"]
  }
}

方式 B：合并 Patch 文件

将插件仓库根目录下的 cordis.patch.yml 文件中的 insert 段直接合并到 Web Profile 的 cordis.patch.yml 文件中。

步骤 3：重启服务¶

执行上述配置修改后，重启 DSH Web 服务使配置生效：

dsh web

开发与依赖¶

该插件依赖 DSH 客户端的相关 UI 组件包：

@deepseek-ai/cordis
@deepseek-ai/dsh-client-ui-settings
@deepseek-ai/dsh-client-ui-slots

本地开发时，可使用以下命令进行依赖安装、构建和类型检查：

pnpm install   # 安装依赖
pnpm build     # 产出 lib/index.js 与 lib/client.js
pnpm typecheck # 仅进行类型检查

注意事项¶

开发状态：插件处于开发阶段，尚未发布到 npm，目前“外观”大类下的条目区暂为空，具体功能待后续迭代。
维护情况：作者目前为高二在读学生，不常查看 issues 和 PRs，如有严重问题建议通过邮件联系。
安全建议：由于插件为社区维护且未经过官方大规模审核，安装前请务必检查源码与许可证。