diff --git a/docs/GETTING-STARTED.md b/docs/GETTING-STARTED.md
index caf21ba7d033..b39bda90a772 100644
--- a/docs/GETTING-STARTED.md
+++ b/docs/GETTING-STARTED.md
@@ -789,6 +789,9 @@ $ npx taro build --type ascf
$ set NODE_ENV=production && taro build --type ascf --watch # CMD
$ NODE_ENV=production taro build --type ascf --watch # Bash
+
+```
+
开发者工具
工具准备:
@@ -877,3 +880,4 @@ $ pnpm add -g @tarojs/cli@1.3.9
# OR 安装了 cnpm,使用 cnpm 安装 CLI
$ cnpm install -g @tarojs/cli@1.3.9
```
+
diff --git a/docs/app-config.md b/docs/app-config.md
index 04fdef6eed9a..ed0ced412be4 100644
--- a/docs/app-config.md
+++ b/docs/app-config.md
@@ -658,3 +658,34 @@ export default {
animation: false,
}
```
+
+## ASCF 元服务支持的属性
+
+### ASCF支持的全局参数
+
+这些配置需在项目的入口配置文件(如 app.config.js)中声明,以实现对ASCF元服务的适配。
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+| :------------ | :------ | :--- | :----- | :--------------------------------- |
+| ascfAppId | String | 是 | 无 | ASCF元服务的唯一应用标识,需在ASCF开发者平台申请后填写。 |
+| serviceType | String | 是 | 无 | 元服务类型,可选值:miniprogram(小程序式元服务)、webapp(轻应用式元服务)。 |
+| enableAuth | Boolean | 否 | false | 是否开启ASCF的全局用户鉴权功能,需配合ASCF的API使用。 |
+| apiBaseUrl | String | 否 | 无 | ASCF后端API的统一请求地址,用于元服务与服务器的通信。 |
+
+#### 代码示例
+
+```js title="app.config.js"
+export default {
+ pages: ['pages/index/index'],
+ window: {
+ navigationBarTitleText: 'Taro Demo',
+ },
+
+ ascf: {
+ ascfAppId: 'ASCF_123456',
+ serviceType: 'miniprogram',
+ enableAuth: true,
+ apiBaseUrl: 'https://api.ascf.com',
+ },
+};
+```
\ No newline at end of file
diff --git a/docs/envs.md b/docs/envs.md
index 1b74a8683eba..7731d53615fd 100644
--- a/docs/envs.md
+++ b/docs/envs.md
@@ -12,7 +12,7 @@ Taro 在编译时提供了一些内置的环境变量来帮助用户做一些特
用于判断当前的编译平台类型。
-取值:`weapp` / `swan` / `alipay` / `tt` / `qq` / `jd` / `h5` / `rn`
+取值:`weapp` / `swan` / `alipay` / `tt` / `qq` / `jd` / `h5` / `rn`/ `ascf`
可以通过这个变量来区分不同环境,从而使用不同的逻辑。在编译阶段,**会移除不属于当前编译类型的代码,只保留当前编译类型下的代码**,例如:
diff --git a/docs/harmony/meta.md b/docs/harmony/meta.md
new file mode 100644
index 000000000000..587f9a2be00e
--- /dev/null
+++ b/docs/harmony/meta.md
@@ -0,0 +1,181 @@
+---
+title: 元服务
+---
+
+### 元服务
+
+#### 转换为 ASCF 元服务
+
+##### ASCF 介绍
+ASCF(Application Service Component Framework)是面向鸿蒙生态的元服务开发框架,提供轻量化服务能力:
+- **包体更小**:最大包体限制10MB(小程序为20MB)
+- **启动更快**:毫秒级服务卡片加载
+- **深度集成**:支持系统级服务卡片、语音唤醒等鸿蒙特性
+
+##### 开发前准备
+1. **注册账号**:
+ - 访问 [ASCF开发者平台](https://developer.ascf.harmonyos.com) 注册账号
+ - 完成企业实名认证(个人开发者仅支持测试环境)
+
+2. **环境配置**:
+ ```bash
+ # 安装ASCF编译插件
+ npm install @tarojs/plugin-platform-ascf --save-dev
+
+##### 开发第一个 ASCF 元服务
+
+1. **创建Taro项目**:
+ ```bash
+ taro init my-ascf-app
+
+2. **添加元服务页面**:
+
+```diff
+export default function Index() {
+ return (
+
+ Hello ASCF 元服务!
+
+
+ )
+}
+```
+
+3. **启动开发模式**:
+ ```bash
+ taro build --type ascf --watch
+
+##### 修改编译配置
+
+在项目根目录创建 project.ascf.json:
+```diff
+{
+ "appid": "YOUR_ASCF_APPID",
+ "projectname": "我的元服务",
+ "minPlatformVersion": "3.0.0",
+ "serviceCards": [{
+ "name": "mainCard",
+ "src": "/pages/index"
+ }]
+}
+```
+
+##### 编译运行
+
+1. **完整编译**:
+ ```bash
+ taro build --type ascf
+
+
+ 2. **输出目录**:
+ ```bash
+ dist/ascf
+
+##### 预览&调试
+1.使用 ASCF DevTools 导入 dist/ascf 目录
+
+2.扫码预览服务卡片效果:
+
+3.真机调试命令:
+ ```bash
+ ascf debug --device YOUR_DEVICE_ID
+
+#### 注意事项
+
+##### 与小程序的差异
+
+| 特性 | 小程序 | ASCF元服务 | 说明 |
+| -------------- | -----------------| --------------|------------------|
+| 包体大小 | <= 20MB | <= 10MB |需精简资源 |
+| 启动方式 | 扫码/搜索 | 服务卡片/语音 |需配置serviceCards |
+| 路由层级 | 无限制 | 最多5级 |避免深层嵌套 |
+| 全局样式 | 支持 | 部分支持 |需添加-ascf-前缀 |
+
+
+
+##### 常见问题
+
+1. **样式兼容问题**:
+ ```bash
+ .container {
+ -ascf-flex-direction: column;
+ }
+
+2. **API调用差异**:
+ ```diff
+
+ // 小程序方式 (不支持)
+ wx.request({...})
+
+ // ASCF方式
+ ascf.request({...})
+
+ ```
+###### 不支持云开发
+
+当前版本无法使用微信云开发/支付宝云能力,需自建后端服务
+
+###### 不支持插件
+
+无法直接使用小程序插件,需重写为ASCF组件:
+ ```diff
+ export default function CustomPicker({ options }) {
+ return (
+
+ )
+ }
+ ```
+
+###### 不支持独立分包
+所有代码必须打包到主包中,需优化首包体积:
+ ```bash
+ # 分析包体积
+ npx taro asc analyze --type ascf
+
+
+### HarmonyOS 应用
+
+鸿蒙与小程序
+
+鸿蒙 Stage 模型支持使用 ArkTS 来声明式地开发 UI(ArkUI)。ArkTS 是 HarmonyOS 优选的主力应用开发语言。ArkTS 围绕应用开发 TypeScript(简称 TS)生态基础上做了进一步扩展,继承了 TS 的所有特性,是 TS 的超集。
+
+鸿蒙 ArkUI 与小程序写法的主要异同
+
+1.开发语言
+鸿蒙的开发语言 ArkTS 在语法方面由于是 TypeScript 的超集,因此能完美兼容小程序上的 JavaScript/TypeScript 语法。
+
+2.渲染 UI
+小程序可以通过 template 模板来动态地拼接和生成页面的 UI,而鸿蒙可以通过系统提供的自定义组件来递归地渲染出页面 UI。
+
+配置鸿蒙环境
+
+首先要准备鸿蒙运行所需的环境,根据参考文档提示的步骤在 HUAWEI DevEco Studio 的 IDE 中完成 MyApplication 项目的创建,熟悉鸿蒙开发者工具的预览查看等功能。
+
+1. 安装、配置 DevEco Studio
+
+(1)登录 HarmonysOS 应用开发门户,点击右上角注册按钮,注册开发者帐号。
+
+(2)进入 HUAWEI DevEco Studio 下载中心,点击立即下载按钮,下载最新版本的 DevEco Studio IDE。
+
+2. 创建 Harmony 主项目
+
+(1)创建新项目,选择需要开发的设备,根据应用配置所需的信息,点击 Finish 按钮,一个新的项目就被创建出来了。
+
+(2)关注目录 entry/src/main/ets/pages/Index.ets 下面的文件,熟悉文件结构。pages 目录下为页面入口,新建项目的页面目录会包含若干个 .ets 文件,应用级配置信息位于 build-profile.json5,当前的模块信息 、编译信息配置项位于 entry/build-profile.json5。项目结构详情。
+
+3. 预览 & 调试
+
+(1)DevEco Studio 支持下述方式查看运行效果,链接到鸿蒙官网查看具体步骤
+
+a. 使用预览器 previewer 该功能与真机效果可能存在差异,主要用于 UI 样式的预览,主要用于预览 ArkTS 侧经过 @Component 修饰的 UI 组件,在 Taro For Harmony 的开发中无法使用,可以暂时忽略。
+
+b. 使用模拟器 使用 DevEco Studio 提供的模拟器功能,即可正常调试 Taro 打包出来的鸿蒙应用程序,除了无法使用 IDE 提供的 Profiler 来测量性能外,其余功能和真机并无太大差异,推荐没有真机的开发者优先考虑这种调试方式。
+
+c. 使用本地真机 用户真机与电脑相连,打开开发者模式,即可在真机看到效果,这里需要注意的是,真机需要使用纯鸿蒙系统的手机,能够体验到完整的鸿蒙系统功能。
+
+(2) DevEco Studio 真机进行调试
+
+链接上真机后,选择好对应的入口模块,在项目代码中打上断点等信息,在编译器中启动调试即可。
+
diff --git a/docs/page-config.mdx b/docs/page-config.mdx
index 219c72d492e7..5b379fbc0abc 100644
--- a/docs/page-config.mdx
+++ b/docs/page-config.mdx
@@ -103,23 +103,24 @@ export default function Index() {}
### 各端支持程度
-| 属性 | 微信小程序 | 百度小程序 | 抖音小程序 | 支付宝小程序 | H5 | RN |
-| ---------------------------- | ---------------------------------- | -------------------------- | -------------- | ------------ | --- | --- |
-| navigationBarBackgroundColor | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
-| navigationBarTextStyle | ✔️ | ✔️ | ✔️ | ✘ | ✔️ | ✔️ |
-| navigationBarTitleText | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
-| navigationStyle | ✔️(微信客户端 6.6.0) | ✔️(百度 App 版本 11.1.0) | ✔️ | ✘ | ✘ | ✔️ |
-| transparentTitle | - | - | - | ✔️ | - | - |
-| backgroundColor | ✔️ | ✔️ | ✔️ | ✘ | ✘ | ✔️ |
-| backgroundTextStyle | ✔️ | ✔️ | ✔️ | ✘ | ✘ | ✔️ |
-| backgroundColorTop | ✔️(微信客户端 6.5.16) | ✘ | ✔️ | ✘ | ✘ | ✘ |
-| backgroundColorBottom | ✔️(微信客户端 6.5.16) | ✘ | ✔️ | ✘ | ✘ | ✘ |
-| enablePullDownRefresh | ✔️ | ✔️ | ✔️ | ✔️ | ✘ | ✘ |
-| onReachBottomDistance | ✔️ | ✔️ | ✔️ | ✘ | ✘ | ✘ |
-| pageOrientation | ✔️2.4.0 (auto) / 2.5.0 (landscape) | ✘ | ✘ | ✘ | ✘ | ✘ |
-| disableScroll | ✔️ | ✘ | ✘ | ✘ | ✘ | ✔️ |
-| disableSwipeBack | ✔️ | ✘ | ✘ | ✘ | ✘ | ✘ |
-| enableShareAppMessage | ✔️ | ✘ | ✘ | ✘ | ✔️ | ✘ |
-| enableShareTimeline | ✔️ | ✘ | ✘ | ✘ | ✔️ | ✘ |
-| usingComponents | ✔️ | ✔️ | ✔️ | ✔️ | ✘ | ✘ |
-| renderer | ✔️ | ✘ | ✘ | ✘ | ✘ | ✘ |
+属性 | 微信小程序 | 百度小程序 | 抖音小程序 | 支付宝小程序 | H5 | RN | ASCF|
+| ---------------------------- | ---------------------------------- | -------------------------- | -------------- | ------------ | --- | --- |--------- |
+| navigationBarBackgroundColor | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
+| navigationBarTextStyle | ✔️ | ✔️ | ✔️ | ✘ | ✔️ | ✔️ | ✔️ |
+| navigationBarTitleText | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
+| navigationStyle | ✔️(微信客户端 6.6.0) | ✔️(百度 App 版本 11.1.0) | ✔️ | ✘ | ✘ | ✔️ | ✔️ |
+| transparentTitle | - | - | - | ✔️ | - | - | ✘ |
+| backgroundColor | ✔️ | ✔️ | ✔️ | ✘ | ✘ | ✔️ | ✔️ |
+| backgroundTextStyle | ✔️ | ✔️ | ✔️ | ✘ | ✘ | ✔️ | ✘ |
+| backgroundColorTop | ✔️(微信客户端 6.5.16) | ✘ | ✔️ | ✘ | ✘ | ✘ | ✘ |
+| backgroundColorBottom | ✔️(微信客户端 6.5.16) | ✘ | ✔️ | ✘ | ✘ | ✘ | ✘ |
+| enablePullDownRefresh | ✔️ | ✔️ | ✔️ | ✔️ | ✘ | ✘ | ✔️ |
+| onReachBottomDistance | ✔️ | ✔️ | ✔️ | ✘ | ✘ | ✘ | ✘ |
+| pageOrientation | ✔️2.4.0 (auto) / 2.5.0 (landscape) | ✘ | ✘ | ✘ | ✘ | ✘ | ✘ |
+| disableScroll | ✔️ | ✘ | ✘ | ✘ | ✘ | ✔️ | ✘ |
+| disableSwipeBack | ✔️ | ✘ | ✘ | ✘ | ✘ | ✘ | ✘ |
+| enableShareAppMessage | ✔️ | ✘ | ✘ | ✘ | ✔️ | ✘ | ✘ |
+| enableShareTimeline | ✔️ | ✘ | ✘ | ✘ | ✔️ | ✘ | ✘ |
+| usingComponents | ✔️ | ✔️ | ✔️ | ✔️ | ✘ | ✘ | ✔️ |
+| renderer | ✔️ | ✘ | ✘ | ✘ | ✘ | ✘ | ✘ |
+