本地字体选择器 Wepoi9/dsh-local-font-picker

dsh-local-font-picker

这是 DeepSeek Harness（DSH）Web UI 的社区插件，让你为界面和代码区域挑选本机已安装的字体。

这是社区维护的插件，不属于 DeepSeek Harness 核心发行版。

它能做什么

- 通过 Local Font Access API（window.queryLocalFonts()）列出本机已安装的字体。
- 借助 DSH Theme 和 Slot API，分别设置界面字体和代码字体。
- 只在浏览器 localStorage 里保存选中的字体族名称。
- Local Font Access API 不可用时，回退到手动输入字体名。
- 无需改动 DSH 源码树，也没有插件构建步骤。

宿主入口（index.js）刻意留空。所有行为都在 Web 客户端里运行。

兼容性

最新测试过的 DSH 版本：0.2.1-alpha.1。

| DSH 版本 | 验证情况 |
| 0.1.6-alpha.2 | 已验证 Slot/Theme 契约兼容性、卸载/重载清理、已保存设置的恢复 |
| 0.1.7-alpha.2 | 已验证插件加载、清单可见性、字体应用 |
| 0.1.7-rc.1 | 已验证插件加载、清单可见性、字体应用 |
| 0.1.7-rc.2 | 已验证插件加载、清单可见性、字体应用 |
| 0.2.0-rc.1 | 已验证插件加载、清单可见性、字体应用 |
| 0.2.0-rc.2 | 已验证插件加载、清单可见性、字体应用 |
| 0.2.1-alpha.1 | 已验证插件加载、清单可见性、字体应用；2026-10-07 针对当时的 main 566a1b7 重新做了 E2E 验证：插件干净加载、Settings 各行可见、控制台零报错、授予本地字体权限后列出 107 个 PC 字体、界面字体和代码字体应用并在重载后恢复、重置为默认值也已验证 |

更新的 DSH 版本在验证之前，不假定兼容。

安装

把本仓库的本地检出添加到目标 DSH 配置档：

dsh plugin --profile web add <absolute-path-to-this-repository>

安装后重启 DSH Web。

用法

打开 Settings → General → Fonts。

- 用 Load PC fonts 请求访问浏览器的本地字体列表。
- 为界面字体和代码字体选择或输入已安装的字体族。
- 用 Reset to default 清除覆盖项和已保存的选择。

按钮和状态标签跟随上文所述的文案语言：英文列表显示 Load PC fonts，日文显示 PCフォントを読み込む，该行其余部分同理。

文案语言跟随浏览器的首选语言，而不是 DSH 的 Language 设置。第一个可用的偏好决定结果：ja 渲染日文，其他一律渲染英文。

隐私与权限

使用 Load PC fonts 会调用浏览器 Local Font Access API，可能弹出权限提示。授予权限后，浏览器可以把已安装字体的元数据暴露给本页面。

本插件：

- 不读取也不复制字体文件；
- 不上传字体数据；
- 不会发起网络请求；
- 只在 localStorage 里保存选中的字体族名称，作用范围限于当前浏览器源。

限制

- Local Font Access 主要在基于 Chromium 的桌面浏览器上可用。其他浏览器仍可手动输入字体名称。
- 设置按浏览器源分别存储。
- DSH 仍在快速演进，所以客户端扩展契约可能在不同预发布版本之间变化。
- 复制语言在行模块加载时一次性确定。更改浏览器的首选语言，要等下次页面重新加载才生效。

检查

npm run check

贡献

欢迎提交 bug 报告和聚焦的 pull request。报告兼容性问题时，请附上 DSH 版本、浏览器、操作系统、复现步骤，以及预期行为和实际行为。

许可证

MIT。见 LICENSE。