> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 数据与洞察

> Teams 数据度量看板的功能说明、指标口径、权限与归因规则。

<Info>
  适用版本：Enterprise
</Info>

本文说明 Qoder Teams **数据度量**看板提供的能力：各报表含义、统计口径、谁能看什么数据，以及「提交代码 AI 生成占比」等指标在**产品侧如何计算与归因**。

## 度量报表内容

### 提交代码 AI 占比

<img src="https://mintcdn.com/qoder/V0zN5TAiiuDl2IXR/images/teams-analytics-ai-share.png?fit=max&auto=format&n=V0zN5TAiiuDl2IXR&q=85&s=efd79adabe9b9757f40c78bedcdcfbe0" alt="提交代码 AI 占比" width="1024" height="522" data-path="images/teams-analytics-ai-share.png" />

**口径：** 在提交代码中，由 AI 生成部分所占的比例。其中 **AI** 包括 **Agent**、**Edit** 与 **NEXT**。

**筛选能力：**

* 支持按**仓库**筛选；仓库信息根据 Git 信息提取。
* 支持**仅看主分支**。

**如何理解看板数值：** 若团队在 Qoder 之外还使用**第三方工具**辅助编写代码，单次 commit 中的总行数往往会包含这些工具的产出；其中，第三方工具产出**不会**计入本看板「AI 生成」统计的**分子**，但仍可能计入**分母**所依据的变更行，因此**页面上显示的占比有时会低于直觉预期**。具体以看板展示为准。

### Agent 生成保留行数

<img src="https://mintcdn.com/qoder/V0zN5TAiiuDl2IXR/images/teams-analytics-agent-lines.png?fit=max&auto=format&n=V0zN5TAiiuDl2IXR&q=85&s=313dc2a1e06e518fb68958ec1217a2df" alt="Agent 生成保留行数" width="1024" height="526" data-path="images/teams-analytics-agent-lines.png" />

**口径：** 由 **Agent** 与 **Edit** 生成的代码中，最终仍保留在仓库中的行数，包含 Agent 新增与删除的行数。

支持按**文件扩展名**查看，扩展名归类如下：

* **前端类：** `.js`、`.jsx`、`.ts`、`.tsx`、`.vue`、`.svelte`、`.html`、`.css`、`.scss`、`.less`、`.sass`
* **后端类：** `.py`、`.java`、`.go`、`.rs`、`.rb`、`.php`、`.cs`、`.kt`、`.scala`、`.swift`、`.m`
* **系统/底层：** `.c`、`.cpp`、`.h`、`.hpp`、`.asm`
* **脚本/配置：** `.sh`、`.bash`、`.zsh`、`.ps1`、`.bat`、`.yaml`、`.yml`、`.toml`、`.json`、`.xml`、`.ini`、`.env`
* **数据/查询：** `.sql`、`.graphql`、`.prisma`
* **移动端：** `.dart`、`.swift`、`.kt`
* **文档/标记：** `.md`、`.mdx`、`.rst`、`.tex`
* **其他：** `.r`、`.lua`、`.perl`、`.ex`、`.exs`、`.clj`、`.hs`、`.erl`、`.zig`、`.nim`、`.proto`、`.tf`、`.dockerfile`

### NEXT 采纳次数与推荐次数

<img src="https://mintcdn.com/qoder/V0zN5TAiiuDl2IXR/images/teams-analytics-next.png?fit=max&auto=format&n=V0zN5TAiiuDl2IXR&q=85&s=c5e468b1b96eb8e4243fa739a230b236" alt="NEXT 采纳次数和推荐次数" width="1024" height="525" data-path="images/teams-analytics-next.png" />

* **NEXT 采纳次数：** NEXT 补全功能累计**采纳**次数。
* **NEXT 推荐次数：** NEXT 补全功能累计**推荐**次数。

## 权限

数据度量面向组织内已开通相关能力的成员开放，**角色决定可见范围**：

| 用户角色    | 说明             |
| ------- | -------------- |
| **管理员** | 可查看**全团队**的数据。 |
| **成员**  | 仅可查看**本人**的数据。 |

**成员**登录后可使用数据度量能力并查看与本人相关的报表；**管理员**在此基础上可查看组织范围内的汇总与成员维度视图（若产品界面提供）。可见范围以组织配置与当前版本界面为准。

## 提交代码 AI 生成占比：规则与归因

下列规则说明当前策略下，哪些类型的提交会参与或排除在本指标口径之外。表格第三列「是否适用」表示该条规则是否**参与**本指标的计算或过滤。

| 规则                 | 说明                                                               | 是否适用 |
| ------------------ | ---------------------------------------------------------------- | ---- |
| **超大提交过滤**         | 常见于依赖批量导入、代码迁移、vendor 引入等非人工编写场景；**异常大规模**的单次提交可能被识别并排除，不计入本指标口径 | ✅    |
| **Merge 到本地**      | 主要为拉取、合并等产生的、**不含实质代码变更**的提交，一般会从本指标口径中排除                        | ✅    |
| **Revert 提交**      | 针对历史提交的回滚类提交；**当前策略下不排除**                                        | ❌    |
| **Squash / Amend** | **部分工作流或工具链下**，同一批改动可能被**多次统计**                                  | ✅    |
| **批量格式化提交**        | 由**常见代码格式化工具**产生的纯格式变更；**当前策略下不排除**，以便与加工后的代码状态保持一致              | ❌    |

**说明：** Squash、Amend 等是否导致重复统计，取决于实际工作流与工具使用方式；**请以看板展示为最终依据**。

**归因与边界（与提交行为相关的产品行为）：**

* **同步类合并：** 从代码仓库合并到本地、且属于「无实质代码变更」的同步场景，对应行数**不会**计入本指标的 AI 生成统计基础（与上表「Merge 到本地」一致）。
* **路径变更与复制：** 生成后仅**修改文件路径**，或将生成内容**复制到新路径**再提交时，新路径下通常无法按规则归因到 Qoder AI，相关变更**不计入**本指标的 AI 生成统计。
* **多目录 / 工作树：** 使用多工作目录、工作树等导致**检出路径频繁变化**时，只要变更仍可与生成来源按产品规则关联，**一般会纳入**统计。
* **Amend 与再次提交：** 经 **Amend** 等方式再次提交时，凡仍属 **Qoder AI 生成**的内容，**仍计入** AI 生成统计。
* **极大依赖或生成物文件：** 如误提交体积极大的 `.module` 等文件，往往落入「异常大规模提交」处理；此类提交可能被**整体排除**在本指标所依据的范围之外，**以看板为准**。