# 已知问题（KNOWN-ISSUES）

> 本文件记录 2026-05-19/20 首次抽取产出后已知但暂未解决的问题。

## 1. 缺失图片（33 处）

部分 MD 引用了图片但本地文件未生成。原因主要是：

- Figma 节点已删除（如 BEP 图标若干 nodeId 在抽取时已不存在）
- 子节点级别图未拆分（Figma API 只能渲染整个节点为一张图，子区域需手动截图）
- 主线程早期 Task 2-3 在写 MD 时按"语义命名"猜测的图片名，对应节点未在 batch JSON 中登记

受影响 MD：
- `基础/设计原则.md` (4 处)
- `基础/设计系统简介.md` (1 处)
- `基础/2023设计语言规范.md` (7 处)
- `组件/筛选器.md` (15 处)
- `组件/搜索框.md` (11 处)
- `组件/suglist.md` 等其他若干 (1-3 处)

所有失效的 `![](...)` 已替换为 `<!-- 缺图: ... -->` HTML 注释，原引用路径保留，方便手动补图后还原。

## 2. 部分子项数据来源说明

- **会中框架规则.md** 和 **如流logo应用规范.md**：Figma 原节点文本极少，部分内容用"以画板内规范图为准"标注。建议设计师在 Figma 中直接打开对应节点查看。
- **基础/基础元素.md** 中的"声音 / 水印 / 头像"三节在 Figma 中为空 FRAME，已在文中标注"待补全"。

## 3. 颜色 token 不一致

- 部分组件 MD 中早期版本曾使用 `#3377FF` 作为按钮主色，与 `Brandblue60 #165DFF` 不一致。已在 [按钮.md](组件/按钮.md) 中说明，最终以 [色彩.md](基础/色彩.md) 为准。

## 4. 单位说明

- 所有 px 取值来自 Figma 设计稿，未按 dp/pt 换算。开发还原时请按各端 DPI 自行换算。
