create-dwy 0.14.2 → 0.14.4

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # create-dwy
 
+## 0.14.4
+
+### Patch Changes
+
+- 将 iOS 规则 `dwy-swift-style.md` 重命名为 `dwy-swift-core.md`，并重构为精简版规范。
+- 新增规则级配置收口约束，要求可配置项统一在 `AppConfig` 管理。
+- 加强国际化规则：默认要求中文/英文支持，统一 `localizationBundle + loc() + LocalizationManager + AppLanguage` 实施要点。
+
+## 0.14.3
+
+### Patch Changes
+
+- 完善 Git 提交相关规范与模板文档，统一提交规则与 AI 署名治理说明。
+- 优化 iOS 规则中图标策略，优先 SF Symbols，缺省使用成熟第三方 SVG 方案。
+- 强化 `dwy-tdd-dev` 与 `dwy-0to1` 流程文档内的提交规范引用方式。
+
 ## 0.14.2
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-dwy",
-  "version": "0.14.2",
+  "version": "0.14.4",
   "description": "项目脚手架与多平台 AI 配置同步工具",
   "type": "module",
   "bin": {

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

@@ -0,0 +1,71 @@
+---
+description: Docker 通用规则（镜像固定版本、容器内存上限、日志大小限制）
+---
+
+# Docker 通用规则
+
+适用于 `Dockerfile`、`docker-compose*.yml`、`compose.yml`、Kubernetes manifest、CI 配置中的所有 `FROM` / `image:` 字段，以及容器资源与日志配置。
+
+## 一、Docker 镜像固定版本
+
+- **必须**使用固定版本 tag
+- **禁止** `latest`
+- **禁止**省略 tag。省略 tag 等同于 `latest`
+- **禁止**浮动 tag：`stable`、`mainline`、`current`、`release`、`lts`、`rolling`、`main`、`master`、`head`、`edge`、`nightly`
+- **禁止**只写环境或发行版 tag：`alpine`、`slim`、`bookworm`、`bullseye`、`buster`、`jammy`、`focal`、`noble`、`trixie`
+- 数据库、缓存、网关、消息队列等关键基础设施，优先固定到 `tag@sha256:...`
+
+### 正反例
+
+```dockerfile
+# 反例
+FROM nginx:latest
+FROM python
+image: redis:7
+image: postgres:bookworm
+
+# 正例
+FROM nginx:1.26.2
+FROM python:3.12.10-slim
+image: redis:7.4.2
+image: postgres:16.4
+image: postgres:16.4@sha256:xxxxx
+```
+
+## 二、Docker 容器配置要求
+
+### 1. 内存设置
+
+- 每一个容器**必须**设置最大可用内存
+- 与 Redis 配合使用时，容器最大可用内存**必须大于** Redis 的 `maxmemory`
+- **禁止**容器无限制使用宿主机内存
+
+### 2. 日志设置
+
+- Docker 日志**必须**设置最大使用量
+- **必须**限制单个日志文件大小与轮转文件数量
+- **禁止**不设上限长期写入，避免占满磁盘
+
+### compose 示例
+
+```yaml
+services:
+  app:
+    image: myapp:1.2.3
+    mem_limit: 512m
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  redis:
+    image: redis:7.4.2
+    command: ["redis-server", "--maxmemory", "256mb", "--maxmemory-policy", "allkeys-lru"]
+    mem_limit: 384m
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+```

package/templates/ai-tools/rules/iOS/dwy-swift-core.md

@@ -0,0 +1,75 @@
+---
+description: iOS 17+ SwiftUI 开发基线规则（全局适配、动画、国际化、注释）
+paths:
+  - "**/*.swift"
+---
+
+## iOS 目标与写法
+
+- iOS 最低版本 17.0+，不为 16 及以下做兼容分支。
+- 统一 Observation + `@MainActor`，状态对象默认 `final class`。
+
+```swift
+@MainActor
+@Observable
+final class TaskListViewModel {}
+```
+
+## 风格
+
+- 4 空格缩进，不用 Tab。
+- `UpperCamelCase` / `lowerCamelCase`。
+- 参数过长换行，类型签名参数与返回值各占一行。
+- 一行只做一件事，避免压缩表达式。
+
+## 配置管理
+
+- 可修改的运行时配置统一放在 `AppConfig`，避免业务层散落魔法值和可调参数。
+- 默认实现必须只有一个 `AppConfig` 入口，所有配置项、开关、阈值和默认值从这里读取。
+- 配置读取禁止越界分散；新参数先加到 `AppConfig`，再注入到业务逻辑。
+- `AppConfig` 负责默认值、持久化键名、配置来源边界，业务层只读使用。
+
+## 注释与控制流
+
+- 关键类型、方法、属性必有中文 `///` 注释，写明意图和边界。
+- 系统外边界校验，内部调用信任类型，不加冗余兜底。
+- 统一 `guard` + early return，不要多层 `else`。
+- 禁止 `try?` 吞异常；不写无意义 `value ?? default`。
+
+## 全面屏与布局
+
+- 默认尊重安全区；固定内容区用 `safeAreaInset` / `safeAreaPadding`。
+- 全屏背景、遮罩、弹层可用 `ignoresSafeArea()`。
+- 禁止使用固定状态栏高度常量。
+
+## 动效
+
+- 默认优先 `spring`，用同一组参数避免风格撕裂。
+
+```swift
+private let motionSpring = Animation.spring(response: 0.5, dampingFraction: 0.75)
+```
+
+## 图标与文案
+
+- 图标优先 `Image(systemName:)`，无符号则用成熟 SVG。
+- 文案禁止 emoji，禁止硬编码，统一 `loc("key")`。
+- 禁止使用 emoji 作为功能说明、状态、提示。
+
+```swift
+Image(systemName: "chevron.right")
+Text(loc("home_title"))
+```
+
+## 国际化
+
+- 项目必须实现国际化。
+- 默认实现必须包含中文和英文。
+- 使用 `localizationBundle + loc()` + `LocalizationManager` + `AppLanguage` 组合。
+- `loc` 必须走 bundle，不依赖默认 locale 自动解析 key。
+- 语言变更持久化并刷新 `localizationBundle`，`system` 走系统首选。
+
+## 资源与时序
+
+- 颜色、字号走 token，不用裸值。
+- 时间来源通过注入参数或测试可控入口，不直接散落 `Date()`。

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

@@ -0,0 +1,153 @@
+---
+description: Git Commit 规范（提交安全、敏感扫描、Scope、消息规范、AI 署名治理）
+---
+
+# Git Commit 规范（强制）
+
+## 1. 适用范围
+
+适用于所有 Git 提交流程，覆盖：
+
+- `git add`
+- `git commit`
+- 为提交生成或校验 commit message 的场景
+
+任一步骤不通过：中止当前提交流交付流程。
+
+## 2. 执行顺序（硬约束）
+
+1. 安全写法检查
+2. Stage 级敏感扫描
+3. 变更范围确认
+4. Scope 与 message 格式校验
+5. AI 署名与生成声明校验
+
+## 3. 安全写法（命令注入防护）
+
+`git commit -m "..."` 会对双引号内内容做 shell 展开。出现反引号或 `$(...)` 时，禁止直接使用双引号形式。
+
+### 3.1 推荐：消息文件提交（优先）
+
+```bash
+git commit -F /tmp/commit-msg.txt
+```
+
+```bash
+cat > /tmp/commit-msg.txt <<'EOF'
+feat: 示例提交说明
+
+- 修改点 A
+- 修改点 B
+EOF
+git commit -F /tmp/commit-msg.txt
+```
+
+### 3.2 允许：单引号提交
+
+```bash
+git commit -m 'feat: 支持 runConcurrent'
+```
+
+前提：message 内无单引号字符。
+
+### 3.3 禁止：双引号直接携带反引号
+
+```bash
+git commit -m "feat: run `build-tool`"
+```
+
+上例存在命令替换风险。
+
+### 3.4 兜底：转义（不推荐）
+
+```bash
+git commit -m "feat: run \`build-tool\`"
+```
+
+## 4. Stage 级敏感扫描（强制）
+
+同时扫描：
+- `git diff --cached`
+- `git diff --cached --name-only`
+
+### 4.1 禁止提交文件
+
+`.env*`、`*.pem`、`*.key`、`*.p12`、`*.pfx`、`*.jks`、`*.keystore`、`*.sql`（真实数据）、`*.dump`、`*.sqlite`、`*.xlsx`、`*.csv`（敏感表）、`*.log`、`pgdata/`、`cache/*.json`。
+
+### 4.2 禁止内容片段（示例）
+
+`sk-` 开头 API Key、`AKIA` 开头 AWS Key、`ghp_` GitHub Token、`password=...`、`token=...`、`secret=...`、明文数据库连接串、私钥头、`IP:端口`、`ssh user@ip`。
+
+### 4.3 例外
+
+`.env.example`、环境变量读取方式、`localhost`/`127.0.0.1` 示例连接串可保留。
+
+### 4.4 处理失败
+
+1. 立即停止。
+2. 输出 `文件名:行号:命中片段`。
+3. 给出修复建议（`.gitignore`、改环境变量、替换占位符）。
+4. 用户确认后继续；用户强制提交时，message body 追加：
+   - `GIT-SECURITY: 用户已确认提交此内容`
+
+## 5. 变更范围与提交拆分
+
+先执行 `git diff --cached`，明确：修改了哪些模块、影响边界、是否一次可归因。
+
+若单条 message 无法在 `subject` 中清晰表达，必须拆分 commit。
+
+## 6. Commit Scope
+
+Scope 由 AI 根据变更模块与项目语义自行决定，保持与现有提交习惯一致且可读。
+
+- 单模块改动：优先加 scope，名称贴近主改动模块（如 `eui` / `backend` / `cli` 等）。
+- 跨模块改动：可不带 scope。
+- 无法稳定归类：短期使用无 scope，避免强行造新约束。
+
+## 7. Commit Message 规则
+
+格式：
+
+`<type>(<scope>): <subject>`
+
+或
+
+`<type>: <subject>`
+
+或
+
+`<type>!: <subject>`
+
+或
+
+`<type>(<scope>)!: <subject>`
+
+`type` 限定为：`feat`、`fix`、`refactor`、`chore`、`docs`、`test`、`perf`、`style`、`ci`。
+
+`subject` 规则：
+
+- 中文、动宾短语。
+- ≤72 字符。
+- 不用句号、不用“了”。
+- 不得含 emoji。
+- 可选 body 仅说明 why，不要复述 what。
+- 破坏性变更：`feat!:` / `fix!:`（带 scope 时写成 `feat(<scope>)!:` / `fix(<scope>)!:`） + `BREAKING CHANGE: ...`
+
+## 8. AI 署名与生成声明治理
+
+commit 的 subject、body、footer、trailer 中禁止出现：
+
+- `Co-Authored-By: Claude ...`
+- `Generated with Claude Code`
+- `Generated with ...`
+- `Claude`、`ChatGPT`、`GPT`、`Copilot`、`Cursor`、`AI`、`LLM`
+- `noreply@anthropic.com`、`noreply@openai.com`
+
+`git commit -m "..."` 不得附带 AI 署名 trailer。
+
+## 9. 参考示例
+
+- `feat(eui): 添加 Image 组件懒加载支持`
+- `refactor(backend): 提取分页逻辑为共享工具`
+- `fix(eui)!: 重构 EDialog open 属性为 v-model:open`
+  - `BREAKING CHANGE: EDialog 不再接受 visible 属性，请改用 v-model:open`

package/templates/ai-tools/rules//346/225/260/346/215/256/345/272/223/dwy-postgres.md

@@ -14,6 +14,8 @@ description: PostgreSQL 安全与配置规范（参数化查询、应用用户
 |------|------|
 | 参数化查询 | **禁止**字符串拼接 SQL（用 ORM 或 `text(... :param)` 参数绑定） |
 | 应用用户权限 | 只授予 SELECT / INSERT / UPDATE / DELETE，**不给** DROP / CREATE / ALTER / SUPERUSER |
+| 端口暴露 | **禁止**将 `5432` 直接暴露到公网；仅允许 VPC / 内网 / 跳板机访问 |
+| 运行权限 | PostgreSQL 服务进程**禁止**以 `root` 用户运行，必须使用专用低权限系统用户 |
 | 连接池 | `pool_size ≤ 20`，`max_overflow ≤ 10` |
 | SSL 连接 | 生产环境启用 `sslmode=require` |
 | 敏感字段加密 | 身份证号 / 银行卡 / 手机号原文等使用 AES 加密**存储**，不仅展示脱敏 |
@@ -25,6 +27,8 @@ description: PostgreSQL 安全与配置规范（参数化查询、应用用户
 
 生产环境**禁止**使用 `postgres` 超级用户跑应用；为每个应用创建独立用户，授权严格限定到 DML。
 
+数据库服务自身也**禁止**由 `root` 直接启动或托管，统一使用 `postgres` 或发行版默认专用系统账号运行。
+
 ```sql
 -- 创建应用专用用户（非超级用户）
 CREATE USER app_user WITH PASSWORD 'strong_password';
@@ -83,6 +87,8 @@ ALTER DEFAULT PRIVILEGES IN SCHEMA public
 | SQL 拼接 | f-string / `%` / 字符串相加构造 SQL | **致命 → STOP** |
 | 应用用户超权 | 应用账号拥有 DROP / CREATE / ALTER / SUPERUSER | **致命 → STOP** |
 | 超级用户跑应用 | 应用以 `postgres` 或其他超级用户身份连接 | **致命 → STOP** |
+| 公网开放 5432 | 安全组 / 防火墙 / LB 允许公网直连 PostgreSQL 端口 | **致命 → STOP** |
+| root 运行数据库 | PostgreSQL 服务进程以 `root` 身份运行 | **致命 → STOP** |
 | 连接池超限 | `pool_size > 20` 或 `max_overflow > 10` | 高 |
 | 无 SSL | 生产环境连接串无 `sslmode=require` | 高 |
 | 敏感字段明文 | 身份证 / 银行卡等明文落库 | 高 |

package/templates/ai-tools/rules//346/225/260/346/215/256/345/272/223/dwy-redis.md

@@ -21,15 +21,18 @@ description: Redis 安全与使用规范（必须用 dwyeapi 客户端、密码
 | 规则 | 说明 |
 |------|------|
 | 认证 | **必须**设置 `requirepass`，无密码 Redis 一律拒绝接入生产 |
-| 绑定地址 | `bind 127.0.0.1` 或内网地址，**禁止** `bind 0.0.0.0` |
+| 绑定地址 | `bind 127.0.0.1` 或内网地址，**禁止** `bind 0.0.0.0`，**禁止**通过安全组 / 防火墙 / LB 直接暴露 `6379` 到公网 |
+| 运行权限 | Redis 进程**禁止**以 `root` 用户运行，必须使用专用低权限用户 |
 | 危险命令 | **禁用**或重命名 `FLUSHALL` / `FLUSHDB` / `CONFIG` / `KEYS` / `DEBUG` |
-| 内存上限 | 设 `maxmemory` 与 `maxmemory-policy`（推荐 `allkeys-lru`），防止 OOM |
+| 内存上限 | Redis 运行**必须**显式设置 `maxmemory` 与 `maxmemory-policy`（推荐 `allkeys-lru`），防止缓存无限膨胀或 OOM |
 | 持久化 | 根据用途选择：缓存可关 AOF；会话 / 黑名单需 AOF everysec |
 
 ```conf
 # redis.conf 关键项示例
 requirepass <strong-password>
 bind 127.0.0.1
+port 6379
+maxclients 10000
 rename-command FLUSHALL ""
 rename-command FLUSHDB ""
 rename-command CONFIG ""
@@ -39,6 +42,12 @@ maxmemory 256mb
 maxmemory-policy allkeys-lru
 ```
 
+```ini
+# systemd/service 示例
+User=redis
+Group=redis
+```
+
 ---
 
 ## 三、Key 设计规范（强制）
@@ -79,10 +88,13 @@ await redis.set("myapp:cache:user:uuid:f7e2", json_data, ex=300)
 | 检查项 | 违规模式 | 严重程度 |
 |--------|---------|---------|
 | 绑定 0.0.0.0 | 服务对公网暴露 | **致命 → STOP** |
+| 公网开放 6379 | 安全组 / 防火墙 / LB 允许公网直连 Redis 端口 | **致命 → STOP** |
 | 无密码 | 生产 Redis 未设 `requirepass` | **致命 → STOP** |
+| root 运行 | Redis 进程以 `root` 身份启动 | **致命 → STOP** |
 | 存敏感原文 | 密码 / 身份证 / token 明文存 Redis | **致命 → STOP** |
 | 自建连接池 | 业务代码 `aioredis.from_url(...)`，未走 dwyeapi 缓存模块 | 高 |
 | 危险命令未禁 | `FLUSHALL` / `KEYS` / `CONFIG` 等可在生产执行 | 高 |
+| 未设 `maxmemory` | Redis 未设置缓存最大可用内存或未配置淘汰策略 | **致命 → STOP** |
 | Key 无 TTL | `redis.set()` 没有 `ex` 参数（业务上明确永久存储除外） | 中 |
 | Key 无前缀 | Key 无项目前缀，污染共享 Redis | 中 |
 | Pub/Sub 当队列 | 业务关键消息走 Pub/Sub | 高 |

package/templates/ai-tools/skills//{350/277/220/347/273/264/345/217/221/345/270/203 → 345/256/211/345/205/250}/dwy-deploy-audit/SKILL.md

@@ -26,6 +26,7 @@ description: "部署后线上环境基础安全巡检：远程 SSH 到目标服
 | `references/checks-network.md` | 即将运行 4.1 / 4.2 / 4.4 / 4.7 类检查或解读其输出时 | SSH / Nginx / HTTPS / 依赖服务连通性 |
 | `references/checks-data.md` | 即将运行 4.3 / 4.5 / 4.11 类检查或解读其输出时 | 数据库暴露 / 环境变量 / 凭证强度 |
 | `references/checks-runtime.md` | 即将运行 4.6 / 4.8 / 4.9 / 4.10 类检查或解读其输出时 | Docker / 自愈 / 日志防爆 / 资源推荐 |
+| `references/security-doc-search.md` | 本地 checks 不够判定、需要查官方安全文档、需要按版本追 CVE、或需要把新规则沉淀回 skill 时 | 权威文档检索策略 / 官方来源清单 / 沉淀规则 |
 
 ---
 
@@ -46,12 +47,13 @@ description: "部署后线上环境基础安全巡检：远程 SSH 到目标服
 1. 收集目标信息  → 确认 SSH 连接、目标服务范围
 2. 连通性测试    → SSH 登录、sudo 权限确认
 3. 基础环境识别  → 系统版本、已部署服务清单
-4. 分类检查      → SSH / Nginx / DB / HTTPS / Env / Docker / Services / Resilience / Logs / Capacity / Secrets(主 Bash 调用 run_all.sh,12 路并行)
-5. 生成报告      → 按等级聚合,Markdown 格式
-6. 修复建议      → 每条问题给出修复方向(不执行)
+4. 权威文档检索  → 必要时查官方文档 / CVE / OWASP,补足判定依据
+5. 分类检查      → SSH / Nginx / DB / HTTPS / Env / Docker / Services / Resilience / Logs / Capacity / Secrets(主 Bash 调用 run_all.sh,12 路并行)
+6. 生成报告      → 按等级聚合,Markdown 格式
+7. 修复建议      → 每条问题给出修复方向(不执行)
 ```
 
-**共 6 步，按顺序执行。**
+**共 7 步，按顺序执行。**
 
 ---
 
@@ -115,7 +117,44 @@ ssh ${TARGET} "
 
 ---
 
-## Step 4: 分类检查（并行执行）
+## Step 4: 权威文档检索（必要时执行）
+
+当出现以下任一情况，**先读** `references/security-doc-search.md`，再用 WebSearch / 官方站点检索：
+
+1. `references/checks-*.md` 里只有抽象规则，没有给出当前版本依据
+2. audit 输出出现了明确版本号，需要判断是否存在已知高危 CVE
+3. 配置项语义、默认值、版本门槛不确定
+4. 用户明确要求“按官方安全文档”解释
+5. 本次发现适合沉淀回长期规则
+
+### 强制来源顺序
+
+1. 官方产品文档 / 官方 security 页面
+2. 官方 release notes / advisories
+3. CISA KEV / NVD / CVE
+4. OWASP Cheat Sheet
+
+**禁止**把论坛、博客、AI 聚合页当唯一依据。
+
+### 强制检索输出
+
+每次外部检索至少产出 3 个字段：
+
+| 字段 | 说明 |
+|------|------|
+| `source` | 权威来源 URL |
+| `claim` | 从文档得到的明确结论 |
+| `impact` | 这条结论如何影响本次分级 / 判定 / 修复建议 |
+
+### 需要沉淀时怎么做
+
+- 可复用的配置语义 / 检查基线 → 回写对应 `references/checks-*.md`
+- 可复用的检索方法 / 来源入口 → 回写 `references/security-doc-search.md`
+- 单次版本漏洞情报 → 只写进本次报告,不固化成长期规则
+
+---
+
+## Step 5: 分类检查（并行执行）
 
 **主 Claude 直接用 Bash 调用 `run_all.sh`,12 路并行跑完全部检查类目**,把原始输出落到 `/tmp/dwy_audit_<host>.txt`,再由主 Claude `Read` 文件后做分析。
 
@@ -251,7 +290,7 @@ bash {scripts}/check_db.sh <target> [ssh_opts...]
 
 ---
 
-## Step 5: 生成报告
+## Step 6: 生成报告
 
 报告必须为 Markdown 格式,**核心是"完整检查清单 + 状态可视化"** — 让用户一眼看到"检查了哪些 / 通过哪些 / 失败哪些 / 跳过哪些 / 未覆盖哪些"。
 
@@ -441,7 +480,7 @@ bash {scripts}/check_db.sh <target> [ssh_opts...]
 
 ---
 
-## Step 6: 修复建议(只输出,不执行)
+## Step 7: 修复建议(只输出,不执行)
 
 **严格禁止：**
 
@@ -455,6 +494,7 @@ bash {scripts}/check_db.sh <target> [ssh_opts...]
 - 在报告中给出修复命令片段(供用户复制)
 - 解释修复后的影响和验证方法
 - 推荐修复优先级
+- 给出本次实际引用过的权威文档 URL
 
 ---
 

package/templates/ai-tools/skills//{350/277/220/347/273/264/345/217/221/345/270/203 → 345/256/211/345/205/250}/dwy-deploy-audit/references/checks-data.md

@@ -35,6 +35,17 @@
 | `rename-command` | 危险命令(FLUSHALL/CONFIG)已重命名 | medium |
 | Redis 版本 | 非已知 CVE 版本 | medium |
 
+**Redis 版本判定补充：**
+
+- 配置语义先看官方安全文档：`https://redis.io/docs/latest/operate/oss_and_stack/management/security/`
+- 版本安全再搜：`redis <version> CVE`、`redis <version> security advisory`
+- 优先来源：Redis 官方、NVD、CISA KEV
+- 分级规则：
+  - Redis 外网暴露 + 命中高危 CVE / KEV → **critical**
+  - Redis 仅内网暴露，但命中高危 CVE → high
+  - 未命中高危 CVE，但版本明显偏旧且无安全维护依据 → medium
+- 如 `bind`、`protected-mode`、公网暴露本身已不合规，按对应配置项分级；不要把“版本风险”和“暴露风险”混成一条。
+
 ---
 
 ## 4.5 环境变量 / 文件权限 — `{scripts}/check_env.sh`

package/templates/ai-tools/skills//{350/277/220/347/273/264/345/217/221/345/270/203 → 345/256/211/345/205/250}/dwy-deploy-audit/references/checks-network.md

@@ -49,6 +49,20 @@
 | 暴露的 location | 排查 `/.git`、`/.env`、`/admin` 是否泄漏 | **critical** |
 | Nginx 版本 | 非已知 CVE 版本 | medium |
 
+**Nginx 版本判定补充：**
+
+- 先查官方配置语义：
+  - headers 模块：`https://nginx.org/en/docs/http/ngx_http_headers_module.html`
+  - SSL 模块：`https://nginx.org/en/docs/http/ngx_http_ssl_module.html`
+- 再查版本安全：
+  - 搜索词：`nginx <version> security advisory`、`nginx <version> CVE`
+  - 优先来源：Nginx 官方公告、NVD、CISA KEV
+- 分级规则：
+  - 命中 **CISA KEV** 或存在明确在野利用记录 → **critical**
+  - 命中高危 CVE（建议按 CVSS ≥ 7.0 参考），但未见在野利用 → high
+  - 未命中高危 CVE，但版本明显老旧且缺少后续安全修复依据 → medium
+- 如果只是配置项（如 `ssl_protocols`、`ssl_stapling`、`add_header ... always`）语义不清，不按“版本风险”报，改为引用官方模块文档解释配置风险。
+
 ---
 
 ## 4.4 HTTPS 证书 — `{scripts}/check_https.sh`

package/templates/ai-tools/skills//{350/277/220/347/273/264/345/217/221/345/270/203 → 345/256/211/345/205/250}/dwy-deploy-audit/references/checks-runtime.md

@@ -34,6 +34,22 @@
 | **daemon `registry-mirrors`**(时区在 PRC 时) | 至少 1 个国内源(daocloud / aliyun / ustc / tsinghua) | high(PRC 无配置)/ info(境外) |
 | **运行容器使用境外 registry**(`gcr.io` `ghcr.io` `k8s.gcr.io` `quay.io` `mcr.microsoft.com` `nvcr.io` `docker.elastic.co`)且时区在 PRC | 改用 `<registry>.m.daocloud.io` 前缀(`registry-mirrors` **不**对它们生效) | high |
 
+**Docker 版本与暴露面判定补充：**
+
+- 官方基础文档：
+  - Engine security：`https://docs.docker.com/engine/security/`
+  - daemon remote access：`https://docs.docker.com/engine/daemon/remote-access/`
+  - logging driver：`https://docs.docker.com/engine/logging/configure/`
+  - OWASP Docker Security Cheat Sheet：`https://cheatsheetseries.owasp.org/cheatsheets/Docker_Security_Cheat_Sheet.html`
+- 版本安全搜索词：
+  - `docker engine <version> CVE`
+  - `docker <version> security advisory`
+- 分级规则：
+  - 命中 **CISA KEV**，或 Docker daemon TCP 端口公网暴露且无充分保护 → **critical**
+  - 命中高危 CVE（建议按 CVSS ≥ 7.0 参考），但当前未见在野利用 → high
+  - 未命中高危 CVE，但版本过旧且缺少持续维护依据 → medium
+- `docker.sock` 挂载、`--privileged`、2375/2376 暴露属于**配置暴露面**，优先按当前表里的配置项分级，不要被“版本没问题”掩盖。
+
 ---
 
 ## 4.8 自愈与资源耗尽防护 — `{scripts}/check_resilience.sh`