前言¶
DeepSeek Harness (DSH) 采用「一切皆插件」的理念，插件生态为系统提供了丰富的扩展能力。在 Web UI 的日常使用中，获取会话的特定信息（如 ID、路径）或监控详细指标可能需要多次点击或查看不同区域。@comecaramelos/dsh-hover-information 插件旨在通过增强 Web UI 的交互细节，解决信息获取不集中、操作繁琐的问题。它为悬停卡片、侧边栏工具栏以及后台作业列表增加了实用的快捷操作和信息展示。
核心功能¶
悬停卡片增强¶
该插件主要增强了会话悬停卡片的显示内容与操作便捷性：
- 快捷复制：在悬停卡片的头部行，增加了
⧉ copy ID和⧉ copy path图标，替代了原本仅有的整卡复制按钮，允许你单独复制会话 ID 或工作区路径。 - 可配置指标块：在卡片中增加了一个可配置的指标展示区域。该区域支持按需切换显示以下指标：
- 轮次（turns）、步骤（steps）
- 发送/接收的 Token 数量
- 缓存 Token 数量
- 压缩（compactions）、清理（purges）
- 上下文窗口大小
- 子代理（subagents）
- 模型（model）
- 工具调用（tool calls）
- 活跃时间（active time）、创建日期（created date）
侧边栏工具栏¶
在侧边栏的文档预览头部工具栏中，插件增加了两个额外的复制按钮，方便快速复制当前打开文件的内容或路径。
后台作业管理¶
在会话头部的「后台作业列表」中，针对正在运行的任务行，增加了一个 ✕ 按钮用于终止作业（取消操作，非强制终止）。
模型选择器¶
在模型选择器中，增加了提供者（Provider）的显示。选择器中不仅显示模型名称，还通过 Tooltip 和值显示 Provider > Model 的层级信息。
安装与启用¶
安装过程通过 DSH CLI 工具执行。由于浏览器端插件不支持热更新，安装后需要重启服务。
官方安装命令¶
dsh plugin --profile web add @comecaramelos/dsh-hover-information
手动安装（备选方案）¶
如果需要手动安装，需将插件链接到对应目录，并在 package.json 中配置依赖：
mkdir -p ~/.dsh/profiles/web/node_modules/@comecaramelos
ln -s /path/to/dsh-hover-information \
~/.dsh/profiles/web/node_modules/@comecaramelos/dsh-hover-information
随后编辑 ~/.dsh/profiles/web/package.json，添加以下配置：
{
"dependencies": {
"@comecaramelos/dsh-hover-information": "link:/path/to/dsh-hover-information"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@comecaramelos/dsh-hover-information"
]
}
}
}
重启要求：安装完成后，必须重启 web 适配器。浏览器端插件不支持热更新，且 DSH 的 live web 网关不会由工具自动重启，需手动执行。
典型用法¶
- 配置指标显示：进入设置页面的「Plugins」卡片，根据需要开启或关闭上述提到的各类指标项。
- 复制会话信息：在会话列表中将鼠标悬停在会话卡片上，点击头部行右侧的
⧉ copy ID或⧉ copy path图标。 - 终止后台任务：在会话头部查看后台作业列表，找到正在运行的任务行，点击行首的
✕按钮进行取消。 - 查看模型来源：在模型选择器中，点击模型下拉项，查看 Tooltip 或选中项，确认其所属的 Provider 信息。
注意事项¶
- 热更新限制：该插件提供的浏览器端 Bundle 不支持热更新功能，修改代码或配置后必须重启服务。
- 服务重启：Live
dsh web网关不会由安装工具自动重启，务必在安装后手动重启服务以确保插件生效。
结语¶
@comecaramelos/dsh-hover-information 通过细化的 UI 交互改进，提升了 DSH Web UI 在信息查阅和操作上的效率。如果你在使用 Web 界面时频繁需要复制路径、查看详细指标或管理后台任务，该插件能提供即时的功能增强。
