Appearance
Copilot CLI 会在本地记录每次会话的完整数据(提示词、响应、工具调用、文件修改),并通过实验性的 /chronicle 命令提供工作总结、个性化建议和指令优化功能。所有数据保存在本机,不上传到 GitHub 服务器,注重隐私保护。
GitHub Copilot CLI Chronicle:会话历史记录与个人化工作流洞察
会话数据说明
每次运行 Copilot CLI 时,它会在本地记录以下信息:
- 你输入的所有提示词(Prompts)
- Copilot 的响应内容
- 调用了哪些工具(如 shell、文件读写)
- 对哪些文件做了修改
这些数据存储在:
~/.copilot/session-state/同时,还有一个结构化的子集被存入本地 SQLite 数据库(session store),用于支持快速查询和 /chronicle 功能。
隐私保证:所有会话数据都保存在本地,不会发送到 GitHub 服务器。
/chronicle 功能概览
/chronicle是实验性功能,需要先启用实验模式才能使用。
启用实验模式:
bash
# 在 CLI 交互中输入
/experimental on
# 或启动时通过参数开启
copilot --experimental启用后,可使用以下子命令:
| 子命令 | 功能 |
|---|---|
/chronicle standup | 生成近期工作总结(适合每日站会汇报) |
/chronicle tips | 基于你的使用习惯给出个性化使用建议 |
/chronicle improve | 分析历史交互,优化你的自定义指令(Custom Instructions) |
/chronicle reindex | 重建 session store 数据库索引 |
使用场景
每日工作总结
/chronicle standupCopilot 会根据最近的会话历史,生成一份适合晨会汇报的工作总结,包括:昨天做了什么、修改了哪些文件、遇到了哪些问题。
省去手动整理记录的时间,对于每天要写日报或站会汇报的团队特别有用。
获取个性化建议
/chronicle tipsCopilot 分析你的使用模式(常用的命令类型、频繁出现的错误、工具调用习惯),给出针对你个人的优化建议。
比如:发现你经常重复相同的 git 操作提示,可能会建议你写一条自定义指令来简化。
优化自定义指令
/chronicle improve分析你历史上频繁补充的说明或纠正的方向,自动生成改进版的 AGENTS.md 或 ~/.copilot/copilot-instructions.md 内容建议。
这是把"积累的使用经验"固化进指令配置的好方法。
管理会话历史
删除历史记录
直接删除 session 目录中的文件:
bash
# 删除所有历史记录
rm -rf ~/.copilot/session-state/
# 删除指定日期的记录(按文件夹命名规律选择)
rm -rf ~/.copilot/session-state/2026-04-*/删除后运行 reindex 保持数据库同步:
/chronicle reindex重建索引
如果移动、删除或恢复了 session 文件,可能导致数据库索引不一致,运行:
/chronicle reindex这会从 ~/.copilot/session-state/ 重新构建 SQLite session store。
与 Copilot Memory 的区别
| 功能 | Chronicle | Copilot Memory |
|---|---|---|
| 数据来源 | 自动记录所有会话 | 显式存储的记忆条目 |
| 用途 | 历史分析、工作总结 | 持久化项目/个人上下文 |
| 查询方式 | /chronicle 子命令 | 自动加载进上下文 |
| 清理方式 | 删除 session 文件 | 显式删除记忆条目 |
两者互补:Chronicle 负责"我最近做了什么",Memory 负责"关于这个项目 AI 应该记住什么"。
常见问题
Q: 会话数据安全吗?密码或 Token 会被记录吗?
A: 会话数据保存在本机,不会上传。但 Copilot 的记录范围包括完整的提示词和响应,如果你在对话中提到了敏感信息(如 Token、密码),这些也会被记录在本地文件中。建议不要在 Copilot 会话中直接粘贴敏感凭证。
Q: /chronicle standup 生成的内容有多长时间范围?
A: 默认是最近的工作记录(通常是最近几次会话),具体时间范围可能因实现版本而异。如果是实验性功能,行为可能会随版本更新变化。
Q: Windows 上 session 数据存在哪里?
A: Windows 路径为 %USERPROFILE%\.copilot\session-state\,即 C:\Users\你的用户名\.copilot\session-state\。