361 lines
17 KiB
HTML
361 lines
17 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="zh-CN">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<title>L1 自动校对规则 · AUTOSAR 4.4 中文翻译</title>
|
||
<link rel="stylesheet" href="assets/style.css">
|
||
<style>
|
||
.rule-block {
|
||
background: #fff;
|
||
border: 1px solid #ddd;
|
||
border-left: 5px solid #006699;
|
||
padding: 14px 20px;
|
||
margin: 16px 0;
|
||
border-radius: 0 4px 4px 0;
|
||
}
|
||
.rule-block h3 { margin-top: 0; }
|
||
.severity-critical { border-left-color: #d9534f; background: #fdf3f3; }
|
||
.severity-high { border-left-color: #f0ad4e; background: #fffbe6; }
|
||
.severity-medium { border-left-color: #5bc0de; background: #f0f7fb; }
|
||
.severity-low { border-left-color: #5cb85c; background: #f3faf3; }
|
||
.check-pass { color: #5cb85c; font-weight: bold; }
|
||
.check-fail { color: #d9534f; font-weight: bold; }
|
||
.check-warn { color: #f0ad4e; font-weight: bold; }
|
||
.metric-table th { background: #006699; }
|
||
code.cmd { background: #2d2d2d; color: #f8f8f2; padding: 8px 12px; display: block; border-radius: 4px; }
|
||
</style>
|
||
</head>
|
||
<body>
|
||
|
||
<header class="doc-header">
|
||
<h1>L1 自动校对规则（QUALITY_RULES）</h1>
|
||
<div class="meta">
|
||
<span>📋 文档 ID：QR-001</span>
|
||
<span>🏷 类型：校对规则</span>
|
||
<span>📅 版本：1.0（2026-06-13）</span>
|
||
<span>🎯 适用范围：所有翻译文档</span>
|
||
<span>📌 状态：<strong>已生效</strong></span>
|
||
</div>
|
||
</header>
|
||
|
||
<nav class="doc-nav">
|
||
<a href="index.html">← 总索引</a>
|
||
<a href="quality_review.html">📊 质量审查报告</a>
|
||
<a href="glossary.html">📖 术语表</a>
|
||
<a href="logs/proofread_log.jsonl">🧪 校对日志</a>
|
||
</nav>
|
||
|
||
<div class="toc">
|
||
<h2>目录</h2>
|
||
<ul>
|
||
<li><a href="#overview">1 规则总览</a></li>
|
||
<li><a href="#categories">2 规则分类（4 类 18 项）</a>
|
||
<ul>
|
||
<li><a href="#structural">2.1 结构类（5 项）</a></li>
|
||
<li><a href="#terminology">2.2 术语类（4 项）</a></li>
|
||
<li><a href="#completeness">2.3 完整性类（5 项）</a></li>
|
||
<li><a href="#style">2.4 风格类（4 项）</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#thresholds">3 量化阈值</a></li>
|
||
<li><a href="#ratings">4 评级标准</a></li>
|
||
<li><a href="#template">5 校对区块模板</a></li>
|
||
<li><a href="#workflow">6 校对工作流</a></li>
|
||
</ul>
|
||
</div>
|
||
|
||
<main>
|
||
|
||
<h2 id="overview">1 规则总览</h2>
|
||
<p>L1 自动校对是每篇翻译完成后必经的最小质量门槛。本规则文档规定 18 项硬性检查，按"结构 / 术语 / 完整性 / 风格"四类组织，每项均给出：检查方法、通过/失败/警告判定、严重等级。</p>
|
||
|
||
<p>校对应在翻译完成的<strong>同一会话</strong>内完成，避免上下文丢失。若未通过 L1，不得更新 <code>proofread_log.jsonl</code> 与 <code>progress.md</code>。</p>
|
||
|
||
<div class="rule-block severity-critical">
|
||
<h3>🔴 核心原则</h3>
|
||
<ul>
|
||
<li><strong>诚实优先</strong>：校对区块中不得使用"完整""全部""100% 覆盖"等绝对词，除非附带量化证据（页数比、需求数、表格行数）。</li>
|
||
<li><strong>可验证</strong>：每条校对声明都应对应原 PDF 中的具体章节/需求 ID，便于审计。</li>
|
||
<li><strong>可追溯</strong>：校对日志采用 <code>jsonl</code> 格式，字段结构必须可被 <code>grep</code> 解析。</li>
|
||
</ul>
|
||
</div>
|
||
|
||
<h2 id="categories">2 规则分类（4 类 18 项）</h2>
|
||
|
||
<h3 id="structural">2.1 结构类（5 项）</h3>
|
||
|
||
<div class="rule-block severity-critical">
|
||
<h3>📐 S-01 · HTML 头与元数据完整性</h3>
|
||
<p><strong>检查</strong>：HTML 必须包含 <header class="doc-header"> 与以下 6 个字段：</p>
|
||
<ul>
|
||
<li><code>📄 文档 ID</code>：取自原 PDF Document Identification No</li>
|
||
<li><code>🏷 类型</code>：EXP / SRS / SWS / TR / TPS / RS</li>
|
||
<li><code>📅 版本</code>：AUTOSAR CP 4.4.0</li>
|
||
<li><code>📑 页数</code>：与原 PDF 页数一致</li>
|
||
<li><code>📌 状态</code>：Final / Draft / Obsolete</li>
|
||
<li><code>🔗 原 PDF</code>：以 <code><code></code> 包裹的 PDF 文件名</li>
|
||
</ul>
|
||
<p><strong>失败判定</strong>：缺失任一字段或字段值与原 PDF 不符。</p>
|
||
</div>
|
||
|
||
<div class="rule-block severity-critical">
|
||
<h3>📐 S-02 · 章节编号与锚点对应</h3>
|
||
<p><strong>检查</strong>：TOC 中的 <code><a href="#sN_M"></code> 必须能在正文中找到对应的 <code><hN id="sN_M"></code>。</p>
|
||
<p><strong>命令</strong>：</p>
|
||
<pre class="cmd">grep -oE 'href="#s[0-9_]+"' file.html | sort -u
|
||
grep -oE 'id="s[0-9_]+"' file.html | sort -u
|
||
diff <(命令1) <(命令2 sed 's/href="#/id="/')</pre>
|
||
<p><strong>失败判定</strong>：存在孤立锚点（仅出现在 TOC 或仅出现在正文）。</p>
|
||
</div>
|
||
|
||
<div class="rule-block severity-high">
|
||
<h3>📐 S-03 · 章节顺序一致性</h3>
|
||
<p><strong>检查</strong>：HTML 正文章节顺序与原 PDF Table of Contents 一致。</p>
|
||
<p><strong>失败判定</strong>：章节被重新排序或合并/拆分（除非有合理理由并在校对区块说明）。</p>
|
||
</div>
|
||
|
||
<div class="rule-block severity-medium">
|
||
<h3>📐 S-04 · 导航栏链接</h3>
|
||
<p><strong>检查</strong>：<nav class="doc-nav"> 必须包含：</p>
|
||
<ul>
|
||
<li>← 总索引（指向 <code>../index.html</code>）</li>
|
||
<li>← 模块索引（指向 <code>index.html</code>）</li>
|
||
<li>📖 术语表（指向 <code>../glossary.html</code>）</li>
|
||
</ul>
|
||
</div>
|
||
|
||
<div class="rule-block severity-medium">
|
||
<h3>📐 S-05 · 页脚信息</h3>
|
||
<p><strong>检查</strong>：<footer class="doc-footer"> 包含翻译者、源 PDF 引用、文档 ID。</p>
|
||
</div>
|
||
|
||
<h3 id="terminology">2.2 术语类（4 项）</h3>
|
||
|
||
<div class="rule-block severity-critical">
|
||
<h3>📚 T-01 · 术语一致性</h3>
|
||
<p><strong>检查</strong>：译文术语必须与 <code>glossary.html</code> 一致。禁止同义词混用。</p>
|
||
<p><strong>常见违规</strong>：</p>
|
||
<ul>
|
||
<li>"自由运行定时器" vs "自由运行计时器" vs "自由计数器"</li>
|
||
<li>"硬件测试管理" vs "硬件测试管理器" vs "HTM 模块"（HTMSS 才是标准名）</li>
|
||
<li>"需求 ID" vs "要求 ID" vs "规范 ID"</li>
|
||
</ul>
|
||
<p><strong>失败判定</strong>：出现与术语表不一致的同义译法。</p>
|
||
</div>
|
||
|
||
<div class="rule-block severity-high">
|
||
<h3>📚 T-02 · 首次双语 + 后续中文</h3>
|
||
<p><strong>检查</strong>：每个新术语首次出现时为"中文（English, 缩写）"，后续仅中文。</p>
|
||
<p><strong>错误模式</strong>：</p>
|
||
<ul>
|
||
<li>❌ "RTE 是 RTE 的实现"</li>
|
||
<li>✅ "运行时环境（Runtime Environment，RTE）是 RTE 的具体实现"</li>
|
||
</ul>
|
||
<p><strong>警告判定</strong>：缩写未在首次出现时给出。</p>
|
||
</div>
|
||
|
||
<div class="rule-block severity-critical">
|
||
<h3>📚 T-03 · 缩写表正确性</h3>
|
||
<p><strong>检查</strong>：译文中"缩略语与缩写"表必须忠实翻译原 PDF 表格，<strong>不可凭空添加</strong>，<strong>不可复制其他文档</strong>。</p>
|
||
<p><strong>已知错误</strong>（2026-06-13 审查发现）：</p>
|
||
<ul>
|
||
<li>🔴 <code>AUTOSAR_SRS_TimeService.html</code> 缩略语表为 8 条（ADC/BIST/BSW/...），但原 PDF 表格<strong>实际为空</strong>，是错误复制自 <code>HWTestManager</code> 译文。</li>
|
||
</ul>
|
||
<p><strong>失败判定</strong>：表行数与原 PDF 不符（多/少/错位）。</p>
|
||
</div>
|
||
|
||
<div class="rule-block severity-high">
|
||
<h3>📚 T-04 · RFC 2119 关键字保留</h3>
|
||
<p><strong>检查</strong>：SHALL / MUST / SHOULD / MAY 等关键字保留英文，首次出现附中文释义。</p>
|
||
<p><strong>关键字表</strong>：</p>
|
||
<table class="metric-table">
|
||
<thead><tr><th>英文</th><th>中文释义</th></tr></thead>
|
||
<tbody>
|
||
<tr><td><code>SHALL</code></td><td>绝对要求</td></tr>
|
||
<tr><td><code>SHALL NOT</code></td><td>绝对禁止</td></tr>
|
||
<tr><td><code>MUST</code></td><td>基于法律/标准的绝对要求</td></tr>
|
||
<tr><td><code>MUST NOT</code></td><td>基于法律/标准的绝对禁止</td></tr>
|
||
<tr><td><code>SHOULD / RECOMMENDED</code></td><td>推荐（但有理由可忽略）</td></tr>
|
||
<tr><td><code>SHOULD NOT / NOT RECOMMENDED</code></td><td>不推荐</td></tr>
|
||
<tr><td><code>MAY / OPTIONAL</code></td><td>真正可选</td></tr>
|
||
<tr><td><code>REQUIRED</code></td><td>等同于 SHALL</td></tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<h3 id="completeness">2.3 完整性类（5 项）</h3>
|
||
|
||
<div class="rule-block severity-critical">
|
||
<h3>✅ C-01 · 章节覆盖率</h3>
|
||
<p><strong>检查</strong>：原 PDF 中的所有顶级章节（"1 范围"到 "N 参考资料"）在译文中均存在。</p>
|
||
<p><strong>量化指标</strong>：</p>
|
||
<pre>章节覆盖率 = (译文包含的章节数 / 原 PDF 章节数) × 100%</pre>
|
||
<p><strong>阈值</strong>：≥ 95% 通过；85-94% 警告（需在校对区块说明缺失原因）；< 85% 失败。</p>
|
||
<p><strong>已知问题</strong>：</p>
|
||
<ul>
|
||
<li>🔴 <code>AUTOSAR_SRS_TimeService.html</code> 缺失 5 Requirements Tracing、6.1.4 后续、7 References</li>
|
||
<li>🔴 <code>AUTOSAR_SRS_FreeRunningTimer.html</code> 缺失 6.1.2-6.1.5、6.2、7，共 6 章</li>
|
||
</ul>
|
||
</div>
|
||
|
||
<div class="rule-block severity-critical">
|
||
<h3>✅ C-02 · 需求 ID 完整性</h3>
|
||
<p><strong>检查</strong>：原 PDF 中所有 <code>[XXX_NNNNN]</code> 形式的需求 ID 必须在译文中出现。</p>
|
||
<p><strong>量化指标</strong>：</p>
|
||
<pre>需求覆盖率 = (译文中出现的需求 ID 数 / 原 PDF 需求 ID 数) × 100%</pre>
|
||
<p><strong>阈值</strong>：100% 必需。缺失任何一条均为失败。</p>
|
||
<p><strong>验证命令</strong>：</p>
|
||
<pre class="cmd"># 提取 PDF 中所有需求 ID（粗略正则）
|
||
pdftotext input.pdf - | grep -oE '[A-Z]+_[A-Za-z]+_[0-9]{5}' | sort -u > pdf_reqs.txt
|
||
# 提取 HTML 中所有需求 ID
|
||
grep -oE '[A-Z]+_[A-Za-z]+_[0-9]{5}' input.html | sort -u > html_reqs.txt
|
||
# 求差集
|
||
comm -23 pdf_reqs.txt html_reqs.txt</pre>
|
||
</div>
|
||
|
||
<div class="rule-block severity-high">
|
||
<h3>✅ C-03 · 表格行数</h3>
|
||
<p><strong>检查</strong>：译文中每个 <code><table></code> 的行数（含表头）应与原 PDF 对应表格一致。</p>
|
||
<p><strong>允许偏差</strong>：≤ 5%（允许拆分/合并视觉等价的相邻行）。</p>
|
||
</div>
|
||
|
||
<div class="rule-block severity-medium">
|
||
<h3>✅ C-04 · 图与表的存在</h3>
|
||
<p><strong>检查</strong>：原 PDF 中所有 Figure / Table 在译文中至少提及，并提供：</p>
|
||
<ul>
|
||
<li>Figure → ASCII 简化结构 + 中文描述</li>
|
||
<li>Table → 完整 HTML 表格</li>
|
||
</ul>
|
||
</div>
|
||
|
||
<div class="rule-block severity-low">
|
||
<h3>✅ C-05 · 参考资料列表</h3>
|
||
<p><strong>检查</strong>：原 PDF References 章节中的所有引用条目在译文中完整保留。</p>
|
||
</div>
|
||
|
||
<h3 id="style">2.4 风格类（4 项）</h3>
|
||
|
||
<div class="rule-block severity-medium">
|
||
<h3>🎨 F-01 · 不译项严格保留</h3>
|
||
<p><strong>检查</strong>：以下内容<strong>不得翻译</strong>，必须原样保留：</p>
|
||
<ul>
|
||
<li>需求 ID（<code>SRS_HTMSS_00001</code>）</li>
|
||
<li>API / 函数名（<code>Rte_Write_*</code>、<code>HTMSS_Init</code>）</li>
|
||
<li>类型名（<code>Std_ReturnType</code>、<code>boolean</code>）</li>
|
||
<li>宏（<code>FUNC</code>、<code>P2VAR</code>、<code>NULL_PTR</code>）</li>
|
||
<li>文件路径（<code>Platform_Types.h</code>、<code>Compiler.h</code>）</li>
|
||
<li>章节编号 / 页码</li>
|
||
</ul>
|
||
</div>
|
||
|
||
<div class="rule-block severity-medium">
|
||
<h3>🎨 F-02 · 中文为主，英文为辅</h3>
|
||
<p><strong>检查</strong>：除首次术语引入外，正文中英文比例应 ≤ 30%（粗略估计）。</p>
|
||
<p><strong>失败模式</strong>：整段未译、英文堆砌、机翻痕迹。</p>
|
||
</div>
|
||
|
||
<div class="rule-block severity-high">
|
||
<h3>🎨 F-03 · 校对区块诚实性</h3>
|
||
<p><strong>检查</strong>：每篇译文末尾的"校对记录"区块必须：</p>
|
||
<ul>
|
||
<li>✅ 量化每个声明（"X / Y 条需求已译"而非"全部需求已译"）</li>
|
||
<li>✅ 标注已知瑕疵（"⚠ 原文 X 章未译，原因 Y"）</li>
|
||
<li>✅ 引用原 PDF 页码或章节号</li>
|
||
<li>❌ 禁止"完整翻译""全部覆盖""100%"等无证据的绝对词</li>
|
||
</ul>
|
||
<p><strong>模板见 <a href="#template">第 5 节</a>。</strong></p>
|
||
</div>
|
||
|
||
<div class="rule-block severity-low">
|
||
<h3>🎨 F-04 · 格式一致性</h3>
|
||
<p><strong>检查</strong>：标题层级、列表缩进、表格样式与现有译文风格统一。</p>
|
||
</div>
|
||
|
||
<h2 id="thresholds">3 量化阈值</h2>
|
||
<table class="metric-table">
|
||
<thead>
|
||
<tr><th>指标</th><th>权重</th><th>通过</th><th>警告</th><th>失败</th></tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr><td>S-01 元数据完整</td><td>硬性</td><td>100%</td><td>—</td><td>< 100%</td></tr>
|
||
<tr><td>S-02 锚点对应</td><td>硬性</td><td>100%</td><td>—</td><td>< 100%</td></tr>
|
||
<tr><td>C-01 章节覆盖</td><td>硬性</td><td>≥ 95%</td><td>85-94%</td><td>< 85%</td></tr>
|
||
<tr><td>C-02 需求 ID 覆盖</td><td>硬性</td><td>100%</td><td>—</td><td>< 100%</td></tr>
|
||
<tr><td>C-03 表格行数偏差</td><td>硬性</td><td>≤ 5%</td><td>5-10%</td><td>> 10%</td></tr>
|
||
<tr><td>T-01 术语一致</td><td>硬性</td><td>0 违规</td><td>1-2 违规</td><td>≥ 3 违规</td></tr>
|
||
<tr><td>T-03 缩写表正确</td><td>硬性</td><td>= PDF 行数</td><td>—</td><td>≠ PDF 行数</td></tr>
|
||
<tr><td>F-03 校对区块诚实</td><td>硬性</td><td>全部量化</td><td>部分量化</td><td>无量化</td></tr>
|
||
<tr><td>F-01 不译项保留</td><td>软性</td><td>100% 保留</td><td>≤ 2 误译</td><td>> 2 误译</td></tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
<h2 id="ratings">4 评级标准</h2>
|
||
<table class="metric-table">
|
||
<thead>
|
||
<tr><th>评级</th><th>条件</th><th>处理</th></tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr><td><span class="check-pass">A 级（优）</span></td><td>所有硬性指标 100% 通过，软性 ≤ 1 警告</td><td>可作为基准文档</td></tr>
|
||
<tr><td><span class="check-pass">B 级（良）</span></td><td>所有硬性指标通过，软性 ≤ 3 警告</td><td>可发布，附改进计划</td></tr>
|
||
<tr><td><span class="check-warn">C 级（可接受）</span></td><td>1 项硬性指标警告，其余通过</td><td>必须修复警告项</td></tr>
|
||
<tr><td><span class="check-fail">D 级（不达标）</span></td><td>≥ 1 项硬性指标失败</td><td>禁止发布，立即返工</td></tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
<h2 id="template">5 校对区块模板</h2>
|
||
<p>每篇 HTML 末尾的校对记录区块<strong>必须</strong>采用以下模板：</p>
|
||
|
||
<pre class="cmd"><section class="proofread-notes">
|
||
<h3>📋 校对记录</h3>
|
||
<p><strong>校对轮次</strong>：L1 自动校对（YYYY-MM-DD）</p>
|
||
<ul>
|
||
<li>✅ <strong>章节覆盖</strong>：X / Y 章节已译（覆盖率 Z%）</li>
|
||
<li>✅ <strong>需求 ID 覆盖</strong>：A / B 条已译，覆盖率 C%</li>
|
||
<li>✅ <strong>表格覆盖</strong>：P / Q 行已译，覆盖率 R%</li>
|
||
<li>✅ <strong>术语一致性</strong>：与 glossary.html 对齐 N 处</li>
|
||
<li>⚠ <strong>已知瑕疵</strong>：[具体描述及原因]</li>
|
||
</ul>
|
||
<p><strong>质量评级</strong>：<span class="check-pass">A 级</span>（如适用）</p>
|
||
</section></pre>
|
||
|
||
<h2 id="workflow">6 校对工作流</h2>
|
||
<ol>
|
||
<li><strong>翻译完成后立即</strong>执行 L1（不要隔日或异步）</li>
|
||
<li>对照本规则逐项检查（建议使用 grep / sed 辅助）</li>
|
||
<li>填写校对区块（量化指标）</li>
|
||
<li>追加 <code>proofread_log.jsonl</code>：</li>
|
||
</ol>
|
||
|
||
<pre class="cmd">{"timestamp": "...", "stage": "P1", "module": "SystemServices",
|
||
"document": "AUTOSAR_XXX", "pages": N, "pdf_chapters": A, "html_chapters": B,
|
||
"pdf_requirements": C, "html_requirements": D,
|
||
"pdf_tables": E, "html_table_rows": F,
|
||
"result": "L1_pass" | "L1_warn" | "L1_fail",
|
||
"rating": "A" | "B" | "C" | "D",
|
||
"issues": [...], "notes": "..."}</pre>
|
||
|
||
<ol start="5">
|
||
<li>同步更新 <code>progress.md</code> 与 <code>_progress.json</code></li>
|
||
<li>若评级 < B 级：触发返工流程，回到翻译阶段</li>
|
||
</ol>
|
||
|
||
<h2>7 例外与豁免</h2>
|
||
<p>以下情况允许在校对区块明确标注：</p>
|
||
<ul>
|
||
<li><strong>E-01</strong>：原 PDF 自身存在明显错误（如重复章节、空白页）</li>
|
||
<li><strong>E-02</strong>：图（Figure）以 ASCII 简化代替（永久允许）</li>
|
||
<li><strong>E-03</strong>：变更历史（Change History）以摘要形式呈现</li>
|
||
<li><strong>E-04</strong>：免责声明（Disclaimer）可省略（版权信息）</li>
|
||
</ul>
|
||
|
||
<p><strong>任何豁免必须在校对区块显式声明并说明理由，否则视为违规。</strong></p>
|
||
|
||
<footer class="doc-footer">
|
||
规则文档：QUALITY_RULES v1.0 · 维护：opencode translator · 最近更新：2026-06-13
|
||
</footer>
|
||
|
||
</main>
|
||
|
||
</body>
|
||
</html>
|