@finedesign/cli 0.7.0 → 0.8.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 +7 -0
- package/README.md +4 -3
- package/data/1.25.0/catalog.json +1 -1
- package/data/1.25.0/manifest.json +3 -3
- package/package.json +1 -1
- package/src/cli.mjs +129 -3
- package/src/core/contracts.mjs +10 -1
- package/src/core/figma-data.json +2929 -0
- package/src/core/figma.mjs +138 -0
- package/src/mcp.mjs +9 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# 更新日志
|
|
2
2
|
|
|
3
|
+
## 0.8.0
|
|
4
|
+
|
|
5
|
+
2026-11-11
|
|
6
|
+
|
|
7
|
+
- 新增离线 Figma 组件反查。CLI 提供 `fine-design figma resolve` 与 `figma list`,stdio MCP 提供 `resolve_figma_component` 与 `list_figma_components`。收录 70 个 Code Connect 模板及导入语句,并按模板提供适用的业务参数和静态包装函数签名。
|
|
8
|
+
- Figma 映射随资料同步生成。仓库构建检查快照与模板来源的一致性,独立构建检查快照完整性。
|
|
9
|
+
|
|
3
10
|
## 0.7.0
|
|
4
11
|
|
|
5
12
|
2026-11-10
|
package/README.md
CHANGED
|
@@ -75,7 +75,7 @@ fine-design init
|
|
|
75
75
|
}
|
|
76
76
|
```
|
|
77
77
|
|
|
78
|
-
MCP 提供组件搜索、API、Design Token
|
|
78
|
+
MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检查、浏览器运行时查询以及 Figma 节点与 Code Connect 映射解析(`resolve_figma_component` / `list_figma_components`)。客户端可自动发现工具参数。组件资料查询可省略 `version`:默认从 MCP 进程工作目录检测组件版本,检测不到时使用内置 Skill 对应的资料版本;已检测但未收录的版本仍会报错。代码检查从扫描目标检测版本。`get_browser_runtime` 省略版本时使用当前托管版本,运行时查询需要联网。
|
|
79
79
|
|
|
80
80
|
## 命令
|
|
81
81
|
|
|
@@ -106,6 +106,7 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
|
|
|
106
106
|
| --- | --- |
|
|
107
107
|
| `init` | 一键初始化 Agent 规则与配置(`--agent cursor/claude/codex/all`) |
|
|
108
108
|
| `add <component> [id]` | 提取组件示例代码及附属文件到项目目录(支持 `--output` 与 `--force`) |
|
|
109
|
+
| `figma <resolve\|list>` | 反查 Fine Design 库节点的离线 Code Connect 映射,或浏览已连接模板 |
|
|
109
110
|
| `mcp` | 启动 stdio MCP 服务 |
|
|
110
111
|
| `runtime [list]` | 查询在线运行时或生成完整 HTML 页面 |
|
|
111
112
|
|
|
@@ -114,7 +115,7 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
|
|
|
114
115
|
## 版本与输出
|
|
115
116
|
|
|
116
117
|
- **组件版本**:`--fd-version` 优先,其次使用 `--project <目录>` 指定的工程。未指定时,`lint` 从扫描目标检测版本,其他组件查询从当前工程检测。未收录的版本会报错。
|
|
117
|
-
- **输出格式**:默认文本;`--format json` 适合 Agent。`doc`、`info`、`token` 支持 Markdown;`runtime` 支持 HTML。
|
|
118
|
+
- **输出格式**:默认文本;`--format json` 适合 Agent。`doc`、`info`、`token`、`figma` 支持 Markdown;`runtime` 支持 HTML。
|
|
118
119
|
- **结果与错误**:结果写入 stdout,错误写入 stderr。退出码 `0` 表示成功,`1` 表示检查未通过或运行错误,`2` 为参数问题,`3` 为版本问题,`4` 为资料未找到。
|
|
119
120
|
|
|
120
121
|
## 浏览器预览
|
|
@@ -127,7 +128,7 @@ fine-design runtime --fd-version '<versions 中的版本>' --format html > demo.
|
|
|
127
128
|
fine-design runtime --fd-version '<versions 中的版本>' --output ./offline-demo
|
|
128
129
|
```
|
|
129
130
|
|
|
130
|
-
`--output`
|
|
131
|
+
`--output` 将运行时示例、任务列表组合示例、资源和来源记录写入新目录,并保留 SRI。可加 `--dry-run --format json` 预览文件列表。首次导出需要联网,生成的页面仅引用本地资源。宿主须允许页面脚本和样式。
|
|
131
132
|
|
|
132
133
|
[打开 Fine Design Playground](https://fine-design-runtime.pages.dev/)。生成的 HTML 固定资源版本并附带 SRI 校验;在线托管仅保留当前版本,长期归档请保存对应资源。
|
|
133
134
|
|