ChatGPTClaudeGrok / X / CursorGemini

DeepSeek Harness 会话查询四种配方:按时间、工作区、模型与标题找会话怎么查

配置与使用发布于 2026-11-18作者: DeepSeek Plugin 插件市场
DeepSeek HarnessDSH plugin会话查询session_search工作区
会话多了以后,找一条旧记录比新建一条更难。本文给时间窗、工作区、模型、标题关键词四个查询配方,讲游标与截断怎么读、授权边界在哪,以及结果怎么核对。

会话查询不是「把整个库翻一遍」,而是「先定范围,再选维度,最后读游标」。 官方把查询工具设计成只读、隐藏提供方游标,并按调用方会话授权(来源)。会用四个配方,找旧会话比新建会话快。

DeepSeek Harness 查询前先定范围

查询范围决定成本与结果,先定范围再写条件。 三个范围(来源):

  1. 单会话 — 已知会话 id,直接读事件或追踪;
  2. 单工作区 — 在一个项目内找,范围可控;
  3. 全库 — 跨工作区找,成本最高,也最受授权限制。

单会话查询最快,适合「我记得那条会话,但忘了内容在哪」。单工作区适合「在这个项目里找某次改动」。全库适合「不记得在哪个项目」,但要接受更慢与更多过滤。

范围没定就查全库,常见结果是「结果太多、截断、找不到重点」。先缩小到工作区,再按时间或模型过滤,通常更快。

如果连工作区都不确定,先用标题关键词做粗筛,再按结果缩小。不要一上来就按事件全文搜索。

DeepSeek Harness 四种配方

四个配方覆盖「时间、工作区、模型、标题」四个最常用维度。 每个配方给「怎么问」与「适合什么」(来源):

  1. 时间窗 — 「查最近 7 天的会话,按更新时间倒序。」适合「我记得大概什么时候做的」。
  2. 工作区 — 「查当前工作区里所有会话。」适合「只在这个项目里找」。
  3. 模型 — 「查使用某个模型的会话。」适合「我想找那次用强模型做的分析」。
  4. 标题关键词 — 「查标题里包含某个词的会话。」适合「我记得标题大概写了什么」。

四个配方可以组合:工作区 + 时间窗 + 标题关键词,通常能把结果缩到几条。组合越多,查询越精确,但也越容易漏掉目标。

配方不是官方固定语法,而是查询思路。具体参数名以工具 schema 为准,不要把「配方」当成可直接粘贴的命令。

如果四个配方都找不到,再考虑事件级搜索。会话级找不到,可能是标题或时间记错了;事件级搜索能按内容找,但结果更杂。

DeepSeek Harness 游标与截断

查询结果通常不是一次全返回,而是带游标或截断提示。 官方查询工具会隐藏提供方游标,只暴露可继续读取的位置(来源)。

三个读取要点:

  1. 看截断提示 — 结果是否明确说「还有更多」;
  2. 按游标继续 — 不要重复用同一个游标,否则会读到同一页;
  3. 控制页大小 — 太大容易截断,太小增加往返。

游标是位置,不是内容。不要把游标当成会话 id 或事件 id;它只用于继续读取当前查询。

如果结果被截断,先判断「是结果太多」还是「单条太大」。前者靠加条件缩小范围,后者靠读取单条事件或 spill 全文。

DeepSeek Harness 授权边界

查询按调用方会话授权,跨工作区不是无条件开放。 官方说明:查询工具根据不可变的调用方会话为每个结果授权(来源)。

这意味着:

  • 查询结果受工作区权限限制 — 无权访问的工作区不会出现在结果里;
  • 跨工作区查询要显式确认范围 — 不是所有会话都可见;
  • 只读不等于无限制 — 只读工具仍可能暴露敏感内容,授权仍要生效。

如果明明知道某条会话存在却查不到,先确认它属于哪个工作区、当前调用方是否有权限,再怀疑查询条件。

不要把授权过滤当成「查询坏了」。没有权限时,查不到才是正确行为。

DeepSeek Harness 结果核对

查询结果要核对三件事:是不是目标、是否完整、是否最新。 三步(来源):

  1. 是不是目标 — 看标题、时间、工作区、模型是否与记忆一致;
  2. 是否完整 — 结果是否被截断,是否需要继续读取;
  3. 是否最新 — 会话是否还在更新,投影是否有延迟。

第一步最容易出错。同名会话、同一工作区多个分支、相似标题,都会让「看起来像」的结果被误选。

第二步看截断提示。只读到前几条就下结论,可能漏掉真正的目标。

第三步看更新时间。查询结果可能来自投影,刚写入的事件还没折叠;需要最新状态时,重开会话或稍后再查。

DeepSeek Harness 查询配方的四个小实验

验证查询配方,用四个小实验。 四步(来源):

  1. 单会话 — 按 id 读取,确认能拿到事件;
  2. 工作区 — 在工作区内查,确认结果都在该工作区;
  3. 时间窗 — 限定一天,确认结果时间落在范围内;
  4. 标题 — 用已知标题关键词查,确认能命中。

四步都过,说明范围、条件与授权基本正确。只过第一步,常见问题是范围太大;只过前三步,常见问题是标题匹配规则与预期不同。

旧文 dev-session-query-api 讲查询 API,configure-session-history 讲历史管理,fix-session-search-rangeerror 讲搜索报错;本篇补的是四个配方。先定范围,再选维度。

查询的目标是「找到那条会话」,不是「把库翻一遍」。

ChatGPTClaudeGrok / X / CursorGemini

常见问题

DeepSeek Harness 的会话查询工具需要额外启用吗?

DeepSeek Harness 需要这样。DeepSeek Harness 的会话查询工具是选择启用的,提供只读的搜索、读取与追踪能力;没有启用时,模型看不到这些工具。

DeepSeek Harness 的 session_search 和 session_event_search 有什么区别?

DeepSeek Harness 的 session_search 面向会话级查找,session_event_search 面向事件级查找;前者找会话,后者找会话里的具体事件。

DeepSeek Harness 查询结果被截断后,怎么拿完整内容?

DeepSeek Harness 的查询可能返回游标或截断提示,需要按游标继续读取;需要完整内容时,也可以结合 spill 定位符或事件读取工具。

DeepSeek Harness 会话查询会返回其他工作区的会话吗?

DeepSeek Harness 的查询按调用方会话的授权范围过滤,通常不会返回无权访问的工作区内容;跨工作区查找要先确认权限与范围。

相关术语

session_search
session_search 是 DeepSeek Harness 的会话级查询工具,用于按条件查找会话,而不是读取会话内每条事件。— DeepSeek Harness 官方文档 - 会话查询
session_event_search
session_event_search 是 DeepSeek Harness 的事件级查询工具,用于在会话事件中搜索匹配内容。— DeepSeek Harness 官方文档 - 工具 Schema 目录
游标
游标是 DeepSeek Harness 查询结果的位置标记,用于继续读取下一页或下一段结果。— DeepSeek Harness 官方文档 - 会话查询
授权范围
授权范围是 DeepSeek Harness 根据调用方会话决定的可查询范围,跨工作区查询会受它限制。— DeepSeek Harness 官方文档 - 会话查询

来源