mta-mcp 3.13.0 → 3.14.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mta-mcp",
-  "version": "3.13.0",
+  "version": "3.14.2",
   "description": "MTA - 智能编码助手 MCP 服务器（规范 + 技能 + 诊断 + 模板 + 记忆 + 思考）",
   "type": "module",
   "main": "./dist/index.js",

package/standards/frameworks/flutter.md

@@ -1072,6 +1072,43 @@ height = 文本高度 ÷ 字号 = 20 ÷ 14 = 1.43
 4. 设置 `Container.alignment: Alignment.center`
 5. 设置 `contentPadding: EdgeInsets.zero` + `isDense: true`
 
+### TextField Focus 背景色全局修复
+
+> ⚠️ **TextField 聚焦时出现蓝色半透明背景，需要在 ThemeData 两处同时消除**
+
+Flutter 默认 `focusColor = Color(0x1F2196F3)`（蓝色 12% 透明度），在 TextField focus 时作为 State Layer 叠加在背景上，视觉效果很突兀。
+
+```dart
+// ✅ 必须在 ThemeData 和 InputDecorationTheme 两处同时设置
+ThemeData(
+  focusColor: Colors.transparent,      // 消除 focus state layer
+  hoverColor: Colors.transparent,       // 消除 hover state layer
+  splashColor: Colors.transparent,      // 消除水波纹
+  highlightColor: Colors.transparent,   // 消除高亮
+  inputDecorationTheme: InputDecorationTheme(
+    filled: true,
+    fillColor: Colors.transparent,
+    focusColor: Colors.transparent,     // 双重保护
+    hoverColor: Colors.transparent,
+    border: InputBorder.none,
+    enabledBorder: InputBorder.none,
+    focusedBorder: InputBorder.none,
+  ),
+)
+
+// ❌ 错误 - 只改 InputDecorationTheme 不够，ThemeData 级别仍然生效
+inputDecorationTheme: InputDecorationTheme(
+  focusColor: Colors.transparent, // 单独设置无效
+),
+```
+
+| 属性 | 控制范围 |
+|------|----------|
+| `ThemeData.focusColor` | 全局 focus 状态叠加色 |
+| `ThemeData.hoverColor` | 全局 hover 状态叠加色 |
+| `InputDecorationTheme.focusColor` | TextField 专属 focus 色 |
+| `InputDecorationTheme.fillColor` | TextField 填充色 |
+
 ---
 
 ## 🎨 Sketch/Figma 设计稿还原规范
@@ -1199,6 +1236,43 @@ SvgPicture.asset(
 )
 ```
 
+#### Bitmap 图层处理规范
+
+Sketch 将 Bitmap（位图）图层"导出为 SVG"时，**并不生成矢量路径**，而是嵌入 base64 PNG 数据：
+
+```xml
+<!-- Bitmap 导出 SVG 的实际内容 - 只有 base64 图片，无矢量路径 -->
+<svg viewBox="0 0 12 12" xmlns="http://www.w3.org/2000/svg">
+  <image xlink:href="data:image/png;base64,iVBORw0KGgo..." width="12" height="12"/>
+</svg>
+```
+
+**正确处理方式：识别 Bitmap 图层后，改为 PNG 导出，Flutter 使用 `Image.asset`**：
+
+```javascript
+// 判断图层是否为 Bitmap
+const isBitmap = layer.type === 'Image';
+
+// Bitmap 图层导出 PNG（@3x 高清）
+if (isBitmap) {
+  sketch.export(layer, { formats: 'png', scales: '3', output: '/path/to/assets/icons/' });
+}
+```
+
+```dart
+// ✅ 正确 - Bitmap 图层用 Image.asset，不用 SvgPicture.asset
+Image.asset(
+  'assets/icons/ic_example.png',
+  width: 12,
+  height: 12,
+  color: AppColors.textDarkSecondary,  // 按需染色
+  colorBlendMode: BlendMode.srcIn,
+)
+
+// ❌ 错误 - 对 Bitmap SVG 用 SvgPicture 会显示模糊的 base64 位图
+SvgPicture.asset('assets/icons/ic_example.svg') // 实际是嵌套 PNG，非矢量
+```
+
 #### 颜色透明度转换
 
 设计稿颜色格式：`#RRGGBBAA`（最后两位是透明度）
@@ -1217,6 +1291,57 @@ Flutter: Color(0xB31C2B45) 或 SVG fill-opacity="0.7"
 | 50% | 80 | #00000080 |
 | 15% | 26 | #1C2B4526 |
 
+### 字重（FontWeight）还原规范
+
+> ⚠️ **Sketch `style.fontWeight` 返回的是内部索引值，≠ Flutter FontWeight 数值**（高频错误）
+
+#### 错误根因
+
+Sketch JS API 的 `layer.style.fontWeight` 返回 5、6、8、9 等内部索引，与 CSS/Flutter 的字重体系（400、500、600、700）**没有直接倍数关系**，不能 `×100` 使用。
+
+| Sketch `fontWeight` 值 | 实际字体面 | Flutter 正确值 | 常见错误推断 |
+|---|---|---|---|
+| 5 | PingFangSC-Regular | `FontWeight.w400` | ~~w500~~（直接 ×100） |
+| 6 | PingFangSC-Medium | `FontWeight.w500` | ~~w600~~ |
+| 8 | PingFangSC-Semibold | `FontWeight.w600` | ~~w800~~（最常见错误！）|
+| 9 | PingFangSC-Bold | `FontWeight.w700` | ~~w900~~ |
+
+#### 正确获取方式（必须用 native API）
+
+```javascript
+// ❌ 错误 - fontWeight 数字不等于 Flutter FontWeight 值
+const weight = layer.style.fontWeight; // 返回 8，不代表 w800
+
+// ✅ 正确 - 获取字体面完整名称，再按规则映射
+const fontName = String(layer.sketchObject.font().fontName());
+// "PingFangSC-Regular"  → FontWeight.w400
+// "PingFangSC-Medium"   → FontWeight.w500
+// "PingFangSC-Semibold" → FontWeight.w600
+// "PingFangSC-Bold"     → FontWeight.w700
+
+// 批量提取 Text 图层字重的完整脚本
+function getLayerFontWeight(layer) {
+  const fontName = String(layer.sketchObject.font().fontName());
+  const map = {
+    'Regular':  'FontWeight.w400',
+    'Medium':   'FontWeight.w500',
+    'Semibold': 'FontWeight.w600',
+    'Bold':     'FontWeight.w700',
+  };
+  const variant = Object.keys(map).find(k => fontName.includes(k)) || 'Regular';
+  return { fontName, fontWeight: map[variant] };
+}
+```
+
+#### 字重与 UI 元素对照（PingFangSC 典型规律）
+
+| UI 元素 | 常用字体面 | Flutter FontWeight |
+|--------|--------|-------------------|
+| 说明文字、普通标签 | PingFangSC-Regular | `w400` |
+| 次标题、中等强调 | PingFangSC-Medium | `w500` |
+| 重要数值、价格金额 | PingFangSC-Semibold | `w600` |
+| 页面主标题 | PingFangSC-Bold | `w700` |
+
 ### 问题速查表
 
 > ⚠️ **修改代码前，先检查是否属于已知问题类型**
@@ -1231,6 +1356,10 @@ Flutter: Color(0xB31C2B45) 或 SVG fill-opacity="0.7"
 | Row 内 Gap 间距无效 | #6 Gap 方向错误 | `SizedBox(width:)` 或 `Gap.h()` |
 | **SVG 颜色比设计稿浅** | #7 ColorFilter 覆盖 | **移除 ColorFilter，保留 SVG 原有样式** |
 | **SVG 图标未居中** | #8 viewBox 不匹配 | **SVG viewBox 与使用尺寸一致** |
+| **字重比设计稿更粗/更细** | #9 fontWeight 数字误读 | **用 `font().fontName()` 获取字体面名称映射** |
+| **SVG 图标模糊/非矢量** | #10 Bitmap 图层误用 | **位图图层改用 PNG 导出 + `Image.asset`** |
+| **TextField 聚焦出现蓝色背景** | #11 Focus 颜色未清除 | **ThemeData + InputDecorationTheme 两处设 transparent** |
+| **Obx 不触发 RxSet 刷新** | #12 GetX 引用未订阅 | **Obx 内用 `Set.from(rxSet)` 创建新集合触发订阅** |
 
 ### 还原检查清单
 
@@ -1247,6 +1376,8 @@ Flutter: Color(0xB31C2B45) 或 SVG fill-opacity="0.7"
 | **边框** | color, thickness, position | `border: Border.all(...)` |
 | **不透明度** | opacity (颜色末尾两位) | 颜色 alpha 或 `Opacity` widget |
 | **图标** | SVG path, fill color, opacity | `SvgPicture.asset` |
+| **字重** | fontFace 名称（非 fontWeight 数字） | `FontWeight.w400/w500/w600/w700` |
+| **图标类型** | 矢量(Shape) vs 位图(Image) | Shape→SVG；Image→PNG+`Image.asset` |
 
 ### 禁止事项
 
@@ -1257,6 +1388,10 @@ Flutter: Color(0xB31C2B45) 或 SVG fill-opacity="0.7"
 5. ❌ **禁止遗漏阴影参数** - 必须读取全部 5 个参数
 6. ❌ **禁止忽略透明度** - 颜色 `#RRGGBBAA` 最后两位是透明度
 7. ❌ **禁止 ColorFilter 覆盖 SVG** - 除非明确需要改变颜色
+8. ❌ **禁止用 Sketch `fontWeight` 数字推断 Flutter FontWeight** - 必须通过字体面名称（`font().fontName()`）映射
+9. ❌ **禁止对 Bitmap 图层使用 SvgPicture.asset** - 必须导出 PNG，用 `Image.asset`
+10. ❌ **禁止只在 InputDecorationTheme 修复 focus 背景色** - ThemeData 级别的 focusColor 也必须设置
+11. ❌ **禁止在 Obx 外传入 RxSet 引用** - 必须在 Obx lambda 内用 `Set.from()` 触发响应式订阅
 
 ---
 

package/standards/troubleshooting-cases/flutter/input-focus-background-color.md

@@ -0,0 +1,79 @@
+# TextField 聚焦时出现蓝色背景（Focus State Layer）
+
+**问题标签**: `TextField`, `InputDecoration`, `ThemeData`, `focusColor`, `focus`, `背景色`
+**问题类型**: `UI 样式异常`
+**严重程度**: 中
+**节省时间**: 多轮尝试 → 1 步修复
+
+---
+
+## 问题描述
+
+TextField 点击聚焦后，输入框背景出现蓝色半透明叠加色（State Layer），与设计稿完全不符，视觉效果很突兀。
+
+## 问题根因
+
+Flutter Material Design 默认会在 `ThemeData.focusColor` 设置带透明度的蓝色：
+
+```dart
+// Flutter 框架默认值
+ThemeData(
+  focusColor: Color(0x1F2196F3), // 蓝色 12% 透明度 → 即 12% 不透明蓝色叠加层
+)
+```
+
+当 TextField 聚焦时，这个颜色作为 **State Layer** 叠加在 `fillColor` 上方，产生明显的蓝色背景。
+
+**陷阱**：只在 `InputDecorationTheme` 中设置 `focusColor: Colors.transparent` 并不够——`ThemeData` 级别的 `focusColor` 仍然生效，在某些情况下依然会显示。
+
+## 错误尝试（导致反复）
+
+| 尝试 | 结果 |
+|------|------|
+| 只设置 `InputDecorationTheme.focusColor: transparent` | 部分场景仍有蓝色 |
+| 设置 `TextField.decoration.fillColor: transparent` | 填充色改了，但 focus 叠加色仍在 |
+| 单独设置某个 TextField 的样式 | 新增 TextField 又出现问题，不是全局修复 |
+
+## 正确方案
+
+必须在 `ThemeData` 和 `InputDecorationTheme` **两处同时**设置：
+
+```dart
+ThemeData(
+  // 全局消除 focus/hover/ripple State Layer
+  focusColor: Colors.transparent,
+  hoverColor: Colors.transparent,
+  splashColor: Colors.transparent,
+  highlightColor: Colors.transparent,
+
+  inputDecorationTheme: InputDecorationTheme(
+    filled: true,
+    fillColor: Colors.transparent,
+    focusColor: Colors.transparent,   // 针对 TextField 的双重保护
+    hoverColor: Colors.transparent,
+    // 消除聚焦时的边框
+    border: InputBorder.none,
+    enabledBorder: InputBorder.none,
+    focusedBorder: InputBorder.none,
+    errorBorder: InputBorder.none,
+    focusedErrorBorder: InputBorder.none,
+  ),
+)
+```
+
+## 各属性作用说明
+
+| 属性 | 控制范围 | 默认值 |
+|------|----------|--------|
+| `ThemeData.focusColor` | 全局所有 Widget 的 focus 状态叠加色 | `Color(0x1F2196F3)` |
+| `ThemeData.hoverColor` | 全局所有 Widget 的 hover 状态叠加色 | `Color(0x0A000000)` |
+| `ThemeData.splashColor` | InkWell 水波纹颜色 | 蓝色变体 |
+| `ThemeData.highlightColor` | 长按高亮颜色 | 半透明 |
+| `InputDecorationTheme.focusColor` | TextField 专属 focus 层（二次覆盖） | 跟随 ThemeData |
+| `InputDecorationTheme.fillColor` | TextField 填充背景色 | 跟随主题 |
+
+## 关键原则
+
+1. **ThemeData 和 InputDecorationTheme 都必须设置**，只改一处不够
+2. 如果项目有多套主题（亮色/暗色），**每套主题都需要单独设置**
+3. 在明确需要 focus 效果的按钮上（如 `ElevatedButton`），可单独通过 `ButtonStyle` 恢复，不影响全局配置

package/standards/troubleshooting-cases/flutter/sketch-fontweight-mapping.md

@@ -0,0 +1,105 @@
+# Sketch fontWeight 数字 ≠ Flutter FontWeight 值
+
+**问题标签**: `sketch`, `fontWeight`, `字重`, `PingFangSC`, `字体`, `设计稿还原`
+**问题类型**: `UI 还原错误`
+**严重程度**: 高
+**节省时间**: 多轮调试 → 1 次确认
+
+---
+
+## 问题描述
+
+从 Sketch 设计稿读取 `layer.style.fontWeight` 后，按 `值 × 100` 推算 Flutter FontWeight，导致字重比设计稿偏粗或偏细：
+
+- 设计师说"这是常规字重"，但代码里写了 `FontWeight.w500`（实际应是 w400）
+- 价格数值看起来异常加粗，代码里用了 `FontWeight.w800`（实际应是 w600）
+
+## 问题根因
+
+Sketch JS API 的 `style.fontWeight` 返回的是**字体变体的内部枚举索引**（5、6、8、9...），与 CSS/Flutter 标准字重体系（100 ~ 900）**无数学对应关系**，不能直接 `×100` 使用。
+
+| Sketch `style.fontWeight` | 实际字体面 | Flutter 正确值 | 错误推断 |
+|---|---|---|---|
+| 5 | PingFangSC-Regular | `FontWeight.w400` | ~~w500~~ |
+| 6 | PingFangSC-Medium | `FontWeight.w500` | ~~w600~~ |
+| 8 | PingFangSC-Semibold | `FontWeight.w600` | **~~w800~~（最常见！）** |
+| 9 | PingFangSC-Bold | `FontWeight.w700` | ~~w900~~ |
+
+## 错误尝试（导致反复）
+
+| 尝试 | 结果 |
+|------|------|
+| 直接 `fontWeight × 100` | 所有字重偏粗（w500→w600，w600→w800） |
+| 猜测"5≈medium≈w500" | 有时正确，有时偏差一级 |
+| 看字体名前半段"PingFangSC" | 没有变体信息，无法区分 Regular/Semibold |
+
+## 正确方案
+
+### 获取字体面完整名称（必须用 Sketch native API）
+
+```javascript
+// ❌ 错误 - 返回内部索引，含义不明确
+const weight = layer.style.fontWeight; // 返回 8，≠ w800
+
+// ✅ 正确 - 获取字体面完整名称
+const fontName = String(layer.sketchObject.font().fontName());
+// 返回 "PingFangSC-Semibold" → 映射到 FontWeight.w600
+```
+
+### 标准映射表
+
+```javascript
+// PingFangSC 字体映射（中文场景最常见）
+const PINGFANG_WEIGHT_MAP = {
+  'Ultralight': 'FontWeight.w100',
+  'Thin':       'FontWeight.w200',
+  'Light':      'FontWeight.w300',
+  'Regular':    'FontWeight.w400',
+  'Medium':     'FontWeight.w500',
+  'Semibold':   'FontWeight.w600',
+  'Bold':       'FontWeight.w700',
+  'Heavy':      'FontWeight.w800',
+  'Black':      'FontWeight.w900',
+};
+
+function getFlutterFontWeight(layer) {
+  const fontName = String(layer.sketchObject.font().fontName());
+  const variant = Object.keys(PINGFANG_WEIGHT_MAP).find(k => fontName.includes(k));
+  return PINGFANG_WEIGHT_MAP[variant || 'Regular'];
+}
+```
+
+### 批量提取文本样式脚本
+
+```javascript
+const sketch = require('sketch');
+const page = sketch.getSelectedDocument().selectedPage;
+
+function extractTextStyles(containerName) {
+  const container = sketch.find(`[name="${containerName}"]`, page)[0];
+  if (!container) return;
+
+  function walkLayers(layers) {
+    layers.forEach(layer => {
+      if (layer.type === 'Text') {
+        const fontName = String(layer.sketchObject.font().fontName());
+        const variant = ['Regular','Medium','Semibold','Bold','Light'].find(k => fontName.includes(k)) || 'Regular';
+        const weightMap = { Regular:'w400', Medium:'w500', Semibold:'w600', Bold:'w700', Light:'w300' };
+        console.log(`"${layer.name}": fontSize=${layer.style.fontSize}, fontWeight=FontWeight.${weightMap[variant]}, fontFace=${fontName}`);
+      }
+      if (layer.layers) walkLayers(layer.layers);
+    });
+  }
+
+  walkLayers(container.layers || []);
+}
+
+extractTextStyles('组件名称');
+```
+
+## 关键原则
+
+1. **永远不要根据 `style.fontWeight` 数字直接推断 Flutter FontWeight**
+2. **必须通过 `layer.sketchObject.font().fontName()` 获取字体面名称**
+3. 拿到字体面名称（如 `PingFangSC-Semibold`）后，取变体部分（`Semibold`）做映射
+4. 不同字体族（SF Pro、Roboto）的映射规则相同，变体名称是通用的

package/standards/troubleshooting-cases/flutter/sketch-svg-bitmap-export.md

@@ -0,0 +1,112 @@
+# Sketch SVG 导出：Bitmap 图层内嵌 base64 而非矢量路径
+
+**问题标签**: `sketch`, `svg`, `bitmap`, `SvgPicture`, `Image.asset`, `图标导出`
+**问题类型**: `资源处理错误`
+**严重程度**: 中
+**节省时间**: 多次排查 → 1 次识别
+
+---
+
+## 问题描述
+
+从 Sketch 导出 SVG 图标后，在 Flutter 中用 `SvgPicture.asset` 显示，但图标看起来模糊、不清晰，放大后出现像素化，或者根本无法正确着色。
+
+## 问题根因
+
+Sketch 在导出 Bitmap（位图/Image）类型图层时，即使选择 SVG 格式，**实际写入的是 base64 编码的 PNG 数据**，并非矢量路径：
+
+```xml
+<!-- 表面是 .svg 文件，实际内容完全不是矢量 -->
+<svg viewBox="0 0 12 12" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <image xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA..." width="12" height="12"/>
+</svg>
+```
+
+用 `SvgPicture.asset` 渲染这种文件时：
+- 实际显示的是 base64 内嵌的栅格图像，存在分辨率上限
+- `colorFilter` 无法对内嵌图像染色（只对矢量 path 有效）
+- 在高 DPI 屏幕上仍然模糊
+
+## 如何识别 Bitmap 图层
+
+```javascript
+// Sketch 脚本：检测图层类型
+const sketch = require('sketch');
+const layer = sketch.getSelectedDocument().selectedLayers.layers[0];
+
+console.log(`图层类型: ${layer.type}`);
+// Shape / Group / Text / SymbolInstance → 矢量，可导出 SVG
+// Image                                 → 位图，应导出 PNG
+```
+
+也可以在 Sketch UI 中：点击图层 → 右侧 Inspector → 图层类型标识为 "Image" 则为 Bitmap。
+
+## 正确方案
+
+### 步骤一：导出 PNG 而非 SVG
+
+```javascript
+const sketch = require('sketch');
+const layer = sketch.find('[name="ic_rate_chart"]', sketch.getSelectedDocument().selectedPage)[0];
+
+if (layer) {
+  // 位图图层导出 PNG，@3x 保证高清
+  sketch.export(layer, {
+    formats: 'png',
+    scales: '3',
+    output: '/path/to/project/assets/icons/',
+  });
+  console.log('导出完成: ic_rate_chart@3x.png');
+}
+```
+
+### 步骤二：Flutter 使用 Image.asset
+
+```dart
+// ✅ 正确 - 位图图标用 Image.asset
+Image.asset(
+  'assets/icons/ic_rate_chart.png',
+  width: 12,
+  height: 12,
+  color: AppColors.textDarkSecondary,  // 单色染色
+  colorBlendMode: BlendMode.srcIn,
+)
+
+// ✅ 不需要染色时
+Image.asset(
+  'assets/icons/ic_rate_chart.png',
+  width: 12,
+  height: 12,
+)
+
+// ❌ 错误 - 对 Bitmap SVG 用 SvgPicture，实际是渲染嵌套 PNG
+SvgPicture.asset(
+  'assets/icons/ic_rate_chart.svg',
+  colorFilter: ColorFilter.mode(color, BlendMode.srcIn), // 不生效
+)
+```
+
+### 步骤三：注册资源
+
+在 `pubspec.yaml` 中确保声明：
+
+```yaml
+flutter:
+  assets:
+    - assets/icons/ic_rate_chart.png
+```
+
+## 矢量图标 vs 位图图标的选择
+
+| 图标来源 | 图层类型 | 导出格式 | Flutter 使用方式 |
+|--------|--------|--------|----------------|
+| Sketch Shape/Group 绘制 | Shape/Group | SVG | `SvgPicture.asset` |
+| 粘贴进来的 PNG/JPG | Image | PNG (`scales: '3'`) | `Image.asset` |
+| 外部导入的位图 | Image | PNG (`scales: '3'`) | `Image.asset` |
+| 含 mask 的复合图标 | Group | SVG（先确认路径正确） | `SvgPicture.asset` |
+
+## 关键原则
+
+1. **导出前先检查图层类型**：`layer.type === 'Image'` 则为 Bitmap，必须用 PNG
+2. **不要对内嵌 base64 SVG 使用 colorFilter**：颜色叠加对栅格图像无效
+3. **PNG 导出用 `scales: '3'`**：保证 @3x 分辨率，避免在高 DPI 设备上模糊

package/ui/sketch/mta-measure.sketchplugin/Contents/Sketch/measure.js

@@ -670,7 +670,7 @@ function detectIfIcon(layer) {
 
   var name = (layer.name || '').toLowerCase();
   var size = Math.max(layer.frame.width, layer.frame.height);
-  var iconKeywords = ['icon', 'ico', 'logo', 'symbol', 'arrow', 'close', 'menu',
+  var iconKeywords = ['icon', 'ico', 'ic_', '_ic', 'logo', 'symbol', 'arrow', 'close', 'menu',
     'search', 'star', 'check', 'back', 'more', 'nav', 'btn', 'button'];
   var hasKeyword = false;
   for (var k = 0; k < iconKeywords.length; k++) {
@@ -837,7 +837,13 @@ function extractShapePathSignature(layer) {
     guessedRole = 'background';
     guessedFlutter = 'Container with BoxDecoration';
   }
-  // 描边图标
+  // v3.0.6: 极简几何描边（≤4直线点，尺寸≤24×24）→ CustomPainter 而非 SVG
+  // 根因: AI 看到勾选/箭头路径会用 Icons.check，但 Material Icon 是填充形状，与描边设计不符
+  else if (!isClosed && !hasCurves && pointCount <= 4 && Math.max(w, h) <= 24) {
+    guessedRole = 'geometric-stroke';
+    guessedFlutter = 'CustomPainter.drawPath() - 禁止用 Icons.xxx 或 SvgPicture.asset()';
+  }
+  // 描边图标（复杂曲线或点数较多的开放路径）
   else if (!isClosed && pointCount >= 2) {
     guessedRole = 'icon-stroke';
     guessedFlutter = 'SvgPicture.asset() - stroke path';
@@ -907,6 +913,18 @@ function extractShapePathSignature(layer) {
       shapeSigResult.strokeSvgHint = '此路径是开放描边路径 (isClosed=false)，SVG 必须用 stroke 而非 fill。' +
         '模板: <polyline points="..." fill="none" stroke="' + strokeHexColor + '" stroke-width="' + b0.thickness + '" stroke-linecap="round" stroke-linejoin="round"/>。' +
         '禁止生成 fill 实心形状——该图形在设计稿中是纯描边无填充。';
+      // v3.0.6: geometric-stroke 专用 CustomPainter 提示——无需 SVG 文件，直接内联绘制
+      if (guessedRole === 'geometric-stroke') {
+        shapeSigResult.flutterCustomPainterHint =
+          '此路径为极简几何描边（' + pointCount + '点，' + w + '×' + h + '），禁止用 Icons.xxx 或 SvgPicture.asset()。' +
+          '用 CustomPainter: canvas.drawPath(path, Paint()' +
+          '..color=' + strokeFlutterColor +
+          '..style=PaintingStyle.stroke' +
+          '..strokeWidth=' + b0.thickness +
+          '..strokeCap=StrokeCap.round' +
+          '..strokeJoin=StrokeJoin.round)。' +
+          '典型场景: radio button勾选✓、小型折线箭头。';
+      }
     }
   }
 
@@ -1279,7 +1297,11 @@ function extractCompleteStyle(layer) {
       var ish = innerShadows[isi];
       var innerObj = { color: ish.color, blur: ish.blur, x: ish.x, y: ish.y, spread: ish.spread || 0 };
       var fc3 = sketchColorToFlutter(ish.color);
-      if (fc3) innerObj.flutterBoxShadow = 'BoxShadow(color: ' + fc3 + ', offset: Offset(' + ish.x + ', ' + ish.y + '), blurRadius: ' + ish.blur + ', spreadRadius: ' + (ish.spread || 0) + ')';
+      if (fc3) {
+        innerObj.flutterBoxShadow = 'BoxShadow(color: ' + fc3 + ', offset: Offset(' + ish.x + ', ' + ish.y + '), blurRadius: ' + ish.blur + ', spreadRadius: ' + (ish.spread || 0) + ')';
+        // Flutter 不原生支持 innerShadow，以下给出实现方案
+        innerObj.flutterNote = '⚠️ Flutter 不原生支持 innerShadow。实现方案: 在 Stack 中于内容层上方叠加一个同形状的 DecoratedBox，decoration 中 boxShadow 使用较大的 spreadRadius 使阴影向内延伸，再用 ClipRRect/ClipPath 裁剪为相同圆角，使阴影只在容器内部可见。或使用 CustomPainter 直接绘制。';
+      }
       style.innerShadows.push(innerObj);
     }
   }
@@ -2415,8 +2437,28 @@ function measureRecursively(layer, depth, parentFrame, siblings) {
       if (iconFill.flutterColor) {
         var iw = Math.round(layer.frame.width);
         var ih = Math.round(layer.frame.height);
+        // 将图层级别 opacity 合并进 colorFilter 颜色的 alpha 通道
+        // 原因: Sketch 支持"填充色 alpha"和"图层整体 opacity"两个独立维度,
+        // 若只用填充色 alpha 而忽略 layer opacity, colorFilter 渲染比设计稿更深
+        var layerOpacity = 1.0;
+        try {
+          if (layer.style && layer.style.opacity !== undefined && layer.style.opacity !== 1) {
+            layerOpacity = layer.style.opacity;
+          }
+        } catch (e2) { /* ignore */ }
+        var fillAlpha = (iconFill.alpha !== undefined) ? iconFill.alpha : 1.0;
+        var effectiveAlpha = fillAlpha * layerOpacity;
+        var effectiveColor;
+        if (Math.abs(effectiveAlpha - fillAlpha) > 0.01) {
+          // layer opacity 有效，合并后重新生成 Flutter 颜色
+          effectiveColor = toFlutterColor(iconFill.hex || iconFill.color, effectiveAlpha);
+          element.iconOpacityMerged = true;
+          element.iconOpacityNote = 'fill-alpha(' + Math.round(fillAlpha * 100) + '%) × layer-opacity(' + Math.round(layerOpacity * 100) + '%) = ' + Math.round(effectiveAlpha * 100) + '% → 已合并入 colorFilter alpha';
+        } else {
+          effectiveColor = iconFill.flutterColor;
+        }
         // 路径后附带 TODO 注释，提示核对实际文件名
-        element.flutterSvgCode = 'SvgPicture.asset(\'assets/' + element.iconExportPath + '\' /* TODO: 核对 assets/icons/ 中实际文件名，禁止用 Icons.xxx 替代 */, width: ' + iw + ', height: ' + ih + ', colorFilter: ColorFilter.mode(' + iconFill.flutterColor + ', BlendMode.srcIn),)';
+        element.flutterSvgCode = 'SvgPicture.asset(\'assets/' + element.iconExportPath + '\' /* TODO: 核对 assets/icons/ 中实际文件名，禁止用 Icons.xxx 替代 */, width: ' + iw + ', height: ' + ih + ', colorFilter: ColorFilter.mode(' + effectiveColor + ', BlendMode.srcIn),)';
       }
     }
   }
@@ -2508,7 +2550,13 @@ function measureRecursively(layer, depth, parentFrame, siblings) {
     if (nativeImgFills && nativeImgFills[0] && nativeImgFills[0].hex) {
       element.imageInfo.nativeTint = formatNativeColor(nativeImgFills[0]);
     }
-    element.imageInfo.note = '此图层为嵌入式位图(Bitmap), 需要导出为 SVG 或 PNG 后使用';
+    element.imageInfo.note = '此图层为嵌入式位图(Bitmap), 必须导出为 PNG (非SVG——Bitmap导出SVG只含base64嵌套图片, 无矢量路径), 放入 assets/icons/, 用 Image.asset 渲染';
+    // 生成 Image.asset 代码片段，开发者直接复制使用
+    var bitmapW = Math.round(layer.frame.width);
+    var bitmapH = Math.round(layer.frame.height);
+    var bitmapName = sanitizeFileName(layer.name);
+    element.flutterImageCode = 'Image.asset(\'assets/icons/' + bitmapName + '.png\', width: ' + bitmapW + ', height: ' + bitmapH + ', color: YOUR_COLOR, colorBlendMode: BlendMode.srcIn,)';
+    element.imageInfo.exportHint = 'Sketch 导出命令: File > Export Layers > 选择此图层 > 格式 PNG @3x, 放入 assets/icons/';
   }
 
   // Symbol Instance — override 真实值

package/ui/sketch/sketch-tools.js

@@ -1153,6 +1153,10 @@ function extractShapePathSignature(layer) {
     } else if (pointCount <= 4 && isClosed && hasCurves && aspect > 0.8 && aspect < 1.25) {
       guessedRole    = 'circle-bg'
       guessedFlutter = 'Container(decoration: BoxDecoration(shape: BoxShape.circle, ...))'
+    } else if (!isClosed && !hasCurves && pointCount <= 4 && w <= 24 && h <= 24) {
+      // v3.0.6: 极简几何描边（≤4直线点，≤24×24），用 CustomPainter 而非 Icons.xxx 或 SVG
+      guessedRole    = 'geometric-stroke'
+      guessedFlutter = '极简几何描边（' + pointCount + '点，' + w + '×' + h + '）。禁止用 Icons.xxx 或 SvgPicture.asset()。正确: CustomPainter → canvas.drawPath(path, Paint()..style=PaintingStyle.stroke..strokeCap=StrokeCap.round)。详见 flutterCustomPainterHint 字段。'
     } else if (isSmall && isSquarish && (pointCount > 4 || !isClosed)) {
       guessedRole    = 'icon'
       guessedFlutter = '矢量图标路径。必须 exportIconAsSVG 导出后用 SvgPicture.asset() 加载。禁止用 Icons.xxx 猜测。'
@@ -1167,6 +1171,25 @@ function extractShapePathSignature(layer) {
     sig.guessedRole    = guessedRole
     sig.guessedFlutter = guessedFlutter
 
+    // v3.0.6: 开放路径—提取描边信息；geometric-stroke 补充 CustomPainter 提示
+    if (!isClosed && layer.style && layer.style.borders) {
+      const activeBorders = layer.style.borders.filter(b => b.enabled !== false)
+      if (activeBorders.length > 0) {
+        const b0 = activeBorders[0]
+        const fColor = sketchColorToFlutter(b0.color) || 'Colors.black'
+        sig.strokeInfo = { thickness: b0.thickness, color: b0.color, flutterColor: fColor }
+        if (guessedRole === 'geometric-stroke') {
+          sig.flutterCustomPainterHint =
+            'canvas.drawPath(path, Paint()' +
+            '..color = ' + fColor +
+            '  ..style = PaintingStyle.stroke' +
+            '  ..strokeWidth = ' + (b0.thickness || 2) +
+            '  ..strokeCap = StrokeCap.round' +
+            '  ..strokeJoin = StrokeJoin.round)'
+        }
+      }
+    }
+
     return sig
   } catch (e) {
     return { error: String(e) }