@goodandready/dsh-session-search
DeepSeek Harness 代理工具（session_search），用于对历史会话进行全文搜索，由核心 SQLite FTS5 引擎提供支持，且不产生内存开销。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @goodandready/dsh-session-search@0.1.4Session Search 以 @goodandready/dsh-session-search 发布，当前版本为 0.1.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
🇬🇧 English • 🇨🇳 中文说明 • 🇷🇺 Русский
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 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.
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, Best snippet)
Agent-->>User: Answers with exact historical configuration details
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 |
| Pagination Notice | UI infinite scroll / cursor | Model hint: (more results available — refine your query) |
| Cancellation | AbortSignal in API | Propagated via execCtx.signal |
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).
Configure maxResults in your profile configuration:
# dsh configuration
plugins:
dsh-session-search:
maxResults: 20
| Option | Type | Default | Description |
|---|---|---|---|
maxResults | number | 20 | Default upper bound on returned search matches per call. |
session_searchquery (string, required): Search query text (search terms and keywords).limit (integer, optional): Maximum number of matching sessions to return (automatically clamped between 1 and 100, defaults to configured maxResults).The tool returns a clean, plain-text representation:
• Session Title [session-id-12345]
Context snippet with matching keywords highlighted around occurrence...
• Second Session [session-id-67890]
Another snippet from past conversation...
(more results available — refine your query)
If no conversations match:
session_search: no matches found.
If backend execution fails:
session_search: error: <error message>
MIT © 2026 GoodAndReady