企业官网建设流程全解析

thClaws 会话管理完全指南：thClaws 是一款开源 AI 智能体工具，所有对话都以「会话（Session）」为单位持久化保存。本教程带你快速掌握thClaws 会话恢复、会话切换与 JSONL 存档的完整方法，让历史对话随时可查、可迁移、永不丢失。

什么是 thClaws 的会话（Session）？

在 thClaws 中，一个会话 = 你与 AI 的一次完整对话。它记录了：

• 📜 完整的消息历史（你的提问、AI 回答、工具调用结果）
• 🤖 当时使用的模型与 provider
• 🕒 创建时间、工作目录、可选的自定义标题
• 🧮 会话累计的 Token 用量

会话采用append-only（只追加、不覆写）的 JSONL 格式——一行一个事件，这带来三个好处：

1. 抗损坏：即使进程中途崩溃，已完成的每条记录都完好无损
2. 可审计：压缩、重命名等操作都留有痕迹，可事后追溯
3. 易迁移：单个会话就是一个纯文本文件，可以拷贝、提交、发送

会话文件存在哪里？

thClaws 的会话是按项目隔离的，统一存放在项目目录下的：

./.thclaws/state/sessions/

每个会话是一个.jsonl文件，文件名即会话 ID（例如sess-181a2c7f4e3d5.jsonl，由创建时刻的纳秒时间戳生成，天然可按时间排序）。

💡 在空文件夹启动 thClaws，会话列表就是空的——会话不会跨项目串门。

三种方式恢复历史会话

方式一：CLI 斜杠命令（最常用）

在交互界面（REPL）中输入/sessions查看最近的会话列表：

❯ /sessions s-4f3a2b1c · claude-sonnet-4-6 · 23 msg refactor-auth · claude-sonnet-4-6 · 87 msg

然后用/load按ID（支持前缀）或标题恢复：

❯ /load s-4f3a2b1c loaded s-4f3a2b1c (23 message(s)) ❯ /load refactor-auth loaded refactor-auth (87 message(s))

方式二：GUI 侧边栏点击

在桌面 GUI 的侧边栏SESSIONS区域，最近的会话按时间倒序列出（已命名的优先显示）。单击任意一行即可加载该会话，Chat 标签和 Terminal 标签会同步切换。此外还能：

• ✏️悬停出现铅笔图标 / 右键 → Rename：给会话起易读的名字
• 🗑️右键 → Delete：删除会话文件（系统弹窗二次确认，不可撤销）
• ➕区域标题旁的+按钮：开启新会话（当前会话会先自动保存）

方式三：启动参数--resume（适合脚本与终端）

不想先进入 REPL 再敲命令？启动时直接指定要恢复的会话：

# 按 ID 或标题恢复指定会话 thclaws --resume refactor-auth # 恢复最近一次活跃的会话 thclaws --resume last

找不到目标会话时，thClaws 会给出友好提示并自动开新会话，不会报错中断。

会话切换技巧：新建、/fork 分叉与自动保存

thClaws 会在以下情况自动创建新会话，且旧会话都会先自动保存，绝不丢失数据：

两个实用细节：

• /model切换模型不会分叉——JSONL 就是权威历史，哪个 provider 接下一轮都能翻译它，会话文件原封不动（提示conversation preserved in session …）
• /fork是"轻装上阵"利器：老会话太臃肿时，用分叉开一个新会话，只携带摘要 + 最近 4 轮对话，上下文立刻清爽

长会话管理：自动压缩与 5MB 分叉提醒

对话越长，上下文占用越高。thClaws 内置两级机制帮你稳住大局：

① 自动压缩（compaction）：当历史超过当前模型上下文窗口的 80% 时，下一轮之前会自动裁掉最旧的消息，并写入一条compaction检查点到 JSONL。之后/load会从检查点回放，不必每次重新压缩。终端里会看到类似提示：

[compacted: 48 → 18 messages — context over 80% of budget]

② 检查上下文水位：随时运行/context，用进度条颜色判断——绿色（<60%）、黄色（60–80%）、红色（≥80% 即将触发压缩）：

❯ /context context: 10 message(s), 14 content block(s) model: claude-sonnet-4-6 · window: 200k tokens · used: ~4.6k tokens [██░░░░░░░░░░░░░░░░░░░░░░░░] 2.3%

③ 5MB 文件提醒：JSONL 是只追加的，文件会持续增大。超过5 MB时，thClaws 会在界面右上角弹出横幅，建议你Fork with summary（带摘要分叉新会话）：

如果确信下一轮要吃重上下文（比如让 AI 读大文件），也可以手动执行/compact提前压缩。

手把手读懂 JSONL 存档：6 种事件类型

会话文件是纯文本，直接查看即可：

cat .thclaws/state/sessions/s-4f3a2b1c.jsonl | head -5

你会看到这些事件类型（按出现顺序）：

🔍 由于每行独立，想脱敏分享时直接删掉含敏感信息的那一行即可，不会损坏其余内容。

分享与迁移会话文件

会话文件是自包含的，迁移极简：

1. 把sess-xxxx.jsonl拷贝到另一台机器的.thclaws/state/sessions/目录
2. 它立刻出现在/sessions列表和 GUI 侧边栏中，点击即恢复

无论是提交进版本库归档、还是发给同事复现问题，都无需任何转换工具。

thClaws 会话命令速查表

进一步阅读：文档与源码位置

想深入 thClaws 会话管理的设计细节（事件回放、跨进程并发、M6.19 容错修复等），可参考以下资料：

• 官方技术文档：thclaws-technical-manual/sessions.md
• 用户手册会话章节：user-manual/ch07-sessions.md（泰文版见 user-manual-th/ch07-sessions.md）
• 会话持久层源码：crates/core/src/session.rs
• CLI 斜杠命令实现：crates/core/src/repl.rs
• GUI 侧边栏 IPC 处理：crates/core/src/gui.rs
• 上下文压缩实现：crates/core/src/compaction.rs

掌握以上内容，你就可以在 thClaws 中自如地恢复会话、切换会话、归档 JSONL 文件，把每一次有价值的 AI 对话都变成可长期保存的资产。