返回目录
其他 待识别

shl-session-history

sunyuhuirong/shl-session-history

DeepSeek Harness plugin: conversation history request rail (ZCode-style) - 会话历史请求迷你滑轨

Stars
1
Forks
0
Issues
0
更新
今天

PROJECT TOPICS

项目标签

PROJECT README

README

Session History Locator (shl)

在 DeepSeek Harness 桌面客户端添加会话历史请求迷你滑轨,参考 ZCode 的交互模式:对话区左侧垂直居中的短横线,每条横线代表一条用户请求;鼠标悬停时横线变长并以浮动小窗显示该条请求的摘要,点击跳转到对应对话位置。以 bundle npm 包形式安装到桌面插件管理器。

功能

  • ✅ 左侧垂直居中的迷你滑轨,每条记录 = 一条短横线
  • ✅ 鼠标悬停:横线变长 + 以悬停处为轴心向两侧渐短渐淡(波浪渐变),并弹出带背景的浮动窗口显示完整请求摘要
  • ✅ 点击跳转:滚动到对话中对应的用户消息位置
  • ✅ 高亮跟随悬停位置(非固定高亮当前消息)
  • ✅ 2 秒自动刷新,仅数据变化时重建 DOM(不打断悬停交互)
  • ✅ 仅显示真实用户请求(按事件 source.kind === 'user' 过滤系统注入消息)

文件结构

plugin-shl/
├── package.json        # bundle 元数据(dsh.bundle.patch + dsh.client)
├── cordis.patch.yml    # 注册行:- insert: - id / name
├── src/
│   └── index.js        # Host 端:TypertRemoteService + 手动 Remote 标记
├── lib/
│   └── client.js       # Client 端:__ModuleLoader__.load bundle 格式
└── README.md

安装方式(桌面插件管理器)

在插件管理器中选择「Browse folder / 安装本地文件夹」选择本目录即可。

或命令行安装:

dsh plugin --profile desktop add /path/to/plugin-shl

架构

  • Host 端 (src/index.js):ShlService extends TypertRemoteService,通过 super(ctx, 'shl') 注册服务;用纯 JS 手动调用 Remote('method') 等价于 @Remote() 装饰器(Node 24 默认不支持 decorator 语法),标记 getHistory / navigateToTurn / getCurrentSession 三个远程方法。数据源:sessionQuery.readSession(sessionId) 读取完整事件(含 data),按事件 source.kind === 'user' 过滤出真实用户请求。
  • Client 端 (lib/client.js):window.__ModuleLoader__.load({ id, factory }) bundle 格式,导出 { apply, inject };通过 ctx.connection.rpc.call('/api', 'shl/<method>', { args: { request: {...} } }) 调用 host;纯 DOM + document.createElement('style') 注入样式与悬浮窗口(append 到 document.bodyposition: fixed 按滚动容器矩形计算定位)。

RPC 接口(Host → Remote)

方法 参数 返回值 说明
getHistory { sessionId? } { items, sessionId, debug?, error? } 获取会话历史请求列表
navigateToTurn { sessionId, turnIndex } { ok, eventSeq?, error? } 定位到指定轮次

Client 端远程调用返回包装:{ ok: true, value }{ ok: false, error }

主题适配

所有样式使用 DSH 主题 token,自动适配亮色/暗色模式(带 fallback 值):

  • --dsw-alias-bg-layer-1 / --dsw-alias-bg-layer-2
  • --dsw-alias-border-l2
  • --dsw-alias-brand-primary
  • --dsw-alias-label-primary / --dsw-alias-label-secondary / --dsw-alias-label-tertiary

CLASSIFICATION EVIDENCE

分类依据

项目类型待识别
功能分类其他
规则置信度

系统优先读取 GitHub Topics,再与站内分类词典和词根规则比对。当前命中: 无有效分类标签。