前言¶
在 DSH（DeepSeek Harness）里配好多个模型之后，你往往还需要一种可复现的方式对比它们：同一套挑战、同一套参考库、输出可对照的排名，而不是凭单次对话印象下结论。把检测逻辑塞进独立脚本，又要自己管 API Key、provider 和流式调用，和 DSH 里已有的模型配置容易脱节。
下面介绍社区插件 dsh-fingerprint（维护者 Practice019，分类为模型推理）。它在 DSH Web UI 左侧栏增加「指纹检测」整页：勾选你已配置的模型、设定轮次，通过 lmfpd-sdk 跑 LM Fingerpoint Detection，得到相对参考库的封闭排名表。模型调用走宿主侧的 ctx.llm.stream()，前端只做 UI 与 fetch，不新增 provider、不改你的 settings。
这是什么¶
dsh-fingerprint 是 DSH 插件，包版本 0.1.0，许可证 MIT。仓库：Practice019/dsh-fingerprint；社区目录页：SkillHub 条目（独立社区站点，与 DeepSeek / 幻方无官方从属关系）。
给已经安装 DSH 且至少配置了一个模型的用户使用。装好后左侧栏多一行「指纹检测」，点开即可选模型、跑若干轮「指纹挑战」、查看排名。
核心功能¶
- 模型选择与轮次：在面板里勾选已在 DSH 中配置好的模型，设置检测轮次后启动任务。
- LM 指纹检测：检测逻辑依赖运行时包 lmfpd-sdk（
package.json中为^0.2.0），执行 LM Fingerpoint Detection。 - 排名结果：完成后展示模型在参考库语境下的排名表。
- 安全与配置边界：明文 API Key 仅在宿主侧解析；任意 DSH 已配模型均可参与，无需把凭据交给插件前端。
首次运行需从网络下载约 3.6 MB 参考数据（Windows 上缓存路径为 %LOCALAPPDATA%\lmfpd\data.bin）。仓库自述测试状态：tests: 188 passing，selfcheck: 29 checks。
安装与启用¶
环境与版本¶
| 项 | 要求 |
|---|---|
| DSH | engines.dsh：>=0.2.1-rc.2 <0.3.0-0（以插件 package.json 为准） |
| Node.js | >= 22 |
| 账号 | 无额外要求，使用你已在 DSH 中配置好的模型 |
若启动时出现跳过本插件或 pluginCompatibilityWarning，说明当前 DSH 版本不在上述范围内。README 建议优先升级 DSH 到兼容的 0.2.x 线，而不是把「版本豁免」当作常规步骤；仅在确实被拒绝加载且你明确接受风险时，才考虑 dsh plugin … allow-version（命令细节见仓库 README）。
依赖（本地克隆或开发时）¶
仓库不包含 node_modules/，在插件目录内需要先安装依赖，否则 node --test 会因找不到 lmfpd-sdk 失败：
cd <plugin-dir>
npm install
推荐：由 DSH 安装插件¶
dsh plugin --profile <profile> add github:Practice019/dsh-fingerprint
<profile> 为你的 profile 名（例如 web 或自定义 profile）。该命令会把包写入 profile 的 dsh.profile.bundles，无需手改 profile 列表。
desktop profile 特例：普通 dsh CLI 会拒绝管理 desktop profile（由 Electron 应用独占）。在桌面版上首选在应用内 Web UI → 侧栏「插件」页安装；若用 CLI，须使用应用随附的 dsh.cmd（路径为安装目录下 resources\runtime\cli\bin\dsh.cmd），并先完全退出应用。README 注明勿误用 resources\app\runtime\... 下的 junction 路径。
通过 dsh plugin add 安装时，pnpm 通常会顺带解析依赖；若装完后仍报缺少 lmfpd-sdk，在插件安装目录手动执行一次 npm install。
装完后可改一次 profile 的 cordis.patch.yml（或重启 DSH）以触发重新组合。验证挂载可运行（在插件源码目录）：
node tools/selfcheck.mjs
全 PASS 时退出码为 0。
典型用法¶
- 确认 DSH 中已配置至少一个可用模型。
- 安装并启用 dsh-fingerprint（见上一节）。
- 打开 DSH Web UI，在左侧栏进入 「指纹检测」。
- 勾选要参与检测的模型，设置轮次，启动检测。
- 等待任务完成（首次运行会下载参考数据），在页面查看排名表。
具体 UI 字段与中断/接回行为以你安装的插件版本为准；实现上所有 LLM 调用经宿主 ctx.llm.stream() 完成，与你在 DSH 里已有的模型配置一致。
适用场景与注意¶
适合：已在 DSH 里维护多模型配置、需要用同一套 lmfpd 参考库做横向对比的开发者或评测场景。
注意：
- 插件在当前 DSH 进程的权限与环境下运行；安装前请自行查看源码与 MIT 许可证，确认可接受依赖与网络行为（含首次下载参考数据）。
- DSH 生态理念是「一切皆插件」；本插件不修改你的 provider 凭据存储方式，但也不替代你对第三方包 lmfpd-sdk 的审阅。
- 仅支持 README /
package.json声明的 DSH 0.2.x 代（含-rc），0.3.x 及以上不在engines.dsh放行范围内，需等待插件更新或按 README 谨慎处理兼容性。
结尾¶
dsh-fingerprint 把 LM 指纹检测收进 DSH 侧栏：复用已有模型配置、宿主侧调用、输出排名表，避免另起一套 Key 与 provider 管理。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库 的 README（含 desktop 安装、本地 junction 开发装法与自检命令）。
