# 更新日志

## 0.9.0

2026-11-12

- 新增 Figma 组件物料清单。CLI 提供 `fine-design figma scan <file-or-dir>`，stdio MCP 提供 `scan_figma_components`。根据 JSX 与 `React.createElement` 的源码绑定识别组件，输出设计库节点、Code Connect 模板和未映射组件。CLI 支持 text、json 和 markdown。解析失败时返回部分清单及诊断。
- 优化 `figma resolve` 对设计规范总览画板的反查交互，提供明确的组件定位指引。

## 0.8.1

2026-11-11

- 精简内置 Skill 与离线运行时导出：移除通用性不足的任务列表组合示例与参考页面（`task-list.js`、`standalone-task-page.md`），`runtime --output` 默认导出聚焦真实组件加载与交互验证的通用页面。
- 清理相关业务状态测试，保持通用设计系统 Skill 约束与离线资源导出能力的轻量纯粹。

## 0.8.0

2026-11-11

- 新增离线 Figma 组件反查。CLI 提供 `fine-design figma resolve` 与 `figma list`，stdio MCP 提供 `resolve_figma_component` 与 `list_figma_components`。收录 70 个 Code Connect 模板及导入语句，并按模板提供适用的业务参数和静态包装函数签名。
- Figma 映射随资料同步生成。仓库构建检查快照与模板来源的一致性，独立构建检查快照完整性。

## 0.7.0

2026-11-10

- JSX 与 React.createElement 共用 API 检查，补齐 Select、Combo、NextTable、PopConfirm、Pagination、Dialog、Tag 和主题前缀检查，支持 React 工厂导入及展开属性的保守判断。
- 新增 `runtime --output <新目录>`，下载并校验四份必需资源，导出本地 HTML、任务列表组合示例及来源记录；支持 dry-run，拒绝覆盖已有目录，失败时不安装半成品。
- 随包提供筛选、分页、草稿编辑和确认删除的独立页面参考，补充业务语义、真实操作结果、键盘入口及验证边界要求。
- 初始化规则与内置 Skill 明确 Fine Design 任务的主动查询、自检和结果报告要求，支持全局 CLI，并复用同一会话的版本诊断及 API 资料。
- 更新站点和 Agent 接入提示词，补充已有项目规则的合并与更新方式；按需查询组件和示例，避免默认读取全部资料。

## 0.6.1

2026-11-10

- `init --force` 只更新共享规则文件中带标记的 Fine Design 内容，无标记的已有规则保留并提示手动处理。
- `init` 和 `add` 增加 `--dry-run`，预览新建、更新、跳过和冲突；`doctor` 显示版本选择方式与资料来源。
- 补充公开 CLI、独立 HTML 运行时发现、替代实现与验证边界的 Agent 指引；`diff` 的通用迁移建议明确标注为非版本专属。

## 0.6.0

2026-11-09

- 新增 `init`，初始化 Cursor、Claude Code 与 Codex 的项目规则及 Skill；默认保留已有 Skill，覆盖需显式指定 `--force`。
- 新增 `add <component> [id]`，提取完整示例及辅助文件，保留相对目录与资源引用，输出依赖信息；写入前检查全部文件冲突。
- MCP 组件资料查询可省略 `version`，默认检测进程工作目录的组件版本，检测不到时使用内置 Skill 对应版本；运行时查询省略版本时使用当前托管版本。
- `lint` 增加 Select、Combo、PopConfirm 及 Pagination 的常见属性误用检查，支持 `Combo.Check` 与 NextTable 内联分页配置。
- 补充初始化覆盖保护、跨目录资源引用及冲突时不写入文件的回归测试，同步 MCP 接入说明与许可署名。

## 0.5.1

2026-11-06

- `doctor` 在未检测到组件包时提示先确认在线 UMD 版本。清单读取失败时返回清单地址和排查提示。
- `lint` 检查 UMD 页面通过 `React.createElement` 传入的 Button 类型，并提示修正误用的 npm 样式导入路径。
- 更新 Agent 接入指令，先确定交付形式，再按目标版本查询组件 API 和示例。

## 0.5.0

2026-11-06

- 明确已有 React 工程、无构建 HTML 和只查询资料时，各自使用的组件包、UMD 资源或公开 CLI。
- CLI `diff --component <name>` 和 MCP `diff_catalogs` 的 `component` 参数支持按组件对比版本。结果补充被移除的章节、示例和别名，并识别同名章节和示例的内容变更。
- CLI `example <component>` 和 MCP `get_component_example` 省略示例 ID 时列出可用 ID 和标题，指定 ID 后读取源码和资源。

## 0.4.0

2026-11-05

- MCP 新增组件概览、Design Token、版本对比和代码检查，支持省略可选的工具参数。
- CLI 和 MCP 按扫描目标检测 Fine Design 版本，仅在执行 `lint` 时加载语法解析器。代码检查支持传统装饰器和 SVG 图标类型导入。
- 补齐 `1.24.9` 的 `Combo.Check`、图标示例和组件别名，更新 `1.25.0` 示例中的 Dialog 回调与图标导入。日期示例导出时移除站点专用样式前缀。

## 0.3.1

2026-11-05

- 重整 npm README，固定功能、安装、快速开始、Agent 集成与命令索引等章节，精简接入说明并使用动态版本徽章。
- 增加 README 维护约定和构建校验，普通发版无需改写正文；CLI 命令、组件资料和依赖保持不变。

## 0.3.0

2026-11-05

- 新增 `list`、`info`、`token`、`lint`、`diff` 命令，支持组件列表、API 概览、设计变量查询、代码检查和跨版本资料对比；搜索新增 `--limit`。
- 优化搜索排序，补充中文、子组件及图标别名和拼写建议；完善资料简介、Token 表格及可复用示例。
- `lint` 使用语法树区分代码、注释和字符串，修正 Button 类型与建议，支持解构重命名，并区分类型导出和运行时值。
- 从对应历史提交补齐 Fine Design `1.24.9` 的组件 Token 资料；文本 `diff` 增加被移除组件列表。
- 补齐 `1.24.9` 内置图标导出，修复 `lint` 对组件重命名及局部同名绑定的误判，并使 Token 查询的 Markdown 输出遵循筛选条件。

## 0.2.0

2026-11-04

- CLI/MCP 增加在线 UMD 查询，按精确组件版本返回版本化 URL、SRI 和加载标签；仅托管当前最新文件，旧版本缺失时明确报错。
- `runtime --format html` 生成完整可运行页面，固定托管资源的版本化 URL、SRI 和 CORS 属性；失败时显示具体资源地址。默认入口统一为已验收的 Cloudflare production。
- 保留离线文档的多版本能力，与在线 UMD 可用性分别报告。
- 发布工具、托管、文档导出和 Skill 作者源统一至 `tools/fine-design`，提供完整本地构建、浏览器与打包安装验收。
- CLI 上传前持久化意图，上传中断保留原 tgz，仅继续查询和验收。

## 0.2.0-rc.0

2026-11-03

- 新增 `fine-design doctor` 只读环境自检命令，查看当前识别的组件版本、内置离线目录版本及内置 Skill 路径。
- `doc` 命令新增 `--toc` / `--summary`（MCP `get_component_doc` 新增可选 `summary: true`），支持先读取章节目录与示例列表再按需读取正文；`--section` 支持大小写不敏感匹配与相近章节提示。
- `example` / `get_component_example` 默认对超过 16 KB 的非入口 JSON 数据夹具返回截断预览与哈希元信息，通过 `--include-assets` / `includeAssets: true` 获取完整内容。
- 支持在 `@fx-ui/fine-design` 组件库源码仓库内直接识别工作区版本，并为 MCP 服务增加进程内目录缓存。
- 导出器与离线资料新增 `Combo.Check`（`combo-check`）独立文档及全部内置图标别名检索，收录 Fine Design `1.25.0`（保留 `1.24.9`）并同步最新 Fine Design Skill。

## 0.1.0

2026-11-02

- 发布首个正式版本，提供组件搜索、文档与示例查询，以及三个只读 MCP 工具。
- 改善组件未安装时的排查提示，支持在未安装组件库的工程中显式指定版本查询离线资料。
- 补充组件库安装、私有源认证和独立 HTML 预览说明，区分公开 CLI 与组件库的安装要求。
- 内置 Fine Design 1.24.9 中文资料及更新后的 Fine Design Skill。

## 0.1.0-rc.0

2026-11-02

- 提供 `fine-design` 命令，支持组件搜索、文档章节和示例查询。
- 提供 stdio MCP 服务，包含三个只读工具，与 CLI 使用相同的查询结果和错误契约。
- 内置 Fine Design 1.24.9 中文资料和 Fine Design Skill。
- 支持完整示例文件及相对依赖读取；二进制资源默认返回元信息，可按需获取完整内容。
- 支持从项目实际安装包识别组件版本；未收录版本明确报错。