mta-mcp 2.14.0 → 2.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mta-mcp",
-  "version": "2.14.0",
+  "version": "2.16.0",
   "description": "MTA - 智能项目分析与编码规范管理 MCP 服务器",
   "type": "module",
   "main": "./dist/index.js",

package/standards/core/mandatory-rules.md

@@ -0,0 +1,103 @@
+# 底层必须规则（Mandatory Rules）
+
+> 此规范由 MCP 底层自动注入，所有规范请求都会附加此内容。
+> 版本: v1.0.0 | 最后更新: 2026-01-16
+
+---
+
+## 🚨 零容忍规则
+
+**这些规则在任何情况下都不能违反，优先级最高：**
+
+### 1. 完整的标签配对
+
+```html
+✅ <div>...</div>
+✅ <el-table>...</el-table>
+❌ <div>...<div>  <!-- 缺少结束标签 -->
+❌ </div>         <!-- 孤立的结束标签 -->
+```
+
+### 2. 禁止 `any` 类型
+
+```typescript
+// ❌ 禁止
+const data: any = {}
+function process(input: any) {}
+
+// ✅ 正确
+const data: Record<string, unknown> = {}
+function process(input: UserData) {}
+```
+
+### 3. 国际化强制使用
+
+```vue
+<!-- ✅ 正确 -->
+<el-button>{{ $t('提交') }}</el-button>
+:label="$t('名称')"
+:placeholder="$t('请输入')"
+
+<!-- ❌ 硬编码 -->
+<el-button>提交</el-button>
+label="名称"
+```
+
+---
+
+## ⚠️ 强制工作流
+
+### 问题诊断优先
+
+当用户描述问题时（错误、样式不对、效果不符预期），必须先调用：
+
+```
+troubleshoot({ problem: "用户描述的问题" })
+```
+
+### 规范加载验证
+
+在生成代码前，必须确认已加载相关规范：
+
+1. **检查项目作用域** - 确认文件路径属于当前项目
+2. **声明已加载** - 在响应中说明：`✅ 已加载规范: [规范名称]`
+
+---
+
+## 🔍 代码审查清单
+
+**每次编辑后必检：**
+
+- [ ] 所有 HTML 标签正确闭合
+- [ ] Vue SFC 只有一个 `<style>` 标签
+- [ ] 所有用户可见文本已国际化
+- [ ] 无 `any` 类型
+- [ ] Props/Emits 有完整类型定义
+
+---
+
+## 🚫 全局禁止模式
+
+| 禁止 | 替代方案 |
+|------|----------|
+| `any` 类型 | 具体类型或 `unknown` |
+| Options API | Composition API (`<script setup>`) |
+| 直接修改 Props | emit 事件或 computed |
+| `<script>` 中使用 `this` | 使用响应式变量 |
+| 多个 `<style>` 标签 | 合并为一个 |
+| 硬编码文本 | `$t('...')` 国际化 |
+
+---
+
+## 📋 最小改动原则
+
+| 判断项 | 是 | 否 |
+|--------|---|---|
+| 修改只影响当前文件？ | 继续修改 | **停止，重新评估** |
+| 存在类似模式？ | **复用现有模式** | 可新建 |
+| 需要改组件类型？ | **先确认用户意图** | 继续 |
+| 需要删除现有代码？ | **先确认必要性** | 继续 |
+
+---
+
+**此规范自动注入，无需手动加载。**

package/standards/frameworks/flutter.md

@@ -996,6 +996,84 @@ class UserProfile extends StatelessWidget {
 
 ---
 
+## 📝 TextField 垂直居中规范（重要）
+
+> ⚠️ **此问题曾导致 15+ 轮对话才修复，必须一步到位**
+
+### 问题场景
+TextField 中 placeholder、光标、输入内容三者需要在固定高度容器中垂直居中对齐。
+
+### 正确方案（一步到位）
+
+```dart
+// ✅ 正确 - Container.alignment + 统一 height + contentPadding.zero
+Widget _buildCenteredTextField(String placeholder, TextEditingController controller) {
+  return Container(
+    height: 36, // 固定容器高度
+    alignment: Alignment.center, // 关键1：让 TextField 整体居中
+    child: TextField(
+      controller: controller,
+      textAlign: TextAlign.center,
+      style: const TextStyle(
+        fontSize: 14,
+        height: 1.43, // 关键2：行高 = 期望文本高度 ÷ 字号
+      ),
+      decoration: InputDecoration(
+        hintText: placeholder,
+        hintStyle: const TextStyle(
+          fontSize: 14,
+          height: 1.43, // 关键3：必须与 style.height 完全一致
+        ),
+        contentPadding: EdgeInsets.zero, // 关键4：清除默认 padding
+        isDense: true, // 关键5：移除额外空间
+        border: InputBorder.none,
+      ),
+    ),
+  );
+}
+
+// ❌ 错误 - 会导致 placeholder 和输入内容位置不一致
+TextField(
+  textAlignVertical: TextAlignVertical.center, // 只影响输入内容
+  style: TextStyle(fontSize: 14, height: 1.43),
+  decoration: InputDecoration(
+    hintStyle: TextStyle(fontSize: 14), // height 不一致！
+    contentPadding: EdgeInsets.symmetric(vertical: 8), // 干扰居中
+  ),
+)
+```
+
+### 行高计算公式
+
+从设计稿获取：
+- 容器高度：36px
+- 文本 Y 坐标：8px（距顶部）
+- 文本高度：20px
+- 字号：14px
+
+```
+height = 文本高度 ÷ 字号 = 20 ÷ 14 = 1.43
+```
+
+### 禁止事项
+
+| 禁止 | 原因 |
+|------|------|
+| `style.height` ≠ `hintStyle.height` | placeholder 和输入内容位置不一致 |
+| 同时用 `textAlignVertical` 和 `height` | 产生冲突，效果不可预测 |
+| 用 `strutStyle + forceStrutHeight` | 可能压缩文字 |
+| 反复调整 `contentPadding` 试错 | 应先确定行高配置 |
+
+### 调试顺序（遇到问题时）
+
+1. 先从设计稿获取：容器高度、文本 Y 坐标、文本高度
+2. 计算 `height = 文本高度 ÷ 字号`
+3. 确保 `style.height` = `hintStyle.height`
+4. 设置 `Container.alignment: Alignment.center`
+5. 设置 `contentPadding: EdgeInsets.zero` + `isDense: true`
+
+---
+
 ## 🎨 Sketch/Figma 设计稿还原规范
 
 > ⚠️ **此章节为强制执行规范** - 所有 UI 还原任务必须严格遵循