create-dwy 0.16.0 → 0.17.0

package/templates/ai-tools/rules/HarmonyOS/dwy-harmony-pitfalls.md

@@ -0,0 +1,72 @@
+---
+description: 鸿蒙踩坑四栏归档（现象/根因/正确做法/适用）。事前规范见 dwy-arkts-ui-design / dwy-arkts-ui-build / dwy-arkts-strict
+paths:
+  - "**/*.ets"
+  - "**/build-profile.json5"
+---
+
+# 鸿蒙开发坑清单（归档）
+
+> **事前约束**请先读：
+>
+> | 文件 | 用途 |
+> |---|---|
+> | `dwy-arkts-strict.md` | 语言禁用语法 |
+> | `dwy-arkts-ui-build.md` | 组件 API / 构建 / 设备与运行时 |
+> | `dwy-arkts-ui-design.md` | UI 弹层/顶栏/加载态规范 |
+>
+> 本文件只记 **已踩过的坑**（四栏）。新坑：先按格式追加 → 再把「正确做法」回写到对应规范文件，避免规范与归档脱节。
+
+## 分类索引
+
+- ArkUI 弹层 / 出码
+- 工程与设备网络
+
+---
+
+## ArkUI 弹层 / 出码
+
+### bindSheet 系统 × 与内容自绘 × / 顶栏按钮重叠
+
+- **现象**：右上两颗 ×，或系统 × 与「扫码/配对码」「新增」「复制全部」贴在一起。
+- **根因**：`showClose` 与内容自绘关闭/右侧操作同区叠放。
+- **正确做法**：见 `dwy-arkts-ui-design.md` §2（二选一）；禁止省略 `showClose`。
+- **适用**：所有 `bindSheet`。
+
+### 内容区 × 是清空不是关 sheet
+
+- **现象**：键盘输入框旁 × 被当成关弹层。
+- **根因**：语义是清空输入。
+- **正确做法**：见 `dwy-arkts-ui-design.md` §3。
+- **适用**：Keyboard / 搜索。
+
+### ScanKit 二维码模拟器空白 + 永久 spinner
+
+- **现象**：配对扫码页只转圈，无码图。
+- **根因**：HVD 上 `generateBarcode` 常失败；失败 UI 仍 loading。
+- **正确做法**：见 `dwy-arkts-ui-build.md` §14 + `dwy-arkts-ui-design.md` §4（兜底出图 + 三态）。
+- **适用**：出码展示。
+
+---
+
+## 工程与设备网络
+
+### unsigned.hap 真机装不上
+
+- **现象**：CLI 打包成功，真机安装失败。
+- **根因**：未配置 `signingConfigs`。
+- **正确做法**：见 `dwy-arkts-ui-build.md` §11。
+- **适用**：真机分发。
+
+### 模拟器代理设置无法让 ADB 连局域网电视
+
+- **现象**：在 HVD「代理设置」里配代理/DNS，仍连不上 `192.168.x.x:5555`。
+- **根因**：代理只走 HTTP 出网；app 用原始 TCP；HVD 为 NAT 非 LAN peer。
+- **正确做法**：见 `dwy-arkts-ui-build.md` §13；真机同 Wi-Fi。
+- **适用**：局域网调试类产品。
+
+### HVD 命令行启停
+
+- **现象**：不会脱离 IDE 起模拟器。
+- **正确做法**：见 `dwy-arkts-ui-build.md` §12。
+- **适用**：脚本化调试。

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

@@ -282,6 +282,53 @@ class CreateUserRequest(BaseModel):
 - 所有类、所有方法/函数（含私有）**必须**有 docstring
 - docstring 统一使用 **Google 风格**
 
+### 临时代码标识（强制）
+
+产品源码中的业务待办、调试旁路、假数据**必须**用固定标签，便于编辑器全局搜索。`tests/` 内正规 mock / fixture **不强制**。
+
+| 标签 | 用途 | 格式 |
+|---|---|---|
+| `TODO` | 业务/技术未完成 | `# TODO(name, YYYY-MM-DD): 说明`（推荐带责任人与日期） |
+| `TESTCODE` | 临时调试、跳过校验、试验开关 | `# TESTCODE: 说明 + 移除条件` |
+| `MOCK` | 假数据、假接口、stub 实现 | `# MOCK: 说明 + 将来替换点` |
+
+- 写 mock/调试代码的**同一 diff 必须带标**；接真实现后**删标签与包夹**
+- 禁止无标签假返回；禁止自造 `# 假数据`、`# test only` 等替代词
+- 发版/提测前 `rg 'MOCK|TESTCODE'`，清单交给负责人确认（允许残留但须知情）
+
+**单行**（仅一行代码）：
+
+```python
+# MOCK: 登录假 token，接 POST /auth/login 后删除
+return {"token": "fake-token"}
+
+# TESTCODE: 强制测试账号，提测前删除
+user_id = 1
+```
+
+**多行 / 大段（≥2 行逻辑）强制包夹**：
+
+```text
+# MOCK BEGIN: <说明 + 将来替换点>
+...
+# MOCK END
+
+# TESTCODE BEGIN: <说明 + 移除条件>
+...
+# TESTCODE END
+```
+
+```python
+# MOCK BEGIN: 用户详情假数据，接 UserRepository.get 后删除
+user = {
+    "id": 1,
+    "name": "张三",
+    "roles": ["admin"],
+}
+return user
+# MOCK END
+```
+
 ### 完整示例（模块 / 类 / 方法 / 私有方法 docstring）
 
 ```python

package/templates/ai-tools/rules/Vue/dwy-vue-core.md

@@ -453,6 +453,60 @@ import type { UserInfo } from '@/features/users/types'
 5. 全部使用**中文**，**禁止**混用中英文
 6. 代码改了，注释**必须**同步更新
 
+### 临时代码标识（强制 · TS / Vue）
+
+产品源码（`src/`）中的业务待办、调试旁路、假数据**必须**用固定标签。`tests/` 内 Vitest mock **不强制**。
+
+| 标签 | 用途 | 格式 |
+|---|---|---|
+| `TODO` | 业务/技术未完成 | `// TODO(name, YYYY-MM-DD): 说明`（推荐） |
+| `TESTCODE` | 临时调试、`console` 后门、试验开关 | `// TESTCODE: 说明 + 移除条件` |
+| `MOCK` | 假数据、假接口、stub | `// MOCK: 说明 + 将来替换点` |
+
+- `<script>` / `.ts` 用 `//`；模板用 `<!-- ... -->`
+- 写 mock/调试的**同一 diff 必须带标**；接真实现后**删标签与包夹**
+- 禁止无标签假返回；禁止自造 `// 假数据` 等替代词
+- 发版前搜 `MOCK`、`TESTCODE`，清单确认（允许残留但须知情）
+
+**单行**（仅一行代码）：
+
+```ts
+// MOCK: 首页 banner 假数据，接 GET /banners 后删除
+const banners = ref([{ id: 1, title: 'demo' }])
+
+// TESTCODE: 打开时 dump store，上线前删除
+// console.log(store.$state)
+```
+
+**多行 / 大段（≥2 行逻辑）强制包夹**：
+
+```text
+// MOCK BEGIN: <说明 + 将来替换点>
+...
+// MOCK END
+
+// TESTCODE BEGIN: <说明 + 移除条件>
+...
+// TESTCODE END
+```
+
+```ts
+// MOCK BEGIN: 首页假数据，接 GET /home 后删除
+const banners = ref([
+  { id: 1, title: 'demo-a' },
+  { id: 2, title: 'demo-b' },
+])
+const user = ref({ name: '张三' })
+// MOCK END
+```
+
+```vue
+<!-- MOCK BEGIN: 无接口时的占位，接 CMS 后删除 -->
+<div>占位标题</div>
+<div>占位副标题</div>
+<!-- MOCK END -->
+```
+
 ### 示例
 
 ```typescript
@@ -509,6 +563,7 @@ AI 编写或审查 Vue 代码时，**必须**检查以下违规模式：
 | 解构 store 丢响应性 | `const { x } = store`（应用 `storeToRefs`） | 高 |
 | 注释缺失 | 导出函数 / 类型 / 接口字段无中文注释 | 中 |
 | 注释为英文 | 项目中文环境下写英文注释 | 中 |
+| 无标签 mock/调试 | `src/` 假数据或调试旁路未标 `MOCK:` / `TESTCODE:` | 高 |
 | 硬编码 API 地址 | URL 直接写在代码里，未走 `import.meta.env` | 高 |
 | 相对路径回溯 | `../../../` 跨层导入 | 中 |
 | scoped 替代 Tailwind | 大段 scoped CSS 实现可用 Tailwind 表达的样式 | 中 |

package/templates/ai-tools/rules/iOS/dwy-ios-pitfalls.md

@@ -157,3 +157,10 @@ paths:
 - **根因**：`switch` 在视图树里每次只保留当前 case 的子树，切 tab 时 SwiftUI **销毁**旧 tab 视图、**重建**新 tab 视图，`@State` 随之重置。它不是缓存容器。
 - **正确做法**：用系统 `TabView(selection:)` + 每页 `.tag(...)`。TabView 保活所有 tab 页，切换只是显隐，状态天然保留。隐藏系统 tab bar（`.toolbar(.hidden, for: .tabBar)`）后用自绘底栏，`selection` 与自绘栏共用同一 `@State`。注意别用 `.tabViewStyle(.page)`（会引入左右滑动切页，与边缘返回手势冲突）。
 - **适用**：iOS 16+ SwiftUI 多 tab 且需保留各 tab 页内状态时。
+
+### Mac（Designed for iPhone/iPad）上 sheet 不继承 Observable environment，弹层即崩
+
+- **现象**：iPhone 真机正常；把 iOS app 装到 macOS（「在 Mac 上使用 iPhone/iPad App」）后，一点「解锁」/付费墙/编辑设备/键盘 sheet 就崩。崩溃报告 `EXC_BREAKPOINT` / `SIGTRAP`，栈顶 `libswiftCore _assertionFailure` → `SwiftUICore EnvironmentValues.subscript.getter` → `SheetBridge.present` / `PresentationHostingController`。应用日志只到 `app 启动`。
+- **根因**：`@Environment(Store.self)` / `@Environment(AppRouter.self)` 在未注入时会 fatal。iPhone 上 sheet 内容通常继承父树的 `.environment(...)`；Mac 上 UIKitMacHelper 走 `PresentationHostingController`，**不把父视图的 Observable environment 传进 sheet**，于是 `PaywallView` 等一 present 就 assertionFailure。
+- **正确做法**：凡 sheet / fullScreenCover 内容里读了 `@Environment(SomeObservable.self)`，在 content 上**显式** `.environment(store)` / `.environment(router)` 重注入，不要依赖继承。嵌套 sheet 同样要再注一次。例：`PaywallView().environment(store)`、`DeviceEditSheet(...).environment(router)`、`KeyboardSheet().environment(router)`。
+- **适用**：iOS 17+ `@Observable` + `.environment(instance)`，且 app 会在 Mac 上以 Designed for iPhone/iPad 运行时。iPhone 上不重注入多数也能跑，但为跨平台一致应一律重注入。

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

@@ -36,6 +36,52 @@ final class TaskListViewModel {}
 - 统一 `guard` + early return，不要多层 `else`。
 - 禁止 `try?` 吞异常；不写无意义 `value ?? default`。
 
+### 临时代码标识（强制）
+
+产品源码中的业务待办、调试旁路、假数据**必须**用固定标签（`//`，勿写进正式 `///` 文档注释）。单元测试 / UITest 正规 mock **不强制**。
+
+| 标签 | 用途 | 格式 |
+|---|---|---|
+| `TODO` | 业务/技术未完成 | `// TODO(name, YYYY-MM-DD): 说明`（推荐） |
+| `TESTCODE` | 临时调试、跳过生物识别/鉴权等 | `// TESTCODE: 说明 + 移除条件` |
+| `MOCK` | 假数据、stub Service | `// MOCK: 说明 + 将来替换点` |
+
+- 写 mock/调试的**同一 diff 必须带标**；接真实现后**删标签与包夹**
+- 禁止无标签假返回；禁止自造 `// 假数据` 等替代词
+- 发版/提测前搜 `MOCK`、`TESTCODE`，清单确认（允许残留但须知情）
+
+**单行**（仅一行代码）：
+
+```swift
+// MOCK: 个人资料假数据，接 ProfileService.fetch 后删除
+let profile = Profile(name: "Demo", avatarURL: nil)
+
+// TESTCODE: 跳过生物识别，提测包删除
+// return true
+```
+
+**多行 / 大段（≥2 行逻辑）强制包夹**：
+
+```text
+// MOCK BEGIN: <说明 + 将来替换点>
+...
+// MOCK END
+
+// TESTCODE BEGIN: <说明 + 移除条件>
+...
+// TESTCODE END
+```
+
+```swift
+// MOCK BEGIN: 个人资料假数据，接 ProfileService.fetch 后删除
+let profile = Profile(
+    name: "Demo",
+    avatarURL: nil,
+    roles: ["user"]
+)
+// MOCK END
+```
+
 ## 全面屏与布局
 
 - 默认尊重安全区；固定内容区用 `safeAreaInset` / `safeAreaPadding`。

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

@@ -135,16 +135,19 @@ Scope 由 AI 根据变更模块与项目语义自行决定，保持与现有提
 
 ## 8. AI 署名与生成声明治理
 
-commit 的 subject、body、footer、trailer 中禁止出现：
+commit 的 subject、body、footer、trailer 中禁止出现任何形式的 AI 署名或生成声明。AI 应自行判断：凡由 AI 工具（Claude、ChatGPT、GPT、Copilot、Cursor、Gemini、Llama、LLM 等）生成或参与撰写的署名、尾随声明、自动生成标记，均不得写入 commit message。
 
-- `Co-Authored-By: Claude ...`
-- `Generated with Claude Code`
-- `Generated with ...`
-- `Claude`、`ChatGPT`、`GPT`、`Copilot`、`Cursor`、`AI`、`LLM`
-- `noreply@anthropic.com`、`noreply@openai.com`
+包括但不限于：
+
+- `Co-Authored-By: <AI 名称> <noreply@...>`（任何 AI 产品 + 邮箱组合）
+- `Generated with Claude Code` / `Generated with ...`（任何"由 XX 生成"声明）
+- 含 AI 产品名的署名行（Claude、ChatGPT、GPT、Copilot、Cursor、Gemini、LLM 等）
+- AI 平台noreply 邮箱（noreply@anthropic.com、noreply@openai.com 等）
 
 `git commit -m "..."` 不得附带 AI 署名 trailer。
 
+> PreToolUse hook `pre-git-commit-ai-signature-check.sh` 会在 commit message 中检出 Co-Authored-By / Generated with 等 AI 署名模式时硬拦截（exit 2），规则约束 + 工程兜底双保险。
+
 ## 9. 参考示例
 
 - `feat(eui): 添加 Image 组件懒加载支持`

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

@@ -0,0 +1,128 @@
+---
+description: 商用/销售类应用的开源依赖许可合规（禁不可商用与强 copyleft；仅强制署名时在隐私协议附录声明含版本）
+---
+
+# 商用开源依赖许可合规（强制）
+
+> 销售、SaaS、付费 App、对外交付的商业产品引入开源库时，
+> 许可不合规会带来版权/违约风险。本规则约束：选型禁区 + 强制署名时的声明义务。
+
+## 一、适用边界
+
+- **适用**：任何面向收费/销售/对外商用的应用（含内部先试用后商用的产品）
+- **不适用**：纯学习/练手/未商用的 builder 原型（一旦要上架/收费，必须补齐本规则）
+- **覆盖栈**：npm/pnpm、PyPI/uv、CocoaPods/SPM、Gradle/Maven、ohpm、pub、Docker 基础镜像、字体/图标/素材、模型权重与 SDK
+- **声明范围**：仅 **直接依赖**；不强制盘传递依赖
+
+## 二、核心原则（三条）
+
+1. **先查许可，再装依赖** — 未确认 license 的包禁止引入
+2. **明确不可商用 / 强 copyleft → 禁止直接使用** — 换可商用替代，或购买商业授权
+3. **仅当许可强制要求署名 / NOTICE 时**，才在隐私协议附录中声明（含版本）；**不强制署名的库不必写**
+
+## 三、禁止引入（不可商用 / 高法律风险）
+
+以下类型**默认禁止**写入依赖树（直接依赖必须查；已知会把禁区 license 顶进运行时链接的包也不得引）：
+
+| 类型 | 常见标识 | 原因 |
+|---|---|---|
+| 明确非商业 | `CC-BY-NC*`、`CC-NC`、`PolyForm-Noncommercial`、许可证写 Non-Commercial / No Commercial Use | 商用即侵权 |
+| 强传染 copyleft（闭源商用） | `GPL-2.0`、`GPL-3.0`、`AGPL-3.0`、`SSPL` | 可能强制整包开源或限制网络服务形态；**闭源商用一律禁止** |
+| 限制竞争/生产用途 | `BUSL`（未到 Change Date 且限制 Production）、Commons Clause、部分 Source-Available | 表面开源，实则禁商用或禁竞争 |
+| 仅免费个人/评估 | 字体/图标/SDK 写 "free for personal use only"、"evaluation only" | 商用需买授权 |
+| 无 license / 自定义模糊条款 | 仓库无 LICENSE、或 "all rights reserved" 却当开源用 | 默认不可用 |
+
+### 例外（必须显式记录）
+
+- 已购买**商业授权**且合同覆盖当前用途 → 可引入，记录授权方、合同编号、到期日
+- LGPL 等边界许可 → 不得默认通过，须单独评估后再定
+
+### 选型动作（强制）
+
+引入新依赖时在选型对比中增加一列 **License**，并标注：
+
+- `OK-商用`（可商用；若无强制署名义务则声明页可不写）
+- `OK-商用+强制署名`（MIT/BSD/Apache-2.0/ISC 等要求保留版权与许可声明 → 须进隐私协议附录）
+- `OK-商用+额外义务`（如 Apache NOTICE、MPL 文件级 copyleft 等 → 按义务处理，署名类进附录）
+- `禁-不可商用/高风险`（上表）→ **不得推荐为默认项**
+
+## 四、强制署名时的声明义务
+
+### 4.1 何时必须声明（仅此场景）
+
+直接依赖的 license **明确要求** attribution / copyright notice / NOTICE / 保留许可文本时，必须声明。
+
+**不强制署名则不写**：无保留声明义务的可商用库，不必塞进隐私协议或开源列表。
+
+### 4.2 声明落点
+
+- **唯一约定落点**：隐私协议 **附录**「第三方开源组件」
+- 不与个人信息处理条款正文混写；附录与正文分节
+- 若产品另有「关于 / 法律信息」页，可链到该附录，不替代附录本身
+
+### 4.3 每条声明最低字段（强制）
+
+| 字段 | 说明 | 示例 |
+|---|---|---|
+| 组件名 | 直接依赖包名 | `axios` |
+| 版本 | **实际锁定版本**（lockfile / 构建锁定） | `1.7.9` |
+| 许可证 | SPDX 标识 | `MIT` |
+| 版权声明 | 来自 LICENSE / 包元数据 | `Copyright (c) 2014-present Matt Zabriskie` |
+| 许可全文或链接 | 全文或稳定 URL | `https://opensource.org/licenses/MIT` |
+
+**版本必须写锁定版本**，禁止只写 `latest` 或不写版本。
+
+### 4.4 声明模板（可直接贴进隐私协议附录）
+
+```text
+附录：第三方开源组件
+
+本产品直接使用的、且许可证要求保留声明的开源组件如下：
+
+1. axios 1.7.9
+   License: MIT
+   Copyright (c) 2014-present Matt Zabriskie
+   https://github.com/axios/axios/blob/v1.7.9/LICENSE
+
+2. dayjs 1.11.13
+   License: MIT
+   Copyright (c) 2018-present, iamkun
+   https://github.com/iamkun/dayjs/blob/v1.11.13/LICENSE
+```
+
+仅列 **直接依赖 + 许可强制署名** 的项；无强制署名义务的直接依赖不列。
+
+### 4.5 何时更新声明
+
+- 新增/替换直接依赖，且其许可强制署名
+- 已声明组件的主版本或锁定版本变更
+- 发版前：附录中的版本 vs lockfile **必须一致**；已移除的组件从附录删掉
+
+## 五、执行检查清单（引入依赖 / 发版前）
+
+- [ ] 直接依赖均有明确 SPDX license（或等价官方许可文本）
+- [ ] 无 NC / 非商业 / GPL / AGPL / SSPL / 评估版字体图标等禁区
+- [ ] 无未评估的 LGPL / 商业授权到期风险
+- [ ] 仅对「许可强制署名」的直接依赖写入隐私协议附录（含版本号）
+- [ ] 不强制署名的库未滥写进附录
+- [ ] 附录版本与 lockfile 一致
+
+## 六、AI 行为约束
+
+- 推荐开源方案时：**必须带 license 与商用结论**（OK / OK+强制署名 / 禁 / 需商业授权）
+- 候选为 NC / GPL / AGPL / SSPL / 无 license：**不得作为推荐默认项**；列出可商用替代
+- 生成/修改隐私协议时：扫描直接依赖，**只把强制署名的项**写入附录「第三方开源组件」
+- 不得以「业界都在用」跳过 license 核查
+- 不得把无强制署名义务的库整表刷进隐私协议
+
+## 七、常见许可速查（非穷尽）
+
+| SPDX | 商用闭源 | 是否强制进隐私协议附录 |
+|---|---|---|
+| MIT / ISC / BSD-2/3 | 可 | **是**（要求保留版权与许可声明） |
+| Apache-2.0 | 可 | **是**（保留 NOTICE / 声明） |
+| MPL-2.0 | 通常可 | 按义务；修改过的 MPL 文件另有开源义务 |
+| LGPL-2.1/3.0 | 须单独评估 | 评估通过后再定声明 |
+| GPL / AGPL / SSPL | **禁** | —（不得引入） |
+| CC-BY-NC* | **禁** | —（不得引入） |
+| 无 license | **禁** | —（不得引入） |

package/templates/ai-tools/skills//345/205/203/345/267/245/345/205/267/dwy-shared/SKILL.md

@@ -153,10 +153,31 @@ git -C "$REPO_PATH" mv <仓库内相对路径> <new-相对路径>
 
 **冲突处理**：目标已存在 → AskUserQuestion 让用户选「覆盖 / 改名 / 取消」。
 
+### 步骤 6.5：bump ai-tools 内部版本 + CHANGELOG（强制）
+
+凡改动 `$REPO_PATH/dwy-cli/templates/ai-tools/` 下任意内容，**必须**同批更新：
+
+| 文件 | 动作 |
+| ---- | ---- |
+| `dwy-cli/templates/ai-tools/VERSION` | 按 `CHANGELOG.md` 内维护约定 bump（MAJOR / MINOR / PATCH） |
+| `dwy-cli/templates/ai-tools/CHANGELOG.md` | 顶部追加 `## x.y.z — YYYY-MM-DD` 段 + Added/Changed/Fixed/Removed |
+
+约定全文见：`$REPO_PATH/dwy-cli/templates/ai-tools/CHANGELOG.md`「维护约定」。
+
+- 新增 skill/rule/hook/command 或新增强制约束 → 至少 **MINOR**
+- 仅修正文案 / 链接 / 不改强制语义 → **PATCH**
+- 破坏同步结构 / 删除广泛依赖项且无迁移 → **MAJOR**
+
+**禁止**只提交模板文件而不改 `VERSION` + `CHANGELOG.md`。
+
 ### 步骤 7：staged + 显示 diff
 
 ```bash
 git -C "$REPO_PATH" add <精准路径>
+# 务必包含 VERSION 与 CHANGELOG
+git -C "$REPO_PATH" add \
+  "$REPO_PATH/dwy-cli/templates/ai-tools/VERSION" \
+  "$REPO_PATH/dwy-cli/templates/ai-tools/CHANGELOG.md"
 git -C "$REPO_PATH" status --short
 git -C "$REPO_PATH" diff --cached --stat
 ```
@@ -170,7 +191,7 @@ git -C "$REPO_PATH" diff --cached --stat
 按项目 `CLAUDE.md` 中 Git Commit Scope 规范：
 - scope: `cli`
 - type: `feat`（新模板）/ `fix`（修复模板）/ `docs`（仅文档）
-- subject: 中文动宾短语 ≤72 字符
+- subject: 中文动宾短语 ≤72 字符；可附 ai-tools 版本号（如 `ai-tools 0.2.0`）
 - **禁** AI 署名 / Co-Authored-By trailer
 
 模板：

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-ios-app-store-release/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: dwy-ios-app-store-release
+description: "iOS/macOS App Store 上架编排。用户要求创建或填写 App Store Connect 应用资料、生成并上传 iOS/macOS 截图、配置全地区定价、创建内购/自动续期订阅、提交 TestFlight 或 App Review 时使用。使用 App Store Connect API 自动填充，使用已登录 Playwright 补齐网页专属步骤；首次运行在用户私有目录缓存 API 配置。"
+---
+
+# iOS/macOS App Store 上架
+
+将开发完成的 Apple 应用整理为可确认、可审计、可重复执行的发布包。API 优先；新建 App Record、App Privacy 等 API 外页面才使用已登录 Playwright。
+
+## 安全边界
+
+- Skill 模板目录禁止保存任何 API Key、`.p8` 私钥、Cookie、审核账号密码或税务材料。
+- 只从 `/Users/chances/.dwy/app-store-connect/` 读取用户私有配置。首次运行时询问 Issuer ID、Key ID、团队和私钥文件位置，再调用 `scripts/appstore_config.sh` 写入。
+- 不将秘密写入项目、Git、`appstore-submission.yaml` 或执行日志。审核账号在发布包中只能使用钥匙串或环境变量引用。
+- 提交审核、正式发布、价格上调前，必须显示变更并获得用户二次确认。
+
+## 首次配置
+
+1. 执行 `scripts/appstore_config.sh init`，创建权限 `0700` 的用户私有目录。
+2. 逐项询问用户，再执行 `set --issuer-id <id> --key-id <id> [--team-id <id>]`。
+3. 用户提供现有 `.p8` 文件路径后，执行 `import-key --path <absolute-path>`；禁止让用户在聊天中粘贴私钥内容。
+4. 使用 `get` 验证非秘密标识；不要打印私钥或会话文件。
+
+## 发布包与资料收集
+
+将 `assets/appstore-submission.yaml` 复制到用户私有目录下 `submissions/<bundle-id>/`，逐步收集并在每步确认：
+
+1. 应用身份：Bundle ID、SKU、名称、分类、版权、年龄分级和构建。
+2. 产品页：只维护 `zh-Hans`、`en-US` 的名称、副标题、描述、关键词、支持/营销/隐私 URL。
+3. 截图：按 [截图工作流](references/screenshot-workflow.md) 从真实应用采集 iOS 与 macOS 图，分别校验后上传。
+4. 合规：隐私、第三方 SDK、内容权利、加密、审核账号和测试路径。法律真实性由用户确认。
+5. 商业：应用价格、全地区可售、内购或订阅的权益、价格、地区和审核截图。
+
+## 地区、ICP 与本地化
+
+- 默认应用、内购和订阅均为 `all_territories`；产品页本地化仅 `zh-Hans`、`en-US`。
+- ICP/APP 备案号为非阻塞字段。缺失时继续配置其它全部地区，并在执行报告标记中国大陆待办。
+- 用户后续提供备案号后，单独写入并启用中国大陆；不得重新填写其它已确认资料。
+
+## 自动化顺序
+
+1. 读取发布包、项目构建信息和 API 配置，先输出完整 diff。
+2. 用 API 写入 App 信息、版本本地化、价格、地区、年龄分级、审核资料、截图、内购和订阅。
+3. 对 API 未覆盖项复用用户已登录 Playwright 会话：创建 App Record、填写 App Privacy 或处理网页专属确认。
+4. 关联构建与审核提交。仅在用户再次确认后调用提交审核或发布动作。
+5. 输出成功、失败、待补 ICP 和人工确认项，保存无秘密执行记录。
+
+## 内购与订阅
+
+- 校验 `product_id` 与 StoreKit 代码一致，再创建消耗型、非消耗型内购或自动续期订阅。
+- 每个内购必须提交一张用于审核的 `1280 × 800` 像素截图；按 [内购审核截图](references/in-app-purchase-review.md) 从真实购买流程采集并校验。
+- 默认全地区可售；以美国区目标价格查询 Apple 价格点，并由 Apple 自动等价换算其它地区价格。
+- 价格修改必须展示旧价、新价、生效时间和受影响地区；用户二次确认后才执行。
+
+## 网页自动化限制
+
+- 只使用用户已登录会话，不索取 Apple ID 密码或二次验证码。
+- 遇到验证码、实名核验、协议、税务、银行、证照上传或法律声明时暂停并交由用户完成。
+- App Review 拒审后整理证据、修复清单与回复草稿；回复或重新提交前确认。
+
+## 参考资料
+
+- API 与网页动作：见 [references/api-workflow.md](references/api-workflow.md)。
+- iOS/macOS 截图采集与规格：见 [references/screenshot-workflow.md](references/screenshot-workflow.md)。
+- 内购审核截图：见 [references/in-app-purchase-review.md](references/in-app-purchase-review.md)。

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-ios-app-store-release/assets/appstore-submission.yaml

@@ -0,0 +1,43 @@
+# 已确认的发布包模板；秘密仅使用外部引用，不能填入此文件。
+schema_version: 1
+application:
+  bundle_id: ""
+  sku: ""
+  platforms: [ios, macos]
+  availability: all_territories
+  china_mainland:
+    icp_status: not_started
+    icp_filing_number: ""
+localizations:
+  zh-Hans:
+    name: ""
+    subtitle: ""
+    description: ""
+    keywords: ""
+    support_url: ""
+    privacy_policy_url: ""
+  en-US:
+    name: ""
+    subtitle: ""
+    description: ""
+    keywords: ""
+    support_url: ""
+    privacy_policy_url: ""
+screenshots:
+  ios: { zh-Hans: [], en-US: [] }
+  macos: { zh-Hans: [], en-US: [] }
+# 每个内购条目必须带 `review_screenshot`，尺寸固定为 1280x800 像素。
+in_app_purchases: []
+subscriptions: []
+review:
+  contact_name: ""
+  contact_email: ""
+  contact_phone: ""
+  demo_credentials_reference: ""
+  notes: ""
+confirmations:
+  metadata_confirmed: false
+  privacy_confirmed: false
+  pricing_confirmed: false
+  submit_for_review_confirmed: false
+  release_confirmed: false

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-ios-app-store-release/references/api-workflow.md

@@ -0,0 +1,17 @@
+# App Store Connect API 与网页补齐
+
+## API 优先动作
+
+使用 App Store Connect API 创建或更新版本本地化、App 信息、分类、年龄分级、地区可售性、应用价格、内购、订阅、审核资料、截图和审核提交。每次写入前读取当前资源并生成字段 diff。
+
+## 网页补齐动作
+
+只在 API 无法覆盖时，使用用户已登录的 Playwright 会话：创建 App Record、App Privacy 问卷和 Apple 要求的网页专属确认。不得自动绕过验证码或复用未授权会话。
+
+## 中国大陆
+
+默认请求全地区可售。若 Apple 返回 ICP 缺失或无效状态，保留其它地区配置并在执行记录中登记备案待办。用户提供有效备案号后，单独重试中国大陆。
+
+## 最终门禁
+
+下列动作必须再次询问用户：提交审核、正式发布、提高价格、启用中国大陆（当备案资料刚补齐时）。

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-ios-app-store-release/references/in-app-purchase-review.md

@@ -0,0 +1,16 @@
+# 内购审核截图
+
+## 本项目固定规格
+
+每个内购项目提交一张 `1280 × 800` 像素、16:10 的审核截图。图片必须来自真实购买路径，清晰展示商品或服务、价格入口与购买后的可获得权益；禁止使用与应用不一致的概念图。
+
+## 采集与上传
+
+1. 使用审核账号或 StoreKit 测试环境进入目标商品购买页。
+2. 在 macOS 16:10 画布导出 `1280 × 800` PNG 或 JPG，移除用户身份、支付凭据和生产数据。
+3. 上传前校验精确像素、RGB、无透明通道和单张文件约束。
+4. 通过 `inAppPurchaseAppStoreReviewScreenshots` 的预留、上传、提交流程写入对应内购；上传后读取资源状态确认成功。
+
+## Apple 规格关系
+
+Apple 将内购审核截图用于审核而非商店展示，并要求它符合应用支持的平台截图规格。本项目将 `1280 × 800` 作为固定的 macOS 审核画布；如果 Apple 后续针对目标平台返回更严格的校验错误，停止上传并提示用户确认平台规格，不擅自缩放或裁剪。

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-ios-app-store-release/references/screenshot-workflow.md

@@ -0,0 +1,16 @@
+# iOS/macOS 截图工作流
+
+## 采集
+
+从真实 iOS 模拟器和 macOS 应用构建采集截图。先向用户确认截图剧本：启动方式、测试账号引用、页面路径、测试数据、脱敏规则和中英文文案。禁止以与实际应用不一致的生成图替代功能展示。
+
+## 分平台输出
+
+- iOS 和 macOS 必须分别采集、设计、校验和上传，不能将同一图片简单缩放复用。
+- 每种平台、设备尺寸和语言输出 1 到 10 张 JPEG/JPG/PNG；不得包含 Alpha 通道。
+- macOS 使用 16:10：`1280x800`、`1440x900`、`2560x1600` 或 `2880x1800`。
+- iOS 根据目标 iPhone 展示尺寸选择 Apple 当前接受的规格；执行时先读取 Apple 官方截图规格，避免使用过期机型尺寸。
+
+## 上传前检查
+
+检查尺寸、方向、格式、无透明通道、语言目录、页面顺序、隐私脱敏和平台归属。先生成本地预览和上传清单，用户确认后才上传。