词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
管理对话
💡 一句话总结：用 /new新建会话，用/sessions切换，用/undo撤销，用/export导出，用opencode import导入。
📝 课程笔记
学完你能做什么
你现在的困境
什么时候用这一招
🎒 开始前的准备
确保你已经完成以下事项：
核心思路
为什么需要多个会话
会话存在哪里？
~/.local/share/opencode/storage/
├── session/ # 会话信息
│ └── <project-id>/
│ └── <session-id>.json
├── message/ # 消息记录
│ └── <session-id>/
│ └── <message-id>.json
└── part/ # 消息片段（文本、工具调用等）
└── <message-id>/
└── <part-id>.json~/.local/share/opencode/ 是 XDG 标准的数据目录。macOS 和 Linux 都遵循这个规范。会话按项目隔离，不同项目的会话互不干扰。会话的一生
创建 → 活跃对话 → 压缩（上下文太长时自动触发）→ 归档/删除会话管理命令速览
| 命令 | 作用 |
|---|---|
/new | 新建会话 |
/sessions | 查看并切换会话 |
/undo | 撤销上一步操作 |
/redo | 重做被撤销的操作 |
/compact | 压缩上下文 |
/export | 导出对话记录 |
/share | 分享会话（生成链接） |
opencode import | 从文件或 URL 导入会话（CLI 命令） |
opencode export | 导出会话为 JSON（CLI 命令） |
跟我做
第 1 步：新建一个会话
开始新任务时，用新会话避免之前的上下文干扰。
/new第 2 步：在新会话中对话
让新会话有一些内容，方便后面切换查看。
你好，这是第二个会话第 3 步：查看并切换会话
学会在多个会话之间切换。
/sessions第 4 步：测试撤销功能
AI 可能会做错事，撤销能帮你恢复。
/undo 撤销文件操作（创建、修改、删除文件）需要项目是 Git 仓库。| 项目类型 | 撤销文件操作 | 撤销对话记录 |
|---|---|---|
| Git 项目 | ✅ 文件会被恢复 | ✅ |
| 非 Git 项目 | ❌ 文件不会变化 | ✅ |
git init。:::
创建一个 test.txt 文件，内容写 "hello"/undo第 5 步：压缩过长的上下文
对话太长会占用 Token，压缩后可以节省成本。
/compact第 6 步：导出对话记录
保存重要对话，方便日后查阅。
/export第 7 步：用 CLI 导出和导入会话
TUI 里的
/export 导出的是 Markdown 格式，适合阅读。但如果你想备份完整数据、或者在另一台机器上恢复会话，需要用 CLI 命令导出 JSON 格式。Export session
◇ Select session to export
│ Fix authentication bug • 2026-02-14 10:30 • a1b2c3d4
│ Add new API endpoint • 2026-02-13 15:20 • e5f6g7h8
└ Update documentation • 2026-02-12 09:00 • i9j0k1l2Imported session: session_abc123/sessions 就能看到恢复的会话。第 8 步：从分享链接导入会话
同事分享了一个 OpenCode 会话链接，你想在本地继续那个对话。
💡 URL 格式
https://opncd.ai/share/<slug>。企业版用户的域名可能不同，取决于 enterprise.url 配置。如果 URL 格式不对，会提示错误。第 9 步：Fork 会话
有时候你想从对话的某个节点"分叉"出去，尝试不同的方向，但又不想丢掉原来的对话。Fork 就是干这个的。
(fork #1) 后缀，再次 Fork 则递增为 (fork #2)、(fork #3)……opencode.json 中给它绑一个：{
"keybinds": {
"session_fork": "<leader>f"
}
}原标题 (fork #1)检查点 ✅
全部通过才能继续
/new 能创建新会话/sessions 能看到会话列表并切换/undo 能撤销 AI 的操作（Git 项目可撤销文件）/export 能导出对话opencode export 能导出 JSON 格式的完整会话数据opencode import 能从文件导入会话踩坑提醒
| 现象 | 原因 | 解决 |
|---|---|---|
/undo 文件没恢复 | 当前目录不是 Git 仓库 | 切换到 Git 项目，或先执行 git init |
/undo 撤销对话但文件还在 | 非 Git 项目不支持文件撤销 | 这是正常行为，只撤销对话记录 |
| 会话太多找不到 | 会话名都是默认的 | 养成用 /new 任务名 命名的习惯 |
/compact 后丢了重要信息 | 压缩会删除详细对话 | 重要信息先 /export 备份 |
opencode import 失败 | JSON 格式不对 | 只能导入 opencode export 导出的文件 |
| 分享 URL 导入失败 | URL 格式不对 | 格式必须是 https://opncd.ai/share/<slug> |
本课小结
1.
/new 新建会话2.
/sessions 切换会话3.
/undo /redo 撤销和重做4.
/compact 压缩上下文5.
/export 导出对话（Markdown 格式）6.
opencode export / opencode import 备份和恢复完整会话（JSON 格式）7.
opencode import https://opncd.ai/share/xxx8.
下一课预告
下一课我们学习 2.3 常用快捷键推荐。 你会学到： Leader 键机制（Ctrl+X 前缀） 15 个最实用的快捷键 程序员专属的 Readline 风格快捷键