mta-mcp 2.15.0 → 2.16.0

package/agents/flutter.agent.md

@@ -1,7 +1,7 @@
 # Flutter 开发代理
 
 > 此 Agent 引导 AI 通过 MCP 工具获取 npm 包中的详细规范
-> 版本: v3.0.0 | 最后更新: 2026-01-16
+> 版本: v3.1.0 | 最后更新: 2026-01-19
 
 ---
 
@@ -22,6 +22,41 @@ troubleshoot({ problem: "用户描述的问题" })
 | 阴影被裁剪 | clip, shadow, clipBehavior |
 | SVG 颜色/居中问题 | svg, color, viewbox |
 | 输入框边框异常 | input, border, focus |
+| **TextField 垂直居中** | textfield, placeholder, 居中, 光标, 输入框 |
+
+---
+
+## ⚠️ TextField 垂直居中（高频问题）
+
+> 此问题曾导致 15+ 轮对话才修复，必须一步到位
+
+### 问题特征
+- placeholder 和输入内容位置不一致
+- 光标位置偏上/偏下
+- 修改一个问题引发另一个问题
+
+### 正确方案（直接使用）
+
+```dart
+Container(
+  height: 36, // 设计稿容器高度
+  alignment: Alignment.center, // 关键1
+  child: TextField(
+    style: TextStyle(fontSize: 14, height: 1.43), // 关键2: 行高 = 文本高度÷字号
+    decoration: InputDecoration(
+      hintStyle: TextStyle(fontSize: 14, height: 1.43), // 关键3: 必须与style一致
+      contentPadding: EdgeInsets.zero, // 关键4
+      isDense: true, // 关键5
+    ),
+  ),
+)
+```
+
+### 禁止事项
+- ❌ `style.height` ≠ `hintStyle.height`
+- ❌ 同时用 `textAlignVertical` 和 `height`
+- ❌ 用 `strutStyle + forceStrutHeight`
+- ❌ 反复调整 `contentPadding` 试错
 
 ---
 
@@ -101,5 +136,38 @@ get_standard_by_id({ ids: ['flutter', 'flutter-ui-system'] })
 
 ---
 
+## 🎨 设计稿还原强制规范
+
+> ⚠️ 使用 Sketch/Figma MCP 时必须遵守
+
+### 强制要求：完整读取选中元素及其所有子集
+
+```javascript
+// 正确：一次性获取容器+所有子元素的完整信息
+function extractComplete(element) {
+  // 1. 容器信息
+  console.log(`容器: ${element.frame.width}x${element.frame.height}`);
+  
+  // 2. 所有子元素信息（关键！）
+  element.layers.forEach(child => {
+    console.log(`子元素: ${child.name}`);
+    console.log(`  位置: Y=${child.frame.y}px`);
+    console.log(`  尺寸: ${child.frame.width}x${child.frame.height}`);
+    if (child.type === 'Text') {
+      console.log(`  字号: ${child.style.fontSize}px`);
+      console.log(`  行高: ${child.frame.height / child.style.fontSize}`);
+    }
+  });
+}
+```
+
+### 禁止事项
+- ❌ 只读容器属性，忽略内部元素位置
+- ❌ 每次只查一个属性，分散多轮获取
+- ❌ 假设"差不多"而不验证精确像素值
+- ❌ 用"试错法"调整参数
+
+---
+
 **维护团队**: MTA工作室  
 **设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取

package/package.json

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

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 还原任务必须严格遵循

package/standards/troubleshooting-cases/flutter/textfield-vertical-centering.md

@@ -0,0 +1,107 @@
+# TextField 垂直居中问题
+
+**问题标签**: `textfield`, `居中`, `placeholder`, `光标`, `输入框`, `vertical-align`  
+**问题类型**: `UI 对齐`  
+**严重程度**: 高  
+**节省时间**: 15+ 轮对话 → 1 轮
+
+---
+
+## 问题描述
+
+TextField 中 placeholder、光标、输入内容三者需要在固定高度容器中垂直居中对齐，但出现以下问题：
+- placeholder 和输入内容位置不一致
+- 光标位置偏上或偏下
+- 修改一个问题引发另一个问题
+
+## 问题根因
+
+Flutter TextField 的垂直对齐涉及多个相互作用的属性：
+- `style.height` - 输入文本的行高
+- `hintStyle.height` - placeholder 的行高
+- `contentPadding` - 内边距
+- `isDense` - 紧凑模式
+- `textAlignVertical` - 垂直对齐
+- `strutStyle` - 行高基准
+
+**核心问题**：这些属性相互影响，单独调整一个可能破坏其他元素的对齐。
+
+## 错误尝试（导致反复）
+
+| 尝试 | 结果 |
+|------|------|
+| 只调整 `contentPadding` | 整体偏移，不居中 |
+| 用 `textAlignVertical: center` | 只影响输入内容，placeholder 不动 |
+| 用 `strutStyle + forceStrutHeight` | 文字被压缩变形 |
+| `style.height` ≠ `hintStyle.height` | placeholder 和输入内容位置不一致 |
+
+## 正确方案
+
+### 从设计稿获取数值
+
+```javascript
+// Sketch 提取脚本
+const container = sketch.find('[name="Input"]', artboard)[0];
+const text = container.layers.find(l => l.type === 'Text');
+
+console.log(`容器高度: ${container.frame.height}px`);        // 36
+console.log(`文本 Y 坐标: ${text.frame.y}px`);               // 8
+console.log(`文本高度: ${text.frame.height}px`);              // 20
+console.log(`字号: ${text.style.fontSize}px`);                // 14
+console.log(`行高倍数: ${text.frame.height / text.style.fontSize}`);  // 1.43
+```
+
+### Flutter 代码
+
+```dart
+Container(
+  height: 36, // 设计稿容器高度
+  alignment: Alignment.center, // 关键1：让 TextField 整体居中
+  child: TextField(
+    textAlign: TextAlign.center,
+    style: const TextStyle(
+      fontSize: 14,
+      height: 1.43, // 关键2：行高 = 文本高度÷字号 = 20÷14
+    ),
+    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,
+    ),
+  ),
+)
+```
+
+## 关键原则
+
+| 原则 | 说明 |
+|------|------|
+| `style.height` = `hintStyle.height` | 两者必须相同，否则位置不一致 |
+| `Container.alignment` 控制居中 | 不要用 `textAlignVertical` |
+| `contentPadding: EdgeInsets.zero` | 让 Container.alignment 生效 |
+| 先计算再编码 | 行高 = 文本高度 ÷ 字号 |
+
+## 禁止事项
+
+- ❌ `style.height` ≠ `hintStyle.height`
+- ❌ 同时使用 `textAlignVertical` 和 `height`
+- ❌ 使用 `strutStyle + forceStrutHeight`
+- ❌ 反复调整 `contentPadding` 试错
+
+## 验证方法
+
+1. 点击输入框，检查光标位置
+2. 输入文字，检查文字位置
+3. 清空输入，检查 placeholder 位置
+4. 三者应该在同一垂直位置
+
+---
+
+**案例来源**: 汇款记录筛选弹窗金额输入框  
+**创建日期**: 2026-01-19  
+**版本**: v1.0

package/standards/workflows/design-restoration-guide.md

@@ -0,0 +1,164 @@
+# 设计稿还原通用规范
+
+> 适用于使用 Sketch、Figma 等设计工具 MCP 进行 UI 还原的所有场景
+
+## 🔴 核心问题
+
+本规范基于真实案例总结：**一个简单的输入框垂直居中问题，经历了 15+ 轮对话才修复**。
+
+### 问题根源分析
+
+| 问题 | 表现 | 后果 |
+|------|------|------|
+| **属性读取不完整** | 只读容器尺寸，忽略内部文本位置 | 无法精确计算边距和行高 |
+| **分散查询** | 每次只问一个属性 | 信息不完整，反复补充 |
+| **假设而非验证** | "应该差不多居中" | 实际偏差明显 |
+| **试错式调整** | 逐个调整参数看效果 | 改了 A 问题引发 B 问题 |
+
+---
+
+## ✅ 强制执行规范
+
+### 1. 完整读取选中元素及其所有子集
+
+**⚠️ 这是最重要的规则**
+
+```javascript
+// 正确示例：一次性获取完整信息
+function extractCompleteInfo(element) {
+  console.log('=== 容器信息 ===');
+  console.log(`尺寸: ${element.frame.width}x${element.frame.height}px`);
+  
+  console.log('=== 所有子元素 ===');
+  element.layers.forEach((child, index) => {
+    console.log(`\n子元素 ${index}: ${child.name} (${child.type})`);
+    console.log(`  X: ${child.frame.x}px, Y: ${child.frame.y}px`);
+    console.log(`  宽: ${child.frame.width}px, 高: ${child.frame.height}px`);
+    
+    if (child.type === 'Text') {
+      console.log(`  字号: ${child.style.fontSize}px`);
+      console.log(`  字重: ${child.style.fontWeight}`);
+      console.log(`  颜色: ${child.style.textColor}`);
+      console.log(`  行高倍数: ${(child.frame.height / child.style.fontSize).toFixed(2)}`);
+    }
+    
+    // 递归处理嵌套子元素
+    if (child.layers && child.layers.length > 0) {
+      child.layers.forEach(nested => {
+        console.log(`    嵌套: ${nested.name} (${nested.type})`);
+        console.log(`    位置: Y=${nested.frame.y}px`);
+      });
+    }
+  });
+  
+  console.log('=== 计算结果 ===');
+  const textChild = element.layers.find(l => l.type === 'Text');
+  if (textChild) {
+    const topSpace = textChild.frame.y;
+    const bottomSpace = element.frame.height - textChild.frame.y - textChild.frame.height;
+    console.log(`文本上边距: ${topSpace}px`);
+    console.log(`文本下边距: ${bottomSpace}px`);
+    console.log(`是否居中: ${Math.abs(topSpace - bottomSpace) < 2 ? '是' : '否'}`);
+  }
+}
+```
+
+### 2. 必须获取的完整信息清单
+
+| 元素类型 | 必须获取的属性 | 用途 |
+|----------|----------------|------|
+| **容器** | width, height, padding, 背景色/渐变 | 外层布局 |
+| **文本** | Y 坐标, height, fontSize, fontWeight, color | 计算行高和边距 |
+| **图标** | viewBox, path, fill, fill-opacity | 完整导出 SVG |
+| **渐变** | 所有 stops（颜色+位置）, from, to | 精确还原 |
+| **阴影** | x, y, blur, spread, color (全部 5 个) | 完整阴影 |
+| **边框** | color, width, position | 边框样式 |
+
+### 3. 计算而非试错
+
+**正确流程**：
+```
+1. 从设计稿获取精确数值
+2. 计算目标框架需要的参数
+3. 一次性配置完整方案
+4. 验证结果
+```
+
+**示例：TextField 行高计算**
+```
+设计稿数据:
+- 容器高度: 36px
+- 文本 Y 坐标: 8px
+- 文本高度: 20px
+- 字号: 14px
+
+计算:
+- 行高倍数 = 文本高度 ÷ 字号 = 20 ÷ 14 = 1.43
+- 上边距 = 文本 Y 坐标 = 8px
+- 下边距 = 容器高度 - Y - 文本高度 = 36 - 8 - 20 = 8px
+
+Flutter 配置:
+style: TextStyle(fontSize: 14, height: 1.43)
+Container: height=36, alignment=Alignment.center
+```
+
+---
+
+## 📋 框架特定注意事项
+
+### Flutter
+
+| 问题场景 | 关键属性 | 注意事项 |
+|----------|----------|----------|
+| TextField 居中 | `style.height`, `hintStyle.height` | 两者必须相同 |
+| 容器阴影 | `clipBehavior` | 设为 `Clip.none` 避免裁剪 |
+| Gap 间距 | `Gap()` vs `Gap.h()` | 默认垂直，`.h()` 水平 |
+| SVG 颜色 | `colorFilter` | 不要覆盖，保留原色 |
+
+### Vue/CSS
+
+| 问题场景 | 关键属性 | 注意事项 |
+|----------|----------|----------|
+| Flex 居中 | `align-items`, `justify-content` | 注意主轴方向 |
+| 文本居中 | `line-height` | 设为容器高度实现垂直居中 |
+| 边框问题 | `box-sizing` | 使用 `border-box` |
+| 阴影裁剪 | `overflow` | 避免 `hidden` 裁剪阴影 |
+
+### React Native
+
+| 问题场景 | 关键属性 | 注意事项 |
+|----------|----------|----------|
+| 文本居中 | `textAlignVertical` | 仅 Android 生效 |
+| 输入框 | `includeFontPadding` | Android 设为 false |
+| 阴影 | `elevation` vs `shadow*` | 平台差异 |
+
+---
+
+## 🚫 禁止事项
+
+1. ❌ **禁止只读容器属性** - 必须读取所有子元素
+2. ❌ **禁止分散查询** - 一次性获取完整信息
+3. ❌ **禁止假设数值** - 必须从设计稿读取精确像素
+4. ❌ **禁止试错调整** - 先计算，再编码
+5. ❌ **禁止忽略透明度** - 颜色 `#RRGGBBAA` 最后两位是透明度
+6. ❌ **禁止属性不一致** - 相关属性（如 style 和 hintStyle）必须统一配置
+
+---
+
+## ✅ 检查清单
+
+还原任何设计稿元素前：
+
+- [ ] 已获取目标元素的**容器尺寸**
+- [ ] 已获取**所有子元素**的位置和尺寸
+- [ ] 已获取文本的**Y 坐标、高度、字号**
+- [ ] 已**计算**行高倍数和边距
+- [ ] 已确认相关属性（style/hintStyle）**配置一致**
+- [ ] 已一次性配置**完整方案**
+- [ ] 已验证**所有相关元素**符合预期
+
+---
+
+**维护团队**: MTA工作室  
+**创建日期**: 2026-01-19  
+**版本**: v1.0

package/standards/workflows/problem-diagnosis.md

@@ -194,6 +194,74 @@
 
 ---
 
+## 🎨 设计稿还原专项规范
+
+> ⚠️ **此章节基于真实案例：一个输入框居中问题反复 15+ 轮对话才修复**
+
+### 设计稿工具使用规范（Sketch/Figma）
+
+#### 强制要求：完整读取选中元素及其所有子集
+
+**问题根源**：
+- 只读取了容器属性，忽略了内部文本的精确位置
+- 每次只查询一个属性，导致信息不完整
+- 假设而非验证具体数值
+
+**正确做法**：
+
+```javascript
+// 示例：读取输入框完整信息（包含所有子集）
+function extractInputFieldComplete(inputGroup) {
+  console.log('=== 容器信息 ===');
+  console.log(`宽度: ${inputGroup.frame.width}px`);
+  console.log(`高度: ${inputGroup.frame.height}px`);
+  
+  console.log('=== 内部文本（子集）===');
+  const text = inputGroup.layers.find(l => l.type === 'Text');
+  console.log(`文本 Y 坐标: ${text.frame.y}px`);  // 关键：距容器顶部距离
+  console.log(`文本高度: ${text.frame.height}px`); // 关键：计算行高
+  console.log(`字号: ${text.style.fontSize}px`);
+  
+  console.log('=== 计算结果 ===');
+  const topSpace = text.frame.y;
+  const bottomSpace = inputGroup.frame.height - text.frame.y - text.frame.height;
+  console.log(`上边距: ${topSpace}px`);
+  console.log(`下边距: ${bottomSpace}px`);
+  console.log(`行高倍数: ${(text.frame.height / text.style.fontSize).toFixed(2)}`);
+}
+```
+
+#### 必须获取的信息清单
+
+| 元素类型 | 必须获取 | 用途 |
+|----------|----------|------|
+| 容器 | width, height, padding | 外层尺寸 |
+| 文本 | fontSize, Y坐标, height, fontWeight | 计算行高和边距 |
+| 图标/SVG | viewBox, path, fill-opacity | 完整导出 |
+| 渐变 | stops（所有节点）, from, to | 精确还原 |
+| 阴影 | x, y, blur, spread, color | 全部5个参数 |
+
+### 反复修复问题的根因分析
+
+| 导致反复的原因 | 正确做法 |
+|----------------|----------|
+| 只读取容器高度，不读内部文本 Y 坐标 | 一次性获取容器+所有子元素的完整信息 |
+| 用"试错法"调整参数 | 先计算精确值（如行高=文本高度÷字号） |
+| 修改 A 属性引发 B 问题 | 理解属性之间的相互作用关系 |
+| 假设"差不多居中" | 从设计稿获取精确像素值验证 |
+
+### 设计稿还原检查清单
+
+修复任何设计还原问题前：
+
+- [ ] 已获取目标元素的**完整信息**（容器+所有子集）
+- [ ] 已计算精确数值（行高、边距、颜色透明度）
+- [ ] 已理解框架渲染机制（如 Flutter TextField 的多属性相互作用）
+- [ ] 一次性配置完整方案，而非逐个属性调整
+- [ ] 验证所有相关元素（placeholder、光标、输入内容）都符合预期
+
+---
+
 ## ✅ 检查清单
 
 修复任何问题前，确认以下检查项：

package/standards/workflows/textfield-centering-guide.md

@@ -0,0 +1,157 @@
+# Flutter TextField 垂直居中纠错指南
+
+> 本文档基于一次真实案例总结：修复一个简单的输入框垂直居中问题，经历了 **15+ 轮对话**，涉及多种方案反复尝试
+
+## 📋 问题总结
+
+### 问题描述
+输入框需要实现 placeholder、光标、输入内容三者在容器中垂直居中对齐。
+
+### 问题根因
+Flutter TextField 的垂直对齐涉及**多个相互作用的属性**，修改一个属性可能影响其他元素的位置，导致"改了 A 问题引发 B 问题"的循环。
+
+### 反复失败的原因
+
+| 尝试次数 | 方案 | 结果 |
+|----------|------|------|
+| 1 | contentPadding: vertical: 10 | 整体偏下 |
+| 2 | textAlignVertical: center | 只影响输入内容，placeholder 不动 |
+| 3 | 移除 contentPadding | 整体偏上 |
+| 4 | strutStyle + height: 1.0 | 文字被压缩，更难看 |
+| 5 | Container.alignment + contentPadding: 8 | 输入内容正常，placeholder 偏下 |
+| 6 | hintStyle height: 1.2 | placeholder 移动，但不够 |
+| 7 | hintStyle height: 1.0 | placeholder 过于靠上 |
+| 8-15 | 各种组合... | 来回折腾 |
+
+### 根本问题
+**没有一开始就理解 TextField 的渲染模型**，而是"试错式"调整参数。
+
+---
+
+## ✅ 正确方案（一步到位）
+
+### 设计规格（从 Sketch 获取）
+- 容器高度：36px
+- 文本 Y 坐标：8px（距顶部）
+- 文本高度：20px
+- 字号：14px
+- 行高倍数：1.43（20 ÷ 14 = 1.43）
+
+### Flutter 正确配置
+
+```dart
+Widget _buildCenteredTextField({
+  required String placeholder,
+  required TextEditingController controller,
+}) {
+  return Container(
+    height: 36,
+    decoration: BoxDecoration(
+      // ... 背景、圆角、阴影
+    ),
+    alignment: Alignment.center, // 关键：让 TextField 在容器中居中
+    child: TextField(
+      controller: controller,
+      textAlign: TextAlign.center, // 水平居中
+      // 不要使用 textAlignVertical，会导致 placeholder 和输入内容位置不一致
+      style: const TextStyle(
+        fontSize: 14,
+        height: 1.43, // 关键：与 hintStyle 保持一致
+        fontWeight: FontWeight.w600,
+      ),
+      decoration: InputDecoration(
+        hintText: placeholder,
+        hintStyle: const TextStyle(
+          fontSize: 14,
+          height: 1.43, // 关键：与 style 完全一致
+          fontWeight: FontWeight.w600,
+        ),
+        contentPadding: EdgeInsets.zero, // 关键：清除默认 padding
+        isDense: true, // 关键：移除额外空间
+        border: InputBorder.none,
+        enabledBorder: InputBorder.none,
+        focusedBorder: InputBorder.none,
+      ),
+    ),
+  );
+}
+```
+
+### 关键原则
+
+| 属性 | 作用 | 注意事项 |
+|------|------|----------|
+| `Container.alignment: Alignment.center` | 让 TextField 整体在容器中居中 | 必须配合 `contentPadding: EdgeInsets.zero` |
+| `style.height` 和 `hintStyle.height` | 控制行高 | **必须相同**，否则 placeholder 和输入内容位置不一致 |
+| `contentPadding: EdgeInsets.zero` | 清除默认间距 | 让 Container.alignment 生效 |
+| `isDense: true` | 移除 TextField 默认空间 | 减少干扰因素 |
+| `textAlignVertical` | **不推荐使用** | 只影响输入内容，不影响 placeholder |
+
+---
+
+## 📌 简版纠错指南
+
+### TextField 垂直居中三步法
+
+```dart
+// Step 1: Container 提供高度和居中
+Container(
+  height: 36,
+  alignment: Alignment.center,
+  child: TextField(
+    // Step 2: style 和 hintStyle 使用相同的 height
+    style: TextStyle(fontSize: 14, height: 1.43),
+    decoration: InputDecoration(
+      hintStyle: TextStyle(fontSize: 14, height: 1.43),
+      // Step 3: 清除 padding，启用 isDense
+      contentPadding: EdgeInsets.zero,
+      isDense: true,
+    ),
+  ),
+)
+```
+
+### 禁止事项
+
+1. ❌ **禁止 style.height 和 hintStyle.height 不一致** - 会导致 placeholder 和输入内容位置不同
+2. ❌ **禁止同时使用 textAlignVertical 和 height** - 会产生冲突
+3. ❌ **禁止 strutStyle + forceStrutHeight** - 可能压缩文字
+4. ❌ **禁止反复调整 contentPadding 试错** - 先确定行高配置
+
+### 调试顺序
+
+遇到 TextField 垂直对齐问题时，按以下顺序检查：
+
+1. **先确认设计规格** - 容器高度、文本高度、计算行高倍数
+2. **配置 height** - style 和 hintStyle 使用相同的 height
+3. **配置 Container** - alignment: Alignment.center
+4. **清除干扰** - contentPadding: EdgeInsets.zero, isDense: true
+5. **移除冲突属性** - 不要用 textAlignVertical 和 strutStyle
+
+---
+
+## 🎯 案例复盘
+
+### 为什么需要 15+ 轮对话？
+
+| 问题 | 正确做法 |
+|------|----------|
+| 没有先计算行高倍数 | 从设计稿提取：文本高度 ÷ 字号 = height |
+| 逐个尝试属性 | 一次性配置完整方案 |
+| 改了 A 引发 B | 理解属性之间的关系 |
+| 没有统一 style 和 hintStyle | 两者必须完全一致 |
+
+### 正确的工作流
+
+```
+1. 从 Sketch 获取完整规格（容器高度、文本 Y 坐标、文本高度）
+2. 计算 height = 文本高度 ÷ 字号
+3. 一次性配置完整方案（Container.alignment + 相同 height + contentPadding.zero + isDense）
+4. 验证三者（placeholder、光标、输入内容）是否对齐
+```
+
+---
+
+**创建日期**: 2026-01-19  
+**案例来源**: 汇款记录筛选弹窗金额输入框  
+**解决方案**: Container.alignment + 统一 height + contentPadding.zero