@finedesign/cli 0.6.1 → 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 +10 -0
- package/README.md +19 -13
- 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 +5 -4
- package/skills/fine-design/references/component-guide.md +4 -0
- package/skills/fine-design/references/imports-and-setup.md +2 -0
- 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 +15 -9
- package/src/core/html.cjs +12 -10
- package/src/core/lint.mjs +75 -78
- package/src/core/runtime.mjs +59 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,15 @@
|
|
|
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
|
+
|
|
3
13
|
## 0.6.1
|
|
4
14
|
|
|
5
15
|
2026-11-10
|
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,17 @@ npx -y @finedesign/cli lint src/ # 检查代码
|
|
|
45
48
|
|
|
46
49
|
### Skill
|
|
47
50
|
|
|
48
|
-
安装 CLI
|
|
51
|
+
安装 CLI 后,在准备使用 AI 助手的工作目录初始化:
|
|
49
52
|
|
|
50
53
|
```sh
|
|
51
|
-
|
|
54
|
+
fine-design init
|
|
52
55
|
```
|
|
53
56
|
|
|
54
|
-
`init` 默认配置 Cursor、Claude Code 和 Codex
|
|
57
|
+
空目录也可初始化,无需现有 React 项目或 `package.json`。`init` 默认配置 Cursor、Claude Code 和 Codex,写入主动调用 CLI 的项目规则,并为 Claude Code、Codex 安装内置 Skill;已有配置默认保留。换一个工作目录时,再执行一次 `fine-design init`。后续直接描述业务需求,助手会在 Fine Design 任务中核对目标版本 API、按需读取示例,并在改动后运行 lint 和项目检查;同一会话已查资料可复用。
|
|
55
58
|
|
|
56
59
|
也可让 AI 编码助手完成接入:
|
|
57
60
|
|
|
58
|
-
>
|
|
61
|
+
> 全局安装 `@finedesign/cli`(已安装则复用),在当前工作目录运行 `fine-design init`,空目录也可。确认当前助手的项目规则包含:涉及 Fine Design 的任务主动用 CLI 核对目标版本 API,改动后运行 lint 和项目检查。保留已有规则,本次只完成接入。
|
|
59
62
|
|
|
60
63
|
### MCP
|
|
61
64
|
|
|
@@ -76,7 +79,7 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
|
|
|
76
79
|
|
|
77
80
|
## 命令
|
|
78
81
|
|
|
79
|
-
以下命令均使用 `
|
|
82
|
+
以下命令均使用 `fine-design` 前缀,完整参数见 `fine-design --help`。
|
|
80
83
|
|
|
81
84
|
### 组件资料
|
|
82
85
|
|
|
@@ -119,10 +122,13 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
|
|
|
119
122
|
已有构建流程的 React 应用使用私有组件包 `@fx-ui/fine-design`。独立 HTML、无构建嵌入页和原型可使用公开 UMD 运行时,浏览器无需安装组件包。
|
|
120
123
|
|
|
121
124
|
```sh
|
|
122
|
-
|
|
123
|
-
|
|
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
|
|
124
128
|
```
|
|
125
129
|
|
|
130
|
+
`--output` 将资源、运行时示例和任务列表组合示例写入新目录,保留 SRI 与来源记录;已有目录不会覆盖。可加 `--dry-run --format json` 预览文件列表。首次导出需要联网,之后页面仅引用本地资源;宿主仍须允许页面脚本和样式。
|
|
131
|
+
|
|
126
132
|
[打开 Fine Design Playground](https://fine-design-runtime.pages.dev/)。生成的 HTML 固定资源版本并附带 SRI 校验;在线托管仅保留当前版本,长期归档请保存对应资源。
|
|
127
133
|
|
|
128
134
|
## 更多资料
|