create-dwy 0.17.0 → 0.18.0

package/src/sync-packs.js

@@ -0,0 +1,191 @@
+/**
+ * 按包勾选的包目录：技术栈包 + 场景包。
+ * 展开结果写入现有 skills/rules/hooks 选择，不改平台 sync 的按名增删。
+ * 条目按扫描结果的 category / name 匹配，模板里不存在的名字直接跳过。
+ */
+
+/** 技术栈包（含通用）。第一屏只出这些。 */
+export const STACK_PACKS = [
+  {
+    id: 'common',
+    label: '通用',
+    description: '开发流程 rules、Git hooks、跨栈 skill（dwy-shared / semver / 流程文档）',
+    ruleCategories: ['开发流程'],
+    hookCategories: ['Git'],
+    skillCategories: ['元工具', '开发流程'],
+    skillNames: ['dwy-semver'],
+  },
+  {
+    id: 'vue',
+    label: 'Vue',
+    description: 'Vue rules + dwy-eui / dwy-ekit / 全栈脚手架',
+    ruleCategories: ['Vue'],
+    skillNames: ['dwy-eui', 'dwy-ekit', 'dwy-fullstack-scaffold'],
+  },
+  {
+    id: 'python',
+    label: 'Python',
+    description: 'Python rules + dwy-eapi / 全栈脚手架',
+    ruleCategories: ['Python'],
+    skillNames: ['dwy-eapi', 'dwy-fullstack-scaffold'],
+  },
+  {
+    id: 'ios',
+    label: 'iOS',
+    description: 'iOS / Swift rules。上架 skill 在场景包「发布发版」',
+    ruleCategories: ['iOS'],
+  },
+  {
+    id: 'android',
+    label: 'Android',
+    description: 'Android rules',
+    ruleCategories: ['Android'],
+  },
+  {
+    id: 'flutter',
+    label: 'Flutter',
+    description: 'Flutter rules',
+    ruleCategories: ['Flutter'],
+  },
+  {
+    id: 'harmony',
+    label: 'HarmonyOS',
+    description: 'HarmonyOS / ArkTS rules',
+    ruleCategories: ['HarmonyOS'],
+  },
+  {
+    id: 'docker',
+    label: 'Docker / 运维',
+    description: 'Docker rule + 镜像/部署 skill',
+    ruleCategories: ['Docker'],
+    skillCategories: ['运维发布'],
+  },
+  {
+    id: 'database',
+    label: '数据库',
+    description: 'Postgres / Redis / 迁移 rules。DolphinDB skill 在场景包',
+    ruleCategories: ['数据库'],
+  },
+]
+
+/** 场景包。第二屏单独问，允许全不选。 */
+export const SCENE_PACKS = [
+  {
+    id: 'product-0to1',
+    label: '产品0到1',
+    description: '立项到上线的阶段 skill（launcher / PRD / 架构 / TDD…）',
+    skillCategories: ['产品0到1'],
+  },
+  {
+    id: 'media',
+    label: '自媒体',
+    description: '单位圆自媒体流水线 + 豆包配音',
+    skillCategories: ['自媒体'],
+  },
+  {
+    id: 'release',
+    label: '发布发版',
+    description: 'dwy-publish / App Store / SDK 检查 / semver / GitHub Action',
+    skillCategories: ['发布发版'],
+  },
+  {
+    id: 'security',
+    label: '安全',
+    description: '部署巡检与白帽渗透',
+    skillCategories: ['安全'],
+  },
+  {
+    id: 'article',
+    label: '内容创作',
+    description: '技术文章写作 skill',
+    skillCategories: ['内容创作'],
+  },
+  {
+    id: 'dolphindb',
+    label: 'DolphinDB',
+    description: 'DolphinDB 开发与审查 skill（体量大，不跟数据库栈绑定）',
+    skillNames: ['dwy-dolphindb'],
+  },
+]
+
+const STACK_IDS = new Set(STACK_PACKS.map(pack => pack.id))
+const SCENE_IDS = new Set(SCENE_PACKS.map(pack => pack.id))
+
+/**
+ * 规范化 sync-state 里的 packs。未知 id 丢弃，避免旧状态撑爆交互默认勾选。
+ *
+ * @param {{ stacks?: string[], scenes?: string[] } | null | undefined} raw
+ */
+export function normalizePacks(raw) {
+  return {
+    stacks: [...new Set((raw?.stacks || []).filter(id => STACK_IDS.has(id)))],
+    scenes: [...new Set((raw?.scenes || []).filter(id => SCENE_IDS.has(id)))],
+  }
+}
+
+/**
+ * 判断扫描项是否属于某个包。
+ * 约束：只看本类型对应的 category / 显式名字，避免 skill 目录名误伤 rules。
+ *
+ * @param {{ name: string, category?: string }} item
+ * @param {object} pack
+ * @param {'skills' | 'rules' | 'hooks'} type
+ */
+function itemInPack(item, pack, type) {
+  if (type === 'skills') {
+    if ((pack.skillNames || []).includes(item.name)) return true
+    return (pack.skillCategories || []).includes(item.category)
+  }
+  if (type === 'rules') return (pack.ruleCategories || []).includes(item.category)
+  return (pack.hookCategories || []).includes(item.category)
+}
+
+/**
+ * 按名字去重合并，保持扫描原序。
+ *
+ * @param {Array<{ name: string }>} items
+ */
+function uniqueByName(items) {
+  const seen = new Set()
+  const result = []
+  for (const item of items) {
+    if (seen.has(item.name)) continue
+    seen.add(item.name)
+    result.push(item)
+  }
+  return result
+}
+
+/**
+ * 把已选栈 + 场景包展开成 sync 用的条目。
+ * skillsOnly 时 rules/hooks 必须空数组，调用方不得据此删除项目已有项。
+ *
+ * @param {{ skills: object[], rules: object[], commands?: object[], hooks: object[] }} scans
+ * @param {{ stacks?: string[], scenes?: string[], skillsOnly?: boolean }} selection
+ */
+export function expandPackSelection(scans, { stacks = [], scenes = [], skillsOnly = false } = {}) {
+  const packById = new Map([...STACK_PACKS, ...SCENE_PACKS].map(pack => [pack.id, pack]))
+  const selectedPacks = [...stacks, ...scenes]
+    .map(id => packById.get(id))
+    .filter(Boolean)
+
+  const pick = (type) => uniqueByName(
+    selectedPacks.flatMap(pack => (scans[type] || []).filter(item => itemInPack(item, pack, type))),
+  )
+
+  if (skillsOnly) {
+    return {
+      skills: pick('skills'),
+      rules: [],
+      commands: [],
+      hooks: [],
+    }
+  }
+
+  return {
+    skills: pick('skills'),
+    rules: pick('rules'),
+    commands: [],
+    hooks: pick('hooks'),
+  }
+}

package/src/sync-scene.js

@@ -0,0 +1,146 @@
+/**
+ * 按包勾选交互：技术栈包 → 场景包 → 确认/微调。
+ * 由 dwy / dwy sync 在「按技术栈 / 场景包」模式下调用。
+ */
+
+import { isCancel } from '@clack/prompts'
+import { SEARCH_PLACEHOLDER, searchableMultiselect, searchableSelect } from './searchable-select.js'
+import { SCENE_PACKS, STACK_PACKS, expandPackSelection, normalizePacks } from './sync-packs.js'
+import { promptSelection } from './sync.js'
+import { chalk } from './utils.js'
+
+/**
+ * 把包目录转成可搜索选项。
+ *
+ * @param {Array<{ id: string, label: string, description: string }>} packs
+ */
+function packOptions(packs) {
+  return packs.map(pack => ({
+    value: pack.id,
+    label: pack.label,
+    description: pack.description,
+  }))
+}
+
+/**
+ * 打印包展开条数。确认步默认用这些预选项，微调再加减。
+ *
+ * @param {string[]} stacks
+ * @param {string[]} scenes
+ * @param {{ skills: object[], rules: object[], hooks: object[] }} selected
+ */
+function printPackSummary(stacks, scenes, selected) {
+  const stackLabels = STACK_PACKS.filter(pack => stacks.includes(pack.id)).map(pack => pack.label)
+  const sceneLabels = SCENE_PACKS.filter(pack => scenes.includes(pack.id)).map(pack => pack.label)
+  const packText = [...stackLabels, ...sceneLabels].join(' + ') || '（未选包）'
+  console.log(chalk.gray('\n包展开：'))
+  console.log(chalk.gray(`  ${packText}`))
+  console.log(chalk.gray(`  Skills ${selected.skills.length}  Rules ${selected.rules.length}  Hooks ${selected.hooks.length}`))
+}
+
+/**
+ * 按包选择条目。
+ * 返回 { skills, rules, commands, hooks, packs } 或 null（取消）。
+ *
+ * @param {object} scans
+ * @param {{ packs?: { stacks?: string[], scenes?: string[] } }} syncState
+ * @param {{ skillsOnly?: boolean }} [opts]
+ */
+export async function interactiveSelectByPacks(scans, syncState, { skillsOnly = false } = {}) {
+  const previous = normalizePacks(syncState?.packs)
+  let stacks = previous.stacks.length > 0 ? previous.stacks : ['common']
+  let scenes = previous.scenes
+  let step = 'stacks'
+  /** 微调后的展开结果；返回改包时丢弃，重新 expand。 */
+  let selected = null
+
+  while (true) {
+    if (step === 'stacks') {
+      const result = await searchableMultiselect({
+        message: '选择技术栈（通用默认勾选）',
+        options: packOptions(STACK_PACKS),
+        initialValues: stacks,
+        required: true,
+        maxItems: 12,
+        placeholder: SEARCH_PLACEHOLDER,
+      })
+      if (isCancel(result)) return null
+      stacks = result
+      selected = null
+
+      const nav = await searchableSelect({
+        message: `已选 ${stacks.length} 个技术栈。下一步：`,
+        options: [
+          { label: '继续选场景包', value: 'next' },
+          { label: '返回重选技术栈', value: 'back' },
+          { label: '取消同步', value: 'cancel' },
+        ],
+        initialValue: 'next',
+        placeholder: SEARCH_PLACEHOLDER,
+      })
+      if (isCancel(nav) || nav === 'cancel') return null
+      step = nav === 'back' ? 'stacks' : 'scenes'
+      continue
+    }
+
+    if (step === 'scenes') {
+      const result = await searchableMultiselect({
+        message: '选择场景包（可全不选）',
+        options: packOptions(SCENE_PACKS),
+        initialValues: scenes,
+        required: false,
+        maxItems: 10,
+        placeholder: SEARCH_PLACEHOLDER,
+      })
+      if (isCancel(result)) return null
+      scenes = result
+      selected = null
+      step = 'confirm'
+      continue
+    }
+
+    selected = selected || expandPackSelection(scans, { stacks, scenes, skillsOnly })
+    printPackSummary(stacks, scenes, selected)
+
+    const confirmOptions = [
+      { label: '确认提交（用上面勾好的）', value: 'confirm' },
+      { label: '微调 Skills（可加减）', value: 'skills' },
+      ...(!skillsOnly ? [
+        { label: '微调 Rules（可加减）', value: 'rules' },
+        { label: '微调 Hooks（可加减）', value: 'hooks' },
+      ] : []),
+      { label: '返回改技术栈', value: 'stacks' },
+      { label: '返回改场景包', value: 'scenes' },
+      { label: '取消同步', value: 'cancel' },
+    ]
+    const final = await searchableSelect({
+      message: '包已帮你勾好。确认提交，或微调加减条目：',
+      options: confirmOptions,
+      initialValue: 'confirm',
+      placeholder: SEARCH_PLACEHOLDER,
+    })
+    if (isCancel(final) || final === 'cancel') return null
+    if (final === 'confirm') {
+      return {
+        ...selected,
+        commands: [],
+        packs: { stacks, scenes },
+      }
+    }
+    if (final === 'stacks' || final === 'scenes') {
+      step = final
+      selected = null
+      continue
+    }
+
+    // 完整清单 + 包内项预勾：可减包内项，也可加包外项
+    const catalog = scans[final] || []
+    const tuned = await promptSelection(
+      catalog,
+      final === 'skills' ? 'Skills' : final === 'rules' ? 'Rules' : 'Hooks',
+      new Set(selected[final].map(item => item.name)),
+    )
+    if (tuned === null) return null
+    selected = { ...selected, [final]: tuned }
+  }
+}

package/src/sync.js

@@ -239,7 +239,15 @@ function buildSearchableOptions(items) {
     })
 }
 
-async function promptSelection(items, label, defaultNames) {
+/**
+ * 可搜索多选一层。items 为空直接返回 []，不弹窗。
+ * 取消返回 null，调用方必须中止整次同步。
+ *
+ * @param {Array<{ name: string, category?: string, description?: string }>} items
+ * @param {string} label
+ * @param {Iterable<string>} defaultNames
+ */
+export async function promptSelection(items, label, defaultNames) {
   if (items.length === 0) return []
   // 可搜索多选 + 底部说明区（聚焦项描述不跟在行尾）
   const selectedNames = await searchableMultiselect({

package/templates/ai-tools/CHANGELOG.md

@@ -52,6 +52,38 @@
 
 ---
 
+## 0.13.1 — 2026-09-02
+
+### Changed
+
+- 产品0到1 包装 skill：外部 skill 缺失时提示跑 `dwy` 选「刷新全局外部 skill」，不再写已删除的 `dwy skills install`
+
+---
+
+## 0.13.0 — 2026-09-02
+
+### Changed
+
+- `skills/发布发版/dwy-ios-app-store-release`：送审后截图锁死，改图必须撤审 → 换图保序 → 新建 submission 再送；只补现网已有槽；What's New 能力现网图看不到则必须更新截图；凭据优先读仓库 `AGENTS.md` / `CLAUDE.md` 约定。`iphone_65` 补 `preferred: 1242×2688`
+
+---
+
+## 0.12.0 — 2026-09-02
+
+### Changed
+
+- `rules/开发流程/dwy-dependency-freshness.md`：首次技术选型选版本必须只选正式版，禁止 beta / rc / alpha / preview / nightly 等预发布；AskUserQuestion 选项同样不列预发布号。7 天新鲜度约束仍在，两条同时满足
+
+---
+
+## 0.11.0 — 2026-08-18
+
+### Changed
+
+- `rules/开发流程/dwy-git-commit.md`：提交前必须先 `git fetch` + `git pull --rebase --autostash`，冲突全部处理完才能 `git commit`（多人协作，禁止先提交再拉）
+
+---
+
 ## 0.10.0 — 2026-08-13
 
 ### Added

package/templates/ai-tools/VERSION

@@ -1 +1 @@
-0.10.0
+0.13.1

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

@@ -23,6 +23,70 @@ paths:
 - 全屏背景、沉浸式遮罩可以延伸到系统栏区域,但前景可交互内容默认留在安全显示区内。
 - 禁止写死状态栏高度、导航栏高度、刘海高度,统一通过系统 inset 获取。
 
+## 控件选型(AppCompat)
+
+XML 布局、代码 `new`、自定义 View:**只要存在 AppCompat 对应类,就必须用 AppCompat 版**,禁止 `android.widget` 平台控件。没有 AppCompat 对应类的布局容器 / 列表(LinearLayout、ConstraintLayout、RecyclerView 等)保持原样。
+
+**理由**:平台控件在低版本没有矢量图 tint、自动夜间色、`?attr` 着色。`AppCompatActivity.setContentView` 虽会把 `<TextView>` 自动换成 `AppCompatTextView`,但 `LayoutInflater.from(context)`、`View.inflate`、非 AppCompat 上下文的 `<include>`、自定义 View 写 `extends TextView`,都会落到平台控件,静默丢兼容。写 AppCompat 类名,不依赖自动替换。
+
+**包名禁止写死**:本规范只约束类名(`AppCompatTextView` / `SwitchCompat` 等)。XML 全限定包名、Kotlin/Java import 一律按当前项目已有控件推断,禁止把短类名当 XML 标签照抄,禁止未看项目写死 `androidx.*` 或 `android.support.*`。
+
+**id 缩写不变**:`AppCompatTextView` 仍是 `tv_`,`SwitchCompat` 仍是 `sw_`,不要另造 `actv` / `sc`。页面基类用 `AppCompatActivity`,禁止 `android.app.Activity`。
+
+### 对照表(有则必须换)
+
+
+| 禁止(平台)                         | 必须用                                                                                      |
+| ------------------------------ | ---------------------------------------------------------------------------------------- |
+| TextView                       | AppCompatTextView                                                                        |
+| EditText                       | AppCompatEditText                                                                        |
+| Button                         | AppCompatButton                                                                          |
+| ImageView                      | AppCompatImageView                                                                       |
+| ImageButton                    | AppCompatImageButton                                                                     |
+| CheckBox                       | AppCompatCheckBox                                                                        |
+| RadioButton                    | AppCompatRadioButton                                                                     |
+| CheckedTextView                | AppCompatCheckedTextView                                                                 |
+| AutoCompleteTextView           | AppCompatAutoCompleteTextView                                                            |
+| MultiAutoCompleteTextView      | AppCompatMultiAutoCompleteTextView                                                       |
+| Spinner                        | AppCompatSpinner                                                                         |
+| SeekBar                        | AppCompatSeekBar                                                                         |
+| RatingBar                      | AppCompatRatingBar                                                                       |
+| Switch                         | **SwitchCompat**(类名不是 AppCompatSwitch)                                                    |
+| `android.widget.Toolbar`       | appcompat 包下的 `Toolbar`(不是 `android.widget.Toolbar`)                                     |
+
+
+表中未列、但依赖里能搜到 `AppCompatXxx` / `SwitchCompat` 的,同样必须用。搜不到才用平台类。
+
+无 AppCompat 对应、保持原样:LinearLayout / RelativeLayout / FrameLayout / TableLayout / ConstraintLayout / ScrollView / NestedScrollView / HorizontalScrollView / RecyclerView / ListView / GridView / ViewPager / WebView / CardView / View / Space。
+
+### 代码 `new` / 自定义 View
+
+```kotlin
+// ❌
+val btn = Button(context)
+class PriceText(context: Context, attrs: AttributeSet?) : TextView(context, attrs)
+
+// ✅
+val btn = AppCompatButton(context)
+class PriceText(context: Context, attrs: AttributeSet?) : AppCompatTextView(context, attrs)
+```
+
+### 例外(可观察条件)
+
+- 依赖里搜不到 AppCompat 对应类 → 用原类
+- 项目已在用 Material / Design 同功能控件 → 那些优先(`MaterialButton` 优于 `AppCompatButton`);无对应项仍用 AppCompat
+- Jetpack Compose 组件不受本条约束
+
+### 禁止的借口
+
+
+| 借口                         | 事实                                                          |
+| -------------------------- | ----------------------------------------------------------- |
+| XML 写 TextView 会被自动替换      | 仅 AppCompat 的 LayoutInflater Factory2 会替换;其它 inflate 路径不会    |
+| 自定义 View 继承 TextView 即可    | 必须继承 AppCompatTextView,否则无 tint / 矢量                        |
+| Switch 没有 AppCompat 版      | 类名是 SwitchCompat                                             |
+
+
 ## 一、命名规范
 
 
@@ -76,7 +140,7 @@ View id 规则:`<控件缩写>_<逻辑名>`,如 `tv_username`、`btn_submit`。
 | 容器 / 导航 | Toolbar=`toolbar`、TabLayout=`tab`、FloatingActionButton=`fab`、BottomNavigationView=`bnv`、AppBarLayout=`abl` |
 
 
-> 缩写冲突时取更长缩写消歧:`rbtn`(RadioButton) 区别于 `rb`(RatingBar)。表中无对应的控件,按"首字母 / 业务语义就近"自拟,组内保持一致。
+> 缩写冲突时取更长缩写消歧:`rbtn`(RadioButton) 区别于 `rb`(RatingBar)。表中无对应的控件,按"首字母 / 业务语义就近"自拟,组内保持一致。AppCompat 控件 id 仍用对应平台缩写(`AppCompatTextView`=`tv`、`SwitchCompat`=`sw`),类名选型见上文「控件选型(AppCompat)」。
 
 #### drawable / selector 状态后缀
 
@@ -1033,6 +1097,7 @@ if (trimmed.isNotEmpty()) { ... }
 | Java 实体 `public` 实例字段                                              | `private` 字段 + `getXxx`/`setXxx` + `toString`            |
 | Kotlin 实体 `@JvmField` / 无 `toString` 的普通 class 实体                 | 优先 `data class` + `val`;或手写访问器 + `toString`          |
 | `s.length() > 0` / `s.trim().length() > 0` 等用 length 判空 / 非空       | Java `!s.isEmpty()` / `!s.trim().isEmpty()`;Kotlin `s.isNotEmpty()` / `s.isNotBlank()`;详见本节「字符串空判断」 |
+| 平台 `TextView` / `Button` / `Switch` / 自定义 View 继承平台控件     | 改用 AppCompat 对应类(`SwitchCompat` 等),包名按项目推断;无对应类的布局容器保持原样;详见「控件选型(AppCompat)」 |
 
 
 ## 九、代码自检(写代码时强制执行)
@@ -1065,6 +1130,7 @@ if (trimmed.isNotEmpty()) { ... }
 | 21  | Gradle 脚本(Groovy / kts):锁版本 / `exclude` / 自定义 task / 变体 / 关键魔法值有 why 注释,无复述式、无注释掉的配置块                                                                                                                                     | ✓        |
 | 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`;无对应类的布局容器保持原样                                                                                                                          | ✓        |
 
 
 **不执行自检就提交代码 = 违规。**

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

@@ -1,10 +1,10 @@
 ---
-description: 依赖版本新鲜度通用规则（首次技术选型下载依赖时，发布 <7 天的版本不采用；跨 npm/uv/Docker/Android/iOS/鸿蒙/Flutter 等所有栈）
+description: 依赖版本选择通用规则（首次技术选型只选正式版、禁止 beta/rc 等预发布；发布 <7 天的版本不采用；跨 npm/uv/Docker/Android/iOS/鸿蒙/Flutter 等所有栈）
 ---
 
 # 依赖版本新鲜度规则
 
-> 首次技术选型下载依赖（引新包、选 base 镜像 / SDK 版本）时，刚发布的新版本常带回归 bug：构建失败、Docker 镜像缺层、API breaking change。本规则约束 AI 在装新依赖前主动查「版本发布时间」，避开 <7 天的版本。
+> 首次技术选型下载依赖（引新包、选 base 镜像 / SDK 版本）时，预发布版（beta / rc / alpha）未冻结 API，刚发布的正式版也常带回归 bug。本规则约束 AI 在装新依赖前：先丢掉预发布，再查正式版「首次发布时间」，避开 <7 天的版本。
 >
 > 适用**所有技术栈**：npm/pnpm、uv/pip、Docker、Android(Gradle/Maven)、iOS(CocoaPods/SPM)、鸿蒙(ohpm)、Flutter(pub) 以及未来出现的任何包管理器。下面给出总约束 + 各栈示例，未列出的栈按「查官方 registry 发布时间」通用流程自行判断。
 
@@ -12,19 +12,24 @@ description: 依赖版本新鲜度通用规则（首次技术选型下载依赖
 
 - **仅约束首次技术选型下载依赖**：新项目引入新包、新搭脚手架选 base 镜像 / SDK 版本、原项目引入此前没用过的依赖。
 - **已安装的旧版本无需为此升级**。本规则只管「新装 / 新选」，不管「存量升级」。
-- 7 天是**下限排除条件**，不是「必须选最近一个 ≥7 天的版本」。最终选哪个稳定版由 AI 综合判断（成熟度、维护活跃度、依赖体积、与项目栈兼容性）。
+- 7 天是**下限排除条件**，不是「必须选最近一个 ≥7 天的版本」。最终选哪个稳定正式版由 AI 综合判断（成熟度、维护活跃度、依赖体积、与项目栈兼容性）。
 
 ## 二、核心约束
 
-- **必须**在首次安装 / 选定版本前，查候选版本的「首次发布时间」
+候选版本必须**同时**满足下面两条，缺一不可。给用户的 AskUserQuestion 选项同样只列合格版本，禁止把预发布号摆上去让用户选。
+
+- **必须只选正式版**
+  - **禁止**采用预发布：版本号或 tag 含 `beta` / `rc` / `alpha` / `preview` / `nightly` / `snapshot` / `canary` / `dev` / `experimental`，或 registry 标为 pre-release（npm dist-tag `next`/`beta`/`rc`、GitHub `prerelease: true`、PyPI 版本号带 `a`/`b`/`rc`）
+  - 先滤掉预发布，再进入 7 天判断；预发布即使发布超过 7 天也不用
+- **必须**在首次安装 / 选定版本前，查候选**正式版**的「首次发布时间」
   - 用官方 registry 的发布时间，**不是**上传时间、**不是** `latest` / `stable` tag 时间
 - **禁止**采用发布时间距今 **<7 天**的版本
-- **禁止**无脑用 `@latest` / `latest` / `stable` / 浮动 tag / 不带版本号安装——这些随时可能落到刚发布的新版本上
+- **禁止**无脑用 `@latest` / `latest` / `stable` / 浮动 tag / 不带版本号安装——这些随时可能落到刚发布的新版本或预发布通道上
 - 已安装版本**无需**为此规则升级
 
 ## 三、各栈查发布时间示例
 
-未列出的栈，按「查官方 registry 元数据 → 取发布时间」自行处理。
+未列出的栈，按「查官方 registry 元数据 → 取发布时间」自行处理。查的对象必须是正式版，预发布条目直接跳过。
 
 | 栈 | 查发布时间方法 |
 |---|---|
@@ -40,20 +45,27 @@ description: 依赖版本新鲜度通用规则（首次技术选型下载依赖
 ## 四、正反例
 
 ```bash
-# 反例：直接装 latest，可能落到昨天才发的版本
+# 反例：预发布，即使发布超过 7 天也不用
+pnpm add some-pkg@1.3.0-beta.2
+uv add some-pkg==2.0.0rc1
+FROM node:23.0.0-rc
+implementation 'com.example:lib:1.0.0-alpha'
+
+# 反例：直接装 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 天
+# 正例：正式版，且发布 ≥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 天再用。
+- 栈未列全时，先找该栈的**官方 registry**（包管理器背后的中央仓库），丢掉预发布条目，再查正式版发布时间字段。
+- 拿不到精确发布时间时，保守处理：选发布更早、更稳定的正式版，不要选「最新」，更不要选 beta。
+- 7 天窗口内的新正式版，**等待**而非采用，**无任何例外**（含安全补丁）。等满 7 天再用。
+- 用户口头点名某个 beta / rc：**不要直接装**。说明本规则只选正式版，改给最近一个合格正式版让用户确认。