Documentation
¶
Overview ¶
Package sessionquery 提供会话查询与搜索(任务 S04:Session Query + FTS5 搜索)。
对齐上游:packages/storage/session-query
设计要点:
- 读层构建在 S03 的 SQLite 会话存储之上:枚举会话(ListSessions)、按会话读事件 (Load),并复用其 FTS5 全文检索(Search);标题取 latest-wins 投影,缺省回退 首条用户消息前缀;
- ListSummaries 支持三元过滤:标题前缀(TitlePrefix)/ 创建时间范围 (CreatedFrom..CreatedTo)/ 数量上限(Limit),过滤结果按更新时间倒序;
- Search 先用 FTS5 在事件正文/标题里命中关键词,得到出现该词的会话集合, 再附加「标题含词」的会话;两者求并集后返回摘要(ctrl+f 定位语义)。
uri.go 复刻官方 context/session-reference 的会话引用 URI:把不透明 session id 无损编码为 omnix-session: URI、解码并校验规范化,以及 Markdown mention 渲染。
Index ¶
Constants ¶
View Source
const Scheme = "omnix-session:"
Scheme 是会话快照引用的保留 URI scheme。
Variables ¶
View Source
var ErrInvalidURI = errors.New("sessionquery: invalid session reference URI")
ErrInvalidURI 会话引用 URI 非法或不规范。
Functions ¶
func FormatMention ¶
FormatMention 渲染携带规范 URI 的 Markdown mention;label 为空时用 id 本身。
Types ¶
type ListRequest ¶
type ListRequest struct {
TitlePrefix string // 标题前缀过滤(可选)
CreatedFrom *time.Time // 创建时间下界(可选,含)
CreatedTo *time.Time // 创建时间上界(可选,含)
Limit int // 返回上限(<=0 表示不限)
}
ListRequest 是会话列表查询参数(三元过滤)。
type QueryService ¶
type QueryService struct {
// contains filtered or unexported fields
}
QueryService 提供按标题/时间/关键词检索会话的能力。
func (*QueryService) ListSummaries ¶
func (q *QueryService) ListSummaries(ctx context.Context, req ListRequest) ([]SessionSummary, error)
ListSummaries 按标题前缀 + 创建时间范围枚举会话,返回按更新时间倒序的摘要。
func (*QueryService) Search ¶
func (q *QueryService) Search(ctx context.Context, req SearchRequest) ([]SessionSummary, error)
Search 用 FTS5 检索关键词,返回命中会话的摘要(内容命中 ∪ 标题含词)。
type SearchRequest ¶
SearchRequest 是全文搜索参数。
Click to show internal directories.
Click to hide internal directories.