前言¶
长时间在 DeepSeek Harness（DSH）里写提示、看对话和调插件时，界面是否顺眼、对比度是否合适，会直接影响专注度。桌面版若只有默认主题，想切浅色/深色、改字号或微调颜色，往往要改应用本身或等官方发版。社区插件 dsh-codex-appearance 走另一条路：在 Harness 的设置里增加一页「外观」，用主题 token 与设置 section 扩展点注入一套 Codex 风格的蓝灰预设，并把常用显示选项集中到同一界面。下面介绍它是什么、能做什么，以及如何安装与使用。
这是什么¶
dsh-codex-appearance 是维护者 zhongjiadeng-cmd 发布的独立社区插件（非 Codex 或 DeepSeek 官方产品）。在 DSH 设置中增加「外观」页，以 Codex 风格蓝灰深色为预设，并支持跟随系统、浅色、深色、自定义颜色、字体与字号、侧边栏模糊、动态效果及对比度等调节。设置保存在当前桌面应用实例的本地浏览器存储中，不跨设备同步。
插件在 SkillHub 目录 中归类为「趣味换装」；源码与说明见 GitHub 仓库。
核心功能¶
README 中列出的能力均可归结为两类：预设主题与细粒度控件。
主题与色彩
- 预设：Codex 风格蓝灰深色主题。
- 模式：跟随系统、浅色、深色，以及自定义颜色相关选项。
排版与界面细节
- 字体与字号。
- 侧边栏模糊。
- 动态效果。
- 对比度。
实现方式
插件通过 Harness 的 ui-theme（主题 token）和 settings.section（设置分区）接口工作；客户端注入 @deepseek-ai/dsh-client-ui-theme、@deepseek-ai/dsh-client-ui-settings-general、@deepseek-ai/dsh-client-ui-renderer 等依赖（见 package.json 中的 dsh.client.inject 配置）。
版本与验证环境
- 插件版本：
0.1.1（MIT 许可证）。 - 维护者在 macOS 的 DeepSeek Harness
0.2.0-rc.2上验证过安装与设置界面；代码未调用操作系统专有 API，Windows 实机效果 README 标明尚待验证。
安装与启用¶
安装前请确认本机 DeepSeek Harness 版本已包含 ui-theme 与 settings.section 插件接口；插件以当前 dsh 进程权限运行，安装前建议阅读仓库源码与许可证。
1、下载发布包
从仓库 Releases 下载 dsh-codex-appearance.tgz。
2、添加到桌面配置
在包含该文件的目录下执行（Windows PowerShell 同样适用，可将路径改为下载文件的绝对路径）：
dsh plugin --profile desktop add ./dsh-codex-appearance.tgz
3、重启应用
重启 DeepSeek Harness 后，打开「设置 → 外观」进行调整。
典型用法¶
安装并重启后，用法集中在设置页，无需额外 CLI 子命令。
- 打开 DeepSeek Harness 的「设置」。
- 进入「外观」分区（由本插件注册）。
- 按需选择跟随系统 / 浅色 / 深色，或调整自定义颜色、字体、字号、侧边栏模糊、动态效果与对比度。
若同时启用多个主题类插件，README 说明：最后注册的 token 覆盖层会对同名颜色生效；当前版本的设置仅属于本机当前桌面应用实例。
卸载¶
dsh plugin --profile desktop remove dsh-codex-appearance
README 注明：此插件不修改应用安装包或签名。
适用场景与注意¶
适合谁
- 希望在 DSH 桌面版里快速切换到 Codex 风格蓝灰深色预设的用户。
- 需要在一处统一管理浅色/深色、字体、动效和对比度，而不改应用本体的人。
需要注意
- 插件在社区目录 SkillHub 上架，与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，安装社区包前应自行核对源码与 MIT 许可证。
- 设置不跨设备同步；多主题插件并存时注意 token 覆盖顺序。
- macOS 上已有验证记录，Windows 尚未在 README 中声明实机验证结果。
结尾¶
dsh-codex-appearance 把外观相关选项收进「设置 → 外观」，并以 Codex 风格蓝灰主题为默认预设，适合想微调 Harness 观感又不愿动安装包的开发者。目录页：https://www.skillhub.cn/plugins/zhongjiadeng-cmd/dsh-codex-appearance；仓库：https://github.com/zhongjiadeng-cmd/dsh-codex-appearance。
