{"meta":{"title":"代码行指标","intro":"代码行数指标通过量化在补全、聊天和代理功能中建议、添加或删除的代码行数，为 Copilot 输出提供一个方向性的衡量指标。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/copilot","title":"GitHub Copilot"},{"href":"/zh/copilot/reference","title":"参考资料"},{"href":"/zh/copilot/reference/copilot-usage-metrics","title":"Copilot 使用情况指标"},{"href":"/zh/copilot/reference/copilot-usage-metrics/lines-of-code-metrics","title":"Copilot LoC 指标"}],"documentType":"article"},"body":"# 代码行指标\n\n代码行数指标通过量化在补全、聊天和代理功能中建议、添加或删除的代码行数，为 Copilot 输出提供一个方向性的衡量指标。\n\n代码行数（LoC）指标通过量化 Copilot 在补全、聊天和代理功能中建议、添加或删除的代码行数，对其输出提供一种方向性衡量。\n\n## LoC 指标出现的位置\n\n在以下情况下可能会遇到 LoC 指标：\n\n* **代码生成仪表板（企业和组织级别）** - 可视化基于 LoC 的用户和代理活动。 请参阅“[查看代码生成仪表板](/zh/copilot/how-tos/administer-copilot/view-code-generation)”。\n* **导出和 API（企业、组织和用户级别）** - 公开 LoC 字段，例如 `loc_suggested_to_add_sum`， `loc_added_sum`和 `loc_deleted_sum`。 请参阅“[用于 Copilot 使用情况指标的REST API终结点](/zh/rest/copilot/copilot-usage-metrics)”。\n* **“Copilot 使用量指标中的可用数据”参考** - 列出派生自 LoC 的所有仪表板和 API 字段。 请参阅“[Copilot使用情况指标中提供的数据](/zh/copilot/reference/copilot-usage-metrics/copilot-usage-metrics)”。\n\n本文介绍 LoC 的测量方式以及影响其准确性和覆盖范围的内容。 有关详细定义，请参阅上面的参考文章。\n\n## LoC 指标注意事项\n\nLOC 指标可能因 IDE 和版本而异。 请谨记下列注意事项：\n\n* **覆盖：** 并非所有 IDE 和用户都会在升级到所需版本之前发出 LoC 遥测数据。 报表包括 `last_known_ide_version` 和 `last_known_plugin_version` 字段，以便监控整个企业的覆盖范围。\n* **稳定性：** 随着 Copilot 不断发展，遥测定义可能会发生变化。 随着准确性随时间改善，数据会发生小幅度变化。\n\n## 版本要求\n\nLoC 指标需要特定最低版本的 IDE 和 Copilot 插件才能正常运行。 较旧版本的用户不会提供 LoC 数据，这可能会导致在升级之前报告不足。\n\n| IDE                                                                             | 功能 / 特点                                              | 最低 IDE 版本           | 最低 Copilot Chat 扩展版本 |\n| :------------------------------------------------------------------------------ | :--------------------------------------------------- | :------------------ | :------------------- |\n| Eclipse                                                                         | <ul><li>`code_completion`</li></ul>                  | 4.31                | 0.9.3.202507240902   |\n|                                                                                 | <ul><li>                                             |                     |                      |\n| `chat_panel` （询问、编辑、规划、代理）</li></ul>                                            | 4.31                                                 | 0.11.0.202508291001 |                      |\n|                                                                                 | <ul><li>`agent_edit`</li></ul>                       | 4.31                | 0.10.0.202508110512  |\n| IntelliJ/JetBrains                                                              | <ul><li>`code_completion`</li><li>                   |                     |                      |\n| `chat_panel` （询问、编辑、规划、代理）</li><li>`chat_inline`</li><li>`agent_edit`</li></ul> | 2024.2.6                                             | 1.5.52-241          |                      |\n| Visual Studio                                                                   | <ul><li>`code_completion`</li><li>                   |                     |                      |\n| `chat_panel` （询问、编辑、规划、代理）</li></ul>                                            | 17.14.13                                             | 18.0.471.29466      |                      |\n|                                                                                 | <ul><li>`chat_inline`</li><li>`agent_edit`</li></ul> | 17.14.14            | 18.0.471.29466       |\n| VS Code                                                                         | <ul><li>`code_completion`</li></ul>                  | 1.104.0             | 0.31.0               |\n|                                                                                 | <ul><li>                                             |                     |                      |\n| `chat_panel` （询问、编辑、规划、代理）</li></ul>                                            | 1.102.0                                              | 0.29.0              |                      |\n|                                                                                 | <ul><li>`chat_inline`</li></ul>                      | 1.103.2             | 0.30.3               |\n|                                                                                 | <ul><li>`agent_edit`</li></ul>                       | 1.103.0             | 0.30.0               |\n| XCode                                                                           | <ul><li>`code_completion`</li></ul>                  | 14.3.1              | 0.40.0               |\n|                                                                                 | <ul><li>                                             |                     |                      |\n| `chat_panel` （询问、编辑、规划、代理）</li></ul>                                            | 15.0                                                 | 0.43.0              |                      |\n|                                                                                 | <ul><li>`agent_edit`</li></ul>                       | 15.2                | 0.41.0               |\n\n## 代理模式如何影响 LoC 指标\n\n与完成或聊天不同， Copilot agent 不遵循“建议然后接受”流。 代理计划和执行多步骤任务，通常以迭代方式编辑多个文件，而无需用户明确接受。 因此，代理活动的 LoC 指标以不同的方式进行度量。\n\n| 行为       | 其在 LoC 指标中的反映方法                                                              |\n| :------- | :--------------------------------------------------------------------------- |\n| 代理代码建议   | 在可见代码块显示在聊天面板中时计为 `loc_suggested_to_add_sum`。                                |\n| 文件中的代理编辑 | 计为 `loc_added_sum` 功能存储桶下的 `loc_deleted_sum` 和 `agent_edit`。 这些编辑不包括在建议的指标中。 |\n| 多文件操作    | 即使由一个提示触发，每个文件编辑也会导致添加和删除的总行数。                                               |\n\n与代理相关的 LoC 活动的示例输出：\n\n```json\n\"totals_by_language_feature\": [\n  {\n    \"language\": \"unknown\",\n    \"feature\": \"chat_panel_agent_mode\",\n    \"code_generation_activity_count\": 12,\n    \"code_acceptance_activity_count\": 0,\n    \"loc_suggested_to_add_sum\": 86, // code block suggestions in chat panel in agent mode\n    \"loc_suggested_to_delete_sum\": 0,\n    \"loc_added_sum\": 5, // only includes code block copy or apply in chat panel, not agent edits\n    \"loc_deleted_sum\": 0\n  },\n  {\n    \"language\": \"unknown\",\n    \"feature\": \"agent_edit\",\n    \"code_generation_activity_count\": 345,\n    \"code_acceptance_activity_count\": 0,\n    \"loc_suggested_to_add_sum\": 0,\n    \"loc_suggested_to_delete_sum\": 0,\n    \"loc_added_sum\": 2342, // agent and edit mode edits in files\n    \"loc_deleted_sum\": 947\n  }\n]\n```\n\n对于单个代理编辑，你可能会看到以下指标：\n\n```json\n\"user_initiated_interaction_count\": 0,\n\"code_generation_activity_count\": 1,\n\"code_acceptance_activity_count\": 0\n```"}