zhc
45bb3da47e
master 通过 #7700 将 portal 菜单改为 CSS Anchor Positioning，并删除了 `useAnchoredPosition`。本次合并让子菜单跟进同一机制： - 子卡片以父卡片内一个不随列表滚动、与卡片同尺寸的锚点框为默认锚点， 侧开时默认在右侧、放不下时由 CSS 翻到左侧；单面板模式占据父卡片位置。 - JavaScript 只决定侧开或单面板，并提供当前行在父卡片内的偏移和子卡片 自然高度；两者都是相对尺寸，双指缩放与平移由 CSS 锚点处理。 - 锚点框绕开了 WebKit 的两个问题：锚定到自身由锚点定位的父卡片时不会 在其定位稳定后重新计算；锚定到滚动列表内的行时不计入滚动偏移。 - 删除 `useAnchoredPosition` 及其测试；`menu-submenu-position` 只保留 侧开/单面板判断，相应单测改为验证模式与锚点名。 - 解决 README、测试与 package.json 冲突，沿用 master 的 CSS 锚点说明并 补充子菜单定位描述。
description, kind
| description | kind |
|---|---|
| Package map for the session retrieval capability family: searching, tracing, and reading live and durable session history, plus the Web session-log export. | package-group |
session-query/ — session retrieval capability family
English | 中文
Summary
The session-query/ group provides retrieval over live and durable session history, independent of compaction: programmatic callers query one unified service for exact logs, filtered lists, relationship traces, and full-text search; a SQLite backend powers the search; the Web UI gets an /export command that downloads a session ZIP. Search results agree with the conversation history the model sees. This page maps the group; each package README owns its per-package contract.
Table of Contents
Packages
Each package README describes what you can do with its part of the family.
| Package | Role | ctx key |
|---|---|---|
session-query/ |
Unified session-history query service: exact reads, relationship traces, and filters | ctx.sessionQuery |
session-query-sqlite/ |
Full-text search across session history backed by a SQLite FTS5 index | registers on ctx.sessionQuery |
session-log-export/ |
Web /export command and browser download of a session ZIP |
ctx.sessionLogDownload (browser) |
Related documentation
Start with the subsystem reference for the shared query vocabulary, then the design records behind tracing and search.
The default Web and Desktop use this shared query, index, and export infrastructure. The experimental model-facing tools are a separate optional consumer.
- Session Query subsystem reference — logical records, filters, search pages, lineage, bounded reads, and event relationships.
- Session query relationship tracing — trace semantics and the validation boundary.
- SQLite FTS5 session search — search semantics, reconciliation, and the tokenizer decision.
Dev Note
None.