dsh-font-probe:在 DSH 设置里调字体与排版,不改 app.asar

前言

DeepSeek Harness(DSH)的 Web 界面默认字体和排版能力有限:官方「设置 → 通用 → 外观」里可以选配色、输入字体族名,并从 v0.2.1-alpha.2 起提供正文字号、代码字号与终端字号;但字体仍主要靠手输名称,也没有字重以及字距、行距等细调。常见变通是改 app.asar 里的 CSS,那是应用本体,每次升级都会被覆盖,改坏了也不易还原。

下面介绍社区插件 dsh-font-probe(维护者 lohana20061023-29):通过 Cordis 客户端插件通道,用 styles.insert() 注入样式、只覆盖 CSS 自定义属性,配置写回 profile,不动 app.asar。在 SkillHub 目录中归类为「趣味换装」,GitHub 约 19 stars(MIT 许可)。

这是什么

dsh-font-probe 是给 DSH Web GUI 用的字体与排版插件:中英文字体分设、界面与标题字重可调、字距/行距/段距/首行缩进四根滑块,底部吸底总预览,确认后才落盘。

字号由官方「通用 → 外观」统一管理:本插件不写 --dsh-content-font-size,不覆盖正文字号与代码字号。若你只需要字重和排版、字体字号已由官方管,同一作者还提供 dsh-font-probe-lite,命名空间不同,可与主包共存。

核心功能

能力 说明
中文字体 汉字独立设族名;点名称可展开预设,其它族可走「浏览本机字体…」
英文字体 只作用于拉丁字母与数字,汉字仍用中文字体;留空则不区分
代码字体 代码块、终端、行号等宽字体,可浏览本机字体
界面字重 / 标题字重 同一行左右并排;标题留空则跟随界面
字距 滑块 0–3px
行距 滑块 0–12px,在应用自身行高之上叠加,不是替换
段距 滑块 0–24px
首行缩进 滑块 0–4em,随字号缩放
总预览 吸底卡片实时预览字体、字重、四项排版与代码样张(含标题);上缘可拖高度 80–560px
确认制 改动先进草稿,点「确认应用」才写入 profile
恢复默认 一键清空草稿(仍需确认才生效)

预设列表内置 15 条字体(含 8 条中文,如霞鹜文楷系列、月星楷等);展开预设时会检测本机是否安装,缺失项可链到官方下载页。全部入口在 设置 → 文字显示设置。

安装与启用

一条命令从 npm 安装,不需要 git:

dsh plugin --profile desktop add dsh-font-probe

装完后需要重启应用(托盘右键 → 退出应用 → 重新打开)。插件是 host + client 双半体,首次安装后 host 的配置 schema 需由模块加载器导入一次,侧栏「设置」里才会出现「文字显示设置」。

更新与卸载:

dsh plugin --profile desktop update dsh-font-probe
dsh plugin --profile desktop remove dsh-font-probe

卸载后注入的样式表移除,界面字体回到应用默认。其它方式(GitHub 源码、Release tarball、本地目录)见仓库 README,本文不展开。

轻量版(仅字重 + 排版):

dsh plugin --profile desktop add dsh-font-probe-lite

典型用法

  1. 打开 设置 → 文字显示设置。
  2. 选中文字体、英文字体、代码字体,设界面/标题字重,拖动四根滑块调排版。
  3. 看底部总预览是否符合预期。
  4. 满意后点 确认应用。

未点确认前,界面、CSS 变量与 profile 都不会变,可反复试。正文字号、代码字号、终端字号仍在 设置 → 通用 → 外观 调整。

原理简述

插件主要做两件事:注入 CSS 自定义属性,并在单一样式表里写少量规则。

正文字体令牌 --dsw-font-family 合成为:"英文字体", "中文字体", <应用自带栈>。栈按字符回退:拉丁在英文字体命中,汉字落到中文字体;顺序不能颠倒,否则中文字体自带的拉丁字形会让英文字体轮不到。

排版四项只作用于带 _markdown 的类名区域,不碰设置面板自身文字。行距使用 calc 在官方行高之上叠加增量,因此在官方改字号时行高仍会随字号变化。

适用场景与注意

适合谁:长期在 DSH 桌面版或 dsh web 里读对话、写 Markdown,希望中英分字体、调字重与段落排版,又不想动 app.asar 的用户。

限制(来自官方文档):

  • 只影响 Web GUI,不含 Native 窗口/菜单字体。
  • 排版滑块主要作用于对话正文,不改侧栏、按钮等界面文字。
  • 「浏览本机字体」依赖 Chromium 的 Local Font Access API;不支持时退回预设列表。
  • 字体须本机已安装,插件不捆绑字体文件。
  • 部分字体只有单一字重,选中后整体可能偏粗,属字体本身性质。

安全与许可:插件以当前 DSH 进程权限运行,安装前建议浏览 GitHub 源码 与 MIT 许可证。DSH 社区插件目录(如 SkillHub)为独立站点,与 DeepSeek / 幻方无官方从属关系;生态理念是「一切皆插件」,按需选用即可。

结尾

dsh-font-probe 把字体族、字重和四项排版收进设置页,用确认制和 profile 持久化,避免为换字体去改应用包体。目录页:https://www.skillhub.cn/plugins/lohana20061023-29/dsh-font-probe;仓库:https://github.com/lohana20061023-29/dsh-font-probe。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye