Introduction

When using DeepSeek Harness (DSH) locally, searching for specific historical records becomes difficult as the number of sessions grows. Managing this historical data, especially when you need to quickly locate previously discussed content, code snippets, or decision records, requires an efficient retrieval method. The dsh-session-search plugin solves the problem of performing full-text keyword searches across all local sessions.

Plugin Overview

dsh-session-search is a memory plugin for performing full-text searches across all local DSH sessions. It supports DSH’s default zstd-compressed storage format and plain-text storage format. The plugin is maintained by uckkk and released under the MIT License.

Core Features

  1. Full-text keyword search: After entering a keyword, the plugin returns matching session information (including title, ID, and working directory), hit line numbers, and the specific line content.
  2. Sorting and scope control: Results are sorted by most recent usage. By default, it scans the most recent 20 sessions; you can adjust the scan scope using the maxSessions or limit parameters.
  3. Case sensitivity: Search is case-insensitive by default; you can enable case-sensitive mode through the caseSensitive configuration option.
  4. Storage format support: Supports both zstd-compressed .jsonl.zstd files and plain-text .jsonl files.

Installation and Activation

Use DSH’s plugin management command to install this plugin. The following command adds it to the web configuration file:

dsh plugin --profile web add dsh-session-search

After installation, the plugin takes effect in the current DSH instance.

Typical Usage

The plugin provides a session_search tool for performing search operations.

  • Basic search:
    Call session_search with a keyword to retrieve all local sessions.
  • Specified search:
    Pass the query parameter in the command for precise search, for example:
    session_search query=<函数名>
  • Use case:
    When you need to retrieve previously discussed content or find the context of a specific function, just invoke this command directly.

Technical Details

  • Dependencies: The plugin is implemented in pure Node.js and has zero third-party runtime dependencies. It uses peer-only dependencies and is loaded together with the DSH host.
  • License: MIT License © istone.

Applicable Scenarios and Notes

This plugin is suitable for quickly retrieving information from local DSH historical sessions, especially in knowledge management scenarios involving cross-project or cross-session work. It is recommended to review the source code before installation to confirm that its behavior meets your expectations.

Conclusion

With dsh-session-search, you can manage local session history more effectively. For more details and updates, please refer to its community directory or GitHub repository.