create-dwy 0.14.6 → 0.15.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # create-dwy
 
+## 0.15.0
+
+### Minor Changes
+
+- 新增「产品 0→1」三层 skill 体系（总控 `dwy-product-launcher` + 5 个可独立触发的阶段 skill + 13 个产出物级原子 skill）：从模糊想法渐进式推进到上线产品，立项阶段三道闸门（需求市场验证为总闸门 → 技术 POC → MVP≤7），廉价验证在前、昂贵投入在后。
+- 新增 `dwy skills install` 命令：把 pm-skills / superpowers 的外部 skill 安装到全局 `~/.dwy/skills/`（一台机一份、全项目共享），含完整 `scripts/` 与 LICENSE；再次运行即覆盖更新。`dwy claude sync` 选中相关 skill 时自动自检安装。
+- 外部 skill 进全局纯数据目录而非 `.claude/skills/`，避免被工具当 skill 加载、与 `dwy-*` 触发冲突。
+- 改造 `dwy-whiteboard-prototype`：配色按产品定位推荐（保留 `:root` 语义变量结构）、尺寸按目标端推荐、图标不再用 emoji。
+
+## 0.14.7
+
+### Patch Changes
+
+- 平台选择交互默认按当前项目本地目录回填：存在 `.claude`、`.codex` / `.agents` / `AGENTS.md`、`.cursor`、`.opencode` 时，自动勾选对应平台；无本地目录时退回默认 `Claude Code + Codex`。
+- 将跨语言通用基础约束并入 `CLAUDE.md`，删除重复的 `rules/Global/dwy-common-code-baseline.md`，减少全局规则分散。
+- 将 Docker 规则从 `rules/Global/dwy-docker.md` 调整到 `rules/Docker/dwy-docker.md`，按技术域归类。
+- 为 Android 与 Flutter 规则补充全面屏、刘海屏、挖孔屏适配约束，统一要求基于安全区域与响应式布局实现。
+
 ## 0.14.6
 
 ### Patch Changes

package/bin/index.js

@@ -4,6 +4,7 @@ import { readFileSync } from 'fs'
 import { fileURLToPath } from 'url'
 import { dirname, resolve } from 'path'
 import { syncAll } from '../src/sync-all.js'
+import { installSkills } from '../src/skills-install.js'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf-8'))
@@ -16,6 +17,7 @@ function printHelp() {
     'Usage:',
     '  dwy               运行交互式同步',
     '  dwy sync          运行交互式同步',
+    '  dwy skills install  安装/更新全局外部 skill 到 ~/.dwy/skills/',
     '  dwy --help        显示本说明',
     '  dwy -h            显示本说明',
     '  dwy --version     显示当前版本',
@@ -29,6 +31,8 @@ if (argv.includes('--help') || argv.includes('-h') || argv[0] === 'help') {
   printHelp()
 } else if (argv.includes('--version') || argv.includes('-V')) {
   console.log(pkg.version)
+} else if (argv[0] === 'skills' && argv[1] === 'install') {
+  await installSkills()
 } else if (argv.length === 0 || argv[0] === 'sync') {
   await syncAll()
 } else {

package/package.json

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

package/src/skills-install.js

@@ -0,0 +1,113 @@
+import fs from 'fs-extra'
+import path from 'path'
+import os from 'node:os'
+import { getDwyHomeDir, runGit, chalk } from './utils.js'
+
+function logAction(label) {
+  console.log(chalk.green(`  ✓ ${label}`))
+}
+
+// 产品 0→1 流程依赖的外部 skill 清单。
+// 每项：缓存目录名（= 原子 skill 引用的 ~/.dwy/skills/<name>）→ 来源 repo / stable tag / repo 内目录。
+// 只用正式 release tag，不用 main HEAD（定版可复现）。更新版本时改这里的 tag。
+const SKILL_SOURCES = {
+  'pm-skills': {
+    repo: 'https://github.com/phuryn/pm-skills.git',
+    tag: 'v2.0.0',
+    licenseFile: 'LICENSE',
+    licenseDest: 'LICENSE-pm-skills',
+    skills: {
+      'competitor-analysis': 'pm-market-research/skills/competitor-analysis',
+      'market-sizing': 'pm-market-research/skills/market-sizing',
+      'sentiment-analysis': 'pm-market-research/skills/sentiment-analysis',
+      'interview-script': 'pm-product-discovery/skills/interview-script',
+      'prioritize-features': 'pm-product-discovery/skills/prioritize-features',
+      'opportunity-solution-tree': 'pm-product-discovery/skills/opportunity-solution-tree',
+      'metrics-dashboard': 'pm-product-discovery/skills/metrics-dashboard',
+      'create-prd': 'pm-execution/skills/create-prd',
+      'outcome-roadmap': 'pm-execution/skills/outcome-roadmap',
+      'test-scenarios': 'pm-execution/skills/test-scenarios',
+      'release-notes': 'pm-execution/skills/release-notes',
+      'gtm-strategy': 'pm-go-to-market/skills/gtm-strategy',
+      'intended-vs-implemented': 'pm-ai-shipping/skills/intended-vs-implemented',
+      'north-star-metric': 'pm-marketing-growth/skills/north-star-metric',
+    },
+  },
+  superpowers: {
+    repo: 'https://github.com/obra/superpowers.git',
+    tag: 'v6.0.3',
+    licenseFile: 'LICENSE',
+    licenseDest: 'LICENSE-superpowers',
+    skills: {
+      brainstorming: 'skills/brainstorming',
+      'writing-plans': 'skills/writing-plans',
+      'test-driven-development': 'skills/test-driven-development',
+      'systematic-debugging': 'skills/systematic-debugging',
+    },
+  },
+}
+
+// 全局外部 skill 安装目录：~/.dwy/skills/
+function getGlobalSkillsDir() {
+  return path.join(getDwyHomeDir(), 'skills')
+}
+
+// 浅克隆指定 tag 到临时目录（--depth 1 + --branch <tag> 只取定版，省带宽）。
+async function shallowCloneTag(repoUrl, tag, destDir) {
+  await runGit(['clone', '--depth', '1', '--branch', tag, repoUrl, destDir])
+}
+
+// 安装/更新全部外部 skill 到 ~/.dwy/skills/。再次运行即覆盖式更新。
+export async function installSkills() {
+  const targetDir = getGlobalSkillsDir()
+  await fs.ensureDir(targetDir)
+
+  const tmpRoot = path.join(os.tmpdir(), `dwy-skills-${process.pid}`)
+  await fs.ensureDir(tmpRoot)
+
+  const versions = {}
+  try {
+    for (const [sourceName, src] of Object.entries(SKILL_SOURCES)) {
+      console.log(chalk.gray(`拉取 ${sourceName} @ ${src.tag} ...`))
+      const repoDir = path.join(tmpRoot, sourceName)
+      await shallowCloneTag(src.repo, src.tag, repoDir)
+
+      // 搬 LICENSE（MIT 要求保留原版权声明）
+      const licenseSrc = path.join(repoDir, src.licenseFile)
+      if (await fs.pathExists(licenseSrc)) {
+        await fs.copy(licenseSrc, path.join(targetDir, src.licenseDest), { overwrite: true })
+      }
+
+      // 搬每个 skill 整目录（含 scripts/、配套 .md）
+      for (const [skillName, repoPath] of Object.entries(src.skills)) {
+        const from = path.join(repoDir, repoPath)
+        const to = path.join(targetDir, skillName)
+        if (!await fs.pathExists(from)) {
+          throw new Error(`${sourceName} @ ${src.tag} 内未找到 ${repoPath}（仓库结构可能变了）`)
+        }
+        await fs.remove(to)
+        await fs.copy(from, to, { overwrite: true })
+        logAction(`skills/${skillName}`)
+        versions[skillName] = { repo: src.repo, tag: src.tag }
+      }
+    }
+
+    // 写版本清单，供查看与后续更新比对
+    await fs.writeJson(path.join(targetDir, 'VERSIONS.json'), versions, { spaces: 2 })
+    console.log(chalk.green(`\n✓ 外部 skill 已安装到 ${targetDir}`))
+  } finally {
+    await fs.remove(tmpRoot)
+  }
+}
+
+// 全局 skill 是否已就绪（供 sync 自检：缺则自动装）。
+export async function skillsInstalled() {
+  return fs.pathExists(path.join(getGlobalSkillsDir(), 'VERSIONS.json'))
+}
+
+export async function ensureSkillsInstalled() {
+  if (await skillsInstalled()) return false
+  console.log(chalk.gray('未检测到全局外部 skill，自动安装...'))
+  await installSkills()
+  return true
+}

package/src/sync-all.js

@@ -24,6 +24,14 @@ import {
 } from './sync-codex.js'
 import { scanExistingCursorRules, syncCursor } from './sync-cursor.js'
 import { syncOpenCode } from './sync-opencode.js'
+import { ensureSkillsInstalled } from './skills-install.js'
+
+// 产品 0→1 流程里依赖全局外部 skill 的包装型原子 skill。
+// 同步选中其中任一个时，触发全局外部 skill 自检安装。
+const WRAPPER_SKILL_NAMES = new Set([
+  'dwy-ideate', 'dwy-competitor', 'dwy-validate', 'dwy-mvp', 'dwy-prd',
+  'dwy-version', 'dwy-tasks', 'dwy-tdd-dev', 'dwy-acceptance', 'dwy-release',
+])
 
 const PLATFORM_OPTIONS = [
   { value: 'claude', label: 'Claude Code', hint: '支持 rules / skills / commands / hooks' },
@@ -119,7 +127,32 @@ async function shouldInitialize(projectDir, existing) {
   return !isCancel(ok) && ok
 }
 
-async function selectPlatforms() {
+export async function buildPlatformDefaultsFromLocalState(projectDir) {
+  const defaults = []
+
+  if (await fs.pathExists(path.join(projectDir, '.claude'))) {
+    defaults.push('claude')
+  }
+  if (
+    await fs.pathExists(path.join(projectDir, '.codex'))
+    || await fs.pathExists(path.join(projectDir, '.agents'))
+    || await fs.pathExists(path.join(projectDir, 'AGENTS.md'))
+  ) {
+    defaults.push('codex')
+  }
+  if (await fs.pathExists(path.join(projectDir, '.cursor'))) {
+    defaults.push('cursor')
+  }
+  if (await fs.pathExists(path.join(projectDir, '.opencode'))) {
+    defaults.push('opencode')
+  }
+
+  return defaults.length > 0 ? defaults : ['claude', 'codex']
+}
+
+async function selectPlatforms(projectDir) {
+  const initialValues = await buildPlatformDefaultsFromLocalState(projectDir)
+
   console.log(chalk.gray('\n平台能力预览：'))
   console.log(chalk.gray('  Claude Code → rules / skills / commands / hooks'))
   console.log(chalk.gray('  Codex       → rules / skills / hooks'))
@@ -129,7 +162,7 @@ async function selectPlatforms() {
   const result = await multiselect({
     message: '选择要同步的平台',
     options: PLATFORM_OPTIONS,
-    initialValues: ['claude', 'codex'],
+    initialValues,
     required: true,
     maxItems: 6,
   })
@@ -575,7 +608,7 @@ export async function syncAll({
     return
   }
 
-  const selectedPlatforms = selectedPlatformsOverride || await selectPlatforms()
+  const selectedPlatforms = selectedPlatformsOverride || await selectPlatforms(projectDir)
   if (selectedPlatforms === null) {
     console.log(chalk.yellow('\n已取消同步。'))
     return
@@ -665,6 +698,17 @@ export async function syncAll({
   }
   await saveSyncState(projectDir, syncState)
 
+  // 产品 0→1 流程的包装型原子 skill 依赖全局外部 skill（~/.dwy/skills/）。
+  // 若本次同步选中了这些 skill 且全局未安装，自动装一次（缺则装、有则跳过）。
+  if (selected.skills?.some((s) => WRAPPER_SKILL_NAMES.has(s.name))) {
+    try {
+      await ensureSkillsInstalled()
+    } catch (error) {
+      console.log(chalk.yellow(`\n外部 skill 自动安装失败：${error.message}`))
+      console.log(chalk.gray('可稍后手动运行 `dwy skills install` 重试。'))
+    }
+  }
+
   if (!syncedAnySupportedPlatform) {
     console.log(chalk.yellow('未选择已接入平台，本次未执行同步。'))
   }

package/templates/ai-tools/CLAUDE.md

@@ -8,7 +8,24 @@
 
 ## 团队执行任务
 
-任务执行必须使用多 Agent 或 agent team 并行提高效率。
+任务执行前必须先分析 block；无 block 的任务使用多 Agent 并行执行以提高效率。
+
+## 代码注释
+
+- 所有代码都必须有注释。
+- 类、接口、私有方法、函数、重要参数与重要字段都必须写明用途、约束与边界。
+- 每个类顶部要有简短功能说明。
+- 注释重点写“为什么”和“约束”，避免仅复述代码实现。
+
+## 图标规范
+
+- 图标优先使用成熟稳定的图标库，不使用 emoji 作为功能性图标。
+- 优先选择项目已有成熟依赖；无可用依赖时再补充稳定方案。
+
+## 发布与打包基础准则
+
+- PyPI 与 npm 的发布必须走 GitHub Actions，使用 OIDC 完成鉴权，禁止使用长期静态发布凭据。
+- 多平台打包必须走 GitHub Actions 工作流执行，不使用本地手工打包作为唯一流程。
 
 ## 减少常见 LLM 编码错误的行为指南
 

package/templates/ai-tools/hooks/Git/pre-git-commit-sensitive-check.sh

@@ -37,8 +37,16 @@ PATTERNS=(
 # 拼接为正则
 REGEX=$(IFS='|'; echo "${PATTERNS[*]}")
 
-# 扫描暂存内容
-RESULT=$(git diff --cached -U0 2>/dev/null | grep -inE "$REGEX" 2>/dev/null)
+# 只扫「新增行」(+ 开头，排除 +++ 文件头)，删除的代码不可能是正在引入的凭证。
+# 跳过文档/规则类文件(.md/.mdc/规则/hook 本身)——它们写的是「如何检测凭证」的模式说明，非真凭证。
+SCAN_FILES=$(printf '%s\n' "$STAGED" | grep -viE '\.(md|mdc|txt)$|rules/|/hooks/|sensitive-check')
+RESULT=""
+for f in $SCAN_FILES; do
+    HIT=$(git diff --cached -U0 -- "$f" 2>/dev/null \
+        | grep -E '^\+' | grep -vE '^\+\+\+' \
+        | grep -inE "$REGEX" 2>/dev/null)
+    [ -n "$HIT" ] && RESULT="${RESULT}${f}:\n${HIT}\n"
+done
 
 if [ -n "$RESULT" ]; then
     echo "========================================"

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

@@ -15,6 +15,14 @@ paths:
 
 不限制构建工具、UI 框架、架构模式、SDK 版本、依赖库选型 —— 与老项目兼容。
 
+## 全面屏 / 刘海屏适配
+
+- Android 端默认按全面屏、刘海屏、挖孔屏适配实现,不要使用固定上下左右边距硬编码内容区。
+- 优先使用 `WindowInsets`、系统栏 inset、约束布局和响应式容器处理状态栏、导航栏、手势区域占位。
+- 顶部标题栏、底部操作栏、输入区、悬浮按钮必须显式考虑状态栏、导航栏和手势返回区域,避免被遮挡或贴边误触。
+- 全屏背景、沉浸式遮罩可以延伸到系统栏区域,但前景可交互内容默认留在安全显示区内。
+- 禁止写死状态栏高度、导航栏高度、刘海高度,统一通过系统 inset 获取。
+
 ## 一、命名规范
 
 

package/templates/ai-tools/rules/Flutter/dwy-flutter-core.md

@@ -8,6 +8,14 @@ paths:
 
 # Flutter + Dart 基础风格规范
 
+## 全面屏 / 刘海屏适配
+
+- Flutter 应用默认按 iOS 与 Android 全面屏、刘海屏、挖孔屏适配实现,不要依赖固定上下左右边距硬编码页面内容区。
+- 优先使用 `SafeArea`、`MediaQuery.padding`、`MediaQuery.viewPadding`、`MediaQuery.viewInsets` 与响应式布局约束处理状态栏、底部手势区、键盘遮挡。
+- 页面主体、底部操作栏、表单输入区、弹层内容必须显式处理安全区域,避免被刘海、Home Indicator、导航栏或软键盘遮挡。
+- 全屏背景、沉浸式插画、遮罩层可以铺满屏幕,但前景可交互内容默认留在安全区域内。
+- 禁止写死 iOS 状态栏高度、Android 导航栏高度或机型刘海尺寸,统一通过系统安全区域与 inset 信息计算。
+
 ## 一、项目结构
 
 ### 1.1 标准目录

package/templates/ai-tools/rules/HarmonyOS/dwy-arkts-strict.md

@@ -0,0 +1,221 @@
+---
+description: HarmonyOS ArkTS 严格性避坑（相对 TS/JS 的禁用语法，编译期 arkts-no-* 报错）
+paths:
+  - "**/*.ets"
+  - "**/*.ts"
+---
+
+# ArkTS 严格性避坑
+
+ArkTS 是 TypeScript 的**受限子集**，禁掉大量 TS/JS 动态写法以换取性能与静态可分析性。
+从 TS/JS（尤其 iOS/前端转鸿蒙）照搬代码必触发 `arkts-no-*` 编译错误。
+**写 `.ets` 前先过一遍本清单**，别用下面列出的禁用写法。每条配真实报错码 + 错误/正确写法。
+
+## 1. 禁止解构声明与解构赋值（arkts-no-destruct-decls / arkts-no-destruct-assignment）
+
+```typescript
+// 错：解构声明
+let [oldR, r] = [a % m, m];
+// 错：解构赋值
+[oldR, r] = [r, oldR - q * r];
+const { value, next } = readVarint(bytes, i);
+
+// 对：拆成单变量 + 临时变量交换
+let oldR = a % m;
+let r = m;
+const tmpR = oldR - q * r;
+oldR = r;
+r = tmpR;
+const res = readVarint(bytes, i);
+const value = res.value;
+const next = res.next;
+```
+
+## 2. 对象字面量必须对应显式 class/interface（arkts-no-untyped-obj-literals / arkts-no-obj-literals-as-types）
+
+ArkTS 不允许「匿名对象字面量当类型」，也不允许「无类型标注的对象字面量」。
+**两种触发场景都要先声明 interface**：
+
+### 2.1 函数返回类型不能写匿名对象
+
+```typescript
+// 错：返回类型是匿名对象字面量
+private static readVarint(bytes: Uint8Array, i: number): { value: number; next: number } { ... }
+
+// 对：先声明 interface
+interface VarintResult {
+  value: number;
+  next: number;
+}
+private static readVarint(bytes: Uint8Array, i: number): VarintResult { ... }
+```
+
+### 2.2 返回 / 赋值的对象字面量必须有类型来源
+
+```typescript
+// 错：裸对象字面量（编译器无法对应到具体类型）
+return { command: c, arg0: a, arg1: b, dataLength: d };
+const out = { header, payload: payload.slice() };
+
+// 对：显式标注类型（interface 已声明）
+const header: AdbHeader = { command: c, arg0: a, arg1: b, dataLength: d };
+return header;
+const out: AdbMessageResult = { header, payload: payload.slice() };
+```
+
+### 2.3 给 SDK API 传对象参数也要带类型
+
+SDK（@ohos.net.socket / cryptoFramework 等）的参数即使是已声明类型，裸字面量仍报错，
+必须用「声明类型的变量」传入：
+
+```typescript
+// 错：裸字面量传参
+await tcp.connect({ address: { address: host, port: 5555, family: 1 }, timeout: 15000 });
+await tcp.send({ data: buf });
+const out = await signer.sign({ data: token });
+
+// 对：拆成带 SDK 类型标注的变量
+const netAddr: socket.NetAddress = { address: host, port: 5555, family: 1 };
+const opts: socket.TCPConnectOptions = { address: netAddr, timeout: 15000 };
+await tcp.connect(opts);
+
+const sendOpts: socket.TCPSendOptions = { data: buf };
+await tcp.send(sendOpts);
+
+const input: cryptoFramework.DataBlob = { data: token };
+const out = await signer.sign(input);
+```
+
+## 3. 禁止用下标访问 string 取字符（arkts-no-props-by-index）
+
+string 不能 `s[i]` 取字符（被判为「字段索引访问」）。用 `charAt`：
+
+```typescript
+// 错
+const table = 'ABCD...';
+out += table[(n >> 18) & 63];
+
+// 对
+out += table.charAt((n >> 18) & 63);
+```
+
+> 注意：`Uint8Array[i]` / `Array[i]` 下标访问是允许的，只有 **string 下标取字符** 被禁。
+
+## 4. 禁止 String() / Number() / Boolean() 当转换函数调用
+
+ArkTS 禁止把内置构造器当函数转换值。catch 错误转文案、数字转字符串都要换写法：
+
+```typescript
+// 错
+const msg = e instanceof Error ? e.message : String(e);
+const s = String(num);
+
+// 对：catch 变量在 ArkTS 里就是 Error（含 BusinessError extends Error），直接取 message
+function errMsg(e: Error): string {
+  return e.message;
+}
+// 数字转字符串用 .toString() 或模板串
+const s = num.toString();
+const s2 = `${num}`;
+```
+
+## 5. Promise executor / 回调形参类型：简单形参标，executor 的 resolve/reject 不标
+
+箭头函数当回调，形参不能省类型；executor 里别把函数直接当回调透传：
+
+```typescript
+// 错：resolve 无类型 + 直接把 resolve 透传给 setTimeout
+return new Promise<void>((resolve) => setTimeout(resolve, ms));
+
+// 对：形参标类型 + 包一层箭头
+return new Promise<void>((resolve: () => void) => {
+  setTimeout(() => {
+    resolve();
+  }, ms);
+});
+```
+
+**⚠️ 例外（实测踩坑）：给 `Promise` executor 的 resolve/reject 标注「函数类型」反而触发
+`arkts-no-structural-typing`**。executor 的两个形参类型由 `Promise<T>` 自身约束，显式标
+`(reject: (e: Error) => void)` 会与 SDK 内置的 reject 签名做结构比对而报错。这种情况**去掉
+executor 形参的类型注解，让 ArkTS 推断**（reject 内部传 `Error` 子类实例完全正常）：
+
+```typescript
+// 错：executor 形参标函数类型 → arkts-no-structural-typing
+return new Promise<Uint8Array>(
+  (resolve: (v: Uint8Array) => void, reject: (e: Error) => void) => { ... });
+
+// 对：executor 形参不标，推断
+return new Promise<Uint8Array>((resolve, reject) => {
+  reject(new MyError(...));   // MyError extends Error，正常
+});
+```
+
+判据：**普通回调（如自己定义的 `onError: (e: Error) => void`）形参要标；`new Promise(...)`
+的 executor 形参不标**。另：跨文件传回调时，形参类型用基类（`Error`）而非具体子类
+（`MyGrpcError`），避免「子类型 lambda 赋给基类形参」触发同一规则。
+
+## 6. 页面路由路径不带 `ets/` 前缀
+
+`main_pages.json` 的 `src` 与 `windowStage.loadContent(...)` 的路径都相对 `src/main/ets/` 根，
+**不要带 `ets/` 前缀**，否则编译报 `Page '.../ets/ets/xxx' does not exist`：
+
+```json
+// 错：resources/base/profile/main_pages.json
+{ "src": ["ets/spike/SpikePage"] }
+// 对
+{ "src": ["spike/SpikePage"] }
+```
+
+```typescript
+// 错
+windowStage.loadContent('ets/spike/SpikePage', cb);
+// 对
+windowStage.loadContent('spike/SpikePage', cb);
+```
+
+## 7. 大整数运算用原生 bigint（无需第三方库）
+
+ArkTS 原生支持 ES11 `bigint`（`10n` / `BigInt(x)` / `<< >> % & | ** /`）。
+但无 `.inverse(m)` / `.power(_,modulus:)` / `.serialize()` 这类方法（那是 Swift BigInt 库的），
+模逆/模幂/序列化要**手写**：
+
+```typescript
+// 模幂（快速幂）
+function modPow(base: bigint, exp: bigint, m: bigint): bigint {
+  let result = 1n;
+  let b = base % m;
+  let e = exp;
+  while (e > 0n) {
+    if ((e & 1n) === 1n) { result = (result * b) % m; }
+    e >>= 1n;
+    b = (b * b) % m;
+  }
+  return result;
+}
+// 模逆（扩展欧几里得，见本仓鸿蒙工程 AndroidPubkey.ets）
+```
+
+## 8. 自检清单（写完 .ets 提交前 grep 一遍）
+
+```bash
+grep -rn 'let \[\|const \[' .          # 解构声明
+grep -rn '): {'  .                      # 匿名对象当返回类型
+grep -rn 'return {' .                   # 裸对象字面量返回（确认有类型标注）
+grep -rn 'String(\|Number(\|Boolean(' . # 构造器当转换函数（排除 String.fromCharCode）
+grep -rn 'new Promise<.*>((.*:.*=>' .   # executor 形参标了函数类型（见 §5 例外，应去注解）
+# string 下标取字符需人工核对（table[i] 形式）
+```
+
+## 9. 仍需真机/真实 SDK 确认的（编译期过不代表运行对）
+
+ArkTS 编译通过只保证语法合规；以下 SDK 行为编译期无法验证，需真机/模拟器实测：
+- cryptoFramework 的 `createSign(规格串)` 是否支持目标算法组合（如 `RSA2048|PKCS1|NoHash`）
+- `getEncoded()` 返回的公钥 DER 是 PKCS#1 还是 X.509 SPKI（影响解析）
+- `@ohos.net.socket.TCPSocket` 局域网连通性（需 `ohos.permission.INTERNET`，normal 级安装即授予）
+
+---
+
+> 本文件只管**语言语法层**。ArkUI 组件、V2 状态管理、图标资源、工程构建、运行时容错的坑
+> 见同目录 **`dwy-arkts-ui-build.md`**（图标名映射 / 自定义组件链属性 / @BuilderParam 默认值 /
+> @Param 外部初始化 / async 状态快照 / bootstrap 分步容错 / DevEco 命令行构建）。