Add AUTOSAR v4.4 translation pilot: terminology, progress tracker, SRS_BSWGeneral sample

This commit is contained in:
opencode-translator
2026-06-12 15:29:02 +08:00
parent bf21120e94
commit 43ddcf23e4
3 changed files with 710 additions and 0 deletions
+127
View File
@@ -0,0 +1,127 @@
# AUTOSAR v4.4 翻译进度跟踪
> 跟踪 216 个 PDF 的翻译状态。
> 状态说明:⬜ 未开始 | 🟡 进行中 | ✅ 已完成 | ⚠️ 部分完成(仅章节)| ❌ 跳过
---
## 总体进度
| 项 | 数量 | 百分比 |
|---|---|---|
| 总 PDF 数 | 216 | 100% |
| 已完成 | 1 | 0.5% |
| 进行中 | 0 | 0% |
| 未开始 | 215 | 99.5% |
| 跳过 | 0 | 0% |
---
## 试点已完成(Step 2
| 模块 | PDF | 状态 | 译文文件 | 备注 |
|------|------|------|----------|------|
| BSWGeneral | AUTOSAR_SRS_BSWGeneral.pdf | ⚠️ 部分完成 | `BSWGeneral/AUTOSAR_SRS_BSWGeneral.md` | 封面+TOC+Ch 1-3 完整翻译;Ch 4-6 占位;Ch 5 仅 5 条需求作为样例。~150 条需求待补。 |
---
## 阶段计划
### 🟢 P0 - 基础与架构(Step 3
#### General11 PDF
- [ ] AUTOSAR_EXP_AIUserGuide.pdf
- [ ] AUTOSAR_EXP_LayeredSoftwareArchitecture.pdf
- [ ] AUTOSAR_EXP_VFB.pdf
- [ ] AUTOSAR_RS_Features.pdf
- [ ] AUTOSAR_RS_SWCModeling.pdf
- [ ] AUTOSAR_TR_AIDesignPatternsCatalogue.pdf
- [ ] AUTOSAR_TR_AIMeasurementCalibrationDiagnostics.pdf
- [ ] AUTOSAR_TR_PredefinedNames.pdf
- [ ] AUTOSAR_TR_SWCModelingGuide.pdf
- [ ] (其他 2 个 General 模块文档)
#### BSWGeneral13 PDF
- [ ] AUTOSAR_EXP_ApplicationLevelErrorHandling.pdf
- [ ] AUTOSAR_EXP_BSWDistributionGuide.pdf
- [ ] AUTOSAR_EXP_CDDDesignAndIntegrationGuideline.pdf
- [ ] AUTOSAR_EXP_ErrorDescription.pdf
- [ ] AUTOSAR_EXP_InterruptHandlingExplanation.pdf
- [ ] AUTOSAR_SRS_BSWGeneral.pdf — ⚠️ **试点**(部分完成)
- [ ] AUTOSAR_SWS_BSWGeneral.pdf
- [ ] AUTOSAR_SWS_CommunicationStackTypes.pdf
- [ ] AUTOSAR_SWS_CompilerAbstraction.pdf
- [ ] AUTOSAR_SWS_PlatformTypes.pdf
- [ ] AUTOSAR_SWS_StandardTypes.pdf
- [ ] AUTOSAR_TR_BSWModuleList.pdf
- [ ] AUTOSAR_TR_BSWUMLModelModelingGuide.pdf
#### MethodologyAndTemplates36 PDF 中的核心)
- [ ] (详见 `MethodologyAndTemplates/` 目录)
---
### 🟡 P1 - 核心 BSWStep 4
- Communication71
- Diagnostics3
- SystemServices13
- MCAL7
### 🟠 P2 - 扩展 BSWStep 5
- Memory16
- Safety9
- Crypto6
- ModeManagement4
- IO14
### 🔵 P3 - 高级主题(Step 6
- RTE2
- Libraries10
- GlobalTime4
- HMI1
- Chassis1
- Powertrain1
- Tools4
- ReleaseDocumentation2
---
## 已交付文件清单
### Step 1-2 产出
-`翻译术语表.md`v1~250 条术语)
-`翻译进度.md`(本文件)
-`BSWGeneral/AUTOSAR_SRS_BSWGeneral.md`(试点译文)
### 工作目录(不在仓库内)
- `/tmp/opencode/translate_workdir/extracted/` —— PDF 提取的原始文本
- `LayeredSoftwareArchitecture.txt`442KB
- `SRS_BSWGeneral.txt`220KB
- `SWS_COM.txt`544KB
- `/tmp/opencode/translate_workdir/pdf_inventory.txt` —— 完整 PDF 清单
---
## 试点经验总结
### 验证通过
1. `pdftotext -layout` 可正确提取 AUTOSAR PDF 文本,保留版面结构
2. 三个试点 PDFEXP/SRS/SWS 三种类型)均为文本型,无需 OCR
3. 翻译模板(封面 + TOC + 章节 + 需求)格式清晰、可复用
### 试点发现
- PDF 提取后 `⌈⌋` 是 AUTOSAR 需求表格的方框符号,需保留为表格代码块
- 章节编号(5.1.1.1)在 PDF 中可能有空行间隔,但章节顺序稳定
- 需求条目 ID(如 `SRS_BSW_00344`)必须**逐字保留**
### 风险
- 长文档(如 SWS_COM 185 页 / 10K 行)单次 LLM 翻译可能超上下文 → 需按章节分片
- 表格翻译:复杂表格(如 Traceability Matrix)需保持原结构,文字部分用中文替换
- 校对工作量:每篇文档翻译后建议人工抽检关键章节
---
## 下一步
按计划进入 **Step 3:批量翻译 P0**
预计产出:~50 个 P0 文档的中文 Markdown。