uview-plus 3.8.127 → 3.8.129

package/libs/i18n/locales/es.js

@@ -82,5 +82,18 @@ export default {
     "up.goodsSku.price": "Precio",
     "up.goodsSku.amount": "Piezas",
     "up.goodsSku.choosed": "Seleccionado",
-    "up.goodsSku.buyAmount": "Cantidad"
+    "up.goodsSku.buyAmount": "Cantidad",
+    "up.video.rate": "Velocidad",
+    "up.video.volume": "Volumen",
+    "up.video.danmu": "Comentarios",
+    "up.video.danmuPlaceholder": "Envía un comentario",
+    "up.video.send": "Enviar",
+    "up.video.episodes": "Episodios",
+    "up.video.lock": "Bloqueado",
+    "up.video.unlock": "Desbloqueado",
+    "up.video.ad": "Anuncio",
+    "up.video.adCountdown": "Anuncio {seconds}s",
+    "up.video.skipAd": "Saltar anuncio",
+    "up.video.adDetail": "Más información",
+    "up.video.error": "Error de reproducción"
 }

package/libs/i18n/locales/fr.js

@@ -82,5 +82,18 @@ export default {
     "up.goodsSku.price": "Prix",
     "up.goodsSku.amount": "Pièces",
     "up.goodsSku.choosed": "Sélectionné",
-    "up.goodsSku.buyAmount": "Quantité"
+    "up.goodsSku.buyAmount": "Quantité",
+    "up.video.rate": "Vitesse",
+    "up.video.volume": "Volume",
+    "up.video.danmu": "Commentaires",
+    "up.video.danmuPlaceholder": "Envoyer un commentaire",
+    "up.video.send": "Envoyer",
+    "up.video.episodes": "Épisodes",
+    "up.video.lock": "Verrouillé",
+    "up.video.unlock": "Déverrouillé",
+    "up.video.ad": "Publicité",
+    "up.video.adCountdown": "Publicité {seconds}s",
+    "up.video.skipAd": "Ignorer la publicité",
+    "up.video.adDetail": "En savoir plus",
+    "up.video.error": "Échec de la lecture"
 }

package/libs/i18n/locales/ja.js

@@ -82,5 +82,18 @@ export default {
     "up.goodsSku.price": "価格",
     "up.goodsSku.amount": "個",
     "up.goodsSku.choosed": "選択済み",
-    "up.goodsSku.buyAmount": "購入数量"
+    "up.goodsSku.buyAmount": "購入数量",
+    "up.video.rate": "再生速度",
+    "up.video.volume": "音量",
+    "up.video.danmu": "コメント",
+    "up.video.danmuPlaceholder": "コメントを送信",
+    "up.video.send": "送信",
+    "up.video.episodes": "エピソード",
+    "up.video.lock": "ロック中",
+    "up.video.unlock": "ロック解除",
+    "up.video.ad": "広告",
+    "up.video.adCountdown": "広告 {seconds}秒",
+    "up.video.skipAd": "広告をスキップ",
+    "up.video.adDetail": "詳細を見る",
+    "up.video.error": "再生できません"
 }

package/libs/i18n/locales/ko.js

@@ -82,5 +82,18 @@ export default {
     "up.goodsSku.price": "가격",
     "up.goodsSku.amount": "개",
     "up.goodsSku.choosed": "선택됨",
-    "up.goodsSku.buyAmount": "구매 수량"
+    "up.goodsSku.buyAmount": "구매 수량",
+    "up.video.rate": "재생 속도",
+    "up.video.volume": "음량",
+    "up.video.danmu": "탄막",
+    "up.video.danmuPlaceholder": "탄막을 입력하세요",
+    "up.video.send": "보내기",
+    "up.video.episodes": "회차",
+    "up.video.lock": "잠김",
+    "up.video.unlock": "잠금 해제",
+    "up.video.ad": "광고",
+    "up.video.adCountdown": "광고 {seconds}초",
+    "up.video.skipAd": "광고 건너뛰기",
+    "up.video.adDetail": "자세히 보기",
+    "up.video.error": "재생 실패"
 }

package/libs/i18n/locales/ru.js

@@ -82,5 +82,18 @@ export default {
     "up.goodsSku.price": "Цена",
     "up.goodsSku.amount": "Штук",
     "up.goodsSku.choosed": "Выбрано",
-    "up.goodsSku.buyAmount": "Количество"
+    "up.goodsSku.buyAmount": "Количество",
+    "up.video.rate": "Скорость",
+    "up.video.volume": "Громкость",
+    "up.video.danmu": "Комментарии",
+    "up.video.danmuPlaceholder": "Отправить комментарий",
+    "up.video.send": "Отправить",
+    "up.video.episodes": "Серии",
+    "up.video.lock": "Заблокировано",
+    "up.video.unlock": "Разблокировано",
+    "up.video.ad": "Реклама",
+    "up.video.adCountdown": "Реклама {seconds} с",
+    "up.video.skipAd": "Пропустить рекламу",
+    "up.video.adDetail": "Подробнее",
+    "up.video.error": "Ошибка воспроизведения"
 }

package/libs/i18n/locales/th.js

@@ -82,5 +82,18 @@ export default {
     "up.goodsSku.price": "ราคา",
     "up.goodsSku.amount": "ชิ้น",
     "up.goodsSku.choosed": "เลือกแล้ว",
-    "up.goodsSku.buyAmount": "จำนวน"
+    "up.goodsSku.buyAmount": "จำนวน",
+    "up.video.rate": "ความเร็ว",
+    "up.video.volume": "ระดับเสียง",
+    "up.video.danmu": "คอมเมนต์",
+    "up.video.danmuPlaceholder": "ส่งคอมเมนต์",
+    "up.video.send": "ส่ง",
+    "up.video.episodes": "ตอน",
+    "up.video.lock": "ล็อกแล้ว",
+    "up.video.unlock": "ปลดล็อกแล้ว",
+    "up.video.ad": "โฆษณา",
+    "up.video.adCountdown": "โฆษณา {seconds} วิ",
+    "up.video.skipAd": "ข้ามโฆษณา",
+    "up.video.adDetail": "ดูรายละเอียด",
+    "up.video.error": "เล่นไม่สำเร็จ"
 }

package/libs/i18n/locales/zh-Hans.js

@@ -82,5 +82,18 @@ export default {
     "up.goodsSku.price": "价格",
     "up.goodsSku.amount": "件",
     "up.goodsSku.choosed": "已选",
-    "up.goodsSku.buyAmount": "购买数量"
+    "up.goodsSku.buyAmount": "购买数量",
+    "up.video.rate": "倍速",
+    "up.video.volume": "音量",
+    "up.video.danmu": "弹幕",
+    "up.video.danmuPlaceholder": "发条弹幕吧",
+    "up.video.send": "发送",
+    "up.video.episodes": "选集",
+    "up.video.lock": "已锁定",
+    "up.video.unlock": "已解锁",
+    "up.video.ad": "广告",
+    "up.video.adCountdown": "广告 {seconds}s",
+    "up.video.skipAd": "跳过广告",
+    "up.video.adDetail": "了解详情",
+    "up.video.error": "播放失败"
 }

package/libs/i18n/locales/zh-Hant.js

@@ -82,5 +82,18 @@ export default {
     "up.goodsSku.price": "價格",
     "up.goodsSku.amount": "件",
     "up.goodsSku.choosed": "已選",
-    "up.goodsSku.buyAmount": "購買數量"
+    "up.goodsSku.buyAmount": "購買數量",
+    "up.video.rate": "倍速",
+    "up.video.volume": "音量",
+    "up.video.danmu": "彈幕",
+    "up.video.danmuPlaceholder": "發條彈幕吧",
+    "up.video.send": "發送",
+    "up.video.episodes": "選集",
+    "up.video.lock": "已鎖定",
+    "up.video.unlock": "已解鎖",
+    "up.video.ad": "廣告",
+    "up.video.adCountdown": "廣告 {seconds}s",
+    "up.video.skipAd": "跳過廣告",
+    "up.video.adDetail": "了解詳情",
+    "up.video.error": "播放失敗"
 }

package/libs/mixin/mixin.js

@@ -1,5 +1,5 @@
 import { defineMixin } from '../vue'
-import { deepMerge, $parent, upGetRect } from '../function/index'
+import { $parent, upGetRect } from '../function/index'
 import test from '../function/test'
 import route from '../util/route'
 import {
@@ -87,11 +87,16 @@ export const mixin = defineMixin({
                 return instance.__upUCache
             }
             // 在非nvue端，移除props，http，mixin等对象，避免在小程序setData时数据过大影响性能
-            let mergeU = deepMerge(uni.$u, {
-                props: undefined,
-                http: undefined,
-                mixin: undefined
-            })
+            // 这里只做浅拷贝：本mixin是全局注册的（见index.js的Vue.mixin），深拷贝整个uni.$u
+            // （含上百个组件的props默认值）的开销会随组件实例数线性放大，日历、长列表这类
+            // 一次渲染上千个节点的场景会因此长时间阻塞主线程
+            const globalU = typeof uni !== 'undefined' ? uni.$u : null
+            // 与原先的deepMerge保持一致：uni.$u尚未初始化时返回false，交由upBindGetRect兜底
+            if (!globalU || typeof globalU !== 'object') return false
+            let mergeU = Object.assign({}, globalU)
+            mergeU.props = undefined
+            mergeU.http = undefined
+            mergeU.mixin = undefined
 			// 缓存结果避免每次计算
 			if (instance) {
 				instance.__upUCache = mergeU

package/package.json

@@ -2,7 +2,7 @@
   "id": "uview-plus",
   "name": "uview-plus",
   "displayName": "零云®uview-plus3.0重磅发布，全面的Vue3鸿蒙跨端移动组件库，组件丰富维护更新稳定。",
-  "version": "3.8.127",
+  "version": "3.8.129",
   "description": "零云®uview-plus已兼容vue3支持多语言，120+全面的组件和便捷的工具会让您信手拈来。近期新增拖动排序、条码、图片裁剪、下拉刷新、虚拟列表、签名、Markdown等。",
   "keywords": [
     "uview",

package/skills/README.md

@@ -0,0 +1,66 @@
+# uview-plus AI skill
+
+给 AI 编码助手用的 uview-plus 使用说明，按 [Agent Skills](https://code.claude.com/docs/en/skills) 的 `SKILL.md` 格式组织，随 uview-plus 一起分发。
+
+目的很简单：让 AI 写 uview-plus 代码时不再靠猜——组件名、图标名、属性、双向绑定写法、easycom 接入、多端差异都有一手依据。
+
+```
+skills/uview-plus/
+├── SKILL.md                    # 入口：硬规则 + 样板代码 + 索引
+└── references/
+    ├── setup.md                # 安装接入（npm / uni_modules）
+    ├── components.md           # 组件清单（源码生成）
+    ├── icons.md                # 内置图标名清单（源码生成）
+    ├── api.md                  # uni.$u 工具库、路由、请求、主题、i18n
+    └── pitfalls.md             # 症状 → 原因，多端与接入常见坑
+```
+
+## 在项目里启用
+
+### Claude Code / 认 SKILL.md 的工具
+
+把这个目录放到项目的 `.claude/skills/` 下即可被自动发现。
+
+npm 装法：
+
+```bash
+mkdir -p .claude/skills
+cp -r node_modules/uview-plus/skills/uview-plus .claude/skills/
+```
+
+uni_modules（HBuilderX）装法，把源路径换成项目里的实际位置：
+
+```bash
+mkdir -p .claude/skills
+cp -r src/uni_modules/uview-plus/skills/uview-plus .claude/skills/
+```
+
+Windows PowerShell：
+
+```powershell
+New-Item -ItemType Directory -Force .claude\skills | Out-Null
+Copy-Item -Recurse -Force node_modules\uview-plus\skills\uview-plus .claude\skills\
+```
+
+想让内容随 uview-plus 升级自动更新，用软链代替复制（Windows 需要开发者模式或管理员权限）：
+
+```bash
+ln -s ../../node_modules/uview-plus/skills/uview-plus .claude/skills/uview-plus
+```
+
+也可以放到 `~/.claude/skills/` 让所有项目共用。
+
+### 其他 AI 工具
+
+不认 `SKILL.md` 的工具（Cursor、Copilot、Codex 等），在项目的 `AGENTS.md`、`.cursor/rules/*.mdc` 或 `.github/copilot-instructions.md` 里加一句指路即可：
+
+```md
+本项目使用 uview-plus 组件库。写相关代码前先读 node_modules/uview-plus/skills/uview-plus/SKILL.md，
+组件名以 references/components.md 为准，图标名以 references/icons.md 为准，不要凭印象拼名字。
+```
+
+## 维护说明
+
+`references/components.md` 与 `references/icons.md` 由 uview-plus 仓库的 `scripts/gen-skill-references.mjs` 从源码生成，`npm run verify:skill-assets` 会校验它们没有漂移，**不要手改**。
+
+其余文件手写。发现内容与源码不符，欢迎到 https://github.com/ijry/uview-plus/issues 反馈，请注明是哪个文件的哪一段。

package/skills/uview-plus/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: uview-plus
+description: 在 uni-app + Vue3 项目里使用 uview-plus 组件库时使用。覆盖 up-*/u-* 组件写法、easycom 接入、组件与图标清单、uni.$u 工具库、主题与暗黑模式、H5/小程序/App-nvue/鸿蒙多端差异。写页面、初次接入或升级 uview-plus、排查"组件不渲染/样式不生效/属性无效/图标空白"时都适用。
+---
+
+# uview-plus
+
+uni-app 生态的 Vue3 组件库（fork 自 uView2）。139 个组件加一套 JS 工具库（`uni.$u`），一套代码覆盖 H5、微信/支付宝/头条/QQ 小程序、Android/iOS App（vue 与 nvue）、鸿蒙。
+
+包的位置：npm 装法在 `node_modules/uview-plus/`，HBuilderX 装法在项目里的 `uni_modules/uview-plus/`。下文的相对路径都以这个包根目录为准，遇到不确定的用法**优先读包内源码**而不是凭印象写。
+
+## 先确认接入完整
+
+写页面之前先确认宿主项目这 4 处都配好了。缺任意一处的典型症状就是"组件写了不渲染""样式全丢""属性不生效"，这类问题九成不是组件 bug：
+
+1. `pages.json` 的 `easycom.custom` 里有 uview-plus 的三条规则
+2. `main.js` 里 `app.use(uviewPlus)`
+3. `App.vue` **首行** `@import "uview-plus/index.scss";`，且 `<style lang="scss">`
+4. `uni.scss` 里 `@import "uview-plus/theme.scss";`
+
+新项目接入、或上面任意一条没配，读 `references/setup.md`（npm 与 uni_modules 两种装法都有，含 manifest、tsconfig、nvue 的额外要求）。
+
+## 硬规则
+
+1. **不要 `import` 组件**。easycom 会按规则自动引入，模板里直接写 `<up-button text="按钮"></up-button>`。手写 import 反而容易和 easycom 规则打架。
+2. **前缀用 `up-`**。`u-`、`u--` 仍然兼容（三条 easycom 规则都指向同一份 `components/u-*`），但 `u-` 会和 uni-app 官方组件抢名字（例如 `u-slider`），新代码统一用 `up-`，同一项目里不要混用。
+3. **组件名从 `references/components.md` 里挑**，不要凭印象拼。清单里没有的名字就是不存在，结果是编译报错或者整块不渲染。
+4. **属性、事件、插槽不要猜**。一手说明在包内：
+   - `components/u-<名字>/u-<名字>.vue` 顶部 JSDoc 的 `@property` / `@event`
+   - `components/u-<名字>/props.js` 是属性的真实默认值（约四分之一的组件没有这个文件，属性直接写在 `.vue` 里）
+   - `types/comps/<驼峰名>.d.ts` 是 TS 类型（覆盖常用组件，不是全部）
+5. **图标名从 `references/icons.md` 里挑**。`<up-icon name="star-fill"></up-icon>`，名字写错**不会报错**，只是渲染空白。要用清单外的图标，走 `customIcon` 配置自己的字体图标。
+6. **双向绑定分两类**，搞反了就是"弹窗打不开"或"输入框不联动"：
+   - 值类组件（`up-input`、`up-checkbox-group`、`up-rate`、`up-slider`、`up-datetime-picker` …）内部是 `modelValue`，写 `v-model="xxx"`
+   - 显隐类组件（`up-popup`、`up-action-sheet`、`up-modal`、`up-picker`、`up-cascader`、`up-tooltip`、`up-guide`、`up-swipe-action-item`）内部是 `show` + `update:show`，写 `v-model:show="show"`
+   - 其余组件先看它的 `emits` 数组再决定，不要想当然。
+7. **数值型尺寸的单位取决于 `config.unit`**（默认 `px`，项目可全局改成 `rpx`）。要确定的单位就把单位写全：`width="80px"`。
+8. **组件内部尽量不要依赖宿主全局 class**。需要覆盖样式时优先用组件自身的 `customStyle` / 具体属性，小程序有样式隔离，全局类不一定命中。
+
+## 一个可运行的样板
+
+```vue
+<template>
+	<view>
+		<up-navbar title="表单" :autoBack="true"></up-navbar>
+		<up-form ref="formRef" :model="form" :rules="rules" labelWidth="80">
+			<up-form-item label="手机号" prop="mobile" borderBottom>
+				<up-input v-model="form.mobile" placeholder="请输入手机号" border="none"></up-input>
+			</up-form-item>
+		</up-form>
+		<up-button type="primary" text="提交" @click="submit"></up-button>
+		<up-popup v-model:show="show" mode="bottom">
+			<view style="padding: 24px;">提交成功</view>
+		</up-popup>
+	</view>
+</template>
+
+<script setup>
+import { reactive, ref } from 'vue'
+
+const formRef = ref(null)
+const show = ref(false)
+const form = reactive({ mobile: '' })
+const rules = {
+	mobile: [{ required: true, message: '请输入手机号', trigger: ['blur', 'change'] }]
+}
+
+function submit() {
+	formRef.value
+		.validate()
+		.then(() => {
+			show.value = true
+		})
+		.catch(() => {
+			uni.$u.toast('请检查表单')
+		})
+}
+</script>
+```
+
+要点：`up-form` 的 `validate()` 返回 Promise（校验失败 reject 错误数组）；`uni.$u.*` 在 `.vue` 与普通 `.js` 里都能用，不必 import。
+
+## 按需展开
+
+| 需要做的事 | 读这个文件 |
+| --- | --- |
+| 装包、接入、easycom / scss / manifest / tsconfig / nvue Root 配置 | `references/setup.md` |
+| 挑组件、查某个组件的属性事件在哪 | `references/components.md` |
+| 用图标 | `references/icons.md` |
+| 路由、请求、校验、时间、主题、暗黑模式、多语言等 JS 能力 | `references/api.md` |
+| 组件不渲染、样式不生效、多端表现不一致、报错排查 | `references/pitfalls.md` |
+
+包内还有一手资料：`changelog.md`（版本变更，升级排查先看它）、`types/`（TS 声明）。当前版本看包内 `package.json` 的 `version`；`uni.$u.config.v` 只返回大版本 `'3'`，不能用来判断补丁版本。
+
+在线文档 https://uview-plus.jiangruyi.com ，与包内源码不一致时**以源码为准**。

package/skills/uview-plus/references/api.md

@@ -0,0 +1,105 @@
+# JS 工具库（uni.$u）
+
+## 两种取用方式
+
+```js
+// 1) 全局对象，.vue 与普通 .js 文件里都能直接用，不需要 import
+uni.$u.toast('保存成功')
+
+// 2) 具名导入，按需引入
+import { route, timeFormat, deepClone } from 'uview-plus'
+```
+
+`.vue` 里还有 `this.$u`（选项式 API，由 install 挂到 `globalProperties`）。
+
+注意：**主题相关方法只在 `uni.$u` 上**（`setTheme`、`getThemeVars` 等不是包根的具名导出），需要 import 时从 `uview-plus/libs/theme/theme.js` 取。
+
+## 路由
+
+```js
+uni.$u.route({ type: 'navigateTo', url: '/pages/index/index', params: { id: 1 } })
+uni.$u.route('/pages/index/index', { id: 1 }) // 等价简写，默认 navigateTo
+```
+
+`type` 可选 `navigateTo`（默认）、`redirect`、`switchTab`、`reLaunch`、`navigateBack`；`params` 会被拼成 query。全局拦截配置见 `libs/util/route.js`。
+
+## 请求
+
+`uni.$u.http` 是内置 luch-request 实例（`libs/luch-request`），支持 `get/post/put/delete/upload/download`、拦截器、`baseURL` 等：
+
+```js
+uni.$u.http.get('/user/info', { params: { id: 1 } })
+```
+
+推荐在 `app.use(uviewPlus, () => ({ httpIns: initRequest }))` 的 `httpIns` 回调里统一配置拦截器，见 `references/setup.md`。
+
+## 校验
+
+`uni.$u.test.*` 全部返回布尔值：`mobile`、`email`、`url`、`date`、`dateISO`、`number`、`digits`、`string`、`array`、`object`、`func`、`promise`、`idCard`、`carNo`、`amount`、`chinese`、`letter`、`enOrNum`、`landline`、`contains`、`range`、`rangeLength`、`empty`、`jsonString`、`code`、`image`、`video`、`regExp`。
+
+完整签名见 `types/func.d.ts` 的 `test` 接口。
+
+## 常用函数
+
+| 分类 | 函数 |
+| --- | --- |
+| 时间 | `timeFormat(dateTime, 'yyyy-mm-dd')`、`timeFrom(timestamp)`、`padZero`；`uni.$u.date` 是 `timeFormat` 的别名 |
+| 数值 | `calc.add/sub/mul/div`（浮点安全）、`digit.plus/minus/times/divide/round`（高精度）、`priceFormat`、`range(min, max, value)`、`getPx`、`addUnit`、`rpx2px`、`getDuration` |
+| 对象 | `deepClone`、`deepMerge`、`shallowMerge`、`getProperty`、`setProperty`、`getValueByPath` |
+| 字符串 | `trim(str, pos)`、`queryParams(data, isPrefix, arrayFormat)`、`guid(len)` |
+| 函数 | `debounce(fn, wait)`、`throttle(fn, wait)`、`sleep(ms)` |
+| 环境 | `os()`、`sys()`、`getWindowInfo()`、`getDeviceInfo()`、`platform`、`page()`、`pages()` |
+| 交互 | `toast(title, duration)`、`type2icon(type, fill)` |
+| 颜色 | `colorGradient`、`hexToRgb`、`rgbToHex`、`colorToRgba`、`genLightColor` |
+| 节点查询 | `upGetRect(selector, all, comp)`、`upCreateIntersectionObserver(comp, options)` |
+| 其他 | `random(min, max)`、`randomArray(arr)`、`addStyle`、`$parent(name)`、`formValidate` |
+
+表里的 `digit` 与 `getDeviceInfo` **不在 `uni.$u` 上**，只能具名导入（`import { digit, getDeviceInfo } from 'uview-plus'`）；其余都挂在 `uni.$u`，也都能具名导入。挂载清单以包内 `index.js` 的 `$u` 对象为准。
+
+节点查询优先用 `upGetRect` / `upCreateIntersectionObserver` 而不是直接写 `uni.createSelectorQuery`：它们已经处理了 nvue 与组件已卸载的情况。实现在 `libs/function/index.js`，类型在 `types/func.d.ts`。
+
+## 配置对象
+
+- `uni.$u.config`：`v`（大版本 `'3'`）、`unit`、`iconUrl`、`customIcon`、`interceptor`、`nativeThemeSync` 等，默认值在 `libs/config/config.js`
+- `uni.$u.props`：所有组件属性的默认值，可全局改
+- `uni.$u.color`：`up-primary` / `up-success` / `up-error` / `up-warning` / `up-info` 等主题色
+- `uni.$u.zIndex`：各类浮层的层级
+- `setConfig({ config, props, color, zIndex })`：运行时改上面这些
+
+## 主题与暗黑模式
+
+```js
+uni.$u.setTheme('dark')          // 'light' | 'dark'
+uni.$u.setThemePreference('auto') // 跟随系统
+uni.$u.getThemeVars()             // 当前主题的 CSS 变量表
+```
+
+3.8 起主题走 `--up-*` CSS 变量 + 运行时主题，旧的 `$u-*` scss 变量只桥接 light 主题。样式里优先用 `var(--up-primary)` 这类变量；模板里可用 `upThemeVar('--up-border-color', '#dadbde')`、`upThemeIsDark`、`upThemePageStyle`、`upThemeCardStyle`（由 install 挂在实例上，nvue 页面依赖 Root 注入）。
+
+想让原生导航栏 / tabBar 跟随运行时主题，需要显式打开 `config.nativeThemeSync`（默认关，避免覆盖项目已有的 `pages.json` / `theme.json`）。
+
+## 多语言
+
+```js
+import { registerLocale, setLocale, t, en, ja } from 'uview-plus'
+
+registerLocale('ja', ja) // 按需注册语言包，不注册就不打进包
+setLocale('ja')
+t('up.common.confirm')
+```
+
+内置语言包：`en`、`es`、`fr`、`de`、`ko`、`ja`、`ru`、`th`、`zhHans`、`zhHant`（`allLocales` 是全量，会增大体积）。文案键形如 `up.common.confirm`，全量键看 `libs/i18n/locales/en.js`。
+
+## 全局 toast / notify
+
+`uni.$u.rootToast(options)`、`uni.$u.rootNotify(options)` 不需要在页面里放组件。它们依赖 Root 注入的宿主组件（见 `references/setup.md` 的 Root 一节）；没启用 Root 时会自动降级成 `uni.showToast`。
+
+也可以用组件形式：页面里放 `<up-toast ref="toastRef"></up-toast>`，再 `toastRef.value.show({ message: '...' })`。
+
+## 组件实例方法
+
+组件方法要通过 `ref` 调，常用的几个：
+
+- `up-form`：`validate()`（返回 Promise）、`validateField(props, cb)`、`resetFields()`、`clearValidate(props)`、`setRules(rules)`
+- `up-toast` / `up-notify`：`show(options)`
+- 其他组件的方法看对应 `u-<名字>.vue` 里 `methods` 的公开方法与 JSDoc `@method` 说明。