@doubao-apps/create 0.0.26 → 0.0.27

package/dist/36.js

@@ -1,5 +1,5 @@
-import"node:module";import e from"node:path";import t,{promises as r}from"node:fs";import{execFileSync as a}from"node:child_process";import{fileURLToPath as o}from"node:url";let i=e.join("src","app.ts");function n(e){return e.replace(/\\/g,"\\\\").replace(/'/g,"\\'").replace(/\r/g,"\\r").replace(/\n/g,"\\n").replace(/\u2028/g,"\\u2028").replace(/\u2029/g,"\\u2029")}async function s(t,a,o=""){let c,l=e.join(t,i);try{c=await r.readFile(l,"utf8")}catch(e){if(e?.code==="ENOENT")return;throw e}let p=c.replace("<%= appId %>",n(a)).replace("<%= name %>",n(o));p!==c&&await r.writeFile(l,p,"utf8")}let c=new Set(["node_modules","dist",".git"]);async function l(t,a,o={}){let{includeAI:i=!0}=o,n=async(t,a)=>{for(let o of(await r.mkdir(a,{recursive:!0}),await r.readdir(t,{withFileTypes:!0}))){let s=e.join(t,o.name),l=e.join(a,o.name);if(o.isDirectory()){if(c.has(o.name)||".ai"===o.name&&!i)continue;await n(s,l)}else{if("AGENTS.md"===o.name&&!i)continue;await r.copyFile(s,l)}}};await n(t,a)}let p=new Set([".js",".cjs",".mjs",".ts",".tsx",".jsx",".json",".md",".txt",".scss",".css",".less",".html",".yml",".yaml"]),d=[["@byted-doubao-apps/framework","@doubao-apps/framework"],["@byted-doubao-apps/kit","@doubao-apps/kit"],["@byted-doubao-apps/ai","@doubao-apps/ai"],["@byted-doubao-apps/create","@doubao-apps/create"],["@byted-doubao-apps/taro-runtime","@doubao-apps/taro-runtime"]],u=["doubao.config.ts"],f=["@byted-doubao-apps/deploy","@doubao-apps/deploy"],m=["deploy"],y=["pnpm run deploy","doubao.config.ts","部署到豆包平台"];function w(e){let t=e;for(let[e,r]of d)t=t.replace(RegExp(e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),"g"),r);return t}async function h(t,a){for(let i of(await r.readdir(t,{withFileTypes:!0}))){var o;let n=e.join(t,i.name);if(function(e){return u.some(t=>t===e)}(i.name)){await r.rm(n,{recursive:!0,force:!0});continue}if(i.isDirectory()){await h(n,a);continue}if(o=i.name,!p.has(e.extname(o))&&"package.json"!==o&&"tsconfig.json"!==o)continue;let s=await r.readFile(n,"utf-8");await r.writeFile(n,function(e,t,r){if("package.json"===e){let e=JSON.parse(w(t));if(e.scripts&&"object"==typeof e.scripts){for(let t of m)delete e.scripts[t];0===Object.keys(e.scripts).length&&delete e.scripts}for(let t of["dependencies","devDependencies","peerDependencies"])if(e[t]&&"object"==typeof e[t]){for(let a of Object.keys(e[t]))f.some(e=>e===a)?delete e[t][a]:a.startsWith("@doubao-apps/")&&(e[t][a]=`^${r}`);0===Object.keys(e[t]).length&&delete e[t]}return`${JSON.stringify(e,null,2)}
-`}return"README.md"===e||"AGENTS.md"===e?w(t).split("\n").filter(e=>!y.some(t=>e.includes(t))).join("\n"):w(t)}(i.name,s,a))}}function b(e){return e?/[<>:"|?*\x00-\x1F]/.test(e)?{valid:!1,error:"Project name contains invalid characters"}:[".",".."].includes(e)?{valid:!1,error:"Project name is reserved"}:{valid:!0}:{valid:!1,error:"Project name is required"}}function j(e){return e.trim().toLowerCase().replace(/\s+/g,"-").replace(/^[._]/,"").replace(/[^a-z0-9-~._]+/g,"-")}async function g(r,a){let o=e.join(r,"package.json");if(!t.existsSync(o))throw Error("package.json not found in template");let i=JSON.parse(t.readFileSync(o,"utf-8"));i.name=a,t.writeFileSync(o,`${JSON.stringify(i,null,2)}
-`)}let E=["starter","empty"],N=[{value:"starter",label:"Starter (default)",hint:"Starter template with example pages"},{value:"empty",label:"Empty",hint:"Minimal template without example pages"}];function v(e){return E.includes(e)}let S=o(import.meta.url),$=e.dirname(S),T={".gitignore":["dist","node_modules",".DS_Store"]};async function O(t){for(let[a,o]of Object.entries(T))await r.writeFile(e.join(t,a),`${o.join("\n")}
-`)}async function k(){let t=e.resolve($,"..","package.json");return JSON.parse(await r.readFile(t,"utf-8")).version??"0.0.1"}async function F(t){let o=e.join(t,".git");if(!await r.stat(o).then(e=>e.isDirectory()).catch(e=>{if(e?.code==="ENOENT")return!1;throw e}))try{a("git",["init"],{cwd:t,stdio:"ignore"})}catch(e){if(e?.code==="ENOENT")return;throw Error(`Failed to initialize git repository: ${t}`,{cause:e})}}async function x({template:t,projectDir:a,public:o=!0,includeAI:i,appId:n,name:c,packageName:p,overwrite:d}){if(!e.isAbsolute(a))throw Error(`Project directory must be an absolute path: ${a}`);if(!v(t))throw Error(`Invalid template: ${t}. Valid options: ${E.join(", ")}`);let u=e.resolve($,`template-${t}`);try{if(!(await r.stat(u)).isDirectory())throw Error(`Template path is not a directory: ${u}`)}catch(e){if(e?.code==="ENOENT")throw Error(`Template directory not found: ${u}`,{cause:e});throw Error(`Unable to access template directory: ${u}`,{cause:e})}if(await r.stat(a).then(e=>{if(!e.isDirectory())throw Error(`Project path is not a directory: ${a}`);return!0}).catch(e=>{if(e?.code==="ENOENT")return!1;throw Error(`Unable to access project directory: ${a}`,{cause:e})})){if((await r.readdir(a)).length>0&&!d)throw Error(`Project directory is not empty: ${a}`)}else await r.mkdir(a,{recursive:!0});await l(u,a,{includeAI:i}),o&&await h(a,await k()),await O(a),await F(a);let f=p??j(e.basename(a));await g(a,f),await s(a,n??`com.doubao.${f}`,c??"")}export{E as TEMPLATES,N as TEMPLATE_CHOICES,x as create,j as formatProjectName,v as isValidTemplate,t as node_fs,e as node_path,b as validateProjectName};
+import"node:module";import e from"node:path";import t,{promises as r}from"node:fs";import{execFileSync as a}from"node:child_process";import{fileURLToPath as o}from"node:url";let i=e.join("src","app.config.ts"),n=e.join("src","app.ts");function s(e){return e.replace(/\\/g,"\\\\").replace(/'/g,"\\'").replace(/\r/g,"\\r").replace(/\n/g,"\\n").replace(/\u2028/g,"\\u2028").replace(/\u2029/g,"\\u2029")}async function c(t,a,o=""){for(let c of[i,n].map(r=>e.join(t,r))){let e;try{e=await r.readFile(c,"utf8")}catch(e){if(e?.code==="ENOENT")continue;throw e}let t=e.replace("<%= appId %>",s(a)).replace("<%= name %>",s(o));t!==e&&await r.writeFile(c,t,"utf8")}}let l=new Set(["node_modules","dist",".git"]);async function p(t,a,o={}){let{includeAI:i=!0}=o,n=async(t,a)=>{for(let o of(await r.mkdir(a,{recursive:!0}),await r.readdir(t,{withFileTypes:!0}))){let s=e.join(t,o.name),c=e.join(a,o.name);if(o.isDirectory()){if(l.has(o.name)||".ai"===o.name&&!i)continue;await n(s,c)}else{if("AGENTS.md"===o.name&&!i)continue;await r.copyFile(s,c)}}};await n(t,a)}let d=new Set([".js",".cjs",".mjs",".ts",".tsx",".jsx",".json",".md",".txt",".scss",".css",".less",".html",".yml",".yaml"]),u=[["@byted-doubao-apps/framework","@doubao-apps/framework"],["@byted-doubao-apps/kit","@doubao-apps/kit"],["@byted-doubao-apps/ai","@doubao-apps/ai"],["@byted-doubao-apps/create","@doubao-apps/create"],["@byted-doubao-apps/taro-runtime","@doubao-apps/taro-runtime"]],f=["doubao.config.ts"],m=["@byted-doubao-apps/deploy","@doubao-apps/deploy"],y=["deploy"],w=["pnpm run deploy","doubao.config.ts","部署到豆包平台"];function h(e){let t=e;for(let[e,r]of u)t=t.replace(RegExp(e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),"g"),r);return t}async function j(t,a){for(let i of(await r.readdir(t,{withFileTypes:!0}))){var o;let n=e.join(t,i.name);if(function(e){return f.some(t=>t===e)}(i.name)){await r.rm(n,{recursive:!0,force:!0});continue}if(i.isDirectory()){await j(n,a);continue}if(o=i.name,!d.has(e.extname(o))&&"package.json"!==o&&"tsconfig.json"!==o)continue;let s=await r.readFile(n,"utf-8");await r.writeFile(n,function(e,t,r){if("package.json"===e){let e=JSON.parse(h(t));if(e.scripts&&"object"==typeof e.scripts){for(let t of y)delete e.scripts[t];0===Object.keys(e.scripts).length&&delete e.scripts}for(let t of["dependencies","devDependencies","peerDependencies"])if(e[t]&&"object"==typeof e[t]){for(let a of Object.keys(e[t]))m.some(e=>e===a)?delete e[t][a]:a.startsWith("@doubao-apps/")&&(e[t][a]=`^${r}`);0===Object.keys(e[t]).length&&delete e[t]}return`${JSON.stringify(e,null,2)}
+`}return"README.md"===e||"AGENTS.md"===e?h(t).split("\n").filter(e=>!w.some(t=>e.includes(t))).join("\n"):h(t)}(i.name,s,a))}}function b(e){return e?/[<>:"|?*\x00-\x1F]/.test(e)?{valid:!1,error:"Project name contains invalid characters"}:[".",".."].includes(e)?{valid:!1,error:"Project name is reserved"}:{valid:!0}:{valid:!1,error:"Project name is required"}}function g(e){return e.trim().toLowerCase().replace(/\s+/g,"-").replace(/^[._]/,"").replace(/[^a-z0-9-~._]+/g,"-")}async function E(r,a){let o=e.join(r,"package.json");if(!t.existsSync(o))throw Error("package.json not found in template");let i=JSON.parse(t.readFileSync(o,"utf-8"));i.name=a,t.writeFileSync(o,`${JSON.stringify(i,null,2)}
+`)}let N=["starter","empty"],v=[{value:"starter",label:"Starter (default)",hint:"Starter template with example pages"},{value:"empty",label:"Empty",hint:"Minimal template without example pages"}];function S(e){return N.includes(e)}let $=o(import.meta.url),T=e.dirname($),O={".gitignore":["dist","node_modules",".DS_Store"]};async function k(t){for(let[a,o]of Object.entries(O))await r.writeFile(e.join(t,a),`${o.join("\n")}
+`)}async function F(){let t=e.resolve(T,"..","package.json");return JSON.parse(await r.readFile(t,"utf-8")).version??"0.0.1"}async function x(t){let o=e.join(t,".git");if(!await r.stat(o).then(e=>e.isDirectory()).catch(e=>{if(e?.code==="ENOENT")return!1;throw e}))try{a("git",["init"],{cwd:t,stdio:"ignore"})}catch(e){if(e?.code==="ENOENT")return;throw Error(`Failed to initialize git repository: ${t}`,{cause:e})}}async function P({template:t,projectDir:a,public:o=!0,includeAI:i,appId:n,name:s,packageName:l,overwrite:d}){if(!e.isAbsolute(a))throw Error(`Project directory must be an absolute path: ${a}`);if(!S(t))throw Error(`Invalid template: ${t}. Valid options: ${N.join(", ")}`);let u=e.resolve(T,`template-${t}`);try{if(!(await r.stat(u)).isDirectory())throw Error(`Template path is not a directory: ${u}`)}catch(e){if(e?.code==="ENOENT")throw Error(`Template directory not found: ${u}`,{cause:e});throw Error(`Unable to access template directory: ${u}`,{cause:e})}if(await r.stat(a).then(e=>{if(!e.isDirectory())throw Error(`Project path is not a directory: ${a}`);return!0}).catch(e=>{if(e?.code==="ENOENT")return!1;throw Error(`Unable to access project directory: ${a}`,{cause:e})})){if((await r.readdir(a)).length>0&&!d)throw Error(`Project directory is not empty: ${a}`)}else await r.mkdir(a,{recursive:!0});await p(u,a,{includeAI:i}),o&&await j(a,await F()),await k(a),await x(a);let f=l??g(e.basename(a));await E(a,f),await c(a,n??`com.doubao.${f}`,s??"")}export{N as TEMPLATES,v as TEMPLATE_CHOICES,P as create,g as formatProjectName,S as isValidTemplate,t as node_fs,e as node_path,b as validateProjectName};
 //# sourceMappingURL=36.js.map

package/dist/template-empty/.ai/examples/common-patterns.md

@@ -388,62 +388,73 @@ function UserProfile({ userId }) {
 ### 1. 打开新页面
 
 ```tsx
-import { close, openPage, openPopup } from '@doubao-apps/framework/api';
+import { navigateTo, redirectTo, reLaunch } from '@doubao-apps/framework/api';
 
-// 打开全屏页面
+// 保留当前页面，打开详情页
 function openFullPage() {
-  openPage({
-    pageId: 'user-profile',
-    pageData: JSON.stringify({ userId: '12345' }),
-    context: {},
-    pageSettings: {
-      title: '用户资料'
-    }
+  navigateTo({
+    url: 'user-profile?userId=12345'
   });
 }
 
-// 打开弹窗页面
-function openSettingsPopup() {
-  openPopup({
-    pageId: 'settings',
-    context: {},
-    pageSettings: {
-      title: '设置',
-      heightPercent: 60 // 高度百分比，范围 (0, 100]
-    }
+// 替换当前页面
+function openSettingsPage() {
+  redirectTo({
+    url: 'settings'
+  });
+}
+
+// 清空页面栈并回到首页
+function relaunchHome() {
+  reLaunch({
+    url: 'home'
   });
 }
 ```
 
+这里的 `url` 直接使用目标页面的 `pageId`，与页面的 `aiMeta.id` 一致；如需传参，可继续拼接 query string。
+
 ### 2. 页面间传参
 
 ```tsx
+import { navigateTo } from '@doubao-apps/framework/api';
+
+function buildPageUrl(pageId: string, params: Record<string, string | number | boolean>) {
+  const query = Object.entries(params)
+    .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)
+    .join('&');
+
+  return query ? `${pageId}?${query}` : pageId;
+}
+
 // 发送方
 function navigateWithParams() {
-  openPage({
-    pageId: 'detail-page',
-    pageData: JSON.stringify({
+  navigateTo({
+    url: buildPageUrl('detail-page', {
       id: '123',
       name: '商品名称',
       price: 99.99
-    }),
-    context: {}
+    })
   });
 }
 
 // 接收方 (detail-page)
 import { getViewData } from '@doubao-apps/framework';
 
+interface DetailPageInput {
+  id: string;
+  name: string;
+  price: number;
+}
+
 export default definePage({
   aiMeta: {
     id: 'detail-page',
     title: '详情页'
   },
   render() {
-    // 使用 getViewData 获取传递的参数
-    const viewData = getViewData();
-    const params = JSON.parse(viewData.pageData || '{}');
-    const { id, name, price } = params;
+    // getViewData() 直接返回传入页面的最终对象
+    const { id, name, price } = getViewData<DetailPageInput>();
 
     return (
       <view>
@@ -456,24 +467,29 @@ export default definePage({
 });
 ```
 
-### 3. 关闭页面
+### 3. 返回上一页
 
 ```tsx
-import { close } from '@doubao-apps/framework/api';
+import { navigateBack } from '@doubao-apps/framework/api';
 
 function closeCurrentPage() {
-  close(); // 关闭当前页面
+  navigateBack();
 }
 ```
 
 ### 4. 页面栈管理
 
 ```tsx
-import { close } from '@doubao-apps/framework/api';
+import { navigateBack } from '@doubao-apps/framework/api';
 
 // 场景 1: 返回上一页
 function goBack() {
-  close();
+  navigateBack();
+}
+
+// 场景 2: 返回多级页面
+function goBackTwoPages() {
+  navigateBack({ delta: 2 });
 }
 ```
 
@@ -509,13 +525,12 @@ export default definePage({
 ### 6. 九宫格页面导航
 
 ```tsx
+import { navigateTo } from '@doubao-apps/framework/api';
+
 // 打开九宫格页面
 function openGridPage() {
-  openPage({
-    pageId: 'app-grid',
-    pageSettings: {
-      title: '应用中心'
-    }
+  navigateTo({
+    url: 'app-grid'
   });
 }
 
@@ -538,12 +553,7 @@ export default definePage({
           <view
             key={app.id}
             className="grid-item"
-            onClick={() =>
-              openPage({
-                pageId: app.id,
-                context: {}
-              })
-            }
+            onClick={() => navigateTo({ url: app.id })}
           >
             <text className="icon">{app.icon}</text>
             <text className="name">{app.name}</text>

package/dist/template-empty/.ai/examples/component-basics.md

@@ -358,23 +358,6 @@ function WeatherCard({ city }: WeatherWidgetInput) {
 }
 
 export default defineWidget({
-  aiMeta: {
-    id: 'weather-card',
-    name: '天气卡片',
-    description: '显示指定城市的天气信息',
-    boxType: 'inbox',
-    input: {
-      type: 'object',
-      properties: {
-        city: {
-          type: 'string',
-          title: '城市名称',
-          description: '要查询天气的城市'
-        }
-      },
-      required: ['city']
-    }
-  },
   onMounted() {
     console.log('卡片挂载');
   },

package/dist/template-empty/.ai/guides/component-development.md

@@ -124,45 +124,31 @@ export default definePage({
 });
 ```
 
-### 页面打开方式
+### 页面导航
 
 ```tsx
-import { openPage } from '@doubao-apps/framework/api';
-
-// 全屏页面
-openPage({
-  pageId: 'my-page',
-  mode: 'full', // 或省略此参数，默认为 'full'
-  pageData: JSON.stringify({ userId: '123' }),
-  context: {},
-  pageSettings: {
-    title: '页面标题'
-  }
+import { navigateTo, redirectTo, reLaunch } from '@doubao-apps/framework/api';
+
+// 保留当前页面，打开新页面
+navigateTo({
+  url: 'user-detail?userId=123&tab=profile'
 });
 
-// 弹窗页面
-openPage({
-  pageId: 'settings',
-  mode: 'popup',
-  context: {},
-  pageSettings: {
-    title: '设置',
-    heightPercent: 60 // 高度百分比
-  }
+// 替换当前页面
+redirectTo({
+  url: 'settings'
 });
 
-// 悬浮窗
-openPage({
-  pageId: 'mini-player',
-  mode: 'floating',
-  context: {},
-  pageSettings: {
-    width: 300,
-    height: 200
-  }
+// 关闭所有页面并回到首页
+reLaunch({
+  url: 'home'
 });
 ```
 
+`url` 在常规页面跳转里填写页面的 `pageId`，与该页面的 `aiMeta.id` 一致；需要传参时可直接在后面拼接 query string。
+
+页面内可继续通过 `getViewData<PageInput>()` 读取 URL 中传入的参数。
+
 ### 常用模式
 
 **1. 数据加载**
@@ -207,7 +193,7 @@ function MyPage({ userId }: { userId: string }) {
 
 ```tsx
 import { useState } from '@doubao-apps/framework';
-import { close, request, showToast } from '@doubao-apps/framework/api';
+import { navigateBack, request, showToast } from '@doubao-apps/framework/api';
 
 function FormPage() {
   const [formData, setFormData] = useState({
@@ -225,7 +211,7 @@ function FormPage() {
         data: formData
       });
       showToast({ message: '提交成功' });
-      close(); // 关闭页面
+      navigateBack(); // 返回上一页
     } catch (err) {
       showToast({ message: '提交失败' });
     } finally {
@@ -257,40 +243,38 @@ function FormPage() {
 
 ## 🎴 Widget 开发指南
 
+### Metadata 配置
+
+```ts
+import { defineAppConfig } from '@doubao-apps/kit';
+
+export default defineAppConfig({
+  widgets: {
+    'widgets/my-widget': {
+      id: 'my-widget',                 // 卡片唯一标识
+      name: '我的卡片',                 // 卡片名称
+      description: '卡片功能描述',       // 卡片描述
+      boxType: 'inbox',                // 卡片类型: inbox | full_box
+      border: true,
+      keywords: ['demo', 'widget'],
+      titleType: 'normal'
+    }
+  }
+});
+```
+
 ### 基本结构
 
 ```tsx
-import { defineWidget, getViewData, useState, useEffect } from '@doubao-apps/framework';
+import { defineWidget, getViewData } from '@doubao-apps/framework';
 import './index.scss';
 
-export default defineWidget({
-  // 1. AI 元数据配置
-  aiMeta: {
-    id: 'my-widget',                  // 卡片唯一标识
-    name: '我的卡片',                  // 卡片名称
-    description: '卡片功能描述',        // 卡片描述
-    boxType: 'inbox',                 // 卡片类型: inbox | full_box
-
-    // 2. 输入数据 Schema（JSON Schema 格式）
-    input: {
-      type: 'object',
-      properties: {
-        title: {
-          type: 'string',
-          title: '标题',
-          description: '卡片标题文本'
-        },
-        content: {
-          type: 'string',
-          title: '内容',
-          description: '卡片内容文本'
-        }
-      },
-      required: ['title']              // 必填字段
-    }
-  },
+interface MyWidgetData {
+  title: string;
+  content?: string;
+}
 
-  // 3. 生命周期钩子
+export default defineWidget({
   onShow() {
     console.log('卡片显示');
   },
@@ -316,10 +300,8 @@ export default defineWidget({
     console.log('卡片销毁');
   },
 
-  // 4. 渲染函数
   render() {
-    const input = getViewData();
-
+    const input = getViewData<MyWidgetData>();
     return <MyWidgetComponent {...input} />;
   }
 });
@@ -336,23 +318,26 @@ export default defineWidget({
 - 不需要占用整行宽度，希望保持对话流的紧凑阅读体验
 - 交互以按钮、简单表单项为主
 
+```ts
+// src/app.config.ts
+import { defineAppConfig } from '@doubao-apps/kit';
+
+export default defineAppConfig({
+  widgets: {
+    'widgets/info-card': {
+      id: 'info-card',
+      name: '信息卡片',
+      boxType: 'inbox'
+    }
+  }
+});
+```
+
 ```tsx
 export default defineWidget({
-  aiMeta: {
-    id: 'info-card',
-    name: '信息卡片',
-    boxType: 'inbox',
-    input: {
-      type: 'object',
-      properties: {
-        title: { type: 'string', title: '标题' },
-        content: { type: 'string', title: '内容' }
-      }
-    }
-  },
   render() {
     const input = getViewData<{ title: string; content: string }>();
-    
+
     return (
       <view className="info-card">
         <text className="title">{input.title}</text>
@@ -367,20 +352,23 @@ export default defineWidget({
 
 适用于需要更大展示空间的卡片（例如图表、图片墙、复杂表单等）。
 
+```ts
+// src/app.config.ts
+import { defineAppConfig } from '@doubao-apps/kit';
+
+export default defineAppConfig({
+  widgets: {
+    'widgets/user-action-card': {
+      id: 'user-action-card',
+      name: '全宽卡片示例',
+      boxType: 'full_box'
+    }
+  }
+});
+```
+
 ```tsx
 export default defineWidget({
-  aiMeta: {
-    id: 'user-action-card',
-    name: '全宽卡片示例',
-    boxType: 'full_box',
-    input: {
-      type: 'object',
-      properties: {
-        action: { type: 'string', title: '操作' },
-        result: { type: 'string', title: '结果' }
-      }
-    }
-  },
   render() {
     const input = getViewData<{ action: string; result: string }>();
     return (
@@ -393,127 +381,26 @@ export default defineWidget({
 });
 ```
 
-### Input Schema 定义
+### 输入数据类型
 
-**基础类型**
+Widget 输入数据通过 `getViewData<T>()` 的泛型参数和 TypeScript 接口表达。
 
 ```tsx
-// 字符串
-{
-  type: 'string',
-  title: '标题',
-  description: '字段描述',
-  default: '默认值',
-  minLength: 1,
-  maxLength: 100
-}
-
-// 数字
-{
-  type: 'number',
-  title: '数量',
-  minimum: 0,
-  maximum: 100,
-  default: 1
-}
-
-// 布尔值
-{
-  type: 'boolean',
-  title: '是否启用',
-  default: false
-}
-
-// 枚举
-{
-  type: 'string',
-  enum: ['option1', 'option2', 'option3'],
-  title: '选项'
-}
-
-// 数组
-{
-  type: 'array',
-  items: {
-    type: 'string'
-  },
-  title: '标签列表',
-  minItems: 1,
-  maxItems: 5
-}
-
-// 对象
-{
-  type: 'object',
-  properties: {
-    name: { type: 'string', title: '名称' },
-    age: { type: 'number', title: '年龄' }
-  },
-  required: ['name']
+interface ProductCardData {
+  name: string;
+  price: number;
+  images?: string[];
+  category: '电子' | '服装' | '食品' | '图书';
+  inStock: boolean;
+  specs?: {
+    color?: string;
+    size?: string;
+  };
 }
-```
-
-**复杂 Schema 示例**
 
-```tsx
 export default defineWidget({
-  aiMeta: {
-    id: 'product-card',
-    name: '商品卡片',
-    boxType: 'inbox',
-    input: {
-      type: 'object',
-      properties: {
-        name: {
-          type: 'string',
-          title: '商品名称',
-          description: '商品的显示名称'
-        },
-        price: {
-          type: 'number',
-          title: '价格',
-          minimum: 0,
-          description: '商品价格（元）'
-        },
-        images: {
-          type: 'array',
-          items: { type: 'string' },
-          title: '商品图片',
-          description: '商品图片 URL 列表',
-          minItems: 1,
-          maxItems: 5
-        },
-        category: {
-          type: 'string',
-          enum: ['电子', '服装', '食品', '图书'],
-          title: '分类'
-        },
-        inStock: {
-          type: 'boolean',
-          title: '是否有货',
-          default: true
-        },
-        specs: {
-          type: 'object',
-          properties: {
-            color: { type: 'string', title: '颜色' },
-            size: { type: 'string', title: '尺寸' }
-          },
-          title: '规格'
-        }
-      },
-      required: ['name', 'price']
-    }
-  },
   render() {
-    const input = getViewData<{
-      name: string;
-      price: number;
-      images?: string[];
-      category: string;
-      inStock: boolean;
-      specs?: { color?: string; size?: string };
-    }>();
+    const input = getViewData<ProductCardData>();
     return (
       <view className="product-card">
         <text className="name">{input.name}</text>
@@ -579,16 +466,17 @@ function WeatherWidget({ city }: { city: string }) {
 **2. 用户交互**
 
 ```tsx
+import { sendQueryMessage } from '@doubao-apps/framework/api';
+
 function InteractiveWidget({ initialCount }: { initialCount: number }) {
   const [count, setCount] = useState(initialCount);
 
   const handleIncrement = () => {
     setCount(count + 1);
-    // 可以发送消息到 Bot
+    // 发送一条用户消息到当前会话
     sendQueryMessage({
       content: `计数增加到 ${count + 1}`,
-      type: 'text',
-      context: {}
+      type: 'text'
     });
   };
 
@@ -604,18 +492,12 @@ function InteractiveWidget({ initialCount }: { initialCount: number }) {
 **3. 打开页面**
 
 ```tsx
-import { openPage } from '@doubao-apps/framework/api';
+import { navigateTo } from '@doubao-apps/framework/api';
 
 function ActionWidget({ itemId }: { itemId: string }) {
   const handleViewDetail = () => {
-    openPage({
-      pageId: 'item-detail',
-      mode: 'full', // 全屏页面，可省略（默认）
-      pageData: JSON.stringify({ id: itemId }),
-      context: {},
-      pageSettings: {
-        title: '详情'
-      }
+    navigateTo({
+      url: `item-detail?id=${itemId}`
     });
   };