@yyc3/cli

YYC³ UI 智能编程库 CLI — 言启象限 · 语枢未来。基于 shadcn/ui v4.5.0 全量融合，保留上游全部能力 + YYC³ 品牌注入 + 增强组件 Registry。

安装

npx @yyc3/cli --help

命令总览

Usage: yyc3 [options] [command]

YYC³ UI 智能编程库 — 言启象限 | 语枢未来

Commands:
  init|create    初始化项目并安装依赖
  apply          应用预设到现有项目
  add            添加组件到项目
  diff           对比组件差异
  docs           查看文档和 API 参考
  view           查看 Registry 中的组件
  search|list    搜索 Registry 中的组件
  migrate        运行迁移
  info           获取项目信息
  build          构建 Registry 组件
  mcp            MCP Server 和配置命令
  registry       管理 Registry

快速开始

创建项目

npx create-yyc3-app my-project -t dashboard --preset yyc3-dark
cd my-project
pnpm install
pnpm dev

初始化现有项目

npx @yyc3/cli init -p yyc3-dark

添加标准组件

npx @yyc3/cli add button
npx @yyc3/cli add card dialog sheet

添加 YYC³ 增强组件

npx @yyc3/cli add @yyc3/spotlight
npx @yyc3/cli add @yyc3/card-3d
npx @yyc3/cli add @yyc3/particle-canvas
npx @yyc3/cli add @yyc3/spline-scene

主题预设

预设	风格	字体	色系
yyc3-dark	Cyberpunk 霓虹	Geist	Zinc Dark
yyc3-light	明亮商务	Inter	Neutral
yyc3-brand	品牌标准	Geist	Neutral
nova	shadcn 默认	Geist	Neutral
vega	Inter 风格	Inter	Neutral

MCP 集成

AI 编辑器（Trae / Cursor / Claude Code / VS Code）可通过 MCP 直接搜索和添加组件：

npx @yyc3/cli mcp init --client cursor

支持的客户端：claude / cursor / vscode / codex / opencode

品牌标识

所有通过 yyc3 add 写入的 .tsx/.ts 文件自动注入品牌标识头：

// ⟨YYC³⟩ — YYC³ UI 智能编程库 | 言启象限 · 语枢未来
import * as React from "react"

YYC³ Registry 组件

组件	类型	依赖	说明
@yyc3/spotlight	交互	framer-motion	鼠标跟随聚光灯
@yyc3/card-3d	3D	framer-motion	透视旋转卡片
@yyc3/spline-scene	3D	@splinetool/react-spline	Spline 懒加载场景
@yyc3/particle-canvas	背景	零依赖	霓虹粒子网络

脚手架模板

npx create-yyc3-app <name> -t <template>

模板	说明	端口
dashboard	侧边栏 + 内容区 + 数据表格	3201
ai-platform	对话界面 + 模型管理 + 工具调用	3300
landing	品牌展示 + Spline 3D + 动效	3200
api	RESTful API + 认证 + 中间件	3400

技术架构

• 基于: shadcn/ui v4.5.0（MIT）全量源码融合
• 构建: tsup ESM，398KB，tree-shaken
• Registry: @shadcn + @yyc3 双 Registry 内置
• MCP: 5 工具（搜索/查看/列出/示例/Registry）
• 品牌: 自动标识头注入 + CLI 名称/描述/Server name 全面 YYC³ 化