deepseek-harness/packages/session-query/README.zh.md

description, kind

description	kind
会话检索能力家族的包映射：搜索、追踪与读取实时和持久会话历史，以及 Web 端会话日志导出。	package-group

session-query/：会话检索能力家族

English | 中文

概述

session-query/ 组提供对实时与持久会话历史的检索，且独立于压缩（compaction）：程序化调用方通过一个统一服务查询精确日志、过滤后的列表、关系追踪与全文搜索；SQLite 后端支撑搜索；模型获得五个经工作区授权的工具；Web 界面获得下载会话 ZIP 的 /export 命令。搜索结果与模型看到的对话历史一致。本页是组的映射；各包 README 负责各自的包级约定。

目录

• 包
• 相关文档
• 开发备注

---

包

每个包 README 描述你可用该包部分完成的事情。

包	职责	ctx 键
session-query/	统一的会话历史查询服务：精确读取、关系追踪与过滤	ctx.sessionQuery
session-query-sqlite/	基于 SQLite FTS5 索引的会话历史全文搜索	注册到 ctx.sessionQuery
session-log-export/	Web /export 命令与浏览器下载会话 ZIP	ctx.sessionLogDownload（浏览器）
tool-session-query/	面向模型的搜索、追踪与读取会话历史工具	注册到 ctx.tools

---

相关文档

先从子系统参考了解共享的查询词汇，再看追踪、搜索与面向模型工具背后的设计记录。

• 会话查询子系统参考——逻辑记录、过滤器、搜索页、血缘、有界读取与事件关系。
• 会话查询关系追踪——追踪语义与校验边界。
• SQLite FTS5 会话搜索——搜索语义、对账与 tokenizer 决策。
• 面向模型的会话查询工具——工作区授权与无游标结果设计。

开发备注

无。