一段双语字幕进入素材验收记录后，最容易被忽略的往往不是文字本身，而是它出现时采用了哪一组显示规则。中文转法文还是中文转英文？是 18sp 还是 26sp？字幕是白色、暖黄色还是青蓝色？这些变化表面上属于界面设置，实际会直接影响阅读顺序、画面遮挡和后续人员对材料来源的判断。

如果验收记录只保存一句双语文字，后续人员无法知道这句话是在什么语言组合、什么字号、什么颜色下被检查过的；如果只保存配置，又会把“配置已应用”误写成“文字已经来自组件输出”。对影像质量与素材验收工程师来说，正确的目标不是把字幕做得更像最终成片，而是让一条可见文字在交接后仍能回答三个问题：它按什么规则显示、它来自哪里、谁复核过它。

当前项目将语言、字号、颜色、文本来源和人工复核拆成独立状态。模拟器可以产生一段带来源标签的本地分析材料，也可以模拟输入异常；这让字幕配置本身能够被重复检查，同时避免把固定片段、人工转述或组件状态混成一个“字幕已完成”的结论。

场景解说：待补画面应展示源语言、目标语言、字号、颜色、文本来源和人工复核均未形成记录的初始状态。它能证明页面还没有把预设文本当成结果，不能证明语音内容不存在或字幕组件不可用。

配置快照：双语字幕为何不是单一设置

在素材验收场景中，语言配置不应只被理解为一个下拉选项。它更像一份与当前字幕片段绑定的快照：源语言决定人员如何理解原始语音的语境，目标语言决定交接对象能读取什么，字号和颜色决定这段文字是否仍能在影像上被读清。任何一项变更，都可能使“上一轮已经复核过”的结论失去适用范围。

当前页面的语言切换会同时写入源语言与目标语言；字号切换会映射为组件字号选项；颜色切换会更新展示颜色。这些状态是配置事实，因此可以由页面直接观察和重复操作。

this.sourceLanguage = 'zh-CN';
this.targetLanguage = mode === '中文 → 法文' ? 'fr-FR' : 'en-US';
this.captionFontSize = AICaptionFontSize.NORMAL;
this.captionFontColor = fontColor;

这段代码能够证明页面为当前会话保存了语言和样式配置，并以这些参数组织展示。它不能证明字幕文字由组件产生，也不能证明目标语言文字在语义上已经通过人工审核。

验收记录中应把这组快照写得足够具体，例如“zh-CN → fr-FR、22sp、暖黄色、当前片段 00:07”。这样做不是增加表单负担，而是限制结论的适用范围：后续若改成英文、放大字号或换成青蓝色，就应重新判断可读性与遮挡，而不是沿用旧结论。

场景解说：待补画面应显示源/目标语言、字号和颜色的独立入口，证明配置可被逐项核对。它不能证明当前可见文字已经过识别、翻译或内容审校。

结论失效：配置变化后为何不能沿用复核

“文字没变，只改了颜色”看似不需要重新审核，实际上可能正好改变了素材的阅读风险。暖黄色在深色画面中可读，不代表在高亮的工程现场画面中仍然可读；26sp 更易阅读，也可能遮住设备编号、告警区域或关键操作指示。语言变化同样如此：中文短句转换为法文后，文字长度和换行位置都可能改变。

因此，人工复核应把配置变更视为新的待验收条件，而不是把历史复核状态永久挂在一段文本上。当前页面在选择语言、字号和颜色时更新本地反馈，但不会自动把人工复核写成“已通过”。这条边界避免了页面把一次点击当作质量结论。

配置变化	应重新检查的对象	可保留的历史事实	不应沿用的结论
目标语言改变	断句、长度、术语和阅读顺序。	原始片段的来源标签。	上一语言的内容可读性。
字号改变	遮挡范围、换行、移动端可读性。	当前片段时间和来源。	上一字号下的画面完整性。
颜色改变	与背景的对比度和警示色冲突。	配置变更发生的时间。	上一颜色下的可读性。
文本来源改变	组件回调、人工转述或本地分析材料。	已选择的展示规则。	上一来源的证据等级。

这个表也解释了“复核边界”的含义：人工可以确认某组配置下的视觉呈现，却不能把这种确认扩大为对所有语言、所有尺寸或所有文字来源的通用背书。

文本来源：先标明来源再判断显示

字幕片段可能来自组件回调、人工转述、本地分析素材，或者根本还没有文本。这几种来源的视觉效果可以相同，证据等级却完全不同。若先讨论“这段法文是否漂亮”，再回头补来源标签，通常已经来不及判断旧截图和旧记录究竟对应哪一种输入。

当前项目生成模拟器片段时，会主动写入“非 AICaptionComponent 回调”的来源说明；发生输入异常时，页面改为“无文本来源”，并禁止用固定文字填补空缺。

this.simulatorCaptionState = '本地字幕片段已生成，等待人工复核';
this.simulatorTextSource = `模拟器分析素材 · ${segment.time} · 非 AICaptionComponent 回调`;
this.simulatorResultText = this.displayedTranslation(segment);

这段代码能够证明本地片段带有时间与来源标签，且展示文本按当前目标语言选择。它不能证明 Speech Kit 识别了音频、完成了翻译，也不能说明固定片段反映真实语音的停顿或延迟。

对素材验收而言，来源标签的价值在于让人工复核知道自己在审什么：若是本地分析素材，复核重点是字号、颜色、行距、遮挡和说明文案；若是组件回调，则还需要检查输入状态、回调时间和文本内容；若无来源，则不能进入内容审核，只能保留异常和待补动作。

人工边界：复核人员实际检查什么

人工复核不是点击一次“通过”，而是针对一个明确对象做判断。对于双语字幕，至少要拆成四项：配置是否符合当前交接对象；文本来源是否明确；字幕是否遮挡关键影像区域；文字的断句和术语是否能被当前人员理解。前两项解决可追溯性，后两项解决可读性与使用风险。

当前页面只在存在可标注来源的本地片段时允许记录人工复核。若页面处于输入异常、没有文本来源的状态，复核动作会被阻断。这避免了“先盖章、再补文本”的倒序操作。

if (this.simulatorCaptionState.indexOf('已生成') < 0) {
  this.simulatorReviewState = '人工复核被阻断：当前没有可标注来源的本地字幕片段。';
  return;
}
this.simulatorReviewState = '人工复核已记录：配置已应用，文本来源为模拟器分析素材，不代表真实组件输出。';

这段代码能够证明人工复核以“来源可标注”为前提，并明确指出本地分析材料的边界。它不能证明人工已经审核任何真实语音内容，也不能对翻译准确率给出结论。

实际操作时，复核备注可以写成：“当前片段为模拟器分析素材，配置为中文到法文、22sp、暖黄色；在当前画面中未遮挡设备铭牌，断句可读；待有组件回调时另行核对来源与文本。”这比“字幕正常”更长，但每一句都能回到具体判断。

异常处理：输入异常时哪些检查可以继续

输入异常并不意味着整页都失去价值。源语言、目标语言、字号和颜色仍然可以被检查，页面布局和遮挡风险也仍可借助已有分析素材演练；但本次异常状态下不能写“当前语音已形成字幕”，更不能让固定文字顶替缺失的输入结果。

当前项目在异常分支中将来源写为“无文本来源”，把结果区改为等待重新输入或人工转述，并把复核限制在来源缺口之外。这种处理让异常本身变成可交接的信息：下一位人员知道配置已经准备好，缺的是文本输入或回调，而不是重复去设置语言和颜色。

当前状态	可以继续完成的工作	必须暂停的结论	交接时应留下什么
配置已选择、无文本来源	检查样式控制、布局和异常提示。	文本内容、翻译质量、字幕已生成。	缺失的是输入或回调。
本地分析素材已生成	检查视觉呈现和来源标签。	组件识别、真实延迟、语义准确率。	本地材料的时间和用途。
组件准备状态出现	检查组件状态与配置参数。	某一字幕片段已返回。	prepared 或 error 的时间。
人工转述已录入	检查人工文本的可读性。	自动识别或翻译已成功。	转述人、复核人和适用范围。

这张分流表的核心不是限制写作，而是避免把“可以继续分析”误解成“可以继续下业务结论”。模拟器正适合验证这类分支：它能让异常、来源、配置和复核状态稳定出现，便于截图和文章解释。

交接记录：双语字幕怎样避免混写

推荐把一条交接记录写成四行，而不是一句概括。第一行记录配置快照；第二行记录文本来源；第三行记录人工复核对象与结果；第四行记录尚未取得的证据。例如：

记录项	示例写法
配置快照	zh-CN → fr-FR、22sp、暖黄色、当前片段 00:07。
文本来源	模拟器分析素材，非组件回调。
人工复核	未遮挡关键区域，断句可读，适用于当前画面。
待补证据	真实组件输入、回调时间和内容复核尚未形成。

这种写法让后续人员不需要反向猜测“已通过”指的到底是样式、文字还是组件运行。若配置后续变化，只需复制原结构生成新的一组记录；若文本来源变化，也不会覆盖旧记录的用途。

错误归因：三种误判如何避免

把颜色问题归因给翻译。 当暖黄色在浅色背景上不清楚时，问题是视觉对比，不是目标语言文字有错。应先调整颜色或背景策略，再讨论文本内容。

把来源不明归因给组件异常。 页面显示一段文字却没有来源标签时，不能直接判断组件失败；可能是本地样本、人工草稿或旧状态残留。正确动作是先回到来源卡，确认这段文字属于哪一层。

把人工复核归因给全局通过。 人工确认的是当前配置、当前画面和当前来源条件下的呈现，不是对所有双语字幕、所有业务语境的永久授权。记录必须带上范围，才能避免同一结论在别处被错误复用。

这三类错误看似是文案问题，实质上都是证据层混淆。账号3的职责就是把这种混淆提前截断，让素材交接保留足够的判断依据，而不是只留下一个好看的双语成品。

FAQ

字幕的目标语言改了，是否只需要更新一行文案？

不够。目标语言变化会影响文本长度、断句和术语，也可能改变对画面的遮挡范围。应保存新的配置快照，并重新完成当前画面的可读性复核。

模拟器片段可以支持哪些验收动作？

可以检查语言、字号、颜色、布局、来源标签、异常出口和人工复核流程。它不能证明自动识别、翻译准确率、真实语音时序或外部发布状态。

为什么有了人工复核，还要保留文本来源？

人工复核说明谁在何种条件下做了判断；来源标签说明被判断的文字来自哪里。两项缺一不可，不能由人工确认把本地分析材料升级为组件回调。

必要条件｜从SDK到设备的依赖链路

本文技术点的运行链路必须按以下顺序成立：

1. SDK/API：工程使用 HarmonyOS 6.1.1（API 24），DevEco Studio 和 Hvigor 能完成 entry 模块构建。

   

2. Kit：源码实际引入本文所需 Kit，例如 @kit.CameraKit、@kit.MapKit、@kit.NotificationKit、@kit.SpeechKit 或 @kit.VisionKit。

3. 模块/页面：页面路由写入 main_pages.json，模块保持 Stage 配置，相关权限写入 entry/src/main/module.json5。

4. 权限：动态能力调用前完成 CAMERA、MICROPHONE 或其他系统授权；网络页面确认 INTERNET 已声明。

5. 系统能力/硬件：设备满足本文 API 和能力要求。相机、麦克风、地图、CardRecognition 等能力缺失时必须进入降级分支。
   

MapKit文章在上述链路后增加服务配置：在 AppGallery Connect 创建或选择项目，绑定与工程一致的包名和签名证书，进入服务管理开通 MapKit，并按控制台要求完成应用服务凭据/授权配置；不要在文章或源码中公开 App ID、Client ID、API 密钥或私钥。完成后再验证地图初始化、搜索或事件回调。