@doubao-apps/ai 0.0.35-rc.0 → 0.0.35

package/dist/public/skills/doubao-components-api/references/reference/media.md

@@ -0,0 +1,195 @@
+# 文本与媒体组件
+
+## `<text>`
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| className | string | - | 样式类名 |
+| style | CSSProperties | - | 内联样式 |
+| textMaxline | string | - | 最大行数，超出省略号 |
+| tailColorConvert | boolean | false | 省略号颜色跟随外层 text 样式 |
+| textSingleLineVerticalAlign | `'normal' \| 'bottom' \| 'center' \| 'top'` | `'normal'` | 单行垂直对齐，inline 文本不支持 |
+| textSelection | boolean | false | 是否可选择文本 |
+| customContextMenu | boolean | false | 开启文本选择后使用自定义菜单 |
+| onClick | (e: TouchEvent) => void | - | 点击 |
+| onLayout | (e: LayoutEvent) => void | - | 布局完成 |
+| onSelectionChange | (e: SelectionChangeEvent) => void | - | 文本选区变化（需开启 textSelection） |
+
+```tsx
+<text textMaxline="2">超出两行显示省略号的长文本...</text>
+<text textSelection>可以被用户选择复制的文本</text>
+```
+
+---
+
+## `<image>`
+
+**必须设置非空 src，且满足以下任意一条，否则图片不显示：**
+- 设置 width + height > 0
+- 设置 `autoSize`
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| src | string | - | **必填**，图片地址（http/https/base64） |
+| mode | `'scaleToFill' \| 'aspectFit' \| 'aspectFill' \| 'center'` | `'scaleToFill'` | 缩放模式 |
+| placeholder | string | - | 占位图，用法同 src |
+| autoSize | boolean | false | 加载成功后自动调整为原图尺寸 |
+| flatten | boolean | true | false 时走 Lynx 自定义解码链路，可缓解 Android 大图降采样 |
+| subsample | boolean | true | 是否启用降采样，仅在 `flatten=false` 时可设为 false |
+| onLoad | (e: LoadEvent) => void | - | 加载成功，事件包含宽高 |
+| onError | (e: ErrorEvent) => void | - | 加载失败 |
+| onClick | (e: TouchEvent) => void | - | 点击 |
+
+**mode 说明：**
+
+| 值 | 说明 |
+|----|------|
+| scaleToFill | 拉伸填满，不保持比例 |
+| aspectFit | 保持比例，长边完全显示 |
+| aspectFill | 保持比例，短边完全显示（常用于头像/封面） |
+| center | 不缩放，只显示中间区域 |
+
+**Android 大图说明：** `flatten={false}` 走 Lynx 解码链路，可缓解 Fresco 默认纹理限制导致的超大图片降采样。`subsample={false}` 关闭降采样，超大图存在 OOM 风险，谨慎使用。
+
+```tsx
+<image
+  src="https://example.com/photo.jpg"
+  mode="aspectFill"
+  style={{ width: '200px', height: '200px', borderRadius: '50%' }}
+  onLoad={(e) => console.log('尺寸:', e.detail.width, e.detail.height)}
+/>
+```
+
+---
+
+## `<svg>`
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| className | string | 样式类名 |
+| style | CSSProperties | 内联样式 |
+
+SVG 内容作为子节点传入，使用标准 SVG 元素。
+
+---
+
+## `<video>`
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| ref | ForwardedRef\<VideoRef\> | - | 实例 ref，可调用播放控制方法 |
+| playUrl | string | - | 播放地址 |
+| poster | string | - | 海报图 |
+| autoPlay | boolean | false | 资源就绪后自动播放 |
+| mute | boolean | true | 静音 |
+| loop | boolean | false | 循环 |
+| objectfit | `'aspectFit' \| 'aspectFill' \| 'scaleToFill'` | `'aspectFit'` | 缩放模式 |
+| style | CSSProperties | - | 设置宽高和圆角 |
+
+### VideoRef 方法
+
+| 方法 | 说明 |
+|------|------|
+| play(callback?) | 播放 |
+| pause(callback?) | 暂停 |
+| stop(callback?) | 停止 |
+| seek(position, play, callback?) | 跳转到指定时间 |
+| replay(play, callback?) | 重新播放 |
+
+```tsx
+import type { VideoRef } from '@doubao-apps/framework/components';
+import { useRef } from '@doubao-apps/framework';
+
+const videoRef = useRef<VideoRef>(null);
+
+<video
+  ref={videoRef}
+  playUrl="https://example.com/video.mp4"
+  poster="https://example.com/poster.jpg"
+  objectfit="aspectFill"
+  style={{ width: '100%', height: '220px', borderRadius: '12px' }}
+/>
+<button onClick={() => videoRef.current?.play()}>播放</button>
+<button onClick={() => videoRef.current?.pause()}>暂停</button>
+```
+
+---
+
+## `<long-image>`
+
+长图分段解码，提供两种用法。
+
+### 简单用法（内置滚动容器）
+
+```tsx
+<long-image
+  src="https://example.com/long.jpg"
+  style={{ height: '70vh' }}
+  onStateChange={(state) => {
+    // state: 'measuring' | 'loading-meta' | 'ready' | 'error'
+    console.log(state);
+  }}
+/>
+```
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| src | string | - | **必填** |
+| id | string | 自动生成 | 根节点 id |
+| reloadToken | number | 0 | 变化时重新初始化 |
+| segmentDisplayHeight | number | 600 | 单段目标高度 (px) |
+| decodeOverscanScreens | number | 1 | 预加载屏数 |
+| maxActiveSegments | number | 8 | 同时激活解码上限 |
+| placeholderColor | string | 'transparent' | 非激活段占位背景色 |
+| style | CSSProperties | - | 未设 height 时默认 100vh |
+| onStateChange | (state: LongImageState) => void | - | 状态回调 |
+| onMetricsChange | (metrics: LongImageMetrics) => void | - | 指标回调 |
+
+### Hook 用法（接入外部滚动容器）
+
+```tsx
+import { useLongImage, renderLongImageSegments } from '@doubao-apps/framework/components';
+
+const longImageResult = useLongImage({ src });
+
+<view id={longImageResult.containerId} style={{ height: '70vh' }} onLayoutChange={longImageResult.handleContainerLayoutChange}>
+  <list style={{ width: '100%', height: '100%' }} onScroll={longImageResult.handleScroll}>
+    {renderLongImageSegments(longImageResult, { mode: 'list' })}
+  </list>
+</view>
+```
+
+**⚠️ 长图前有 header 时必须修正 scrollTop：**
+
+```tsx
+const HEADER_HEIGHT = 120;
+const handlePageScroll = (event) => {
+  longImageResult.handleScroll({
+    ...event,
+    detail: { ...event.detail, scrollTop: Math.max(0, event.detail.scrollTop - HEADER_HEIGHT) }
+  });
+};
+```
+
+`handleScroll` 期望接收的 scrollTop 语义是"可视区域顶部相对于长图内容顶部的偏移"，如果长图前有其他内容，外层 scrollTop 需减去该内容高度。
+
+---
+
+## `<web-view>`
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| src | string | 网页地址 |
+| onLoad | () => void | 加载成功 |
+| onError | (e: { errorMsg: string; errorCode: number }) => void | 加载失败 |
+| onMessage | (e: { msg: string }) => void | 网页 postMessage |
+| className | string | 样式类名 |
+| style | CSSProperties | 内联样式 |
+
+```tsx
+<web-view
+  src="https://example.com"
+  style={{ width: '100%', height: '100vh' }}
+  onMessage={(e) => console.log('收到消息:', e.msg)}
+/>
+```

package/dist/{skills → public/skills}/douyin-to-doubao/SKILL.md

@@ -68,7 +68,7 @@ npx @doubao-apps/ai skills add doubao-apps-dev --agent codex
 | 框架 API 速查 | `$SKILLS_BASE/references/reference/framework-api-quick-ref.md` | definePage/defineWidget 等核心 API |
 | 开发规则 | `$SKILLS_BASE/references/rules/dos-and-donts.md` | 必须遵守的开发规范 |
 | 组件开发指南 | `$SKILLS_BASE/references/guides/component-development.md` | 页面/组件组织方式 |
-| 组件库参考 | `$SKILLS_BASE/references/reference/components-quick-ref.md` | UI 组件 API |
+| 组件库参考 | `doubao-components-api` skill | UI 组件完整 props 和事件 API |
 
 ### 映射文档（迁移核心依据）
 

package/dist/{skills → public/skills}/h5-to-doubao/SKILL.md

@@ -47,7 +47,7 @@ description: Migrate H5 projects to Doubao Apps SDK (React Lynx). Supports stand
 | 框架 API 速查 | `$SKILLS_BASE/references/reference/framework-api-quick-ref.md` | definePage/defineWidget 等核心 API |
 | 开发规则 | `$SKILLS_BASE/references/rules/dos-and-donts.md` | 必须遵守的开发规范 |
 | 组件开发指南 | `$SKILLS_BASE/references/guides/component-development.md` | 完整的组件开发模式 |
-| 组件库参考 | `$SKILLS_BASE/references/reference/components-quick-ref.md` | UI 组件 API |
+| 组件库参考 | `doubao-components-api` skill | UI 组件完整 props 和事件 API |
 
 ### 源框架子文档（按源框架读取）
 
@@ -246,7 +246,7 @@ HTML 元素：
 **按需读取**：
 
 - `$SKILLS_BASE/references/guides/component-development.md` - 遇到复杂组件时
-- `$SKILLS_BASE/references/reference/components-quick-ref.md` - 需要使用 UI 组件时
+- `doubao-components-api` skill - 需要使用 UI 组件时
 - `./references/source-framework/react-to-doubao.md` - 当 `source_framework=react`
 - `./references/source-framework/vue-to-doubao.md` - 当 `source_framework=vue`
 - `./references/common/troubleshooting.md` - 当迁移或验证阶段出现公共问题

package/dist/{skills → public/skills}/quality-gate/scripts/collect-doubao-page-data.js

@@ -180,10 +180,10 @@ function sampleFromType(ts, checker, type, fieldPath, state, depth = 0) {
     return chooseStringSample(fieldName);
   }
 
-  if (normalized.isStringLiteral && normalized.isStringLiteral()) {
+  if (normalized.isStringLiteral?.()) {
     return normalized.value;
   }
-  if (normalized.isNumberLiteral && normalized.isNumberLiteral()) {
+  if (normalized.isNumberLiteral?.()) {
     return normalized.value;
   }
 
@@ -197,7 +197,7 @@ function sampleFromType(ts, checker, type, fieldPath, state, depth = 0) {
     return false;
   }
 
-  if (normalized.isUnion && normalized.isUnion()) {
+  if (normalized.isUnion?.()) {
     const literal = normalized.types.find(
       (item) =>
         (item.flags & ts.TypeFlags.StringLiteral) ||

package/dist/{skills → public/skills}/uniapp-to-doubao/SKILL.md

@@ -69,7 +69,7 @@ npx @doubao-apps/ai skills add doubao-apps-dev --agent codex
 | 框架 API 速查 | `$SKILLS_BASE/references/reference/framework-api-quick-ref.md` | `definePage` / `defineApp` / `getViewData` 等 |
 | 开发规则 | `$SKILLS_BASE/references/rules/dos-and-donts.md` | 必须遵守的目标框架规范 |
 | 组件开发指南 | `$SKILLS_BASE/references/guides/component-development.md` | 页面/组件组织方式 |
-| 组件库参考 | `$SKILLS_BASE/references/reference/components-quick-ref.md` | 目标组件 API |
+| 组件库参考 | `doubao-components-api` skill | UI 组件完整 props 和事件 API |
 
 ### 映射文档（迁移核心依据）
 

package/dist/{skills → public/skills}/weixin-to-doubao/SKILL.md

@@ -45,7 +45,7 @@ description: Migrate WeChat Mini Program (微信小程序) projects to Doubao Ap
 | 框架 API 速查 | `$SKILLS_BASE/references/reference/framework-api-quick-ref.md` | definePage/defineWidget 等核心 API |
 | 开发规则 | `$SKILLS_BASE/references/rules/dos-and-donts.md` | 必须遵守的开发规范 |
 | 组件开发指南 | `$SKILLS_BASE/references/guides/component-development.md` | 完整的组件开发模式 |
-| 组件库参考 | `$SKILLS_BASE/references/reference/components-quick-ref.md` | UI 组件 API |
+| 组件库参考 | `doubao-components-api` skill | UI 组件完整 props 和事件 API |
 
 ### 映射文档（迁移核心依据）
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@doubao-apps/ai",
-  "version": "0.0.35-rc.0",
-  "description": "Doubao Apps SDK AI tools with context and skills management",
+  "version": "0.0.35",
+  "description": "Doubao Apps SDK AI tools for skills management",
   "type": "module",
   "bin": {
     "doubao-cli": "./bin.js"
@@ -16,8 +16,8 @@
       "import": "./dist/cli.js",
       "types": "./dist/cli.d.ts"
     },
-    "./manifest": "./dist/manifest.json",
-    "./skills/*": "./dist/skills/*"
+    "./manifest/public": "./dist/public/manifest.json",
+    "./skills/public/*": "./dist/public/skills/*"
   },
   "files": [
     "bin.js",
@@ -33,6 +33,6 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "build": "rslib build && node scripts/copy-assets.cjs"
+    "build": "rimraf dist && rslib build && node scripts/copy-assets.cjs"
   }
 }

package/dist/733.js

@@ -1,33 +0,0 @@
-import l,{createRequire as e}from"node:module";let o=l.createRequire(import.meta.url);import{__webpack_require__ as s}from"./rslib-runtime.js";import{fileURLToPath as t}from"node:url";import{dirname as a}from"node:path";let i=e(import.meta.url);s.add({"node:fs"(l){l.exports=i("node:fs")},"node:path"(l){l.exports=i("node:path")},"../../ai/dist/cli.js"(l,e,s){var i=a(t(import.meta.url));let n=s("node:fs"),r=s("node:path"),c={amp:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},"kimi-cli":{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},replit:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},universal:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},antigravity:{projectPath:".agent/skills/",globalPath:"~/.gemini/antigravity/skills/"},augment:{projectPath:".augment/skills/",globalPath:"~/.augment/skills/"},claude:{projectPath:".claude/skills/",globalPath:"~/.claude/skills/"},"claude-code":{projectPath:".claude/skills/",globalPath:"~/.claude/skills/"},openclaw:{projectPath:"skills/",globalPath:"~/.openclaw/skills/"},cline:{projectPath:".agents/skills/",globalPath:"~/.agents/skills/"},codebuddy:{projectPath:".codebuddy/skills/",globalPath:"~/.codebuddy/skills/"},codex:{projectPath:".agents/skills/",globalPath:"~/.codex/skills/"},"command-code":{projectPath:".commandcode/skills/",globalPath:"~/.commandcode/skills/"},continue:{projectPath:".continue/skills/",globalPath:"~/.continue/skills/"},cortex:{projectPath:".cortex/skills/",globalPath:"~/.snowflake/cortex/skills/"},crush:{projectPath:".crush/skills/",globalPath:"~/.config/crush/skills/"},cursor:{projectPath:".agents/skills/",globalPath:"~/.cursor/skills/"},droid:{projectPath:".factory/skills/",globalPath:"~/.factory/skills/"},"gemini-cli":{projectPath:".agents/skills/",globalPath:"~/.gemini/skills/"},"github-copilot":{projectPath:".agents/skills/",globalPath:"~/.copilot/skills/"},goose:{projectPath:".goose/skills/",globalPath:"~/.config/goose/skills/"},junie:{projectPath:".junie/skills/",globalPath:"~/.junie/skills/"},"iflow-cli":{projectPath:".iflow/skills/",globalPath:"~/.iflow/skills/"},kilo:{projectPath:".kilocode/skills/",globalPath:"~/.kilocode/skills/"},"kiro-cli":{projectPath:".kiro/skills/",globalPath:"~/.kiro/skills/"},kode:{projectPath:".kode/skills/",globalPath:"~/.kode/skills/"},mcpjam:{projectPath:".mcpjam/skills/",globalPath:"~/.mcpjam/skills/"},"mistral-vibe":{projectPath:".vibe/skills/",globalPath:"~/.vibe/skills/"},mux:{projectPath:".mux/skills/",globalPath:"~/.mux/skills/"},opencode:{projectPath:".agents/skills/",globalPath:"~/.config/opencode/skills/"},openhands:{projectPath:".openhands/skills/",globalPath:"~/.openhands/skills/"},pi:{projectPath:".pi/skills/",globalPath:"~/.pi/agent/skills/"},qoder:{projectPath:".qoder/skills/",globalPath:"~/.qoder/skills/"},"qwen-code":{projectPath:".qwen/skills/",globalPath:"~/.qwen/skills/"},roo:{projectPath:".roo/skills/",globalPath:"~/.roo/skills/"},trae:{projectPath:".trae/skills/",globalPath:"~/.trae/skills/"},"trae-cn":{projectPath:".trae/skills/",globalPath:"~/.trae-cn/skills/"},windsurf:{projectPath:".windsurf/skills/",globalPath:"~/.codeium/windsurf/skills/"},zencoder:{projectPath:".zencoder/skills/",globalPath:"~/.zencoder/skills/"},neovate:{projectPath:".neovate/skills/",globalPath:"~/.neovate/skills/"},pochi:{projectPath:".pochi/skills/",globalPath:"~/.pochi/skills/"},adal:{projectPath:".adal/skills/",globalPath:"~/.adal/skills/"}};function d(){return r.join(i,"..","dist")}function g(l={}){return r.join(function(l={}){if(l.preferBundledAssets)return d();try{let l=o.resolve("@byted-doubao-apps/ai-assets/manifest");return r.dirname(l)}catch{return d()}}(l),"skills")}function k(l){return l.startsWith("~/")?r.join(process.env.HOME||process.env.USERPROFILE||"",l.slice(2)):l}function p(l){let e={agent:null,global:!1};for(let o=0;o<l.length;o++)("--agent"===l[o]||"-a"===l[o])&&l[o+1]?e.agent=l[++o]:("--global"===l[o]||"-g"===l[o])&&(e.global=!0);return e}function h(l,e,o,s={}){if(!c[e])throw Error(`Unknown agent: "${e}". Supported agents: ${Object.keys(c).join(", ")}`);let t=function(l,e={}){return r.join(g(e),l)}(l,s);if(!n.existsSync(t)){let e=g(s),o=n.existsSync(e)?n.readdirSync(e).join(", "):"(none)";throw Error(`Skill "${l}" not found. Available skills: ${o}`)}let a=c[e],i=o?a.globalPath:a.projectPath,d=o?r.join(k(i),l):r.join(process.cwd(),i,l);for(let o of(console.log(`Installing skill "${l}" for ${e}...`),console.log(`  Target: ${d}`),n.existsSync(d)&&n.rmSync(d,{recursive:!0,force:!0}),n.mkdirSync(d,{recursive:!0}),n.readdirSync(t,{withFileTypes:!0}))){let l=r.join(t,o.name),e=r.join(d,o.name);o.isDirectory()?(!function l(e,o){if(!n.existsSync(e))throw Error(`Source directory not found: ${e}`);for(let s of(n.mkdirSync(o,{recursive:!0}),n.readdirSync(e,{withFileTypes:!0}))){let t=r.join(e,s.name),a=r.join(o,s.name);s.isDirectory()?l(t,a):n.copyFileSync(t,a)}}(l,e),console.log(`  ✓ ${o.name}/`)):(n.copyFileSync(l,e),console.log(`  ✓ ${o.name}`))}console.log("  ✓ Done")}l.exports={runCli:function(l={}){let e=l.commandName||"doubao-ai",o={preferBundledAssets:!0===l.preferBundledAssets},[s,...t]=process.argv.slice(2);if(!s||"--help"===s||"-h"===s)return void console.log(`
-${e} - Doubao Apps SDK AI 工具
-
-用法：
-  ${e} skills add <skill1> [skill2...] --agent <agent>  安装一个或多个 skill 到指定 Agent
-  ${e} skills list                         查看可用 skills
-  ${e} skills update [--global]            更新所有已安装的 skills
-
-选项：
-  --agent <agent>    指定 AI Agent（如 claude-code、opencode、cursor）
-  --global, -g       全局安装（用户目录而非项目目录）
-
-示例：
-  # 安装一个或多个 skill 到 Claude Code
-  ${e} skills add doubao-apps-dev quality-gate --agent claude-code
-
-  # 安装 skill 到 opencode
-  ${e} skills add doubao-apps-dev --agent opencode
-
-  # 全局安装 skill
-  ${e} skills add doubao-apps-dev --agent claude-code --global
-
-  # 查看可用 skills
-  ${e} skills list
-
-  # 更新所有已安装的 skills
-  ${e} skills update
-
-支持的 Agents：
-  ${Object.keys(c).join(", ")}
-`);if("skills"===s){let[l,...s]=t;if("list"===l)return void function(l={}){let e=g(l);if(!n.existsSync(e))return console.log("No skills available. Run build first.");let o=n.readdirSync(e,{withFileTypes:!0}).filter(l=>l.isDirectory()).map(l=>l.name);if(0===o.length)return console.log("No skills available.");for(let l of(console.log("Available skills:"),o)){let o=r.join(e,l,"SKILL.md");console.log(`  - ${l}${n.existsSync(o)?"":" (not built)"}`)}}(o);if("add"===l){let{agent:l,global:t}=p(s),a=[];for(let l=0;l<s.length;l++){let e=s[l];"--agent"===e||"-a"===e?l++:"--global"!==e&&"-g"!==e&&a.push(e)}for(let s of(0===a.length&&(console.error(`Usage: ${e} skills add <skill-name>... --agent <agent>`),process.exit(1)),l||(console.error(`--agent is required. Example: ${e} skills add doubao-apps-dev --agent claude-code`),process.exit(1)),a))h(s,l,t,o);return}if("update"===l){let{global:l}=p(s);!function(l,e={}){let o=g(e);if(!n.existsSync(o))return console.log("No skills to update. Run build first.");let s=n.readdirSync(o,{withFileTypes:!0}).filter(l=>l.isDirectory()).map(l=>l.name),t=0;for(let[o,a]of Object.entries(c)){let i=l?a.globalPath:a.projectPath,c=l?k(i):r.join(process.cwd(),i);for(let a of s)n.existsSync(r.join(c,a))&&(h(a,o,l,e),t++)}0===t?console.log("No installed skills found to update."):console.log(`
-Updated ${t} skill installation(s).`)}(l,o);return}console.error(`Unknown skills subcommand: "${l}". Use: add, list, update`),process.exit(1)}console.error(`Unknown command: "${s}". Run \`${e} --help\` for usage.`),process.exit(1)}}}});
-//# sourceMappingURL=733.js.map

package/dist/skills/doubao-apps-dev/references/reference/components-quick-ref.md

@@ -1,114 +0,0 @@
-# 组件库快速参考
-
-所有组件均已编译为全局变量，**无需任何 import**，直接像 `<view>`、`<text>` 一样使用小写标签即可。
-
----
-
-## 组件列表
-
-| 组件标签 | 用途 | 关键属性 |
-|---------|------|----------|
-| `<button>` | 按钮交互 | `text`, `type`, `size`, `loading`, `disabled`, `openType`, `onClick` |
-| `<switch>` | 开关切换 | `checked`, `defaultChecked`, `disabled`, `onChange` |
-| `<slider>` | 滑块选择 | `value`(必填), `min`, `max`, `showValue`, `disabled`, `onChange` |
-| `<swiper>` | 轮播容器 | `data`, `itemWidth`, `itemHeight`, `loop`, `duration`, `onChange` |
-| `<swiper-item>` | 轮播项 | `index`, `realIndex` |
-
----
-
-## 事件命名
-
-应用 TSX 中使用 React 风格事件名。`button` 点击使用 `onClick`；不要在业务代码里写 `onTap`、`bindtap` 或 `catchtap`。
-`switch` / `slider` / `swiper` 使用 `onChange`，回调直接接收当前值。
-
----
-
-## button 按钮
-
-```tsx
-<button
-  text="提交"
-  type="primary"       // primary | default | plain
-  size="default"       // default | mini | large
-  loading={false}
-  disabled={false}
-  throttle={500}       // 节流时间(ms)
-  onClick={() => {}}
-/>
-
-{/* 开放能力 */}
-<button
-  openType="getPhoneNumber"
-  onGetPhoneNumber={(e) => console.log(e)}
-/>
-```
-
----
-
-## switch 开关
-
-```tsx
-{/* 非受控 */}
-<switch defaultChecked onChange={(checked) => {}} />
-
-{/* 受控 */}
-<switch checked={value} onChange={(checked) => setChecked(checked)} />
-```
-
-> `onChange` 回调直接接收 `boolean` 值，而非事件对象。
-
----
-
-## slider 滑块
-
-```tsx
-const [value, setValue] = useState(50);
-
-<slider
-  value={value}      // 必填，只支持受控
-  min={0}
-  max={100}
-  showValue={true}
-  onChange={(value) => setValue(value)}
-/>
-```
-
-> `onChange` 回调直接接收 `number` 值，而非事件对象。
-> `slider` 不支持 `step`、`defaultValue` 或事件对象参数；不要传这些 props。
-
----
-
-## swiper 轮播
-
-```tsx
-<swiper
-  data={[{ img: 'url1' }, { img: 'url2' }]}
-  itemWidth={300}
-  itemHeight={200}
-  loop={true}
-  duration={500}
-  onChange={(index) => console.log(index)}
->
-  {({ item, index }) => (
-    <swiper-item index={index} key={index}>
-      <image src={item.img} />
-    </swiper-item>
-  )}
-</swiper>
-```
-
-> `onChange` 回调直接接收当前 `index: number`，而非事件对象。
-
----
-
-## 注意事项
-
-1. **无需 import**：所有组件直接使用小写标签，不需要从任何包导入
-2. **事件命名**：button 使用 `onClick`，不要写 `onTap`、`bindtap` 或 `catchtap`
-3. **onChange 回调签名**：switch/slider/swiper 的 `onChange` 直接接收值（boolean/number/number），不是事件对象
-4. **Lynx 不支持 CSS 继承**：组件样式自包含，不依赖父元素样式
-5. **受控/非受控**：switch 支持两种模式，slider 只支持受控模式
-6. **节流处理**：button 内置 500ms 节流，可通过 `throttle` 自定义
-7. **Slider props**：slider 只使用 `value`、`min`、`max`、`showValue`、`disabled`、`onChange`，不要写 `step`
-
-完整 Page 组合示例见 [内置组件使用配方](../examples/component-recipes.md)。

package/dist/skills/doubao-apps-dev/references/reference/open-api/01-/345/237/272/347/241/200.md

@@ -1,136 +0,0 @@
-# Open API: 基础
-
-账号、授权、宿主基础信息、窗口信息和能力可用性。
-
-[返回目录](./README.md) | [返回速查](../open-api.md)
-
-## 速查
-
-| API | 说明 |
-| --- | --- |
-| [getAccountInfo](#getaccountinfo) | 异步获取账号信息。 |
-| [getAccountInfoSync](#getaccountinfosync) | 同步获取账号信息。<br><br>同步 API。 |
-| [authorize](#authorize) | 初始化授权。 |
-| [canIUse](#caniuse) | 检测当前宿主是否支持指定 API 或能力。 |
-
-## API 详情
-
-<a id="getaccountinfo"></a>
-### getAccountInfo()
-
-异步获取账号信息。
-
-## 代码示例
-
-```typescript
-import { getAccountInfo } from '@doubao-apps/framework/api';
-
-const result = await getAccountInfo();
-console.log(result.miniProgram.appId);
-```
-
-## 入参
-
-无入参。
-
-## 返回值
-
-返回 `Promise<GetAccountInfoResult>`。
-
-|字段名|类型|说明|
-|---|---|---|
-|miniProgram|`DoubaoAppAccountInfo`|豆包 App账号信息|
-|miniProgram.appId|`string`|豆包 App appId|
-|miniProgram.envVersion|`"develop" \| "trial" \| "release"`|豆包 App 运行环境。<br><br>- develop: 开发版<br>- trial: 体验版<br>- release: 正式版|
-|miniProgram.version|`string`|线上豆包 App 版本号。|
-|plugin|`PluginAccountInfo`|插件账号信息（仅在插件中调用时包含）|
-|plugin.appId|`string`|插件 appId|
-|plugin.version|`string`|插件版本号，'a.b.c' 形式|
-
-<a id="getaccountinfosync"></a>
-### getAccountInfoSync()
-
-同步获取账号信息。
-
-## 代码示例
-
-```typescript
-import { getAccountInfoSync } from '@doubao-apps/framework/api';
-
-const result = getAccountInfoSync();
-console.log(result.miniProgram.appId, result.miniProgram.envVersion, result.miniProgram.version);
-```
-
-## 入参
-
-无入参。
-
-## 返回值
-
-返回 `GetAccountInfoResult`。
-
-|字段名|类型|说明|
-|---|---|---|
-|miniProgram|`DoubaoAppAccountInfo`|豆包 App账号信息|
-|miniProgram.appId|`string`|豆包 App appId|
-|miniProgram.envVersion|`"develop" \| "trial" \| "release"`|豆包 App 运行环境。<br><br>- develop: 开发版<br>- trial: 体验版<br>- release: 正式版|
-|miniProgram.version|`string`|线上豆包 App 版本号。|
-|plugin|`PluginAccountInfo`|插件账号信息（仅在插件中调用时包含）|
-|plugin.appId|`string`|插件 appId|
-|plugin.version|`string`|插件版本号，'a.b.c' 形式|
-
-<a id="authorize"></a>
-### authorize()
-
-初始化授权
-
-## 代码示例
-
-```typescript
-import { authorize } from '@doubao-apps/framework/api';
-
-await authorize({ scope: 'scope.userLocation' });
-```
-
-## 入参
-
-|参数名|类型|必填|说明|
-|---|---|---|---|
-|scope|`Scope`|是|授权范围|
-
-**类型说明**
-
-- `Scope`: `"scope.userLocation" | "scope.userFuzzyLocation" | "scope.userLocationBackground" | "scope.payment" | "scope.record" | "scope.bluetooth" | "scope.camera" | "scope.addPhoneContact" | "scope.addPhoneCalendar"`
-
-## 返回值
-
-Promise 对象，授权成功时会返回授权结果
-
-<a id="caniuse"></a>
-### canIUse()
-
-检测当前宿主是否支持指定 API 或能力。
-
-## 代码示例
-
-```typescript
-import { canIUse } from '@doubao-apps/framework/api';
-
-const { result } = await canIUse({ schema: 'doubao.getLocation' });
-
-console.log(result);
-```
-
-## 入参
-
-|参数名|类型|必填|说明|
-|---|---|---|---|
-|schema|`string`|是|-|
-
-## 返回值
-
-返回 `Promise<CanIUseResult>`。
-
-|字段名|类型|说明|
-|---|---|---|
-|result|`boolean`|-|