create-dwy 0.14.7 → 0.15.0

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-github-action-publish/references/electron-release-workflow-template.yml

@@ -0,0 +1,98 @@
+# Electron 多平台打包 + GitHub Release workflow 模板
+#
+# 来源参考: 某 Electron 桌面应用多平台打包实战 (release.yml + pack.mjs)
+#
+# 使用前按项目实际情况替换:
+#   1. node-version
+#   2. 包管理器安装命令(npm ci / pnpm install --frozen-lockfile)
+#   3. build / pack 命令
+#   4. Linux 系统依赖
+#   5. 签名 / 公证 secrets
+#   6. artifact path 和文件命名
+
+name: Build and Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-15-intel
+            platform: mac-x64
+            packArgs: ""
+          - os: macos-latest
+            platform: mac-arm64
+            packArgs: "-- --arm64"
+          - os: windows-latest
+            platform: win
+            packArgs: ""
+          - os: ubuntu-latest
+            platform: linux
+            packArgs: "-- --linux"
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install Linux packaging dependencies
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          sudo rm -f /etc/apt/sources.list.d/azure-cli.list /etc/apt/sources.list.d/microsoft-prod.list
+          sudo apt-get update
+          sudo apt-get install --no-install-recommends -y icnsutils graphicsmagick xz-utils
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Package
+        run: npm run pack ${{ matrix.packArgs }}
+        env:
+          CSC_IDENTITY_AUTO_DISCOVERY: false
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-${{ matrix.platform }}
+          path: |
+            release/**/*.dmg
+            release/**/*.exe
+            release/**/*.AppImage
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+          merge-multiple: true
+
+      - name: List release files
+        run: find artifacts -type f
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: artifacts/**/*
+          generate_release_notes: true
+          draft: false

package/templates/ai-tools/skills//{350/277/220/347/273/264/345/217/221/345/270/203/dwy-cibuildwheel → 345/217/221/345/270/203/345/217/221/347/211/210/dwy-github-action-publish}/references/release-workflow-template.yml

@@ -1,6 +1,6 @@
 # Python Cython SDK 跨平台 wheel + PyPI Trusted Publisher 发版 workflow 模板
 #
-# 已内置 dwy-cibuildwheel skill 7 个避坑修复，开箱即用。
+# 已内置 dwy-github-action-publish skill Python wheel 场景 8 个避坑修复，开箱即用。
 # 复制到项目 .github/workflows/release.yml，只改两处：
 #   1. package-dir: <PACKAGE_DIR>      —— 实际 SDK 子目录（monorepo 必填，单包仓库填 . 或省略）
 #   2. CIBW_BUILD                      —— 按需调整 Python 版本枚举
@@ -42,7 +42,7 @@ jobs:
         include:
           - { os: ubuntu-latest,    archs: x86_64 }
           - { os: ubuntu-24.04-arm, archs: aarch64 }
-          # 坑 8: macos-13 已于 2025-12-04 退休,用 macos-15-intel(真 Intel runner)替代
+          # 坑 8: macos-13 已退休,用 macos-15-intel(真 Intel runner)替代
           # 如果不需要 x86_64 wheel,删掉下一行,Intel Mac 用户走 Rosetta 跑 arm64 wheel
           - { os: macos-15-intel,   archs: x86_64 }
           - { os: macos-14,         archs: arm64 }
@@ -66,7 +66,7 @@ jobs:
           CIBW_MUSLLINUX_X86_64_IMAGE: musllinux_1_2
           CIBW_MUSLLINUX_AARCH64_IMAGE: musllinux_1_2
           CIBW_TEST_REQUIRES: pytest pytest-asyncio respx
-          # 坑 3 + 坑 7: 整行加双引号避免 YAML 冒号歧义；强制 binary 防止源码 build 链
+          # 坑 3 + 坑 7: 整行加双引号避免 YAML 冒号歧义; 强制 binary 防止源码 build 链
           CIBW_BEFORE_TEST: "pip install --only-binary=:all: pyarrow pandas"
           # 坑 4 + 坑 5: monorepo 用 {package} 而非 {project}；外单内双跨平台兼容
           CIBW_TEST_COMMAND: 'pytest {package}/tests -v -k "not requires_server"'

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

@@ -0,0 +1,31 @@
+---
+name: dwy-publish
+description: "发版/部署编排器。触发条件：用户说\"发版\"\"部署\"\"发布上线\"\"release\"\"publish\"\"走发版流程\"时。按应用目录确认发布方式并缓存，串起定版本→changelog→安全检查→build/发布→监控→通知。版本号决策单独走 dwy-semver，GA 打包走 dwy-github-action-publish，发布前安全检查走 dwy-sdk-spec——本 skill 负责编排，按路径主动调它们。"
+---
+
+# 发版编排器
+
+一条发版链的编排执行。进入前测试已完成。
+
+**先**读仓库上下文，判目标平台（前端/后端/Android/iOS/鸿蒙/通用）+ 定位应用目录（相对项目根的相对路径）。**再**按下表执行 8 步。
+
+| # | 步骤 | 类型 | 调用 |
+|---|------|------|------|
+| 1 | 确认发布方式 + 探测 build/publish 命令 | 项目步 | `scripts/release_config.sh` + `references/publish-config.md` |
+| 2 | 写/校验发布配置（GA workflow / TestFlight 就绪） | 项目步 | `references/publish-config.md` |
+| 3 | 定版本号 + 多文件同步 | 通用步 | `../dwy-semver` + `references/version-sync.md` |
+| 4 | 写 changelog（按平台子目录） | 通用步 | `references/changelog.md` |
+| 5 | 安全检查（闸门，未过不发） | 通用步 | `../dwy-sdk-spec` |
+| 6 | build + 触发发布 | 项目步 | `references/<平台>.md`；走 GA 引 `../dwy-github-action-publish` |
+| 7 | 监控发布进程 | 项目步 | `references/monitor-notify.md` |
+| 8 | 通知结果（输出结果文本） | — | `references/monitor-notify.md` |
+
+平台流程文件：`frontend-deploy.md` / `backend-deploy.md` / `ios.md` / `android.md` / `harmony.md` / `generic-release.md`。
+
+## 编排约束
+
+- **通用步固化**（定版本/changelog/安全检查跨项目一致，走子 skill/脚本）；**项目步读上下文+缓存**（build/deploy/监控命令因项目而异，**绝不写死**，探测不到问用户后缓存）。
+- 安全检查（第 5 步）是闸门，未过不进发布。
+- 全程 AI 自动判断、自动跑，仅搞不定时才问用户（版本级别拿不准、命令探测不到、配置缺失、构建/发布失败）。
+- 编排时按文件路径主动加载子 skill（`../dwy-semver`、`../dwy-sdk-spec`、`../dwy-github-action-publish`）；这些 skill 也可被用户独立触发。
+- `.dwy/` 缓存提醒用户加进 `.gitignore`。

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

@@ -0,0 +1,31 @@
+# Android 发布流程
+
+适用：Android 产物——**应用包（apk/aab→分发/商店）** 或 **SDK（aar→maven）**。
+
+## 先判产物形态
+
+- 应用包：有 application module、产出 apk/aab → 走 app 路径
+- SDK：library module、产出 aar、有 maven publish 配置 → 走 SDK 路径
+
+## 版本（通用步，固化）
+
+- `versionName` = 语义版本号，走 `../dwy-semver` 决策 + bump.py。
+- `versionCode` = 单调递增整数，每次发布 +1。
+- 多文件同步见 `version-sync.md`。
+
+## build / publish（项目步，不写死命令）
+
+命令来自缓存（build_cmd/publish_cmd），缓存缺则按 `publish-config.md` 探测：
+- 探测线索：`build.gradle(.kts)` task、`gradlew`、`fastlane/`、CI workflow
+- 探测不到→问用户→缓存
+
+按缓存 method 分流：
+- `maven` → 用项目实际的 maven 发布命令（gradle publish task / 私有源）
+- `github-action` → 引 `../dwy-github-action-publish`（先过通用检查）
+- `local` → 缓存的本地构建/发布命令
+
+## changelog / 安全检查 / 监控
+
+- changelog → `changelog.md`（写 `android/CHANGELOG.md`）
+- 安全检查 → `../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

@@ -0,0 +1,23 @@
+# 后端部署流程
+
+适用：后端服务、API、容器或镜像、线上后端环境。
+
+## 版本（通用步，固化）
+
+- 走 `../dwy-semver` 决策 + bump.py；多文件同步见 `version-sync.md`（Python 须同步 `pyproject.toml` 的 `version` 和包 `__init__.py` 的 `__version__`）。
+- 纯重发、仅重跑 workflow、仅补环境配置、仅回滚已有构建时可不 bump。
+
+## build / deploy（项目步，不写死命令）
+
+命令来自缓存（build_cmd/publish_cmd），缓存缺则按 `publish-config.md` 探测：
+- 探测线索：`Dockerfile`、`docker-compose`、部署脚本、`Makefile`、`pyproject.toml`、CI workflow
+- 探测不到→问用户→缓存
+
+按缓存 method 分流：
+- `github-action` → 引 `../dwy-github-action-publish`（CI 推荐 OIDC，先过通用检查）
+- `local` → 缓存的本地构建/部署命令（打镜像 / 部署脚本）
+
+## changelog / 监控
+
+- changelog → `changelog.md`（写 `backend/CHANGELOG.md`）
+- 监控 + verify → `monitor-notify.md`（后端信号：健康检查 / 版本接口 / 运行日志 / 镜像 tag）

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

@@ -0,0 +1,37 @@
+# CHANGELOG 按平台子目录各写一份
+
+monorepo 下一个仓库可能同时含 android / ios / harmony / frontend / backend 多平台。**每个平台维护自己的 CHANGELOG，不写全局单份**。发哪个平台，只写哪个平台那份。
+
+## 各平台 CHANGELOG 位置
+
+- `android/CHANGELOG.md`
+- `ios/CHANGELOG.md`
+- `harmony/CHANGELOG.md`
+- `frontend/CHANGELOG.md`
+- `backend/CHANGELOG.md`
+
+子目录名按仓库实际结构定（先在第 0 步识别平台目录）。
+
+## 写法
+
+1. 找该平台上一个 release tag
+2. 按平台子目录过滤 commit：
+
+```bash
+git log <last-tag>..HEAD --oneline -- <平台子目录>/
+```
+
+3. 按 `feat` / `fix` / `refactor` / `chore` 分组
+4. 写入该平台 `CHANGELOG.md`，标注新版本号
+
+如果仓库已有自动生成命令（changelogen 等），优先使用，但仍按平台目录过滤范围。
+
+## 自动执行
+
+changelog 由 AI 自动生成并写入，不强制逐步确认。仅当 commit 历史无法清晰归类、或平台目录边界不明时才停下问用户。
+
+## 禁止
+
+- 禁止写一份全局 CHANGELOG 混入多平台变更
+- 禁止 changelog 未写完就进入部署
+- 禁止把其他平台的 commit 写进当前平台 CHANGELOG（必须按目录过滤）

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

@@ -0,0 +1,23 @@
+# 前端部署流程
+
+适用：站点、SPA、SSR、前端容器镜像或线上前端环境。
+
+## 版本（通用步，固化）
+
+- 走 `../dwy-semver` 决策 + bump.py；多文件同步见 `version-sync.md`（前端改 `package.json` 的 `version`）。
+- 纯重发、仅重跑 workflow、仅回滚已有构建时可不 bump。
+
+## build / deploy（项目步，不写死命令）
+
+命令来自缓存（build_cmd/publish_cmd），缓存缺则按 `publish-config.md` 探测：
+- 探测线索：`package.json` scripts（build/deploy）、`vite.config.*`、`Dockerfile`、`Makefile`、CI workflow
+- 探测不到→问用户→缓存
+
+按缓存 method 分流：
+- `github-action` → 引 `../dwy-github-action-publish`（CI 推荐 OIDC，先过通用检查）
+- `local` → 缓存的本地构建/部署命令（推镜像 / 传 CDN·OSS / 部署脚本）
+
+## changelog / 监控
+
+- changelog → `changelog.md`（写 `frontend/CHANGELOG.md`）
+- 监控 + verify → `monitor-notify.md`（前端信号：页面访问 / 版本接口 / 产物 hash / CDN 刷新）

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

@@ -0,0 +1,27 @@
+# 通用发布流程（兜底）
+
+适用：不属于前端 / 后端 / Android / iOS / 鸿蒙 五类的发布——CLI 二进制、Docker 镜像、纯 PyPI / npm 库、其他对外包或环境。dwy-shared 自身的 eui / ekit / eapi / cli 走这条。
+
+## 版本（通用步，固化）
+
+- 走 `../dwy-semver` 决策 + bump.py；多文件同步见 `version-sync.md`（Python 同步 `pyproject.toml` + `__init__.py`，Node 同步 `package.json`）。
+- 纯重发、仅重跑 workflow、仅回滚已有构建时可不 bump。
+
+## build / publish（项目步，不写死命令）
+
+命令来自缓存（build_cmd/publish_cmd），缓存缺则按 `publish-config.md` 探测：
+- 探测线索：`package.json` scripts、`pyproject.toml`、`Makefile`、发布脚本、CI workflow
+- 探测不到→问用户→缓存
+
+按缓存 method 分流：
+- `github-action-oidc` → **PyPI/npm 首选**，引 `../dwy-github-action-publish`（OIDC + Trusted Publisher）
+- `github-action` → Cython wheel / Electron / 镜像，引 `../dwy-github-action-publish`
+- `local` → 缓存的本地发包命令（`uv publish` / `pnpm publish` 等）
+
+**PyPI/npm 未配置 GA 时按 `publish-config.md` 主动推荐 OIDC。**
+
+## changelog / 安全检查 / 监控
+
+- changelog → `changelog.md`（单包仓库根目录一份；monorepo 按包目录过滤）
+- 安全检查 → `../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

@@ -0,0 +1,25 @@
+# 鸿蒙发布流程
+
+适用：HarmonyOS ArkTS 产物——**应用包（har app / hap）** 或 **SDK（har→ohpm）**。
+
+## 版本（通用步，固化）
+
+- `oh-package.json5` 的 `version` = 语义版本号，走 `../dwy-semver` 决策 + bump.py。
+- 多文件同步见 `version-sync.md`。
+
+## build / publish（项目步，不写死命令）
+
+命令来自缓存（build_cmd/publish_cmd），缓存缺则按 `publish-config.md` 探测：
+- 探测线索：`build-profile.json5`、ohpm 脚本、DevEco 构建配置、CI workflow
+- 探测不到→问用户→缓存
+
+按缓存 method 分流：
+- `ohpm` → 用项目实际的 ohpm 发布命令（中心仓 / 私有源）
+- `github-action` → 引 `../dwy-github-action-publish`（先过通用检查）
+- `local` → 缓存的本地构建/发布命令
+
+## changelog / 安全检查 / 监控
+
+- changelog → `changelog.md`（写 `harmony/CHANGELOG.md`）
+- 安全检查 → `../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

@@ -0,0 +1,32 @@
+# iOS 发布流程
+
+适用：iOS 产物——**应用包（ipa→TestFlight/App Store）** 或 **SDK（framework/xcframework→CocoaPods/SPM）**。
+
+## 先判产物形态
+
+- 应用包：有 app target、`fastlane/` beta/release lane、TestFlight 上传 → 走 app 路径
+- SDK：产出 framework/xcframework、有 podspec / `Package.swift` → 走 SDK 路径
+
+## 版本（通用步，固化）
+
+- 语义版本号 `CFBundleShortVersionString`，走 `../dwy-semver` 决策 + bump.py。
+- **build 号 `CFBundleVersion` = 时间戳 `yyyyMMddHHmm` 12 位**（如 `202606231430`，`date +%Y%m%d%H%M`），每次发布重新生成，单调递增。app 和 SDK 都适用。
+- 多文件同步见 `version-sync.md`。
+
+## build / publish（项目步，不写死命令）
+
+命令来自缓存（`release_config.sh` 的 build_cmd/publish_cmd），缓存缺则按 `publish-config.md` 探测：
+- 探测线索：`fastlane/Fastfile`、`*.xcodeproj`/`*.xcworkspace`、`Makefile`、CI workflow、`package.json` scripts
+- 探测不到→问用户→缓存
+
+按缓存 method 分流：
+- `testflight` → 用项目实际的 TestFlight 上传命令（fastlane lane / Transporter / altool）
+- `cocoapods` / `spm` → 用项目实际的 pod 发布 / git tag 命令（SPM 以 tag 为版本，tag 须等于 `CFBundleShortVersionString`）
+- `github-action` → 引 `../dwy-github-action-publish`（先过其通用检查）
+- `local` → 缓存的本地命令
+
+## changelog / 安全检查 / 监控
+
+- changelog → `changelog.md`（写 `ios/CHANGELOG.md`）
+- 安全检查 → `../dwy-sdk-spec`（SDK 发布尤其要查泄露）
+- 监控 + 结果 → `monitor-notify.md`

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

@@ -0,0 +1,36 @@
+# 监控发布进程 + 通知结果
+
+发布触发后监控进程直到终态，再输出结果文本。监控方式因 CI / 本地而异（项目步）。
+
+## 监控
+
+发布方式来自缓存 method：
+
+- **CI（github-action / github-action-oidc）**：
+  ```bash
+  gh run watch "$(gh run list --workflow=<release.yml> --limit=1 --json databaseId --jq '.[0].databaseId')" --exit-status
+  ```
+  观察到失败时拉日志定位失败 job：`gh run view <run-id> --json jobs,conclusion`。
+- **本地（local / testflight / maven / cocoapods / ohpm）**：用缓存的 `publish_cmd` 退出码判断，再做产物 / 渠道检查。
+
+## verify
+
+用缓存 `verify_cmd`，或按渠道验证新版本可见：
+
+- npm：`npm view <pkg> version`
+- PyPI：`pip index versions <pkg>`
+- maven / ohpm / cocoapods：对应渠道版本查询
+- TestFlight：App Store Connect 构建状态
+- GitHub Release：`gh release view <tag>`
+- 前端 / 后端：页面访问 / 版本接口 / 健康检查
+
+verify 失败，发布不算完成。
+
+## 通知结果（输出结果文本）
+
+发布终态后在对话里输出结果摘要，不接外部通知：
+
+- **成功**：平台 / 应用目录、版本号、产物、渠道、verify 结果
+- **失败**：失败阶段、关键报错、下一步建议（重发 / bump / 修配置）
+
+涉及删除远端 release / tag 的重发，必须先确认用户允许。

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

@@ -0,0 +1,65 @@
+# 发布方式缓存 + 命令探测
+
+发布方式与 build/publish 命令**因项目而异，不写死**。按应用目录探测 → 问 → 缓存复用。
+
+## 缓存机制
+
+- 缓存文件：`<project_root>/.dwy/publish/config.json`，读写走 `scripts/release_config.sh`。
+- key = **相对项目根的相对目录**（如 `ios`、`apps/electron`，根用 `.`）。
+- `.dwy/` 是本机判断缓存，**提醒用户加进 `.gitignore`**，不入版本库。
+
+## 读写流程
+
+1. 确定本次要发的**应用目录**（相对路径）。
+2. `release_config.sh get <root> <rel_dir>`：
+   - 命中且 `configured=true` → 用缓存的 method + build_cmd/publish_cmd/verify_cmd
+   - 比对 `cmd_source`：若项目里对应命令源（package.json scripts / Fastfile / workflow 等）已变 → 重新探测+问用户+更新缓存
+   - 未命中（首次进入该目录）→ 走第 3 步
+3. 首次配置：
+   - 探测真实命令（见下方探测线索）
+   - AskUserQuestion 问发布方式（见下方各平台候选）
+   - 检查对应配置就绪（GA workflow 是否存在 / TestFlight 凭据线索 / maven·pod publish 配置）
+   - `release_config.sh set <root> <rel_dir> <platform> <method> <channel> <configured> [build_cmd] [publish_cmd] [verify_cmd] [cmd_source]`
+   - 提醒把 `.dwy/` 加进 `.gitignore`
+4. 目录与缓存对不上（仓库结构变了）：先 AI 自助判断目录是否仍正确，判不准再问用户，必要时 `reset` 重建。
+
+全程 AI 自动跑，仅探测不到 / 命令歧义 / 配置缺失时才问用户。
+
+## build/publish 命令探测线索（不写死，按项目找）
+
+| 平台 | 去哪找真实命令 |
+|------|---------------|
+| 前端 | `package.json` scripts（build/deploy）、`vite.config.*`、`.github/workflows/`、`Makefile` |
+| 后端 | `Dockerfile`、`docker-compose`、部署脚本、`Makefile`、`pyproject.toml`、`.github/workflows/` |
+| iOS | `fastlane/Fastfile`、`*.xcodeproj` / `*.xcworkspace`、`Makefile`、CI workflow、`package.json` scripts |
+| Android | `build.gradle(.kts)` task、`gradlew`、`fastlane/`、CI workflow |
+| 鸿蒙 | `build-profile.json5`、ohpm 脚本、DevEco 构建配置、CI workflow |
+| 通用包 | `package.json` scripts、`pyproject.toml`、`Makefile`、发布脚本、`.github/workflows/` |
+
+探测到多个候选时问用户选；探测不到时问用户给命令。命令存进缓存的 `build_cmd`/`publish_cmd`/`verify_cmd`。
+
+## 各平台发布方式候选（AskUserQuestion）
+
+先按平台 + 产物形态（应用包 vs SDK）裁剪候选，推荐项标注：
+
+| platform / 产物 | method 候选 |
+|------|------|
+| ios 应用包（ipa） | `testflight`(推荐) / `github-action` / `local` / `manual` |
+| ios SDK（framework/xcframework） | `cocoapods` / `spm` / `github-action` / `local` |
+| android 应用包（apk/aab） | `github-action`(推荐) / `local` |
+| android SDK（aar） | `maven`(推荐) / `github-action` / `local` |
+| harmony（har / har app） | `ohpm`(推荐) / `github-action` / `local` |
+| frontend | `github-action`(CI，推荐 OIDC) / `local` |
+| backend | `github-action`(CI，推荐 OIDC) / `local` |
+| generic — PyPI/npm | `github-action-oidc`(**推荐**，无静态凭据、符合团队准则) / `local` |
+| generic — Cython wheel | `github-action`(cibuildwheel) / `local` |
+| generic — Electron | `github-action`(多平台 runner) / `local` |
+| generic — Docker/二进制 | `github-action` / `local` |
+
+## PyPI / npm 首次配置：主动推荐 GitHub Action OIDC
+
+PyPI / npm 且未配置 GA 时，**主动推荐 `github-action-oidc`**（OIDC Trusted Publishing，无长期静态凭据）：
+
+- 给 workflow 模板：见 `../dwy-github-action-publish`（Python wheel / 纯包 OIDC）。
+- 给 Trusted Publisher 网页配置步骤：PyPI/npmjs 后台绑定 repo + workflow 文件名 + environment。
+- 用户仍可选 `local`（`uv publish` / `pnpm publish` 等），按其选择缓存。

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

@@ -0,0 +1,30 @@
+# 版本号多文件同步
+
+版本号定好后，**同一次发布的所有版本来源文件必须改到完全一致**。一个技术栈往往有多处版本声明，漏改一处就会导致包内版本不一致、构建产物版本错乱。
+
+## 各技术栈版本来源清单
+
+| 技术栈 | 版本来源文件 | 字段 |
+|------|------|------|
+| Python | `pyproject.toml` + 包 `__init__.py` | `version` / `__version__` |
+| Node/Vue | `package.json` | `version` |
+| Android | `build.gradle(.kts)` | `versionName`（语义号）+ `versionCode`（整数，每次发布递增） |
+| iOS | `Info.plist` 或 `project.pbxproj` | `CFBundleShortVersionString`（语义号）+ `CFBundleVersion`（build 号，见 `sdk-ios.md`） |
+| 鸿蒙 | `oh-package.json5` | `version` |
+
+## 规则
+
+- **Python**：`pyproject.toml` 的 `version` 与包 `__init__.py` 的 `__version__` 两处必须一致。
+- **Android**：`versionName` 用语义版本号；`versionCode` 是单调递增整数，与语义号无关，每次发布 +1。
+- **iOS**：`CFBundleShortVersionString` 用语义版本号；`CFBundleVersion`（build 号）用时间戳，规则见 `sdk-ios.md`。
+- 改完后用 grep 全仓库扫一遍旧版本号，确认无遗漏：
+
+```bash
+grep -rn "<旧版本号>" --include=pyproject.toml --include=package.json --include="*.gradle*" --include="*.plist" --include="oh-package.json5" .
+```
+
+## 禁止
+
+- 禁止只改一处版本来源就发布（如只改 `pyproject.toml` 漏改 `__init__.py`）
+- 禁止用会自动 commit 的版本命令（`npm version` / `bumpversion` 等），直接编辑文件，保持提交边界可控
+- 禁止 `versionCode` / `CFBundleVersion` 不递增就重发（应用商店会拒）

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/scripts/release_config.sh

@@ -0,0 +1,115 @@
+#!/usr/bin/env bash
+# dwy-publish 发布方式缓存读写
+# 缓存写项目内 <project_root>/.dwy/publish/config.json，key 用相对项目根的相对目录
+# 用法:
+#   release_config.sh get   <project_root> <rel_dir>
+#   release_config.sh set   <project_root> <rel_dir> <platform> <method> <channel> <configured> [build_cmd] [publish_cmd] [verify_cmd] [cmd_source]
+#   release_config.sh reset <project_root> <rel_dir>
+#   release_config.sh list  <project_root>
+#
+# 设计要点（与发布编排配套）:
+#   - 通用步(定版本/changelog/安全检查)不进缓存,走固化流程
+#   - 项目步(build/publish/verify)命令因项目而异,探测/确认后存这里复用
+#   - cmd_source 是命令来源指纹,编排器 get 后比对,变更则重新问用户更新
+
+set -euo pipefail
+
+config_file() {
+  echo "${1%/}/.dwy/publish/config.json"
+}
+
+ensure_config() {
+  local root="$1"
+  local dir="${root%/}/.dwy/publish"
+  local file
+  file="$(config_file "$root")"
+  mkdir -p "$dir"
+  if [[ ! -f "$file" ]]; then
+    echo '{"version":"1","apps":{}}' > "$file"
+  fi
+  # 检测损坏
+  if ! jq empty "$file" 2>/dev/null; then
+    echo "ERROR: $file is corrupted. Back it up and delete to reset." >&2
+    exit 2
+  fi
+}
+
+cmd_get() {
+  local root="$1" rel="$2"
+  ensure_config "$root"
+  jq --arg p "$rel" '.apps[$p] // null' "$(config_file "$root")"
+}
+
+cmd_set() {
+  local root="$1" rel="$2" platform="$3" method="$4" channel="$5" configured="$6"
+  local build_cmd="${7:-}" publish_cmd="${8:-}" verify_cmd="${9:-}" cmd_source="${10:-}"
+
+  case "$platform" in
+    frontend|backend|ios|android|harmony|generic) ;;
+    *) echo "ERROR: platform must be one of frontend|backend|ios|android|harmony|generic, got: $platform" >&2; exit 2 ;;
+  esac
+  case "$configured" in
+    true|false) ;;
+    *) echo "ERROR: configured must be 'true' or 'false', got: $configured" >&2; exit 2 ;;
+  esac
+  if [[ -z "$method" ]]; then
+    echo "ERROR: method must not be empty" >&2; exit 2
+  fi
+
+  ensure_config "$root"
+  local now file tmp
+  now=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+  file="$(config_file "$root")"
+  tmp=$(mktemp)
+  jq \
+    --arg p "$rel" \
+    --arg pl "$platform" \
+    --arg m "$method" \
+    --arg c "$channel" \
+    --arg b "$build_cmd" \
+    --arg pub "$publish_cmd" \
+    --arg v "$verify_cmd" \
+    --arg cs "$cmd_source" \
+    --argjson cfg "$configured" \
+    --arg t "$now" \
+    '.apps[$p] = {platform:$pl, method:$m, channel:$c, build_cmd:$b, publish_cmd:$pub, verify_cmd:$v, cmd_source:$cs, configured:$cfg, configured_at:$t}' \
+    "$file" > "$tmp"
+  mv "$tmp" "$file"
+
+  echo "OK: cached $rel -> $platform/$method"
+  echo "Remember to add .dwy/ to .gitignore (本机判断缓存，不入版本库)"
+}
+
+cmd_reset() {
+  local root="$1" rel="$2"
+  ensure_config "$root"
+  local file tmp
+  file="$(config_file "$root")"
+  tmp=$(mktemp)
+  jq --arg p "$rel" 'del(.apps[$p])' "$file" > "$tmp"
+  mv "$tmp" "$file"
+  echo "OK: removed $rel from cache"
+}
+
+cmd_list() {
+  local root="$1"
+  ensure_config "$root"
+  jq '.apps | to_entries | map({dir: .key, platform: .value.platform, method: .value.method, configured: .value.configured})' "$(config_file "$root")"
+}
+
+main() {
+  if [[ $# -lt 1 ]]; then
+    echo "Usage: $0 {get|set|reset|list} <project_root> [args...]" >&2
+    exit 2
+  fi
+  local action="$1"; shift
+  case "$action" in
+    get)   cmd_get "$@" ;;
+    set)   cmd_set "$@" ;;
+    reset) cmd_reset "$@" ;;
+    list)  cmd_list "$@" ;;
+    *) echo "ERROR: unknown action: $action" >&2; exit 2 ;;
+  esac
+}
+
+main "$@"