请求官方增加字体修改功能，能修改UI和对话内容的字体

[wtksana]

之前自己写了个字体修改的插件，但是还是希望官方能支持，就像vscode里的字体修改功能

[YOUKNOWWHOOO]

补充一个数据点，方向与 #8179 相同，依次给出设置对象、注入点与字体族常量三处代码级的依据。

同题检索

我先检索了讨论区（2026-09-30，检索词覆盖：字体、字号、字体族、字型、界面字体、代码字体、字体自定义、字体选项、外观设置、主题设置、font、font family、fontFamily、Monospace、typeface、UI 字体），与本诉求相关的串如下。

串	标题	与本次反馈的关系
#8179	请求官方增加字体修改功能，能修改 UI 和对话内容的字体	本诉求的同题串，0 条评论。本条在此追加
#7769	Zoom the whole client UI with ⌘+ / ⌘-	同为客户端排版可配置性，范围是整界面缩放；串内已有一条来自桌面端 macOS arm64 0.2.0-rc.2 的数据点，其结论是字号设置只写 --dsh-content-font-size
#7937	桌面端 ⌘+ / ⌘- / ⌘0 缩放不可用	桌面壳没有 View 菜单，属另一条通道
#8283	macOS 客户端界面字体过小	用户侧现象
#7739	第三方字体插件	插件作品，不是官方配置面
#7482	侧栏终端 Nerd Font 图标显示为方块	终端渲染器的另一个 fontFamily 参数，另一条代码路径
#6269	启用带连字的字体后输入框开头字符不显示	用户样式覆盖后的渲染问题，另一条路径

我检索到的评论里没有一条落在「字体族」这一层，也没有看到对两端运行时上的同一个客户端包做过逐字节比对。以下是这次的主要增量，我尽量分清哪些是回读结论、哪些没有验证。

环境

• 操作系统 Windows 11 家庭版 中文版 25H2，版本 10.0.26200，内部版本 26200.8246，x64
• 处理器 Intel Core Ultra 5 336H（12 核），内存 31.5 GB
• 区域与语言 zh-CN，时区 China Standard Time
• Node.js v26.9.0、npm 12.0.2（fnm 1.39.0 管理）、PowerShell 7.6.6
• @deepseek-ai/dsh 0.2.0-rc.2，经 npx @deepseek-ai/dsh web 启动，Web UI 监听 127.0.0.1:3080；npm dist-tags 的 latest 与 next 当日均为 0.2.0-rc.2
• profile 为 web，bundles 为 @deepseek-ai/dsh-base + @deepseek-ai/dsh-web-app
• 官方桌面端 DeepSeek Harness 0.2.0-rc.2，per-user 安装，host 自身 profile 为 desktop，默认监听 127.0.0.1:19387（观测时桌面端未运行，安装与版本取自安装目录与卸载注册项）
• 桌面端自带运行时版本：resources/runtime/versions.json 为 Node 24.18.1、pnpm 11.7.0；resources/runtime/primary-runtime/runtime.json 为 Node 24.21.0、pnpm 11.7.0、Python 3.12.14
• 界面为 dsh Web UI 与桌面端；浏览器为 Chromium 内核浏览器
• 本机三个补丁层（$DSH_HOME/cordis.patch.yml、$DSH_HOME/profiles/web/cordis.patch.yml、$DSH_HOME/profiles/desktop/cordis.patch.yml）全都不含 ui-theme 行，因此下面的取值就是包默认值

现象

在 Web UI 与桌面端的设置里，能改的排版项只有会话内容的字号（10 至 22 px）。它的说明文字自述「仅影响会话内容的字号」。界面自身的字体（字体族）没有任何配置入口：Web UI 与桌面端用的是同一套前端产物，两端的「通用」分区里都只有「外观」与「字号大小」两行。

证据（发布产物逐行回读，0.2.0-rc.2）

设置侧的 Config 是闭集，只有两个键

dsh-client-ui-theme/lib/index.js：

• :11 THEME_SETTINGS_NAMESPACE = "ui-theme"
• :13 THEME_PREFERENCE_FIELD = "preference"、:15 FONT_SIZE_FIELD = "fontSize"
• :19 至 :23 FONT_SIZE_MIN = 10、FONT_SIZE_MAX = 22、DEFAULT_FONT_SIZE = 14
• :80-83 的 Config 只声明两个字段：

const Config = z.object({
  preference: z.union([...THEME_PREFERENCES]).default(DEFAULT_PREFERENCE).volatile(),
  fontSize: z.number().step(1).min(10).max(22).default(14).volatile()
});

没有字体族字段。有效的配置面上因此不存在接收字体族的字段。

唯一的排版注入点只写字号

同文件 :47-57 的 bootThemeBodyScript() 是唯一的排版注入点，其中的设置语句是：

document.body.style.setProperty('--dsh-content-font-size', ${JSON.stringify(`${fontSize}px`)})

它出现在 :92-94 的 webserver/index-inject 里，作用是把首帧画出来之前就套用所选字号。除字号之外，它不改任何排版属性。

字体族是客户端产物里的硬编码常量

dsh-client-ui-theme/lib/client.js:1142 的 base 样式表定义了两个界面字体族常量：

--dsw-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "Helvetica Neue", Helvetica, Arial, sans-serif;
--dsw-font-family-brand: "Montserrat", var(--dsw-font-family);
--ds-font-family-code: "SF Mono", "JetBrains Mono", "Fira Code", Consolas, "Liberation Mono", Menlo, Courier, "PingFang SC", "Microsoft YaHei";

同一次发布里，普通界面文字以 var(--dsw-font-family) 取值、代码块以 var(--ds-font-family-code) 取值，因此这两个常量就是普通界面文字的字体来源。用户可以改的只有 --dsh-content-font-size 一个变量。

全树检索：不存在任何字体族配置键

• 在 @deepseek-ai 作用域的全部包内检索属性名 fontFamily 与 fontFamilyStack，命中只有一处，是 libreoffice-kit/lib/types/fonts.d.ts:75 的 fontFamilyPriority()，与客户端界面无关。
• 同一作用域的包内置文案检索 字体族、字体 与 Font Family，命中里与界面设置相关的只有 字号大小 及其说明「仅影响会话内容的字号」。

插件侧有 token 覆盖通道，因此「不可改」这一说法不成立，成立的是「用户不能改」

这条不是本次反馈的缺陷主张，而是必须一并说清的另一面：界面字体族并非技术上不可改。同一包在客户端提供 ThemeRuntime 服务，它有两个入口：

• register(definition) 注册带别名 token 覆盖的主题（lib/types/client/index.d.ts:161，实现在 lib/client.js:1446）；
• overrideTokens(source, tokens) 在活动主题之上叠加一层 token 覆盖，参数形状是「token 名 → { light, dark } 值对」（lib/types/client/index.d.ts:178，实现在 lib/client.js:1474，取值的运行时校验在 validateOverrides）。

也就是说，插件可以把 --dsw-font-family 与 --ds-font-family-code 作为 token 名传进去，这一点对 token 名没有白名单限制。真正的缺口是：这是一条需要写代码、且要随包发布的通道，用户手上没有任何配置项能改字体族。 讨论区已有插件把换字体做成了自己的设置面（#7739 提供正文字体与代码字体两行并明确以「字体族不可配」为出发点；#8318 列出了「换掉一板一眼的字体」并声明 Web 与 Desktop 共用同一条客户端插件管线）。这既说明需求存在，也说明上游缺的是把它变成产品自带设置的那一步。

两端用的是同一个包，字体族缺口对两端一致

比对官方桌面端 resources/app.asar 内的 dsh/node_modules/@deepseek-ai/dsh-client-ui-theme 与 CLI 侧 npx 安装树里的同名包：

文件	桌面端	CLI 侧	逐字节相等
lib/index.js	4227 B，sha256 2bbd6d5f2c0f44776185ad555b13afe920de9e7f9ea27ddc6a04a5fd8d25b433	同字节数、同 sha256	是
lib/styles/brand-font.css	554 B，sha256 d0733ee69620e686561800ac788e54fc0bb9e02af5294c8b6f74c109132210cf	同字节数、同 sha256	是
lib/client.js	101729 B	101885 B	否
package.json	2206 B	2280 B	否

lib/index.js 逐字节相同，说明上面那条 Config 闭集在两端是同一份实现，不是某一条运行时各自的问题。

两个不相等的文件差异与本次主张无关，但如实写出来：lib/client.js 的差异只在构建时嵌入的源码路径（桌面端为 /home/runner/work/…）与 CSS Modules 生成的类名哈希（_8HJdBW_ 对 v01cdW_ 等），逻辑代码逐行相同；package.json 的差异是 devDependencies 的排序与 scripts 字段在打包时被裁掉。

影响

1. 用户侧没有字体族配置项。 字号能放大，但字体族不变；代码块与正文的等宽字体同样固定，界面文字的字体栈无法在设置里改。
2. 缺的是用户可配置的入口，不是修改通道。 ui-theme 命名空间下只有 preference 与 fontSize 两个字段，界面字体族在源码里是常量的默认值；插件侧的 token 覆盖层确实存在（见上），但那是写代码的通道，普通用户在设置里做不到。因此现状是：用户能在界面上改的排版项只有字号一项。
3. 跨平台一致性。 内置字体栈里中文只列了 PingFang SC、Hiragino Sans GB、Microsoft YaHei 三种；其它平台的用户同样没有调整入口。
4. 这与 [Feature] Zoom the whole client UI with ⌘+ / ⌘- #7769、MacOS client - possible to make the UI font bigger? its tiny #8283 是同一类缺口的不同面。 那两条落在「字号 / 整界面缩放」，本条落在「字体族」。三者的共同点是：客户端排版里只有字号存在用户配置面。

建议

为 Web UI 与官方桌面端都加入字体设置。 两端运行的是同一份前端产物（上表），因此一份实现可以同时覆盖两端，不需要分别做。

具体建议：

1. 在 ui-theme 命名空间下增加字体族键，分别作用于界面文字与代码文字（例如 fontFamily 与 monospaceFontFamily），与既有的 preference、fontSize 同一处，取值写进当前 profile 的 cordis.patch.yml。
2. 默认值取当前内置的两条字体栈，使不改动的部署行为完全不变。留空或 system 时回退到内置栈。
3. 通道建议复用插件侧已有的那套：把取值经 ctx.theme 的 token 覆盖层写入（overrideTokens 已支持按 token 名覆盖任意 --dsw-* 变量），从而与第三方主题走同一条合成路径，而不是新增一套 CSS 注入。
4. 在设置里的「通用」分区增加对应的输入行，位置与「字号大小」一致（当前 ui-theme 已在该分区注册「外观」与「字号大小」两行）。
5. 若为控制改动面，先只做界面字体族一项、代码字体族维持内置栈，也是完整的一步。

这样做的直接收益是：现在要靠第三方插件才能得到的「正文字体 / 代码字体」两个设置行变成产品自带，且取值由官方 schema 校验、随设置一起持久化。

复现

1. 在 Web UI 或桌面端打开设置，进入「通用」分区：可见「外观」与「字号大小」两行，没有字体相关行。
2. 在安装树里读 ui-theme 的 Config（dsh-client-ui-theme/lib/index.js:80-83）：只有 preference 与 fontSize 两个字段。
3. 在安装树里检索 --dsw-font-family 与 --ds-font-family-code：定义只出现在包内内联的样式表里；插件侧可经 ctx.theme.overrideTokens() 覆盖它们，但用户侧没有任何配置键。

未验证

1. 我没有在运行中的客户端上实测「插件经 ctx.theme.overrideTokens() 覆盖 --dsw-font-family 后界面字体的实际变化」，该通道的可用性判定来自它的参数形状与运行时校验（lib/types/client/index.d.ts:178、lib/client.js:1474），没有取得运行期读数。
2. 我没有实测「往配置面写入一个字体族键会被如何处置」（忽略、报错或落到未知键），该判定只基于「Config 只声明两个字段」与「全树检索没有字体族键」这两个源码事实。
3. 桌面端的结论全部来自对安装目录与 resources/app.asar 的只读回读，观测时桌面端未运行，因此没有桌面端的运行期读数。

[dsh-community-assistant[bot]]

已收到这条反馈。

[Jarvis-Baba]

同一诉求的另一面补充（字数从简，避免分散）：

我在 #8355 追加了一份 0.2.0-rc.2 Windows 桌面端的数据点，与「界面文字过小 / 只能改会话内容字号」直接相关，其中包含：

• 「字号大小」已放宽到 10..22px，但它只写 --dsh-content-font-size，界面文字走 11/12/13/14px 的固定 token，拉满 22px 也够不到那一层；
• 客户端 ui-theme 的配置 schema 是只有 preference 与 fontSize 两个键的闭集，且产物中没有 custom.css / user.css / customCss 机制——用户侧不存在配置层绕过。

字体族（本串）与字号 / 整界面缩放（#8355、#7769）是同一类缺口的不同面，建议合并评估。