diff --git a/zh-cn/application-dev/reference/apis/Readme-CN.md b/zh-cn/application-dev/reference/apis/Readme-CN.md
index c87c165352502ba70ae40c7cc515dae3688fa4b3..881b254e3f1514a9d2e027cca9d24aaa1c1d9f0e 100755
--- a/zh-cn/application-dev/reference/apis/Readme-CN.md
+++ b/zh-cn/application-dev/reference/apis/Readme-CN.md
@@ -1,4 +1,4 @@
-# 接口
+# 接口
 
 - [开发说明](development-intro.md)
 
@@ -171,6 +171,7 @@
   - [@ohos.promptAction (弹窗)](js-apis-promptAction.md)
   - [@ohos.router (页面路由)](js-apis-router.md)
   - [@ohos.measure (文本计算)](js-apis-measure.md)
+  - [@ohos.uiAppearance (用户界面外观)](js-apis-uiappearance.md)
 
 - 图形图像
   - [@ohos.animation.windowAnimationManager (窗口动画管理)](js-apis-windowAnimationManager.md)
diff --git a/zh-cn/application-dev/reference/apis/js-apis-uiappearance.md b/zh-cn/application-dev/reference/apis/js-apis-uiappearance.md
new file mode 100644
index 0000000000000000000000000000000000000000..28402007b002e0f214060f8dc9a629d2d042a311
--- /dev/null
+++ b/zh-cn/application-dev/reference/apis/js-apis-uiappearance.md
@@ -0,0 +1,106 @@
+# 用户界面外观
+
+用户界面外观提供管理系统外观的一些基础能力，目前仅包括深浅色模式配置。
+
+> **说明：**
+>
+> 从API Version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+>
+> 本模块接口为系统接口。
+
+
+## 导入模块
+
+```ts
+import uiAppearance from '@ohos.uiAppearance'
+```
+
+
+## DarkMode
+
+深色模式枚举。
+
+
+**系统能力：** SystemCapability.ArkUI.UiAppearance
+
+| 名称 | 值 | 说明 |
+| -- | -- | -- |
+| ALWAYS_DARK | 0 | 系统始终为深色。  |
+| ALWAYS_LIGHT | 1 | 系统始终为浅色。 |
+
+
+## uiAppearance.setDarkMode
+
+setDarkMode(mode: DarkMode, callback: AsyncCallback\<void>): void
+
+设置系统深色模式。
+
+**需要权限：** ohos.permission.UPDATE_CONFIGURATION
+
+**系统能力：** SystemCapability.ArkUI.UiAppearance
+
+**参数：** 
+| 参数名 | 类型 | 必填 | 说明 |
+| -- | -- | -- | -- |
+| mode | [DarkMode](#darkmode) | 是 | 指定系统的深色模式配置 |
+| callback | AsyncCallback\<void>| 是 | 配置深色模式的异步回调 |
+
+**示例：** 
+  ```ts
+uiAppearance.setDarkMode(uiAppearance.DarkMode.ALWAYS_DARK, (err) => {
+  console.info(`${err}`);
+})
+  ```
+
+
+## uiAppearance.setDarkMode
+
+setDarkMode(mode: DarkMode): Promise\<void>;
+
+设置系统深色模式。
+
+**需要权限：** ohos.permission.UPDATE_CONFIGURATION
+
+**系统能力：** SystemCapability.ArkUI.UiAppearance
+
+**参数：** 
+| 参数名 | 类型 | 必填 | 说明 |
+| -- | -- | -- | -- |
+| mode | [DarkMode](#darkmode) | 是 | 指定系统深色模式配置 |
+
+**返回值：**
+
+| 类型   | 说明                           |
+| ------ | ------------------------------ |
+| Promise\<void> | Promise对象。无返回结果的Promise对象。|
+
+**示例：** 
+  ```ts
+uiAppearance.setDarkMode(uiAppearance.DarkMode.ALWAYS_DARK).then(() => {
+    console.log('Set dark-mode successfully.');
+}).catch((err) => {
+    console.log(`Set dark-mode failed, ${err}`);
+});
+  ```
+
+
+## uiAppearance.getDarkMode
+
+getDarkMode(): DarkMode;
+
+获取当前的深色模式配置。
+
+**需要权限：** ohos.permission.UPDATE_CONFIGURATION
+
+**系统能力：** SystemCapability.ArkUI.UiAppearance
+
+**返回值：** 
+| 类型 | 说明 |
+| -- | -- |
+|[DarkMode](#darkmode) | 系统当前的深色模式配置 |
+
+**示例：** 
+  ```ts
+let darkMode = uiAppearance.getDarkMode();
+console.log(`Get dark-mode ${darkMode}`);
+  ```
\ No newline at end of file