wtksana/dsh-font-plugin

dsh-font-plugin

一个 DeepSeek Harness (dsh) 插件：为 Web UI 提供字体族和连字控制，以官方卡片样式呈现在 设置 → 插件 → 插件配置 中。

功能

- 字体族：编辑器 — 覆盖 --dsw-font-family（UI + Markdown 正文文本）
- 字体族：代码 — 覆盖 --ds-font-family-code（代码块 / 命令 / 日志）
- 字体连字 — Auto（主题默认）/ On / Off

字体族以逗号分隔的字体栈形式输入（例如 MiSans, Microsoft YaHei, sans-serif）；带引号或不带引号的名称均可，单个名称会自动加引号并附带系统回退字体。保存时会原样存储你输入的内容（即使值等于官方默认值也会写入——根据官方插件配置约定，覆盖由字段在用户层中的存在来标记）；重置会将字段恢复为主题默认值。

自 dsh 0.1.2 起，字重和字号由官方主题设置（外观）提供；本插件有意将这些留给官方界面。

默认值镜像官方 @deepseek-ai/dsh-client-ui-theme 基础样式表。更改在保存后生效，并持久化在 dsh 设置文档中（$DSH_HOME/settings.yaml，命名空间 dsh-font）。UI 文案通过官方 ctx.locale 机制本地化（zh / en）。

安装

从 npm 安装

dsh plugin --profile web add dsh-font-plugin

从 GitHub 安装

dsh plugin --profile web add github:wtksana/dsh-font-plugin

预构建的打包产物（lib/）已提交，因此安装时无需构建步骤或 prepare 授权。

本地开发

dsh plugin --profile web add ./path/to/dsh-font-plugin

然后启动 dsh（编辑打包产物后需要重启，因为客户端打包版本号在启动时计算）：

dsh --profile web

配置

在 Web UI 中打开 设置 → 插件 → 插件配置，展开 dsh-font-plugin 卡片，编辑字段并点击 保存。

或直接编辑 $DSH_HOME/settings.yaml：

dsh-font:
editorFont: MiSans
codeFont: MiSans
ligatures: auto

dsh plugin remove dsh-font-plugin 会同时卸载该包及其补丁层。

开发说明

本包是一个双面插件：

- lib/index.js — 宿主端：通过 ctx.settings.register('dsh-font', FontSettingsSchema, { applies: 'live' }) 注册 dsh-font 设置命名空间。该 schema 以 FontSettingsSchema 导出，刻意不以 Config 导出：Cordis 会用插件的 Config 导出校验行自身的配置，而带有必填字段的设置 schema 会导致该行在启动时校验失败。
- lib/client.js — 浏览器端：dsh.client 包（__ModuleLoader__.load + exports.apply）。样式标签在工厂实例化时创建，并带有 data-plugin / data-plugin-css 标记，以便客户端模块系统将其登记用于 HMR 拆除；卡片以命名空间为键注册到 settings.plugin.item，字体通过带有 !important 的 CSS 变量应用（ui-theme 基础样式表可能会在我们的样式标签之后注入）。

卡片语义遵循官方插件配置契约：字段在原始用户层中存在即视为已覆盖，重置会暂存一次清除（针对组合 base，回退到内置默认值），而保存一个等于官方默认值的值仍会存储它，而不是静默清除。内置默认值（DEFAULT_CFG、FONT_TOKENS）与宿主 schema 默认值及 ui-theme 基础样式表保持一致——当你更改默认值时，请同时更新这两部分。

客户端包修订版本在启动时计算——编辑包后请重启 dsh。

许可证

MIT