@doubao-apps/create 0.0.26 → 0.0.27

package/dist/template-starter/.ai/guides/system-prompt.md

@@ -21,7 +21,7 @@
 
 ### **项目文档系统**
 本地项目文档（按优先级）：
-1. **AGENTS.md** - 项目主入口，包含快速开始和核心规则
+1. **SKILL.md** - 项目主入口，包含快速开始和核心规则
 2. **.ai/rules/** - 框架规则和约束
 3. **.ai/guides/** - 开发指南
 4. **.ai/examples/** - 代码示例库
@@ -50,7 +50,7 @@ LynxBase MCP 提供：
 ## 知识体系
 
 ### 知识优先级
-1. **项目本地文档**（AGENTS.md 及 .ai/ 目录）
+1. **项目本地文档**（SKILL.md 及 .ai/ 目录）
 2. **LynxBase MCP**（Lynx 官方/内部文档）
 3. **通用编程知识**
 
@@ -64,7 +64,7 @@ LynxBase MCP 提供：
 
 [生成代码]
 
-详细的开发规范请参考：[.ai/prompts/component-development.md](.ai/prompts/component-development.md)
+详细的开发规范请参考：[component-development.md](component-development.md)
 ```
 
 **错误做法**：
@@ -191,7 +191,7 @@ ReactLynx 镜像 React API（`useState`、`useEffect` 等），但所有生命
 
 **4. 项目结构问题** → 引用本地文档
 - 示例："如何组织组件？"
-- 响应：简短说明 + 引用 AGENTS.md 或 .ai/rules/
+- 响应：简短说明 + 引用 SKILL.md 或 .ai/rules/
 
 **5. 问题诊断** → 分析 + 解决方案 + 预防措施
 - 示例："报错了"
@@ -209,7 +209,7 @@ ReactLynx 镜像 React API（`useState`、`useEffect` 等），但所有生命
 
 2. **规划方法**
    - **Lynx 相关** → 查询 **LynxBase MCP** 获取支持数据
-   - **项目结构/规则** → 引用本地文档（AGENTS.md、.ai/）
+   - **项目结构/规则** → 引用本地文档（SKILL.md、.ai/）
 
 3. **调用适当工具**
    - Lynx 相关 → **LynxBase MCP**
@@ -261,7 +261,7 @@ ReactLynx 镜像 React API（`useState`、`useEffect` 等），但所有生命
    - 提供错误处理代码
 
 4. ❌ **不要违反框架规则**
-   - 严格遵守 AGENTS.md 和 Lynx 规范
+   - 严格遵守 SKILL.md 和 Lynx 规范
    - 不要为了方便走捷径
 
 5. ❌ **不要过度工程化**
@@ -280,13 +280,13 @@ ReactLynx 镜像 React API（`useState`、`useEffect` 等），但所有生命
 
 | 用户请求 | 查阅文档 | 你的动作 |
 |---------|---------|---------|
-| "创建页面" | `.ai/prompts/component-development.md` (Page) + LynxBase MCP | 生成代码 + 引用文档 |
-| "创建卡片" | `.ai/prompts/component-development.md` (Widget) + LynxBase MCP | 生成代码 + 引用文档 |
+| "创建页面" | `.ai/guides/component-development.md` (Page) + LynxBase MCP | 生成代码 + 引用文档 |
+| "创建卡片" | `.ai/guides/component-development.md` (Widget) + LynxBase MCP | 生成代码 + 引用文档 |
 | "Lynx 组件如何用" | LynxBase MCP → `query-assets` → `get-assets` | 查询 + 提供示例 |
 | "如何调用 API" | `.ai/examples/common-patterns.md` + Doubao Bridge 文档 | 提供示例 + 引用文档 |
-| "性能优化" | `.ai/prompts/performance-optimization.md` + Lynx 性能指南 | 分析问题 + 引用文档 |
-| "报错了" | `.ai/prompts/troubleshooting.md` + 错误分析 | 诊断 + 修复 + 引用文档 |
-| "框架规则" | `.ai/rules/dos-and-donts.md` + AGENTS.md | 简要说明 + 引用文档 |
+| "性能优化" | `.ai/guides/performance-optimization.md` + Lynx 性能指南 | 分析问题 + 引用文档 |
+| "报错了" | `.ai/guides/troubleshooting.md` + 错误分析 | 诊断 + 修复 + 引用文档 |
+| "框架规则" | `.ai/rules/dos-and-donts.md` + SKILL.md | 简要说明 + 引用文档 |
 
 ---
 
@@ -309,7 +309,7 @@ ReactLynx 镜像 React API（`useState`、`useEffect` 等），但所有生命
 1. 调用 **LynxBase MCP** 查询主线程相关文档
 2. 简短解释："主线程脚本是在 Lynx 主线程执行的 JS 代码，用于高频交互和实时更新..."
 3. 提供简单示例
-4. 引用详细文档："更多详情请查阅 LynxBase 文档或参考 [性能优化指南](.ai/prompts/performance-optimization.md)"
+4. 引用详细文档："更多详情请查阅 LynxBase 文档或参考 [性能优化指南](performance-optimization.md)"
 
 ### 示例 3：项目规则
 **用户**："组件应该放在哪里？"
@@ -324,8 +324,8 @@ ReactLynx 镜像 React API（`useState`、`useEffect` 等），但所有生命
 - `index.scss` - 样式文件
 - `types.ts` - 类型定义（可选）
 
-详细规范请参考：[AGENTS.md](./AGENTS.md) 和 [组件开发指南](.ai/prompts/component-development.md)"
+详细规范请参考：[SKILL.md](../../SKILL.md) 和 [组件开发指南](component-development.md)"
 
 ---
 
-*系统提示词版本: 2.0.0 | 集成: Lynx + Doubao Apps SDK | 维护: Doubao Apps SDK 团队*
+*系统提示词版本: 2.0.0 | 集成: Lynx + Doubao Apps SDK | 维护: Doubao Apps SDK 团队*

package/dist/template-starter/.ai/reference/framework-api-quick-ref.md

@@ -136,7 +136,7 @@ console.log(info.keys, info.currentSize, info.limitSize);
 ## 引入依赖
 
 ```ts
-import { getLocation, getPhoneNumber, openPage, request, showToast, setStorage, getStorage } from '@doubao-apps/framework/api';
+import { getLocation, getPhoneNumber, navigateTo, navigateBack, request, showToast, setStorage, getStorage } from '@doubao-apps/framework/api';
 ```
 
 ## 使用示例
@@ -144,7 +144,8 @@ import { getLocation, getPhoneNumber, openPage, request, showToast, setStorage,
 ```ts
 await showToast({ message: '保存成功' });
 
-const { viewId } = await openPage({ pageId: 'detail', context: {} });
+await navigateTo({ url: 'detail?id=123' });
+await navigateBack();
 
 const res = await request({ url: '/api/data', method: 'GET' });
 
@@ -155,85 +156,57 @@ const phone = await getPhoneNumber();
 
 以下为常用端能力 API 的节选，完整以 `@doubao-apps/framework/api` 类型定义为准。
 
-### openFloatingWindow
+### navigateTo
 
 **参数**:
 ```typescript
 {
-  /** 期望要打开的 page 的 id */
-  pageId: string;
-
-  /** 打开页面时传入的数据，运行时通过 getViewData 获取 */
-  pageData?: string;
-
-  /** view context 对象，在全页和卡片中通过 getViewContext() 获取 */
-  context: object;
-
-  /** 打开 Page 时配置页面参数 */
-  pageSettings?: {
-    /**
-     * 悬浮窗口在横向上的吸附位置
-     *
-     * @deprecated 最新的 Lynx 悬浮窗中已失效
-     */
-    align?: 'left' | 'right';
-    
-    /**
-     * 设置 Lynx 悬浮窗的宽度，单位是 `px`
-     */
-    width?: number;
-    
-    /**
-     *  设置 Lynx 悬浮窗的高度，单位是 `px`
-     */
-    height?: number;
-    
-    /**
-     * 优先级。越高代表优先级越高，取值-2~2
-     */
-    priority?: number;
-    
-    /**
-     * 是否自动恢复展示。在被高优悬浮窗打断时会发挥作用，只有为 true 才会得到恢复的机会，否则直接释放
-     */
-    autoReshow?: boolean;
-  };
+  /** 跳转目标，填写页面的 pageId，可拼接 query，如 'detail?id=123' */
+  url: string;
 }
 ```
 
-**返回值**:
+**返回值**: Promise
+
+### redirectTo
+
+**参数**:
 ```typescript
 {
-  /** 创建出的 view id */
-  viewId: string;
-  
-  /**
-   * 返回展示悬浮窗的结果
-   * 0: 展示失败
-   * 1: 展示成功
-   * 2: 排队中
-   */
-  floatingShowResult?: number;
+  /** 跳转目标，填写页面的 pageId，如 'settings' */
+  url: string;
 }
 ```
 
-### close
+**返回值**: Promise
+
+### reLaunch
 
 **参数**:
 ```typescript
 {
-  /** 要关闭的页面 id，留空(undefined) 为当前页面 */
-  viewID?: string;
-  /** 要关闭的多个页面 id */
-  viewIDs?: string[];
-  /**
-   * @default false
-   */
-  animated?: boolean;
+  /** 跳转目标，填写页面的 pageId，如 'home' */
+  url: string;
 }
 ```
 
-**返回值**: 无（空对象）
+**返回值**: Promise
+
+### navigateBack
+
+**参数**:
+```typescript
+{
+  /** 返回的页面数，默认为 1 */
+  delta?: number;
+}
+```
+
+**返回值**: Promise
+
+> `close()` 已废弃，公开路由场景请优先使用 `navigateBack()`。
+>
+> 常规页面跳转场景下，`url` 直接使用目标页面的 `pageId`，该值一般与页面的 `aiMeta.id` 一致；需要传参时可直接拼接 query string。
 
 ### showToast
 
@@ -413,7 +386,7 @@ const phone = await getPhoneNumber();
 
 | API | 功能 | 示例 |
 |-----|------|------|
-| `sendQueryMessage(params)` | 发送用户消息 | `sendQueryMessage({ content: '查询天气', type: 'text', context: {} })` |
+| `sendQueryMessage(params)` | 发送用户消息 | `sendQueryMessage({ content: '查询天气', type: 'text' })` |
 | `setAdditionalContext(params)` | 设置上下文 | `setAdditionalContext({ additionalContext: '...' })` |
 
 ### sendQueryMessage
@@ -426,12 +399,6 @@ const phone = await getPhoneNumber();
 
   /** 消息类型，目前仅支持 text */
   type: 'text';
-
-  /** Plugin tool 或 Page/Widget 携带的上下文信息 */
-  context: object;
-
-  /** 扩展信息 */
-  ext?: Record<string, string>;
 }
 ```
 
@@ -500,21 +467,7 @@ interface PageInput {
   [key: string]: any;  // URL 参数
 }
 
-// Widget Input Schema
-interface WidgetInputSchema {
-  type: 'object';
-  properties: {
-    [key: string]: {
-      type: 'string' | 'number' | 'boolean' | 'array' | 'object';
-      title: string;
-      description?: string;
-      default?: any;
-    };
-  };
-  required?: string[];
-}
-
-// aiMeta 配置
+// src/app.config.ts 中的 metadata 配置
 interface PageAIMeta {
   id: string;                      // 页面唯一标识
   title?: string;                  // 页面标题
@@ -526,7 +479,15 @@ interface WidgetAIMeta {
   name?: string;                   // 卡片名称
   description?: string;            // 卡片描述
   boxType?: 'inbox' | 'full_box';  // 卡片类型
-  input: WidgetInputSchema;        // 输入数据格式
+  border?: boolean;                // 是否显示边框
+  keywords?: string[];             // 搜索关键词
+  titleType?: 'none' | 'normal' | 'float';
+}
+
+// Widget 渲染数据类型
+interface WidgetViewData {
+  title: string;
+  content?: string;
 }
 ```
 

package/dist/template-starter/.ai/reference/open-api/01-/345/237/272/347/241/200-/350/264/246/345/217/267-/347/263/273/347/273/237.md

@@ -6,19 +6,19 @@
 
 ## 速查
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 |
-| --- | --- | --- | --- | --- | --- |
-| [`getAccountInfo`](#getaccountinfo) | `getAccountInfo(params?): Promise<GetAccountInfoResult>` | 异步获取账号信息 | `params?` | `Promise<GetAccountInfoResult>` | - |
-| [`getAccountInfoSync`](#getaccountinfosync) | `getAccountInfoSync(params?): GetAccountInfoResult` | 同步获取账号信息 | `params?` | `GetAccountInfoResult` | 同步 API |
-| [`authorize`](#authorize) | `authorize(params): Promise<object>` | 初始化授权 | `params: AuthorizeRequest` | `Promise<object>` | 按 scope 申请授权 |
-| [`canIUse`](#caniuse) | `canIUse(params): Promise<CanIUseResult>` | 检测当前宿主是否支持指定 API 或能力 | `params: CanIUseParams` | `Promise<CanIUseResult>` | 用于兼容性判断 |
-| [`getLocation`](#getlocation) | `getLocation(params?): Promise<GetLocationResponse>` | 获取设备当前的地理位置信息 | `params?: GetLocationParams` | `Promise<GetLocationResponse>` | 可能涉及定位授权 |
-| [`login`](#login) | `login(params?): Promise<LoginResult>` | 发起登录并获取登录凭证 | `params?: LoginRequest` | `Promise<LoginResult>` | - |
-| [`getWindowInfoSync`](#getwindowinfosync) | `getWindowInfoSync(_param?): GetWindowInfoResult` | 获取窗口信息 | `_param?` | `GetWindowInfoResult` | 同步 API |
-| [`getSystemSetting`](#getsystemsetting) | `getSystemSetting(params?): GetSystemSettingResult` | 获取设备设置 | `params?` | `GetSystemSettingResult` | - |
-| [`getAppBaseInfoSync`](#getappbaseinfosync) | `getAppBaseInfoSync(_params?): GetAppBaseInfoResult` | 获取应用基础信息 | `_params?` | `GetAppBaseInfoResult` | 同步 API |
-| [`getWindowInfo`](#getwindowinfo) | `getWindowInfo(_params?): Promise<GetWindowInfoResult>` | 获取窗口信息 | `_params?` | `Promise<GetWindowInfoResult>` | - |
-| [`getAppBaseInfo`](#getappbaseinfo) | `getAppBaseInfo(params?): Promise<GetAppBaseInfoResult>` | 获取应用基础信息 | `params?` | `Promise<GetAppBaseInfoResult>` | - |
+| API | 说明 |
+| --- | --- |
+| [getAccountInfo](#getaccountinfo) | 异步获取账号信息。 |
+| [getAccountInfoSync](#getaccountinfosync) | 同步获取账号信息。<br><br>同步 API。 |
+| [authorize](#authorize) | 初始化授权。<br><br>按 scope 申请授权。 |
+| [canIUse](#caniuse) | 检测当前宿主是否支持指定 API 或能力。<br><br>用于兼容性判断。 |
+| [getLocation](#getlocation) | 获取设备当前的地理位置信息。<br><br>可能涉及定位授权。 |
+| [login](#login) | 发起登录并获取登录凭证。 |
+| [getWindowInfoSync](#getwindowinfosync) | 获取窗口信息。<br><br>同步 API。 |
+| [getSystemSetting](#getsystemsetting) | 获取设备设置。 |
+| [getAppBaseInfoSync](#getappbaseinfosync) | 获取应用基础信息。<br><br>同步 API。 |
+| [getWindowInfo](#getwindowinfo) | 获取窗口信息。 |
+| [getAppBaseInfo](#getappbaseinfo) | 获取应用基础信息。 |
 
 ## API 详情
 

package/dist/template-starter/.ai/reference/open-api/{02-storage.md → 02-/345/255/230/345/202/250.md}

@@ -1,4 +1,4 @@
-# Open API: Storage
+# Open API: 存储
 
 本地缓存；带 Sync 后缀的是同步 API。
 
@@ -6,18 +6,18 @@
 
 ## 速查
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 |
-| --- | --- | --- | --- | --- | --- |
-| [`setStorage`](#setstorage) | `setStorage<TData>(params): Promise<object>` | 将数据写入本地缓存 | `params: SetStorageParams<TData>` | `Promise<object>` | data 会 JSON 序列化 |
-| [`setStorageSync`](#setstoragesync) | `setStorageSync<TData>(params): object` | 将数据写入本地缓存 | `params: SetStorageParams<TData>` | `object` | data 会 JSON 序列化；同步 API |
-| [`getStorage`](#getstorage) | `getStorage<TData>(params): Promise<GetStorageResult<TData>>` | 从本地缓存读取数据 | `params: GetStorageParams` | `Promise<GetStorageResult<TData>>` | data 会 JSON 反序列化 |
-| [`getStorageSync`](#getstoragesync) | `getStorageSync<TData>(params): GetStorageResult<TData>` | 从本地缓存同步读取数据 | `params: GetStorageParams` | `GetStorageResult<TData>` | data 会 JSON 反序列化；同步 API |
-| [`removeStorage`](#removestorage) | `removeStorage(params): Promise<object>` | 删除本地缓存中指定 key 的数据 | `params: RemoveStorageParams` | `Promise<object>` | - |
-| [`removeStorageSync`](#removestoragesync) | `removeStorageSync(params?): object` | 删除本地缓存中指定 key 的数据 | `params?: RemoveStorageParams` | `object` | 同步 API |
-| [`clearStorage`](#clearstorage) | `clearStorage(params?): Promise<object>` | 清空本地缓存 | `params?: object` | `Promise<object>` | - |
-| [`clearStorageSync`](#clearstoragesync) | `clearStorageSync(params?): object` | 清空本地缓存 | `params?: object` | `object` | 同步 API |
-| [`getStorageInfo`](#getstorageinfo) | `getStorageInfo(params?): Promise<GetStorageInfoResult>` | 获取本地缓存信息 | `params?` | `Promise<GetStorageInfoResult>` | - |
-| [`getStorageInfoSync`](#getstorageinfosync) | `getStorageInfoSync(params?): GetStorageInfoResult` | 同步获取本地缓存信息 | `params?` | `GetStorageInfoResult` | 同步 API |
+| API | 说明 |
+| --- | --- |
+| [setStorage](#setstorage) | 将数据写入本地缓存。 |
+| [setStorageSync](#setstoragesync) | 将数据写入本地缓存。<br><br>同步 API。 |
+| [getStorage](#getstorage) | 从本地缓存读取数据。 |
+| [getStorageSync](#getstoragesync) | 从本地缓存同步读取数据。<br><br>同步 API。 |
+| [removeStorage](#removestorage) | 删除本地缓存中指定 key 的数据。 |
+| [removeStorageSync](#removestoragesync) | 删除本地缓存中指定 key 的数据。<br><br>同步 API。 |
+| [clearStorage](#clearstorage) | 清空本地缓存。 |
+| [clearStorageSync](#clearstoragesync) | 清空本地缓存。<br><br>同步 API。 |
+| [getStorageInfo](#getstorageinfo) | 获取本地缓存信息。 |
+| [getStorageInfoSync](#getstorageinfosync) | 同步获取本地缓存信息。<br><br>同步 API。 |
 
 ## API 详情
 
@@ -46,8 +46,6 @@
 
 #### Remarks
 
-data 会 JSON 序列化。
-
 #### Example
 
 ```typescript
@@ -84,8 +82,6 @@ await setStorage({
 
 #### Remarks
 
-data 会 JSON 序列化。
-
 #### Example
 
 ```typescript
@@ -122,8 +118,6 @@ setStorageSync({
 
 #### Remarks
 
-data 会 JSON 反序列化。
-
 #### Example
 
 ```typescript
@@ -161,8 +155,6 @@ console.log(result.data.name, result.data.age);
 
 #### Remarks
 
-data 会 JSON 反序列化。
-
 #### Example
 
 ```typescript

package/dist/template-starter/.ai/reference/open-api/{03-router.md → 03-/350/267/257/347/224/261.md}

@@ -1,4 +1,4 @@
-# Open API: Router
+# Open API: 路由
 
 应用内页面跳转和关闭。
 
@@ -6,14 +6,14 @@
 
 ## 速查
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 |
-| --- | --- | --- | --- | --- | --- |
-| [`close`](#close) | `close(params?): Promise<object>` | 关闭栈顶页面 | `params?: CloseParams` | `Promise<object>` | 已废弃，使用 navigateBack |
-| [`navigateTo`](#navigateto) | `navigateTo(params): Promise<object>` | 保留当前页面，跳转到应用内的某个页面 | `params: NavigateToParams` | `Promise<object>` | - |
-| [`redirectTo`](#redirectto) | `redirectTo(params): Promise<object>` | 关闭当前页面，跳转到应用内的某个页面 | `params: NavigateToParams` | `Promise<object>` | - |
-| [`reLaunch`](#relaunch) | `reLaunch(params): Promise<object>` | 关闭所有页面并跳转到应用内页面 | `params: NavigateToParams` | `Promise<object>` | - |
-| [`navigateBack`](#navigateback) | `navigateBack(params?): Promise<object>` | 关闭当前页面，返回上一页面或多级页面 | `params?: NavigateBackParams` | `Promise<object>` | - |
-| [`exitApp`](#exitapp) | `exitApp(): Promise<object>` | 退出当前所有页面 | `-` | `Promise<object>` | 会退出当前所有页面 |
+| API | 说明 |
+| --- | --- |
+| [close](#close) | 关闭栈顶页面。<br><br>已废弃，使用 navigateBack。 |
+| [navigateTo](#navigateto) | 保留当前页面，跳转到应用内的某个页面。 |
+| [redirectTo](#redirectto) | 关闭当前页面，跳转到应用内的某个页面。 |
+| [reLaunch](#relaunch) | 关闭所有页面并跳转到应用内页面。 |
+| [navigateBack](#navigateback) | 关闭当前页面，返回上一页面或多级页面。 |
+| [exitApp](#exitapp) | 退出当前所有页面。<br><br>会退出当前所有页面。 |
 
 ## API 详情
 

package/dist/{template-empty/.ai/reference/open-api/04-ui- → template-starter/.ai/reference/open-api/04-/347/225/214/351/235/242-}/344/272/244/344/272/222.md

@@ -1,4 +1,4 @@
-# Open API: UI / 交互
+# Open API: 界面 / 交互
 
 Toast、Loading、Modal、ActionSheet 和返回前提醒。
 
@@ -6,17 +6,17 @@ Toast、Loading、Modal、ActionSheet 和返回前提醒。
 
 ## 速查
 
-| API | 签名 | 用途 | 参数类型 | 结果类型 | 注意点 |
-| --- | --- | --- | --- | --- | --- |
-| [`showModal`](#showmodal) | `showModal(params): Promise<ShowModalResult>` | 显示模态对话框 | `params: ShowModalParams` | `Promise<ShowModalResult>` | - |
-| [`showLoading`](#showloading) | `showLoading(params?): Promise<object>` | 显示 loading 提示框 | `params?: ShowLoadingParams` | `Promise<object>` | 需调用 hideLoading 关闭 |
-| [`hideToast`](#hidetoast) | `hideToast(params?): Promise<object>` | 隐藏当前 Toast | `params?: HideInteractionParams` | `Promise<object>` | - |
-| [`hideLoading`](#hideloading) | `hideLoading(params?): Promise<object>` | 隐藏当前 loading | `params?: HideInteractionParams` | `Promise<object>` | - |
-| [`showActionSheet`](#showactionsheet) | `showActionSheet(params): Promise<ShowActionSheetResult>` | 显示操作菜单 | `params: ShowActionSheetParams` | `Promise<ShowActionSheetResult>` | - |
-| [`getMenuButtonBoundingClientRect`](#getmenubuttonboundingclientrect) | `getMenuButtonBoundingClientRect(params?): MenuButtonBoundingClientRect` | 获取菜单按钮的布局位置信息 | `params?` | `MenuButtonBoundingClientRect` | - |
-| [`enableAlertBeforeUnload`](#enablealertbeforeunload) | `enableAlertBeforeUnload(params): Promise<object>` | 开启页面返回前提醒 | `params: EnableAlertBeforeUnloadParams` | `Promise<object>` | 配合 disableAlertBeforeUnload 使用 |
-| [`disableAlertBeforeUnload`](#disablealertbeforeunload) | `disableAlertBeforeUnload(params?): Promise<object>` | 关闭页面返回前提醒 | `params?: Record<string, never>` | `Promise<object>` | - |
-| [`showToast`](#showtoast) | `showToast(params): Promise<object>` | 显示 Toast 提示 | `params: ShowToastParams` | `Promise<object>` | duration 和 icon 可控制提示表现 |
+| API | 说明 |
+| --- | --- |
+| [showModal](#showmodal) | 显示模态对话框。 |
+| [showLoading](#showloading) | 显示 loading 提示框。<br><br>需调用 hideLoading 关闭。 |
+| [hideToast](#hidetoast) | 隐藏当前 Toast。 |
+| [hideLoading](#hideloading) | 隐藏当前 loading。 |
+| [showActionSheet](#showactionsheet) | 显示操作菜单。 |
+| [getMenuButtonBoundingClientRect](#getmenubuttonboundingclientrect) | 获取菜单按钮的布局位置信息。 |
+| [enableAlertBeforeUnload](#enablealertbeforeunload) | 开启页面返回前提醒。<br><br>配合 disableAlertBeforeUnload 使用。 |
+| [disableAlertBeforeUnload](#disablealertbeforeunload) | 关闭页面返回前提醒。 |
+| [showToast](#showtoast) | 显示 Toast 提示。<br><br>duration 和 icon 可控制提示表现。 |
 
 ## API 详情
 

package/dist/template-starter/.ai/reference/open-api/05-/347/225/214/351/235/242-/350/276/223/345/205/245.md

@@ -0,0 +1,42 @@
+# Open API: 界面 / 输入
+
+键盘和输入框选区能力。
+
+[返回目录](./README.md) | [返回速查](../open-api.md)
+
+## 速查
+
+| API | 说明 |
+| --- | --- |
+| [onKeyboardHeightChange](#onkeyboardheightchange) | 监听键盘高度变化事件。<br><br>返回取消监听函数。 |
+
+## API 详情
+
+<a id="onkeyboardheightchange"></a>
+### 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 });
+});
+```

package/dist/template-starter/.ai/reference/open-api/06-/347/275/221/347/273/234.md

@@ -0,0 +1,148 @@
+# Open API: 网络
+
+网络请求
+
+[返回目录](./README.md) | [返回速查](../open-api.md)
+
+## 速查
+
+| API | 说明 |
+| --- | --- |
+| [request](#request) | 发起网络请求。<br><br>返回 statusCode、header 和 data。 |
+
+## API 详情
+
+<a id="request"></a>
+### request()
+
+> **request**(`params`): `Promise`\<[`RequestResponse`](#requestresponse)\>
+
+发起网络请求。
+
+#### Parameters
+
+• **params**: [`RequestParams`](#requestparams)
+
+请求参数，字段见 [RequestParams](#requestparams)。
+
+#### Returns
+
+`Promise`\<[`RequestResponse`](#requestresponse)\>
+
+返回一个 Promise，解析为 [RequestResponse](#requestresponse)。
+
+#### Remarks
+
+返回 statusCode、header 和 data。
+
+#### Example
+
+```typescript
+import { request } from '@doubao-apps/framework/api';
+
+const result = await request({
+  url: 'https://postman-echo.com/post',
+  method: 'POST',
+  dataType: 'json',
+  header: { 'content-type': 'application/json' },
+  data: { hello: 'world' }
+});
+
+console.log(result.statusCode, result.data);
+```
+
+## 相关类型
+
+<a id="requestparams"></a>
+### RequestParams
+
+网络请求参数。
+
+#### Properties
+
+##### data?
+
+> `optional` **data**: `string` \| `Record`\<`string`, `any`\> \| `ArrayBuffer`
+
+请求体数据。
+
+传给服务器的数据最终会是 `String` 或 `ArrayBuffer`：
+- 若 `data` 是 `string` 或 `ArrayBuffer`，直接使用；
+- 若 `header['content-type']` 是 `application/x-www-form-urlencoded`，会被编码为 query string，例如：`encodeURIComponent(k)=encodeURIComponent(v)`；
+- 若 `header['content-type']` 是 `application/json`，会执行 JSON 序列化；
+- 若 `data` 是普通对象且未命中上述类型，也会执行 JSON 序列化；
+- 其他类型会调用 `toString()`
+
+##### dataType?
+
+> `optional` **dataType**: `"string"` \| `"json"`
+
+期望返回的数据格式。
+- `json`: 尝试按 JSON 解析；
+- `string`: 按字符串返回。
+
+###### Default
+
+```ts
+"json"
+```
+
+##### header?
+
+> `optional` **header**: `Record`\<`string`, `string`\>
+
+请求 Header。
+
+###### Default
+
+```ts
+{"content-type": "application/json"}
+```
+
+##### method?
+
+> `optional` **method**: [`RequestMethod`](#requestmethod)
+
+请求方法。
+
+###### Default
+
+```ts
+"GET"
+```
+
+##### url
+
+> **url**: `string`
+
+请求地址，需为完整的 **HTTPS** URL。
+
+<a id="requestresponse"></a>
+### RequestResponse
+
+网络请求返回结果。
+
+#### Properties
+
+##### data?
+
+> `optional` **data**: `string` \| `Record`\<`string`, `any`\> \| `ArrayBuffer`
+
+响应数据，类型由 `dataType` 决定。
+
+##### header
+
+> **header**: `Record`\<`string`, `string`\>
+
+HTTP 响应头。
+
+##### statusCode
+
+> **statusCode**: `number`
+
+HTTP 状态码。
+
+<a id="requestmethod"></a>
+### RequestMethod
+
+> **RequestMethod**: `"GET"` \| `"POST"` \| `"PUT"` \| `"DELETE"` \| `"HEAD"` \| `"OPTIONS"` \| `"TRACE"` \| `"CONNECT"`