create-dwy 0.3.3 → 0.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-dwy",
-  "version": "0.3.3",
+  "version": "0.4.1",
   "description": "Project scaffolding and Claude Code config sync CLI",
   "type": "module",
   "bin": {

package/src/sync.js

@@ -28,6 +28,14 @@ export async function syncClaude() {
     }
   }
 
+  // Sync CLAUDE.md
+  const claudeMdSrc = path.join(sourceDir, 'CLAUDE.md')
+  if (await fs.pathExists(claudeMdSrc)) {
+    await fs.copy(claudeMdSrc, path.join(targetDir, 'CLAUDE.md'))
+    syncedCount++
+    console.log(chalk.green('  ✓ CLAUDE.md'))
+  }
+
   const settingsSrc = path.join(sourceDir, 'settings.json')
   if (await fs.pathExists(settingsSrc)) {
     const settingsDest = path.join(targetDir, 'settings.json')

package/templates/claude-global/CLAUDE.md

@@ -0,0 +1 @@
+所有回答必须使用中文。

package/templates/claude-global/rules/backend-security.md

@@ -1,3 +1,10 @@
+---
+paths:
+  - "**/*.py"
+  - "**/alembic/**"
+  - "**/pyproject.toml"
+---
+
 # 后端安全编码规范
 
 FastAPI + PostgreSQL + Redis + MinIO + DolphinDB 项目的安全编码规则。AI 生成或修改代码时，必须严格按照这些规则执行。

package/templates/claude-global/rules/docs-sync.md

@@ -0,0 +1,23 @@
+# 文档同步规则
+
+代码变更时，必须同步更新所有关联文档。不允许只改代码不更新文档。
+
+## 核心原则
+
+**代码和文档是一个整体。** 如果一次变更修改了对外可见的 API（props、函数签名、导出类型、命令行参数等），那么描述该 API 的文档必须在同一个 commit 中更新。
+
+## 检查清单
+
+完成代码变更后，逐项确认：
+
+1. **Skills / 速查文档** — 是否有 SKILL.md 或类似的 AI 速查文档描述了被修改的 API？如果有，更新对应条目。
+2. **示例 / Demo 页面** — 新增的功能是否有对应的交互演示？如果没有，补充 demo。
+3. **导航 / 搜索索引** — 新增的页面或组件是否已注册到路由、侧边栏、搜索索引？
+4. **项目 CLAUDE.md** — 模块结构（新增/删除/重命名包或模块）、构建命令、测试命令是否变化？如果是，更新 CLAUDE.md。
+5. **版本号** — 变更是否对外可见？如果是，更新 package.json / pyproject.toml 版本号。
+
+## 提交规范
+
+- 文档更新应与代码变更在**同一个 commit** 中
+- 遗漏后发现，立即补一个 `docs: sync xxx` 的 commit
+- 纯文档更新用 `docs:` 前缀，代码+文档混合用 `feat:` / `fix:`

package/templates/claude-global/rules/prefer-open-source.md

@@ -0,0 +1,28 @@
+# 优先使用成熟开源方案
+
+开发新功能时，优先选用成熟的开源项目/库，而不是手写实现。只有在确认没有合适的开源方案时，才自行实现。
+
+## 决策流程
+
+```
+需要某项功能
+  → 1. 搜索是否有成熟的开源库（npm/PyPI/GitHub stars > 1k、近期有维护）
+    → 有：评估是否适配当前技术栈（Vue 3 / FastAPI / Node.js）
+      → 适配：直接使用，不重复造轮子
+      → 不适配：寻找替代方案
+    → 没有合适的：自行实现，但在代码注释中说明为什么没用现成方案
+```
+
+## 强制规则
+
+- **禁止**手写已有成熟方案的功能：日期处理(dayjs/date-fns)、HTTP 请求(axios)、表单校验(zod/vee-validate)、状态管理(pinia)、图表(echarts/chart.js)、富文本(tiptap/quill)、拖拽(vuedraggable/dnd-kit)、虚拟滚动(@tanstack/virtual)、Markdown 渲染(markdown-it)、模糊搜索(fuse.js)
+- **禁止**手写加密/哈希/JWT 算法，必须使用 bcrypt/jose/crypto 等标准库
+- 选用开源库时，优先选择：项目已在用的依赖 > 社区主流方案 > 小众但适合的方案
+
+## 例外情况
+
+以下情况允许自行实现：
+- 功能极其简单（< 20 行），引入一个库反而增加复杂度
+- 开源库有严重的安全漏洞或已停止维护
+- 开源库的依赖体积过大，与需求不成比例
+- 项目有特殊定制需求，开源库无法满足且改造成本高于自建

package/templates/claude-global/rules/python-code-style.md

@@ -3,6 +3,9 @@ name: python-code-style
 description: Python + FastAPI 代码规范
 type: claude-rule
 tags: [python, fastapi, code-style]
+paths:
+  - "**/*.py"
+  - "**/pyproject.toml"
 version: 1.0.0
 author: chances
 ---

package/templates/claude-global/rules/server-security.md

@@ -1,3 +1,12 @@
+---
+paths:
+  - "**/docker-compose*.yml"
+  - "**/Dockerfile*"
+  - "**/nginx*.conf"
+  - "**/deploy*.sh"
+  - "**/.env.example"
+---
+
 # 服务器安全部署规则
 
 所有项目部署到云服务器时必须遵循以下规则。如果任何操作违反这些规则，必须**立即提示用户并获得明确确认**后才能继续。

package/templates/claude-global/rules/vue-code-style.md

@@ -1,3 +1,12 @@
+---
+paths:
+  - "**/*.vue"
+  - "**/*.ts"
+  - "**/*.tsx"
+  - "**/vite.config.*"
+  - "**/tsconfig*.json"
+---
+
 # Vue 3 + TypeScript + Vite + Pinia 代码规范
 
 所有 Vue / TypeScript 前端项目必须遵循以下规范。AI 生成或修改代码时，必须严格按照这些规则执行。

package/templates/claude-global/skills/dwy-auto-sync/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: dwy-auto-sync
+description: "create-dwy 发版后自动更新本地 CLI 并同步 Claude Code 配置。触发条件：执行了 npm publish create-dwy、pnpm publish:cli、或用户要求同步 dwy 配置时。"
+---
+
+# DWY 发版后自动同步
+
+当 `create-dwy` 发布新版本后，必须执行以下步骤确保本地 Claude Code 配置与最新版本同步。
+
+## 触发时机
+
+以下任一情况发生时，执行同步流程：
+
+1. 执行了 `npm publish`（在 claude-cli 目录下）
+2. 执行了 `pnpm publish:cli`
+3. 用户要求"同步 dwy"或"更新配置"
+
+## 同步流程
+
+发版成功后，按顺序执行：
+
+```bash
+# 1. 更新全局 CLI 到最新版
+npm i -g create-dwy@latest
+
+# 2. 验证版本
+dwy --version
+
+# 3. 同步 Claude Code 配置（skills/rules/hooks/commands/settings）
+dwy sync claude
+
+# 4. 验证同步结果
+ls ~/.claude/skills/
+```
+
+## 同步了什么
+
+`dwy sync claude` 会将以下内容从 CLI 模板同步到 `~/.claude/`：
+
+| 目录 | 内容 | 同步方式 |
+|------|------|---------|
+| `~/.claude/skills/` | AI 速查文档 (dwy-frontend-eui, dwy-frontend-core, dwy-backend-base) | 覆盖同名，保留已有 |
+| `~/.claude/rules/` | 编码规范 (python-code-style, vue-code-style, 安全规则等) | 覆盖同名，保留已有 |
+| `~/.claude/hooks/` | 自动化脚本 (pre-git-commit 检查) | 覆盖同名，保留已有 |
+| `~/.claude/commands/` | 自定义命令 | 覆盖同名，保留已有 |
+| `~/.claude/settings.json` | Claude Code 设置 | 浅合并（新 key 加入，同名覆盖，已有独有 key 保留） |
+
+## 注意事项
+
+- npm 注册表有传播延迟（~1 分钟），如果 `npm i -g create-dwy@latest` 安装的不是刚发布的版本，等待后重试
+- `dwy sync claude` 从 Gitee 仓库拉取模板，确保代码已 push 到 Gitee 后再执行
+- 同步不会删除用户手动添加的 skills/rules，只覆盖同名文件

package/templates/claude-global/skills/dwy-frontend-eui/SKILL.md

@@ -75,30 +75,30 @@ frontend/eui/src/components/{component-name}/types.ts
 
 | 组件 | 用途 | 关键 Props |
 |------|------|-----------|
-| EInput | 输入框 | v-model, type, placeholder, size, clearable, showPassword, disabled, readonly, maxlength |
-| ETextarea | 多行输入 | v-model, placeholder, rows, autoResize, maxlength, disabled |
-| ENumberField | 数字输入 | v-model, min, max, step, size, disabled |
-| ESelect | 下拉选择 | v-model, options(Option[]), placeholder, clearable, size, disabled |
+| EInput | 输入框 | v-model, type, placeholder, size, clearable, showPassword, disabled, readonly, maxlength, showWordLimit |
+| ETextarea | 多行输入 | v-model, placeholder, rows, autoResize, maxlength, disabled, showWordLimit, minRows, maxRows |
+| ENumberField | 数字输入 | v-model, min, max, step, size, disabled, precision, controlsPosition, placeholder, readonly |
+| ESelect | 下拉选择 | v-model, options(Option[]), placeholder, clearable, size, disabled, filterable, multiple, collapseTags, remote, remoteMethod, loading |
 | ENativeSelect | 原生 select | v-model, options(SelectOption[]), placeholder, disabled |
 | ECombobox | 组合框 | v-model, options(Option[]), placeholder, emptyText, disabled |
 | EAutocomplete | 自动补全 | v-model, fetchSuggestions(async fn), debounce, placeholder |
-| ECheckbox | 复选框 | v-model, label, disabled, indeterminate |
-| ERadio | 单选组 | v-model, options(Option[]), direction(horizontal/vertical), disabled |
+| ECheckbox | 复选框 | v-model, label, disabled, indeterminate, options(Option[]), direction(horizontal/vertical), border |
+| ERadio | 单选组 | v-model, options(Option[]), direction(horizontal/vertical), disabled, optionType(default/button), border, size |
 | ESwitch | 开关 | v-model, label, size, disabled |
 | ETagsInput | 标签输入 | v-model(string[]), placeholder, max, size, disabled |
-| EDatePicker | 日期选择 | v-model, placeholder, format, clearable, disabled |
+| EDatePicker | 日期选择 | v-model, type(date/daterange/month/year), placeholder, startPlaceholder, endPlaceholder, rangeSeparator, format, clearable, disabled, disabledDate, shortcuts(DatePickerShortcut[]) |
 | ETimePicker | 时间选择 | v-model, placeholder, format, hourStep, minuteStep, disabled |
 | EColorPicker | 颜色选择 | v-model, presets(string[]), showAlpha, disabled |
 | ERate | 评分 | v-model, max, allowHalf, showText, disabled |
 | ESlider | 滑块 | v-model(number[]), min, max, step, orientation, disabled |
-| ECascader | 级联选择 | v-model, options(CascaderOption[]), placeholder, filterable, clearable |
+| ECascader | 级联选择 | v-model, options(CascaderOption[]), placeholder, filterable, clearable, lazy, loadFn, multiple, collapseTags |
 | ETreeSelect | 树选择 | v-model, data(TreeNode[]), placeholder, multiple, checkable, disabled |
 | EMention | @提及输入 | v-model, options(MentionOption[]), prefix, loading, placeholder |
 | EInputOTP | OTP 验证码 | v-model, length, disabled, placeholder |
 | EPinInput | PIN 输入 | v-model(string[]), length, mask, otp, type(text/number) |
-| EUpload | 文件上传 | v-model(UploadFile[]), action, accept, multiple, limit, listType(text/picture/picture-card), drag |
+| EUpload | 文件上传 | v-model(UploadFile[]), action, accept, multiple, limit, listType(text/picture/picture-card), drag, beforeUpload, autoUpload, headers, withCredentials |
 | ETransfer | 穿梭框 | v-model, data(TransferItem[]), filterable, titles([string, string]) |
-| EForm | 表单容器 | model, rules(Zod/FormRule[]), labelWidth, labelPosition(left/right/top), size, disabled |
+| EForm | 表单容器 | model, rules(Zod/FormRule[]), labelWidth, labelPosition(left/right/top), size, disabled, inline |
 | EFormItem | 表单项 | （配合 EForm 使用） |
 | EField | 字段布局 | orientation(vertical/horizontal/responsive), invalid |
 | EInputGroup | 输入组 | 子组件 EInputGroupAddon(align) |
@@ -107,22 +107,22 @@ frontend/eui/src/components/{component-name}/types.ts
 
 | 组件 | 用途 | 关键 Props |
 |------|------|-----------|
-| ETable | 表格 | data, columns(TableColumn[]), loading, rowKey, striped, bordered, selectable, selectedKeys |
+| ETable | 表格 | data, columns(TableColumn[]), loading, rowKey, striped, bordered, selectable, selectedKeys, expandable, expandedRowKeys, rowClassName, showSummary, summaryMethod, virtual, virtualRowHeight, resizable |
 | EVirtualTable | 虚拟滚动表格 | columns(VirtualTableColumn[]), data, height, estimateRowHeight, rowKey, loading |
 | EDescriptions | 描述列表 | items(DescriptionItem[]), columns, bordered, title |
 | ETimeline | 时间线 | items(TimelineItem[]), reverse |
 | EStatistic | 统计数值 | title, value, prefix, suffix, precision |
-| ETree | 树形控件 | data(TreeNode[]), v-model, checkable, expandedKeys, defaultExpandAll |
+| ETree | 树形控件 | data(TreeNode[]), v-model, checkable, expandedKeys, defaultExpandAll, lazy, loadFn, draggable, filterMethod, filterQuery, checkStrictly |
 | ECalendar | 日历 | v-model, multiple, disabled, locale, minValue, maxValue |
 | ERangeCalendar | 日期范围日历 | v-model({start, end}), disabled, locale, minValue, maxValue |
-| EPagination | 分页 | v-model, total, pageSize, showSizeChanger, pageSizes, showTotal |
+| EPagination | 分页 | v-model, total, pageSize, showSizeChanger, pageSizes, showTotal, jumper, layout, disabled |
 | EBreadcrumb | 面包屑 | items(BreadcrumbItem[]), separator |
 
 ### 弹层与反馈
 
 | 组件 | 用途 | 关键 Props |
 |------|------|-----------|
-| EDialog | 对话框 | v-model:open, title, description, showClose, maxWidth |
+| EDialog | 对话框 | v-model:open, title, description, showClose, maxWidth, draggable, closeOnClickModal, closeOnPressEscape, fullscreen, destroyOnClose |
 | EDrawer | 抽屉 | v-model:open, title, description, direction(top/right/bottom/left), showClose |
 | ESheet | 侧边面板 | v-model:open, title, description, side(top/right/bottom/left), showClose |
 | EAlertDialog | 确认对话框 | v-model:open, title, description, confirmText, cancelText |
@@ -136,9 +136,9 @@ frontend/eui/src/components/{component-name}/types.ts
 
 | 组件 | 用途 | 关键 Props |
 |------|------|-----------|
-| ETabs | 标签页 | v-model, items(TabItem[]) |
-| EMenu | 侧边菜单 | v-model, items(MenuItem[]), collapsed |
-| EDropdown | 下拉菜单 | items(DropdownMenuItem[]), side, align, sideOffset |
+| ETabs | 标签页 | v-model, items(TabItem[]), closable, addable, tabPosition(top/bottom/left/right) |
+| EMenu | 侧边菜单 | v-model, items(MenuItem[]), collapsed, router, uniqueOpened, defaultOpeneds |
+| EDropdown | 下拉菜单 | items(DropdownMenuItem[]), side, align, sideOffset, trigger(click/hover), splitButton, buttonText, buttonVariant |
 | EAccordion | 手风琴 | v-model, items(AccordionItemOption[]), multiple, collapsible |
 | ECollapsible | 折叠面板 | v-model(boolean), disabled |
 | EStepper | 步骤条 | v-model, items(StepperItem[]), direction(horizontal/vertical) |
@@ -191,7 +191,7 @@ frontend/eui/src/components/{component-name}/types.ts
 | Composable | 用途 | 返回值 |
 |------------|------|--------|
 | useMessage() | 全局消息提示 | { success, warning, error, info } — 每个接收 string 或 MessageOptions |
-| useNotification() | 通知 | { success, warning, error, info } — 接收 NotificationOptions(title, message, position, duration) |
+| useNotification() | 通知 | { success, warning, error, info } — 接收 NotificationOptions(title, message, position, duration, onClick, closable) |
 | useMessageBox() | 对话确认 | { alert, confirm, prompt } — 返回 Promise<'confirm' \| 'cancel'> |
 | useTheme() | 主题管理 | { isDark, theme, setTheme, toggleDark, colorTheme, setColorTheme } |
 | useConfigProvider() | 读取全局配置 | { size, zIndex, locale } |
@@ -229,6 +229,8 @@ interface MenuItem {
   key: string
   label: string
   icon?: string
+  /** Route path for router mode (falls back to key if not provided) */
+  path?: string
   children?: MenuItem[]
   disabled?: boolean
 }
@@ -243,4 +245,13 @@ interface TableColumn<T = any> {
   align?: 'left' | 'center' | 'right'
   render?: (row: T, index: number) => any
 }
+
+type DatePickerType = 'date' | 'daterange' | 'month' | 'year'
+
+interface DatePickerShortcut {
+  text: string
+  value: Date | Date[] | (() => Date | Date[])
+}
+
+type TabPosition = 'top' | 'bottom' | 'left' | 'right'
 ```