本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-font

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:tianyhjg-lab/dsh-font

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 界面字体（改 --dsw-font-family）：正文、按钮、侧边栏、标题、菜单
• 代码字体（改 --ds-font-family-code）：代码块、终端、JSON 树、diff
• 界面字体：99 个选项，按下拉分组：默认 / 中文黑体 / 中文宋体 /
• 代码字体：31 个选项（默认 / 30 个等宽）
• 下拉选项以各自字体渲染，下方有实时预览条；选择立即全局生效

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后字体选项在哪？

打开「设置 → 常规」，最下方会多出一行「字体」。界面字体 99 选 1、代码字体 31 选 1，下拉里每条都用各自字体渲染，下方有实时预览条。

需要在本机安装字体文件吗？

需要。插件不打包、也不下载任何字体，font-family 列表只是名字。如果电脑没装所选字体，浏览器会自动 fallback 到栈里的下一项，所以选了不存在的字体也不会报错，只是看起来跟没换一样。

选择会记住吗？换浏览器或清缓存会丢吗？

选择保存在浏览器 localStorage（dsh-font:ui 与 dsh-font:code），同源刷新/重启都还在。换浏览器、清缓存或换域名后才会丢，需要重新选一次。

怎么恢复默认字体？

在设置里把界面字体和代码字体都选回「默认」即可，注入的样式会被清空，回到 DSH 内置字体。

商用时这些字体有授权问题吗？

插件本身不包含任何字体文件，但字体的使用授权（尤其商用）由用户自己确认。思源/霞鹜/更纱等 OFL/Apache 开源可再用；方正/汉仪/华文等随系统授权，商用需自行评估。

卸载怎么卸？

删掉依赖和 profile 的 bundles 注册并重启 dsh web 即可。卸载后注入的

移动端能用吗？

插件支持所有 DSH Web 客户端（包括移动端浏览器），但移动端字体会受系统字体限制，渲染效果可能与桌面端不一致。

看不到「字体」这一行怎么办？

检查是否安装到了 web profile、是否在「设置 → 常规」页面最底部，并确认 dsh web 已重启；如果仍然没有，看浏览器控制台有无模块加载报错。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则