create-dwy 0.6.3 → 0.6.4

package/bin/index.js

@@ -27,7 +27,7 @@ program
 
 program
   .command('sync-claude-md')
-  .description('单独同步 CLAUDE.md 到当前目录的 .claude/')
+  .description('单独同步 CLAUDE.md 到全局 ~/.claude/')
   .action(syncProjectClaudeMd)
 
 program.parse()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-dwy",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "项目脚手架与 Claude Code 配置同步工具",
   "type": "module",
   "bin": {

package/src/sync.js

@@ -260,11 +260,11 @@ export async function syncClaude() {
 }
 
 /**
- * 单独同步 CLAUDE.md 到当前项目 .claude/
+ * 单独同步 CLAUDE.md 到全局 ~/.claude/
  */
 export async function syncProjectClaudeMd() {
   const sourceDir = await resolveSourceDir()
-  const targetDir = path.join(process.cwd(), '.claude')
+  const targetDir = path.join(os.homedir(), '.claude')
 
   if (!await fs.pathExists(sourceDir)) {
     console.error(chalk.red('Error: claude-global templates not found in repo'))

package/templates/claude-global/CLAUDE.md

@@ -6,11 +6,11 @@
 - **服务地址**：必须输出完整的 URL（如 `http://localhost:8000/api/users`），禁止省略协议、端口或路径
 - **数据库连接串**：必须输出完整连接字符串（如 `postgresql+asyncpg://user:pass@localhost:5432/mydb`），禁止只写主机名或库名
 
-## Agent 团队执行
+## 团队执行任务
 
-所有任务默认启用 agent team 模式执行：任务可拆分时优先并行派遣 Agent，具体派遣策略、并行度、worktree 隔离、review 闭环等由 Claude 自行判断，不在此处硬编码规则。
+任务执行优先使用 agent team 模式执行。
 
-## Behavioral Guidelines — 减少常见 LLM 编码错误的行为指南
+## 减少常见 LLM 编码错误的行为指南 (Behavioral Guidelines)
 
 与项目特定指令合并使用。
 

package/templates/claude-global/skills/dwy-ekit/SKILL.md

@@ -111,3 +111,244 @@ try {
 ```
 
 `extractValidationErrors` 剥离 `body. / query. / path.` 前缀，返回 `{ field: message }` 扁平对象，与 vee-validate 的 `form.setErrors` 直接兼容。
+
+### storage — localStorage
+
+```ts
+import { useStorage, storage } from '@dwydev/ekit'
+```
+
+| API | 签名 / 说明 |
+|-----|------------|
+| `useStorage(key, defaultValue, storage?, opts?)` | 再导出 @vueuse/core；跨标签页同步、SSR-safe、自动 JSON 序列化 |
+| `storage.get<T>(key, defaultValue?)` | 返回 `T | undefined`；JSON 解析失败按字符串返回 |
+| `storage.set(key, value)` | 自动 `JSON.stringify` |
+| `storage.remove(key)` | 删除 |
+| `storage.clear()` | 清空全部（慎用） |
+
+```ts
+const token = useStorage<string>('token', '')
+const config = useStorage('config', { theme: 'light' }, localStorage, { mergeDefaults: true })
+```
+
+### cookie — Cookie 读写
+
+```ts
+import { useCookie, cookie } from '@dwydev/ekit'
+import type { CookieOptions } from '@dwydev/ekit'
+```
+
+```ts
+interface CookieOptions {
+  expires?: number | Date   // 天数或 Date；不传 = 会话级
+  path?: string             // 默认 '/'
+  domain?: string
+  secure?: boolean
+  sameSite?: 'strict' | 'lax' | 'none'
+}
+
+cookie.get<User>('user')
+cookie.set('user', { id: 1 }, { expires: 7, secure: true })
+cookie.remove('user', { path: '/' })
+
+const lang = useCookie('lang', 'zh-CN')
+lang.value = 'en-US'       // 自动写入
+lang.value = undefined     // 自动删除
+```
+
+### date — 日期 / 时间 / 时区
+
+```ts
+import {
+  now, formatTimestamp, formatInTimezone,
+  formatDate, formatDateTime, formatTime, formatRelativeTime, formatBy,
+} from '@dwydev/ekit'
+```
+
+| 函数 | 签名 | 输出示例 |
+|------|------|---------|
+| `now()` | `(): number` | `1745318445000`（UTC 毫秒戳） |
+| `formatTimestamp(ts, fmt?)` | `(number, string?) => string` | `'2026-04-22 18:40:45'`（默认） |
+| `formatInTimezone(tz, ts?, fmt?)` | `(string, number?, string?) => string` | `formatInTimezone('America/New_York', ts)` |
+| `formatDate(input)` | `(string | number | Date) => string` | `'2026-04-22'` |
+| `formatDateTime(input)` | 同上 | `'2026-04-22 18:40:45'` |
+| `formatTime(input)` | 同上 | `'18:40'` |
+| `formatRelativeTime(input)` | 同上 | `'刚刚' / '5 分钟前' / '3 小时前' / '2 天前'`；> 30 天退化为 `YYYY-MM-DD` |
+| `formatBy(input, template)` | 同上 | `formatBy(ts, 'YYYY年MM月DD日')` -> `'2026年04月22日'` |
+
+### qs — 查询字符串
+
+```ts
+import { stringify, parse } from '@dwydev/ekit'
+import type { StringifyOptions, ParseOptions } from '@dwydev/ekit'
+```
+
+```ts
+stringify({ ids: [1, 2], name: 'a' })                          // 'ids=1&ids=2&name=a'
+stringify({ ids: [1, 2] }, { arrayFormat: 'brackets' })        // 'ids[]=1&ids[]=2'
+stringify({ a: 1 }, { addQueryPrefix: true })                  // '?a=1'
+
+parse('?a=1&b=2')                                              // { a: '1', b: '2' }（默认 ignoreQueryPrefix: true）
+parse('a.b=1', { allowDots: true })                            // { a: { b: '1' } }
+```
+
+### validators — 表单校验
+
+```ts
+import {
+  isPhone, isEmail, isIdCard, isUrl, isRequired, minLength, maxLength,
+  phoneSchema, emailSchema, idCardSchema, urlSchema,
+  requiredSchema, minLengthSchema, maxLengthSchema,
+} from '@dwydev/ekit'
+```
+
+**布尔函数**
+
+| 函数 | 规则 |
+|------|------|
+| `isPhone(value)` | 中国手机号 1[3-9] 开头 11 位 |
+| `isEmail(value)` | 基础邮箱格式 |
+| `isIdCard(value)` | 18 位身份证（末位允许 X/x） |
+| `isUrl(value)` | 合法 URL |
+| `isRequired(value)` | 非空（0 / false 视为有效） |
+| `minLength(value, n)` / `maxLength(value, n)` | 长度校验 |
+
+**zod schema（配合 vee-validate）**
+
+```ts
+import { useForm } from 'vee-validate'
+import { toTypedSchema } from '@vee-validate/zod'
+import { phoneSchema, emailSchema } from '@dwydev/ekit'
+
+const schema = toTypedSchema(z.object({ phone: phoneSchema, email: emailSchema }))
+const { defineField, errors } = useForm({ validationSchema: schema })
+```
+
+> `minLengthSchema(n)` / `maxLengthSchema(n)` 是工厂函数，调用后返回 schema。
+
+### masking — PII 脱敏
+
+```ts
+import {
+  maskPhone, maskEmail, maskIdCard, maskBankCard,
+  maskName, maskAddress, maskIp, maskLicensePlate, maskText,
+} from '@dwydev/ekit'
+```
+
+纯函数，无外部依赖。**输入不符合格式时原样返回，不抛异常**。
+
+| 函数 | 示例输出 |
+|------|---------|
+|  |  |
+|  |  |
+|  |  |
+|  |  |
+|  /  |  /  |
+|  |  |
+|  |  |
+|  |  |
+|  |  |
+
+### copy — 剪贴板
+
+```ts
+import { copyText, useClipboard } from '@dwydev/ekit'
+```
+
+```ts
+await copyText('hello')
+
+const { text, copy, copied, isSupported } = useClipboard({ source: '', copiedDuring: 1500 })
+copy('hello')
+// copied: ComputedRef<boolean>，1500ms 后自动复位
+// isSupported: ComputedRef<boolean>
+```
+
+### file — 文件下载 / Blob / 文件大小
+
+```ts
+import { downloadFile, saveBlob, formatFileSize } from '@dwydev/ekit'
+import type { DownloadOptions, FileRequester } from '@dwydev/ekit'
+```
+
+```ts
+await downloadFile('/api/export.xlsx')                      // GET，自动解析文件名
+await downloadFile('/api/export', {
+  filename: '报表.xlsx', method: 'POST', data: { dateRange },
+})
+
+// 自定义 requester（axios 实例天然满足 FileRequester）
+await downloadFile('/api/export', { requester: myHttpClient })
+
+saveBlob(blob, 'data.json')
+formatFileSize(1234567)        // '1.18 MB'
+formatFileSize(1234567, 0)     // '1 MB'
+```
+
+### hooks — Vue Composables
+
+```ts
+import {
+  useDebounce, useClickOutside, useEventListener, useThrottle,
+  useWindowSize, useMediaQuery, useIntersectionObserver, useResizeObserver,
+  useFormPersist, DEFAULT_SENSITIVE_FIELDS,
+} from '@dwydev/ekit'
+```
+
+| Composable | 说明 |
+|-----------|------|
+| `useDebounce(value, delay=300)` | 防抖 ref；返回 `Readonly<Ref<T>>` |
+| `useClickOutside(target, handler)` | 点击元素外部触发 |
+| `useEventListener(target, event, handler, options?)` | 自动绑/解绑 |
+| `useThrottle(fn, ms)` | 节流函数 |
+| `useWindowSize()` | `{ width, height }` |
+| `useMediaQuery(query)` | `useMediaQuery('(max-width: 768px)')` |
+| `useIntersectionObserver(target, cb)` | 监听元素出现/消失 |
+| `useResizeObserver(target, cb)` | 监听元素尺寸变化 |
+| `useFormPersist(key, initialValue, options?)` | 表单刷新自动回填；默认排除敏感字段 |
+
+**useFormPersist**
+
+```ts
+const { form, reset, clear } = useFormPersist('register-form', {
+  email: '', code: '', remark: '',
+})
+
+// 选项
+interface UseFormPersistOptions<T> {
+  exclude?: (keyof T)[]           // 追加敏感字段
+  storage?: 'session' | 'local'   // 默认 'session'
+  disableDefaultExclude?: boolean // 默认 false（开启内置排除）
+}
+
+// 提交成功后清空残留
+await api.register(form.value)
+reset()
+```
+
+内置 `DEFAULT_SENSITIVE_FIELDS` 包含 password / confirmPassword / oldPassword / newPassword / pwd / code / captcha / verifyCode / verificationCode / smsCode / emailCode / phoneCode / otp / token / accessToken / refreshToken / signSecret / secret / apiKey 共 19 项，不区分大小写。
+
+## 何时读取 references
+
+本 SKILL.md 正文已包含 10 个模块的核心 API、签名和典型用法，满足 90% 编码场景。`references/` 目录保存边缘细节，仅在需要时读取：
+
+| 文件 | 内容 |
+|------|------|
+| `references/request.md` | `HttpPlugin` 完整接口、`HttpError` 字段详情、refreshTokenPlugin 完整参数、`CommonBusinessCode` 枚举、非标准响应兜底行为 |
+| `references/data.md` | `StringifyOptions` / `ParseOptions` 完整字段、`CookieOptions` 完整字段、useStorage 全部选项 |
+| `references/form.md` | validators 底层正则规则、masking 边界处理说明 |
+| `references/ui.md` | `FileRequester` 完整契约、`DownloadOptions` 全部字段、旧版迁移陷阱 |
+
+## v0.6.0 迁移要点
+
+| 旧 | 新 |
+|----|----|
+| `createRequest(): AxiosInstance` | `createRequest(): HttpClient` |
+| `RequestPlugin` | `HttpPlugin` |
+| `import { dayjs } from '@dwydev/ekit'` | 用 `now / formatTimestamp / formatInTimezone / formatDateTime` 等函数 |
+| `CookieAttributes` | `CookieOptions` |
+| `IStringifyOptions / IParseOptions` | `StringifyOptions / ParseOptions` |
+| `DownloadOptions.requestInstance: AxiosInstance` | `DownloadOptions.requester: FileRequester` |
+| 自写 `useDebounce` 返回可写 `Ref` | VueUse `refDebounced` 返回 `Readonly<Ref>` |
+| 自写 `useClipboard` 返回 `{ text, copy, copied, isSupported }`（isSupported 是 boolean） | VueUse 版（isSupported 是 `ComputedRef<boolean>`） |
+| `refreshTokenPlugin` 自动重放 | 必须传 `retry: (cfg) => client.request(cfg)` |