@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 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 内置 `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 的客户端中添加:
@@ -92,9 +93,9 @@ 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
 
@@ -105,7 +106,7 @@ MCP 提供组件搜索、API、Design Token、示例、版本对比、代码检
105
106
  | `mcp` | 启动 stdio MCP 服务 |
106
107
  | `runtime [list]` | 查询在线运行时或生成完整 HTML 页面 |
107
108
 
108
- `init` 默认保留已有 Skill,覆盖需指定 `--force`。`add` 保留示例文件之间的相对目录关系,跨目录资源会生成相应子目录;已有文件冲突时在写入前报错,覆盖需指定 `--force`。
109
+ `init` 默认保留已有 Skill,更新需指定 `--force`;共享规则文件中只更新带标记的 Fine Design 内容,旧版无标记规则需手动处理。`add` 保留示例文件之间的相对目录关系,跨目录资源会生成相应子目录;已有文件冲突时在写入前报错,覆盖需指定 `--force`。两个命令均支持 `--dry-run` 预览文件变更。
109
110
 
110
111
  ## 版本与输出
111
112