会话与历史
保存、恢复和管理您的 YeePilot 对话。跟踪 Token 使用量并导出会话记录。
会话的工作方式
每次使用 YeePilot 时，您的对话都会自动保存为一个会话。会话记录您的提示、AI 回复、命令方案、批准决策和执行输出。无需手动保存 -- 一切在后台自动完成。
当您启动 YeePilot 时，它会恢复您最近的会话。如果您想重新开始，请使用 /new 命令。
管理会话
创建新会话
> /new这会创建一个带有干净对话历史的全新会话。您之前的会话会被保留，可以稍后恢复。
列出所有会话
> /sessions这显示您保存的会话列表，包括名称、创建日期和消息数量。从列表中选择一个会话以切换到该会话。
Sessions:
1. nginx-troubleshooting (12 messages, 2h ago)
2. database-migration (8 messages, yesterday)
3. firewall-setup (23 messages, 3 days ago)
Switch to: _重命名会话
默认情况下，会话会自动命名。给它们有意义的名称以便日后查找：
> /rename nginx-troubleshooting您也可以不带参数重命名，系统会提示您输入名称：
> /rename
Enter new name: prod-server-audit导出会话
将当前会话导出为纯文本记录：
> /export这会保存完整的对话 -- 您的提示、AI 回复、提议的命令和执行输出 -- 为一个可读的文本文件。导出适用于文档记录、事故报告或与同事分享。
上下文窗口管理
AI 模型有一个有限的上下文窗口 -- 它一次能考虑的文本量。随着对话增长，它会接近此限制。YeePilot 通过上下文压缩自动处理这个问题。
压缩的工作方式
当上下文窗口达到约 80% 容量时，YeePilot 触发自动压缩：
- 选择对话中最老的 80% 消息
- 将这些消息总结为简洁的摘要
- 摘要替换原始消息
- 最近 20% 的消息保持不变
此过程是无感的。您无需采取任何操作，对话正常继续。AI 保留了对话早期的关键上下文，同时释放空间用于新的交互。
压缩保留的内容
摘要保留：
- 关键决策和结果
- 重要的文件路径和配置值
- 错误消息及其解决方案
- 会话的整体目标
自然丢失的内容：
- 会话早期的精确命令输出
- 冗长的中间步骤
- 未产生结果的探索性命令
如果您需要引用长会话中早期的精确输出，请考虑在压缩发生前导出会话，或为下一个任务开始新会话。
Token 跟踪
YeePilot 跟踪每个会话的 Token 使用量，让您了解 API 消耗和费用。
查看 Token 使用量
在会话期间按 Ctrl+S 查看统计面板，包括：
- 提示 Token -- 发送给 AI 的 Token（您的消息加上上下文）
- 补全 Token -- AI 生成的 Token
- 总计 Token -- 会话的综合使用量
- 估算费用 -- 根据模型的每 Token 定价计算
理解 Token 费用
Token 使用量因以下因素而显著变化：
- 对话长度 -- 较长的会话每条消息使用更多 Token，因为完整历史作为上下文发送
- 智能体模式 -- 多步骤任务由于重复上下文和工具调用消耗更多 Token
- 思考模式 -- 更高的思考级别使用更多补全 Token
- 文件上下文 -- 使用
/file加载的文件会增加提示 Token 数量
降低费用
- 对日常任务使用免费的 OpenRouter 模型
- 使用
/new开始新会话，而不是继续非常长的对话 - 不再需要文件时使用
/unfile移除 - 对简单任务使用较低的思考模式（
/think low） - 定期使用 Ctrl+S 监控使用量
会话存储
会话本地存储在 ~/.yeepilot/sessions/ 中。每个会话是一个 JSON 文件，包含完整的对话历史和元数据。这些文件仅对您的用户账户可访问。
会话永远不会发送到 YeePilot 的服务器。它们完全保留在您的机器上。唯一离开系统的数据是您作为正常提示/回复流程发送给所选 AI 提供商的内容。
实用工作流
基于任务的会话
为每个不同的任务创建一个新会话：
> /new
> /rename firewall-audit-2026-02
> Check all iptables rules and identify any overly permissive entries这使您的会话保持有序且易于查找。
事故响应
在事故期间，会话成为您调查过程的实时日志：
- 开始新会话：
/new - 命名它：
/rename incident-2026-02-27-api-outage - 使用 YeePilot 进行诊断
- 解决后导出：
/export
导出的记录作为事故报告，精确显示了检查了什么、发现了什么以及采取了什么措施。
恢复工作
第二天回来继续任务：
> /sessions选择相关会话。AI 拥有完整的对话上下文，可以从您上次中断的地方继续。