create-dwy 0.25.3 → 0.27.0

package/templates/ai-tools/skills/Vue/dwy-admin-kit/references/v0/0.3.0.md

@@ -0,0 +1,176 @@
+<!-- 来源：@dwydev/admin-kit@0.3.0 的 frontend/admin-shell/README.md；相对链接以原仓库为准。 -->
+
+# @dwydev/admin-kit
+
+Vue 3 **管理框架与通用组合组件**：模块装配菜单与路由，统一壳布局、页头、面包屑、列表状态和管理页面展示。不读取产品 API、store 或领域模型。
+
+视觉底座用 [`@dwydev/eui`](https://www.npmjs.com/package/@dwydev/eui) 的 `EAdminLayout`，**不并入 eui**（eui 只提供 UI 原语）。
+
+## 安装
+
+```bash
+pnpm add @dwydev/admin-kit
+# peers
+pnpm add vue vue-router @dwydev/eui @dwydev/ekit lucide-vue-next
+```
+
+宿主需接入 eui theme（`@dwydev/eui/theme`）与 Tailwind。若 shell 类名未生效，把 content 扫到：
+
+```txt
+./node_modules/@dwydev/admin-kit/dist/**/*.{js,mjs}
+```
+
+### Vite 跨仓联调注意（file: / 源码 alias）
+
+若用 `file:` 或 alias 指 monorepo **源码**（而非已发布 dist），宿主 `vite.config` 必须 **dedupe 并钉死 `vue` / `vue-router`** 到应用自身 `node_modules`，否则会出现两份 vue-router，`useRoute()` inject 为 `undefined`，控制台页读 `.meta` 白屏：
+
+```ts
+resolve: {
+  dedupe: ['vue', 'vue-router'],
+  alias: {
+    vue: fileURLToPath(new URL('./node_modules/vue', import.meta.url)),
+    'vue-router': fileURLToPath(new URL('./node_modules/vue-router', import.meta.url)),
+  },
+}
+```
+
+发 npm 后消费 dist、peer 由宿主安装时通常无此问题。
+## 快速接入（壳组件模式，适合营销 + 控制台共存）
+
+```ts
+import { createAdminShell, defineAdminModule, asMenuIcon, AdminShell } from '@dwydev/admin-kit'
+import { LayoutDashboard } from 'lucide-vue-next'
+
+export const appShell = createAdminShell({
+  title: 'My App',
+  logo: '/logo.png',
+  collapsedStorageKey: 'myapp:admin:sidebar:collapsed',
+  routeMetaDefaults: { requiresAuth: true, layout: 'admin' },
+  modules: [
+    defineAdminModule({
+      id: 'dashboard',
+      order: 10,
+      menu: { key: '/dashboard', label: '概览', icon: asMenuIcon(LayoutDashboard) },
+      routes: [{
+        path: '/dashboard',
+        name: 'dashboard',
+        component: () => import('./pages/Dashboard.vue'),
+        meta: { title: '概览' },
+      }],
+    }),
+    // 隐藏菜单、仅保留直访路由
+    defineAdminModule({
+      id: 'hidden-page',
+      showInMenu: false,
+      routes: [{ path: '/internal', name: 'internal', component: () => import('./pages/Internal.vue'), meta: { title: '内部' } }],
+    }),
+  ],
+})
+
+// router: [...publicRoutes, ...appShell.routes]
+// layout:
+// <AdminShell v-bind="appShell.shellProps">
+//   <template #header-extra>…用户菜单…</template>
+// </AdminShell>
+```
+
+## 纯后台父子路由
+
+首版以**扁平绝对 path + 宿主渲染 AdminShell** 为主（与 quant-cloud 一致）。
+`path: '/'` + `children` 形态可在后续版本用 `createAdminShellRoute` 增强。
+
+## 导出
+
+| API | 说明 |
+|-----|------|
+| `createAdminShell` / `defineAdminModule` | 菜单 + 路由装配 |
+| `AdminShell` | 布局组件 |
+| `AdminPageHero` / `AdminBreadcrumb` / `AdminPageHeader` | 页头与面包屑 |
+| `asMenuIcon` / `useAdminActiveKey` / `useAdminBreadcrumb` | 工具 |
+
+## meta 约定
+
+| 字段 | 说明 |
+|------|------|
+| `title` | 页头标题 |
+| `description` | 页头副标题 |
+| `menuKey` | 侧栏高亮（嵌套子页） |
+| `pageHero` | 默认 true；false 时页面自管页头 |
+| `breadcrumb` | 覆盖自动面包屑 |
+
+## 不负责
+
+鉴权守卫、角色模型、业务 header 内容、HTTP / Pinia。
+
+## 0.3 通用管理组件
+
+0.3 保留原根入口，新增以下显式子路径。EUI peer 下限为已修复标签关联与键盘输入操作的 2.7.2。
+
+```ts
+import { PagedTable, RecordSearch, RequestFeedback, ConfigFieldControl } from '@dwydev/admin-kit/components'
+import { usePagedList } from '@dwydev/admin-kit/composables'
+import { STATUS_TONE } from '@dwydev/admin-kit/status/tone'
+```
+
+`components` 还提供总览/统计卡、记录详情/代码/省略/日期展示、状态徽章、筛选器、图表容器及确认执行。`OverviewCard` 与 `WindowToggle` 旧名保持兼容；图表容器不引入 Plotly。密码字段和产品领域页面不在本包内。
+
+加载样式并让 Tailwind 扫描实际安装的构建产物：
+
+```css
+@import '@dwydev/eui/theme';
+@import '@dwydev/admin-kit/style.css';
+@source '../node_modules/@dwydev/eui/dist/**/*.js';
+@source '../node_modules/@dwydev/admin-kit/dist/**/*.js';
+```
+
+扫描路径以宿主 CSS 文件为基准。产品已有相应配置时只调整路径，不重复加载主题。
+
+### 分页状态
+
+`RecordSearch` 的 `label` 提供持久、视觉隐藏的输入标签；省略时沿用 `placeholder`。输入法合成回车不提交。用户手动删空或点击清空按钮时会先更新 `modelValue`，再各发一次 `clear` 与 `search`；`clear` 只用于通知，宿主统一在 `search` 中请求，避免重复加载。外部直接清空 `modelValue` 不触发搜索。
+
+`PagedTable` 在实际横向溢出时显示滑动提示，并使滚动区可键盘聚焦。需要常驻的行操作列直接使用既有列属性 `{ key: 'actions', title: '操作', width: 80, fixed: 'right' }`；仅固定较窄的操作列，避免占满窄屏。列定义及 `#cell-*` 插槽仍原样转交 EUI。
+
+`RecordEllipsis` 仅在文本实际截断时开启全文提示与键盘停靠，完整文本与占位符不增加 Tab 次数。
+
+```ts
+const list = usePagedList({
+  fetcher: async ({ page, pageSize, keyword }, request) => {
+    const result = await hostApi.list({ page, pageSize, keyword })
+    if (request.isCurrent()) hostSummary.value = result.summary
+    return { items: result.items, total: result.total }
+  },
+})
+```
+
+`hostApi` 与 `hostSummary` 由产品提供。单参数 fetcher 继续兼容；`paged-list` 子路径与 `composables` 导出同一实现。
+
+- `error` 保留原始失败对象；当前失败清空数据但不向调用方抛出，便于页面区分失败和零条记录。
+- 每次 `load` 开始清旧错误，旧请求成功/失败/finally 不得覆盖新请求。
+- `invalidate()` 停止 loading 并淘汰在途请求，保留数据、错误与筛选，允许之后再次加载。
+- `reset()` 另清空数据/错误/关键词，恢复初始每页条数和排序。
+- Vue 作用域销毁时自动 invalidate；底层 HTTP 不会被取消。
+
+### 构建与实际制品验收
+
+在仓库根执行：
+
+```sh
+pnpm --dir frontend/eui build
+pnpm --dir frontend/ekit build
+pnpm --dir frontend/admin-shell test
+pnpm --dir frontend/admin-shell build
+pnpm --dir frontend/admin-shell smoke:pack
+```
+
+smoke 将本轮实际 admin-kit/EUI/ekit tgz 安装到干净目录，检查根/子入口、类型、分页生命周期和 Vite 打包后的真实 EUI SSR；不依赖源码 alias 或共享仓库外的私有产物。它验证 Vue/Vite 消费模式，不承诺现有 ekit 可由原生 Node 无打包直接加载。其他固定依赖从官方 npm registry 安装，冷缓存需要网络。
+
+两产品可暂保留 `@dwy/components` 转出口；本地准备脚本将本包 tgz 复制到各自 `.shared-packages`，不把临时绝对路径写进 package/lock。正式 registry 接入在另行发行后切换，制品验收通过不表示已经发布。
+
+## 开发
+
+```bash
+cd frontend/admin-shell
+pnpm test
+pnpm build
+```

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

@@ -0,0 +1,10 @@
+---
+name: dwy-auth-web
+description: 使用或排查 @dwydev/auth-web 的接入和现有功能时使用，核实消费项目实际版本。
+---
+
+# @dwydev/auth-web
+
+管理员 Cookie 登录表单与会话；宿主提供 EConfigProvider、样式和成功导航。
+
+先查项目实际依赖、锁文件与已安装包的声明文件和现有调用；版本范围不是安装版本。核实组件 props、初始化和生命周期后再使用。当前仓库清单是 0.1.0，但尚未核实对应发布标签；不能仅凭清单推断已发布包的内容。源码与接入文档在仓库 `frontend/auth-web`；先确认实际来源与版本一致。缺少证据时说明，不猜接口。项目未安装时不自行添加依赖。

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

@@ -1,7 +1,6 @@
 ---
 name: dwy-ekit
-description: "@dwydev/ekit 工具库使用指南。涉及以下任何主题，**必须**使用此 skill（即使用户没有说 'ekit'）：HTTP 请求 / axios 封装 / token 刷新 / dwyeapi 响应契约对接 / localStorage / Cookie / useStorage / useCookie / 日期格式化 / 时区处理 / dayjs / 表单校验 / zod schema / vee-validate / PII 脱敏 / 剪贴板 / useClipboard / 文件下载 / Blob / 查询字符串 / qs / Vue composables（debounce / throttle / click-outside / event-listener / window-size / media-query / intersection-observer / resize-observer / useFormPersist）。本 skill 是 @dwydev/ekit 的唯一权威导航来源，禁止绕过 ekit 直接手写底层 API。"
-ekit_baseline_version: "0.8.0"
+description: 使用或排查 @dwydev/ekit 的请求、存储、日期、校验、文件和 Vue 工具时使用；按项目实际版本查证能力。
 ---
 
 # @dwydev/ekit 工具库使用指南
@@ -20,7 +19,7 @@ ekit 共 82 个对外导出。**本文档不再镜像函数签名** —— 因
 
 ### 第一步：定位 ekit 真实版本
 
-读消费方项目 `package.json`，找 `dependencies["@dwydev/ekit"]` 或 `peerDependencies["@dwydev/ekit"]`。这才是写代码的依据。
+先读消费方项目的实际安装包和锁文件确定版本，再核对 `package.json` 的依赖范围；范围不等于实际安装版本。未安装时不要假设该库已可用或自行增加依赖。
 
 ### 第二步：读 module-manifest.json（一次拿导出索引）
 

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

@@ -16,7 +16,7 @@ Vue 3 组件库（Reka-ui + shadcn 视觉 + Element Plus 式 API + Tailwind 4）
    node -p "require('@dwydev/eui/package.json').version"
    ```
    失败则读 `pnpm-workspace.yaml` catalog `'@dwydev/eui'`，再读 `package.json` 的 `dependencies` / `peerDependencies`。
-   仍失败：按 `v2` 给脚手架，并声明「未探测到安装版本」。
+   声明的依赖范围不代表实际安装版本。仍无法确定时说明缺口，不按任一版本猜测 API。
 
 2. **选线**：读同目录 `versions.yml`。`2.y.z` → `v2/`，`1.y.z` → `v1/`。目录不存在（例如装了 3.x 但还没有 `v3/`）→ 不要用 `v2` 冒充；按下面「读源码」拿该版本代码，并说明文档线未建。
 

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

@@ -6,7 +6,7 @@ sparse:
   - frontend/eui/src
   - frontend/eui/package.json
 lines:
-  - match: ">=2.0.0"
+  - match: ">=2.0.0 <3.0.0"
     dir: v2
-  - match: ">=1.0.0"
+  - match: ">=1.0.0 <2.0.0"
     dir: v1

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

@@ -0,0 +1,8 @@
+---
+name: dwy-vue-architecture
+description: 设计、开发或评审 Vue 项目的模块边界、依赖方向和共享代码时使用。
+---
+
+# Vue 架构
+
+先检查项目实际结构与调用链；旧项目不因启用 Skill 重建。需要设计模块与依赖边界时阅读 [分层与依赖](references/dwy-vue-layering.md)，按实际规模和项目约束使用。

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

@@ -0,0 +1,16 @@
+---
+name: dwy-vue-development
+description: 开发、修改、测试或排查 Vue 应用、组件及组合式函数时使用；覆盖团队写法、常见踩坑和自有基础库发现。
+---
+
+# Vue 开发
+
+先确认 Vue、TypeScript、构建工具及项目已有依赖。优先复用项目现有组件和工具，不自动新增自有依赖。涉及模块边界时使用可用的 dwy-vue-architecture。
+
+- [Vue 规范](references/dwy-vue-core.md)：组件、路由、样式及配置。
+- [Pinia](references/dwy-vue-pinia.md)：项目使用 Pinia 时参考。
+- [测试](references/dwy-vue-testing.md)：组件和业务测试。
+- [踩坑](references/dwy-vue-pitfalls.md)：响应式、路由和构建排查。
+- [自有基础库](references/dwy-vue-base-lib.md)：项目已使用时查 dwy-eui、dwy-ekit；管理后台和认证分别查 dwy-admin-kit、dwy-auth-web。
+
+资料中的强制选型仅适用于已采用该栈或用户明确选择的新项目，现有项目遵循现有依赖和用户要求。

package/templates/ai-tools/{rules/Vue → skills/Vue/dwy-vue-development/references}/dwy-vue-base-lib.md

@@ -1,13 +1,13 @@
 ---
-description: 团队内部基础库强制复用规范（eui UI 组件 + ekit 工具：禁重复造轮子、HTTP/存储/日期/校验/脱敏走 ekit、UI 走 eui）
+description: 已使用 eui 和 ekit 的项目如何查找和复用基础能力
 paths:
   - "**/*.vue"
   - "**/*.ts"
 ---
 
-# Vue 团队基础库强制复用规范
+# Vue 团队基础能力
 
-`dwy-vue-core` rule 的团队内补充。通用 Vue 工程规范见 `dwy-vue-core`；本文件只管「凡 eui / ekit 已提供的能力，禁止自行实现，也禁止引入其他库重复造轮子」。
+本资料适用于已采用 eui 或 ekit 的项目；版本及公开接口以实际安装包和对应 Skill 为准。项目未采用时此处仅用于了解能力，不要求引入或替换现有实现。
 
 `@dwydev/eui` 与 `@dwydev/ekit` 是团队内部 npm 基础库，分别覆盖 UI 组件层与通用工具层。
 

package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-architecture/SKILL.md

@@ -39,19 +39,19 @@ description: "【dwy·技术架构】产品 0 到 1 设计与架构阶段。触
 
 ### 四层架构
 
-层名、依赖边、分包树以对应栈的 layering rule 为准，本 skill **不另定义目录**：
+层名、依赖边、分包树以对应技术栈的架构指引为准，本 skill **不另定义目录**：
 
-- Python → `dwy-python-layering`
-- Vue → `dwy-vue-layering`
+- Python → `dwy-python-architecture`
+- Vue → `dwy-vue-architecture`
 - Android → `dwy-android-layering`
-- iOS / macOS → `dwy-apple-layering`
+- iOS / macOS → `dwy-apple-architecture`
 
-铁律（细节与正反例见上列 rule）：依赖只许向下；`features/*` 互不依赖；具体实现只在 Assembly 注入；第三方版本只写在仓库根 catalog。
+团队新项目参考对应架构指引；既有项目先核实当前依赖边和模块组织，避免擅自重构。
 
 ## 实现
 [自写型]
 1. 读项目 `.claude/rules/`，结合上方架构约束产出架构（项目 rules 优先，本约束兜底）
-2. 技术架构：**先读对应栈 `dwy-*-layering` 按四层归位模块、按业务域聚目录**，再写分层/模块边界/选型理由；选型不确定处走 `AskUserQuestion`
+2. 技术架构：先读可用的对应栈架构 Skill 或 Android layering 规则，再写分层、模块边界和选型理由；选型不确定处走 `AskUserQuestion`
 3. **判有无后端**（读选型/PRD：有 API / 持久化 / 账户体系 → 有后端）：
    - **有后端** → 必出数据库设计，且**建模到位**：库表清单 / 字段(类型·约束·默认·可空) / 主外键关系 / 索引 / 必要的范式或反范式说明，与接口契约 schema 对齐
    - **纯前端**（无后端）→ 跳过数据库设计，在 `技术架构.md` 注明「无后端，不涉及库表」

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-commercial-sdk/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: dwy-commercial-sdk
+description: 商业 SDK 的接口、源码保护和交付产物检查。用户要求检查商业 SDK、商业 SDK 打包或检查其源码泄露风险时使用；不执行发布。
+---
+
+# 商业 SDK 发布前检查
+
+本 skill 适用于有商业保密或源码保护要求的 SDK，覆盖公开仓库、私有源和直接交付等分发方式。发版编排按项目约定执行；本检查不自行发布。
+
+## 确定范围
+
+1. 根据用户要求、项目文档、许可证、仓库公开状态、包配置和实际分发渠道识别 SDK、公开内容和需要保护的部分。不能根据“商业”二字推断源码必须保密；证据不足时询问用户。保护要求和交付范围存在歧义时先确认，再进行依赖该判断的检查。
+2. 每次依据当前项目上下文判断，不创建或读取 `.dwy/sdk-spec/config.json`，也不修改用户的全局配置或凭据。
+
+## 检查
+
+- 检查公开接口、文档、注释及示例是否包含不应公开的内部地址、凭据、个人信息或实现细节；结合上下文判断误报，不输出完整秘密。
+- 按确认的保护目标检查源码仓库、构建配置和分发渠道是否一致。编译、混淆和压缩只能提高还原成本，不能保证源码或算法无法恢复；公开仓库中的代码无法靠发布包配置保密。不要固定要求 Cython、minify 或排除所有源码。
+- 检查实际拟交付的包或文件清单，核对源码、source map、调试文件、环境配置、凭据、许可证和运行必需资源是否符合交付范围。使用项目现有构建和检查工具；明确区分已有产物检查与实际发布产物验证。构建或打包前检查脚本副作用，不执行发布。
+- 对发现的问题给出位置、风险、依据和修复建议；区分已验证、未验证和受环境限制的项目。按用户授权修复并重新检查，不把检查通过表述为绝对安全。

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-github-action-publish/SKILL.md

@@ -7,7 +7,7 @@ description: "GitHub Actions 打包分发避坑指南。先判断场景，再读
 
 定位：使用 GitHub Actions 做跨平台构建、打包、发布时，先判定产物类型，再查对应配置避坑。
 
-本 skill 只处理 CI 打包分发链路。通用发版流程（测试 / bump / changelog / tag）走 `dwy-publish`；SDK 发布前安全审计走 `dwy-sdk-spec`；纯 Python 包不需要 cibuildwheel。
+本 skill 只处理 CI 打包分发链路。通用发版流程（测试 / bump / changelog / tag）走 `dwy-publish`；纯 Python 包不需要 cibuildwheel。
 
 实战来源：
 

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/SKILL.md

@@ -11,9 +11,9 @@ description: "Use when 用户要求整理工程版本、更新 changelog、打
 
 1. 读取仓库指令、结构、构建配置、版本来源、changelog、Git 状态和历史 tag，识别独立工程及共享版本边界。依据实际依赖判断共享代码影响；不要把每个子目录当成独立工程。优先遵循用户指定范围，分不清边界时询问。
 2. 逐工程列出变更、版本来源、changelog 路径、tag 命名、版本类型、是否需要发布和 tag 触发器。检查上次对应 tag 后的提交及本次相关的未提交变更；不要把不属于本次的改动纳入提交。
-3. 对本次需要更新的工程，按 `../dwy-semver` 确定版本级别、beta/rc 或正式版，按 `references/version-sync.md` 同步版本；按 `references/changelog.md` 更新该工程 changelog，每个版本条目必须包含明确版本号和日期，禁止使用 `Unreleased` 或“未发布”等占位标题，与是否发布无关；再按 `references/git-tag.md` 提交和打 tag。无变更工程不创建空版本。已覆盖本次代码的现有版本可复用，不重复升版或打 tag。
+3. 对本次需要更新的工程，按版本决策规则确定版本级别、beta/rc 或正式版，按 `references/version-sync.md` 同步版本；按 `references/changelog.md` 更新该工程 changelog，每个版本条目必须包含明确版本号和日期，禁止使用 `Unreleased` 或“未发布”等占位标题，与是否发布无关；再按 `references/git-tag.md` 提交和打 tag。无变更工程不创建空版本。已覆盖本次代码的现有版本可复用，不重复升版或打 tag。
 4. 确定是否发布：仅版本管理时结束；需要发布或部署时，读取项目约定及现有 CI、构建和部署配置，判断渠道和命令。遵守仓库的发布和授权规则，不套用固定发布方式；证据不足时询问。不根据分支判断版本类型或发布流程。
-5. **部署上线闸门**：有新代码要上线，AI 自动检查并补齐对应工程的版本更新、changelog 和 tag，不逐项要求用户确认。自动校验 tag 指向包含全部拟部署代码、版本和 changelog 的提交，构建或部署使用该提交或其已验证产物。补齐并校验通过后继续部署；无法补齐或校验失败时停止部署并说明原因，不能以赶时间或已有构建替代。先完成项目要求的测试和适用的安全检查；SDK 对外发布前读取 `../dwy-sdk-spec`。
+5. **部署上线闸门**：有新代码要上线，AI 自动检查并补齐对应工程的版本更新、changelog 和 tag，不逐项要求用户确认。自动校验 tag 指向包含全部拟部署代码、版本和 changelog 的提交，构建或部署使用该提交或其已验证产物。补齐并校验通过后继续部署；无法补齐或校验失败时停止部署并说明原因，不能以赶时间或已有构建替代。先完成项目要求的测试和适用的安全检查。
 6. 推送 tag 前检查远端工作流及其他自动触发器：若推送会发布，先完成所有发布闸门并确认本次已获发布授权。仅要求版本管理而推送会触发未经授权的发布时，保留本地 tag 并报告，不能推送或擅自更改 workflow。
 7. 已获授权且满足闸门时，按项目实际配置执行发布；需要 GitHub Actions 打包时读取 `../dwy-github-action-publish` 和相应平台参考文件。按 `references/monitor-notify.md` 监控并验证实际结果。
 
@@ -26,3 +26,7 @@ description: "Use when 用户要求整理工程版本、更新 changelog、打
 - 平台：`references/frontend-deploy.md`、`references/backend-deploy.md`、`references/ios.md`、`references/android.md`、`references/harmony.md`、`references/generic-release.md`。
 
 版本、tag 或发布目标存在歧义时先核实；不可识别时询问。删除或覆盖远端 tag / release 前必须获得用户明确授权。输出各工程的版本、changelog、tag、是否推送和实际发布验证结果。
+
+## 版本决策
+
+按项目版本约定和公开接口兼容性确定版本：不兼容变更升 major，向后兼容的新功能升 minor，向后兼容的问题修复升 patch；同时包含多类变更时取最高级别。升级某一位时将其右侧数字归零。0.x 阶段及预发布版本按项目已有约定处理；约定不明时与用户确认。根据发布用途选择正式版或预发布版，不依据分支判断。

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/references/android.md

@@ -9,7 +9,7 @@
 
 ## 版本（通用步，固化）
 
-- `versionName` = 语义版本号，走 `../dwy-semver` 决策 + bump.py。
+- `versionName` = 语义版本号，按发布 skill 的版本决策规则确定。
 - 新上传构建的 `versionCode` 遵循渠道及项目的递增要求。
 - 多文件同步见 `version-sync.md`。
 
@@ -28,5 +28,5 @@
 
 - changelog → `changelog.md`（使用该工程既有路径和格式）
 - tag → `git-tag.md`（每次 bump 必打；版本串与 changelog 标题一致）
-- 安全检查 → `../dwy-sdk-spec`
+- 按项目要求检查发布产物和敏感信息。
 - 监控 + 结果 → `monitor-notify.md`

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/references/backend-deploy.md

@@ -4,7 +4,7 @@
 
 ## 版本（通用步，固化）
 
-- 走 `../dwy-semver` 决策 + bump.py；按 `version-sync.md` 同步工程实际维护的版本来源。
+- 按发布 skill 的版本决策规则确定版本；按 `version-sync.md` 同步工程实际维护的版本来源。
 - 部署新代码必须先完成入口规定的版本、changelog 和 tag 闸门；仅重发或回滚相同已记录产物可复用原版本。
 
 ## build / deploy（项目步，不写死命令）

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/references/frontend-deploy.md

@@ -4,7 +4,7 @@
 
 ## 版本（通用步，固化）
 
-- 走 `../dwy-semver` 决策 + bump.py；多文件同步见 `version-sync.md`（前端改 `package.json` 的 `version`）。
+- 按发布 skill 的版本决策规则确定版本；多文件同步见 `version-sync.md`（前端改 `package.json` 的 `version`）。
 - 部署新代码必须先完成入口规定的版本、changelog 和 tag 闸门；仅重发或回滚相同已记录产物可复用原版本。
 
 ## build / deploy（项目步，不写死命令）

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/references/generic-release.md

@@ -4,7 +4,7 @@
 
 ## 版本（通用步，固化）
 
-- 走 `../dwy-semver` 决策 + bump.py；按 `version-sync.md` 同步工程实际维护的版本来源。
+- 按发布 skill 的版本决策规则确定版本；按 `version-sync.md` 同步工程实际维护的版本来源。
 - 发布新代码必须先完成入口规定的版本、changelog 和 tag 闸门；仅重发或回滚相同已记录产物可复用原版本。
 
 ## build / publish（项目步，不写死命令）
@@ -24,5 +24,5 @@
 
 - changelog → `changelog.md`（使用该工程既有路径和格式）
 - tag → `git-tag.md`（每次 bump 必打；版本串与 changelog 标题一致；monorepo 例：`@dwydev/eui@2.2.3`、`create-dwy@0.16.1`）
-- 安全检查 → `../dwy-sdk-spec`（对外包必查泄露/产物）
+- 按项目要求检查发布产物和敏感信息。
 - 监控 + verify → `monitor-notify.md`（包仓库版本查询 / GitHub Release）

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/references/harmony.md

@@ -4,7 +4,7 @@
 
 ## 版本（通用步，固化）
 
-- `oh-package.json5` 的 `version` = 语义版本号，走 `../dwy-semver` 决策 + bump.py。
+- `oh-package.json5` 的 `version` = 语义版本号，按发布 skill 的版本决策规则确定。
 - 多文件同步见 `version-sync.md`。
 
 ## build / publish（项目步，不写死命令）
@@ -22,5 +22,5 @@
 
 - changelog → `changelog.md`（使用该工程既有路径和格式）
 - tag → `git-tag.md`（每次 bump 必打；版本串与 changelog 标题一致）
-- 安全检查 → `../dwy-sdk-spec`
+- 按项目要求检查发布产物和敏感信息。
 - 监控 + 结果 → `monitor-notify.md`

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/references/ios.md

@@ -9,7 +9,7 @@
 
 ## 版本（通用步，固化）
 
-- 语义版本号 `CFBundleShortVersionString`，走 `../dwy-semver` 决策 + bump.py。
+- 语义版本号 `CFBundleShortVersionString`，按发布 skill 的版本决策规则确定。
 - 构建号 `CFBundleVersion` 遵循项目及发布渠道约定；重新上传构建时满足渠道的递增要求。
 - 多文件同步见 `version-sync.md`。
 
@@ -29,5 +29,5 @@
 
 - changelog → `changelog.md`（使用该工程既有路径和格式）
 - tag → `git-tag.md`（每次 bump 必打；版本串与 changelog 标题一致）
-- 安全检查 → `../dwy-sdk-spec`（SDK 发布尤其要查泄露）
+- 按项目要求检查发布产物和敏感信息。
 - 监控 + 结果 → `monitor-notify.md`

package/templates/ai-tools/skills//351/200/232/347/224/250/dwy-dependency-choice/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: dwy-dependency-choice
-description: "新增或升级运行时依赖、选版本、选基础镜像 / SDK、检查开源许可证时必须使用（即使用户没说 skill 名）。只选发布满 7 天的正式版；闭源商用禁止 GPL / AGPL / SSPL / 非商业许可。各栈查发布时间和隐私协议附录模板在本 skill。不负责本包自己的 SemVer（那是 dwy-semver）。已安装的旧版本不用为此升级。"
+description: "新增或升级运行时依赖、选版本、选基础镜像 / SDK、检查开源许可证时必须使用（即使用户没说 skill 名）。只选发布满 7 天的正式版；闭源商用禁止 GPL / AGPL / SSPL / 非商业许可。各栈查发布时间和隐私协议附录模板在本 skill。不负责本包自己的 SemVer。已安装的旧版本不用为此升级。"
 ---
 
 # 依赖选型（版本 + 许可）
 
-新装或新选依赖、base 镜像、SDK、字体、图标、素材、模型权重时读本 skill。已安装的旧版本不用为此升级。本包自己的版本号走 `dwy-semver`。
+新装或新选依赖、base 镜像、SDK、字体、图标、素材、模型权重时读本 skill。已安装的旧版本不用为此升级。本包自己的发版版本号按 `dwy-publish` 决策。
 
 没有 skill 的工具只看这两份短 rule，和本 skill 冲突时以本 skill 为准：`rules/开发流程/dwy-dependency-freshness.md`、`rules/开发流程/dwy-oss-commercial-license.md`。