deepseek-harness-desktop-app/packages/dsh-theme-pack

606Star32Fork6Issue0Watching

DeepSeek Harness Desktop App 自带的主题包：提供默认「专业蓝」与可选「二次元蓝」两套主题的安全色板，并把它们登记为当前 Profile 下的官方主题。

分类🎨 主题皮肤🛡️ 安全与治理
vibeingingvibeinging
·vibeinging/deepseek-harness-desktop-app.git
语言
JavaScript
License
MIT
分支
dev
agentic-workflowsai-agentai-workbenchdata-analysisdeepseek-harnessdesktop-appdshdsh-plugin

安装

$ dsh plugin --profile web add github:vibeinging/deepseek-harness-desktop-app/packages/dsh-theme-pack

在终端中运行以上命令，通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh？看这篇新手教程

一句话定位

DeepSeek Harness Desktop App 自带的主题 Profile Bundle，把 professional-blue（专业蓝，默认）与 anime-blue（二次元蓝，可选）两套主题的安全色板登记到当前 DSH Web Profile 的主题目录里，并占用 Cordis 插件树中的一行让 Profile 统一管理生命周期。

核心能力

  • 暴露 professional-blue 默认主题：墨蓝背景 #edf2fa、钴蓝强调色 #405fd2、克制的 Mantine 十阶色板与暗色变体
  • 暴露 anime-blue 可选主题：通透的蓝色调 #5b8def 主色、亮/暗两套背景与色板，开启后会激活看板娘首页
  • 通过 cordis.patch.yml 在 Cordis 插件树里插入 dsh-theme-pack 行，让 Profile 拥有该主题包的生命周期管理权
  • 把所有主题颜色与外观信息放在 themes.json 中，由 DSH Renderer 直接渲染，源码里不再维护第二套主题注册表
  • 严格遵守 renderer-safe 边界：仅暴露 CSS 变量、Mantine 色板、背景色、面板透明度，禁止注入原始 CSS、远程图片或修改应用名
  • 与同仓库的 dsh-work-shell 与 dsh-product-bridge 协同，三件齐全即可呈现桌面应用完整外观与能力

技术实现

  • 语言: JavaScript（ES Module）+ JSON（主题数据）+ YAML（cordis patch）
  • 关键依赖: @deepseek-ai/cordis ^4.0.1（Cordis 插件树管理，列入 peerDependencies 与 devDependencies）
  • 架构模式: 通过 package.json#dsh.bundle.patch 指向 cordis.patch.yml 声明 Bundle 补丁，通过 package.json#dshWork.themes 指向 themes.json 声明主题描述符；src/index.js 仅导出 name 与一个空的 apply()（文件头注释说明 Profile-owned 插件不需要宿主服务，主题数据从 themes.json 投影）
  • 入口文件: packages/dsh-theme-pack/src/index.js、packages/dsh-theme-pack/themes.json、packages/dsh-theme-pack/cordis.patch.yml

适用场景

适合已经或即将安装 DeepSeek Harness Desktop App 的用户，把它作为桌面应用自带主题数据的标准来源引入 Profile，避免主题漂移或第三方主题混入。如果只想自定义外观而不要官方主题，可以选择本地主题新建/导入而不装这个包；如果是给第三方 DSH 客户端做主题，需要走本地主题机制。

前置依赖与兼容性

依赖最低版本说明
DSH0.1.0-rc.6与父仓库使用的 DSH 版本一致；peerDependencies 仅声明 @deepseek-ai/cordis ^4.0.1
Node.js^22.19.0 || >=24.0.0package.json#engines 放宽到 22.19 及以上或 24，根 package.json 与 electron/package.json 要求 >=24
平台跨平台主题包只承载 JSON/YAML/JS 数据，无原生模块、无系统调用
原生模块无—

安装方式

dsh plugin --profile web add github:vibeinging/deepseek-harness-desktop-app/packages/dsh-theme-pack

配置项

配置类型说明默认值
主题选择professional-blue | anime-blue在主题设置页切换；缺失或未选时回落 professional-blueprofessional-blue
主色强调CSS 变量 --el-color-primary亮/暗各 1 个，覆盖 Element Plus 主色跟随所选主题
Mantine 色板10 阶 hex 数组提供 Mantine 组件库的色阶跟随所选主题
背景颜色hex桌面背景色，亮/暗两套跟随所选主题
面板透明度百分比（0-100）工作台面板的不透明度跟随所选主题
明暗模式light | dark | system由 DSH Settings API 持久化为 ui-theme.preference，仅在无用户偏好时写入默认值system

主题字段完整定义在 packages/dsh-theme-pack/themes.json；每个主题都包含 id、name、description、base: "lighting"、vars、mantineColors、dark.vars、dark.mantineColors、appearance.bgColor、appearance.panelOpacity、appearance.dark.bgColor、appearance.dark.panelOpacity，并使用 schema_version: 1 作为描述符版本。

常见问题

Q: 装上这个包之后会出现什么变化？

A: cordis.patch.yml 会把 dsh-theme-pack 行插入 Cordis 插件树，让 Profile 接管主题包的生命周期；同时 themes.json 中 professional-blue 与 anime-blue 两条主题会出现在 Web Profile 的主题目录里，可在主题设置页切换。

Q: 这两套主题分别适合什么场景？

A: professional-blue 是默认主题，墨蓝背景配克制的钴蓝强调色，提供独立亮/暗两套色板，适合日常项目和正式演示；anime-blue 是可选主题，色调更通透，启用后看板娘会出现在新对话首页。

Q: 主题能不能夹带原始 CSS、远程图片或改应用名？

A: 不能。themes.json 只暴露 renderer-safe 的颜色与外观 token（CSS 变量、Mantine 色板、背景色、面板透明度），不含 rawCss、远程背景图或 appName 字段；过度宽松的字段会在加载时被丢弃。

Q: 主题色板包含哪些具体内容？

A: professional-blue 主色 #405fd2（亮）/ #7b9cff（暗），背景 #edf2fa / #1b2d49，面板透明度 98 / 96；anime-blue 主色 #5b8def / #86b2ff，背景 #f8fbff / #2c3440，面板透明度 100 / 100。每套都附带完整的 10 阶 Mantine 色板。

Q: 这个包是私有包吗？跟 npm 上的同名包是什么关系？

A: 是私有包，package.json 标 private: true，无法通过 npm publish 发到公共 registry。包名 @deepseek-ai/dsh-theme-pack 仅供随桌面应用一起发布并由应用自有 Profile 加载；普通用户通过 GitHub 安装命令即可。

Q: 这个包能被普通用户卸载吗？

A: 它属于应用自有 Bundle，由父应用统一随 Profile 加载和升级，不在普通用户的可卸载列表中。日常主题切换、背景与明暗模式调整直接在主题设置页操作。

Q: 安装命令是什么？需要先装好桌面应用吗？

A: dsh plugin --profile web add github:vibeinging/deepseek-harness-desktop-app/packages/dsh-theme-pack。命令把仓库的 packages/dsh-theme-pack 子目录作为 Bundle 源写入当前 Web Profile。

Q: 这个包跟同仓库的 dsh-product-bridge、dsh-work-shell 是什么关系？

A: 三者同属 DeepSeek Harness Desktop App 的私有 Profile Bundle 三件套：dsh-theme-pack 负责主题数据，dsh-work-shell 替换默认壳，dsh-product-bridge 注入 10 个产品工具桥接；三件齐全，桌面应用才会呈现完整外观与能力。

上手难度

入门 — 安装一条命令即生效，不需要写代码；想要自定义外观时直接进主题设置页切换，不需要修改 themes.json。

已知问题与限制

  • package.json 标 "private": true，无法通过 npm publish 发到公共 registry；安装只能走 GitHub 精确 commit 或本地 file: 路径（packages/dsh-theme-pack/package.json:5）
  • src/index.js 导出的 apply() 函数为空函数体（注释说明：Profile-owned 插件不需要宿主服务），仅靠 cordis.patch.yml 注册自身条目，没有运行时逻辑可观测（packages/dsh-theme-pack/src/index.js:4-5）
  • 主题字段受 renderer-safe 约束：超出的字段在加载时被丢弃，自定义主题只能调颜色与外观，不能注入原始 CSS、远程图片或修改应用名（packages/dsh-theme-pack/README.md:8、packages/dsh-theme-pack/themes.json 字段范围）
  • peerDependencies 固定 @deepseek-ai/cordis ^4.0.1，未声明更宽范围；与 DSH 0.1.0-rc.6 SDK 强绑定，跨 RC 升级需要父应用同步调整
  • 没有独立 README：除自身 10 行 README 外，所能参考的只有父项目 README 的"主题与外观"与"插件中心"章节（packages/dsh-theme-pack/README.md 全文）
返回插件目录