前言¶

DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。当默认界面无法满足特定审美或一致性需求时，需要通过外观插件介入。dsh-codex-theme 插件将 Codex 主题的配置映射到 DSH 的 token 系统，提供了一套可配置的外观方案。

简介¶

这是一个 DSH 外观插件，由 Lxd-Ashe 维护。它支持 80 款 Codex 风格的浅色和深色主题，允许在 DSH 中直接切换和自定义。

核心功能¶

• 80 款主题预设：包含 26 款浅色主题和 54 款深色主题。
• 面板内切换：支持在浅色、深色和跟随系统之间切换。
• 主题下拉框：单个下拉框列出预设，带有色带预览。根据当前外观选择特定主题。
• 自定义字体和字号：为 UI 和代码字体分别设置字体和大小。字体下拉框仅列出已安装的字体。
• 持久化：设置写入 $DSH_HOME/settings.yaml。
• 可随时停用：可以在 DSH 设置中禁用或卸载。

安装与启用¶

在安装前，请确保系统已安装 Node.js ≥ 20，且 dsh 命令可用。

在 DSH Desktop 内置终端或安装了 DSH CLI 的终端中执行以下命令：

dsh plugin add dsh-codex-theme

或者直接从 GitHub 安装：

dsh plugin add github:Lxd-Ashe/dsh-codex-theme

安装完成后，重启 DSH（Desktop 应用或 dsh web）即可生效。

用法¶

1. 打开 DSH 设置界面。
2. 找到 Codex 主题设置面板。
3. 在外观模式中选择“浅色”、“深色”或“跟随系统”。
4. 从主题下拉框中选择预设主题，界面会即时更新。
5. 在字体设置中，从下拉框中选择本机已安装的字体，并调整字号。

注意事项¶

• 字体检测：字体下拉框仅列出本机实际安装的字体。“系统默认”选项不会覆盖 DSH 原生外观。
• 平台差异：macOS 上的字体自动检测最完整（通过 system_profiler 枚举）；其他平台检测失败时会优雅回退，显示全部候选字体。
• 持久化：设置持久化行为与操作系统无关，在 macOS 和 Windows 上表现一致。
• 卸载：可通过 dsh plugin remove dsh-codex-theme 命令或 DSH 设置 → 插件管理界面卸载。

结尾¶

本插件为 DSH 用户提供了丰富且可配置的视觉样式。更多详情请访问 社区目录 或查看 GitHub 仓库。