@finedesign/cli 0.6.0 → 0.7.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 +18 -0
- package/README.md +27 -20
- package/data/1.25.0/catalog.json +1 -1
- package/data/1.25.0/manifest.json +8 -6
- package/package.json +1 -1
- package/skills/fine-design/SKILL.md +7 -3
- package/skills/fine-design/references/component-guide.md +4 -0
- package/skills/fine-design/references/imports-and-setup.md +4 -2
- package/skills/fine-design/references/standalone-task-page.md +30 -0
- package/skills/fine-design/references/task-list.js +82 -0
- package/src/cli.mjs +119 -72
- package/src/core/catalog.mjs +1 -0
- package/src/core/html.cjs +12 -10
- package/src/core/lint.mjs +75 -78
- package/src/core/runtime.mjs +59 -2
- package/src/mcp.mjs +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,23 @@
|
|
|
1
1
|
# 更新日志
|
|
2
2
|
|
|
3
|
+
## 0.7.0
|
|
4
|
+
|
|
5
|
+
2026-11-10
|
|
6
|
+
|
|
7
|
+
- JSX 与 React.createElement 共用 API 检查,补齐 Select、Combo、NextTable、PopConfirm、Pagination、Dialog、Tag 和主题前缀检查,支持 React 工厂导入及展开属性的保守判断。
|
|
8
|
+
- 新增 `runtime --output <新目录>`,下载并校验四份必需资源,导出本地 HTML、任务列表组合示例及来源记录;支持 dry-run,拒绝覆盖已有目录,失败时不安装半成品。
|
|
9
|
+
- 随包提供筛选、分页、草稿编辑和确认删除的独立页面参考,补充业务语义、真实操作结果、键盘入口及验证边界要求。
|
|
10
|
+
- 初始化规则与内置 Skill 明确 Fine Design 任务的主动查询、自检和结果报告要求,支持全局 CLI,并复用同一会话的版本诊断及 API 资料。
|
|
11
|
+
- 更新站点和 Agent 接入提示词,补充已有项目规则的合并与更新方式;按需查询组件和示例,避免默认读取全部资料。
|
|
12
|
+
|
|
13
|
+
## 0.6.1
|
|
14
|
+
|
|
15
|
+
2026-11-10
|
|
16
|
+
|
|
17
|
+
- `init --force` 只更新共享规则文件中带标记的 Fine Design 内容,无标记的已有规则保留并提示手动处理。
|
|
18
|
+
- `init` 和 `add` 增加 `--dry-run`,预览新建、更新、跳过和冲突;`doctor` 显示版本选择方式与资料来源。
|
|
19
|
+
- 补充公开 CLI、独立 HTML 运行时发现、替代实现与验证边界的 Agent 指引;`diff` 的通用迁移建议明确标注为非版本专属。
|
|
20
|
+
|
|
3
21
|
## 0.6.0
|
|
4
22
|
|
|
5
23
|
2026-11-09
|
package/README.md
CHANGED
|
@@ -17,26 +17,29 @@
|
|
|
17
17
|
- **精确版本**:识别工程实际安装的组件版本,不自动替换为其他版本的资料。
|
|
18
18
|
- **Agent 接入**:内置 Fine Design Skill,支持 JSON 输出与 stdio MCP。
|
|
19
19
|
- **代码检查**:只读扫描常见 API 误用和非法导入,不修改源文件。
|
|
20
|
+
- **离线预览**:导出校验过的浏览器资源和可运行示例,便于本地预览与归档。
|
|
20
21
|
|
|
21
22
|
## 安装
|
|
22
23
|
|
|
23
|
-
需要 Node.js 20
|
|
24
|
+
需要 Node.js 20+。推荐全局安装,一台机器只需安装一次,无需已有项目:
|
|
24
25
|
|
|
25
26
|
```sh
|
|
26
|
-
npm install -
|
|
27
|
+
npm install -g @finedesign/cli
|
|
27
28
|
```
|
|
28
29
|
|
|
29
30
|
也可通过 `npx -y @finedesign/cli` 直接运行。CLI 安装和离线查询无需公司私有 npm 源;组件包安装是独立操作。
|
|
30
31
|
|
|
32
|
+
团队需要通过锁文件固定版本时,可在已有项目中用 `npm install -D @finedesign/cli` 安装,之后用 `npx fine-design` 调用。
|
|
33
|
+
|
|
31
34
|
## 快速开始
|
|
32
35
|
|
|
33
36
|
在使用 Fine Design 的工程目录运行:
|
|
34
37
|
|
|
35
38
|
```sh
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
39
|
+
fine-design doctor # 检查组件版本与内置 Skill 路径
|
|
40
|
+
fine-design info Button --format json # 查询组件 API
|
|
41
|
+
fine-design example Button basic # 读取真实示例源码
|
|
42
|
+
fine-design lint src/ # 检查代码
|
|
40
43
|
```
|
|
41
44
|
|
|
42
45
|
尚未安装组件时,先用 `doctor` 查看可用资料版本,再通过 `--fd-version <组件版本>` 指定目标版本。
|
|
@@ -45,17 +48,18 @@ npx -y @finedesign/cli lint src/ # 检查代码
|
|
|
45
48
|
|
|
46
49
|
### Skill
|
|
47
50
|
|
|
48
|
-
CLI
|
|
49
|
-
|
|
50
|
-
```text
|
|
51
|
-
开发或修改 Fine Design 页面时,在目标项目目录运行 CLI。项目已安装 CLI 时用 `npx fine-design`,否则用 `npx -y @finedesign/cli`。
|
|
51
|
+
安装 CLI 后,在准备使用 AI 助手的工作目录初始化:
|
|
52
52
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
3. 按目标版本用 `info` 查组件 API。`list --format json` 从 `components` 数组读取组件,`example <组件>` 先列示例 ID,按需再读源码。
|
|
56
|
-
4. 对改动文件运行 `lint`,执行项目已有检查,并单独验证目标预览的渲染和关键交互。
|
|
53
|
+
```sh
|
|
54
|
+
fine-design init
|
|
57
55
|
```
|
|
58
56
|
|
|
57
|
+
空目录也可初始化,无需现有 React 项目或 `package.json`。`init` 默认配置 Cursor、Claude Code 和 Codex,写入主动调用 CLI 的项目规则,并为 Claude Code、Codex 安装内置 Skill;已有配置默认保留。换一个工作目录时,再执行一次 `fine-design init`。后续直接描述业务需求,助手会在 Fine Design 任务中核对目标版本 API、按需读取示例,并在改动后运行 lint 和项目检查;同一会话已查资料可复用。
|
|
58
|
+
|
|
59
|
+
也可让 AI 编码助手完成接入:
|
|
60
|
+
|
|
61
|
+
> 全局安装 `@finedesign/cli`(已安装则复用),在当前工作目录运行 `fine-design init`,空目录也可。确认当前助手的项目规则包含:涉及 Fine Design 的任务主动用 CLI 核对目标版本 API,改动后运行 lint 和项目检查。保留已有规则,本次只完成接入。
|
|
62
|
+
|
|
59
63
|
### MCP
|
|
60
64
|
|
|
61
65
|
在支持 stdio MCP 的客户端中添加:
|
|
@@ -75,7 +79,7 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
|
|
|
75
79
|
|
|
76
80
|
## 命令
|
|
77
81
|
|
|
78
|
-
以下命令均使用 `
|
|
82
|
+
以下命令均使用 `fine-design` 前缀,完整参数见 `fine-design --help`。
|
|
79
83
|
|
|
80
84
|
### 组件资料
|
|
81
85
|
|
|
@@ -92,9 +96,9 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
|
|
|
92
96
|
|
|
93
97
|
| 命令 | 用途 |
|
|
94
98
|
| --- | --- |
|
|
95
|
-
| `doctor` |
|
|
99
|
+
| `doctor` | 检查组件版本、资料来源、可用资料及 Skill 路径 |
|
|
96
100
|
| `lint [files-or-dirs...]` | 扫描常见 API 陷阱与非法导入 |
|
|
97
|
-
| `diff [fromVer] [toVer]` |
|
|
101
|
+
| `diff [fromVer] [toVer]` | 对比版本间的文档和示例,提供通用迁移建议,支持 `--component <name>` |
|
|
98
102
|
|
|
99
103
|
### 集成与代码落地
|
|
100
104
|
|
|
@@ -105,7 +109,7 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
|
|
|
105
109
|
| `mcp` | 启动 stdio MCP 服务 |
|
|
106
110
|
| `runtime [list]` | 查询在线运行时或生成完整 HTML 页面 |
|
|
107
111
|
|
|
108
|
-
`init` 默认保留已有 Skill
|
|
112
|
+
`init` 默认保留已有 Skill,更新需指定 `--force`;共享规则文件中只更新带标记的 Fine Design 内容,旧版无标记规则需手动处理。`add` 保留示例文件之间的相对目录关系,跨目录资源会生成相应子目录;已有文件冲突时在写入前报错,覆盖需指定 `--force`。两个命令均支持 `--dry-run` 预览文件变更。
|
|
109
113
|
|
|
110
114
|
## 版本与输出
|
|
111
115
|
|
|
@@ -118,10 +122,13 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
|
|
|
118
122
|
已有构建流程的 React 应用使用私有组件包 `@fx-ui/fine-design`。独立 HTML、无构建嵌入页和原型可使用公开 UMD 运行时,浏览器无需安装组件包。
|
|
119
123
|
|
|
120
124
|
```sh
|
|
121
|
-
|
|
122
|
-
|
|
125
|
+
fine-design runtime list --format json
|
|
126
|
+
fine-design runtime --fd-version '<versions 中的版本>' --format html > demo.html
|
|
127
|
+
fine-design runtime --fd-version '<versions 中的版本>' --output ./offline-demo
|
|
123
128
|
```
|
|
124
129
|
|
|
130
|
+
`--output` 将资源、运行时示例和任务列表组合示例写入新目录,保留 SRI 与来源记录;已有目录不会覆盖。可加 `--dry-run --format json` 预览文件列表。首次导出需要联网,之后页面仅引用本地资源;宿主仍须允许页面脚本和样式。
|
|
131
|
+
|
|
125
132
|
[打开 Fine Design Playground](https://fine-design-runtime.pages.dev/)。生成的 HTML 固定资源版本并附带 SRI 校验;在线托管仅保留当前版本,长期归档请保存对应资源。
|
|
126
133
|
|
|
127
134
|
## 更多资料
|