@finedesign/cli 0.6.0 → 0.6.1
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 +8 -0
- package/README.md +12 -11
- package/data/1.25.0/catalog.json +1 -1
- package/data/1.25.0/manifest.json +5 -5
- package/package.json +1 -1
- package/skills/fine-design/SKILL.md +4 -1
- package/skills/fine-design/references/imports-and-setup.md +2 -2
- package/src/cli.mjs +106 -65
- package/src/core/catalog.mjs +1 -0
- package/src/mcp.mjs +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,13 @@
|
|
|
1
1
|
# 更新日志
|
|
2
2
|
|
|
3
|
+
## 0.6.1
|
|
4
|
+
|
|
5
|
+
2026-11-10
|
|
6
|
+
|
|
7
|
+
- `init --force` 只更新共享规则文件中带标记的 Fine Design 内容,无标记的已有规则保留并提示手动处理。
|
|
8
|
+
- `init` 和 `add` 增加 `--dry-run`,预览新建、更新、跳过和冲突;`doctor` 显示版本选择方式与资料来源。
|
|
9
|
+
- 补充公开 CLI、独立 HTML 运行时发现、替代实现与验证边界的 Agent 指引;`diff` 的通用迁移建议明确标注为非版本专属。
|
|
10
|
+
|
|
3
11
|
## 0.6.0
|
|
4
12
|
|
|
5
13
|
2026-11-09
|
package/README.md
CHANGED
|
@@ -45,17 +45,18 @@ npx -y @finedesign/cli lint src/ # 检查代码
|
|
|
45
45
|
|
|
46
46
|
### Skill
|
|
47
47
|
|
|
48
|
-
CLI
|
|
48
|
+
安装 CLI 后,在项目根目录初始化:
|
|
49
49
|
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
|
|
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`,执行项目已有检查,并单独验证目标预览的渲染和关键交互。
|
|
50
|
+
```sh
|
|
51
|
+
npx fine-design init
|
|
57
52
|
```
|
|
58
53
|
|
|
54
|
+
`init` 默认配置 Cursor、Claude Code 和 Codex,写入项目规则,并为 Claude Code、Codex 安装内置 Skill;已有配置默认保留。完成后直接描述业务需求,Agent 会使用 `npx fine-design` 查询组件与检查代码。
|
|
55
|
+
|
|
56
|
+
也可让 AI 编码助手完成接入:
|
|
57
|
+
|
|
58
|
+
> 使用项目现有包管理器安装开发依赖 `@finedesign/cli`(已安装则复用),然后运行 `npx fine-design init`。只完成安装和初始化,后续 Fine Design 任务使用该 CLI。
|
|
59
|
+
|
|
59
60
|
### MCP
|
|
60
61
|
|
|
61
62
|
在支持 stdio MCP 的客户端中添加:
|
|
@@ -92,9 +93,9 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
|
|
|
92
93
|
|
|
93
94
|
| 命令 | 用途 |
|
|
94
95
|
| --- | --- |
|
|
95
|
-
| `doctor` |
|
|
96
|
+
| `doctor` | 检查组件版本、资料来源、可用资料及 Skill 路径 |
|
|
96
97
|
| `lint [files-or-dirs...]` | 扫描常见 API 陷阱与非法导入 |
|
|
97
|
-
| `diff [fromVer] [toVer]` |
|
|
98
|
+
| `diff [fromVer] [toVer]` | 对比版本间的文档和示例,提供通用迁移建议,支持 `--component <name>` |
|
|
98
99
|
|
|
99
100
|
### 集成与代码落地
|
|
100
101
|
|
|
@@ -105,7 +106,7 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
|
|
|
105
106
|
| `mcp` | 启动 stdio MCP 服务 |
|
|
106
107
|
| `runtime [list]` | 查询在线运行时或生成完整 HTML 页面 |
|
|
107
108
|
|
|
108
|
-
`init` 默认保留已有 Skill
|
|
109
|
+
`init` 默认保留已有 Skill,更新需指定 `--force`;共享规则文件中只更新带标记的 Fine Design 内容,旧版无标记规则需手动处理。`add` 保留示例文件之间的相对目录关系,跨目录资源会生成相应子目录;已有文件冲突时在写入前报错,覆盖需指定 `--force`。两个命令均支持 `--dry-run` 预览文件变更。
|
|
109
110
|
|
|
110
111
|
## 版本与输出
|
|
111
112
|
|