From 7e07894422e4c9b5301b3ed4a31bf3be93b4a963 Mon Sep 17 00:00:00 2001
From: oyo <oyo@byteawake.com>
Date: Fri, 12 Sep 2025 17:04:24 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20knowledge-brief.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 knowledge-brief.md | 9 +++++++++
 1 file changed, 9 insertions(+)

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