@doubao-apps/create 0.0.25 → 0.0.27

package/dist/template-empty/.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-empty/.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;
 }
 ```