Sessions Viewer

简体中文

English
日本語

简体中文

English
日本語

外观

opencode 的会话记录存在哪 ​

此处支持的 opencode 布局把会话保存在 SQLite 库 ~/.local/share/opencode/opencode.db；配置后改用 $XDG_DATA_HOME/opencode/opencode.db：

~/.local/share/opencode/opencode.db

它遵循 XDG 规范，所以设了 $XDG_DATA_HOME 的话以 $XDG_DATA_HOME/opencode/opencode.db 为准。macOS 上也一样，尽管 macOS 上大多数应用会用 ~/Library/Application Support。

在此处支持的布局中，会话是数据库行，不是逐会话 JSONL 文件。应查询 SQLite，不要把递归文本搜索当成对话提取方法。旧的文件存储布局不在此适配器范围内。

关键的四张表 ​

sql
project  -- id (sha1)、worktree（项目目录）、vcs、time_*
session  -- id（"ses_…"）、project_id、parent_id、slug、title、directory、
         -- model (JSON)、tokens_* 五列、cost、time_created、
         -- time_updated、time_archived
message  -- id（"msg_…"）、session_id、time_created、data（JSON 信封）
part     -- id（"prt_…"）、message_id、session_id、time_created、data（JSON 正文）

库里还有别的表（workspace、todo、permission、event、credential 以及迁移记录），但一份对话记录就是 session → message → part。

message.data 是 JSON 信封：role、modelID、providerID、tokens{input,output,reasoning,cache{read,write}}、cost、time{created,completed}。part.data 是正文，type 可能是 text、reasoning、tool、file、step-start、step-finish 等等。

子 agent 会话 ​

parent_id 非空的会话是别的会话派生出来的子 agent 运行。应用在普通历史列表中隐藏它们，但统计包括它们已记录的工作。子会话可能包含用量与成本；本地模型、服务商计价或缺失字段都可能产生零记录成本，不能据此断定它是单独计费的 API 调用。

用只读方式打开 ​

检查时 opencode 的 TUI 可能正在写入。以只读连接避免意外修改；繁忙或变化中的数据库仍可能需要等待活动结束后重试。下方命令也遵循配置的 XDG 数据根目录：

bash
sqlite3 "file:${XDG_DATA_HOME:-$HOME/.local/share}/opencode/opencode.db?mode=ro" ".tables"

用 SQL 读 opencode 记录 ​

按时间倒序列出会话，带项目和花费：

sql
SELECT s.id, p.worktree, s.title, s.cost,
       datetime(s.time_created/1000, 'unixepoch') AS created
FROM session s
JOIN project p ON p.id = s.project_id
WHERE s.parent_id IS NULL
ORDER BY s.time_created DESC
LIMIT 20;

按顺序打印一个会话的文本：

sql
SELECT json_extract(m.data, '$.role') AS role,
       json_extract(pt.data, '$.text') AS text
FROM message m
JOIN part pt ON pt.message_id = m.id
WHERE m.session_id = 'ses_...'
  AND json_extract(pt.data, '$.type') = 'text'
ORDER BY m.time_created, pt.time_created;

按项目汇总会话已记录成本：

sql
SELECT p.worktree, ROUND(SUM(s.cost), 2) AS usd, COUNT(*) AS sessions
FROM session s JOIN project p ON p.id = s.project_id
GROUP BY p.worktree ORDER BY usd DESC;

最后这条有意包含子 agent 行，汇总的是已保存的 session.cost，不是服务商发票。桌面统计则读取 assistant 消息成本；缺失或不一致记录可能导致两种汇总不同。

为什么成本必须从库里取 ​

opencode 可使用不同服务商或本地模型，仅按模型名查价目表未必符合实际配置。应用读取 assistant 消息中的 modelID、tokens 和 cost，不按应用价目表重新计价。缺失的数值成本目前按零处理，只表示未测量，不代表确认免费。记录成本不是独立核验的发票，财务决策应对照服务商实际用量和账单。见用量与成本边界。

怎么恢复这个会话 ​

在项目目录运行 opencode --session SESSION_ID，需要已安装 opencode。应用提供终端恢复，不提供 opencode 内置对话。

安装 Sessions Viewer，选择 opencode，再选项目阅读受支持的 SQLite 会话。用 ⌘⇧F（macOS）或 Ctrl+Shift+F（Windows/Linux）跨 opencode 项目查标题和用户提问，也可切换为 ID 模式。不搜索助手回答或工具输出，详见搜索范围。

检查隐私后可导出 Markdown、HTML 或解析后消息 JSON；完整归档应保留原数据库。导出限制包括外链或无法读取的图片。继续工作使用已安装的 opencode CLI 在终端恢复，不是 opencode 应用内对话。Sessions Viewer 是独立开源项目，不是 opencode 官方产品。恢复或分享前请查看隐私说明。

依据与限制 ​

路径、记录成本与操作说明于 2026-10-06 核对 0.6.0 opencode 适配器和搜索实现。这是源码与合成测试范围，不是 CLI 实际运行认证。上游：opencode 文档。

**参考范围：**2026-10-05 对照 Sessions Viewer 0.6.0 的适配器源码核对，不代表验证过每个 CLI 版本。Shell 示例使用 macOS/Linux 路径，需要 jq（opencode 用 sqlite3）；占位符要替换成实际值，自定义目录以你的配置为准。提取文本不等于完整还原工具、图片或会话树当前分支。命令回归使用可下载的合成样本，不读取私人会话；验证边界见能力与证据矩阵。浏览历史与恢复、编辑数据不同，见隐私与数据处理。

SQL 示例针对上述数据库结构，不覆盖旧的文件存储布局。只读查询不同于用户明确执行的重命名、回收、还原等数据库写入。见找不到会话的排障指南。

或者用应用打开 ​

Sessions Viewer 以只读方式查这个库，列表里藏掉子 agent 会话但统计里照算，把 opencode 的对话和那些 JSONL 的 agent 并排显示在同一个界面里。它同时还读 Claude Code、Codex、Grok Build、Kimi Code、Pi 和 Antigravity CLI。