用途：检索和取回过去的会话数据，覆盖会话列表浏览、会话内容获取、消息内容全文搜索、语义检索以及成本与 token 统计等场景。
主要能力与使用方式： 1）插件工具（首选）：session_list 按标题浏览/过滤会话（仅元数据，含 ID、标题、时间戳、文件变更统计与存储路径）；session_get 取回某会话完整对话，经 TTC bear-1.2 压缩，aggressiveness 默认 0.3，可设 0.1（保留更多细节）到 0.7 以上（只取要点），需 TTC_API_KEY 环境变量，缺失时返回未压缩内容。 2）原始 SQLite 查询：数据库位于 /workspace/.local/share/opencode/opencode.db，适合复杂查询、聚合与成本分析；探索时建议用 sqlite3 -readonly 只读模式。 3）REST API：通过 Kortix Master 代理（端口 8000）或直连（端口 4096）访问，如 curl http://localhost:8000/session、/session/SESSION_ID、/session/SESSION_ID/message、/session/status，以及 DELETE 删除会话。 4）grep/ripgrep：在旧版 JSON 存储目录 /workspace/.local/share/opencode/storage/ 下按精确关键字搜索消息内容与工具调用，含 session、message、part、todo 子目录。 5）语义搜索：用 lss 做基于含义的检索，结合 BM25 全文与向量相似度，支持 -p 指定路径、-k 结果数、-e 扩展名、--json 输出。
选择建议：需要精确字符串用 grep，需要按含义查找用 lss；结构化查询（成本、计数、join）用 SQL；查当前运行状态用 REST API。典型流程为 session_list 筛选候选、session_get 压缩概览、再低 aggressiveness 取细节，必要时回退到 grep 与 SQL。
限制：部分功能依赖 TTC_API_KEY；REST 与本地数据库的具体可用性取决于运行环境；资料未提供安装步骤、收费或许可信息。