在 DSH 的使用过程中,随着会话变长,容易遗忘最初的任务目标或当前的代码变更。dsh-session-intelligence 插件通过调用 DSH 模型,在右侧栏固定显示会话初衷、最近用户需求摘要、运行状态以及只读的 Git 信息。它依赖原作者的 dsh-better-sidebar 插件,需在本地 Web 环境中运行。
核心功能¶
该插件主要提供以下维度的信息展示:
- 初衷摘要(DSH 摘要):利用 DSH 模型总结首条包含文字的用户消息,提取主要对象、动作和约束。
- 最近用户需求(DSH 摘要):总结最近一条包含文字的用户消息。后续助手的回复不会覆盖此摘要。
- 主题与活动:展示最新会话标题、最近用户消息时间、最近活动、消息数量以及成功完成的轮次数。
- 运行状态:显示当前运行中/空闲状态、活跃子代理数量以及使用的 agent preset。
- Git 状态:显示当前分支、worktree 名称、HEAD 提交、未提交文件列表以及相对于本地 upstream 引用的领先/落后数量。该部分为只读,不会执行 fetch、提交、推送、切分支或文件修改。
安装与启用¶
在安装前,请确保 dsh web 服务正常运行,且已配置模型。
- 安装依赖插件
dsh-better-sidebar。 - 安装
dsh-session-intelligence。 - 重启对应的 DSH Web 服务,并硬刷新页面(Ctrl+Shift+R 或 Cmd+Shift+R)。
dsh plugin --profile web add dsh-better-sidebar@0.14.0
dsh plugin --profile web add https://github.com/leechengwei/dsh-session-intelligence/releases/download/v0.1.0/dsh-session-intelligence-0.1.0.tgz
首次进入会话时,右侧栏会自动展开“会话情报”,首次摘要生成可能需要约 20 秒。若安装了旧版 @local/dsh-client-ui-session-status,需先移除该插件再安装本插件,否则会存在路由冲突。
使用注意事项¶
- 环境限制:插件仅面向可信用户的本机 DSH Web。接口会检查回环连接,不支持直接 LAN 访问,切勿经反向代理暴露到公网。
- 隐私与费用:摘要功能会触发辅助模型请求,复用会话配置的 provider/model,可能产生额外 token 费用。插件不将原始消息写入侧栏接口,不写摘要磁盘缓存,不主动写入聊天事件。
- 摘要内容:摘要不是逐字原文,也不是对整段对话进度的总结。当只有一条用户文字消息时,初衷与最近需求共用一个摘要。摘要可能包含敏感信息,且不承诺自动脱敏或离线处理。
- 刷新机制:摘要约每 30 秒刷新一次,同时也响应窗口聚焦和会话变化。
- Git 限制:Git 文件列表最多显示 40 条。
技术要求¶
- Node.js:最低要求为 22。
- DSH 版本:已在 DSH
0.1.1-rc.2上验证。 - 依赖版本:
dsh-better-sidebar必须启用,且版本需为0.14.x。
该插件通过 lib/index.js 作为 DSH host 插件,lib/client.js 作为浏览器模块运行,源码无需构建即可运行。