create-dwy 0.15.0 → 0.16.1

package/templates/ai-tools/rules/Vue/dwy-vue-base-lib.md

@@ -0,0 +1,127 @@
+---
+description: 团队内部基础库强制复用规范（eui UI 组件 + ekit 工具：禁重复造轮子、HTTP/存储/日期/校验/脱敏走 ekit、UI 走 eui）
+paths:
+  - "**/*.vue"
+  - "**/*.ts"
+---
+
+# Vue 团队基础库强制复用规范
+
+`dwy-vue-core` rule 的团队内补充。通用 Vue 工程规范见 `dwy-vue-core`；本文件只管「凡 eui / ekit 已提供的能力，禁止自行实现，也禁止引入其他库重复造轮子」。
+
+`@dwydev/eui` 与 `@dwydev/ekit` 是团队内部 npm 基础库，分别覆盖 UI 组件层与通用工具层。
+
+---
+
+## 一、必须复用的能力域
+
+| 能力域 | 归属 |
+|--------|------|
+| 通用 UI 组件（Button / Input / Select / Dialog / Drawer / Form / Table 等） | eui |
+| 主题 / 设计 tokens / 暗色模式 | eui |
+| 表单校验（vee-validate + zod 集成） | eui + ekit |
+| 中后台 / 落地页设计规范 | eui（references） |
+| HTTP 客户端（拦截器 / token / 刷新 / 解包） | ekit |
+| 本地存储 / Cookie | ekit（storage / cookie） |
+| 日期 / 时间格式化 | ekit（date） |
+| 数据校验 schema | ekit（validators） |
+| PII 数据脱敏 | ekit（masking） |
+| 剪贴板 / 文件下载 / qs 序列化 | ekit |
+| VueUse 再导出（debounce / throttle / clickOutside / mediaQuery 等） | ekit（hooks） |
+
+### 查阅方式（关键）
+
+**在编写任何 Vue 代码前，以及调用任何 eui / ekit 提供的 API 之前，必须先用 `Skill` 工具加载对应 skill 查阅当前最新接口。** 本文件只规定约束与边界，**不固化**组件 props、函数签名 —— 这些会随版本演进，固化在 rule 里会与实际包不同步。
+
+```
+Skill 工具调用：
+  - skill="dwy-eui"   组件库 API 与设计规范
+  - skill="dwy-ekit"  工具库 API 与契约
+```
+
+---
+
+## 二、强制规则
+
+- **禁止**业务代码出现 `axios` / `fetch` / `new XMLHttpRequest`，HTTP 走 ekit `createRequest`
+- **禁止**直接 `localStorage.getItem` / `setItem` / `removeItem`，走 ekit storage / `useStorage`
+- **禁止**直接 `document.cookie` 或单独引入 `js-cookie`，走 ekit cookie
+- **禁止**业务代码 `new Date()` / `toLocaleString` / 直接 `import dayjs`，走 ekit date
+- **禁止**手写 `navigator.clipboard` / `document.addEventListener('click', ...)` 监听，走 ekit copy / hooks
+- **禁止**自定义已有 UI 组件（Button / Input / Select / Dialog / Form / Table 等），走 eui
+- **禁止**自定义已有日期 / 时间 / 验证 / 脱敏 / 下载 工具函数，走 ekit
+- 涉及任一能力域，**先查 skill 拿到当前 API，再写代码**
+
+---
+
+## 三、API 请求
+
+### 强制规则
+
+- HTTP 客户端**必须**用 ekit `createRequest` 创建，全局唯一实例放 `core/http.ts`（具体参数与插件查 `dwy-ekit` skill）
+- **禁止**业务代码 `axios.create()` / `fetch()` / `new XMLHttpRequest()`
+- 响应解包契约与 dwyeapi 对齐（`{ code, message, data }`），具体类型与守卫查 `dwy-ekit` skill
+- 401 / 422 / 业务错误的统一处理由 ekit request 插件完成（具体 API 查 `dwy-ekit` skill）
+- 业务侧 catch 用 ekit 提供的 `isApiBusinessError` 类型守卫做分支（`NOT_FOUND` / `VALIDATION_ERROR` / `PERMISSION_DENIED` 等）
+
+> API 函数的目录归属、独立导出、类型标注等结构约定见 `dwy-vue-core` 第六节。
+
+### 示例
+
+```typescript
+// core/http.ts —— 全局唯一 HTTP 客户端（具体 plugins 查 dwy-ekit skill）
+import { createRequest } from '@dwydev/ekit'
+
+export const request = createRequest({
+  baseURL: import.meta.env.VITE_API_BASE_URL,
+  plugins: [
+    /* tokenPlugin / refreshTokenPlugin / unwrapPlugin —— 具体用法查 dwy-ekit skill */
+  ],
+})
+
+// modules/users/api.ts —— 该业务的 API
+import { request } from '@/core/http'
+import type { UserInfo, UserCreate } from './types'
+
+export function getUsers(params: { page: number; page_size: number }) {
+  return request.get<{ items: UserInfo[]; total: number }>('/users', { params })
+}
+
+export function createUser(data: UserCreate) {
+  return request.post<UserInfo>('/users', data)
+}
+```
+
+---
+
+## 四、通用 hooks 走 ekit
+
+通用 hooks（debounce / throttle / clickOutside / mediaQuery 等）**禁止**自己造，走 ekit hooks（具体 API 查 `dwy-ekit` skill）。
+
+---
+
+## 五、样式覆盖 eui
+
+覆盖 eui 内部样式用 scoped CSS + `:deep(...)`（其余样式规范见 `dwy-vue-core` 第八节，优先 Tailwind）。
+
+---
+
+## 六、错误拦截走 ekit
+
+401 / 422 / 业务错误的拦截走 ekit request 插件（查 `dwy-ekit` skill），**禁止**每个 API 都包 try-catch。业务侧统一在页面级或 store 级处理，用 `isApiBusinessError` 守卫分支。
+
+---
+
+## 七、违规检测清单（基础库相关）
+
+AI 编写或审查 Vue 代码时，涉及 eui / ekit 必须检查以下违规模式（通用框架违规清单见 `dwy-vue-core` 第十四节）：
+
+| 检查项 | 违规模式 | 严重程度 |
+|--------|---------|---------|
+| 未查 skill | 使用 eui / ekit API 前未先查 `dwy-eui` / `dwy-ekit` skill | 高 |
+| ekit 重复造轮子 | 自造 HTTP / storage / cookie / date / 校验 / 脱敏 等 ekit 已提供能力 | 高 |
+| eui 重复造轮子 | 自造已有 UI 组件（Button / Input / Dialog 等） | 高 |
+| 组件直调 axios | 组件内 `axios.get` / `fetch` / `new XMLHttpRequest` | **致命 → STOP** |
+| 直接 localStorage | `localStorage.getItem` / `setItem` 出现在业务代码 | 高 |
+| 直接 new Date | `new Date()` / `toLocaleString` / 直接 `import dayjs` | 高 |
+| 旧 axios 例子 | 业务里出现 `axios.create()` / `interceptors.request.use(...)` | **致命 → STOP** |

package/templates/ai-tools/rules/Vue/dwy-vue-core.md

@@ -1,5 +1,5 @@
 ---
-description: Vue 3 + TS + Vite + Tailwind 应用层规范（强制使用 eui/ekit、业务聚合结构、组件 / TS / 路由 / API / 模板 / 样式 / 错误处理 / 注释）
+description: Vue 3 + TS + Vite + Tailwind 应用层通用规范（业务聚合结构、组件 / TS / 路由 / API / 模板 / 样式 / 错误处理 / 注释）
 paths:
   - "**/*.vue"
   - "**/*.ts"
@@ -8,50 +8,7 @@ paths:
 
 # Vue 3 应用层开发规范
 
-适用于基于 Vue 3 + TypeScript + Vite + Tailwind CSS 的前端项目。基础库（组件 / 工具）规范见 `dwy-eui` / `dwy-ekit` skill；状态管理见 `dwy-vue-pinia` rule；测试见 `dwy-vue-testing` rule。
-
----
-
-## 零、优先使用 eui / ekit 基础库（强制）
-
-`@dwydev/eui` 与 `@dwydev/ekit` 是团队内部 npm 基础库，分别覆盖 UI 组件层与通用工具层。**凡是 eui / ekit 已提供的能力，禁止自行实现，也禁止引入其他库重复造轮子。**
-
-### 必须复用的能力域
-
-| 能力域 | 归属 |
-|--------|------|
-| 通用 UI 组件（Button / Input / Select / Dialog / Drawer / Form / Table 等） | eui |
-| 主题 / 设计 tokens / 暗色模式 | eui |
-| 表单校验（vee-validate + zod 集成） | eui + ekit |
-| 中后台 / 落地页设计规范 | eui（references） |
-| HTTP 客户端（拦截器 / token / 刷新 / 解包） | ekit |
-| 本地存储 / Cookie | ekit（storage / cookie） |
-| 日期 / 时间格式化 | ekit（date） |
-| 数据校验 schema | ekit（validators） |
-| PII 数据脱敏 | ekit（masking） |
-| 剪贴板 / 文件下载 / qs 序列化 | ekit |
-| VueUse 再导出（debounce / throttle / clickOutside / mediaQuery 等） | ekit（hooks） |
-
-### 查阅方式（关键）
-
-**在编写任何 Vue 代码前，以及调用任何 eui / ekit 提供的 API 之前，必须先用 `Skill` 工具加载对应 skill 查阅当前最新接口。** 本文件只规定约束与边界，**不固化**组件 props、函数签名 —— 这些会随版本演进，固化在 rule 里会与实际包不同步。
-
-```
-Skill 工具调用：
-  - skill="dwy-eui"   组件库 API 与设计规范
-  - skill="dwy-ekit"  工具库 API 与契约
-```
-
-### 强制规则
-
-- **禁止**业务代码出现 `axios` / `fetch` / `new XMLHttpRequest`，HTTP 走 ekit `createRequest`
-- **禁止**直接 `localStorage.getItem` / `setItem` / `removeItem`，走 ekit storage / `useStorage`
-- **禁止**直接 `document.cookie` 或单独引入 `js-cookie`，走 ekit cookie
-- **禁止**业务代码 `new Date()` / `toLocaleString` / 直接 `import dayjs`，走 ekit date
-- **禁止**手写 `navigator.clipboard` / `document.addEventListener('click', ...)` 监听，走 ekit copy / hooks
-- **禁止**自定义已有 UI 组件（Button / Input / Select / Dialog / Form / Table 等），走 eui
-- **禁止**自定义已有日期 / 时间 / 验证 / 脱敏 / 下载 工具函数，走 ekit
-- 涉及任一能力域，**先查 skill 拿到当前 API，再写代码**
+适用于基于 Vue 3 + TypeScript + Vite + Tailwind CSS 的前端项目。团队内部 eui / ekit 基础库强制复用见 `dwy-vue-base-lib` rule；状态管理见 `dwy-vue-pinia` rule；测试见 `dwy-vue-testing` rule。
 
 ---
 
@@ -72,9 +29,9 @@ Skill 工具调用：
 
 ```
 src/
-├── modules/                    # 业务模块根目录
+├── features/                   # 业务功能根目录
 │   ├── users/                  # 用户功能
-│   │   ├── api.ts              # 该业务的 API（用 ekit createRequest 客户端）
+│   │   ├── api.ts              # 该业务的 API（用全局 HTTP 客户端）
 │   │   ├── store.ts            # 该业务的 Pinia store
 │   │   ├── types.ts            # 该业务的类型
 │   │   ├── views/              # 该业务的页面组件
@@ -92,7 +49,7 @@ src/
 │   ├── composables/
 │   └── constants/
 ├── core/                       # 全局基础设施：HTTP client / 路由根 / 主题 / 启动
-│   ├── http.ts                 # ekit createRequest 实例（全局唯一）
+│   ├── http.ts                 # 全局唯一 HTTP 客户端实例
 │   ├── router.ts
 │   └── main.ts
 ├── App.vue
@@ -135,12 +92,11 @@ export default {
 ```vue
 <script setup lang="ts">
 // 1. 类型导入
-import type { UserInfo } from '@/modules/users/types'
+import type { UserInfo } from '@/features/users/types'
 
 // 2. 组件 / 工具导入
 import { ref, computed, onMounted } from 'vue'
 import { useRouter } from 'vue-router'
-import { EButton, EInput } from '@dwydev/eui'
 
 // 3. Props / Emits
 const props = defineProps<{ userId: number; title?: string }>()
@@ -250,7 +206,7 @@ const router = createRouter({
     {
       path: '/dashboard',
       name: 'Dashboard',
-      component: () => import('@/modules/dashboard/views/DashboardView.vue'),
+      component: () => import('@/features/dashboard/views/DashboardView.vue'),
       meta: { requiresAuth: true },
     },
   ],
@@ -297,7 +253,7 @@ export function useList<T>(fetchFn: () => Promise<T[]>) {
 }
 ```
 
-通用 hooks（debounce / throttle / clickOutside / mediaQuery 等）**禁止**自己造，走 ekit hooks（具体 API 查 `dwy-ekit` skill）。
+通用 hooks（debounce / throttle / clickOutside / mediaQuery 等）**禁止**自己造，优先复用成熟现成方案。
 
 ---
 
@@ -305,27 +261,17 @@ export function useList<T>(fetchFn: () => Promise<T[]>) {
 
 ### 强制规则
 
-- HTTP 客户端**必须**用 ekit `createRequest` 创建，全局唯一实例放 `core/http.ts`（具体参数与插件查 `dwy-ekit` skill）
-- **禁止**业务代码 `axios.create()` / `fetch()` / `new XMLHttpRequest()`
+- HTTP 客户端全局唯一实例放 `core/http.ts`，业务代码从该实例导入，**禁止**每个模块各自创建客户端
 - 每个业务模块的 API 函数集中在该业务目录的 `api.ts`，按业务域隔离
 - 每个 API 函数**独立导出**，**禁止** `default export`
 - 请求参数 / 响应**必须**类型标注
-- 响应解包契约与 dwyeapi 对齐（`{ code, message, data }`），具体类型与守卫查 `dwy-ekit` skill
+
+> 团队项目 HTTP 客户端的创建（createRequest）、响应解包契约、错误处理守卫见 `dwy-vue-base-lib` rule。
 
 ### 示例
 
 ```typescript
-// core/http.ts —— 全局唯一 HTTP 客户端（具体 plugins 查 dwy-ekit skill）
-import { createRequest } from '@dwydev/ekit'
-
-export const request = createRequest({
-  baseURL: import.meta.env.VITE_API_BASE_URL,
-  plugins: [
-    /* tokenPlugin / refreshTokenPlugin / unwrapPlugin —— 具体用法查 dwy-ekit skill */
-  ],
-})
-
-// modules/users/api.ts —— 该业务的 API
+// features/users/api.ts —— 该业务的 API
 import { request } from '@/core/http'
 import type { UserInfo, UserCreate } from './types'
 
@@ -340,8 +286,7 @@ export function createUser(data: UserCreate) {
 
 ### 错误处理契约
 
-- 401 / 422 / 业务错误的统一处理由 ekit request 插件完成（具体 API 查 `dwy-ekit` skill）
-- 业务侧 catch 用 ekit 提供的 `isApiBusinessError` 类型守卫做分支（`NOT_FOUND` / `VALIDATION_ERROR` / `PERMISSION_DENIED` 等）
+- 401 / 422 / 业务错误的统一处理放在 HTTP 客户端拦截层，不散落到每个调用点
 - **禁止**每个 API 调用都包 `try/catch`，只在页面级或 store 级统一处理
 
 ---
@@ -360,7 +305,7 @@ export function createUser(data: UserCreate) {
 <UserCard :user="user" @click="handleSelect" />
 
 <!-- 双向绑定优先 v-model -->
-<EInput v-model="form.name" placeholder="请输入" />
+<MyInput v-model="form.name" placeholder="请输入" />
 ```
 
 **禁止**：
@@ -384,7 +329,7 @@ export function createUser(data: UserCreate) {
 
 ### 允许 scoped CSS 的场景
 
-- 第三方 / eui 内部样式覆盖（`:deep(...)`）
+- 第三方组件库内部样式覆盖（`:deep(...)`）
 - 复杂动画定义
 - 无法用 Tailwind 表达的样式
 
@@ -448,7 +393,7 @@ async function handleSubmit() {
 }
 ```
 
-- 401 / 422 / 业务错误的拦截走 ekit request 插件（查 `dwy-ekit` skill），**禁止**每个 API 都包 try-catch
+- 401 / 422 / 业务错误的拦截放在 HTTP 客户端拦截层统一处理，**禁止**每个 API 都包 try-catch
 - **禁止**空 catch（`try { ... } catch {}` 吞异常）
 - 异步操作**必须**有 loading 状态
 
@@ -482,16 +427,12 @@ VITE_API_BASE_URL=/api
 import { ref, computed } from 'vue'
 import { useRouter } from 'vue-router'
 
-// 2. 第三方
+// 2. 第三方 / 内部包
 import { storeToRefs } from 'pinia'
 
-// 3. @dwydev/* 内部包
-import { EButton, EInput } from '@dwydev/eui'
-import { request } from '@dwydev/ekit'
-
-// 4. 项目内（@ 别名）
-import { useAuthStore } from '@/modules/users/store'
-import type { UserInfo } from '@/modules/users/types'
+// 3. 项目内（@ 别名）
+import { useAuthStore } from '@/features/users/store'
+import type { UserInfo } from '@/features/users/types'
 ```
 
 ### 强制规则
@@ -555,19 +496,14 @@ AI 编写或审查 Vue 代码时，**必须**检查以下违规模式：
 | **高** | 必须修正后才能继续，向用户说明 |
 | **中** | 提示风险，建议修正 |
 
+> 团队内部 eui / ekit 基础库相关的违规项（未查 skill、重复造轮子、组件直调 axios、直接 localStorage / new Date 等）见 `dwy-vue-base-lib` rule 第七节。
+
 | 检查项 | 违规模式 | 严重程度 |
 |--------|---------|---------|
-| 未查 skill | 使用 eui / ekit API 前未先查 `dwy-eui` / `dwy-ekit` skill | 高 |
-| ekit 重复造轮子 | 自造 HTTP / storage / cookie / date / 校验 / 脱敏 等 ekit 已提供能力 | 高 |
-| eui 重复造轮子 | 自造已有 UI 组件（Button / Input / Dialog 等） | 高 |
-| 组件直调 axios | 组件内 `axios.get` / `fetch` / `new XMLHttpRequest` | **致命 → STOP** |
-| 直接 localStorage | `localStorage.getItem` / `setItem` 出现在业务代码 | 高 |
-| 直接 new Date | `new Date()` / `toLocaleString` / 直接 `import dayjs` | 高 |
 | 技术层散落 | 顶级 `views/` / `components/` / `stores/` / `api/` 把不同业务混放 | 高 |
 | Options API | `<script>` 中 `export default { data, methods, ... }` | **致命 → STOP** |
 | Options Store | `defineStore(id, { state, actions })` | **致命 → STOP** |
 | any 无注释 | 使用 `any` 但未注释说明原因 | 高 |
-| 旧 axios 例子 | 业务里出现 `axios.create()` / `interceptors.request.use(...)` | **致命 → STOP** |
 | `v-if` + `v-for` 同元素 | 同一元素既 `v-if` 又 `v-for` | 高 |
 | 模板复杂表达式 | 模板中 `.filter(...).length > 0` 等多语句 | 中 |
 | 解构 store 丢响应性 | `const { x } = store`（应用 `storeToRefs`） | 高 |

package/templates/ai-tools/rules/Vue/dwy-vue-pitfalls.md

@@ -0,0 +1,66 @@
+---
+description: Vue 3 前端开发避坑清单（CSS 动画 / 响应式 / 路由 / 构建 / SSR 踩坑），按分类持续追加
+paths:
+  - "**/*.vue"
+  - "**/*.ts"
+  - "**/*.css"
+---
+
+# Vue 3 前端开发坑清单
+
+> 动手前先对照本清单避开已知坑；踩到新坑随手按四栏格式（现象 / 根因 / 正确做法 / 适用）追加到对应分类，没有合适分类就新建一个。
+>
+> 通用开发规范见 `dwy-vue-core` rule，本文件只记**非显而易见的实战坑**。
+
+## 分类索引
+
+- CSS 动画 / 过渡
+- 响应式 / 组件（ref / reactive / 生命周期 / props）
+- 路由（vue-router / 守卫 / 懒加载）
+- 构建 / SSR（Vite / vite-ssg / 预渲染）
+- i18n / 内容
+- 排查方法论
+- 其他分类遇到再加
+
+---
+
+## CSS 动画 / 过渡
+
+### View Transitions 圆形过渡：收回方向（clip-path 缩到 0）收尾闪一帧
+
+- **现象**：用 View Transitions API + `clip-path: circle()` 做主题切换的圆形润开过渡。散开方向（圆 0→大）正常；收回方向（圆 大→0，旧层缩回圆心露出底下新主题）动画走完后页面闪一下。
+- **根因**：CSS keyframes 默认 `animation-fill-mode: none`——**动画结束瞬间元素恢复到原始属性值，再等浏览器销毁 VT 伪元素树**。收回方向动画挂在 `::view-transition-old(root)`（旧主题层），从 `circle(175vmax)` 缩到 `circle(0)`；动画一结束，`clip-path` 因 `fill-mode:none` **回弹到无裁切（全屏可见）**，旧主题瞬间全屏重现一帧 → 这就是「闪」。散开方向不闪是因为它的动画挂在 new 层，回弹后的终态（全屏新主题）恰好 == 真实 DOM 态，肉眼看不出。不对称的本质：正在动画的上层，其回弹终态是否等于真实页面态。
+- **正确做法**（纯 CSS，不动 JS）：① 给做圆形动画的层加 **`forwards`**，动画结束后保持终态（缩到 `circle(0)` 的层保持不可见），杜绝回弹全屏闪现——这是关键修复；② 给静止的对侧层补一段**恒等铺满动画 + `both`**（`from`/`to` 都是 `circle(175vmax)`），让它整个过渡期间也作为活动合成层，与对侧合成待遇对称，收尾两层合成组同步解散，消除高对比（纯黑↔纯白）下的交接重绘。
+  ```css
+  @keyframes vt-hold-full {
+    from { clip-path: circle(175vmax at var(--vt-x, 50%) var(--vt-y, 50%)); }
+    to   { clip-path: circle(175vmax at var(--vt-x, 50%) var(--vt-y, 50%)); }
+  }
+  html[data-vt-direction='conceal']::view-transition-new(root) {
+    z-index: 1; animation: vt-hold-full var(--vt-dur) var(--vt-ease) both;
+  }
+  html[data-vt-direction='conceal']::view-transition-old(root) {
+    z-index: 2; animation: vt-circle-conceal var(--vt-dur) var(--vt-ease) forwards;
+  }
+  ```
+- **适用**：通用。推广教训：① 凡 keyframes 动画**结束态偏离元素静止态**（clip-path / transform / opacity 终值非默认），必须显式 `animation-fill-mode: forwards`（或 `both`），否则结束瞬间回弹一帧；不限 View Transitions。② 高对比色块下任何一帧亮度跳变都肉眼可见，动画收尾要让「正在动画的上层终态 == 真实 DOM 态」。③ 逐帧闪烁靠截图基本抓不到（只在单帧出现），定位靠根因推理 + CSSOM 确认规则生效，别依赖视觉快照验证。
+
+## 响应式 / 组件
+
+<!-- 待填：踩到坑按四栏格式追加 -->
+
+## 路由
+
+<!-- 待填 -->
+
+## 构建 / SSR
+
+<!-- 待填 -->
+
+## i18n / 内容
+
+<!-- 待填 -->
+
+## 排查方法论
+
+<!-- 待填 -->

package/templates/ai-tools/rules/iOS/dwy-ios-pitfalls.md

@@ -157,3 +157,10 @@ paths:
 - **根因**：`switch` 在视图树里每次只保留当前 case 的子树，切 tab 时 SwiftUI **销毁**旧 tab 视图、**重建**新 tab 视图，`@State` 随之重置。它不是缓存容器。
 - **正确做法**：用系统 `TabView(selection:)` + 每页 `.tag(...)`。TabView 保活所有 tab 页，切换只是显隐，状态天然保留。隐藏系统 tab bar（`.toolbar(.hidden, for: .tabBar)`）后用自绘底栏，`selection` 与自绘栏共用同一 `@State`。注意别用 `.tabViewStyle(.page)`（会引入左右滑动切页，与边缘返回手势冲突）。
 - **适用**：iOS 16+ SwiftUI 多 tab 且需保留各 tab 页内状态时。
+
+### Mac（Designed for iPhone/iPad）上 sheet 不继承 Observable environment，弹层即崩
+
+- **现象**：iPhone 真机正常；把 iOS app 装到 macOS（「在 Mac 上使用 iPhone/iPad App」）后，一点「解锁」/付费墙/编辑设备/键盘 sheet 就崩。崩溃报告 `EXC_BREAKPOINT` / `SIGTRAP`，栈顶 `libswiftCore _assertionFailure` → `SwiftUICore EnvironmentValues.subscript.getter` → `SheetBridge.present` / `PresentationHostingController`。应用日志只到 `app 启动`。
+- **根因**：`@Environment(Store.self)` / `@Environment(AppRouter.self)` 在未注入时会 fatal。iPhone 上 sheet 内容通常继承父树的 `.environment(...)`；Mac 上 UIKitMacHelper 走 `PresentationHostingController`，**不把父视图的 Observable environment 传进 sheet**，于是 `PaywallView` 等一 present 就 assertionFailure。
+- **正确做法**：凡 sheet / fullScreenCover 内容里读了 `@Environment(SomeObservable.self)`，在 content 上**显式** `.environment(store)` / `.environment(router)` 重注入，不要依赖继承。嵌套 sheet 同样要再注一次。例：`PaywallView().environment(store)`、`DeviceEditSheet(...).environment(router)`、`KeyboardSheet().environment(router)`。
+- **适用**：iOS 17+ `@Observable` + `.environment(instance)`，且 app 会在 Mac 上以 Designed for iPhone/iPad 运行时。iPhone 上不重注入多数也能跑，但为跨平台一致应一律重注入。

package/templates/ai-tools/rules//345/274/200/345/217/221/346/265/201/347/250/213/dwy-dependency-freshness.md

@@ -0,0 +1,59 @@
+---
+description: 依赖版本新鲜度通用规则（首次技术选型下载依赖时，发布 <7 天的版本不采用；跨 npm/uv/Docker/Android/iOS/鸿蒙/Flutter 等所有栈）
+---
+
+# 依赖版本新鲜度规则
+
+> 首次技术选型下载依赖（引新包、选 base 镜像 / SDK 版本）时，刚发布的新版本常带回归 bug：构建失败、Docker 镜像缺层、API breaking change。本规则约束 AI 在装新依赖前主动查「版本发布时间」，避开 <7 天的版本。
+>
+> 适用**所有技术栈**：npm/pnpm、uv/pip、Docker、Android(Gradle/Maven)、iOS(CocoaPods/SPM)、鸿蒙(ohpm)、Flutter(pub) 以及未来出现的任何包管理器。下面给出总约束 + 各栈示例，未列出的栈按「查官方 registry 发布时间」通用流程自行判断。
+
+## 一、适用边界
+
+- **仅约束首次技术选型下载依赖**：新项目引入新包、新搭脚手架选 base 镜像 / SDK 版本、原项目引入此前没用过的依赖。
+- **已安装的旧版本无需为此升级**。本规则只管「新装 / 新选」，不管「存量升级」。
+- 7 天是**下限排除条件**，不是「必须选最近一个 ≥7 天的版本」。最终选哪个稳定版由 AI 综合判断（成熟度、维护活跃度、依赖体积、与项目栈兼容性）。
+
+## 二、核心约束
+
+- **必须**在首次安装 / 选定版本前，查候选版本的「首次发布时间」
+  - 用官方 registry 的发布时间，**不是**上传时间、**不是** `latest` / `stable` tag 时间
+- **禁止**采用发布时间距今 **<7 天**的版本
+- **禁止**无脑用 `@latest` / `latest` / `stable` / 浮动 tag / 不带版本号安装——这些随时可能落到刚发布的新版本上
+- 已安装版本**无需**为此规则升级
+
+## 三、各栈查发布时间示例
+
+未列出的栈，按「查官方 registry 元数据 → 取发布时间」自行处理。
+
+| 栈 | 查发布时间方法 |
+|---|---|
+| npm / pnpm | `npm view <pkg> time --json`（取目标版本对应的时间字段） |
+| uv / pip | PyPI JSON API：`https://pypi.org/pypi/<pkg>/json` 的 `releases[<version>][0].upload_time` |
+| Docker | Docker Hub 镜像页 / API 的 `last_updated`；优先看具体 tag 的 push 时间 |
+| Android (Gradle/Maven) | Maven Central `maven-metadata.xml` 的 `<lastUpdated>`（格式 yyyyMMddHHmmss） |
+| iOS (CocoaPods) | `https://github.com/CocoaPods/Specs` 或仓库 release / tag 时间 |
+| iOS (SPM) | 源仓库 release / tag 时间 |
+| 鸿蒙 (ohpm) | ohpm registry 包元数据 publishTime |
+| Flutter (pub) | `https://pub.dev/packages/<pkg>/versions` 页 published 时间 |
+
+## 四、正反例
+
+```bash
+# 反例：直接装 latest，可能落到昨天才发的版本
+pnpm add some-pkg@latest
+uv add some-pkg          # 不锁版本
+FROM node:latest         # 随时被新镜像覆盖
+implementation 'com.example:lib:latest'
+
+# 正例：先查发布时间，选发布 ≥7 天的稳定版
+npm view some-pkg time --json      # 看候选版本发布时间
+pnpm add some-pkg@1.2.3            # 1.2.3 发布已满 7 天
+FROM node:20.18.1-slim             # 该 tag push 已满 7 天
+```
+
+## 五、AI 自判提示
+
+- 栈未列全时，先找该栈的**官方 registry**（包管理器背后的中央仓库），查目标版本的发布时间字段。
+- 拿不到精确发布时间时，保守处理：选发布更早、更稳定的版本，不要选「最新」。
+- 7 天窗口内的新版本，**等待**而非采用，**无任何例外**（含安全补丁）。等满 7 天再用。

package/templates/ai-tools/rules//345/274/200/345/217/221/346/265/201/347/250/213/dwy-git-commit.md

@@ -135,16 +135,19 @@ Scope 由 AI 根据变更模块与项目语义自行决定，保持与现有提
 
 ## 8. AI 署名与生成声明治理
 
-commit 的 subject、body、footer、trailer 中禁止出现：
+commit 的 subject、body、footer、trailer 中禁止出现任何形式的 AI 署名或生成声明。AI 应自行判断：凡由 AI 工具（Claude、ChatGPT、GPT、Copilot、Cursor、Gemini、Llama、LLM 等）生成或参与撰写的署名、尾随声明、自动生成标记，均不得写入 commit message。
 
-- `Co-Authored-By: Claude ...`
-- `Generated with Claude Code`
-- `Generated with ...`
-- `Claude`、`ChatGPT`、`GPT`、`Copilot`、`Cursor`、`AI`、`LLM`
-- `noreply@anthropic.com`、`noreply@openai.com`
+包括但不限于：
+
+- `Co-Authored-By: <AI 名称> <noreply@...>`（任何 AI 产品 + 邮箱组合）
+- `Generated with Claude Code` / `Generated with ...`（任何"由 XX 生成"声明）
+- 含 AI 产品名的署名行（Claude、ChatGPT、GPT、Copilot、Cursor、Gemini、LLM 等）
+- AI 平台noreply 邮箱（noreply@anthropic.com、noreply@openai.com 等）
 
 `git commit -m "..."` 不得附带 AI 署名 trailer。
 
+> PreToolUse hook `pre-git-commit-ai-signature-check.sh` 会在 commit message 中检出 Co-Authored-By / Generated with 等 AI 署名模式时硬拦截（exit 2），规则约束 + 工程兜底双保险。
+
 ## 9. 参考示例
 
 - `feat(eui): 添加 Image 组件懒加载支持`

package/templates/ai-tools/rules//345/274/200/345/217/221/346/265/201/347/250/213/dwy-tdd-development.md

@@ -1,5 +1,5 @@
 ---
-description: TDD 开发流程(新功能/bug 修复/重构的测试先行与回归策略)
+description: TDD 开发流程(新功能/bug 修复/重构的测试先行与回归策略)与测试-源码分隔(测试工程独立 tests/ 目录、镜像源码结构、各栈目录约定)
 ---
 
 # TDD 开发规则
@@ -26,6 +26,42 @@ description: TDD 开发流程(新功能/bug 修复/重构的测试先行与回
 2. 再重构 — 修改代码
 3. 再跑测试 — 确认行为没变
 
+## 测试与源码分隔（硬约束）
+
+测试工程必须与源码分隔，不混在一起。
+
+### 核心规则
+
+- 测试代码**禁止**与源码同目录混放；测试集中在项目根 / 包根的独立 `tests/` 目录。
+- `tests/` **镜像源码结构**，测试文件与被测源码一一对应、可反查：
+  - `src/foo/bar.ts` → `tests/foo/bar.test.ts`
+  - `src/services/user.py` → `tests/test_user.py`
+- 源码目录（`src/`）保持纯净，**只放产品代码**；打包 / 发布产物天然不含测试，CI 用一个目录通配即可圈定全部测试。
+- 测试用的 fixture / mock 数据 / 测试工具，放 `tests/` 内（如 `tests/fixtures/`、`tests/conftest.py`），不散落进源码目录。
+
+### 为什么（约束的根因）
+
+测试混入源码目录会引发一连串问题，分隔后一次性收口：
+
+- **被打包进发布产物**：测试随源码一起发到 npm / PyPI，污染产物、撑大体积。
+- **source map / 内部细节泄露**：测试常含内部实现假设、mock 的真实数据，泄露到产物有安全风险。
+- **覆盖率 / 构建统计污染**：测试文件被计入源码统计，覆盖率、行数失真。
+- **CI 难圈定范围**：源码与测试交织，CI 无法用一条目录规则排除测试。
+- **AI / 工具难定位**：找不到「源码↔测试」对应关系，反复把测试误写进 `src/`。
+
+### 各栈目录与命令速查表
+
+| 栈 | 测试目录 | 命名约定 | 运行命令 |
+|----|---------|---------|---------|
+| Vue / Vitest | `tests/` 镜像 `src/` | `*.test.ts` | `pnpm vitest run [路径]` |
+| Python / pytest | `tests/` | `test_*.py` | `pytest tests/ -v` / `uv run pytest` |
+| Android | `src/test/`（单元）+ `src/androidTest/`（仪器） | `*Test.kt` | `./gradlew test` / `./gradlew connectedAndroidTest` |
+| Node / CLI | `tests/` 镜像 `src/` | `*.test.ts` | 对应 runner（vitest / jest） |
+
+注：Android 的 `src/test` / `src/androidTest` 是 Gradle 生态**强约定**的独立测试源集（test source set），与 `src/main` 源码完全分隔，符合本规范"测试与源码分隔"理念，按其生态默认即可，**属合规分隔**，不视为"测试写进 src"。
+
+**通用准则（表中未列的栈）**：遵循「独立测试目录 + 镜像源码结构 + 该生态主流 runner 约定」三条原则自行判断，不硬套上表布局。
+
 ## 回归测试
 
 ### 开发中：只跑受影响的测试
@@ -55,7 +91,13 @@ pnpm vitest run tests/utils/format.test.ts   # 改了单个工具函数
 
 ## TEST_CASES.md
 
-每个包/项目维护一份 `TEST_CASES.md`，记录所有测试用例的清单：
+每个包/项目维护一份 `TEST_CASES.md`，记录所有测试用例的清单。**`TEST_CASES.md` 跟测试目录走，不放项目根**：
+
+- 有 `tests/` → 放 `tests/TEST_CASES.md`
+- 测试源集分散（如 Android `src/test/`）→ 放对应测试根（`src/test/TEST_CASES.md`），与该模块测试同处
+- 理念：测试清单是测试工程的一部分，归测试目录，与「测试与源码分隔」一致
+
+内容要求：
 
 - 人类可读，方便审查和手动编辑
 - 新增/修改/删除功能时必须同步更新
@@ -68,3 +110,6 @@ pnpm vitest run tests/utils/format.test.ts   # 改了单个工具函数
 - **禁止**写完代码再补测试（先测试后代码）
 - **禁止**测试不通过就提交
 - **禁止** TEST_CASES.md 与实际测试不同步
+- **禁止**测试文件写进 `src/` 源码目录（Android `src/test`、`src/androidTest` 例外，是 Gradle 标准测试源集）
+- **禁止**测试目录结构与源码脱节（找不到「源码↔测试」对应关系）
+- **禁止**把测试 fixture / mock 数据散落进源码目录