create-dwy 0.18.4 → 0.19.1

package/templates/ai-tools/skills/Python/dwy-eapi/v0/index.md

@@ -0,0 +1,103 @@
+# dwyeapi 0.x
+
+精确签名以安装版本的源码为准（见上级 SKILL.md：先 clone tag，拿不到再读 venv）。本页是 0.x 导航与陷阱。
+
+跨大版本不变的分层 / 时区 / 信封 / 防腐层在 `shared/`。
+
+## 模块清单（当前 0.9 线）
+
+| 模块 | 用途 | 下限 |
+|------|------|------|
+| `config` | BaseSettings + `is_dev` / `is_prod` / `get_environment` | |
+| `exceptions` | AppError + FastAPI handler | |
+| `database` | 异步 engine/session + Base + TimestampMixin | |
+| `dependencies` | `get_db` 工厂 | |
+| `security` | JWT + bcrypt | |
+| `cache` | 异步 Redis | |
+| `response` | `ApiResponse[T]` + `PageData[T]` | ≥0.6.0 |
+| `pagination` | PaginationParams + paginate | |
+| `dt` | 中国时区时间工具 | ≥0.7 左右；`timedelta`/`after` ≥0.9.4 |
+| `logger` | loguru | |
+| `masking` | PII 脱敏 | |
+| `email` | Gmail 规范化 | ≥0.9.6 |
+| `health` | 只探活健康检查 | ≥0.7.0 |
+| `tasks` | ARQ 异步任务，需 `[tasks]` | ≥0.7 后 |
+| `providers.email` | 邮件验证码，内置 resend | 工厂注册表 ≥0.9.0 |
+
+`<0.9.0` 可能没有 dt / tasks / providers。先 `ls` 安装目录或 clone 该 tag 再调用。
+
+## 接入骨架
+
+```python
+from contextlib import asynccontextmanager
+from fastapi import FastAPI
+from dwyeapi import cache, logger, is_dev
+from dwyeapi.config import BaseSettings
+from dwyeapi.database import create_async_engine_factory, create_session_factory
+from dwyeapi.dependencies import create_get_db
+from dwyeapi.exceptions import register_exception_handlers
+from dwyeapi.health import create_health_router
+
+class Settings(BaseSettings):
+    app_name: str = "My API"
+    service_name: str = "my-api"
+
+settings = Settings()
+engine = create_async_engine_factory(settings.database_url, echo=is_dev())
+session_factory = create_session_factory(engine)
+get_db = create_get_db(session_factory)
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    logger.configure(level="INFO", log_dir="./logs", filename="app")
+    cache.configure(settings.redis_url)
+    yield
+    await cache.close_redis()
+    logger.close()
+
+app = FastAPI(
+    lifespan=lifespan,
+    docs_url="/docs" if is_dev() else None,
+    redoc_url="/redoc" if is_dev() else None,
+    openapi_url="/openapi.json" if is_dev() else None,
+)
+register_exception_handlers(app)
+app.include_router(create_health_router(service_name=settings.service_name, version="1.0.0"))
+```
+
+## 0.x 陷阱
+
+### 配置
+
+- **没有 `debug` 字段**，调试开关用 `is_dev()`
+- `environment` 默认 `"prod"`。非 dev 必须关掉 docs/redoc/openapi
+- `BaseSettings` 必填：`database_url` / `redis_url` / `secret_key`（子类不能给默认值）
+
+### Redis
+
+- `cache.configure(redis_url)` 启动时一次；`get_redis()` 懒连接
+- `close_redis()` 可重复调用
+- 未 configure 直接 `get_redis()` → `RuntimeError`
+
+### tasks
+
+- `pip install dwyeapi[tasks]`
+- 签名 `async def task(ctx: TaskContext, params: dict)`
+- 取消是协作式：必须 `await ctx.is_cancelled()`
+- 细节：`references/tasks-integration-guide.md`
+
+### 日志
+
+- `logger.configure()` 启动一次；`logger.close()` 在 lifespan 结束
+- `intercept_stdlib=True`（默认）接管 uvicorn / SQLAlchemy
+- 多进程必须 `enqueue=True`（默认）
+
+### 健康检查
+
+- `create_health_router()` **只**探活，**不**碰 PostgreSQL / Redis
+- readiness 业务自建并限制内网
+
+### 邮件 / Gmail
+
+- Provider：`v0/providers-email.md`
+- 规范化：`v0/email-canonical.md`（≥0.9.6）

package/templates/ai-tools/skills/Python/dwy-eapi/v0/providers-email.md

@@ -0,0 +1,39 @@
+# 邮件 Provider（0.x）
+
+内置与自定义走同一注册表。`make_email_provider` 只按 `EMAIL__PROVIDER` 查名。
+
+当前内置仅 `resend`，extra：`dwyeapi[email-resend]`。`dwyeapi[email]` = 全部内置 extra（现在就这一个）。
+
+```python
+from dwyeapi.providers.email import (
+    EmailProviderBase,
+    EmailSettings,
+    make_email_provider,
+    register_email_provider,
+)
+
+provider = make_email_provider(settings.email)
+await provider.send_code("user@example.com")
+```
+
+自定义（**不用改 eapi**）：
+
+```python
+class TencentSesProvider(EmailProviderBase):
+    async def _send(self, target: str, code: str) -> bool:
+        html = self._render_code_html(code)
+        text = self._render_code_text(code)
+        return True
+
+register_email_provider("tencent_ses", lambda s: TencentSesProvider(code_ttl=s.code_ttl))
+# .env: EMAIL__PROVIDER=tencent_ses
+```
+
+- 验证码 Redis + 品牌化模板由基类复用，子类只实现 `_send`
+- 内置名 `resend` 不可覆盖
+- 自定义同名二次注册会覆盖并 warning
+- 必须在 `make_email_provider` **之前** register
+- `send_code` / `verify_code` 的 Redis key 自 **0.9.6** 走 `canonicalize_email`；发信信封仍用用户输入地址
+- 缺 extra 构造内置 provider → `ImportError`，提示 `pip install dwyeapi[email-resend]`
+
+0.9.0 删除了内置 mock / 阿里云占位 / 整个 sms 模块，见 `breaking.md`。

package/templates/ai-tools/skills/Python/dwy-eapi/versions.yml

@@ -0,0 +1,13 @@
+# dwyeapi 安装版本 → 文档线。匹配从上到下第一条。
+# 大版本破坏才新开 vN/；0.x 内部 breaking 写 v0/breaking.md，细节 clone 对应 tag。
+repo: https://github.com/danweiyuancircle/dwy-ai-experience.git
+tag_prefix: "dwyeapi@"
+sparse:
+  - backend/src/dwyeapi
+lines:
+  - match: ">=2.0.0"
+    dir: v2
+  - match: ">=1.0.0"
+    dir: v1
+  - match: ">=0.0.0"
+    dir: v0

package/templates/ai-tools/skills/Vue/dwy-eui/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: dwy-eui
+description: "Use when building Vue 3 UI with @dwydev/eui: pick components, forms, tables, overlays, admin layout, theme, i18n, EConfigProvider. The single navigation skill for @dwydev/eui."
+---
+
+# @dwydev/eui
+
+Vue 3 组件库（Reka-ui + shadcn 视觉 + Element Plus 式 API + Tailwind 4）。本文件只做**路由**：探测安装版本 → 选文档线 → 不够再读源码（先 clone tag，拿不到再读 `node_modules`）。
+
+对外只有这一个 skill。`v1/` `v2/` 不是独立 skill，禁止当多个入口用。
+
+## 每次写 @dwydev/eui 代码前（强制）
+
+1. **探测安装版本**（按顺序，命中即停）
+   ```bash
+   node -p "require('@dwydev/eui/package.json').version"
+   ```
+   失败则读 `pnpm-workspace.yaml` catalog `'@dwydev/eui'`，再读 `package.json` 的 `dependencies` / `peerDependencies`。
+   仍失败：按 `v2` 给脚手架，并声明「未探测到安装版本」。
+
+2. **选线**：读同目录 `versions.yml`。`2.y.z` → `v2/`，`1.y.z` → `v1/`。目录不存在（例如装了 3.x 但还没有 `v3/`）→ 不要用 `v2` 冒充；按下面「读源码」拿该版本代码，并说明文档线未建。
+
+3. **读文档**：先 `shared/`（跨大版本不变），再该线 `vN/`。能力标了版本下限（如 `component-manifest.json` ≥2.1.0、`useEuiMobile` ≥2.4）时，安装版本低于下限 → 当不存在。
+
+4. **文档不够 / 和记忆冲突 / 下限对不上** → 读代码，顺序如下（命中即停）：
+   1. clone 安装版本对应 tag（见下）
+   2. tag 不存在 / clone 失败 → 读**当前项目** `node_modules/@dwydev/eui`
+   3. `node_modules` 也没有 → **停下来问人**，禁止猜 props，禁止拿旁边 dwy-shared master 冒充
+
+## 读源码
+
+### 1. clone tag（优先）
+
+```bash
+VER=2.4.0                          # 换成第 1 步探测到的版本
+TAG="@dwydev/eui@${VER}"
+DEST=".dwy/eui-src/${VER}"         # 项目内缓存，已 gitignore
+
+if [ ! -d "$DEST/frontend/eui/src" ]; then
+  git clone --depth 1 --branch "$TAG" \
+    --filter=blob:none --sparse \
+    https://github.com/danweiyuancircle/dwy-ai-experience.git \
+    "$DEST"
+  git -C "$DEST" sparse-checkout set frontend/eui/src frontend/eui/package.json
+fi
+# 只读 $DEST/frontend/eui/src/ 的组件 types.ts / .vue
+```
+
+- `--branch` 必须是 `@dwydev/eui@x.y.z`（含 `-beta.N`），禁止 clone 默认 branch。
+- 必须 sparse，只要 `frontend/eui/src`。
+
+### 2. node_modules（clone 拿不到时）
+
+```bash
+# 版本与清单
+node -p "require('@dwydev/eui/package.json').version"
+ls node_modules/@dwydev/eui/dist/component-manifest.json
+# props/emits：dist/components/{kebab}/types.d.ts
+# slots：.d.ts 常被擦成 any，clone 源码搜 <slot
+```
+
+`node_modules` 是消费方正在跑的代码，当作安装版本真相。
+
+文档与源码冲突：信源码。clone 与 node_modules 都读到且不一致：以 **node_modules** 为准，回复里写明。
+
+## 文档地图
+
+| 路径 | 何时读 |
+|------|--------|
+| `shared/form.md` | 禁原生 form、ESelect 空 value、zod rules |
+| `shared/overlay.md` | `v-model:open`、Dialog padding、Sheet zIndex |
+| `shared/reka.md` | 封装 reka 必须 v-model |
+| `shared/config-theme.md` | EConfigProvider、useTheme、cn() |
+| `v2/index.md` | 2.x 组件导航、composables、陷阱 |
+| `v2/lookup.md` | manifest / types.d.ts 怎么查 |
+| `v2/breaking.md` | 2.x 内部 breaking（含 2.4.0 删组件） |
+| `v1/index.md` | 1.x 导航；无 manifest 时怎么查 |
+| `references/eui-integration-guide.md` | 新项目接入 |
+| `references/eui-design-guide.md` | 中后台设计 |
+| `references/eui-landing-design-guide.md` | 落地页设计 |
+
+## 禁止
+
+| 借口 | 实际 |
+|------|------|
+| 读旁边 dwy-shared master | 消费方版本可能不同。先 clone 安装版本的 tag，不行再读本项目 node_modules |
+| 文档是 2.1，装的 2.4.0，差不多 | 有下限的能力必须对照版本；已删组件当不存在 |
+| tag 没有就猜 / 直接停 | clone 失败后读 node_modules；也没有才停 |
+| 再开一个 `dwy-eui-v2` skill | 对外只有 `dwy-eui` |

package/templates/ai-tools/skills/{/345/237/272/347/241/200/345/272/223 → Vue}/dwy-eui/references/eui-design-guide.md

@@ -213,7 +213,14 @@ neutral（默认）| blue | green | rose | orange | violet | slate
 | lg | 1024px | 小桌面 |
 | xl | 1280px | 标准桌面 |
 
-中后台页面最小支持 `md`（768px），不强求手机适配。
+中后台**壳**必须在 375px 可用：`EAdminLayout` 默认窄屏抽屉，不要再假设最小 `md`。
+
+| 场景 | 要求 |
+|------|------|
+| 布局壳 | `EAdminLayout` 375px 可开抽屉；顶栏不裁切 |
+| 列表 | 表格允许横滑；`EPagination` 默认 `mode="auto"` |
+| 表单 | 标签置顶 / `EField orientation="responsive"` |
+| 提示 | 禁止 hover-only 作为唯一入口（`ETooltip trigger="auto"`） |
 
 ## 八、ESelect 特殊约束
 

package/templates/ai-tools/skills/{/345/237/272/347/241/200/345/272/223 → Vue}/dwy-eui/references/eui-integration-guide.md

@@ -210,37 +210,6 @@ const { isDark, toggleDark, colorTheme, setColorTheme } = useTheme()
 
 ## 7. Composables
 
-### useToast
-
-轻量 toast 通知。需要在根组件挂载 `<EToast />` 容器：
-
-```vue
-<!-- App.vue -->
-<template>
-  <router-view />
-  <EToast rich-colors />
-</template>
-```
-
-使用：
-
-```ts
-import { useToast } from '@dwydev/eui'
-
-const toast = useToast()
-
-toast.success('操作成功')
-toast.error('操作失败')
-toast.warning('警告信息')
-toast.info('提示信息')
-
-// 带描述
-toast.success('保存成功', { description: '数据已持久化' })
-
-// 自定义时长（毫秒）
-toast.info('处理中...', { duration: 5000 })
-```
-
 ### useMessage
 
 ```ts

package/templates/ai-tools/skills/Vue/dwy-eui/shared/config-theme.md

@@ -0,0 +1,8 @@
+# 配置与主题
+
+- **必须**在 App 根包 `EConfigProvider`（locale / 默认尺寸 / zIndex）。缺了日期英文、z-index 乱、文案回退。
+- `locale.name` 用 BCP 47（`zh-CN` / `en-US`），默认 `zh-CN`。
+- 类名合并走 `cn()`（clsx + tailwind-merge）。
+- 主题走 `useTheme()` 的 `setColorTheme` / `toggleDark`，**不要**手改 `<html class="dark">`。
+- 样式入口：`import '@dwydev/eui/theme'`。
+- 轻提示用 `useMessage()`，不要当 Toast 再包一层。

package/templates/ai-tools/skills/Vue/dwy-eui/shared/form.md

@@ -0,0 +1,6 @@
+# 表单
+
+- **禁止原生 `<form>`**，一律 `<EForm>`。EForm 带 vee-validate、provide/inject、label 布局、`reset` / `validate`。
+- `ESelect` 的 `option.value` **不能是 `''`**，reka-ui 不支持。筛选项用哨兵（如 `'all'`），请求时再转 `undefined`。
+- 校验优先 zod schema 交给 `EForm` 的 `rules`。
+- `useFormField` 只在 `EFormItem` 内有值；表单外返回 `null`，不要当 vee-validate `<FormField>` 用。

package/templates/ai-tools/skills/Vue/dwy-eui/shared/overlay.md

@@ -0,0 +1,6 @@
+# 弹层
+
+- 显隐统一 `v-model:open`，不要 `:visible` / `@update:visible`。
+- `EDialog` body 有 `overflow-y-auto`，首尾表单控件的 focus-ring 会被裁。内容区加 `p-1` / `py-1`。
+- `ESheet` 与 `EDrawer` 场景不同：Sheet 侧向覆盖（手机导航），Drawer 底部抓手。不要合成一个组件。
+- `EAlertDialog` / `EConfirmDialog` / `useMessageBox` 场景不同，不要互相替换当「唯一确认框」。

package/templates/ai-tools/skills/Vue/dwy-eui/shared/reka.md

@@ -0,0 +1,5 @@
+# reka-ui 绑定
+
+封装 reka-ui 原语时统一 `v-model`（`modelValue` / `update:modelValue`），**不是** `:checked` / `@update:checked`。
+
+自己写包一层时用 `v-model` 或 writable computed。

package/templates/ai-tools/skills/Vue/dwy-eui/v1/index.md

@@ -0,0 +1,8 @@
+# @dwydev/eui 1.x
+
+1.x 没有 `v2/` 那套删减。精确 API clone `@dwydev/eui@1.y.z` 或读该版本 `node_modules`。
+
+- **没有** `component-manifest.json`（2.1.0 才有）。`ls node_modules/@dwydev/eui/dist/components/` 定位目录。
+- 轻提示可能是 `useToast`，不是 `useMessage`。
+- 可能仍有 `EInputOTP`、`EVirtualTable`、`EDataPage`、`EAIChat` 等；不要按 2.4.0 清单当成已删除。
+- 升 2.4.0 前读 `v2/breaking.md`，全仓替换已删符号。

package/templates/ai-tools/skills/Vue/dwy-eui/v2/breaking.md

@@ -0,0 +1,14 @@
+# 2.x 内部 breaking
+
+2.x 的 minor / beta 也可以不兼容。整条线仍用 `v2/`，破坏点记在这里。细节 clone `@dwydev/eui@x.y.z`，不要另开 `v2.4/` 目录。
+
+完整段落以该 tag 的 `frontend/eui/CHANGELOG.md` 为准。
+
+| 版本 | 破坏点 |
+|------|--------|
+| 2.4.0 | 正式线。删除 `EAIChat`、`ETimetableGrid`、`EDataPage`、`EVirtualTable`、`EInputOTP`、`EChartContainer`、`useToast`。OTP 用 `EPinInput` + `otp`；虚拟表用 `ETable virtual`；轻提示用 `useMessage`。`ETable` 不用 `w-max`，列宽之和写入 `minWidth` |
+| 2.4.0-beta.8 | 上表删除在 beta 线落地；停在 beta.1–7 的项目按此行 |
+| 2.4.0-beta.9 | `ETable` 去掉 `w-max`，长单元格不再把末列撑出视口 |
+| 2.4.0-beta.4 | 曾把表改成 `w-max` 以支持窄屏横滑；被 beta.9 / 2.4.0 修正 |
+
+2.3.0 仍有上表删除前的组件。从 2.3 升 2.4 先全仓搜这些符号。仍停在 2.4.0-beta.N 的项目对照上表对应行，不要用 2.4.0 正式线冒充。

package/templates/ai-tools/skills/Vue/dwy-eui/v2/index.md

@@ -0,0 +1,55 @@
+# @dwydev/eui 2.x
+
+精确签名以安装版本为准（见上级 SKILL.md：先 clone tag，拿不到再读 node_modules）。本页是 2.x 导航与陷阱。
+
+跨大版本不变的表单 / 弹层 / reka / 主题在 `shared/`。查 props 走 `lookup.md`。
+
+## Composables
+
+| 名 | 用途 | 下限 |
+|----|------|------|
+| `useMessage` | 轻提示 success / error / warning / info | |
+| `useNotification` | 带标题通知 | |
+| `useMessageBox` | alert / confirm / prompt，返回 Promise | |
+| `useTheme` | 亮暗与色板 | |
+| `useConfigProvider` | size / zIndex / locale | |
+| `useFormField` | EFormItem 内 id / error；表单外 `null` | 2.4 起不依赖 vee-validate FormField |
+| `useSecureValue` | 密码不写进 HTML attribute | |
+| `useEuiMobile` | `max-width: 767` 是否手机布局 | ≥2.4 |
+
+2.4.0 **删除** `useToast`，改 `useMessage`。仍停在 2.3 的项目读 `breaking.md`。
+
+## 组件导航（只列名）
+
+用途一句话够导航；props 读 types.d.ts。
+
+**展示**：EButton、EButtonGroup、EBadge、EAlert、ECard、ELabel、ESeparator、ETypography、EKbd、ESpinner、EProgress、ESkeleton、EEmpty、EAvatar、EImage、EAspectRatio、EAffix、EWatermark
+
+**表单**：EForm / EFormItem、EField、EInput、EInputGroup、ETextarea、ENumberField、ESelect、ENativeSelect、ECombobox、EAutocomplete、ECheckbox、ERadio、ESwitch、ETagsInput、EDatePicker、ETimePicker、EColorPicker、ERate、ESlider、ECascader、ETreeSelect、EMention、EPinInput（OTP 用 `otp` + `mask`）、EUpload、ETransfer
+
+**数据**：ETable（`virtual` 走 TanStack Virtual）、EDescriptions、ETimeline、EStatistic、ETree、ECalendar、ERangeCalendar、EPagination、EBreadcrumb
+
+**弹层**：EDialog、EDrawer、ESheet、EAlertDialog、ETooltip、EPopover、EHoverCard、EToast（Toaster 挂载点）、EContextMenu、EFormDialog、EConfirmDialog
+
+**布局**：ETabs、EMenu、EDropdown、EAccordion、ECollapsible、EStepper、ECarousel、EScrollArea、EInfiniteScroll、EToggle / EToggleGroup、EItem、EResizable*、ECommand*、ENavigationMenu*、EMenubar*、EAdminLayout、EConfigProvider
+
+已删组件见 `breaking.md`，不要再 import。
+
+## 2.x 陷阱
+
+### 汉堡 / 抽屉
+
+- `ESheet` / `EAdminLayout` 的 Boolean `open` / `mobileOpen` **缺省必须是 `undefined`**，不能是 `false`。`false` 会让非受控开关永远打不开（≥2.4.0）。
+- 关闭态 overlay 必须卸掉（`unmountOnHide`），否则挡住汉堡。
+- 打开态 overlay 用 `EConfigProvider.zIndex`（默认 2000），压过应用顶栏 `z-50`（≥2.4.0）。
+- 手机抽屉打开时 `EAdminLayout` 把 header 槽设 `invisible`，避免用户名和关闭钮抢角（≥2.4.0）。
+
+### ETable
+
+- 列 `width` 用数字 px，不要百分比。表 `minWidth` = 列宽之和：宽于容器横滑，窄于容器铺满（≥2.4.0）。
+- 不要再上 `EVirtualTable`，用 `ETable` 的 `virtual`。
+- 排序对外仍 `@sort` + `TableColumn.sortable`。
+
+### 手机布局
+
+- 断点与 Tailwind `md` 对齐：`max-width: 767`。`useEuiMobile()` 与 `EAdminLayout` / `EPagination` 同一套。

package/templates/ai-tools/skills/Vue/dwy-eui/v2/lookup.md

@@ -0,0 +1,29 @@
+# 2.x 查 API
+
+精确 props/emits **不要**写进 skill。按安装版本读类型。
+
+## manifest（≥2.1.0）
+
+```
+node_modules/@dwydev/eui/dist/component-manifest.json
+```
+
+- 组件名 → `componentToDir["EButton"]` → 目录 `button`
+- `directories["button"].types` → `components/button/types.d.ts`
+- 拼接 `node_modules/@dwydev/eui/dist/` + 该路径
+
+`<2.1.0` 没有 manifest：直接 `ls dist/components/`。
+
+## types
+
+```
+node_modules/@dwydev/eui/dist/components/{kebab}/types.d.ts
+```
+
+`{kebab}`：去 `E` 前缀后 kebab-case（`EDatePicker` → `date-picker`）。不确定就 `ls`，不要猜。
+
+## slots
+
+`.d.ts` 里 slot 常是 `any`。需要具名/作用域插槽时 clone 该版本 tag，在 `frontend/eui/src/components/{kebab}/*.vue` 搜 `<slot`。
+
+npm 包 `files` 不含 `.vue`，`node_modules` 里没有模板。

package/templates/ai-tools/skills/Vue/dwy-eui/versions.yml

@@ -0,0 +1,12 @@
+# @dwydev/eui 安装版本 → 文档线。匹配从上到下第一条。
+# 大版本破坏才新开 vN/；2.x 内部 breaking 写 v2/breaking.md，细节 clone 对应 tag。
+repo: https://github.com/danweiyuancircle/dwy-ai-experience.git
+tag_prefix: "@dwydev/eui@"
+sparse:
+  - frontend/eui/src
+  - frontend/eui/package.json
+lines:
+  - match: ">=2.0.0"
+    dir: v2
+  - match: ">=1.0.0"
+    dir: v1

package/templates/ai-tools/skills//{345/205/203/345/267/245/345/205/267 → 351/200/232/347/224/250}/dwy-shared/SKILL.md

@@ -129,7 +129,7 @@ done
 
 读源文件的 description / 内容前 500 字，结合现有分类样例，推荐 1 个最匹配分类。
 
-如果新文件明显不属于任何现有分类（如全新技术栈），**主动建议新建分类**，提一个名字（中文优先，与现有风格一致：技术栈用英文 `Flutter`/`Vue`，业务域用中文 `运维发布`/`基础库`）。
+分类目录必须和同步 Tab 的包名对齐：技术栈用 `通用` / `Vue` / `Python` / `Docker` 等，场景用 `产品0到1` / `自媒体` / `发布发版` / `安全` / `内容创作` / `DolphinDB`。不要再建 `基础库` / `脚手架` / `元工具` 这种与包不对齐的目录。新文件明显不属于任何现有包时，**主动建议新建分类（同时要在 `sync-packs.js` 加包）**。
 
 ### 步骤 5：AskUserQuestion 确认分类