· 更新于 2026-05-18
AI

opencode会话管理

问题背景

使用 opencode 时，退出后会提示一句：

1
2
3
4
5
6
7

█▀▀█ █▀▀█ █▀▀█ █▀▀▄ █▀▀▀ █▀▀█ █▀▀█ █▀▀█
█  █ █  █ █▀▀▀ █  █ █    █  █ █  █ █▀▀▀
▀▀▀▀ █▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀

Session   New session - 2026-05-08T09:32:17.883Z
Continue  opencode -s ses_xxxxxxxxxxxxxxxxxxxx

但如果终端窗口关得太快，或忘记复制，这个会话 ID 就丢了，导致无法恢复之前的会话。

我们要实现的就是知道的会话记录，并且可以随时重续之前的会话。如：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
=== 最近的会话 (第5/13页，共122条) ===
  10) [/Users/qian/Downloads] Explore blog structure for Architecture candidates (@explore subagent)
      ├─ 输入: I need to find files in a Hexo blog that
      └─ 最后: I need to find files in a Hexo blog that
   9) [/Users/qian/Downloads] Find thread and UI related files (@explore subagent)
      ├─ 输入: I need to find files in a Hexo blog that
      └─ 最后: I need to find files in a Hexo blog that
   8) [/Users/qian/Downloads] Check blog cleanup status (@explore subagent)
      ├─ 输入: Quick exploration: Look at the hexo blog
      └─ 最后: Quick exploration: Look at the hexo blog
   7) [/Users/qian/Downloads] Explore blog structure (@explore subagent)
      ├─ 输入: I need to understand the current state o
      └─ 最后: I need to understand the current state o
   6) [/Users/qian/Downloads] OpenCode 会话管理配置
      ├─ 输入: 配置opencode会话管理
      ├─ 倒二: 好
      └─ 最后: 提交推送
   5) [/Users/qian/Project/dvlproadHexo] Find articles with duplicate titles (@explore subagent)
      ├─ 输入: Quick search: In /Users/qian/Project/dvl
      └─ 最后: Quick search: In /Users/qian/Project/dvl
   4) [/Users/qian/Project/dvlproadHexo] Scan all image references (@general subagent)
      ├─ 输入: Scan ALL markdown files under /Users/qia
      └─ 最后: Scan ALL markdown files under /Users/qia
   3) [/Users/qian/Project/dvlproadHexo] Check rendered img src for  (@explore subagent)
      ├─ 输入: In the hexo blog at /Users/qian/Project/
      └─ 最后: In the hexo blog at /Users/qian/Project/
   2) [/Users/qian/Project/dvlproadHexo] Find Plan A vs B discussions (@explore subagent)
      ├─ 输入: Search thoroughly for any discussion abo
      └─ 最后: Search thoroughly for any discussion abo
   1) [/Users/qian/Project/AI/AI-qskills] Explore repos data structure (@explore subagent)
      ├─ 输入: I need to understand the data structure 
      └─ 最后: I need to understand the data structure 
输入序号恢复，n=下一页，p=上一页，直接回车=新会话，q=退出:

opencode_session_list

opencode 会话机制

命令 作用
opencode -s <sessionID> 恢复指定会话
opencode --continue 恢复最近一次会话
opencode session list 列出所有历史会话
opencode session delete <sessionID> 删除会话

会话数据存储在 SQLite 数据库中：

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

核心表结构（session 表）：

字段 说明
id 会话 ID，格式 ses_xxx
title 会话标题
directory 项目目录
project_id 关联的项目 ID
time_created 创建时间戳（毫秒）
time_updated 最后更新时间戳（毫秒）

解决方案：opencode_list 会话选择器

核心思路：提供一个独立的 opencode_list 命令，不覆盖原生命令，opencode 行为完全不受影响。

交互设计

  • opencode_list → 弹出会话列表，分页浏览（每页 10 条）
  • 每条记录显示：项目名、会话标题、首条用户输入、倒二条用户输入、末条用户输入
  • 最新会话显示在最底部，1 号位离输入框最近
  • 输入序号 → 恢复该会话
  • 直接回车 → 开新会话
  • n → 下一页，p → 上一页
  • q → 退出

分页取数说明

分页取数：每次只查一页（默认10条），避免一次查太多。每条记录含3个关联子查询（首条/倒二/末条用户消息），查10条 = 30次子查询，查30条 = 90次子查询。

技术要点

SQLite 查询

查询关联 session、project、message、part 四张表，取每条会话的摘要预览：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
SELECT s.id,
       COALESCE(p.name, s.directory, '?'),
       COALESCE(s.title, ''),
       -- 首条用户输入
       (SELECT json_extract(pt.data, '$.text')
        FROM message m2 JOIN part pt ON pt.message_id = m2.id
        WHERE m2.session_id = s.id
          AND json_extract(m2.data, '$.role') = 'user'
          AND json_extract(pt.data, '$.type') = 'text'
        ORDER BY m2.time_created ASC LIMIT 1),
       -- 倒二条用户输入
       (SELECT json_extract(pt.data, '$.text')
        FROM message m2 JOIN part pt ON pt.message_id = m2.id
        WHERE m2.session_id = s.id
          AND json_extract(m2.data, '$.role') = 'user'
          AND json_extract(pt.data, '$.type') = 'text'
        ORDER BY m2.time_created DESC LIMIT 1 OFFSET 1),
       -- 末条用户输入
       (SELECT json_extract(pt.data, '$.text')
        FROM message m2 JOIN part pt ON pt.message_id = m2.id
        WHERE m2.session_id = s.id
          AND json_extract(m2.data, '$.role') = 'user'
          AND json_extract(pt.data, '$.type') = 'text'
        ORDER BY m2.time_created DESC LIMIT 1)
FROM session s
LEFT JOIN project p ON s.project_id = p.id
ORDER BY s.time_updated DESC
LIMIT 10 OFFSET 0;

对应的 Skill

完整的安装脚本和配置步骤已封装为可复用的 Skill：

AI-qskills 中的 opencode-sessions-manager

在新机器上只需加载该 Skill，AI 会自动完成脚本创建、.zshrc 配置等步骤，无需手动操作。

End