uview-pro 0.0.3 → 0.0.5

package/components/u-radio/u-radio.vue

@@ -26,7 +26,7 @@ defineOptions({
 /**
  * radio 单选框
  * @description 单选框用于有一个选择，用户只能选择其中一个的场景。搭配u-radio-group使用
- * @tutorial https://uview-pro.anyup.cn/docs/components/radio.html
+ * @tutorial https://uview-pro.netlify.app/components/radio.html
  * @property {String|Number} icon-size 图标大小，单位rpx（默认24）
  * @property {String|Number} label-size label字体大小，单位rpx（默认28）
  * @property {String|Number} name radio组件的标示符

package/components/u-radio-group/u-radio-group.vue

@@ -15,7 +15,7 @@ defineOptions({
 /**
  * radioGroup 单选框父组件
  * @description 单选框用于有一个选择，用户只能选择其中一个的场景。搭配u-radio使用
- * @tutorial https://uview-pro.anyup.cn/docs/components/radio.html
+ * @tutorial https://uview-pro.netlify.app/components/radio.html
  * @property {Boolean} disabled 是否禁用所有radio（默认false）
  * @property {String|Number} size 组件整体的大小，单位rpx（默认40）
  * @property {String} active-color 选中时的颜色，应用到所有子Radio组件（默认#2979ff）

package/components/u-rate/u-rate.vue

@@ -29,7 +29,7 @@ defineOptions({
 /**
  * rate 评分
  * @description 该组件一般用于满意度调查，星型评分的场景
- * @tutorial https://uview-pro.anyup.cn/docs/components/rate.html
+ * @tutorial https://uview-pro.netlify.app/components/rate.html
  * @property {String|Number} count 最多可选的星星数量（默认5）
  * @property {String|Number} current 默认选中的星星数量（默认0）
  * @property {Boolean} disabled 是否禁止用户操作（默认false）

package/components/u-read-more/u-read-more.vue

@@ -36,7 +36,7 @@ defineOptions({ name: 'u-read-more' });
 /**
  * readMore 阅读更多
  * @description 该组件一般用于内容较长，预先收起一部分，点击展开全部内容的场景。
- * @tutorial https://uview-pro.anyup.cn/docs/components/readMore.html
+ * @tutorial https://uview-pro.netlify.app/components/readMore.html
  * @property {String|Number} showHeight 内容超出此高度才会显示展开全文按钮，单位rpx（默认400）
  * @property {Boolean} toggle 展开后是否显示收起按钮（默认false）
  * @property {String} closeText 关闭时的提示文字（默认“展开阅读全文”）

package/components/u-row/u-row.vue

@@ -21,7 +21,7 @@ defineOptions({
 /**
  * row 行布局
  * @description 通过基础的 12 分栏，迅速简便地创建布局。
- * @tutorial https://uview-pro.anyup.cn/docs/components/layout.html#row-props
+ * @tutorial https://uview-pro.netlify.app/components/layout.html#row-props
  * @property {String|Number} gutter 栅格间隔，左右各为此值的一半，单位rpx（默认0）
  * @property {String} justify 水平排列方式(微信小程序暂不支持)默认（start(或flex-start)）
  * @property {String} align 垂直排列方式（默认center）

package/components/u-search/u-search.vue

@@ -58,7 +58,7 @@ defineOptions({ name: 'u-search' });
 /**
  * search 搜索框
  * @description 搜索组件，集成了常见搜索框所需功能，用户可以一键引入，开箱即用。
- * @tutorial https://uview-pro.anyup.cn/docs/components/search.html
+ * @tutorial https://uview-pro.netlify.app/components/search.html
  * @property {String} shape 搜索框形状，round-圆形，square-方形（默认round）
  * @property {String} bg-color 搜索框背景颜色（默认#f2f2f2）
  * @property {String} border-color 边框颜色，配置了颜色，才会有边框

package/components/u-section/u-section.vue

@@ -45,7 +45,7 @@ defineOptions({ name: 'u-section' });
 /**
  * section 查看更多
  * @description 该组件一般用于分类信息有很多，但是限于篇幅只能列出一部分，让用户通过"查看更多"获得更多信息的场景，实际效果见演示。
- * @tutorial https://uview-pro.anyup.cn/docs/components/section.html
+ * @tutorial https://uview-pro.netlify.app/components/section.html
  * @property {String} title 左边主标题
  * @property {String} subTitle 右边副标题（默认更多）
  * @property {Boolean} right 是否显示右边的内容（默认true）

package/components/u-skeleton/u-skeleton.vue

@@ -15,7 +15,7 @@ defineOptions({ name: 'u-skeleton' });
 /**
  * skeleton 骨架屏
  * @description 骨架屏一般用于页面在请求远程数据尚未完成时，页面用灰色块预显示本来的页面结构，给用户更好的体验。
- * @tutorial https://uview-pro.anyup.cn/docs/components/skeleton.html
+ * @tutorial https://uview-pro.netlify.app/components/skeleton.html
  * @property {String} elColor 骨架块状元素的背景颜色（默认#e5e5e5）
  * @property {String} bgColor 骨架组件背景颜色（默认#ffffff）
  * @property {Boolean} animation 骨架块是否显示动画效果（默认false）

package/components/u-steps/u-steps.vue

@@ -28,7 +28,7 @@ defineOptions({ name: 'u-steps' });
 /**
  * steps 步骤条
  * @description 该组件一般用于完成一个任务要分几个步骤，标识目前处于第几步的场景。
- * @tutorial https://uview-pro.anyup.cn/docs/components/steps.html
+ * @tutorial https://uview-pro.netlify.app/components/steps.html
  * @property {String} mode 设置模式（默认dot）
  * @property {Array<{name: string}>} list 数轴条数据，数组。具体见上方示例
  * @property {String} type type主题（默认primary）

package/components/u-sticky/u-sticky.vue

@@ -33,7 +33,7 @@ defineOptions({ name: 'u-sticky' });
 /**
  * sticky 吸顶
  * @description 该组件与CSS中position: sticky属性实现的效果一致，当组件达到预设的到顶部距离时， 就会固定在指定位置，组件位置大于预设的顶部距离时，会重新按照正常的布局排列。
- * @tutorial https://uview-pro.anyup.cn/docs/components/sticky.html
+ * @tutorial https://uview-pro.netlify.app/components/sticky.html
  * @property {String|Number} offsetTop 吸顶时与顶部的距离，单位rpx（默认0）
  * @property {String|Number} index 自定义标识，用于区分是哪一个组件
  * @property {Boolean} enable 是否开启吸顶功能（默认true）

package/components/u-subsection/u-subsection.vue

@@ -23,7 +23,7 @@ defineOptions({ name: 'u-subsection' });
 /**
  * subsection 分段器
  * @description 该分段器一般用于用户从几个选项中选择某一个的场景
- * @tutorial https://uview-pro.anyup.cn/docs/components/subsection.html
+ * @tutorial https://uview-pro.netlify.app/components/subsection.html
  * @property {Array} list 选项的数组，形式见上方"基本使用"
  * @property {String | Number} current 初始化时默认选中的选项索引值（默认0）
  * @property {String} activeColor 激活时的颜色，mode为subsection时固定为白色（默认#303133）

package/components/u-swipe-action/u-swipe-action.vue

@@ -32,7 +32,7 @@ defineOptions({ name: 'u-swipe-action' });
 /**
  * swipeAction 左滑单元格
  * @description 该组件一般用于左滑唤出操作菜单的场景，用的最多的是左滑删除操作。
- * @tutorial https://uview-pro.anyup.cn/docs/components/swipeAction.html
+ * @tutorial https://uview-pro.netlify.app/components/swipeAction.html
  * @property {String} bg-color 整个组件背景颜色（默认#ffffff）
  * @property {Array} options 数组形式，可以配置背景颜色和文字
  * @property {String|Number} index 标识符，点击时候用于区分点击了哪一个，用v-for循环时的index即可

package/components/u-swiper/u-swiper.vue

@@ -62,7 +62,7 @@ defineOptions({ name: 'u-swiper' });
 /**
  * swiper 轮播图
  * @description 该组件一般用于导航轮播，广告展示等场景,可开箱即用
- * @tutorial https://uview-pro.anyup.cn/docs/components/swiper.html
+ * @tutorial https://uview-pro.netlify.app/components/swiper.html
  * @property {Array} list 轮播图数据，见官网"基本使用"说明
  * @property {Boolean} title 是否显示标题文字，需要配合list参数，见官网说明（默认false）
  * @property {String} mode 指示器模式，见官网说明（默认round）

package/components/u-switch/u-switch.vue

@@ -23,7 +23,7 @@ defineOptions({
 /**
  * switch 开关选择器
  * @description 选择开关一般用于只有两个选择，且只能选其一的场景。
- * @tutorial https://uview-pro.anyup.cn/docs/components/switch.html
+ * @tutorial https://uview-pro.netlify.app/components/switch.html
  * @property {Boolean} loading 是否处于加载中（默认false）
  * @property {Boolean} disabled 是否禁用（默认false）
  * @property {String|Number} size 开关尺寸，单位rpx（默认50）

package/components/u-table/u-table.vue

@@ -12,7 +12,7 @@ defineOptions({ name: 'u-table' });
 /**
  * table 表格
  * @description 表格组件一般用于展示大量结构化数据的场景
- * @tutorial https://uview-pro.anyup.cn/docs/components/table.html
+ * @tutorial https://uview-pro.netlify.app/components/table.html
  * @property {String} border-color 表格边框的颜色（默认#e4e7ed）
  * @property {String} bg-color 表格的背景颜色（默认#ffffff）
  * @property {String} align 单元格的内容对齐方式，作用类似css的text-align（默认center）

package/components/u-tabs/u-tabs.vue

@@ -24,7 +24,7 @@ defineOptions({ name: 'u-tabs' });
 /**
  * tabs 标签
  * @description 该组件，是一个tabs标签组件，在标签多的时候，可以配置为左右滑动，标签少的时候，可以禁止滑动。 该组件的一个特点是配置为滚动模式时，激活的tab会自动移动到组件的中间位置。
- * @tutorial https://uview-pro.anyup.cn/docs/components/tabs.html
+ * @tutorial https://uview-pro.netlify.app/components/tabs.html
  * @property {Boolean} is-scroll tabs是否可以左右拖动（默认true）
  * @property {Array} list 标签数组，元素为对象，如[{name: '推荐'}]
  * @property {String|Number} current 指定哪个tab为激活状态（默认0）

package/components/u-tabs-swiper/u-tabs-swiper.vue

@@ -21,7 +21,7 @@ defineOptions({ name: 'u-tabs-swiper' });
 /**
  * tabsSwiper 全屏选项卡
  * @description 该组件内部实现主要依托于uniapp的scroll-view和swiper组件，主要特色是切换过程中，tabsSwiper文字的颜色可以渐变，底部滑块可以 跟随式滑动，活动tab滚动居中等。应用场景可以用于需要左右切换页面，比如商城的订单中心(待收货-待付款-待评价-已退货)等应用场景。
- * @tutorial https://uview-pro.anyup.cn/docs/components/tabsSwiper.html
+ * @tutorial https://uview-pro.netlify.app/components/tabsSwiper.html
  * @property {Boolean} is-scroll tabs是否可以左右拖动（默认true）
  * @property {Array} list 标签数组，元素为对象，如[{name: '推荐'}]
  * @property {String|Number} current 指定哪个tab为激活状态（默认0）

package/components/u-tag/u-tag.vue

@@ -23,7 +23,7 @@ defineOptions({
 /**
  * tag 提示
  * @description 该组件一般用于标记和选择
- * @tutorial https://uview-pro.anyup.cn/docs/components/tag.html
+ * @tutorial https://uview-pro.netlify.app/components/tag.html
  * @property {String} type 主题类型（默认primary）
  * @property {String} size 标签大小（默认default）
  * @property {String} shape 标签形状（默认square）

package/components/u-td/u-td.vue

@@ -13,7 +13,7 @@ defineOptions({ name: 'u-td' });
 /**
  * td td单元格
  * @description 表格组件一般用于展示大量结构化数据的场景（搭配u-table使用）
- * @tutorial https://uview-pro.anyup.cn/docs/components/table.html#td-props
+ * @tutorial https://uview-pro.netlify.app/components/table.html#td-props
  * @property {String | Number} width 单元格宽度百分比或者具体带单位的值，如30%， 200rpx等，一般使用百分比，单元格宽度默认为均分tr的长度（默认auto）
  * @example <u-td>二年级</u-td>
  */

package/components/u-th/u-th.vue

@@ -13,7 +13,7 @@ defineOptions({ name: 'u-th' });
 /**
  * th th单元格
  * @description 表格组件一般用于展示大量结构化数据的场景（搭配u-table使用）
- * @tutorial https://uview-pro.anyup.cn/docs/components/table.html#td-props
+ * @tutorial https://uview-pro.netlify.app/components/table.html#td-props
  * @property {String | Number} width 标题单元格宽度百分比或者具体带单位的值，如30%，200rpx等，一般使用百分比，单元格宽度默认为均分tr的长度
  * @example 暂无示例
  */

package/components/u-time-line/u-time-line.vue

@@ -10,7 +10,7 @@ defineOptions({ name: 'u-time-line' });
 /**
  * timeLine 时间轴
  * @description 时间轴组件一般用于物流信息展示，各种跟时间相关的记录等场景。
- * @tutorial https://uview-pro.anyup.cn/docs/components/timeLine.html
+ * @tutorial https://uview-pro.netlify.app/components/timeLine.html
  * @example <u-time-line></u-time-line>
  */
 

package/components/u-time-line-item/u-time-line-item.vue

@@ -17,7 +17,7 @@ defineOptions({ name: 'u-time-line-item' });
 /**
  * timeLineItem 时间轴Item
  * @description 时间轴组件一般用于物流信息展示，各种跟时间相关的记录等场景。(搭配u-time-line使用)
- * @tutorial https://uview-pro.anyup.cn/docs/components/timeLine.html
+ * @tutorial https://uview-pro.netlify.app/components/timeLine.html
  * @property {String} bg-color 左边节点的背景颜色，一般通过slot内容自定义背景颜色即可（默认#ffffff）
  * @property {String | Number} node-top 节点左边图标绝对定位的top值，单位rpx
  * @example <u-time-line-item node-top="2">...</u-time-line-item>

package/components/u-toast/u-toast.vue

@@ -25,7 +25,7 @@ defineOptions({
 /**
  * toast 消息提示
  * @description 此组件表现形式类似uni的uni.showToastAPI，但也有不同的地方。
- * @tutorial https://uview-pro.anyup.cn/docs/components/toast.html
+ * @tutorial https://uview-pro.netlify.app/components/toast.html
  * @property {String|Number} z-index toast展示时的z-index值
  * @event {Function} show 显示toast，如需一进入页面就显示toast，请在onReady生命周期调用
  * @example <u-toast ref="uToast" />

package/components/u-top-tips/u-top-tips.vue

@@ -11,7 +11,7 @@ defineOptions({ name: 'u-top-tips' });
 /**
  * topTips 顶部提示
  * @description 该组件一般用于页面顶部向下滑出一个提示，尔后自动收起的场景。
- * @tutorial https://uview-pro.anyup.cn/docs/components/topTips.html
+ * @tutorial https://uview-pro.netlify.app/components/topTips.html
  * @property {String|Number} navbarHeight 导航栏高度(包含状态栏高度在内)，单位PX
  * @property {String|Number} zIndex z-index值（默认975）
  * @example <u-top-tips ref="uTips"></u-top-tips>

package/components/u-tr/u-tr.vue

@@ -10,7 +10,7 @@ defineOptions({ name: 'u-tr' });
 /**
  * tr 表格行标签
  * @description 表格组件一般用于展示大量结构化数据的场景（搭配<u-table>使用）
- * @tutorial https://uview-pro.anyup.cn/docs/components/table.html
+ * @tutorial https://uview-pro.netlify.app/components/table.html
  * @example <u-tr></u-tr>
  */
 </script>

package/components/u-upload/u-upload.vue

@@ -61,7 +61,7 @@ defineOptions({
 /**
  * upload 图片上传
  * @description 该组件用于上传图片场景
- * @tutorial https://uview-pro.anyup.cn/docs/components/upload.html
+ * @tutorial https://uview-pro.netlify.app/components/upload.html
  * @property {String} action 服务器上传地址
  * @property {String Number} max-count 最大选择图片的数量（默认99）
  * @property {Boolean} custom-btn 如果需要自定义选择图片的按钮，设置为true（默认false）
@@ -95,6 +95,8 @@ defineOptions({
  * @event {Function} on-progress 图片上传过程中的进度变化过程触发
  * @event {Function} on-uploaded 所有图片上传完毕触发
  * @event {Function} on-choose-complete 每次选择图片后触发，只是让外部可以得知每次选择后，内部的文件列表
+ * @event {Function} on-choose-fail 文件选择失败时触发
+ * @event {Function} on-list-change 文件列表发生变化时触发
  * @example <u-upload :action="action" :file-list="fileList" ></u-upload>
  */
 
@@ -193,13 +195,17 @@ watch(
             !tmp && lists.value.push({ url: value.url, error: false, progress: 100 });
         });
     },
-    { immediate: true }
+    { immediate: true, deep: true }
 );
 
 // 监听 lists 变化，发出事件
-watch(lists, n => {
-    emit('on-list-change', n, props.index);
-});
+watch(
+    lists,
+    n => {
+        emit('on-list-change', n, props.index);
+    },
+    { deep: true }
+);
 
 /**
  * 清除列表
@@ -502,7 +508,7 @@ function checkFileExt(file: any) {
     return noArrowExt;
 }
 
-defineExpose({ clear, reUpload, selectFile, upload, retry, remove, doPreviewImage });
+defineExpose({ clear, reUpload, selectFile, upload, retry, remove, doPreviewImage, lists });
 </script>
 
 <style lang="scss" scoped>

package/components/u-verification-code/u-verification-code.vue

@@ -12,7 +12,7 @@ defineOptions({ name: 'u-verification-code' });
 /**
  * verificationCode 验证码输入框
  * @description 考虑到用户实际发送验证码的场景，可能是一个按钮，也可能是一段文字，提示语各有不同，所以本组件不提供界面显示，只提供提示语，由用户将提示语嵌入到具体的场景
- * @tutorial https://uview-pro.anyup.cn/docs/components/verificationCode.html
+ * @tutorial https://uview-pro.netlify.app/components/verificationCode.html
  * @property {Number|String} seconds 倒计时所需的秒数（默认60）
  * @property {String} startText 开始前的提示语，见官网说明（默认获取验证码）
  * @property {String} changeText 倒计时期间的提示语，必须带有字母"x"，见官网说明（默认X秒重新获取）

package/components/u-waterfall/u-waterfall.vue

@@ -17,7 +17,7 @@ defineOptions({ name: 'u-waterfall' });
 /**
  * waterfall 瀑布流
  * @description 这是一个瀑布流形式的组件，内容分为左右两列，结合uView的懒加载组件效果更佳。相较于某些只是奇偶数左右分别，或者没有利用vue作用域插槽的做法，uView的瀑布流实现了真正的 组件化，搭配LazyLoad 懒加载和loadMore 加载更多组件，让您开箱即用，眼前一亮。
- * @tutorial https://uview-pro.anyup.cn/docs/components/waterfall.html
+ * @tutorial https://uview-pro.netlify.app/components/waterfall.html
  * @property {Array} flow-list 用于渲染的数据
  * @property {String | Number} add-time 单条数据添加到队列的时间间隔，单位ms，见上方注意事项说明（默认200）
  * @example <u-waterfall :flowList="flowList"></u-waterfall>

package/libs/function/md5.ts

@@ -394,4 +394,6 @@ function md5(str: string): string {
   return hex_md5(str);
 }
 
-export default md5;
+export default {
+  md5,
+};

package/libs/request/auto-http.ts

@@ -0,0 +1,76 @@
+import deepMerge from '../function/deepMerge';
+
+export function isFunction(f: any): boolean {
+    return typeof f === 'function';
+}
+
+export function isPromise(p: any): boolean {
+    return !!(p && p.then && p.catch);
+}
+
+export function isArray(arr: any) {
+    return Object.prototype.toString.call(arr) === '[object Array]';
+}
+
+/**
+ * 构建基础类
+ */
+class Builder<T> {
+    instance: any;
+
+    constructor(instance: any) {
+        this.instance = instance;
+    }
+    /**
+     *
+     * @param urlConfig url 配置表
+     * @param extra 其他请求方法对象
+     * @returns Object
+     */
+    dispatch(urlConfig: Record<string, any>, extra: Record<string, any> = {}): Record<string, any> {
+        const builder: Record<string, any> = {};
+        // 创建 API
+        Object.keys(urlConfig).forEach(name => {
+            builder[name] = this.use.bind(this, urlConfig[name]);
+        });
+        return { ...builder, ...extra };
+    }
+    /**
+     * 发送请求
+     * @param {*} urlConfig : url 配置表
+     * @demo urlConfig = { login: { url: '/user/login', method: 'GET', loading: true } }
+     * @param {*} config : 开放配置，用户主动配置的
+     * @demo api.login({ params: { username: "admin" } })
+     * @returns Promise
+     */
+    use(urlConfig: Record<string, any>, config: Record<string, any> = {}): Promise<T> {
+        // 请求地址
+        let url = config?.url ?? urlConfig.url;
+        // 兼容 restful url，如果是使用url为function，则为restful格式
+        if (config.url && isFunction(config.url)) {
+            url = `${urlConfig.url}${config.url()}`;
+        }
+        // 请求类型，get,post,put,delete
+        const method = config?.method ?? urlConfig?.method ?? 'GET';
+        // 如果有自定义的工厂函数基础类
+        const options = { ...deepMerge(urlConfig, config), url, method };
+        if (isFunction(this.instance) || isPromise(this.instance)) {
+            return this.instance(options);
+        }
+        // 如果是使用的 instance
+        // 默认的请求基础类
+        return this.instance.request(options);
+    }
+}
+
+/**
+ * Http 基础类
+ */
+class AutoHttp {
+    static get Builder() {
+        return Builder;
+    }
+    constructor() {}
+}
+
+export { AutoHttp };

package/libs/request/uni-http.md

@@ -0,0 +1,156 @@
+# uni-http 使用说明（useHttp hooks 版）
+
+> 本文档适用于 uView Pro 3.x 及以上版本，推荐使用 hooks 方式引入 Http 请求库。
+
+## 目录
+- [简介](#简介)
+- [快速开始](#快速开始)
+- [类型定义](#类型定义)
+- [拦截器用法](#拦截器用法)
+- [常见用例](#常见用例)
+- [常见问题](#常见问题)
+- [类型提示与 TS 支持](#类型提示与 TS 支持)
+- [FAQ](#faq)
+
+---
+
+## 简介
+
+`uni-http` 是基于 Promise 封装的 uni-app HTTP 请求库，支持全局配置、请求/响应拦截、类型安全、hooks 化调用，适配多端。推荐通过 `useHttp` hooks 工厂函数创建实例，支持全局单例和按需实例化。
+
+## 快速开始
+
+### 1. 引入 useHttp
+```ts
+import useHttp from '@/uni_modules/uview-pro/libs/request/uni-http';
+```
+
+### 2. 创建 http 实例
+```ts
+const http = useHttp({
+  baseURL: 'https://api.example.com',
+  timeout: 10000,
+  header: { 'Content-Type': 'application/json' }
+});
+```
+
+### 3. 发起请求
+```ts
+// GET
+http.get('/user/info', { params: { id: 1 } })
+  .then(res => { /* ... */ })
+  .catch(err => { /* ... */ });
+
+// POST
+http.post('/user/update', { name: '张三' })
+  .then(res => { /* ... */ });
+```
+
+## 类型定义
+
+```ts
+interface HttpRequestConfig {
+  baseURL?: string;
+  timeout?: number;
+  header?: Record<string, any>;
+  [key: string]: any;
+}
+
+interface HttpResponse<T = any> {
+  code: number;
+  data: T;
+  msg: string;
+  [key: string]: any;
+}
+
+interface Http {
+  get<T = any>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+  post<T = any>(url: string, data?: any, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+  put<T = any>(url: string, data?: any, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+  delete<T = any>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+  // ... 其他方法
+  setRequestInterceptor(fn: (config: HttpRequestConfig) => HttpRequestConfig | Promise<HttpRequestConfig>): void;
+  setResponseInterceptor(fn: (response: HttpResponse) => HttpResponse | Promise<HttpResponse>): void;
+}
+```
+
+## 拦截器用法
+
+### 请求拦截器
+```ts
+http.setRequestInterceptor(config => {
+  // 可统一添加 token、日志等
+  config.header = config.header || {};
+  config.header.Authorization = 'Bearer ' + uni.getStorageSync('token');
+  return config;
+});
+```
+
+### 响应拦截器
+```ts
+http.setResponseInterceptor(response => {
+  if (response.code !== 0) {
+    uni.showToast({ title: response.msg || '请求失败', icon: 'none' });
+  }
+  return response;
+});
+```
+
+## 常见用例
+
+### 1. 全局单例
+```ts
+// src/common/http.ts
+import useHttp from '@/uni_modules/uview-pro/libs/request/uni-http';
+const http = useHttp({ baseURL: 'https://api.example.com' });
+export default http;
+```
+
+### 2. 组件内按需实例化
+```ts
+import useHttp from '@/uni_modules/uview-pro/libs/request/uni-http';
+const http = useHttp();
+```
+
+### 3. 类型推断
+```ts
+interface UserInfo { id: number; name: string; }
+const res = await http.get<UserInfo>('/user/info');
+console.log(res.data.id);
+```
+
+### 4. 错误处理
+```ts
+http.get('/error/api').catch(err => {
+  uni.showToast({ title: err.message, icon: 'none' });
+});
+```
+
+## 常见问题
+
+- **Q: 如何全局配置 baseURL、header？**
+  A: 在 useHttp({ baseURL, header }) 传入即可。
+- **Q: 如何自定义拦截器？**
+  A: 通过 setRequestInterceptor/setResponseInterceptor。
+- **Q: 支持多实例吗？**
+  A: 支持，useHttp 可多次调用。
+- **Q: 支持类型推断吗？**
+  A: 支持，泛型参数自动推断返回数据类型。
+
+## 类型提示与 TS 支持
+
+- 完全 TypeScript 支持，类型自动推断。
+- 推荐在 `tsconfig.json` 中包含 `uni-http.ts` 路径。
+
+## FAQ
+
+- **Q: 还能用 new Http() 吗？**
+  A: 不推荐，已废弃。请统一使用 useHttp。
+- **Q: 如何清理拦截器？**
+  A: 暂不支持移除，建议重新实例化。
+- **Q: 支持 uni.uploadFile、downloadFile 吗？**
+  A: 暂未内置，可自行扩展。
+
+---
+
+如有更多问题，欢迎提 Issue 或 PR。