@doubao-apps/ai 0.0.19 → 0.0.20

package/dist/skills/doubao-apps-dev/.ai/reference/open-api.md

@@ -116,6 +116,18 @@ closePage();
 
 ***
 
+### exitApp()
+
+> **exitApp**(): `Promise`\<`object`\>
+
+退去当前所有页面
+
+#### Returns
+
+`Promise`\<`object`\>
+
+***
+
 ### getAccountInfo()
 
 > **getAccountInfo**(`params`?): `Promise`\<[`GetAccountInfoResult`](doubao-apps-sdk-open-api.md#getaccountinforesult)\>
@@ -352,7 +364,7 @@ Returns a Promise containing privacy setting information
 #### Example
 
 ```typescript
-import { getScreenBrightness } from '@byted-doubao-apps/framework/api';
+import { getScreenBrightness } from '@doubao-apps/framework/api';
 
 const result = await getScreenBrightness();
 
@@ -593,7 +605,7 @@ Returns a Promise containing the login credential code
 
 拨打电话。
 
-入参与微信豆包 App `wx.makePhoneCall` 对齐。
+入参与宿主应用的拨打电话能力对齐。
 
 #### Parameters
 
@@ -647,6 +659,36 @@ await makePhoneCall({ phoneNumber: '10086' });
 
 ***
 
+### onKeyboardHeightChange()
+
+> **onKeyboardHeightChange**(`handler`): () => `void`
+
+监听键盘高度变化事件。
+
+#### Parameters
+
+• **handler**
+
+#### Returns
+
+`Function`
+
+##### Returns
+
+`void`
+
+#### Example
+
+```typescript
+import { onKeyboardHeightChange } from '@doubao-apps/framework/api';
+
+const unsubscribe = onKeyboardHeightChange(({ height }) => {
+  console.log('Keyboard height change event:', { height });
+});
+```
+
+***
+
 ### openApp()
 
 > **openApp**(`params`): `Promise`\<[`OpenAppResult`](doubao-apps-sdk-open-api.md#openappresult)\>
@@ -874,6 +916,32 @@ await sendQueryMessage({ content: '订阅消息', type: 'text' })
 
 ***
 
+### setClipboardData()
+
+> **setClipboardData**(`params`): `Promise`\<`object`\>
+
+设置系统剪贴板内容。
+
+#### Parameters
+
+• **params**: [`SetClipboardDataParams`](doubao-apps-sdk-open-api.md#setclipboarddataparams)
+
+#### Returns
+
+`Promise`\<`object`\>
+
+返回一个 Promise，在剪贴板内容设置成功时解析。
+
+#### Example
+
+```typescript
+import { setClipboardData } from '@doubao-apps/framework/api';
+
+await setClipboardData({ data: 'hello' });
+```
+
+***
+
 ### setStorage()
 
 > **setStorage**\<`TData`\>(`params`): `Promise`\<`object`\>
@@ -1387,6 +1455,18 @@ key 对应的数据
 
 ***
 
+### KeyboardHeightChangeEvent
+
+#### Properties
+
+##### height
+
+> **height**: `number`
+
+键盘高度，单位 px。
+
+***
+
 ### LoginRequest
 
 #### Properties
@@ -1706,6 +1786,18 @@ HTTP 状态码。
 
 ***
 
+### SetClipboardDataParams
+
+#### Properties
+
+##### data
+
+> **data**: `string`
+
+需要设置的剪贴板内容
+
+***
+
 ### SetStorageParams\<TData\>
 
 #### Type parameters

package/dist/skills/douyin-to-doubao/SKILL.md

@@ -0,0 +1,333 @@
+---
+name: douyin-to-doubao
+description: Migrate Douyin Mini Program (抖音小程序) projects to Doubao Apps SDK (React Lynx). Use when converting TTML/TTSS/JS code, or when users request migration from 抖音小程序 / Douyin Mini Program / tt.* APIs.
+---
+
+# 抖音小程序 to Doubao Apps Migration Skill
+
+## When to Use
+
+- Converting Douyin Mini Program projects to Doubao Apps
+- User mentions "migrate from 抖音小程序", "Douyin to Doubao", "ttml to tsx", "tt.* API migration"
+- Working with `.ttml`, `.ttss`, `Page({})`, `Component({})`, `App({})` patterns
+- Replacing `tt.*` APIs and TTML directives with Doubao Apps patterns
+
+---
+
+## Core Principles
+
+**CRITICAL RULES - MUST FOLLOW:**
+
+1. **Preserve Business Logic**: Only change framework APIs and syntax, never modify business logic.
+2. **Plan Before Execute**: Always present migration plan before making changes.
+3. **Official Docs First**: Source-framework judgments must prioritize Douyin official documentation verified on `2026-04-01`.
+4. **Mapping First**: Use mapping docs first; only consult raw framework docs when mapping does not cover a case.
+5. **Incremental Migration**: Migrate and validate file by file.
+6. **Document Gaps**: Record all unsupported or platform-specific features in migration report.
+
+---
+
+## 官方文档入口（抖音小程序，2026-04-01 校验）
+
+以下链接是本 skill 的主要事实依据，遇到边界能力优先回读原文：
+
+- 框架概述: `https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/tutorial/miniapp-framework/introduction`
+- App / 应用: `https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/framework/app`
+- Component 构造器: `https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/tutorial/custom-component/component-constructor`
+- 组件生命周期: `https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/tutorial/custom-component/lifetime`
+- 组件概述: `https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/component/overview/`
+- TTML 数据绑定: `https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/tutorial/miniapp-framework/view/ttml-data-bind`
+- TTML 列表渲染: `https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/tutorial/miniapp-framework/view/ttml-list-draw`
+- TTML 事件: `https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/tutorial/miniapp-framework/view/ttml-event`
+- 网络连接 / `tt.request`: `https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/tutorial/basic-ability/net-connection`
+- 小程序登录 / `tt.login`: `https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/api/open-interface/log-in/tt-login`
+- 小程序分享: `https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/tutorial/open-capabilities/general-capabilities/share`
+- `tt.authorize`（官方标注“逐步废弃”）: `https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/api/open-interface/authorization/tt-authorize`
+
+---
+
+## 知识来源速查
+
+### 目标框架文档（按需读取）
+
+安装路径（`$SKILLS_BASE`，由 Step 0 检测确定）：
+
+| Agent 环境 | 知识库路径 |
+|------------|-----------|
+| Codex / Cursor / Cline | `.agents/skills/doubao-apps-dev` |
+| Claude Code | `.claude/skills/doubao-apps-dev` |
+
+通过以下命令安装：
+
+```bash
+npx @doubao-apps/ai skills add doubao-apps-dev --agent codex
+```
+
+| 文档 | 路径 | 用途 |
+|------|------|------|
+| 框架 API 速查 | `$SKILLS_BASE/.ai/reference/framework-api-quick-ref.md` | definePage/defineWidget 等核心 API |
+| 开发规则 | `$SKILLS_BASE/.ai/rules/dos-and-donts.md` | 必须遵守的开发规范 |
+| 组件开发指南 | `$SKILLS_BASE/.ai/guides/component-development.md` | 页面/组件组织方式 |
+| 组件库参考 | `$SKILLS_BASE/.ai/reference/components-quick-ref.md` | UI 组件 API |
+
+### 映射文档（迁移核心依据）
+
+| 文档 | 路径 |
+|------|------|
+| 核心 API 映射 | `./references/mapping/core-api-mapping.md` |
+| 生命周期映射 | `./references/mapping/lifecycle-mapping.md` |
+| 组件映射 | `./references/mapping/component-mapping.md` |
+| 样式映射 | `./references/mapping/style-mapping.md` |
+| 事件映射 | `./references/mapping/event-mapping.md` |
+
+### 源框架文档（按问题读取）
+
+| 文档 | 路径 | 何时读取 |
+|------|------|----------|
+| 抖音小程序 API 参考 | `./references/source-framework/api-reference.md` | 识别 `tt.*` API、`Page/Component/App`、登录/分享等开放能力 |
+| 抖音小程序组件参考 | `./references/source-framework/components.md` | 识别 `view`、`scroll-view`、`swiper`、`button`、`input` 等组件语义 |
+
+### 代码导入来源
+
+| 包名 | 用途 | 示例 |
+|------|------|------|
+| `@doubao-apps/framework` | 框架 API 和 React Hooks | `import { definePage, useState } from '@doubao-apps/framework'` |
+| `@doubao-apps/framework/api` | 端能力 API（替代 `tt.*`） | `import { request, showToast, navigateTo } from '@doubao-apps/framework/api'` |
+| `@doubao-apps/framework/components` | 目标组件库导出；对已支持的小写标签会由 loader 自动注入 import | `import { PickerView, PickerColumn, RadioGroup, Radio } from '@doubao-apps/framework/components'` |
+
+> 当前项目已支持直接写小写标签：`<view>`、`<text>`、`<image>`、`<input>`、`<textarea>`、`<scroll-view>`、`<list>`、`<list-item>`、`<button>`、`<switch>`、`<slider>`、`<swiper>`、`<swiper-item>`、`<map>`、`<map-marker>`、`<movable-area>`、`<movable-view>`、`<popup>`、`<radio>`、`<radio-group>`、`<picker-view>`、`<picker-column>`、`<web-view>`、`<svg>`。
+
+---
+
+## 迁移流程
+
+### Step 0: 环境检查
+
+**1. 确定知识库路径（`$SKILLS_BASE`）**
+
+依次检测以下路径，取第一个存在的作为 `$SKILLS_BASE`：
+
+```bash
+ls .agents/skills/doubao-apps-dev/AGENTS.md 2>/dev/null && echo "SKILLS_BASE=.agents/skills/doubao-apps-dev"
+ls .claude/skills/doubao-apps-dev/AGENTS.md 2>/dev/null && echo "SKILLS_BASE=.claude/skills/doubao-apps-dev"
+```
+
+**2. 如未安装，执行安装**
+
+```bash
+npx @doubao-apps/ai skills add doubao-apps-dev --agent codex
+```
+
+**3. 初始化 Doubao Apps 目标项目**
+
+询问用户目标项目目录名（默认为源项目目录名加 `-doubao` 后缀），然后创建空项目：
+
+```bash
+npx @doubao-apps/create <target-dir> --template empty -y
+```
+
+创建成功后，将 `<target-dir>` 记录为 `$TARGET_PROJECT_PATH`，后续迁移产物统一输出到该目录。
+
+**输出示例**：
+
+```text
+✅ 环境就绪
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Agent 环境：Codex
+$SKILLS_BASE：.agents/skills/doubao-apps-dev
+知识库状态：已安装 v0.0.1
+映射文档：5 份就绪
+目标项目：./my-douyin-miniapp-doubao（已创建）
+```
+
+---
+
+### Step 1: 分析源项目
+
+扫描抖音小程序项目，识别：
+
+- `.ttml` 文件数量和页面/组件分布
+- 使用的 `tt.*` API 清单
+- `tt:` 指令使用情况（`tt:if` / `tt:for` / `tt:key`）
+- 使用的组件列表（`view`、`scroll-view`、`swiper`、`navigator`、`button` 等）
+- `app.json` 与各页面 `.json` 的页面配置、路由、`usingComponents`
+- 自定义组件及其 `properties` / `pageLifetimes` / 事件依赖
+- 平台专有能力：登录、分享、挂载到抖音视频/直播、`open-type`、授权链路
+
+**输出示例**：
+
+```text
+📊 项目分析报告
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+文件数量：18 个页面/组件
+  └─ 页面（pages/）：12 个
+  └─ 组件（components/）：6 个
+
+使用的 tt.* API：
+  ✅ 有直接迁移路径：tt.request, tt.showToast, tt.navigateTo, tt.setStorageSync (11 个)
+  ⚠️  需人工决策：tt.login, 分享挂载能力, button open-type (4 个)
+
+TTML 指令：
+  ✅ 常规：tt:if, tt:for, tt:key
+  ⚠️  需重写：bind:tap.capture, bind:tap.stop.prevent
+
+组件：
+  ✅ 有映射：view, text, image, scroll-view, button, input, swiper, movable-area, radio-group, picker-view (10 个)
+  ⚠️  需适配：navigator, picker, checkbox-group (3 个)
+  ❌ 平台强绑定：video 发布/直播挂载入口（2 个）
+
+复杂度评估：中高
+```
+
+---
+
+### Step 2: 读取映射文档
+
+按以下顺序读取，建立转换规则索引：
+
+1. `./references/mapping/core-api-mapping.md`
+2. `./references/mapping/lifecycle-mapping.md`
+3. `./references/mapping/component-mapping.md`
+4. `./references/mapping/style-mapping.md`
+5. `./references/mapping/event-mapping.md`
+
+遇到未覆盖场景时，再回读源框架文档：
+
+1. `./references/source-framework/api-reference.md`
+2. `./references/source-framework/components.md`
+
+---
+
+### Step 3: 生成迁移计划
+
+基于项目分析和映射规则，生成迁移计划并**展示给用户确认**：
+
+```text
+📋 迁移计划
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+迁移顺序（共 18 个文件）：
+  [1] pages/index/index        → 简单，纯展示页
+  [2] pages/feed/detail       → 中等，含 tt.request / 分享
+  [3] components/banner-card  → 中等，含 swiper
+  ...
+
+风险点：
+  ⚠️ tt.login 需要重接服务端登录态
+  ⚠️ button open-type="share" / 视频挂载能力无机械等价物
+  ⚠️ pageLifetimes.resize 需要上提到页面容器重写
+
+是否开始迁移？(y/n)
+```
+
+---
+
+### Step 4: 执行迁移
+
+#### 4.1 文件转换规则
+
+抖音小程序每个页面/组件通常由 4 个文件组成，迁移后统一收敛为 Doubao Apps 的 `index.tsx` + `index.scss`：
+
+| 抖音小程序 | Doubao Apps | 说明 |
+|-----------|-------------|------|
+| `page.ttml` | `index.tsx` JSX 部分 | 模板转 TSX |
+| `page.ttss` | `index.scss` | 样式尽量保留 class 语义 |
+| `page.js` / `page.ts` | `index.tsx` 组件逻辑 | `Page({})` / `Component({})` 转 `definePage({})` 或 FC |
+| `page.json` | 合并到页面定义/路由配置 | 页面配置不再逐文件保留 |
+
+> **⚠️ 命名约束**：页面/组件目录下的入口文件必须命名为 **`index.tsx`**，样式文件为 **`index.scss`**。
+
+#### 4.2 单文件转换步骤（每个页面/组件）
+
+1. **依赖更新**：移除抖音小程序专属依赖，添加 `@doubao-apps/framework`
+2. **import 语句转换**：`tt.*` → `@doubao-apps/framework/api`
+3. **页面/组件定义方式**：`Page({})` / `Component({})` → `definePage({})` / `FC<Props>`
+4. **状态管理**：`data` + `setData` → `useState` / `useMemo` / `useEffect`
+5. **生命周期转换**：见 `lifecycle-mapping.md`
+6. **TTML 模板转 TSX**：见 `component-mapping.md`
+7. **TTSS 样式转 `index.scss`**：见 `style-mapping.md`
+8. **事件绑定**：见 `event-mapping.md`
+9. **平台能力拆分**：登录、分享、抖音视频/直播挂载能力单独标记
+
+#### 4.3 转换策略（优先级从高到低）
+
+```text
+映射文档 → 官方源文档 → 目标框架文档 → AI 推断 → 询问用户
+```
+
+---
+
+### Step 5: 迁移摘要
+
+输出本次迁移的执行结果：
+
+```text
+📋 迁移摘要
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+已迁移：16/18 文件
+  └─ 页面：11 个
+  └─ 组件：5 个
+
+跳过（平台强绑定）：
+  - pages/share-mount/index：依赖抖音分享/挂载链路
+  - components/live-entry/index：依赖直播挂载能力
+
+需人工处理：
+  - tt.login × 2 处：需重建服务端 code2session 登录链路
+  - button open-type × 3 处：需按业务目标改成 Doubao 原生交互
+```
+
+---
+
+### Step 6: 质量门禁（Quality Gate）
+
+迁移完成后，必须执行同级 skill：
+
+```text
+<当前 skill 同级目录>/quality-gate/SKILL.md
+```
+
+最低要求：
+
+- TypeScript 无报错
+- 页面可渲染
+- 核心路由可跳转
+- 网络请求与状态更新正常
+- 样式无明显结构性错位
+- 所有平台能力缺口都有迁移备注
+
+---
+
+## 特别注意事项
+
+### 1. 抖音小程序页面可能用 `Component()` 构造
+
+官方文档明确支持“使用 `Component` 构造器构造页面”。扫描时如果发现页面不是 `Page({})` 而是 `Component({})`，不要误判成普通组件，仍按页面迁移到 `definePage({})`。
+
+### 2. `tt.authorize` 不应被新代码直接平移
+
+官方文档已标记该 API “逐步废弃，后续不再维护”。遇到旧项目使用 `tt.authorize` 时，优先按具体能力重接，而不是照搬。
+
+### 3. 分享、视频挂载、直播挂载不是普通 UI 迁移
+
+这些能力依赖抖音宿主链路，不应简单替换为一个按钮或导航调用。必须在迁移报告里单列。
+
+### 4. 事件语法需要区分老写法和新写法
+
+抖音小程序同时存在：
+
+- 老写法：`bindtap` / `catchtap` / `capture-bind:touchstart`
+- 官方新写法：`bind:tap` / `bind:tap.capture` / `bind:tap.stop.prevent`
+
+迁移时统一转换为 TSX 函数引用和显式事件语义。
+
+---
+
+## 输出要求
+
+迁移结束时必须给出：
+
+1. 项目分析报告
+2. 用户确认过的迁移计划
+3. 迁移摘要
+4. 未完成项 / 平台能力缺口列表
+5. 后续质量门禁执行建议

package/dist/skills/douyin-to-doubao/assets/migration-checklist-template.md

@@ -0,0 +1,144 @@
+# 抖音小程序 → Doubao Apps 迁移检查清单
+
+> 对每个迁移的页面/组件，逐项执行本清单。
+
+---
+
+## 前置准备
+
+- [ ] 备份原始抖音小程序项目
+- [ ] 安装 Doubao Apps 知识库：`npx @doubao-apps/ai skills add doubao-apps-dev --agent codex`
+- [ ] 梳理项目页面列表（来自 `app.json` 的 `pages` 字段）
+- [ ] 梳理自定义组件列表与 `usingComponents`
+- [ ] 识别所有 `tt.*` API 调用，标记平台强绑定能力
+- [ ] 识别所有 `open-type`、分享、视频挂载、直播挂载入口
+
+---
+
+## 依赖处理
+
+- [ ] 移除抖音小程序专属依赖或 runtime
+- [ ] 添加 `@doubao-apps/framework`
+- [ ] 更新 `tsconfig.json`
+
+---
+
+## 逐文件迁移清单
+
+对每个 `.ttml` + `.ttss` + `.js/.ts` + `.json` 文件组，执行以下步骤：
+
+### 1. Import 语句转换
+
+- [ ] 移除全局 `tt` 对象直接调用
+- [ ] 添加 `import { ... } from '@doubao-apps/framework'`
+- [ ] 添加 `import { ... } from '@doubao-apps/framework/api'`
+- [ ] UI 组件直接使用小写标签，不要手写导入组件库
+
+### 2. 页面 / 组件定义转换
+
+- [ ] `Page({})` → `definePage({ ..., render() { return <PageComponent /> } })`
+- [ ] 页面若用 `Component({})` 构造，也要落为 `definePage({})`
+- [ ] `Component({ properties, methods })` → `FC<Props>`
+- [ ] `App({})` → `defineApp({...})`
+- [ ] `.json` 页面配置合并到目标工程结构
+
+### 3. 状态管理转换
+
+- [ ] `data: { foo: val }` → `const [foo, setFoo] = useState(val)`
+- [ ] `this.setData({ foo: val })` → `setFoo(val)`
+- [ ] `this.setData({ 'arr[0].key': val })` → 展开更新或 reducer
+- [ ] `this.data.foo` → 直接使用变量 `foo`
+- [ ] `this.properties.foo` → `props.foo`
+
+### 4. 生命周期转换
+
+- [ ] Page `onLoad(options)` → 不假设 `definePage` 存在同名钩子；页面输入改由 `getViewData()/getViewContext()` 或页面容器显式注入
+- [ ] Page `onShow / onHide` → `definePage.onShow/onHide`
+- [ ] Page `onReady` → `definePage.onMounted` 或组件内 `useEffect`
+- [ ] Page `onUnload` → `definePage.onDestroy`
+- [ ] Page `onPullDownRefresh / onReachBottom / onPageScroll` → 按页面容器或 `scroll-view` 事件重写，不假设存在同名页面钩子
+- [ ] Component `attached / ready` → `useEffect(() => {...}, [])`
+- [ ] Component `detached` → `useEffect(() => () => cleanup(), [])`
+- [ ] `pageLifetimes.show/hide/resize` 上提到页面容器
+
+### 5. TTML 模板转 TSX
+
+- [ ] `{{expression}}` → `{expression}`
+- [ ] `tt:if="{{cond}}"` → 条件表达式
+- [ ] `tt:for="{{list}}" tt:key="id"` → `list.map(...)`
+- [ ] `<block>` → `<>...</>` 或直接移除
+- [ ] 文本内容包裹在 `<text>` 中
+- [ ] `<navigator url="...">` → 显式路由 API
+
+### 6. TTSS 样式转 `index.scss`
+
+- [ ] `page.ttss` → `index.scss`
+- [ ] `class="xxx"` → `className="xxx"`
+- [ ] 保留可复用 class 语义，不要无脑改成内联 style
+- [ ] `rpx` / `px` / 百分比单位按 Doubao 样式能力核对
+- [ ] 对不兼容选择器和继承样式做扁平化处理
+
+### 7. 事件绑定转换
+
+- [ ] `bindtap` / `bind:tap` → `onClick={handleTap}`
+- [ ] `catchtap` / `catch:tap` / `bind:tap.stop` → `onCatchTap={handleTap}`
+- [ ] `capture-bind:*` / `bind:*.capture` → 视情况重构事件流
+- [ ] `bind:input` → `onInput`
+- [ ] `bind:tap.prevent` → 明确改写默认行为，不做机械替换
+- [ ] `data-* + dataset` → 优先改为闭包传值
+
+### 8. `tt.*` API 转换
+
+- [ ] `tt.request(...)` → `request(...)`
+- [ ] `tt.navigateTo/Back/RedirectTo(...)` → 对应路由 API
+- [ ] `tt.showToast(...)` → `showToast({ message, ... })`（注意 `title` 需改成 `message`）
+- [ ] `tt.showLoading/hideLoading/showModal(...)` → 先核对当前项目是否真的暴露对应 API，再决定是否迁移
+- [ ] `tt.getStorageSync/setStorageSync(...)` → 对应存储 API
+- [ ] `tt.login(...)` → 标记为服务端登录链路改造项
+- [ ] `tt.authorize(...)` → 标记为废弃能力重构项
+
+### 9. 组件替换
+
+- [ ] `view / text / image / scroll-view` → 对应 Doubao 标签
+- [ ] `swiper / swiper-item` → 直接使用小写 `<swiper>` / `<swiper-item>` 标签
+- [ ] `switch / slider / picker / radio / checkbox` → 直接使用小写标签；如目标标签能力不足，再按业务补封装
+- [ ] `button open-type=*` → 不机械迁移，按业务重写
+- [ ] `navigator` → 用路由 API 重写
+
+---
+
+## 验证步骤
+
+- [ ] TypeScript 编译无报错：`npx tsc --noEmit`
+- [ ] 构建成功：`pnpm run build`
+- [ ] 所有页面可正常渲染
+- [ ] 事件触发正常
+- [ ] 状态更新正常
+- [ ] 网络请求正常
+- [ ] 路由跳转正常
+- [ ] 样式结构正确
+- [ ] 平台强绑定能力均已记录
+
+---
+
+## 平台能力缺口记录
+
+| 功能 | 原因 | 处理状态 |
+|------|------|---------|
+| | | |
+
+---
+
+## 迁移报告模板
+
+```text
+迁移完成时间：YYYY-MM-DD
+迁移文件数量：____ 个（页面 ____ + 组件 ____）
+完成率：____/____（____%）
+
+未完成项：
+  - [文件] [原因]
+
+平台能力缺口：
+  - [能力名称] × [调用次数]：[处理建议]
+```