阿语说明书神器·混排排雷
给消费电子测试、质量、产品、项目人员:把阿语说明书里“看着对,导出却错”的风险定位到段落和页面。
原本需自行组织版本核对、逐段对照、混排检查、页面审查、导出复验五个环节;使用时只需两步:提供材料和审查范围 → 接收疑点报告并按清单补证复验。这是工作流说明,不是耗时或效果承诺。
默认交付 Markdown 报告:已知输入与缺项、段落映射、疑点清单、人工待执行项、返修及复验记录。脚本另出 JSON,保留可追溯编号。所有示例均虚构,任何数值按产品规格;示例阈值不作验收依据。
1. 确定范围并检查输入
先读 输入协议。接受粘贴文本、Markdown、JSON,或宿主可读的文档及页面。用户无需自行写 JSON:由助手从授权材料整理成协议格式,保留页码和段落号,不能猜补文本或版本。
一次核对:匿名对象号、硬件/软件/资料版本、主语言是否冻结、目标语言、快速/完整模式、成品页面与导出版本、审查依据和交付用途。已有信息不重复问。
- 缺主语言、主语言未冻结、缺阿语稿:停止对应内容审查,一次列出缺项并问用户补充;可以先交待填骨架。
- 缺最终页面或页面版本不明:停止视觉通过判断,请补与当前资料版本一致的页面。可以继续文字疑点检查,明确“视觉阻塞”。
- 无法读取的 PDF、图片、表格公式无可核对值:明确阻塞,请提供可读文字及页面;不将 OCR 当成已核实原文,不执行附件脚本或宏。
- 用户说“直接做”也只缩减交付范围,不把缺项变成通过。
2. 建段落映射,分开四层判断
以主语言段落号映射阿语段落号和最终页码,先查漏段、重复、串段。对主语言本身未确认的参数只标待确认,不替它背书。
按 人工检查表 逐项执行:
- 语义:动作主体、否定、顺序、警示因果是否对应;翻译拿不准交阿语母语审校,不凭相同数字认定译文正确。
- 方向:检查数字、负号、范围、单位、百分比、括号、协议缩写和拉丁片段;右对齐不代表 RTL 方向正确。禁止整体反转字符串、无差别删控制符或自动镜像表格。
- 页面:从实际阅读起点逐行检查警示及图标、表格列角色与每行关系、连写和缺字、字体替换、边界裁切。
- 导出:修改后重新导出,既看实际页面,也复制文字核对逻辑顺序;有可访问阅读顺序要求时用目标阅读工具核查。文本抽取不能证明页面通过,页面截图也不能证明可访问顺序通过。
完整版逐页逐段检查四层。快速版至少包含全部技术参数、负号单位、操作表、警示和这些页面的导出复验;未覆盖的部分标未测。所有必核项按适用性裁剪:明确不适用要说明依据;声明存在但材料不足是阻塞,不能写不适用。
3. 可选脚本辅助定位(标准库)
先探测 Python 3;macOS/Linux 用 python3 --version,Windows 探测 py -3 --version 或 python --version,后续固定使用同一解释器。下列命令中的技能目录和输出目录由当前环境确定,均加引号。无 Python 时按人工表交付 Markdown,不声称运行过脚本。脚本不联网、不装依赖、不改输入、不解析 PDF/Office 文件。
python3 "<技能目录>/scripts/review.py" --input "<工作目录>/输入.json" --output "<工作目录>/文字扫描.json"
python3 "<技能目录>/scripts/review.py" --selftest
脚本对每个片段输出 Unicode 方向类别统计、控制符码点及一基字符坐标;比较数字(含符号)和明确提供的单位字面值。阿拉伯数字形态统一后比较,但小数分隔只支持点及阿语小数点,复杂表达式需人工检查。所有命中都叫“疑点”,存在控制符或混排本身不等于缺陷。退出码 0 表示执行成功,2 表示输入/输出错误;结论看 JSON 的 scope、questions 与 findings,不能凭退出码判通过。
不自动插入控制符。HTML/XML 可优先评估方向标记;纯文本需要方向控制时由排版人员按官方说明及目标软件验证,见 来源。
4. 返修与交付
每条记录含:匿名对象号、硬件/软件/资料版本、条目标识、前置与环境、动作、判断依据、实际结果、结论、证据号、执行岗位与时间。结论只用通过、失败、未测、阻塞、不适用;疑点在确认前记录为未测或阻塞。见 报告骨架。
先给范围结论,再给已确认缺陷及未确认疑点,最后给补问与复验清单。缺最终页时明确“本轮仅文字预审,视觉与印刷排版阻塞”。每条返修带位置、依据、修改建议、执行岗位、复核方法;关闭需新版本页面证据与对应复制结果,母语核对未做就保持未测。记录原值,不覆盖用户原稿;输出已存在时换新文件名。
示例与边界
从 examples/任务.md 开始,有完整文字预审和必须停问的案例、预期结果及人工审查示例。脚本不能发现所有跨行倒序、表格串列、字体连写、裁切和翻译错误,必须回到页面及母语审校;不做设备测试、规格真实性确认、法规认证、签字放行、自动发送或发布。
相关技能
spec-sheet-reviewer:先确认规格依据;本技能不重新做规格书审查。manual-spec-cross:负责说明书参数事实对应;本技能负责方向、阅读与版面。hardware-five-gates:负责五道关总表,本技能提供资料专项的证据。quality-8d-review:负责缺陷原因与纠正预防,本技能只定位排版疑点与复验。lulu-office-diagram:负责图示表达,本技能不替代制图。issue-pool-closure/lulu-handover-pack:可接收本轮问题和证据清单;相关技能缺失不影响本技能独立运行。
方法来源
路路有为团队成员多年消费电子产品线一线实践总结,示例均为虚构
关于路路有为
本技能由路路有为(广州路路有为人工智能科技有限责任公司)出品。我们专注把 AI 接进真实的工作和生意,每个技能发布前都经过脚本自测和实测。想按你们的流程、模板和数据定制,在 SkillHub 搜索「路路有为」进入团队主页联系我们。