PHITE 深度双语内容编写标准 V2
核心原则:语义一致,而非逐句一致
Section titled “核心原则:语义一致,而非逐句一致”PHITE 的双语知识采用“一个知识对象、两种语言表示”的模式。中文和英文必须表达同一项治理知识,但不要求句子逐一对应。判断双语是否一致,依据是业务含义、规范力度和关键事实,而不是字面相似度。
中文内容应当像中国 EPC 企业自行编写的正式手册;英文内容应当像面向国际 EPC 与工程管理环境直接编写的专业文件。任何一方都不得以翻译腔、机械转换或混杂界面文字代替原生编写。
三类双语内容
Section titled “三类双语内容”A. 严格一致
Section titled “A. 严格一致”以下事实必须在两种语言中保持完全一致:
- 稳定 ID、版本、状态与权威等级;
- 日期、数值、对象关系与决定身份;
- 决策责任人、证据引用、来源引用和实施引用;
- 任何决定状态及其前置条件。
显示文字可以本地化,但底层事实不得变化。例如,机器状态 Open 可在中文界面显示为“待决”,两者仍指向同一状态。
B. 受控术语
Section titled “B. 受控术语”PHITE 术语必须服从 EPC 双语术语表。同一概念不得在不同页面随意更换译法。Foundation 与 Workflow 是 PHITE 已治理的架构术语,在中文中有意保留英文;普通说明文字、栏目名称和状态不得因此放弃中文本地化。
当所需术语尚未收录时,作者必须先识别缺口,提出中文与英文用词并说明依据;只有证据充分时才可加入术语表。不得默默创造新译法。
C. 原生编写
Section titled “C. 原生编写”概览、重要性说明、员工指引、决定说明、Workflow 指引和入门内容,应分别用中文和英文独立组织。两种表示可以采用不同句式、段落结构和解释深度,但不得改变业务结论、适用范围或不确定性。
规范力度必须一致
Section titled “规范力度必须一致”双语编写不得削弱或强化规则。作者必须按受治理语境保持下列力度:
| 中文表达 | 英文表达 | 约束含义 |
|---|---|---|
| 必须 | must | 强制要求 |
| 应 | shall 或 should | 按既有治理语境判断强制义务或明确期望 |
| 可以 | may | 获准但非强制 |
| 不得 | must not | 明确禁止 |
| 建议 | recommended | 非强制建议 |
| 当前倾向 | current leaning / working position | 工作假设,不构成批准 |
“未经批准不得发布”不能写成“建议发布前取得批准”。前者是禁止性规则,后者只是建议,两者不具备语义一致性。
稳定身份与语言表示
Section titled “稳定身份与语言表示”每个正式页面都有稳定 id。同一对象的 zh-CN 与 en 表示使用同一个 ID;标题、文件名、URL、侧边栏文字或语言变化都不改变身份,也不得为语言创建后缀 ID。
id: FDN-DES-001title: 设计管理canonical_name: Design Foundationdescription: 面向中文检索结果的完整说明。foundation: designtype: foundationstatus: draftversion: "0.1"owner: PHITEauthority: draftlanguage: zh-CNtranslation_status: completeeffective_date:last_reviewed:supersedes:related: - project - document-controltags: - phite - epc - 设计管理translation_status 允许 complete、partial、pending。日期、批准、责任归属或实施目标未知时保持空值;空值不表示已批准。
元数据与关系校验
Section titled “元数据与关系校验”两种语言必须共享 id、foundation、type、status、version、authority、owner、related、decision_refs、source_refs 与 implementation。这些字段存在差异时,知识清单生成必须失败并阻止进入 Review。
对登记册类知识,还应校验每条记录的稳定 ID、状态、责任人、对象关系及来源或证据引用。系统只比较可确定的规范事实,不执行逐句翻译相似度检查;原生叙述的语义一致性由人工复核。
业务标识与系统标识
Section titled “业务标识与系统标识”技术实现引用保留真实标识,例如 projects、procurement_requests、project_id、status、created_at。中文正文负责解释其含义,但不得翻译 Collection、字段或其他机器标识。
AI 表示规则
Section titled “AI 表示规则”知识清单和未来检索系统必须把 FDN-COST-001 zh-CN 与 FDN-COST-001 en 识别为同一知识对象。页面应暴露:
id: FDN-COST-001language: zh-CNcanonical_object: FDN-COST-001canonical_object 从既有稳定 ID 派生,不在 frontmatter 中复制第二份事实。检索可以按用户语言返回表示,但权威等级不随语言变化;发现语义冲突时必须报告,不得由相似度自动选择“权威”版本。
正式内容形态与来源
Section titled “正式内容形态与来源”正式 Foundation 知识存放在 .md 或 .mdx。组件可以改善呈现,但关键规则不得只存在于组件、JSON、数据库、生成后的 HTML、图片或图表中。related、decision_refs、source_refs 与实施关联必须结构化;正文应链接到知识责任方,不复制其他 Foundation 的规则定义。
Review 前校验
Section titled “Review 前校验”Handbook 变更进入 Review 前必须完成:
npm testnpm run manifestnpm run checknpm run lintnpm run build校验范围包括复合身份、Tier 1 配对、元数据一致性、登记册严格事实、路由、语言切换、中英文搜索、知识清单新鲜度、Astro、Relay、链接、浅色与深色模式、桌面与移动端呈现。涉及双语页面时,两种表示都必须经过人工视觉检查。
安全与权威边界
Section titled “安全与权威边界”内容生成和导出不得直接写入 GBrain、向量数据库、记忆系统、NocoBase 或生产环境。未来的数据摄取必须另行批准架构、访问策略和执行授权。代码存在、翻译完成或 Preview 部署成功,都不会把 Draft 自动提升为 Frozen、Approved 或其他更高成熟度。
任务执行与汇报
Section titled “任务执行与汇报”PHITE 任务执行与汇报标准 V1.0 规定重大任务如何分层呈现简体中文 Owner 汇报与英文技术证据。它是唯一的任务汇报规则,不得复制出第二份标准。
状态:Draft。 本标准在 PHITE 治理批准前不具备正式规范权威。