Merge commit '3d83740f88b6aaba6962256be517656496b83f25' into lsp-server

2026-05-24 13:04:22 +08:00
parent 7aa60e78f8 3d83740f88
commit 696920df73
292 changed files with 30774 additions and 218828 deletions
@@ -0,0 +1,60 @@
+# 系统模式与约束
+
+<!--
+填写指南：
+- 本文件记录跨模块稳定成立的实现模式，而不是一次性的设计草图
+- 优先记录：模块边界、数据流、不变量、扩展路径、禁止破坏的约束
+- 小项目可只保留最关键的 2-3 个部分
+-->
+
+## 模块边界
+
+<!-- 至少列出主要模块及其职责边界 -->
+
+### {{MODULE_1}}
+
+- **职责**：{{MODULE_1_DESC}}
+- **输入**：{{MODULE_1_INPUT}}
+- **输出**：{{MODULE_1_OUTPUT}}
+- **不应负责**：{{MODULE_1_NON_GOAL}}
+
+## 关键数据流
+
+<!-- 描述系统中的主路径；按“输入 -> 处理 -> 输出”写 -->
+
+1. {{FLOW_STEP_1}}
+2. {{FLOW_STEP_2}}
+3. {{FLOW_STEP_3}}
+
+## 核心不变量
+
+<!-- 这些约束一旦被破坏，系统行为就可能失真 -->
+
+- {{INVARIANT_1}}
+
+## 常见实现模式
+
+<!-- 给 AI 明确“这里通常怎么改” -->
+
+### {{PATTERN_1}}
+
+- **适用场景**：{{PATTERN_1_SCENARIO}}
+- **推荐做法**：{{PATTERN_1_APPROACH}}
+- **避免事项**：{{PATTERN_1_AVOID}}
+
+## 扩展路径
+
+<!-- 新增功能时，优先走哪些入口或目录 -->
+
+1. {{EXTENSION_STEP_1}}
+2. {{EXTENSION_STEP_2}}
+
+## 禁止破坏的约束
+
+<!-- 记录兼容性、安全性或组织层面的硬约束 -->
+
+- {{DO_NOT_BREAK_1}}
+
+---
+
+**最后更新**：{{DATE}}