dsh-ui-font — DSH 字体插件 | DSH Font Plugin
> English: A client plugin that restyles the whole DSH UI — UI/code fonts, display scale, line-height, font smoothing, code ligatures, and a font browser with CJK glyph marking (Settings → Fonts).
> 中文: 修改整个 DSH 界面文字显示效果的客户端插件（设置 → 字体 / Fonts）。
功能
- 正文字体：预设（微软雅黑 / 苹方 / 等线 / 思源黑体 / 更纱黑体 / 思源宋体 / 霞鹜文楷 / HarmonyOS Sans / MiSans）或自定义字体栈
- 代码字体：预设（Cascadia Code / Consolas / JetBrains Mono / Fira Code / 更纱等宽 SC / Maple Mono / Maple Mono NF）或自定义
- 显示比例：80–130% 等比缩放（
zoom，默认 100% = 无变化） - 聊天区行高：1.3–2.0
- 字体平滑：抗锯齿开关
- 代码连字：
font-variant-ligatures - 字体浏览器：自定义字体时可打开子窗口，以列表形式展示本机所有已安装字体（每项用自身字形预览），点击即应用；枚举失败时自动降级为常见字体名单
- 中文字形标记：字体浏览器中无中文字形的字体带「英文」角标，选择时会提示，避免中文显示回退
- 应用反馈：应用按钮显示「已应用 ✓ / 无效输入 / ⚠ 无中文字形」，不再静默失败
- 输入框字体跟随开关：默认关闭（避免输入法组合时光标错位）；开启后输入框使用正文字体
- markdown 全覆盖：智能体回复的正文、标题、列表、表格、链接等全部跟随正文字体（代码块保持等宽字体）
- 实时预览 + 恢复默认
所有设置存浏览器 localStorage（dsh-ui-font:*），刷新保持。
架构
lib/client.js— 浏览器端：设置分类注册 + 样式注入（静态规则一次注入，之后仅更新 CSS 变量，避免高频重建）lib/index.js— 宿主端空实现（纯客户端插件）cordis.patch.yml— bundle patch：把插件注册进 loader（insert），供 dsh-client-modules 发现 client bundlepackage.json—dsh.bundle.patch+dsh.client声明
关键约定（与 DSH rc.6 匹配）
exports.inject只用["slots", "locale"]——不要声明runtime（rc.6 已无该 cordis 服务，声明会导致 pending 卡界面）- 设置分类 id：
dsh-ui-font；槽位settings.dshUiFont.item；localStorage 前缀dsh-ui-font: - 行组件 props 用展开式（
setSans/setCode/...直接作 props），不要用actions.xxx对象
安装
官方快捷安装（推荐）
使用 DSH 自带插件命令，从 GitHub 直接安装：
dsh plugin add github:linshufan21/dsh-ui-font
然后编辑 profile 的 package.json（%USERPROFILE%\.dsh\profiles\web\package.json），在 dsh.profile.bundles 追加 "dsh-ui-font"，重启 DSH（关窗口重开）→ 设置出现"字体"。
本地开发安装
cd $env:USERPROFILE\.dsh\profiles\web
pnpm add "file:E:\deepseekwork1\dsh-ui-font"
# 然后编辑 package.json 的 dsh.profile.bundles 追加 "dsh-ui-font"
# 重启 DSH（关窗口重开）→ 设置出现"字体"
> 提示：Git 托管的插件若含构建脚本，pnpm 默认阻止 prepare——需要在 profile 的 pnpm-workspace.yaml 的 allowBuilds 里放行对应包（本插件无构建脚本，无需处理）。
社区
- 官方仓库：deepseek-ai/deepseek-harness（Everything is a Plugin，可 Star / Issues / Discussions / PR）
- 插件聚合：Oh-My-DSH（DSH 插件目录，可投稿）
- 插件市场与最佳实践：dshfind
- 资源列表：awesome-deepseek-harness / awesome-dsh-plugin
开发与同步
改动 lib/client.js 后，运行同步脚本把文件复制到已安装副本并校验：
powershell -ExecutionPolicy Bypass -File E:\deepseekwork1\_工具脚本\sync-dsh-ui-font.ps1
然后 DSH 窗口 Ctrl+F5 强刷（bundle rev 动态计算，无需重启后端）。
已知限制
- 开启「输入框字体跟随」后，中文输入法组合阶段（拼音未确认）可能因 Chromium 内核限制出现光标错位——默认关闭即可避免，正文显示不受影响
zoom（显示比例）仅在非 100% 时应用，默认不注入，不影响默认状态- 代码区选择器依赖 hash 类名（
_codeBlock等），DSH 大版本升级后可能失效（正文仍生效） - 字体枚举优先使用浏览器 Local Font Access API；若宿主拒绝权限则降级为内置常见字体名单探测，此时新安装的字体可能不出现，可直接手动输入字体名
- 自定义字体栈已做防注入过滤（拒绝
; { } ( ) < >、限长 300）
许可 / License
- English: This project is licensed under the MIT License — free to use, modify and distribute, including commercial use, provided the copyright notice is retained.
- 中文: 本项目基于 MIT 许可证 开源——允许自由使用、修改、分发（含商用），需保留版权声明。
卸载
cd $env:USERPROFILE\.dsh\profiles\web
pnpm remove dsh-ui-font # 并手动从 package.json bundles 移除
