dsh-custom-font

DSH自定义字体插件

dsh-custom-font

一个 DeepSeek Harness（DSH）插件：像 Word 一样，在设置页里直观地修改界面文字的 字体 / 字号 / 加粗 / 颜色 / 版式，改动即时生效（所见即所得）并自动保存。

A DeepSeek Harness plugin for customizing fonts, sizes, weights, colors and layout — Word-style, WYSIWYG, auto-saved.

自带两套开源字体（STIX2Text、Latin Modern Mono Light），并内置一套作者推荐的排版， 装上就能看到效果——不需要你先去装字体，也不会改动你的系统。

功能特性

• ✅ 像 Word 一样改：选字体、改字号、调加粗、选颜色，改动立刻应用到整个界面
• ✅ 自动读取 Windows 已装字体库（200+ 个字体自动进下拉框，可一键刷新）
• ✅ 中英文分开设置：中文字体管汉字，西文字体管英文与数字（正文、标题各一套）
• ✅ 插件内置字体：自带 STIX2Text 与 Latin Modern Mono Light，任何电脑上效果一致； 不写注册表、不需要管理员权限，可在高级设置里关闭
• ✅ 一键「应用作者推荐」：一套现成的公文/学术观感排版（见下）
• ✅ 版式可调（高级设置）：正文两端对齐、一级标题居中 / 不加粗、引用块斜体 + 左侧竖线、 行内代码灰底、表头深底浅字、链接颜色
• ✅ 分三类基础设置：正文 / 标题 / 代码
• ✅ 高级设置（可展开）：h1~h6 逐级自定义，引用 / 行内代码 / 代码块 / 界面文字逐项可调
• ✅ 设置存在 ~/.dsh：换桌面外壳不会丢，还能导出 / 导入
• ✅ 深色模式下正文色自动不生效，链接自动换成亮蓝，避免看不清
• ✅ 一键恢复默认值

安装

npx @deepseek-ai/dsh plugin --profile web add dsh-custom-font

web 换成你实际使用的 profile 名。桌面版与 dsh web 网页版都可用。

使用

1. 打开 DeepSeek Harness → 设置 → 左侧 「自定义字体」
2. 基础页三栏：正文（中文字体 / 西文字体 / 字号 / 加粗 / 颜色）、标题、代码
3. 想改细节就点 「高级设置」：
   • h1~h6 逐级自定义（勾选后独立设置，不勾选则继承上面的「标题」）
   • 内置字体开关与当前状态
   • 版式：两端对齐、一级标题居中/不加粗、引用竖线、行内灰底、表头深底浅字、链接颜色
   • 其他格式：引用 / 行内代码 / 代码块 / 界面文字
4. 改完即时生效、自动保存。设置文件在 ~/.dsh/dsh-custom-font/settings.json， 也可以点「导出设置」「导入设置」备份或搬到别的机器。

作者推荐

插件内置一套作者推荐的排版（是推荐，不是规定——任何一项都可以改掉）：

元素	设置
正文	西文 STIX2Text + 中文 仿宋_GB2312（回落仿宋） / 16px / 常规 / 纯黑 / 两端对齐
一级标题 #	方正小标宋简体 / 22px / 不加粗 / 居中
二级标题 ##	黑体 / 18px / 900
三级标题 ###	楷体_GB2312 / 18px / 900
四~六级标题	仿宋_GB2312 / 18px / 900
代码	Latin Modern Mono Light / 行内 14px 带灰底
引用块	继承正文 / 斜体 / 左侧 2px 竖线 #a2a9b1
链接	DeepSeek 蓝 #4D6BFE（悬停 #2E4FD8；深色模式自动换亮蓝）
表格	表头黑体 700 / 深底浅字 #575c61 / 边框 #a2a9b1

点设置页的「应用作者推荐」即可一次写好；改乱之后也可以用它复位。

关于数字：数字与英文一样，跟随你选的西文字体（字体栈里西文排在中文之前）。 中文字体本身也含数字字形，所以顺序反了数字会悄悄变成中文样式——插件保证了这个顺序。

字体从哪来

插件内置以下两套开源字体（共 7 个 WOFF 文件，约 820 KB），随插件一起分发：

字体	用途	许可证
STIX Two Text（4 个字重）	作者推荐的西文正文字体	SIL Open Font License 1.1
Latin Modern Mono Light（3 个字重）	作者推荐的代码字体	GUST Font License

许可证原文与说明见 assets/fonts/LICENSE-FONTS.md。 字体文件只在需要时由本地宿主端返回给浏览器，不联网下载。

想让自己系统里也装上这两套字体（给 Word、Obsidian 等其他软件用）： 可以把 assets/fonts/ 下的 WOFF 转成 TTF/OTF 后安装；插件本身不需要这一步。

工作原理（给开发者）

• 宿主端 lib/index.js
  • GET /dsh-custom-font/fonts：用 PowerShell（.NET InstalledFontCollection）读取 Windows 已装字体， 返回「中文名 + 英文名」清单（内存缓存，?refresh=1 强制重读）
  • GET/POST /dsh-custom-font/settings：读写设置文件，写入按类型白名单过滤，先写临时文件再改名（原子写入）
  • GET /dsh-custom-font/settings/export：导出设置文件原文
  • GET /dsh-custom-font/font-manifest、GET /dsh-custom-font/font-asset?name=…：内置字体清单与文件本体 （文件名走白名单校验，防目录穿越）
• 客户端 client/client.js
  • 注册一个 settings.section 设置页
  • 按当前设置生成一个 <style>（!important 作用于 p / h1~h6 / code / blockquote / a / table 等， 并写 --dsw-font-* 变量）——样式内容变化时会替换，避免升级后新样式不生效
  • 字体入口同时写 :root 与 body：2026-10 版 harness 在 body 上重新合成 --dsw-font-family / --ds-font-family-code（body 级会盖掉 :root 级），并把官方自定义入口改为 --dsh-font-family-text / --dsh-font-family-code。插件在 body 上带 !important 写这两组变量 （压过主题系统写进 body 内联样式的声明），:root 上的老入口保留给旧版本
  • 内置字体以 @font-face + blob URL 注入，font-display: swap
  • 启动时优先读宿主设置文件；读到旧版 localStorage 里的设置会自动迁移上去
• 设置文件：~/.dsh/dsh-custom-font/settings.json（$DSH_HOME 优先）。 为什么不放浏览器 localStorage：它按「外壳应用数据目录 + 访问源」隔离，换一个桌面外壳就丢一次。

常见问题

问：字体下拉框里没有某个字体，直接输入字体名行吗？ 下拉框取自你系统已装的字体。想用没装的字体，可以选一个字体后手动改设置文件里的名字， 但浏览器会回退到后备字体——这正是插件要把两套推荐字体内置进来的原因。

问：为什么正文数字的字形跟中文不一样？ 这是设计如此：数字跟随西文字体（作者推荐里是 STIX2Text）。

问：改了设置换台电脑就没了？ 设置跟着 ~/.dsh 走，不跟着外壳走。换电脑请用「导出设置 / 导入设置」。

问：我不喜欢这套排版。 基础页逐项改即可；「应用作者推荐」只是把推荐值批量写进去的快捷方式，随时可以再改。

目录结构

dsh-custom-font/
├── package.json          # 插件元信息 + dsh 声明
├── cordis.patch.yml      # 插入 profile 的补丁
├── lib/
│   ├── index.js          # 宿主端：字体库 / 设置 / 字体资源 接口
│   ├── config.js         # 设置文件读写（原子写入 + 类型白名单）
│   └── fonts.js          # 内置字体清单与文件读取
├── client/client.js      # 客户端：设置页 UI + 样式生成
├── assets/fonts/         # 内置字体（WOFF）+ 许可证说明
├── test/                 # 自检（清单 / 宿主端 / 客户端）
└── CHANGELOG.md

自检

npm test

三套用例：清单一致性、宿主端接口与设置文件、客户端样式生成与设置链路。 其中包含对作者推荐排版逐条的断言、目录穿越拒绝、以及"数字跟随西文"的字体栈顺序断言。

License

插件代码：MIT。 内置字体：各自的开源许可证，见 assets/fonts/LICENSE-FONTS.md。