@doubao-apps/ai 0.0.20 → 0.0.21

package/dist/skills/uniapp-to-doubao/references/source-framework/api-reference.md

@@ -0,0 +1,367 @@
+# uni-app 2.0.0 API / 配置参考
+
+> 本文档为迁移参考，仅覆盖 `uni-app 2.0.0` 系列的常用能力。
+> 事实优先来源为官方历史版本归档与当前仍可访问的官方文档入口，已于 `2026-04-09` 校验。
+
+## 官方文档入口
+
+- 历史版本归档（含 `2.0.0` 系列历史构建）: `https://uniapp.dcloud.net.cn/release-archive.html`
+- 页面与生命周期: `https://uniapp.dcloud.io/tutorial/page.html`
+- `pages.json`: `https://uniapp.dcloud.io/collocation/pages.html`
+- 网络请求 / `uni.request`: `https://uniapp.dcloud.io/api/request/request.html`
+- 条件编译: `https://uniapp.dcloud.io/tutorial/platform`
+- 组件总览入口: `https://uniapp.dcloud.io/component/`
+
+**版本说明**：
+
+- 以上官方文档入口当前仍在更新，因此只能作为语法与配置入口使用。
+- 只要当前文档中涉及 `2.0.0` 系列之后新增的能力，一律不纳入本 skill 的源端能力集合。
+- `2.0.0` 系列历史发布记录可用于确认该大版本阶段的能力边界，例如 `2.0.0.20190610` 提到了 `subNVue`、自定义组件模式、`uni.$on/$once/$off/$emit`、`editor` 组件、`navigationbarshadow` 等。
+
+---
+
+## 工程结构
+
+典型 uni-app `2.0.0` 工程：
+
+```text
+src/
+├── main.js
+├── App.vue
+├── pages.json
+├── manifest.json
+├── pages/
+│   └── index/index.vue
+└── components/
+    └── card.vue
+```
+
+### `main.js`
+
+用于挂载 Vue 应用和全局插件：
+
+```js
+import Vue from 'vue';
+import App from './App';
+
+Vue.config.productionTip = false;
+App.mpType = 'app';
+
+const app = new Vue({
+  ...App
+});
+
+app.$mount();
+```
+
+**迁移**：入口逻辑重写到 `src/app.ts`，不要保留 Vue 实例化。
+
+### `App.vue`
+
+常见承载全局生命周期：
+
+```vue
+<script>
+export default {
+  onLaunch() {},
+  onShow() {},
+  onHide() {}
+}
+</script>
+```
+
+**迁移**：应用级逻辑转 `defineApp({ onLaunch, onForeground, onBackground, onDestroy, onError })`。
+
+### `pages.json`
+
+负责页面注册、首页、导航栏、下拉刷新、tabBar 等：
+
+```json
+{
+  "pages": [
+    {
+      "path": "pages/index/index",
+      "style": {
+        "navigationBarTitleText": "首页"
+      }
+    }
+  ],
+  "globalStyle": {},
+  "tabBar": {}
+}
+```
+
+**迁移**：目标工程需按页面与宿主能力重建，不能直接复制。
+
+---
+
+## 页面定义
+
+uni-app `2.0.0` 页面本质上是 Vue2 单文件组件，并额外支持页面生命周期：
+
+```vue
+<script>
+export default {
+  data() {
+    return {
+      list: [],
+      loading: false
+    };
+  },
+  onLoad(options) {},
+  onShow() {},
+  onReady() {},
+  onHide() {},
+  onUnload() {},
+  methods: {
+    loadList() {}
+  }
+}
+</script>
+```
+
+**迁移**：
+
+- 页面输出为 `definePage({ ... render() { ... } })`
+- 页面 UI 本体转为 React 函数组件
+- 初始化请求通常落到 `onMounted` 或组件内 `useEffect`
+- 页面输入优先通过 `getViewData()` / `getViewContext()` 获取
+
+---
+
+## Vue2 Options API
+
+### `data`
+
+```js
+data() {
+  return {
+    count: 0,
+    list: []
+  };
+}
+```
+
+**迁移**：→ `useState`
+
+### `props`
+
+```js
+export default {
+  props: {
+    title: String,
+    active: Boolean
+  }
+}
+```
+
+**迁移**：→ `FC<Props>`
+
+### `computed`
+
+```js
+computed: {
+  doubled() {
+    return this.count * 2;
+  }
+}
+```
+
+**迁移**：→ `useMemo`
+
+### `watch`
+
+```js
+watch: {
+  keyword(val) {
+    this.search(val);
+  }
+}
+```
+
+**迁移**：→ `useEffect`
+
+### `methods`
+
+```js
+methods: {
+  handleTap(item) {},
+  fetchList() {}
+}
+```
+
+**迁移**：→ 组件内普通函数
+
+---
+
+## 页面生命周期
+
+根据官方页面文档与 uni-app 传统用法，常见页面生命周期包括：
+
+- `onLoad(options)`
+- `onShow()`
+- `onReady()`
+- `onHide()`
+- `onUnload()`
+- `onPullDownRefresh()`
+- `onReachBottom()`
+- `onPageScroll(e)`
+- `onShareAppMessage()`
+
+**迁移判断**：
+
+- `onShow / onHide / onUnload` 可映射到目标页面生命周期
+- `onLoad(options)` 不要假设目标框架存在同名钩子；页面输入优先改为 `getViewData()`
+- `onReady()` 通常转为 `onMounted` 或组件 `useEffect`
+- `onPullDownRefresh / onReachBottom / onPageScroll` 需要结合页面容器和目标宿主能力重写
+
+---
+
+## 应用生命周期
+
+`App.vue` 常见生命周期：
+
+- `onLaunch()`
+- `onShow()`
+- `onHide()`
+- `onError(err)`
+- `onPageNotFound(res)`（部分项目会用）
+
+**迁移判断**：
+
+- `onLaunch()` → `defineApp.onLaunch`
+- `onShow()` → `defineApp.onForeground`
+- `onHide()` → `defineApp.onBackground`
+- `onError()` → `defineApp.onError`
+- 其他应用级钩子按目标框架真实 API 取舍，不做机械同名迁移
+
+---
+
+## 常用 `uni.*` API
+
+### `uni.request`
+
+```js
+uni.request({
+  url: 'https://api.example.com/list',
+  method: 'GET',
+  data: { page: 1 },
+  success(res) {
+    console.log(res.data);
+  }
+});
+```
+
+**迁移**：→ `request({ url, method, data })`，返回 Promise。
+
+### 路由
+
+```js
+uni.navigateTo({ url: '/pages/detail/index?id=1' });
+uni.redirectTo({ url: '/pages/home/index' });
+uni.navigateBack({ delta: 1 });
+uni.switchTab({ url: '/pages/tab/index' });
+uni.reLaunch({ url: '/pages/index/index' });
+```
+
+**迁移**：
+
+- `navigateTo / redirectTo / navigateBack / reLaunch` 可迁到目标公开路由 API
+- `switchTab` 不要假设目标侧存在同名公开 API；若源项目依赖 tabBar，需要在目标工程重建导航结构或记录能力缺口
+
+### UI 交互
+
+```js
+uni.showToast({ title: '成功', icon: 'success' });
+uni.showLoading({ title: '加载中' });
+uni.hideLoading();
+uni.showModal({ title: '提示', content: '确认删除？' });
+```
+
+**迁移**：
+
+- `uni.showToast({ title })` → `showToast({ message })`，参数名不同，不能机械复制
+- `showLoading / hideLoading / showModal` 当前不要假设目标公开 API 存在；优先改为页面内 loading 状态、`Dialog` / `Popup` 组件流，或记录能力缺口
+
+### 存储
+
+```js
+uni.setStorageSync('token', token);
+const token = uni.getStorageSync('token');
+uni.removeStorageSync('token');
+```
+
+**迁移**：
+
+- `setStorageSync('token', token)` → `setStorageSync({ key: 'token', data: token })`
+- `getStorageSync('token')` → `getStorageSync({ key: 'token' }).data`
+- `removeStorageSync('token')` → `removeStorageSync({ key: 'token' })`
+
+---
+
+## 页面通信
+
+`2.0.0` 系列发布记录中可确认已加入：
+
+- `uni.$on`
+- `uni.$once`
+- `uni.$off`
+- `uni.$emit`
+
+常见写法：
+
+```js
+onLoad() {
+  uni.$on('refresh', this.handleRefresh);
+},
+onUnload() {
+  uni.$off('refresh', this.handleRefresh);
+},
+methods: {
+  handleRefresh(payload) {}
+}
+```
+
+**迁移建议**：
+
+- 优先改成显式 props / 页面输入 / 本地状态提升
+- 必须跨页面广播时，再结合目标框架能力重写
+- 不要保留全局事件总线式写法而不做生命周期清理
+
+---
+
+## 条件编译
+
+uni-app 通过 `#ifdef` / `#ifndef` / `#endif` 处理多端差异：
+
+```js
+// #ifdef MP-WEIXIN
+wx.login({});
+// #endif
+```
+
+```vue
+<!-- #ifdef MP-WEIXIN -->
+<official-account></official-account>
+<!-- #endif -->
+```
+
+**迁移建议**：
+
+- 先统计所有条件编译块
+- 再判断哪些分支属于当前小程序版本的实际业务路径
+- 宿主原生 API 或原生组件单独记录，不做静默删除
+
+---
+
+## 版本边界提醒
+
+遇到以下能力时，默认视为 **超出 uni-app 2.0.0 范围**，必须谨慎：
+
+- Vue3 / Composition API
+- `<script setup>`
+- 新版条件编译变量
+- 后续新增平台和组件能力
+- 只在更高基础库或更高 HBuilderX 版本中出现的 API
+
+若源项目出现这些写法，应先标记“源项目已超出本 skill 版本假设”。

package/dist/skills/uniapp-to-doubao/references/source-framework/components.md

@@ -0,0 +1,245 @@
+# uni-app 2.0.0 组件 / 模板参考
+
+> 本文档聚焦 `uni-app 2.0.0` 系列常见模板语法和内置组件。
+> 用于迁移时识别 Vue2 SFC 模板语义，而不是罗列所有后续版本新增能力。
+
+## 官方文档入口
+
+- 组件总览入口: `https://uniapp.dcloud.io/component/`
+- 页面与模板用法: `https://uniapp.dcloud.io/tutorial/page.html`
+- 条件编译: `https://uniapp.dcloud.io/tutorial/platform`
+- `editor` 相关 API 入口: `https://uniapp.dcloud.io/api/media/editor-context.html`
+- `2.0.0` 系列发布记录（例如 `2.0.0.20190610`，可用来确认 `editor` 等能力）: `https://uniapp.dcloud.net.cn/release-archive.html`
+
+---
+
+## 模板语法
+
+uni-app `2.0.0` 使用 Vue2 单文件组件模板：
+
+```vue
+<template>
+  <view class="page">
+    <view v-if="loading">加载中</view>
+    <view v-else>
+      <view v-for="item in list" :key="item.id" @tap="handleTap(item)">
+        <text>{{ item.title }}</text>
+      </view>
+    </view>
+  </view>
+</template>
+```
+
+### 常见指令
+
+| uni-app 2.0.0 | 说明 |
+|--------------|------|
+| `{{ expr }}` | 文本插值 |
+| `v-if` / `v-else-if` / `v-else` | 条件渲染 |
+| `v-for="item in list"` | 列表渲染 |
+| `:prop="expr"` | 动态绑定 |
+| `@tap="handleTap"` / `@click="handleClick"` | 事件绑定 |
+| `v-model` | 双向绑定 |
+| `<template>` / `<block>` | 结构块 |
+
+**迁移提醒**：
+
+- 事件绑定是 Vue 模板语义，不是小程序字符串方法名
+- `v-model` 不能机械迁移，必须改成受控组件
+- `<template>` / `<block>` 迁移后通常变成 Fragment 或直接移除
+
+---
+
+## 基础容器
+
+### `view`
+
+```vue
+<view class="card">内容</view>
+```
+
+**迁移**：→ `<view className="card">...</view>`
+
+### `scroll-view`
+
+```vue
+<scroll-view scroll-y class="list" @scrolltolower="loadMore">
+  <view v-for="item in list" :key="item.id">{{ item.name }}</view>
+</scroll-view>
+```
+
+**迁移**：→ 保留 `<scroll-view>`，重写事件和滚动方向属性。
+
+### `swiper` / `swiper-item`
+
+```vue
+<swiper :autoplay="true" :indicator-dots="true">
+  <swiper-item v-for="item in banners" :key="item.id">
+    <image :src="item.image" mode="aspectFill" />
+  </swiper-item>
+</swiper>
+```
+
+**迁移**：→ 优先保留 `<swiper>` / `<swiper-item>` 小写标签。
+
+---
+
+## 文本与媒体
+
+### `text`
+
+```vue
+<text>{{ title }}</text>
+```
+
+**迁移**：→ `<text>{title}</text>`
+
+### `image`
+
+```vue
+<image :src="avatar" mode="aspectFill" />
+```
+
+**迁移**：→ `<image src={avatar} mode="aspectFill" />`
+
+### `video`
+
+普通播放型视频可迁移；平台强绑定的视频能力需单独评估。
+
+### `editor`
+
+`2.0.0` 系列发布记录中可确认 `editor` 富文本编辑器组件已进入该大版本范围。
+
+**迁移提醒**：
+
+- 若源项目确实使用 `editor`，先确认目标工程是否存在等价编辑器能力
+- 若没有，必须记录能力缺口，不要静默替换成普通 `textarea`
+
+---
+
+## 表单组件
+
+### `button`
+
+```vue
+<button type="primary" @tap="handleSubmit">提交</button>
+```
+
+**迁移**：→ 保留 `<button>`，事件改写为目标框架事件。
+
+### `input`
+
+```vue
+<input v-model="keyword" placeholder="请输入关键词" />
+```
+
+**迁移**：→ 改成受控写法：
+
+```tsx
+<input
+  value={keyword}
+  onInput={(e) => setKeyword(e.detail.value)}
+  placeholder="请输入关键词"
+/>
+```
+
+### `textarea`
+
+同 `input`，改为受控多行输入。
+
+### `picker`
+
+uni-app 的 `picker` 常被用作弹出选择器。
+
+**迁移提醒**：
+
+- `mode="selector"`：通常可用 `<popup>` + 单列 `<picker-view>` / `<picker-column>` 重写
+- `mode="multiSelector"`：可用多列 `<picker-column>` 重建
+- `mode="time"` / `mode="date"` / `mode="region"`：先确认目标宿主是否存在等价能力；没有时记录缺口或按业务重新设计，不要静默降级成普通单列选择器
+
+---
+
+## 导航相关
+
+### `navigator`
+
+```vue
+<navigator :url="`/pages/detail/index?id=${item.id}`">
+  <view class="link">查看详情</view>
+</navigator>
+```
+
+**迁移**：→ 改为显式路由 API，不保留 `<navigator>`。
+
+---
+
+## 模板中的列表和条件
+
+### `v-for`
+
+```vue
+<view v-for="(item, index) in list" :key="item.id">
+  <text>{{ index + 1 }}. {{ item.title }}</text>
+</view>
+```
+
+**迁移**：→ `list.map((item, index) => ...)`
+
+### `v-if`
+
+```vue
+<view v-if="loading">加载中</view>
+<view v-else>内容</view>
+```
+
+**迁移**：→ 条件表达式或三元表达式。
+
+---
+
+## 样式组织
+
+uni-app `2.0.0` 常见写法：
+
+```vue
+<style scoped lang="scss">
+.page {
+  padding: 24rpx;
+}
+</style>
+```
+
+**迁移建议**：
+
+- 样式拆到同目录 `index.scss`
+- `class` → `className`
+- `scoped` 语义通过局部 class 组织保持，不依赖自动加 scope attribute
+
+---
+
+## 条件编译中的组件
+
+uni-app 模板可在组件层面使用条件编译：
+
+```vue
+<!-- #ifdef MP-WEIXIN -->
+<official-account></official-account>
+<!-- #endif -->
+```
+
+**迁移提醒**：
+
+- 这是宿主平台组件，不是普通 `view`
+- Doubao 侧若无等价能力，应记录缺口
+
+---
+
+## 版本边界提醒
+
+以下写法若出现在源项目中，需要先怀疑不是 `2.0.0` 的标准能力：
+
+- Vue3 slot / setup 语法
+- 组合式 API 组件示例
+- 后续新增组件或属性
+- 只在更高 HBuilderX 版本中标注支持的能力
+
+优先按 `2.0.0` 系列发布记录和本 skill 的保守口径处理。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doubao-apps/ai",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "description": "Doubao Apps SDK AI tools with context and skills management",
   "type": "module",
   "bin": {