Skip to content

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 standup

Copilot 会根据最近的会话历史,生成一份适合晨会汇报的工作总结,包括:昨天做了什么、修改了哪些文件、遇到了哪些问题。

省去手动整理记录的时间,对于每天要写日报或站会汇报的团队特别有用。

获取个性化建议

/chronicle tips

Copilot 分析你的使用模式(常用的命令类型、频繁出现的错误、工具调用习惯),给出针对你个人的优化建议。

比如:发现你经常重复相同的 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 的区别

功能ChronicleCopilot 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\