DeepSeek Harness 插件

shl-session-history

会话历史请求定位器:在桌面客户端侧边栏添加历史请求列表面板,点击可跳转到对应对话位置(英文原文)

跳到安装方式

来源信息

GitHub 仓库
sunyuhuirong/shl-session-history
最近更新
2026年8月21日
分类
记忆
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/sunyuhuirong/shl-session-history
插件名:shl-session-history
作者:sunyuhuirong

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器2 个文件
README.md来源说明 · 只读预览

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

依赖说明(重要)

本插件是 bundle 插件@deepseek-ai/* peer 依赖由 DeepSeek Harness 主应用运行时提供,通过插件管理器安装时无需 npm install,请勿在插件目录手动重装依赖(会破坏与主应用 runtime 的版本对齐)。

  • 不提供 package-lock.json:registry 上 @deepseek-ai 各 rc 版本间的 peer 依赖组合互相冲突(实测标准 npm install 报 ERESOLVE,无法独立解析整棵依赖树)。
  • 独立开发时可尝试 npm install --legacy-peer-deps,但解析出的版本组合可能与主应用 runtime 不一致,运行时以主应用实际提供的版本为准。
  • 升级主应用后,建议重新加载本插件并做一次 RPC 冒烟验证(三个远程方法可被 client 调用,见 src/index.js 头部注释)。

架构

  • 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