@finedesign/cli 0.5.1 → 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 CHANGED
@@ -1,5 +1,23 @@
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
+
11
+ ## 0.6.0
12
+
13
+ 2026-11-09
14
+
15
+ - 新增 `init`,初始化 Cursor、Claude Code 与 Codex 的项目规则及 Skill;默认保留已有 Skill,覆盖需显式指定 `--force`。
16
+ - 新增 `add <component> [id]`,提取完整示例及辅助文件,保留相对目录与资源引用,输出依赖信息;写入前检查全部文件冲突。
17
+ - MCP 组件资料查询可省略 `version`,默认检测进程工作目录的组件版本,检测不到时使用内置 Skill 对应版本;运行时查询省略版本时使用当前托管版本。
18
+ - `lint` 增加 Select、Combo、PopConfirm 及 Pagination 的常见属性误用检查,支持 `Combo.Check` 与 NextTable 内联分页配置。
19
+ - 补充初始化覆盖保护、跨目录资源引用及冲突时不写入文件的回归测试,同步 MCP 接入说明与许可署名。
20
+
3
21
  ## 0.5.1
4
22
 
5
23
  2026-11-06
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT LICENSE
2
2
 
3
- Copyright (c) 2018-present JDY DESIGN, https://jdy.design/
3
+ Copyright (c) 2018-present Fine Design, https://docs.fanruan.design/index-cn
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining
6
6
  a copy of this software and associated documentation files (the
package/README.md CHANGED
@@ -45,17 +45,18 @@ npx -y @finedesign/cli lint src/ # 检查代码
45
45
 
46
46
  ### Skill
47
47
 
48
- CLI 内置 `skills/fine-design/SKILL.md`。将以下指令发给 AI 编码助手,或写入项目的 `AGENTS.md` / `CLAUDE.md`:
48
+ 安装 CLI 后,在项目根目录初始化:
49
49
 
50
- ```text
51
- 开发或修改 Fine Design 页面时,在目标项目目录运行 CLI。项目已安装 CLI 时用 `npx fine-design`,否则用 `npx -y @finedesign/cli`。
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 的客户端中添加:
@@ -71,7 +72,7 @@ CLI 内置 `skills/fine-design/SKILL.md`。将以下指令发给 AI 编码助手
71
72
  }
72
73
  ```
73
74
 
74
- MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检查和浏览器运行时查询。客户端可自动发现工具参数。组件查询需传入精确的 `version`,代码检查可以从目标工程检测版本,运行时查询需要联网。
75
+ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检查和浏览器运行时查询。客户端可自动发现工具参数。组件资料查询可省略 `version`:默认从 MCP 进程工作目录检测组件版本,检测不到时使用内置 Skill 对应的资料版本;已检测但未收录的版本仍会报错。代码检查从扫描目标检测版本。`get_browser_runtime` 省略版本时使用当前托管版本,运行时查询需要联网。
75
76
 
76
77
  ## 命令
77
78
 
@@ -92,17 +93,21 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
92
93
 
93
94
  | 命令 | 用途 |
94
95
  | --- | --- |
95
- | `doctor` | 检查组件版本、可用资料及 Skill 路径 |
96
+ | `doctor` | 检查组件版本、资料来源、可用资料及 Skill 路径 |
96
97
  | `lint [files-or-dirs...]` | 扫描常见 API 陷阱与非法导入 |
97
- | `diff [fromVer] [toVer]` | 对比版本间的文档、示例和迁移建议,支持 `--component <name>` |
98
+ | `diff [fromVer] [toVer]` | 对比版本间的文档和示例,提供通用迁移建议,支持 `--component <name>` |
98
99
 
99
- ### 集成与预览
100
+ ### 集成与代码落地
100
101
 
101
102
  | 命令 | 用途 |
102
103
  | --- | --- |
104
+ | `init` | 一键初始化 Agent 规则与配置(`--agent cursor/claude/codex/all`) |
105
+ | `add <component> [id]` | 提取组件示例代码及附属文件到项目目录(支持 `--output` 与 `--force`) |
103
106
  | `mcp` | 启动 stdio MCP 服务 |
104
107
  | `runtime [list]` | 查询在线运行时或生成完整 HTML 页面 |
105
108
 
109
+ `init` 默认保留已有 Skill,更新需指定 `--force`;共享规则文件中只更新带标记的 Fine Design 内容,旧版无标记规则需手动处理。`add` 保留示例文件之间的相对目录关系,跨目录资源会生成相应子目录;已有文件冲突时在写入前报错,覆盖需指定 `--force`。两个命令均支持 `--dry-run` 预览文件变更。
110
+
106
111
  ## 版本与输出
107
112
 
108
113
  - **组件版本**:`--fd-version` 优先,其次使用 `--project <目录>` 指定的工程。未指定时,`lint` 从扫描目标检测版本,其他组件查询从当前工程检测。未收录的版本会报错。