在复杂的工程对话中,开发者频繁在多个会话或外部窗口间切换。切回时往往需要重新梳理思路。dsh-session-recap 旨在解决这一问题,它在后台追踪页面可见性与空闲状态,当达到设定阈值时自动提炼任务核心,并在重新切回时通过结构化卡片辅助召回。
插件定位¶
这是一个面向 DeepSeek Harness (DSH) Web 的长程任务会话智能回顾扩展,由开发者 DDDFXYqiming 维护,采用 MIT 许可证开源。
核心功能¶
- 多端会话感知:通过心跳机制精准聚合追踪浏览器的 active 与 away 状态。仅在当前会话失焦且满足 idleMs(默认 3 分钟)与 minTurns(默认 3 轮)阈值时触发,避免无效开销。
- 零侵入持久化:回顾内容以独立 Sidecar 文件形式存储于
~/.dsh/plugin-data/dsh-session-recap/,不占用主模型上下文 Token。 - 动态内容契约:自动剔除沉余的工具日志,以最近用户指令为锚点提取压缩摘要。
- 安全边界:内置专有 API 路由防护,严格校验 Loopback 本地回环、精确 Host 匹配与 Same-Origin 来源,防范 DNS Rebinding 等风险。
- 双模支持:Web 界面以卡片形式优雅呈现,支持一键隐藏;Headless 模式支持通过
/recap终端指令直接回传纯文本。
安装与启用¶
通过 DSH 插件系统安装,执行以下命令:
dsh plugin --profile web add github:DDDFXYqiming/dsh-session-recap
安装后重启 Web Profile 并刷新浏览器即可生效。
典型用法¶
- Web 模式:切回会话时,输入框上方会即时呈现结构化回顾卡片,方便快速召回思路。
- Headless 模式:在无界面配置下,可使用
/recap终端指令直接获取纯文本回顾。
配置指南¶
插件支持在对应 Profile 的 cordis.patch.yml 中自定义规则。默认配置如下:
- id: dsh-session-recap
config:
enabled: true
hostCommand: false
idleMs: 180000
minTurns: 3
recentMessages: 80
maxChars: 400
maxInputChars: 24000
maxOutputTokens: 2048
timeoutMs: 30000
provider: ''
model: ''
适用场景与注意¶
该插件适合需要在长时间对话或频繁切换窗口场景下保持上下文连贯的开发者。使用前需确认当前 dsh 进程权限,并建议检查源码与许可证(MIT)。
总结¶
dsh-session-recap 通过后台静默追踪与智能摘要,为 DSH Web 提供了轻量级的记忆辅助,有效缓解了长程任务中的上下文断层问题。
生态目录:dsh-session-recap
GitHub 仓库:DDDFXYqiming/dsh-session-recap