create-dwy 0.19.1 → 0.21.0

package/templates/ai-tools/rules/Android/dwy-android-core.md

@@ -13,7 +13,7 @@ paths:
 
 适用于 **Android 原生项目**(Java + Kotlin 混编,XML 布局,Gradle 构建脚本)。本规范**重点是代码注释**,兼带最小必要的命名 / 简约 / 反模式约束。
 
-不限制构建工具、UI 框架、架构模式、SDK 版本、依赖库选型 —— 与老项目兼容。
+不限制构建工具、UI 框架、SDK 版本、依赖库选型 —— 与老项目兼容。页面架构走 `dwy-android-mvp`（实际 MVP 读当前项目上下文；本文件只定行为）；模块四层走 `dwy-android-layering`。
 
 ## 全面屏 / 刘海屏适配
 
@@ -23,6 +23,136 @@ paths:
 - 全屏背景、沉浸式遮罩可以延伸到系统栏区域,但前景可交互内容默认留在安全显示区内。
 - 禁止写死状态栏高度、导航栏高度、刘海高度,统一通过系统 inset 获取。
 
+## 尺寸单位
+
+布局、间距、圆角、描边用 `dp`。字号用 `sp`，跟随系统字体缩放。禁止 `px`。数值走 `dimens.xml`，禁止在 XML / 代码里裸写 `16dp` / `16sp`。
+
+**为什么字号用 sp**：系统大字是可访问性能力。把字号锁成 `dp`、或除掉 `fontScale`，大字模式会失效。
+
+**例外**：电视，或设计明确要求不跟随系统字号的固定版式，字号资源才用 `dp`，并在资源旁写明原因。
+
+### 禁止 / 必须
+
+
+| 场景 | 禁止 | 必须 |
+| --- | --- | --- |
+| XML 宽高 / 间距 / 圆角 / 描边 | `16px`、裸数字 | `@dimen/xxx`，资源值 `16dp` |
+| XML / style 字号 | `16px`、裸 `16sp`、用 `dp` 锁死字号 | `@dimen/xxx`，资源值 `16sp` |
+| 代码设字号 | 裸数字、再除一次 `fontScale` | `setTextSize(COMPLEX_UNIT_PX, getDimension(R.dimen.xxx))`。dimen 是 `sp` 时 `getDimension` 已按当前字号缩放换成 px |
+| Jetpack Compose 布局 | `16.px`、裸 `.dp` 字面量 | `dimensionResource(R.dimen.xxx)` |
+| Jetpack Compose 字号 | 裸 `16.sp`、`toPx() / fontScale` | 从 `sp` 的 dimen 读出后再 `.toSp()`，让系统字体缩放只生效一次 |
+
+
+系统 API 返回值本身是 px（`View.getWidth()`、`MotionEvent`、Canvas、`getDimension()`）——那是运行时像素，不是声明单位。声明布局尺寸仍用 dp，声明字号仍用 sp。
+
+```xml
+<!-- res/values/dimens.xml -->
+<dimen name="text_size_title">18sp</dimen>
+<dimen name="padding_page">16dp</dimen>
+```
+
+```xml
+<!-- ❌ -->
+<AppCompatTextView android:textSize="16sp" android:layout_width="100px" />
+<AppCompatTextView android:textSize="16dp" />
+
+<!-- ✅ 字号 sp、间距 dp，都走资源 -->
+<AppCompatTextView
+    android:textSize="@dimen/text_size_title"
+    android:padding="@dimen/padding_page" />
+```
+
+```kotlin
+// ❌
+textView.textSize = 16f
+textView.setTextSize(TypedValue.COMPLEX_UNIT_SP, 16f)
+Text("标题", fontSize = 16.sp)
+
+// ✅ View：dimen 是 sp。getDimension 已按 fontScale 换成 px，不要再套一层 SP，也不要除 fontScale。
+textView.setTextSize(
+    TypedValue.COMPLEX_UNIT_PX,
+    resources.getDimension(R.dimen.text_size_title)
+)
+
+// ✅ Compose：dimensionResource 把 sp 资源按当前 fontScale 收成 Dp。toSp() 除掉这一次，绘制时系统再乘一次。
+val titleSize = with(LocalDensity.current) {
+    dimensionResource(R.dimen.text_size_title).toSp()
+}
+Text("标题", fontSize = titleSize)
+```
+
+布局用 `dimensionResource(R.dimen.xxx)` 读 dimens，不要散落裸 `.dp`。字号不要写裸 `.sp`。
+
+## 屏幕适配（AndroidAutoSize，只按宽）
+
+屏幕适配用 [JessYan AndroidAutoSize](https://github.com/JessYanCoding/AndroidAutoSize) `1.2.1`（今日头条 density 方案）。**只按宽度适配**，不按高度。布局写 `dp`、字号写 `sp`（见上一节），由框架改 `density`，让屏幕逻辑宽等于设计稿宽。字号仍跟随系统字体缩放。
+
+**为什么只按宽**：高度含状态栏 / 刘海 / 手势条，按高适配会把系统栏算进设计高，全面屏变形。宽是稳定轴。
+
+`1.2.0+` 同时兼容 Support 与 AndroidX，按当前项目推断，**禁止**为接本库引入 `androidx.*`。Support 老项目见 `dwy-android-support-only`。
+
+分端只体现在 **设计稿尺寸 + `design_width_in_dp`**。AutoSize 按宽铺满，不必再用 `values-television`、`productFlavor`、`UI_MODE_TYPE_TELEVISION` 去拆资源或运行时切换。
+
+### 设计基准
+
+单位一律 `dp`。`design_width_in_dp` 填当前产品那一行的宽。
+
+| 端 | 画布 | 方向 | `design_width_in_dp` | `design_height_in_dp`（只记录，不参与适配） |
+| --- | --- | --- | --- | --- |
+| 移动端 | **390 × 844** | 竖屏 | **390** | 844 |
+| TV 端 | **1280 × 720** | 横屏 | **1280** | 720 |
+
+### 依赖
+
+JCenter 已停，走 JitPack。用仍兼容 Support、不引入 AndroidX 的正式版。已核对过的起点是 `v1.2.1`（`1.2.0+` 才兼容 Support）。新 tag 先看传递依赖，拉进 AndroidX 就丢掉。具体 tag 按依赖新鲜度现查，不要把 `v1.2.1` 当成永远唯一坐标。
+
+```gradle
+// 起点先验。写入前确认该 tag 仍不带 androidx
+implementation 'com.github.JessYanCoding:AndroidAutoSize:v1.2.1'
+```
+
+### 配置（强制）
+
+Manifest 按上表填当前产品。下面是移动端；TV 把宽改成 `1280`、高改成 `720`。
+
+```xml
+<application>
+    <meta-data
+        android:name="design_width_in_dp"
+        android:value="390" />
+    <meta-data
+        android:name="design_height_in_dp"
+        android:value="844" />
+</application>
+```
+
+```java
+// 移动端保留系统字体缩放。TV、或设计写明固定字号的界面，才 setExcludeFontScale(true)。
+AutoSizeConfig.getInstance()
+        .setBaseOnWidth(true)
+        .setExcludeFontScale(false);
+```
+
+页面基类必须重写 `getResources()`，防止厂商 ROM / Dialog / 三方把 `density` 改回去导致偶发错位：
+
+```java
+@Override
+public Resources getResources() {
+    AutoSizeCompat.autoConvertDensityOfGlobal(super.getResources());
+    return super.getResources();
+}
+```
+
+三方 WebView / 扫码 / 系统 Dialog 错乱：该页实现 `CancelAdapt`，或 `show()` 前再调一次 `AutoSizeCompat.autoConvertDensityOfGlobal`。
+
+### 禁止
+
+- `setBaseOnWidth(false)` 或按高度适配
+- 移动端 `setExcludeFontScale(true)`，或用除 `fontScale` 把字号锁死
+- 副单位 `pt` / `in` / `mm`
+- 再接 `sdp` / 百分比库 / 另一套改 `density` 的方案
+- 布局改回 `px`
+
 ## 控件选型(AppCompat)
 
 XML 布局、代码 `new`、自定义 View:**只要存在 AppCompat 对应类,就必须用 AppCompat 版**,禁止 `android.widget` 平台控件。没有 AppCompat 对应类的布局容器 / 列表(LinearLayout、ConstraintLayout、RecyclerView 等)保持原样。
@@ -101,6 +231,7 @@ class PriceText(context: Context, attrs: AttributeSet?) : AppCompatTextView(cont
 | Fragment                          | `XxxFragment`                       | `HomeFragment`                |
 | Adapter / ViewHolder              | `XxxAdapter` / `XxxViewHolder`      | `OrderAdapter`                |
 | Dialog                            | `XxxDialog`                         | `ConfirmDialog`               |
+| MVP 相关                            | 跟当前项目已有命名                      | 常见 `XxxPresenter`（有 Contract 则跟本仓） |
 | 布尔变量 / 方法                         | `is`* / `has*` / `can*` / `should*` | `isLoading`、`hasNext`         |
 
 
@@ -114,7 +245,7 @@ class PriceText(context: Context, attrs: AttributeSet?) : AppCompatTextView(cont
 | drawable        | `<用途>_<状态>`              | `bg_button_primary`、`ic_arrow_right`、`shape_card_corner`                       |
 | color           | `<语义>`                   | `color_primary`、`color_text_secondary`                                         |
 | string          | `<场景>_<语义>`              | `login_button_submit`、`home_title`                                             |
-| dimen           | `<语义>`                   | `padding_normal`、`text_size_title`                                             |
+| dimen           | `<语义>`。布局 `dp`，字号 `sp`（禁止 `px`） | `padding_normal`、`text_size_title`                                             |
 | anim / animator | `<逻辑名>_<方向|序号>` 或通用动画名   | `fade_in.xml`、`push_bottom_in.xml`、`loading_001.xml`                           |
 | menu            | `menu_<场景>.xml`          | `menu_order_detail.xml`                                                        |
 | style / theme   | `PascalCase`,点号继承,从通用到特殊 | `Widget.App.Button`、`Theme.App.Dark`                                           |
@@ -219,10 +350,10 @@ class UserActivity : AppCompatActivity() {
 
 ```xml
 <!-- ❌ 裸文案 / 裸数字 -->
-<TextView android:text="登录" android:textSize="16sp" />
+<AppCompatTextView android:text="登录" android:textSize="16dp" />
 
-<!-- ✅ 走资源 -->
-<TextView android:text="@string/login_button_submit" android:textSize="@dimen/text_size_normal" />
+<!-- ✅ 走资源；字号单位也是 dp，见「尺寸单位（强制 dp）」 -->
+<AppCompatTextView android:text="@string/login_button_submit" android:textSize="@dimen/text_size_normal" />
 ```
 
 ## 二、代码注释
@@ -792,7 +923,7 @@ for (Order o : orders) {
 
 | 覆盖 | 不覆盖 |
 | ---- | ------ |
-| Model / Entity / DTO / VO / Bean 及同类数据载体 | Activity / Fragment / Adapter / ViewHolder / Repository / ViewModel 等非数据载体 |
+| Model / Entity / DTO / VO / Bean 及同类数据载体 | Activity / Fragment / Adapter / ViewHolder / Repository / Presenter 等非数据载体 |
 | 含功能包内私有、`internal` 实体 | `enum`;仅含常量的 `object` / `Constants` 类 |
 | 网络响应体、跨层传递的数据对象 | 纯 UI 状态若仅为页面内部临时结构且不跨层,可豁免(跨层则按实体处理) |
 
@@ -926,9 +1057,11 @@ class User(val id: Long, val name: String)
 
 ### 包组织(按功能聚合)
 
+**Gradle 模块四层（`:app` / `:features:*` / `:biz-foundation` / `:foundation`）与依赖边 → 见 `dwy-android-layering`。** 本节只约束**模块内部** Java/Kotlin 包。
+
 **按功能聚合(package-by-feature),不按技术分层(package-by-layer)。**
 
-同一个功能/页面相关的所有类 —— 页面(Activity / Fragment)、其数据实体、业务逻辑(ViewModel / Presenter / UseCase)、数据访问(Repository)、列表 Adapter、UI 状态等 —— 放在**同一个功能包**下聚合,而不是按类型横切成 `activities/`、`models/`、`adapters/`、`repositories/` 这种分层包。
+同一个功能/页面相关的所有类 —— 页面(Activity / Fragment)、其数据实体、业务逻辑(Presenter 或本仓对等角色)、数据访问(Repository)、列表 Adapter、UI 状态等 —— 放在**同一个功能包**下聚合,而不是按类型横切成 `activities/`、`models/`、`adapters/`、`presenters/` 这种分层包。页面架构见 `dwy-android-mvp`（切法跟当前项目）。
 
 **理由**:改一个功能时,相关文件都在一个包内,无需在多个分层目录间跳转;包之间按业务边界解耦,删除/迁移一个功能只动一个包;高内聚低耦合,符合就近维护。
 
@@ -937,24 +1070,23 @@ class User(val id: Long, val name: String)
 com.example.app/
   login/                      <!-- 登录功能,自包含 -->
     LoginActivity.kt
-    LoginViewModel.kt
+    LoginPresenter.kt             <!-- 或本仓已有的 Contract / XxxView，跟项目 -->
     LoginRepository.kt
-    LoginUiState.kt
     Credential.kt             <!-- 该功能私有实体 -->
   order/                      <!-- 订单功能 -->
     OrderListActivity.kt
     OrderDetailActivity.kt
-    OrderViewModel.kt
+    OrderListPresenter.kt         <!-- 同上，不强制 Contract 文件 -->
     OrderRepository.kt
     OrderAdapter.kt
     Order.kt
-  common/                     <!-- 跨功能共享:基类、工具、网络、通用实体 -->
+  common/                     <!-- 未拆四层时:本产品 Base / 工具。有 :biz-foundation 则 Base 放那个模块 -->
     base/  network/  util/  model/
 
 // ❌ 按技术分层横切 —— 改一个功能要在多个目录间反复跳
 com.example.app/
   activities/   LoginActivity.kt  OrderListActivity.kt  OrderDetailActivity.kt
-  viewmodels/   LoginViewModel.kt  OrderViewModel.kt
+  presenters/   LoginPresenter.kt  OrderListPresenter.kt
   repositories/ LoginRepository.kt  OrderRepository.kt
   adapters/     OrderAdapter.kt
   models/       Credential.kt  Order.kt
@@ -1090,7 +1222,7 @@ if (trimmed.isNotEmpty()) { ... }
 | Kotlin 顶层 `var`                                                   | `val`;需可变用类封装 + 同步原语                        |
 | 内部类持有外部 Activity                                                  | `static` 内部类 + `WeakReference`              |
 | 拼接 SQL 字符串                                                        | 参数化查询                                       |
-| 硬编码 dp / sp 值                                                     | `@dimen/`                                   |
+| 硬编码尺寸 / 字号用 `px` 或用 `dp` 锁死字号                                      | 布局 `@dimen/` 值 `dp`，字号 `@dimen/` 值 `sp`                           |
 | 硬编码颜色值 `#FF0000`                                                  | `@color/color_primary`                      |
 | 用户可见文案硬编码                                                         | `@string/...`                               |
 | 单行 `if` / `for` / `while` / `do-while` 无 `{}`(Kotlin 表达式 `if` 除外) | 即使只一行也写 `{}`;详见 §四「控制流大括号」                  |
@@ -1131,6 +1263,8 @@ if (trimmed.isNotEmpty()) { ... }
 | 22  | 数据实体(Model/DTO/VO/Bean 等):Java 字段 `private` + get/set + `toString`;Kotlin 优先 `data class`+`val`(自带 toString),禁止 `@JvmField`,非 data class 必须手写 `toString`                                                                              | ✓        |
 | 23  | 字符串空判断用 `isEmpty` / `isNotEmpty` / `isNotBlank`,禁止 `length() > 0` / `== 0` / `!= 0` 及 `trim().length() > 0` 判空;详见 §八「字符串空判断」                                                                                                      | ✓        |
 | 24  | 有 AppCompat 对应类的控件必须用 AppCompat 版(XML / `new` / 自定义 View 父类),包名按当前项目推断;Switch 用 `SwitchCompat`;无对应类的布局容器保持原样                                                                                                                          | ✓        |
+| 25  | 布局 `dp`、字号 `sp`，禁止 `px` 和裸字面量（含 Compose `16.sp` / `16.px`）；数值走 `dimens.xml`。不要除掉 `fontScale`。TV / 固定版式才允许字号用 `dp` 并写明原因 | ✓        |
+| 26  | 屏幕适配走 AndroidAutoSize（Support 兼容线，起点先验 `v1.2.1`，不锁死这个 tag），只按宽；移动端 `design_width=390`（画布 `390×844`），TV `design_width=1280`（画布 `1280×720`）；禁止按高适配、禁止副单位；页面基类重写 `getResources()` 调 `AutoSizeCompat` | ✓        |
 
 
 **不执行自检就提交代码 = 违规。**

package/templates/ai-tools/rules/Android/dwy-android-layering.md

@@ -0,0 +1,142 @@
+---
+description: Android 四层模块与依赖方向（app / features / biz-foundation / foundation）；Gradle Version Catalog 根锁定第三方版本
+paths:
+  - "**/*.kt"
+  - "**/*.java"
+  - "**/*.gradle"
+  - "**/*.kts"
+  - "**/libs.versions.toml"
+  - "**/settings.gradle"
+---
+
+# Android 四层架构与依赖
+
+适用于多模块 Android 应用。注释 / 命名 / AppCompat 见 `dwy-android-core`。页面 MVP 与业务 Base 见 `dwy-android-mvp`。本文件只管**Gradle 模块层、引用边、版本写在哪**。模块**内部** Java 包仍按功能聚合（见 `dwy-android-core`「包组织」）。
+
+新项目强制本结构。未拆模块的存量**不回溯拆包**；新增模块必须按本文件落层。Support 老项目另走 `dwy-android-support-only`。
+
+单壳项目**不建** PlatformFoundation。
+
+---
+
+## 一、层名（冻结）
+
+正式层名只有下表四个。模块可以叫 `:app`、`:biz-foundation`，文档可写「本仓 `:layer-infra` = Foundation」。**禁止**把 `Domain` / `infra` / `core` 当层名。
+
+| 层 | 判定（只用这一条） | 禁止 |
+|---|---|---|
+| **Foundation** | 换一个完全不同的产品仍原样拿走 | 出现本业务名词 |
+| **BizFoundation** | 本产品才有，但跨多个 Feature 都要用 | 页面、导航、某一端壳状态 |
+| **Features** | 可整包删/裁剪的业务域 | 被其他 Feature 直接引用 |
+| **Assembly** | 生命周期、DI、路由挂载、把实现插进 Protocol | 业务规则、业务计算 |
+
+升层：第二个 Feature 或第二个产品**真在用**，才升到 BizFoundation / Foundation。禁止「可能复用」提前抽。
+
+业务内聚：一个业务域 = `:features:<name>`。域内 Activity / Presenter（或本仓对等角色）/ Repository 聚在该模块。禁止全局 `activities/` / `presenters/` 模块（本仓已经那样切的，跟本仓）。
+
+`BaseActivity` / `BaseFragment` / `BaseDialog` 落在 `:biz-foundation`（本产品壳）。Foundation 不放页面基类。细则见 `dwy-android-mvp`。
+
+---
+
+## 二、依赖边（强制）
+
+```
+:app → :features:* → :biz-foundation → :foundation
+            ✕ 互引
+```
+
+| 谁 | 允许 project 依赖 | 禁止 |
+|---|---|---|
+| `:app` | `:features:*`、`:biz-foundation` | 业务规则写在 Application / HomePresenter |
+| `:features:orders` | **仅** `implementation project(':biz-foundation')` | 其它 Feature、`:foundation`、`:app` |
+| `:biz-foundation` | `:foundation`（可用 `api` 给编译用，见下） | Feature / app |
+| `:foundation` | 无 project 下层 | 业务模型、Feature |
+
+**Feature 互引为零。** 跳转只走 `:app`。跨域只许：升到 `:biz-foundation`；Feature 依赖 `biz-foundation` 里的接口，由 app 注入；壳编排。
+
+**透传不等于可直连。** `:biz-foundation` 即使 `api project(':foundation')`，Feature **源码仍禁止** `import` foundation 包名。要用 Http/Log，走 biz-foundation 门面。
+
+```gradle
+// features/orders/build.gradle
+dependencies {
+    implementation project(':biz-foundation')
+    implementation libs.okhttp
+}
+```
+
+```gradle
+// 禁止
+implementation project(':features:inventory')
+implementation project(':foundation')
+implementation project(':app')
+```
+
+---
+
+## 三、分包树
+
+打开工程必须能数出四层。业务词只出现在 `features/` 下。
+
+```
+:app                              # Assembly
+:features:orders                  # Features
+:features:inventory
+:biz-foundation                   # BizFoundation（鉴权、跨域协议放这个模块里面）
+:foundation                       # Foundation（Http / Log / 进程工具）
+```
+
+```
+app/
+features/
+  orders/
+  inventory/
+biz-foundation/
+  src/main/java/.../bizfoundation/auth/
+foundation/
+  src/main/java/.../foundation/http/
+gradle/libs.versions.toml
+settings.gradle
+```
+
+`settings.gradle` include 上述模块。鉴权不是独立层，是 `:biz-foundation` 内的包。
+
+---
+
+## 四、Monorepo 版本（强制）
+
+第三方版本号**只**出现在 `gradle/libs.versions.toml`。模块用 `libs.xxx`。内部模块 `project(':x')`。选哪个版本走 skill `dwy-dependency-choice`。
+
+存量若仍用根 `config.gradle` 的 `ext`，视为同一 catalog，禁止再在子模块写版本。
+
+```toml
+# gradle/libs.versions.toml
+[versions]
+okhttp = "4.12.0"
+
+[libraries]
+okhttp = { module = "com.squareup.okhttp3:okhttp", version.ref = "okhttp" }
+```
+
+```gradle
+// features/orders/build.gradle
+dependencies {
+    implementation project(':biz-foundation')
+    implementation libs.okhttp
+}
+```
+
+禁止 feature 模块 `implementation 'com.squareup.okhttp3:okhttp:4.12.0'`。
+
+---
+
+## 五、检查清单
+
+| 检查项 | 严重 |
+|---|---|
+| 无 `:features` / `:biz-foundation` / `:foundation` 三层模块（新项目） | 高 |
+| Feature `implementation` 另一 Feature 或 `:foundation` 或 `:app` | 高 |
+| Feature 源码 `import` foundation 包名（即使经 `api` 透传） | 高 |
+| 开机链 / 业务编排写在 `:app` 的 Presenter | 高 |
+| 业务 BaseActivity 放在 `:foundation` 或 Feature 里 | 高 |
+| 子模块写死第三方坐标版本 | 高 |
+| `Domain` / `infra` / `core` 当层名 | 中 |

package/templates/ai-tools/rules/Android/dwy-android-mvp.md

@@ -0,0 +1,55 @@
+---
+description: Android 用 MVP 做页面分工；实际架构读当前项目上下文；业务 Base 落在 BizFoundation；简单静态页和确认框允许无 Presenter
+paths:
+  - "**/*.java"
+  - "**/*.kt"
+  - "**/AndroidManifest.xml"
+  - "**/res/**/*.xml"
+---
+
+# Android MVP 与业务 Base
+
+**实际 MVP 架构以当前项目上下文为准。** 本文件只定大行为，不定骨架、类名、目录、库。
+
+写任何页面前必须先读本仓，再动手。读到的继承链、Contract 切法、基类名字、生命周期挂法、包怎么放，全部跟项目。禁止用记忆里的「标准 MVP」覆盖本仓。
+
+模块四层见 `dwy-android-layering`；注释 / 命名 / AppCompat 见 `dwy-android-core`。Support 与 AndroidX 也跟当前项目推断。
+
+---
+
+## 一、写页面前读什么
+
+打开工程后搜并读（命中即按它写）：
+
+- 已有 `*Presenter` / `*View` / `*Contract` / Presenter 基类
+- 业务 `BaseActivity` / `BaseFragment` / `BaseDialog` 的位置与继承链
+- 一页的类怎么摆：同功能包，还是本仓已经横切
+- View 与 Presenter 怎么绑生命周期（attach / 构造传入 / 其它）
+
+新页对齐读到的那套。禁止另起一套。存量不回溯。
+
+新仓还没有任何页面：用下面行为准则写第一页；之后新页对齐第一页，仍不从外部套模板。
+
+---
+
+## 二、行为准则（骨架仍跟项目）
+
+1. **View 管 UI，Presenter（或本仓对等角色）管业务与请求，数据层管读写。** 有业务的页：请求、校验、状态编排不进 Activity。
+2. **Presenter 不碰控件。** 不 `findViewById`，不把 Activity / 控件当字段；需要 Context 走 View 回调。页面销毁后不再调 View。怎么 detach 跟项目。
+3. **简单静态页、确认框、单按钮提示：允许不写 Presenter。** 不造空文件。复杂 Dialog 仍走本仓 MVP。
+4. **业务 Base 给业务扩展。** `BaseActivity` / `BaseFragment` / `BaseDialog` 落在 BizFoundation（未拆四层则本仓已有的 base 包）：本产品壳。Feature 有 Base 之后禁止直接继承框架页。Foundation 不放本产品页面基类。Base 禁止上帝类。
+
+---
+
+## 三、检查清单
+
+| 检查项 | 严重 |
+|---|---|
+| 没读本仓已有 MVP / Base 就按外部模板开写 | 高 |
+| 新页没对齐本仓已有切法 / 命名 / 库 | 高 |
+| 有请求的页在 Activity 里写接口 / 拼业务 | 高 |
+| Presenter（或对等角色）持有控件 / Activity，销毁后仍回调 View | 高 |
+| 已有业务 Base，新页仍直接继承框架页 | 高 |
+| 业务 Base 里出现某 Feature 方法（上帝类） | 高 |
+| Foundation 里放本产品 BaseActivity | 高 |
+| 静态页 / 确认框硬造空 Presenter | 中 |

package/templates/ai-tools/rules/Android/dwy-android-support-only.md

@@ -84,6 +84,8 @@ android.enableJetifier=false
 3. 传递依赖混入 androidx 时,用 `exclude` 排除,并替换为 support 等价物;**无法排除或无 support 等价物 → 换库**,不要将就
 4. **禁止**为使用某个只支持 androidx 的库而引入 androidx —— 一个 androidx 进来就破坏整套隔离,得不偿失
 
+屏幕适配用 AndroidAutoSize（JitPack，Support 兼容线 `1.2.0+`，起点先验 `v1.2.1`，不锁死这个 tag），只按宽度。移动端设计宽 `390`，TV 设计宽 `1280`。禁止改用 `androidx.window` / WindowSizeClass / Compose Adaptive。细则见 `dwy-android-core`「屏幕适配」。
+
 ```groovy
 // 库 foo 的 3.x 已迁 androidx,锁在最后支持 support 的 2.8.0(升级需先整体迁 androidx,见 issue #1234)
 implementation 'com.foo:bar:2.8.0'

package/templates/ai-tools/rules/Docker/dwy-docker.md

@@ -1,5 +1,14 @@
 ---
-description: Docker 通用规则（镜像固定版本、容器内存上限、日志大小限制、配置变更重启姿势）
+description: Docker 通用规则（镜像固定版本、容器内存上限、日志大小限制、配置变更重启姿势）。只在容器和 CI 清单上注入。
+paths:
+  - "**/Dockerfile"
+  - "**/Dockerfile.*"
+  - "**/docker-compose*.yml"
+  - "**/docker-compose*.yaml"
+  - "**/compose.yml"
+  - "**/compose.yaml"
+  - "**/.github/workflows/**"
+  - "**/k8s/**"
 ---
 
 # Docker 通用规则
@@ -32,6 +41,8 @@ image: postgres:16.4
 image: postgres:16.4@sha256:xxxxx
 ```
 
+正例里的版本号只示范具体 tag 的写法。该装哪一个，以当次查到的 tag 列表为准，不从本规则抄数字。
+
 ## 二、Docker 容器配置要求
 
 ### 1. 内存设置
@@ -46,6 +57,8 @@ image: postgres:16.4@sha256:xxxxx
 - **必须**限制单个日志文件大小与轮转文件数量
 - **禁止**不设上限长期写入，避免占满磁盘
 
+具体数字以当次测到的内存占用和日志增速为准。没有实测的新环境才用经验起点，服务跑起来后重测。下面示例只示范字段怎么写。
+
 ### compose 示例
 
 ```yaml
@@ -120,3 +133,12 @@ docker compose exec backend printenv | grep DOLPHINDB_FACTOR__
 ### 一句话
 
 > 配置改了别 restart，`up -d --force-recreate`。验证别只看连通，`printenv` 看容器内真值。
+
+## 四、镜像源
+
+文档和脚本里的镜像站 URL 是当前候选，不是指定赢家。
+
+- 先探测即将真正使用的路径（包索引、发行版 `Release`、镜像 manifest）。超时、证书错误、状态不对、没有目标包或 tag 的源丢掉
+- 在剩下的源里用本次延迟最低的。连通不等于可用
+- 私服、用户指定的源不参与公网竞速
+- 候选全部不成立时另找可用源，再测一次。测速结果不写回本规则

package/templates/ai-tools/rules/Flutter/dwy-flutter-core.md

@@ -125,6 +125,7 @@ class App extends ConsumerWidget {
 
 ```yaml
 # pubspec.yaml
+# 下面的 caret 只示范当时能编过的下限，不是该装的版本。装之前按 dwy-dependency-choice 现查。
 dependencies:
   flutter_riverpod: ^2.6.0
   riverpod_annotation: ^2.6.0
@@ -337,6 +338,7 @@ shared/widgets/               # snake_case
 
 ```yaml
 # pubspec.yaml
+# 版本号是写法示例。装之前按 dwy-dependency-choice 现查，不要抄这里的数字。
 dependencies:
   freezed_annotation: ^2.4.0
   json_annotation: ^4.9.0

package/templates/ai-tools/rules/Flutter/dwy-flutter-testing.md

@@ -72,7 +72,7 @@ testWidgets('登录页面渲染正确', (tester) async {
 
 ## 四、Mock 工具
 
-统一使用 `mocktail`（不是 mockito）：
+统一使用 `mocktail`（不是 mockito）。`^1.0.0` 只示范写法，实际版本按 `dwy-dependency-choice` 现查。
 
 ```yaml
 dev_dependencies:

package/templates/ai-tools/rules/HarmonyOS/dwy-arkts-ui-build.md

@@ -172,10 +172,13 @@ private async safe(name, step) {
 
 ## 9. DevEco 命令行构建（绕开 IDE，拿带 File:行:列 的错误）
 
+路径用本机 DevEco 根，不要抄某台 Mac 的默认安装位置。先找到本机安装目录，再拼 `tools/node/bin/node`、`tools/hvigor/bin/hvigorw.js` 和该布局里的 sdk。找不到就问用户。
+
 ```bash
-NODE=/Applications/DevEco-Studio.app/Contents/tools/node/bin/node
-HVIGOR=/Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw.js
-export DEVECO_SDK_HOME=/Applications/DevEco-Studio.app/Contents/sdk   # 停 daemon 后必设
+# <DEVECO> = 本机 DevEco 根。macOS 默认安装常见 /Applications/DevEco-Studio.app，不是唯一位置。
+NODE=<DEVECO>/Contents/tools/node/bin/node
+HVIGOR=<DEVECO>/Contents/tools/hvigor/bin/hvigorw.js
+export DEVECO_SDK_HOME=<DEVECO>/Contents/sdk   # 停 daemon 后必设
 
 # 配置校验
 $NODE $HVIGOR --sync -p product=default --daemon
@@ -205,14 +208,15 @@ $NODE $HVIGOR --mode module -p module=entry@default -p product=default -p pageTy
 - **正确做法**：DevEco → Project Structure → Signing Configs 自动签名写回工程；**模拟器**可装 unsigned；**真机**必须签名。
 - **适用**：CLI / CI 打包。
 
-## 12. 本地模拟器（HVD）命令行：`-hvd` + hdc `127.0.0.1:5555`
+## 12. 本地模拟器（HVD）命令行：`-hvd` + 本次 `hdc list targets`
 
 - **现象**：不知如何脱离 IDE 起模拟器、装 HAP。
 - **正确做法**：
-  - 启动：`/Applications/DevEco-Studio.app/Contents/tools/emulator/Emulator -hvd "Pura 90"`（名见 `~/.Huawei/Emulator/deployed/*.ini`）。
-  - 设备：`hdc list targets` → 常见 `127.0.0.1:5555`。
-  - 安装：`hdc -t 127.0.0.1:5555 install entry/.../entry-default-unsigned.hap`。
-  - 启动：`hdc -t 127.0.0.1:5555 shell aa start -a EntryAbility -b <bundleName>`。
+  - 模拟器名读 `~/.Huawei/Emulator/deployed/*.ini`，不要写死某一台机型。
+  - 启动：`<DEVECO>/Contents/tools/emulator/Emulator -hvd "<ini 里的名字>"`。`<DEVECO>` 与第 9 节同一台机器的安装根。
+  - 设备：`hdc list targets` 的输出就是 `-t`。`127.0.0.1:5555` 只是本机常见先验，列表里没有就用列表里的那个。
+  - 安装：`hdc -t <本次 target> install entry/.../entry-default-unsigned.hap`。
+  - 启动：`hdc -t <本次 target> shell aa start -a EntryAbility -b <bundleName>`。
 - **适用**：无 GUI / 脚本化调试。
 
 ## 13. 模拟器验不了局域网 TCP / mDNS / 设备发现

package/templates/ai-tools/rules/Python/dwy-python-backend.md

@@ -12,52 +12,11 @@ paths:
 
 ## 一、项目结构与业务聚合（强制）
 
-### 核心原则
+**仓库四层（`app` / `features` / `biz_foundation` / `foundation`）、Feature 互不依赖、uv 根锁定版本 → 见 `dwy-python-layering`。** 本节只约定 Feature **域内**文件名。
 
-**按功能模块（feature / domain）聚合，禁止按技术层散落。** 同一业务功能的 router / schema / service / model / dependency 必须集中在同一个功能目录下；**禁止**全局存在 `routers/` / `services/` / `models/` / `schemas/` 等"技术层"顶级目录，把不相关功能的同类型文件强行揉到一起。
-
-### 为什么
-
-- **跨项目迁移**：复制单个功能目录即可携带该功能全部代码；技术层散落需在 4+ 目录里翻找
-- **可读性**：阅读功能时所有相关代码在同一目录，无需跨目录跳转
-- **变更影响域清晰**：一次改动 diff 集中，code review 更高效
-- **删除友好**：删功能时整个目录删掉即可，不会留下孤儿文件
-
-### 标准结构（参考）
-
-```
-app/
-├── users/                  # 用户功能（一个业务模块自成一个目录）
-│   ├── __init__.py
-│   ├── router.py           # FastAPI 路由
-│   ├── schemas.py          # Pydantic 请求 / 响应模型
-│   ├── service.py          # 业务逻辑
-│   ├── models.py           # ORM 模型
-│   ├── dependencies.py     # 该功能专用 Depends（可选）
-│   └── exceptions.py       # 该功能专用异常（可选）
-├── orders/
-│   ├── router.py
-│   ├── schemas.py
-│   ├── service.py
-│   └── models.py
-├── core/                   # 跨功能共享：配置 / 全局中间件 / 启动逻辑
-│   ├── config.py
-│   ├── middleware.py
-│   └── lifespan.py
-└── main.py                 # 注册各功能 router
-```
-
-### 强制规则
-
-- **禁止**顶级 `routers/` / `services/` / `models/` / `schemas/` 把不同功能的同类文件混放
 - 一个功能目录内文件名固定：`router.py` / `schemas.py` / `service.py` / `models.py`（单数，不带功能前缀）
-- 跨功能真正共享的代码放 `core/` 或 `shared/`，**禁止**为"可能复用"把单一功能逻辑提前抽离
 - 单文件超过约 400 行时再考虑拆分（如 `service.py` → `services/create.py` + `services/query.py`），**禁止**未到规模就预拆分
-- 功能间引用通过明确 import，**禁止**循环依赖
-- 测试镜像功能聚合结构：`tests/users/test_router.py` / `tests/users/test_service.py`（详见第九节）
-
-### 例外
-- 通用基础设施代码（如基础框架库内部）可保持技术层结构
+- 测试镜像功能聚合：`tests/features/orders/test_router.py`（详见第九节）
 
 ---
 
@@ -179,6 +138,7 @@ class UserResponse(UserBase):
 | 分页 page_size | 必须有上限（≤ 100） |
 | 字符串 | 必须显式 `max_length` |
 | 文件上传 | 后端二次校验大小 + magic bytes，**禁止**只信任前端或 Nginx |
+| 图片上传 | 同时校验文件大小和像素宽高上限，防止 decompression bomb |
 
 ---
 
@@ -466,6 +426,7 @@ AI 编写或审查后端代码时，**必须**检查以下违规模式，按严
 |--------|---------|---------|
 | 重复造轮子 | 自造异常基类 / 自封装统一响应 / 散落手写 bcrypt 或 JWT 调用 / 自建 Redis 连接池 等本应走项目级统一模块的能力 | 高 |
 | 技术层散落 | 顶级出现 `routers/` / `services/` / `models/` / `schemas/` 等技术层目录把不同功能文件混放，未按功能聚合 | 高 |
+| 分层依赖 | Feature `from app.` / import 另一 Feature / 源码 `from foundation.`；成员包写死第三方版本。细则见 `dwy-python-layering` | 高 |
 | 测试与源码混放 | 测试文件放在源码目录中（如 `app/users/test_router.py`），未独立到测试目录 | 高 |
 | 密码明文 | `password` 字段出现在 Response Schema | **致命 → STOP** |
 | 密码弱存储 | 使用 MD5 / SHA 而非 bcrypt | **致命 → STOP** |