跳转到内容

PHITE 深度双语内容编写标准 V2

核心原则:语义一致,而非逐句一致

Section titled “核心原则:语义一致,而非逐句一致”

PHITE 的双语知识采用“一个知识对象、两种语言表示”的模式。中文和英文必须表达同一项治理知识,但不要求句子逐一对应。判断双语是否一致,依据是业务含义、规范力度和关键事实,而不是字面相似度。

中文内容应当像中国 EPC 企业自行编写的正式手册;英文内容应当像面向国际 EPC 与工程管理环境直接编写的专业文件。任何一方都不得以翻译腔、机械转换或混杂界面文字代替原生编写。

以下事实必须在两种语言中保持完全一致:

  • 稳定 ID、版本、状态与权威等级;
  • 日期、数值、对象关系与决定身份;
  • 决策责任人、证据引用、来源引用和实施引用;
  • 任何决定状态及其前置条件。

显示文字可以本地化,但底层事实不得变化。例如,机器状态 Open 可在中文界面显示为“待决”,两者仍指向同一状态。

PHITE 术语必须服从 EPC 双语术语表。同一概念不得在不同页面随意更换译法。FoundationWorkflow 是 PHITE 已治理的架构术语,在中文中有意保留英文;普通说明文字、栏目名称和状态不得因此放弃中文本地化。

当所需术语尚未收录时,作者必须先识别缺口,提出中文与英文用词并说明依据;只有证据充分时才可加入术语表。不得默默创造新译法。

概览、重要性说明、员工指引、决定说明、Workflow 指引和入门内容,应分别用中文和英文独立组织。两种表示可以采用不同句式、段落结构和解释深度,但不得改变业务结论、适用范围或不确定性。

双语编写不得削弱或强化规则。作者必须按受治理语境保持下列力度:

中文表达 英文表达 约束含义
必须 must 强制要求
shall 或 should 按既有治理语境判断强制义务或明确期望
可以 may 获准但非强制
不得 must not 明确禁止
建议 recommended 非强制建议
当前倾向 current leaning / working position 工作假设,不构成批准

“未经批准不得发布”不能写成“建议发布前取得批准”。前者是禁止性规则,后者只是建议,两者不具备语义一致性。

每个正式页面都有稳定 id。同一对象的 zh-CNen 表示使用同一个 ID;标题、文件名、URL、侧边栏文字或语言变化都不改变身份,也不得为语言创建后缀 ID。

id: FDN-DES-001
title: 设计管理
canonical_name: Design Foundation
description: 面向中文检索结果的完整说明。
foundation: design
type: foundation
status: draft
version: "0.1"
owner: PHITE
authority: draft
language: zh-CN
translation_status: complete
effective_date:
last_reviewed:
supersedes:
related:
- project
- document-control
tags:
- phite
- epc
- 设计管理

translation_status 允许 completepartialpending。日期、批准、责任归属或实施目标未知时保持空值;空值不表示已批准。

两种语言必须共享 idfoundationtypestatusversionauthorityownerrelateddecision_refssource_refsimplementation。这些字段存在差异时,知识清单生成必须失败并阻止进入 Review。

对登记册类知识,还应校验每条记录的稳定 ID、状态、责任人、对象关系及来源或证据引用。系统只比较可确定的规范事实,不执行逐句翻译相似度检查;原生叙述的语义一致性由人工复核。

技术实现引用保留真实标识,例如 projectsprocurement_requestsproject_idstatuscreated_at。中文正文负责解释其含义,但不得翻译 Collection、字段或其他机器标识。

知识清单和未来检索系统必须把 FDN-COST-001 zh-CNFDN-COST-001 en 识别为同一知识对象。页面应暴露:

id: FDN-COST-001
language: zh-CN
canonical_object: FDN-COST-001

canonical_object 从既有稳定 ID 派生,不在 frontmatter 中复制第二份事实。检索可以按用户语言返回表示,但权威等级不随语言变化;发现语义冲突时必须报告,不得由相似度自动选择“权威”版本。

正式 Foundation 知识存放在 .md.mdx。组件可以改善呈现,但关键规则不得只存在于组件、JSON、数据库、生成后的 HTML、图片或图表中。relateddecision_refssource_refs 与实施关联必须结构化;正文应链接到知识责任方,不复制其他 Foundation 的规则定义。

Handbook 变更进入 Review 前必须完成:

Terminal window
npm test
npm run manifest
npm run check
npm run lint
npm run build

校验范围包括复合身份、Tier 1 配对、元数据一致性、登记册严格事实、路由、语言切换、中英文搜索、知识清单新鲜度、Astro、Relay、链接、浅色与深色模式、桌面与移动端呈现。涉及双语页面时,两种表示都必须经过人工视觉检查。

内容生成和导出不得直接写入 GBrain、向量数据库、记忆系统、NocoBase 或生产环境。未来的数据摄取必须另行批准架构、访问策略和执行授权。代码存在、翻译完成或 Preview 部署成功,都不会把 Draft 自动提升为 Frozen、Approved 或其他更高成熟度。

PHITE 任务执行与汇报标准 V1.0 规定重大任务如何分层呈现简体中文 Owner 汇报与英文技术证据。它是唯一的任务汇报规则,不得复制出第二份标准。

状态:Draft。 本标准在 PHITE 治理批准前不具备正式规范权威。