Files

50 lines
2.4 KiB
Markdown

---
description: "会话检索能力家族的包映射:搜索、追踪与读取实时和持久会话历史,以及 Web 端会话日志导出。"
kind: "package-group"
---
# session-query/:会话检索能力家族
[English](README.md) | 中文
## 概述
`session-query/` 组提供对实时与持久会话历史的检索,且独立于压缩(compaction):程序化调用方通过一个统一服务查询精确日志、过滤后的列表、关系追踪与全文搜索;SQLite 后端支撑搜索;模型获得五个经工作区授权的工具;Web 界面获得下载会话 ZIP 的 `/export` 命令。搜索结果与模型看到的对话历史一致。本页是组的映射;各包 README 负责各自的包级约定。
## 目录
- [](#packages)
- [相关文档](#related-documentation)
- [开发备注](#dev-note)
-----
<a id="packages"></a>
## 包
每个包 README 描述你可用该包部分完成的事情。
| 包 | 职责 | ctx 键 |
|---|---|---|
| [`session-query/`](session-query/README.zh.md) | 统一的会话历史查询服务:精确读取、关系追踪与过滤 | `ctx.sessionQuery` |
| [`session-query-sqlite/`](session-query-sqlite/README.zh.md) | 基于 SQLite FTS5 索引的会话历史全文搜索 | 注册到 `ctx.sessionQuery` |
| [`session-log-export/`](session-log-export/README.zh.md) | Web `/export` 命令与浏览器下载会话 ZIP | `ctx.sessionLogDownload`(浏览器) |
| [`tool-session-query/`](tool-session-query/README.zh.md) | 面向模型的搜索、追踪与读取会话历史工具 | 注册到 `ctx.tools` |
-----
<a id="related-documentation"></a>
## 相关文档
先从子系统参考了解共享的查询词汇,再看追踪、搜索与面向模型工具背后的设计记录。
- [会话查询子系统参考](../../docs/subsystems/session-query.zh.md)——逻辑记录、过滤器、搜索页、血缘、有界读取与事件关系。
- [会话查询关系追踪](../../.agents/notes/implemented/feature/2026-07-13-session-query-tracing.zh.md)——追踪语义与校验边界。
- [SQLite FTS5 会话搜索](../../.agents/notes/implemented/feature/2026-07-10-sqlite-session-query-provider.zh.md)——搜索语义、对账与 tokenizer 决策。
- [面向模型的会话查询工具](../../.agents/notes/implemented/feature/2026-07-24-model-facing-session-query-tools.zh.md)——工作区授权与无游标结果设计。
<a id="dev-note"></a>
## 开发备注
无。