报告

通过 Radar 概览和已保存的探索报告,发现事件与测量结果中的规律,并保留定期分析所依据的计算方式。

报告帮助你从单次翻译看见整体规律。团队可以了解哪些语言占了大部分已记录的工作量、哪项测量的结果发生了变化,或哪条规则屡次未被遵守。下一步如何行动,取决于报告统计的是什么:事件增多、通过的结果减少、词元增多,反映的是不同的情况。

Radar 提供两个报告页面。Radar → 概览汇总当月的平均分、生成词数、今日事件,以及针对今日事件计算出的测量值。Radar → 探索将事件以及通过/未通过或数值得分形式的结果绘制成图表,并将图表保存为组织报告。在结果中打开单条结果,即可查看文本和说明。编辑模式分类不在这些报告和结果列表中;请先通过编辑率和编辑距离定位更改,再阅读对比文本。

将鼠标悬停在概览卡片的名称上,即可查看它统计的内容。概览中的得分、词数、事件和今日测量卡片,以及探索页面,都需要报告使用权限;此权限需订阅 Enterprise 套餐才能获得。没有此权限时,这些位置会提示当前套餐不支持报告。

按问题选择报告 #

问题查看位置
Lingo.dev 本月生成了多少内容?概览中的生成词数,详见翻译工作量。
每种语言、每个引擎或提供商的活动量是多少?探索中的事件,详见翻译工作量。
仓库提交更改了哪些本地化内容?Radar → 日志中的 GitHub 事件,详见仓库更改。
测量结果在本月如何变化?概览中的得分面板,详见评估结果。
按语言或引擎查看,某项测量得出了什么结果?探索中的测量报告,详见评估结果。
规则或术语是否得到了一贯遵守?规则遵守情况或术语表遵守情况的得分报告,单条结果的说明位于结果中;详见评估结果。

账户周期内的词元和模型费用数据序列位于设置 → 用量,而非 Radar;相关说明见用量。

在探索中创建报告 #

  1. 打开 Radar → 探索。选择新建报告,或打开示例,选择一份基于你的数据生成的报告进行调整。
  2. 要跟踪某项数值型或通过/未通过型测量,请在预设下选择它。报告会显示该测量过去 90 天内按周统计的结果:0 到 100 分的测量使用得分和平均值,通过/未通过型测量使用布尔值和平均值。应用预设会替换整份报告;只有报告仍与预设一致时,选择器才会显示该预设的名称。
  3. 在数据下选择添加数据,先选择要统计或计算的内容,再选择计算方式:字段可使用计数或唯一值数,得分可使用求和或平均值,布尔值可使用平均值。每个序列会根据所选数据读取事件或测量结果。
  4. 在筛选条件下选择添加筛选条件,选择字段,再使用属于以下任一值、不属于以下任一值或为空。筛选值列表列出的是全部已记录历史数据中最常见的值,而不仅是所选时间范围内的值。
  5. 在分组依据下,可选择一个细分维度,再通过再按选择第二个。可选的细分维度仅限于报告中所有序列共有的字段。
  6. 在图表上方选择日期范围和时间粒度——日、周、月、年或总计——再在图表下选择展示方式。最后选择保存报告。

数据、筛选条件和细分维度中的每个选项,都会在名称下说明所含内容;作为筛选值的每种事件类型也会附上含义说明。报告的建议名称根据展示内容生成,并以所跟踪的测量名称开头,例如 MQM · Score per week;图表标题则采用数据选择器中的名称。

根据所选数据和分组方式,可选择折线图、柱状图、数值、水平条形图、饼图、热力图、散点图或点图。在时间图表中,拖动缩放会将范围缩小到完整的时间段;重置缩放会恢复已保存的范围。

日期范围包括过去 7 天、过去 30 天、过去 90 天、涵盖 365 天的过去 12 个月,以及从首次有数据的日期开始的全部时间。每个范围都截至今天结束,因此即使今天尚未结束,也会计入。日、周、月的划分以设置 → 常规中设定的组织时区为准;每周从星期一开始。事件和结果按事件发生时间归入相应时段,而非按结果的计算时间。

细分维度会限制一次显示的分组数量。时间图表保留前 5 个分组和其他。不含时间维度、仅使用一个细分维度时,保留前 10 个分组和其他;水平条形图、热力图、点图和散点图则先显示 50 个分组,选择显示更多可再增加 50 个。使用第二个细分维度时,保留前 100 个组合。缺少该字段的记录显示为未设置。不含时间维度、仅使用一个细分维度时,排序提供从高到低和从低到高两种选项。

对于事件序列,筛选条件和细分维度提供事件类型、目标语言区域、源语言区域、引擎和提供商。测量序列还提供测量、值类型、不适用、判定方和评判模型。同时包含事件序列和测量序列的报告,可以按两者共有的字段分组。

保存和共享报告 #

已保存的报告会保留名称和定义,包括序列、筛选条件、分组、图表及日期范围,但不保存数据。每次打开报告都会重新执行查询,因此同一份报告日后可能显示不同的值。组织中的每位成员都能查看组织报告,并可重命名、覆盖或删除其中任意一份;报告删除后无法恢复。

修改已保存的报告后,选择保存可覆盖原报告,选择另存为新报告可保留原报告,也可选择放弃更改。下载 CSV会按当前显示内容原样导出图表下方的表格,包括已格式化的百分比、表示缺失值的 — 和其他分组。因细分维度的分组数量限制而隐藏的分组不会导出。

了解汇总指标的计算方式 #

对百分比求平均,与合并观测数据后计算,可能得出不同的结果。举例来说,某一天的 1 条结果中有 1 条通过,另一天的 9 条结果中没有任何一条通过。两天通过率的平均值是 50%,但合并来看,10 条结果中只有 1 条通过,通过率是 10%。

Radar 在不同位置采用这两种计算方式:

显示位置计算方式
概览得分面板每天合并计算当天的结果。月度汇总指标对有得分的各天求平均,不按结果数量加权。
概览得分变化本月截至今天的每日得分平均值,减去上个月相同日期范围的每日得分平均值,以分数差表示。
生成词数本月词数总和,与上个月相同日期范围比较;卡片会标明比较范围,例如 vs Oct 1 – 2。
探索中的数值图表合并整个范围的数据后计算出的单个值。变化值与紧邻此前、时长相同的时间段比较:百分比使用百分点差,计数使用相对变化;此前的值缺失或为零时显示 —。
探索中的得分 → 平均值排除不适用结果后,0–100 分数值型结果的平均值。
探索中的布尔值 → 平均值通过的结果数,除以排除不适用结果后的通过/未通过型结果总数。0–100 分制的结果不计入分母。

要获取合并全部数据后的比率,请读取合并计算的值——探索中的数值图表,或下文查询响应中的 totals——而不是对图表上的各个数据点求平均。值为空的日期不计入概览平均值;如果整个月都没有带得分的结果,则显示 —,而不是零。

处理空数据集时也需谨慎。空值、显示为零、未观测到任何记录,可能代表不同的状态。仅凭结果总数,无法识别符合条件但从未被选中或未完成的翻译。请使用结果,在报告通过率的同时,报告完成情况和有明确判定结果的覆盖率。

探究数字背后的规律 #

遇到得分变化时,先查看同一测量下的示例,再比较内容构成、语言、抽样和指导要求。整体平均值的变化,可能是因为难度较高的语言占了更多工作量,也可能是因为另一项测量开始产出结果。基于观测数据的排名可以为受控模型比较提供线索,但不能证明差异由模型造成。

分析编辑活动时,请结合编辑率和编辑距离,并核实草稿与目标文本的配对关系。编辑减少,可能意味着草稿更好、审核更少,或采用了不同的接受策略。编辑模式结果属于结构化结果,不纳入得分或通过率指标。是否节省了时间,需要另行举证。

排查运行问题时,请查看运行和请求,并区分未出现、已跳过、失败和已完成的阶段。翻译完成、写回目标位置和输出发布是不同的里程碑。单条记录有助于排查,但无法提供完整的汇总状态转换历史。

结构完整性检查的发现也需要单独解读。请对照预期约定,检查缺失键、多余键、占位符和修复后的输出。缺少完整性字段,并不能证明检查成功;结构检查失败,也不同于陈述内容发生变化。

解读事件时间戳和采集时间戳时,应以数据来源实际采用的时间含义为准。Crowdin 审批保留建议的创建时间,因此两者的时间差可能包含审批前的时间,而不只是采集延迟。事件说明了这对日期筛选的影响。评判耗时描述的则是另一个时间区间。计算数量或汇总延迟时,请将提供商字符串事件与请求事件或任务语言区域事件分开。

比较同一工作对应的费用和耗时 #

请明确核算单位:请求、步骤、测量结果,还是账户周期。多条测量结果可能对应同一个生成请求;如果给每条结果都计入该请求的全部费用,就会重复计算支出。词元总数反映的是工作量,而非金额;默认值为零的事件字段也不能证明生成费用为零。

请求耗时不等同于包含排队或等待审核时间的任务总耗时,其统计范围更窄。每条明确判定结果对应的已记录费用,可以反映测量的产出效率,但不能证明节省了多少人力。费用说明了核算时需要明确的边界。

保留定期分析的依据 #

已保存的探索报告会保留问题的定义,但不保留分析思路或当时显示的值。请在团队分析中一并记录这些信息:分析支持的决策、来源数据集、单位、指标、细分维度、筛选条件、区间、时区、时间粒度、排序方式,以及如何处理排名前 N 项显示范围之外的分组。除名称外,也要保留测量 ID,因为名称可能改变。

每个比率都应明确分子和分母。语言区域占比按筛选后保留的所有分组计算,然后才隐藏较小的分组。质量通过率使用同一标准下有明确判定的结果,并单独报告覆盖率。周期增长率以差值除以上一周期的值;如果上一周期的值为零,增长率则无定义。

请将观测结果或检索日期与分析定义一并保存。已保存的报告或实时查询日后可能返回不同的数据,例如历史评估替换了对应区间内的结果之后。下载的 CSV 会记录报告在当时显示的内容。

最后,请检验报告背后的测量。验证质量发现检查标记是否有充分依据;测量设计检查误报、漏检和覆盖率。仅凭两个模型评判器意见一致,无法证明结果正确。

查询合并计算的报告值 #

使用 Content-Type: application/json 将 JSON 发送至 https://api.lingo.dev,并使用目标组织的服务端 X-API-Key 或受认可的持有者凭据进行身份验证。这些操作需要组织成员身份和报告使用权限;仅仅读取分析数据,无需具备所有者角色。将 :orgId 替换为组织 ID,且不要在客户端代码或已保存的报告定义中存放凭据。

POST 路径要请求并从 totals 中读取的指标
/v2/organizations/:orgId/analytics/measurement-scoresaverageScore, reviews, scored

要获取整个周期的得分,请在测量得分操作中使用以下请求体,并替换示例区间:

json
{
  "measures": ["averageScore", "reviews", "scored"],
  "time": {
    "axis": "createdAt",
    "from": "2026-10-01T00:00:00.000Z",
    "to": "2026-11-01T00:00:00.000Z"
  }
}

读取 totals.averageScore 时,请结合 totals.reviews 和 totals.scored 查看。averageScore 的取值范围为 0–1;reviews 统计所有结果,包括不适用的结果,scored 则统计有明确判定的结果。省略维度会请求合并后的全部数据;分组响应也会独立于各行计算合并总值。createdAt 轴使用事件发生时间。

支持的筛选条件可缩小数据范围:例如,filters: {"reviewerId":"…"} 按 ID 选择一项测量,engineId、sourceLocale 和 targetLocale 则选择引擎和语言。请使用测量读取操作返回的真实 ID。这些操作采用预先声明的查询,不支持任意 SQL。服务器会提供组织时区,并拒绝调用方提供的 timezone;请将该时区与明确的区间边界一并保留。日后执行同一查询可能返回不同的数据,因此请将观测到的总值、检索日期和计算方式一并保存。

探索中的序列使用 /analytics/events 和 /analytics/measurement-answers,在 eventAt 轴上采用相同的请求结构;返回的行不包含 totals。已保存的报告可通过 GET、POST /v2/organizations/:orgId/reports、GET、PATCH 和 DELETE /v2/reports/:id 获取。