{"meta":{"title":"使用 GitHub Copilot CLI 会话数据","intro":"恢复以前的 Copilot CLI 会话，使用 /chronicle 斜杠命令从会话历史记录中获取见解，并询问 Copilot 有关 CLI 使用情况的问题。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/copilot","title":"GitHub Copilot"},{"href":"/zh/copilot/how-tos","title":"操作方法"},{"href":"/zh/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/zh/copilot/how-tos/copilot-cli/use-copilot-cli","title":"使用 Copilot CLI"},{"href":"/zh/copilot/how-tos/copilot-cli/use-copilot-cli/chronicle","title":"使用会话数据"}],"documentType":"article"},"body":"# 使用 GitHub Copilot CLI 会话数据\n\n恢复以前的 Copilot CLI 会话，使用 /chronicle 斜杠命令从会话历史记录中获取见解，并询问 Copilot 有关 CLI 使用情况的问题。\n\nCopilot CLI 在计算机上本地存储 CLI 会话中的数据，默认情况下会将会话同步到帐户 GitHub 。 此会话数据允许你：\n\n* 恢复之前的会话，并从你上次中断的地方继续进行。\n* 使用 `/chronicle` 斜杠命令生成简报报告，获取个性化提示，并接收改进 `.github/copilot-instructions.md` 文件的建议。\n* 向 Copilot 询问过往交互相关问题。\n\n本文介绍如何从 Copilot CLI中使用这些功能。 若要深入了解会话数据的存储和同步方式，请参阅 [关于 GitHub Copilot CLI 会话数据](/zh/copilot/concepts/agents/copilot-cli/chronicle)。 若要从 VS Code中查询会话，请参阅 [管理智能体会话](/zh/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents)。\n\n## 恢复之前的会话\n\n可以从命令行或活动会话期间恢复以前的交互式 CLI 会话。\n\n* **在命令行中**，运行 `copilot --continue` 以恢复最近的会话。 如果要从最近会话的列表中进行选择，请运行 `copilot --resume` 以打开列出最近会话的会话选取器。 或者，如果知道要恢复的会话的会话 ID，则可以运行 `copilot --resume SESSION-ID` 以直接跳转到该会话中。\n\n* **在交互式会话期间**，键入 `/resume` 切换到其他会话。 将显示一个选择器，其中列出了您的近期会话。 或者，可以输入 `/resume SESSION-ID` 以直接跳入特定会话。\n\n> \\[!NOTE]\n> 可以使用斜杠命令查找当前交互式会话 `/session` 的 ID。 退出交互式会话时也会显示会话 ID。\n\n恢复会话时，Copilot 加载完整的会话历史记录，以便可以准确地从离开的地方继续。\n\n## 重命名会话\n\n使用 `--resume` 命令行选项或 `/resume` 斜杠命令时，将列出最近的会话。 列表的最后一列显示会话名称，这有助于确定要恢复的会话。 如果你有一个经常返回的会话，你可能希望为其指定一个自定义名称，以便更轻松地在列表中查找。\n\n要重新创建会话，请执行以下操作：\n\n1. 在交互式会话中，如果要重命名当前会话以外的会话，请使用 `/resume` 斜杠命令切换到要重命名的会话。\n2. 键入 `/rename NEW_NAME` 以重命名当前会话。 无需将名称括在引号中。\n\n   例如，`/rename Improve test coverage`。\n\n## 共享会话\n\n可以将当前会话的内容共享为会话的GitHub.com可共享链接、Markdown 文件、交互式 HTML 文件或专用 gist。GitHub.com 这样，就可以与他人共享提示和 Copilot响应，或将工作记录存储在 CLI 外部。\n\n> \\[!NOTE]\n> 可以在下面的任意命令中用作 `/export` 别名 `/share` 。\n\n若要共享会话并 GitHub 打印可共享链接，请在交互式会话中键入以下内容：\n\n```copilot copy\n/share\n```\n\n若要停止共享会话，请键入 `/share off`。\n\n若要以 gist 形式共享会话，请键入：\n\n```copilot copy\n/share gist\n```\n\n若要将会话会话导出为 Markdown 文件，请键入：\n\n```copilot copy\n/share file [PATH-TO-FILE]\n```\n\n如果未指定文件路径，则 Markdown 文件将保存在具有名称 `copilot-session-SESSIONID.md`的当前工作目录中。\n\n> \\[!NOTE]\n> 要点不适用于 Enterprise Managed Users，或你使用带数据驻留的 GitHub Enterprise Cloud (\\*.ghe.com) 时。\n\n若要将会话导出为交互式 HTML 文件，请键入：\n\n```copilot copy\n/share html [PATH-TO-FILE]\n```\n\n与 Markdown 导出一样，如果未指定文件路径，该文件将保存在当前工作目录中，名称为 `copilot-session-SESSIONID.html`。\n\n如果在当前会话中使用 `/research` 了斜杠命令，也可以使用 `/share` 该命令共享研究报告。 有关详细信息，请参阅“[使用GitHub Copilot CLI进行研究](/zh/copilot/concepts/agents/copilot-cli/research#viewing-and-sharing-a-research-report)”。\n\n## 使用`/chronicle`斜杠命令\n\n`/chronicle`斜杠命令提供一组子命令，用于从会话历史记录生成特定类型的见解。 你可随时向 Copilot 自由提问会话相关问题，`/chronicle` 子命令可快速获取特定见解。\n\n在没有参数的情况下键入 `/chronicle` 时，将显示一个选取器，用于从可用的子命令中进行选择：\n\n| 子命令         | 说明                             |\n| ----------- | ------------------------------ |\n| `standup`   | 根据你近期的工作情况生成一份简报报告。            |\n| `tips`      | 根据使用模式获取个性化提示。                 |\n| `cost tips` | 了解令牌花费情况以及降低成本的建议。             |\n| `search`    | 在会话历史记录中搜索特定主题或关键字。            |\n| `improve`   | 对您的自定义说明文件提出改进建议。              |\n| `reindex`   | 从会话历史记录重新生成本地会话存储，并将会话数据同步到帐户。 |\n\n还可以直接调用子命令，而无需使用选取器，例如 `/chronicle standup`。\n\n### `/chronicle standup`\n\n默认情况下，这会根据 Copilot CLI 会话生成一份过去 24 小时的短报告。\nCopilot 会查看你处理的分支、完成的工作以及你引用的所有 GitHub 拉取请求或问题。 它按完成状态对输出进行分组，每个项目都按其分支标记，并检查任何链接拉取请求的当前状态。\n\n#### 示例简报摘要\n\n```text\nStandup for March 13 2026:\n\n✅ Done\n\nmyapp-repo repo maintenance (main branch)\n\n - Synced local, cleaned files, audited deps, reviewed architecture\n - Session: 69a027e4-9b7b-493e-922e-107acd25abab\n\n🚧 In Progress\n\nMyApp configuration (suppress-start-message branch, myapp-repo)\n\n - Suppressing startup init prompt message\n - Session: 3034d813-3e1f-413a-b3d9-15427ef8c19c\n```\n\n可以将其他上下文追加到命令以自定义输出。 例如，可以指示 Copilot 使用不同的时间段，而不是过去 24 小时的默认时间段：\n\n```copilot copy\n/chronicle standup for the last 3 days\n```\n\n### `/chronicle tips`\n\n这会分析您最近的会话，以了解您的工作方式以及您如何使用 Copilot CLI。 然后，它提供 3-5 个个性化建议。\nCopilot 检查您的实际提示、使用的工具，以及尚未尝试过的功能。 它将完整的可用 CLI 功能集（包括你在存储库中设置的任何自定义代理和技能）进行交叉引用，以查找你可能错过的机会。\n\n提示以实际使用情况数据为基础，提供特定建议，而不是一般建议。\n\n#### 示例提示\n\n响应 `/chronicle tips` 中主要要点的示例如下。 在实际响应中，将更详细地解释每个点。\n\n```text\n1. Use @ to mention files instead of pasting content\n2. Iterate within a session — don't start over\n3. Try /research for your exploration work\n4. Turn recurring prompts into a custom agent\n5. Use plan mode for multi-step work\n```\n\n可以通过在后面 `/chronicle tips`追加上下文，将提示集中在特定区域上。 例如：\n\n```copilot copy\n/chronicle tips for better prompting\n```\n\n### `/chronicle cost tips`\n\n这会分析最近会话中的令牌使用情况，以显示令牌的花费位置，并建议降低成本的方法。\nCopilot 查看提示长度、工具调用频率和延续步骤等模式，以确定提高使用效率的机会。\n\n```copilot copy\n/chronicle cost tips\n```\n\n### `/chronicle search`\n\n这会搜索所有会话内容（而不仅仅是摘要）以获取特定关键字或主题。 与依赖语义理解的开放式问题不同，`/chronicle search` 会直接搜索内容，因此在你知道自己要查找的确切术语或主题时，它会很有用。\n\n```copilot copy\n/chronicle search authentication\n```\n\n### `/chronicle improve`\n\n这会深入探讨您的会话历史记录，以查找 Copilot 无法提供您所寻找的响应或结果的地方，或者您不得不通过提供后续提示来调整路径的地方。 基于这项研究，它建议对你的 `.github/copilot-instructions.md` 自定义指令文件进行改进。\n\n将项目特定知识捕获为自定义指令，是提升 Copilot 在项目中性能的有效方法。 有关详细信息，请参阅“[为 GitHub Copilot CLI 添加自定义说明](/zh/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions)”。\n\n> \\[!NOTE]\n> 与Copilot在其他场合使用时不同，这里使用会话数据回答问题或生成见解，`improve`子命令的范围仅限于当前存储库或工作目录的数据。 这可确保建议与当前正在处理的项目相关。\n\nCopilot 查找摩擦信号 - 重复测试失败、需要多次尝试的编译错误、更正或重定向代理的用户消息以及跨会话重复出现的模式。 然后，它提出了 3-5 个具体建议，每个建议都解释了它发现的问题，以及将解决该问题的说明。\n\n例如，Copilot 可能发现它反复尝试为使用 `jest` 的项目使用 `vitest`，或持续生成与代码库规范不符的导入样式。 建议的说明将在未来的会话中防止这些错误。\n\n提出建议后， Copilot 询问想要应用哪些建议。 默认情况下，会选择所有建议，但你可以使用键盘上的箭头键移动到任意建议，然后按空格键来切换该建议的启用状态。 选择要应用的建议后，按 <kbd>Enter</kbd>。\nCopilot 然后创建或更新 `.github/copilot-instructions.md` 文件。\n\n## 提问有关会话历史记录的问题\n\n无需使用斜杠命令来利用会话历史记录。 如果 Copilot 确定要询问你使用 CLI 的情况，它将自动使用会话存储来提供响应的上下文。\n\n> \\[!NOTE]\n> 默认情况下，有关您与Copilot CLI 互动的问题的解答是基于您所有的记录会话，而不考虑您当前所使用的存储库或分支。\n\n下面是你可能提出的问题类型的一些示例：\n\n### 有关任务的见解\n\n```copilot copy\nUsing what you know about my sessions, what type of tasks give me one-shot successes and which do I have to iterate on most?\n```\n\nCopilot 将分析对话，查找初始响应未遵循相关提示的时间，以及出现一系列迭代提示和响应的时间。\n\n### 减少 GitHub AI Credits 使用量\n\n```copilot copy\nBased on my previous CLI sessions, how could I prompt you in a way that would cost less?\n```\n\nCopilot 将查看会话模式（提示长度、延续步骤数和工具调用频率），并建议通过更少的交互实现相同结果的方法。\n\n### 找到你最为高效的时间\n\n```copilot copy\nLook at data for previous sessions. What time of day am I most and least effective at getting good results from Copilot?\n```\n\nCopilot 将查询会话时间戳和结果，以确定交互何时最高效。\n\n### 回顾过去的工作\n\n```copilot copy\nHave I worked on anything related to authentication in the last month?\n```\n\nCopilot 使用跨会话历史记录的全文搜索来查找相关会话，然后总结所执行的操作。\n\n## 延伸阅读\n\n* [关于 GitHub Copilot CLI 会话数据](/zh/copilot/concepts/agents/copilot-cli/chronicle)\n* [管理智能体会话](/zh/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents)\n* [GitHub Copilot CLI 命令参考](/zh/copilot/reference/copilot-cli-reference/cli-command-reference)"}