dsh-model-info-hint
一个 DeepSeek Harness（DSH）插件：在 Web GUI 的模型选择器里，只要把鼠标光标悬停在某个待选模型上，就会在该模型旁弹出一个提示，展示该模型的详细配置信息——可接收的输入类型（text、image 等）、上下文窗口、最大输出 tokens、推理级别，以及所属服务商的协议（api）、baseURL 与认证环境变量名（apiKeyEnv）。
配置信息来源于用户的 settings 文档（默认 ~/.dsh/settings.yaml，或 $DSH_HOME/settings.yaml），通过 DSH 自带的 settings 服务读取——因此自动支持 $DSH_HOME 覆盖、热加载以及 .yaml/.json 两种格式。
英文版见 README.en.md。
效果
悬停模型显示详细配置提示
提示框按自身实测尺寸定位，与整个模型选择面板（含顶部搜索框）始终保持 14px 固定间距，
不会遮挡搜索框，也不会遮挡任何模型行：
提示框与模型选择面板保持 14px 固定间距
工作原理
插件分两半，模式与 dsh-archived-conversation 一致：
- Host 侧（
lib/index.js）：注入 settings 与 webServer 服务，注册同源 JSON 接口
GET /model-info-hint/api/models，一次性返回 settings 文档中所有模型的完整配置，
以 (provider 显示名, model 显示名) 作为查找键。
- 浏览器侧（
lib/client.js）：监听全局 mouseover。当鼠标悬停在模型选择器的某个
模型项上时（同时支持输入框的模型按钮菜单和 /model 弹窗），按该模型项的可见文本在映射中
查到配置，并在光标旁渲染一个非阻塞的详细提示。
settings 文档中模型路由的典型结构（llm-pi-ai 命名空间）：
llm-pi-ai:
providers:
my-provider:
displayName: 我的服务商 # 可选：默认用 key 作为显示名
api: openai-completions # 可选：线路协议
baseURL: https://example/v1 # 可选：服务端点
apiKeyEnv: MY_API_KEY # 可选：认证环境变量名
defaultInput: # 可选：provider 级兜底
- text
- image
models:
- id: gpt-5.4-nano
name: 我的服务商 | gpt-5.4-nano # 可选：默认用 id
contextWindow: 400000 # 可选：上下文窗口
maxTokens: 32768 # 可选：最大输出
input: # 可选：模型级覆盖，优先级最高
- text
- image
reasoningEfforts: # 可选：推理级别
high: high
low: low
输入类型解析顺序：模型自身 input → provider defaultInput → ["text"]。查找是通用的：插件会扫描
所有已注册 settings 命名空间的 providers 字典，因此不限于 llm-pi-ai，任何按此结构存储路由的
适配器都能命中。
安装
把本目录作为本地包加入模型配置所在的 profile，然后重启 DSH：
# 从本地路径安装（profile 必须是配置了 llm-pi-ai providers 的那一个）
dsh plugin --profile <profile> add file:/absolute/path/to/dsh-model-info-hint
# 之后重启 DSH 使新插件生效
dsh web
⚠️ profile 别选错。提示的数据来自 settings 文档里的 providers 字典，只有配置了
llm-pi-ai（或其它按同结构存放路由的适配器）的 profile 才有内容可显示；装到空 profile 上，
插件会正常加载、接口也能通，但悬停不会有任何提示。
桌面端（DeepSeek Harness 桌面应用）跑的是 desktop profile，如果你的模型是在桌面端配置的，
请用 --profile desktop。
如果插件已发布到 npm，也可以直接：
dsh plugin --profile <profile> add dsh-model-info-hint
dsh web
安装后无需任何配置：打开模型选择器（输入框的模型按钮，或 /model 命令），把鼠标悬停在模型上即可
看到详细配置提示。
目录结构
dsh-model-info-hint/
├── package.json # dsh.client / dsh.bundle 声明
├── cordis.patch.yml # 在 profile 中激活插件行
├── images/
│ └── screenshot.png # 效果截图
├── lib/
│ ├── index.js # host 侧：读 settings + 暴露 HTTP 接口
│ └── client.js # 浏览器侧：悬停检测 + 详细配置提示
├── README.md # 中文版（GitHub 默认展示）
├── README.en.md # 英文版
├── README.cn.md # 中文版副本
└── LICENSE
备注
- 已适配 DSH
0.2.0-rc.2：/model 弹窗的 provider 现在由 MenuGroup 结构化提供
（section[role="group"]），本版改用与输入框模型菜单一致的取法；查表未命中时，若该模型名在
所有 provider 中唯一，则按模型名兜底。
- 提示框先渲染、再按实测尺寸定位：与模型选择面板（
[data-menu-material]，含顶部搜索框）
始终保持 14px 固定间距，任何内容宽度下都精确等于 14px。只用 left 定位——right 是相对
包含块计算的，而包含块不一定和 getBoundingClientRect() 所在的视口一致，用它会偏到别处。
- 提示是非阻塞的（
pointer-events: none），不会挡住鼠标悬停或点击。
- 提示会在移出模型、点击、滚动或按任意键时消失，并在 6 秒后自动消失，避免菜单关闭后残留。
- 提示只展示
~/.dsh/settings.yaml 里声明过的字段，未显式配置的项（例如继承自目录的
contextWindow）不会显示；input 因有 provider/默认兜底，始终会显示。
apiKeyEnv 显示的是环境变量名称（例如 MY_PROVIDER_API_KEY），不是密钥本身，
settings 文档里存放的也只是变量名。- 只覆盖在 settings 文档中声明了模型的适配器；像内置的
deepseek-official 这种未在
~/.dsh/settings.yaml 里描述模型的适配器，不会显示提示。
- 界面文案使用中文，输入类型名（
text/image 等）与 settings 文档保持一致。
