In complex engineering conversations, developers frequently switch between multiple sessions or external windows. When they switch back, they often need to reorganize their thinking. dsh-session-recap is designed to address this issue. It tracks page visibility and idle state in the background, automatically extracts the core of the task when a configured threshold is reached, and helps recall the context through a structured card when switching back.

Plugin Positioning

This is an intelligent session recap extension for long-horizon tasks on DeepSeek Harness (DSH) Web, maintained by developer DDDFXYqiming and open-sourced under the MIT License.

Core Features

  • Multi-end session awareness: Uses a heartbeat mechanism to accurately aggregate and track the browser’s active and away states. It triggers only when the current session loses focus and meets the idleMs (default 3 minutes) and minTurns (default 3 turns) thresholds, avoiding unnecessary overhead.
  • Zero-intrusion persistence: Recap content is stored as a standalone Sidecar file in ~/.dsh/plugin-data/dsh-session-recap/, without consuming tokens in the main model context.
  • Dynamic content contract: Automatically removes redundant tool logs and extracts a compressed summary anchored to the most recent user instruction.
  • Security boundaries: Includes built-in protection for proprietary API routes, strictly validating Loopback local addressing, exact Host matching, and Same-Origin sources to prevent risks such as DNS Rebinding.
  • Dual-mode support: The Web UI displays recaps as elegant cards and supports one-click hiding; Headless mode supports obtaining plain text directly through the /recap terminal command.

Installation and Enablement

Install through the DSH plugin system by running the following command:

dsh plugin --profile web add github:DDDFXYqiming/dsh-session-recap

After installation, restart the Web Profile and refresh the browser to apply.

Typical Usage

  • Web mode: When switching back to a session, a structured recap card is displayed instantly above the input box, making it easy to quickly recall context.
  • Headless mode: In a headless configuration, use the /recap terminal command to directly obtain a plain-text recap.

Configuration Guide

The plugin supports custom rules in the corresponding Profile’s cordis.patch.yml. The default configuration is as follows:

- 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: ''

Applicable Scenarios and Precautions

This plugin is suitable for developers who need to maintain context continuity in long conversations or frequent window-switching scenarios. Before using it, confirm the permissions of the current dsh process and review the source code and license (MIT).

Summary

dsh-session-recap provides lightweight memory assistance for DSH Web through background silent tracking and intelligent summarization, effectively mitigating context breaks in long-horizon tasks.

Ecosystem catalog: dsh-session-recap

GitHub repository: DDDFXYqiming/dsh-session-recap