← 返回列表
⚠ 装前注意
🔍 @goodandready/dsh-session-search
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/9/17 · 已提供中文文档
DeepSeek Harness 代理工具（session_search），用于跨历史会话进行全文搜索
综合分
29.4
GitHub 分
29.4
用户评分
—
★ Stars
0
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add GooDAnDReaDY/dsh-session-search未发布到 npm registry，仅可从源码安装，改用 GitHub 源安装
信任档位：已验证本站已于 1 天前真实安装成功
- 是什么
- dsh 原生插件 · chat
- 装得上吗
- 本站已真实安装成功（非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 8 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/25
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/23（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包@goodandready/dsh-session-search（未发布到 npm，仅可源码安装）
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/23 21:27:30
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/schemastery@deepseek-ai/dsh-tools用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成🔍 @goodandready/dsh-session-search
面向 DeepSeek Harness Agent 的会话历史全文检索工具
🇬🇧 English •
🇨🇳 中文说明 •
🇷🇺 Русский
概述
在原生的 DeepSeek Harness 中，历史会话内容虽然由核心服务 (@deepseek-ai/dsh-session-query-sqlite) 建立了全文索引，但该功能仅暴露给人机界面（左侧边栏搜索框）。自主 Agent（Dee / 模型）本身并没有被赋予检索历史会话的工具。
@goodandready/dsh-session-search 解决了这一非对称性：它向模型注册了原生的 session_search 工具，使 Agent 能够直接检索过去的解决方案、经验教训、决策和上下文，而无需将庞大的 .jsonl.zstd 压缩日志解压到内存中。
架构与数据流
本插件为纯 host-only 架构，前端零额外开销。它直接复用核心 Cordis 检索服务：
sequenceDiagram
autonumber
actor User as 用户
participant Agent as Agent (Dee / LLM)
participant Tool as session_search 工具 (dsh-session-search)
participant Core as ctx.sessionQuery (@deepseek-ai/dsh-session-query)
participant DB as SQLite FTS5 索引 (search_state / persisted_docs)
User->>Agent: "还记得我们上次怎么配置 Nginx SSL 的吗？"
Agent->>Tool: execute({ query: "Nginx SSL configuration", limit: 5 })
Tool->>Core: searchSessions({ query, limit }, { signal })
Core->>DB: FTS5 MATCH 检索
DB-->>Core: 匹配的会话与内容摘要
Core-->>Tool: 返回 SessionSearchPage
Tool-->>Agent: 格式化文本（标题、Session ID、最佳匹配片段）
Agent-->>User: 回复包含历史配置细节的准确答案
对比：原生 DSH 与安装 dsh-session-search
| 能力 | 原生 DSH Core | 安装 dsh-session-search 后 |
|---|---|---|
| 人工在界面检索会话 | ✅ 边栏可用 (WorkspaceBrowser) | ✅ 保持原样（完全可用） |
| Agent 自主检索工具 | ❌ 无（未注册工具） | ✅ 原生注册 session_search 工具 |
| 检索引擎 | SQLite FTS5 (ctx.sessionQuery) | 直接复用核心 SQLite FTS5 引擎 |
| 内存开销 | 低 | 零额外开销（代理给核心） |
| 匹配摘要格式 | 界面 HTML 渲染 | 规整为适合 LLM 上下文的纯文本 |
| 分页提示 | 界面滚动条 / Cursor | 模型提示：(more results available — refine your query) |
| 取消操作支持 | API AbortSignal | 通过 execCtx.signal 透传 |
安装
通过 dsh CLI 为 web profile 安装：
dsh plugin --profile web add @goodandready/dsh-session-search
或者使用 pnpm：
pnpm add @goodandready/dsh-session-search
重启 DeepSeek Harness web profile 以加载 bundle patch (cordis.patch.yml)。
配置
在配置文件中配置 maxResults：
dsh 配置
plugins:
dsh-session-search:
maxResults: 20
| 选项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| maxResults | number | 20 | 单次检索返回的最大结果数上限。 |
工具规范：session_search
参数
* query (string, 必填): 检索词与关键字。
* limit (integer, 可选): 返回的最大匹配会话数（自动限制在 1 到 100 之间，默认值为 maxResults）。
输出格式
工具返回清晰的纯文本格式：
• 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)
若未检索到结果：
session_search: no matches found.
若底层执行异常：
session_search: error:
许可证
MIT © 2026 GoodAndReady