Bortor/dsh-fingerprint-show

README 摘要

dsh-fingerprint-show 一个 DeepSeek Harness（DSH）插件：捕获每次模型调用的 提供方模型指纹 （OpenAI 兼容的 system fingerprint 字段），并在 Web UI 中每条 AI 回复的指标行末尾以纯文本显示。 功能 - 完整指纹文本 — 每条有指标行的 AI 回复末尾以纯文本追加该次调用实际的 模型指纹（如 … 127 tok/s · 0123456789abcdef0123456789abcdef ），完整不截断、 无按钮、无图标、无复制交互； - 样式与原生一致 — 字体 14px、行高 24px、三级灰色 （ --dsw-alias-label-tertiary ）、10px 圆点间距，与指标文本像素级统一； - 悬停同步 — 指纹与 时间 · 用时 · 首 token · tok/s 指标文本 同生同隐 ： 悬停或聚焦消息时一起淡入，移开一起消失（与框架原生行为相同的 80ms 过渡）； - 历史保留 — 中途切换模型后，每条回复各自标注当时实际生效的部署； - 悬停提示 — tooltip 显示模型 id、提供方与调用时间； - 零侵入 — 不修改会话日志、不进入模型上下文、不影响 KV 缓存。 工作原理 DSH 自带的 DeepSeek 适配器把提供方 SSE 翻译成框架内部的 StreamChunk 协议， 响应级元数据（包括 system fingerprint ）在这一步被丢弃，因此 llm/stream 瀑布事件里看不到指纹。本插件在两个互补的接缝上工作： 1. fetch 包装 （主机侧）— 所有适配器最终都走全局 fetch 。插件 tee 每个 匹配 chat/completions 的响应体，从 SSE 分支中提取 system fingerprint ，另一分支原样交还适配器。 2. llm/stream 瀑布监听 （主机侧）— 提供 (sessionId, model, purpose) 。 每次流式调用恰好对应一个提供方请求，观测按「同模型优先、时间最近」关联到 进行中的瀑布调用。 3. HTTP 路由 （主机侧）— 通过 ctx.webServer.register() 在 Web 服务上暴露 GET /api/observations?sessionId=…&limit=… 。之所以不用自定义 会话事件：持久化读取层会拒绝未知事件类型且 Session.append 不支持 ignorable 标记；Remote 命名空间则需要构建期代码生成。 4. 消息内文本 （浏览器侧）— 客户端半区注册 conversation.chat.assistant-actions 槽位条目（定稿 AI 消息的操作条， 与复制/分支按钮同区），按时间单调对齐观测与消息——每条消息取…

分类