@finedesign/cli 0.10.0 → 0.11.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 +9 -0
- package/README.md +8 -7
- package/data/1.25.1/catalog.json +1 -1
- package/data/1.25.1/manifest.json +5 -5
- package/package.json +1 -1
- package/skills/fine-design/references/component-guide.md +6 -3
- package/skills/fine-design/references/docs-slug-map.md +4 -4
- package/src/cli.mjs +55 -29
- package/src/core/catalog.mjs +108 -14
- package/src/core/contracts.mjs +5 -0
- package/src/core/figma.mjs +1 -0
- package/src/mcp.mjs +1 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,14 @@
|
|
|
1
1
|
# 更新日志
|
|
2
2
|
|
|
3
|
+
## 0.11.0
|
|
4
|
+
|
|
5
|
+
待发布
|
|
6
|
+
|
|
7
|
+
- `init --rules-only` 为选定的助手生成项目规则,按需读取 CLI 随包 Skill。生成的规则固定回退命令的 CLI 包名和版本。
|
|
8
|
+
- `figma scan` 和 MCP 物料清单同时返回源码组件与设计映射。例如源码中的 `Table` 映射到 `NextTable` 模板时,保留 `Table` 供工程 API 核对。
|
|
9
|
+
- CLI 和 MCP 优先匹配精确组件名,并为表格、下拉、级联等场景词推荐组件。
|
|
10
|
+
- 补齐 Fine Design 1.25.1 的旧版 `Table`、`Cascader` API 和示例。
|
|
11
|
+
|
|
3
12
|
## 0.10.0
|
|
4
13
|
|
|
5
14
|
2026-11-18
|
package/README.md
CHANGED
|
@@ -48,17 +48,17 @@ fine-design lint src/ # 检查代码
|
|
|
48
48
|
|
|
49
49
|
### Skill
|
|
50
50
|
|
|
51
|
-
|
|
51
|
+
全局安装 CLI 后,在项目根目录为正在使用的助手初始化规则。以 Codex 为例:
|
|
52
52
|
|
|
53
53
|
```sh
|
|
54
|
-
fine-design init
|
|
54
|
+
fine-design init --agent codex --rules-only
|
|
55
55
|
```
|
|
56
56
|
|
|
57
|
-
|
|
57
|
+
`--rules-only` 写入项目规则,由助手按需读取 CLI 随包的 Skill。同一份全局 CLI 可供多个项目使用,组件版本按工程检测。按客户端选择 `--agent codex`、`--agent claude` 或 `--agent cursor`,也可在空目录初始化。需要在客户端注册可直接调用的本地 Skill 时,使用完整初始化 `fine-design init --agent codex` 或 `fine-design init --agent claude`。
|
|
58
58
|
|
|
59
59
|
也可让 AI 编码助手完成接入:
|
|
60
60
|
|
|
61
|
-
> 全局安装 `@finedesign/cli
|
|
61
|
+
> 全局安装 `@finedesign/cli`,已有兼容版本时可复用。在项目根目录按当前助手运行 `fine-design init --agent <助手> --rules-only`。用 `fine-design doctor --format json` 核对组件版本和随包 Skill 路径。
|
|
62
62
|
|
|
63
63
|
### MCP
|
|
64
64
|
|
|
@@ -75,7 +75,7 @@ fine-design init
|
|
|
75
75
|
}
|
|
76
76
|
```
|
|
77
77
|
|
|
78
|
-
MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检查、浏览器运行时查询以及 Figma 节点映射与代码物料清单扫描(`resolve_figma_component` / `list_figma_components` / `scan_figma_components
|
|
78
|
+
MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检查、浏览器运行时查询以及 Figma 节点映射与代码物料清单扫描(`resolve_figma_component` / `list_figma_components` / `scan_figma_components`)。客户端可自动发现工具参数。`get_generation_context` 按精确 `version` 查询多个组件的 API 和示例摘要。其他组件资料查询省略版本时,从 MCP 进程工作目录检测组件版本,检测不到时使用内置 Skill 对应的资料版本。已检测但未收录的版本仍会报错。代码检查从扫描目标检测版本。`get_browser_runtime` 省略版本时使用当前托管版本,运行时查询需要联网。
|
|
79
79
|
|
|
80
80
|
## 命令
|
|
81
81
|
|
|
@@ -88,6 +88,7 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
|
|
|
88
88
|
| `list` | 浏览组件及导出项 |
|
|
89
89
|
| `search [query]` | 搜索组件、中文别名、子组件与图标 |
|
|
90
90
|
| `info <component>` | 查看组件概览与 API |
|
|
91
|
+
| `context <component...>` | 一次查看最多六个组件的 API 小节与示例索引 |
|
|
91
92
|
| `doc <component>` | 阅读文档;`--toc` 查看目录,`--section` 选择章节 |
|
|
92
93
|
| `token [component] [query]` | 查询与筛选全局或组件 Token |
|
|
93
94
|
| `example <component> [id]` | 列出示例 ID 和标题,或按 ID 读取源码及资源信息 |
|
|
@@ -104,9 +105,9 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
|
|
|
104
105
|
|
|
105
106
|
| 命令 | 用途 |
|
|
106
107
|
| --- | --- |
|
|
107
|
-
| `init` |
|
|
108
|
+
| `init` | 初始化 Agent 规则与配置(`--agent cursor/claude/codex/all`,`--rules-only`) |
|
|
108
109
|
| `add <component> [id]` | 提取组件示例代码及附属文件到项目目录(支持 `--output` 与 `--force`) |
|
|
109
|
-
| `figma <resolve\|list\|scan>` | 反查 Fine Design 库节点的离线 Code Connect
|
|
110
|
+
| `figma <resolve\|list\|scan>` | 反查 Fine Design 库节点的离线 Code Connect 映射、浏览已连接模板,或扫描源码组件与对应的设计映射 |
|
|
110
111
|
| `mcp` | 启动 stdio MCP 服务 |
|
|
111
112
|
| `runtime [list]` | 查询在线运行时或生成完整 HTML 页面 |
|
|
112
113
|
|