@finedesign/cli 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,8 +1,26 @@
1
1
  # 更新日志
2
2
 
3
+ ## 0.6.0
4
+
5
+ 2026-11-09
6
+
7
+ - 新增 `init`,初始化 Cursor、Claude Code 与 Codex 的项目规则及 Skill;默认保留已有 Skill,覆盖需显式指定 `--force`。
8
+ - 新增 `add <component> [id]`,提取完整示例及辅助文件,保留相对目录与资源引用,输出依赖信息;写入前检查全部文件冲突。
9
+ - MCP 组件资料查询可省略 `version`,默认检测进程工作目录的组件版本,检测不到时使用内置 Skill 对应版本;运行时查询省略版本时使用当前托管版本。
10
+ - `lint` 增加 Select、Combo、PopConfirm 及 Pagination 的常见属性误用检查,支持 `Combo.Check` 与 NextTable 内联分页配置。
11
+ - 补充初始化覆盖保护、跨目录资源引用及冲突时不写入文件的回归测试,同步 MCP 接入说明与许可署名。
12
+
13
+ ## 0.5.1
14
+
15
+ 2026-11-06
16
+
17
+ - `doctor` 在未检测到组件包时提示先确认在线 UMD 版本。清单读取失败时返回清单地址和排查提示。
18
+ - `lint` 检查 UMD 页面通过 `React.createElement` 传入的 Button 类型,并提示修正误用的 npm 样式导入路径。
19
+ - 更新 Agent 接入指令,先确定交付形式,再按目标版本查询组件 API 和示例。
20
+
3
21
  ## 0.5.0
4
22
 
5
- 2026-11-05
23
+ 2026-11-06
6
24
 
7
25
  - 明确已有 React 工程、无构建 HTML 和只查询资料时,各自使用的组件包、UMD 资源或公开 CLI。
8
26
  - CLI `diff --component <name>` 和 MCP `diff_catalogs` 的 `component` 参数支持按组件对比版本。结果补充被移除的章节、示例和别名,并识别同名章节和示例的内容变更。
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT LICENSE
2
2
 
3
- Copyright (c) 2018-present JDY DESIGN, https://jdy.design/
3
+ Copyright (c) 2018-present Fine Design, https://docs.fanruan.design/index-cn
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining
6
6
  a copy of this software and associated documentation files (the
package/README.md CHANGED
@@ -50,9 +50,10 @@ CLI 内置 `skills/fine-design/SKILL.md`。将以下指令发给 AI 编码助手
50
50
  ```text
51
51
  开发或修改 Fine Design 页面时,在目标项目目录运行 CLI。项目已安装 CLI 时用 `npx fine-design`,否则用 `npx -y @finedesign/cli`。
52
52
 
53
- 1. 运行 `doctor --format json`,读取 `bundledSkillPath` 指向的 Skill,按项目实际组件版本查资料。
54
- 2. 按目标版本用 `info` 查组件 API,按需用 `example` 读示例源码。
55
- 3. 对改动文件运行 `lint <改动文件>`,执行项目已有检查,验证受影响的交互。
53
+ 1. 运行 `doctor --format json` 并读取 `bundledSkillPath` 指向的 Skill。先确定交付形式。接入现有 React 工程时沿用项目组件版本、壳层和同类页面。
54
+ 2. 交付独立 HTML 或无构建预览时,先运行 `runtime list --format json`,再用返回的版本解析 UMD 资源并查询组件 API。
55
+ 3. 按目标版本用 `info` 查组件 API。`list --format json` 从 `components` 数组读取组件,`example <组件>` 先列示例 ID,按需再读源码。
56
+ 4. 对改动文件运行 `lint`,执行项目已有检查,并单独验证目标预览的渲染和关键交互。
56
57
  ```
57
58
 
58
59
  ### MCP
@@ -70,7 +71,7 @@ CLI 内置 `skills/fine-design/SKILL.md`。将以下指令发给 AI 编码助手
70
71
  }
71
72
  ```
72
73
 
73
- MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检查和浏览器运行时查询。客户端可自动发现工具参数。组件查询需传入精确的 `version`,代码检查可以从目标工程检测版本,运行时查询需要联网。
74
+ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检查和浏览器运行时查询。客户端可自动发现工具参数。组件资料查询可省略 `version`:默认从 MCP 进程工作目录检测组件版本,检测不到时使用内置 Skill 对应的资料版本;已检测但未收录的版本仍会报错。代码检查从扫描目标检测版本。`get_browser_runtime` 省略版本时使用当前托管版本,运行时查询需要联网。
74
75
 
75
76
  ## 命令
76
77
 
@@ -95,13 +96,17 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
95
96
  | `lint [files-or-dirs...]` | 扫描常见 API 陷阱与非法导入 |
96
97
  | `diff [fromVer] [toVer]` | 对比版本间的文档、示例和迁移建议,支持 `--component <name>` |
97
98
 
98
- ### 集成与预览
99
+ ### 集成与代码落地
99
100
 
100
101
  | 命令 | 用途 |
101
102
  | --- | --- |
103
+ | `init` | 一键初始化 Agent 规则与配置(`--agent cursor/claude/codex/all`) |
104
+ | `add <component> [id]` | 提取组件示例代码及附属文件到项目目录(支持 `--output` 与 `--force`) |
102
105
  | `mcp` | 启动 stdio MCP 服务 |
103
106
  | `runtime [list]` | 查询在线运行时或生成完整 HTML 页面 |
104
107
 
108
+ `init` 默认保留已有 Skill,覆盖需指定 `--force`。`add` 保留示例文件之间的相对目录关系,跨目录资源会生成相应子目录;已有文件冲突时在写入前报错,覆盖需指定 `--force`。
109
+
105
110
  ## 版本与输出
106
111
 
107
112
  - **组件版本**:`--fd-version` 优先,其次使用 `--project <目录>` 指定的工程。未指定时,`lint` 从扫描目标检测版本,其他组件查询从当前工程检测。未收录的版本会报错。
@@ -113,8 +118,8 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
113
118
  已有构建流程的 React 应用使用私有组件包 `@fx-ui/fine-design`。独立 HTML、无构建嵌入页和原型可使用公开 UMD 运行时,浏览器无需安装组件包。
114
119
 
115
120
  ```sh
116
- npx -y @finedesign/cli runtime list
117
- npx -y @finedesign/cli runtime --format html > demo.html
121
+ npx -y @finedesign/cli runtime list --format json
122
+ npx -y @finedesign/cli runtime --fd-version '<versions 中的版本>' --format html > demo.html
118
123
  ```
119
124
 
120
125
  [打开 Fine Design Playground](https://fine-design-runtime.pages.dev/)。生成的 HTML 固定资源版本并附带 SRI 校验;在线托管仅保留当前版本,长期归档请保存对应资源。