更新 knowledge-brief.md

knowledge-brief.md

@@ -15,6 +15,15 @@ TOCO采用严格的分层架构：
 
 技术栈：Java + SpringBoot + MyBatis-plus（读）+ Hibernate（写）
 
+##平台能力边界说明：
+TOCO的设计模型旨在规范系统结构、统一数据契约与接口形态，自动生成约80%的基础代码框架（如控制器签名、DTO转换、读写方案执行器等）。
+然而，业务行为逻辑（如条件判断、动态路由、状态流转、异常处理、多源聚合、性能优化路径等）无法由设计自动推导或生成，必须由人工编码实现。
+因此：
+设计元素仅表达“系统能做什么”（接口定义、数据结构、依赖关系）；
+**代码实现才是“系统正在做什么”**的唯一真实来源；
+设计与代码之间存在不可逾越的行为鸿沟——设计不记录实现细节，代码不反馈回设计；
+任何对系统行为的分析、影响评估或变更决策，都必须同时考察结构层面的设计信息与行为层面的代码实现，二者缺一不可。
+
 ## 重要设计元素详解
 
 ### 1. 模块（Module）