演进中沉淀的工程原则

架构与契约

• 单一事实源：同一事实只在一处定义，其余引用。槽位配置、数据来源方案、竞争契约、URL 管线通用方法都按此收敛。
• 契约优先且版本化：跨边界交互先定契约，变更靠版本号收敛，版本号进测试断言。
• 规划权威 / 代码契约权威分层：规划文档定架构与设计意图，接口文档定运行实况；两侧不一致时以代码实况校准并回改规划。
• 差异用配置表达：阶段差别只有提示词、契约、检索维度三项，因此收敛为单一引擎 + 阶段参数，不复制流水线。
• 前端零计算：展示元数据由后端单一来源下发，前端不做业务判断。
• 确定性计算不交给模型：能由结构化数据算术推出的结论一律确定性派生（零模型调用、零等待）。

数据与判定

• 自报数据不作跨域派生或组合判定；字段为「对比展示」服务，不承担计算职责。
• 脱离数量的比例无判读价值：比例必须与样本量同屏呈现。
• 负面结论须走规则判定，不做关键词粗筛；新阈值必须有推导，否则登记待验证或删除。
• 近似计算只允许保守方向：可以少判，不能把必亏判成可回收。
• 新鲜度先判状态有效、再用更新时间；三层有效期（采集 / 报告 / 读取侧）不混用。

交付与治理

• 默认安全：未登记或权限不足一律拒绝，不默认放行。
• 可回滚移交：能力下线分阶段执行，先补齐新通道、再软下线、后删除，每阶段留回滚路径，并以流量埋点作为放行门槛。
• 成本内建：令牌预算是设计参数而非事后优化；结论层改确定性派生、默认走轻量检索源，都属这一类。
• 协议跟随官方：不自造协议实现，跟随官方版本与弃用窗口。
• 文档去重与权威分层：重复骨架合并，实例文档指向通用方法。
• 清理纪律：删除判据为「无引用入边 + 无文档 / CI / 测试引用」，运行期数据不删。

质量基线（可核对）

项目	基线
测试	587 passed（2026-09-23 锁定）→ 830 passed（2026-10-30）；测试套件自 2026-09-17 起纳入版本管理
知识资产	营销知识体系 461 条策略规则；80 条质量范本用于生成质量锚定
配置资产	槽位配置单源（21 主 + 22 子 = 43 字段）；交互层移交后精简约 50%
契约资产	archive_contract v1.7；GEO 与竞争输出契约版本入测试断言
文档资产	158 份规划文档，按规划域组织、单一事实源分层治理

一条贯穿始终的判断

每次调整都能对应到一条外部条件变化——协议升级、赛道格局、平台可达性、模型可用性、成本结构或方法论更新。调整方向始终是：把不确定的交给更合适的层，把确定的留在自己手里。

衔接

• 架构收敛的具体过程：四类真实单元
• 竞争引擎的契约收口：V3 · 契约收口与工程重构