sessionquery

package
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 9, 2026 License: MIT Imports: 11 Imported by: 0

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 DecodeURI

func DecodeURI(uri string) (string, error)

DecodeURI 解码并校验 URI 规范;非法返回 ErrInvalidURI。

func EncodeURI

func EncodeURI(sessionID string) string

EncodeURI 把 session id 无损编码为规范 URI。

func FormatMention

func FormatMention(sessionID, label string) string

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 New

func New(store *sqlstore.Store) *QueryService

New 创建会话查询服务,绑定 S03 SQLite 会话存储。

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

type SearchRequest struct {
	Keyword string // 关键词(非空)
	Limit   int    // 返回上限
}

SearchRequest 是全文搜索参数。

type SessionSummary

type SessionSummary struct {
	ID         string    `json:"id"`
	Title      string    `json:"title"`
	CreatedAt  time.Time `json:"createdAt"`
	UpdatedAt  time.Time `json:"updatedAt"`
	EventCount int       `json:"eventCount"`
}

SessionSummary 是一条会话的可查询摘要。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL