PROJECT TOPICS

项目标签

deepseek-harness dsh-plugin

PROJECT README

README

🔍 @goodandready/dsh-session-search

Model-Facing Session Full-Text Search Tool for DeepSeek Harness Agents

🇬🇧 English • 🇨🇳 中文说明 • 🇷🇺 Русский

⭐ If you like this plugin, please star it on GitHub — it shows me that the plugin is useful to you and motivates me to keep developing it.

🐛 If you find a bug or would like to request a feature, open a GitHub issue in any language — I will review your proposal and implement useful suggestions in a future plugin version.

Overview

In stock DeepSeek Harness, historical conversation logs are indexed by the core full-text search backend (@deepseek-ai/dsh-session-query-sqlite), but this capability is exposed only to the human user via the sidebar search bar. The autonomous model/agent (Dee / Ди) is not provided with any tool to query historical conversations.

@goodandready/dsh-session-search provides the agent with a dedicated, hardened session_search tool. This allows the model to look up past lessons, solutions, code snippets, decisions, and conversational context without decompressing or replaying full .jsonl.zstd session archives into memory.

Architecture & Data Flow

The plugin is strictly host-only with zero browser runtime overhead. It delegates directly to the core search service:

sequenceDiagram
    autonumber
    actor User as User
    participant Agent as Agent (Dee / LLM)
    participant Tool as session_search Tool (dsh-session-search)
    participant Core as ctx.sessionQuery (@deepseek-ai/dsh-session-query)
    participant DB as SQLite FTS5 Index (search_state / persisted_docs)

    User->>Agent: "Remember how we configured Nginx SSL in our previous project?"
    Agent->>Tool: execute({ query: "Nginx SSL configuration", limit: 5 })
    Tool->>Core: searchSessions({ query, limit }, { signal })
    Core->>DB: MATCH query in FTS5 index
    DB-->>Core: Matched sessions with snippet & score
    Core-->>Tool: Return SessionSearchPage
    Tool-->>Agent: Formatted text (Title, Session ID, Date, Best snippet)
    Agent-->>User: Answers with exact historical configuration details

Comparison: Stock DSH vs With `dsh-session-search`

Capability	Stock DSH Core	With `dsh-session-search`
Human UI Session Search	✅ Available in sidebar (`WorkspaceBrowser`)	✅ Unchanged (fully available)
Agent Tool for Session Search	❌ None (no tool registered)	✅ Native `session_search` tool registered
Search Engine	SQLite FTS5 (`ctx.sessionQuery`)	Reuses core SQLite FTS5 engine directly
Memory Footprint	Low	Zero additional memory (delegates to core)
Result Snippets	Rendered in UI	Normalized and formatted as text for LLM
Temporal Metadata	Shown in UI	Compact session date: `(YYYY-MM-DD)`
Pagination Notice	UI infinite scroll / cursor	Model hint: `(more results available — refine your query)`
Execution Guard	Core only	30s deadline (`timeoutMs`), `isConcurrencySafe: true`
Lifecycle	Standard	Managed via Cordis `ctx.effect`
Cancellation	AbortSignal in API	Propagated via `execCtx.signal`

Installation

Install via the dsh CLI for your web profile:

dsh plugin --profile web add @goodandready/dsh-session-search

Or install using pnpm:

pnpm add @goodandready/dsh-session-search

Restart the DeepSeek Harness web profile to activate the bundle patch (cordis.patch.yml).

Configuration

Configure options in your profile configuration:

# dsh configuration
plugins:
  dsh-session-search:
    maxResults: 20
    snippetLength: 200
    timeoutMs: 30000

Option	Type	Default	Description
`maxResults`	`number`	`20`	Default upper bound on returned search matches per call.
`snippetLength`	`number`	`200`	Maximum character length of snippet around best match.
`timeoutMs`	`number`	`30000`	Search execution timeout in milliseconds.

Options can also be configured interactively via the DSH Web UI under Settings → Plugins → Session Search.

Tool Specification: `session_search`

Parameters

query (string, required): Search query text (search terms and keywords, must be non-empty).
limit (integer, optional): Maximum number of matching sessions to return (automatically clamped between 1 and 100, defaults to configured maxResults).

Output Format

The tool returns a clean, plain-text representation:

• Session Title [session-id-12345] (2026-09-17)
  Context snippet with matching keywords highlighted around occurrence...
• Second Session [session-id-67890] (2026-09-15)
  Another snippet from past conversation...
(more results available — refine your query)

If no conversations match:

session_search: no matches found.

If input validation fails:

session_search: error: query must be a non-empty string.

If backend execution fails:

session_search: error: <error message>

License

CLASSIFICATION EVIDENCE

分类依据

项目类型待识别

功能分类其他

规则置信度低

系统优先读取 GitHub Topics，再与站内分类词典和词根规则比对。当前命中：无有效分类标签。

dsh-session-search