Skip to main content

使用 数据变量.copilot.copilot_cli %} 会话数据

恢复以前的 Copilot 命令行界面(CLI) 会话,使用 /chronicle 斜杠命令从会话历史记录中获取见解,并询问 Copilot 有关 CLI 使用情况的问题。

Copilot 命令行界面(CLI) 将您的 CLI 会话数据存储在本地机器上。 此会话数据允许你:

  • 恢复之前的会话,并从你上次中断的地方继续进行。
  • 使用 /chronicle 斜杠命令生成简报报告,获取个性化提示,并接收改进 .github/copilot-instructions.md 文件的建议。
  • 询问 Copilot 有关你过去交互的问题。

本文介绍如何使用这些功能。 若要深入了解会话数据的存储方式以及命令的优点 /chronicle ,请参阅 关于 GitHub Copilot 命令行界面 (CLI) 会话数据

恢复之前的会话

可以从命令行或活动会话期间恢复以前的交互式 CLI 会话。

  •         **在命令行中**,运行 `copilot --continue` 以恢复最近的会话。 如果要从最近会话的列表中进行选择,请运行 `copilot --resume` 以打开列出最近会话的会话选取器。 或者,如果知道要恢复的会话的会话 ID,则可以运行 `copilot --resume SESSION-ID` 以直接跳转到该会话中。
    
  •         **在交互式会话期间**,键入 `/resume` 切换到其他会话。 将显示一个选择器,其中列出了您的近期会话。 或者,可以输入 `/resume SESSION-ID` 以直接跳入特定会话。
    

注意

可以使用斜杠命令查找当前交互式会话 /session 的 ID。 退出交互式会话时也会显示会话 ID。

恢复会话时,Copilot 会加载完整的会话历史记录,这样你就可以从上次中断的地方继续。

重命名会话

使用 --resume 命令行选项或 /resume 斜杠命令时,将列出最近的会话。 列表的最后一列显示会话名称,这有助于确定要恢复的会话。 如果你有一个经常返回的会话,你可能希望为其指定一个自定义名称,以便更轻松地在列表中查找。

要重新创建会话,请执行以下操作:

  1. 在交互式会话中,如果要重命名当前会话以外的会话,请使用 /resume 斜杠命令切换到要重命名的会话。

  2. 键入 /rename NEW_NAME 以重命名当前会话。 无需将名称括在引号中。

    例如,/rename Improve test coverage

共享会话

可以将当前会话的内容另存为 Markdown 文件或 GitHub.com 上的专用 gist。 这样,你就可以与他人共享你的提示和 Copilot 的响应,或在 CLI 之外存储你的工作记录。

若要将会话共享为 gist,请在交互式会话中键入以下内容:

Copilot prompt
/share gist

若要将会话会话导出为 Markdown 文件,请键入:

Copilot prompt
/share file [PATH-TO-FILE]

如果未指定文件路径,则 Markdown 文件将保存在具有名称 copilot-session-SESSIONID.md的当前工作目录中。

使用/chronicle斜杠命令

注意

/chronicle 命令和 Copilot 回答有关会话历史记录问题的能力目前是实验性功能,只有在你已使用 /experimental on 斜杠命令或 --experimental 命令行选项时才可用。

          `/chronicle`斜杠命令提供一组子命令,用于从会话历史记录生成特定类型的见解。 虽然你可以随时就你的会话向询问 Copilot 自由形式的问题,但 `/chronicle` 子命令提供了一种快速获得具体见解的方法。

在没有参数的情况下键入 /chronicle 时,将显示一个选取器,用于从可用的子命令中进行选择:

子命令说明
standup根据你近期的工作情况生成一份简报报告。
tips根据使用模式获取个性化提示。
improve建议对 Copilot 自定义说明文件进行改进。
reindex从会话历史记录重新生成会话存储索引。

还可以直接调用子命令,而无需使用选取器,例如 /chronicle standup

/chronicle standup

这将根据您的 Copilot 命令行界面(CLI) 会话生成一份短报表,默认会显示过去 24 小时的内容。 Copilot 查看你处理的分支、完成的工作以及你引用的任何 GitHub 拉取请求或问题。 它按完成状态对输出进行分组,每个项目都按其分支标记,并检查任何链接拉取请求的当前状态。

示例简报摘要

Standup for March 13 2026:

✅ Done

myapp-repo repo maintenance (main branch)

 - Synced local, cleaned files, audited deps, reviewed architecture
 - Session: 69a027e4-9b7b-493e-922e-107acd25abab

🚧 In Progress

MyApp configuration (suppress-start-message branch, myapp-repo)

 - Suppressing startup init prompt message
 - Session: 3034d813-3e1f-413a-b3d9-15427ef8c19c

可以将其他上下文追加到命令以自定义输出。 例如,你可以告诉 Copilot 使用不同的时间段,而非默认的最近 24 小时:

Copilot prompt
/chronicle standup for the last 3 days

/chronicle tips

这将分析你最近的会话,以了解你的工作方式以及如何使用 Copilot 命令行界面(CLI)。 然后,它提供 3-5 个个性化建议。 Copilot 审查您的具体提示、使用的工具以及尚未尝试的功能。 它将完整的可用 CLI 功能集(包括你在存储库中设置的任何自定义代理和技能)进行交叉引用,以查找你可能错过的机会。

提示以实际使用情况数据为基础,提供特定建议,而不是一般建议。

示例提示

响应 /chronicle tips 中主要要点的示例如下。 在实际响应中,将更详细地解释每个点。

1. Use @ to mention files instead of pasting content
2. Iterate within a session — don't start over
3. Try /research for your exploration work
4. Turn recurring prompts into a custom agent
5. Use plan mode for multi-step work

可以通过在后面 /chronicle tips追加上下文,将提示集中在特定区域上。 例如:

Copilot prompt
/chronicle tips for better prompting

/chronicle improve

这将深入了解你的会话历史,以找到 Copilot 难以提供你想要的响应或结果的地方,或者你必须通过提供跟进提示进行路线修正。 基于这项研究,它建议对你的 .github/copilot-instructions.md 自定义指令文件进行改进。

在处理项目时,将特定于项目的知识作为自定义指令捕获是提高 Copilot 性能的有力方法。 有关详细信息,请参阅“为GitHub Copilot 命令行界面 (CLI)添加自定义指令”。

注意

与其他时候 Copilot 使用会话数据来回答问题或生成见解不同,improve 子命令的范围仅限于当前存储库或工作目录的数据。 这可确保建议与当前正在处理的项目相关。

Copilot 查找摩擦信号,包括重复的测试失败、需要多次尝试的生成错误、纠正或重定向智能体的用户消息,以及在会话中重复出现的模式。 然后,它提出了 3-5 个具体建议,每个建议都解释了它发现的问题,以及将解决该问题的说明。

例如,Copilot 可能会发现,它反复尝试为使用 vitest 的项目使用 jest,或者它一直以不符合代码库约定的样式生成导入。 建议的说明将在未来的会话中防止这些错误。

在给出建议后,Copilot 会询问你要应用哪些建议。 默认情况下,会选择所有建议,但你可以使用键盘上的箭头键移动到任意建议,然后按空格键来切换该建议的启用状态。 选择要应用的建议后,按 Enter。 Copilot 然后创建或更新 .github/copilot-instructions.md 文件。

提问有关会话历史记录的问题

无需使用斜杠命令来利用会话历史记录。 如果 Copilot 确定你正在询问 CLI 的使用情况,它将自动使用会话存储为响应提供上下文。

注意

默认情况下,有关你与 Copilot 命令行界面(CLI) 交互的问题的答案基于你记录的所有会话,而不管你当前在哪个存储库或分支中工作。

下面是你可能提出的问题类型的一些示例:

有关任务的见解

Copilot prompt
Using what you know about my sessions, what type of tasks give me one-shot successes and which do I have to iterate on most?

Copilot 将分析你的对话,查找初始响应后没有相关提示的时间,以及有一系列迭代提示和响应的时间。

减少高级优先请求的使用

Copilot prompt
Based on my previous CLI sessions, how could I prompt you in a way that would cost less?

Copilot 将分析您的会话模式,包括提示词长度、延续步骤数量和工具调用频次,并建议如何通过更少的交互实现相同的效果。

找到你最为高效的时间

Copilot prompt
Look at data for previous sessions. What time of day am I most and least effective at getting good results from Copilot?

Copilot 将查询会话时间戳和结果,以确定你的交互何时最有效。

回顾过去的工作

Copilot prompt
Have I worked on anything related to authentication in the last month?

Copilot 在会话历史记录中使用全文搜索来查找相关会话,然后总结你所做的工作。

延伸阅读

  •         [AUTOTITLE](/copilot/concepts/agents/copilot-cli/chronicle)
    
  •         [AUTOTITLE](/copilot/reference/cli-command-reference)