日常使用
会话：恢复、命名、导出
heng-agent 的每次对话都存成会话：-c 接最近一次、/resume 挑一个接着聊、/rename 起名、/export 导出 Markdown；上下文快满时自动压缩，/compact 按你的要求压；/status、/usage、/stats、/context 看状态和花费；多开互不干扰。
- 预计用时
- 约 5 分钟
- 适用版本
- v0.5.0 及以上
接着上次聊
会话按项目目录分开存在数据目录（正式版 ~/.heng-agent/sessions/）里，换个目录看到的是另一批。
| 写法 | 作用 |
|---|---|
heng-agent -c |
启动时直接接这个目录最近的会话（同 --resume 不带 id） |
heng-agent --resume <id 或前缀> |
接指定的会话 |
heng-agent --sessions |
列出这个目录的全部会话 |
/resume |
会话里弹出这个目录的会话列表，选一个接着聊 |
/resume 关键词 |
按会话名、第一句话筛选 |
/clear |
开一个新会话（旧的照样存着） |
给会话起名、导出
/rename 名字：给当前会话起名，以后/resume 名字就能找到它；/export [路径]：把对话导出成 Markdown，写周报、贴给同事都方便；/copy：复制上一条回复的原文，/copy 2复制倒数第二条；回复里有代码块时会让你选，可以只复制其中一段代码。
- 整条回复：回复的 Markdown 原文。
- 其中一段代码：只复制这个代码块的内容，贴进终端或编辑器就能用。
上下文快满了：压缩
对话快撑满模型上下文（超过 80%）时，heng-agent 自动把旧历史总结成摘要接着干，状态栏第二行会提前提醒。也可以自己动手：
/compact 只保留数据库迁移相关的/context 看上下文被什么占着（系统提示词、工具、对话、工具结果……），决定要不要压缩、要不要精简项目说明。上下文长度不对时见 服务商与配置文件 里的 context_window。
看状态和花费
| 命令 | 看什么 |
|---|---|
/status |
一屏看全：版本、模型、会话、目录、权限、MCP、说明文件、扩展 |
/usage（同 /cost） |
本会话的输入输出、缓存命中率、花费、上下文占用 |
/stats |
今天 / 近 7 天 / 近 30 天的会话数、token、花费，按项目、按模型排名 |
/context |
上下文被什么占着 |
/status：版本、模型与地址、目录与 git 分支、权限与思考强度、上下文长度从哪来、扩展数量。/usage：本会话的输入输出 token 和上下文占用；没填价格时提示你去配置档里填。
花费按金额显示要先在配置档里填价格（price_in / price_out），见 服务商与配置文件。
同时开好几个
可以同时开多个 heng-agent，互不干扰：/provider、/mode、「本会话一直允许」都只在各自进程里；会话 id 带随机后缀，同一目录同一秒开两个也各写各的。
做完是这样
关掉终端明天再来，heng-agent -c 接着昨天的对话；/resume 列表里能看到你起过名字的会话；/usage 告诉你这次花了多少、缓存命中了多少。