更新记录

1.2.10（2026-03-31） 下载此版本

文档

• readme.md：预览区 H5 / 微信小程序 演示码改为 COS 等 HTTPS 直链，并说明 公有读、防盗链 与裂图排查；「图标字体（m-icon / iconfont）」 接入说明（static/iconfont、loadFontFace、mp.scss、name / size / color）。文首 「## 文档」 随版本保持索引更新。

修复

• m-login.uvue：getPhone 内补充 getHostProjectConfig()，修复 cfg 未定义（微信取号成功回调闭包作用域）。

更早版本见下文 §3 已发布版本（含 1.2.9 · mms-api-unix 示例对接等）。

mUnix · uni-app x 组件库

mUnix 更新日志

本文档位于 uni_modules/m-unix 根目录（与 package.json、readme.md、logo.png 同级），为组件库权威变更记录。当前版本以 package.json 的 version 为准。

[Unreleased]

发版前：将本节并入 §3 新版本章节，并同步提升 package.json 的 version。

1.2.9（2026-03-31） 下载此版本

说明（示例工程 · 对接 mms-api-unix）

• 仓库内 docs/mms-api-unix-接口适配.md：与主仓 mms-api-unix 的路径、模块前缀约定说明。
• common/config.ts：默认 baseUrl 指向演示 https://demo.mmsadmin.cn/prod-api（无尾斜杠）；api.login → /api/member/v1/token-login、code-open-id-login、code-phone-register-or-login；api.update.checkUpdate → /api/app/v1/upgrade-check；api.upload.image → /api/base/v1/uploads（multipart 字段 file，与 m-upload / Upload.uts 默认一致）。
• common/api/mallApi.uts：广告、省市区、短信、会员登录/地址/资料、文章列表/详情等改为 /api/{模块}/v1/...；checkUpdate 携带 Query type（APP-IOS 为 1，否则为 2），并保留 currentVersionCode 便于网关兼容；tokenLogin / weixinLogin 使用 *`config.api.login.`。藏品 / 订单 / 合同等后端未在 mms-api-unix** 落地的接口保留旧路径并注释，需自建网关或微服务。
• common/api/auth.uts：示例请求改为 *`/api/member/v1/**、**/api/base/v1/sms-code`**。
• config.uts（包内）：apiDevelopmentBase / apiProductionBase 默认值与上述演示根一致（未注入宿主时 getMUiConfig 兜底）。

文档

• readme.md：common/config 说明处补充 mms-api-unix 适配文档索引；预览区 H5 / 小程序 演示码使用 uni_modules/m-unix/static/ 资源与统一尺寸展示。
• 工具页：pages/tools/tools 在 <script setup> 中轻提示改为 Ut.msg，避免 this.$m 不可用报错。

1.2.8（2026-03-31） 下载此版本

Breaking（接入注意）

• index.js：app.use(mUnix) 仅将工具挂到 Vue.config.globalProperties.$m（组件内 this.$m / 模板 $m），不再设置 uni.$m。mount$m() 改为空实现并标记废弃；若旧代码在非组件处使用 uni.$m，请改为 import 具体工具，或在可用上下文中取得 getCurrentInstance() 再访问 globalProperties.$m（视运行环境而定）。

文档

• readme.md：快速上手与 app.use 说明与上述行为一致。

平台兼容性

uni-app x(4.87)

其他

mmsUnix

面向 uni-app x 的基础 UI 与工具库

说明

mmsUnix（包目录 uni_modules/m-unix，插件 ID m-unix）是面向 uni-app x 的自研 UI 方案：脚本为 UTS，页面与组件为 uvue，提供 *`m-组件**、**m-tools工具**与 **mUi` 主题配置，可在 App / 微信小程序 / H5** 等端按需接入。

版本号、变更记录与联系方式以包内 package.json、changelog.md 为准，与 DCloud 插件市场 展示同步维护。

特点

• 专为 uni-app x：组件与工具均以 .uvue + UTS 编写，类型约束清晰。
• 独立命名：组件统一 m- 前缀，避免与生态其它库冲突。
• 按需使用：支持 easycom 自动引入，也可单独 import 组件或 libs。
• 主题可配：通过 mUi / setMUiConfig 与业务侧配置对齐主色与资源。
• 多端适配：安全区与常见端差异已在组件侧考虑（具体以各组件说明为准）。

文档

• 在线文档（站点）：https://mmsadmin.cn/mms-unix/README.html
• 更新日志（权威）：本目录 changelog.md（与 package.json 的 version 一致）
• 源码与 Issue：https://gitee.com/mmsAdmin/mms-unix

链接

• DCloud 插件市场 · m-unix（亦支持 ?id=m-unix）
• 组件说明站点首页
• Gitee 开源仓库
• 问题反馈（Gitee Issues）

预览

在线文档中含组件说明与示例要点；本仓库示例工程 pages_demo 下为各组件演示页，可在 HBuilderX 中运行目标端查看效果。

线上演示（H5 / 微信小程序）

H5 与 unix.mmsadmin.cn 线上工程对齐；小程序 官方太阳码与说明见 在线文档 · 在线演示。
下列二维码使用公网 HTTPS 直链（示例为腾讯云 COS；与下方预览图所用 OSS 同理），在 GitHub / Gitee / 插件市场等查看 README 时一般均可显示；须保证 对象公有读，且 COS 防盗链 未拦截对应站点。

H5 unix.mmsadmin.cn

微信小程序 太阳码见 在线文档；亦可自托管 static/*.jpg

若图片仍不显示，请检查 COS 权限与防盗链，或直接点击表格内 链接 打开 H5 / 在线文档；本地仓库也可将二维码放入 uni_modules/m-unix/static/ 使用相对路径（仅在逐文件路径正确时有效）。

以下为运行效果示意（多端以实际为准）：

预览 1	预览 2

安装

uni-app 插件市场链接 —— https://ext.dcloud.net.cn/plugin?name=m-unix

通过 HBuilderX 导入插件或使用已有工程：将 uni_modules/m-unix 置于项目内，HBuilderX 会自动识别 uni_modules 规范插件（建议使用 3.1.0 及以上版本 HBuilderX）。

快速上手

1. 在 pages.json 中配置 easycom（规则见下「easycom」；与示例工程一致时可复制即用）。
2. 在 main.uts 中用 createSSRApp 创建应用并执行 app.use(mUnix)（会注册全局组件并通过 Vue.config.globalProperties.$m 挂载，组件内使用 this.$m，一般不必再调 mount$m()）。
3. 在 App.uvue 中 @import index.scss（主题与工具类样式，建议保留）。

详见下文「使用方法」。

使用方法

easycom（pages.json）

在 pages.json 根级增加 easycom，使 m-组件名 无需手写 import 即可解析到包内路径：

{
  "easycom": {
    "autoscan": true,
    "custom": {
      "^m-(.*)": "@/uni_modules/m-unix/components/m-$1/m-$1.uvue"
    }
  }
}

配置后模板中可直接使用：

<m-button type="primary">确定</m-button>

全局安装（main.uts）

uni-app x 入口需使用 createSSRApp（来自 vue），并 export function createApp() 返回 { app }，与框架约定一致：

import App from './App.uvue'
import { createSSRApp } from 'vue'
import mUnix from '@/uni_modules/m-unix'

export function createApp() {
  const app = createSSRApp(App)
  app.use(mUnix)
  return {
    app
  }
}

说明：

• app.use(mUnix) 会执行包内 install：批量注册 *`m-** 全局组件，并将工具挂到 **Vue.config.globalProperties.$m**（**this.$m** / 模板 **$m**）。**不**再写入 **uni.$m`**。
• mUnix.mount$m() 已废弃（空实现，仅为兼容旧代码路径）；请始终使用 app.use(mUnix)。

可选：多语言（initI18n）

若使用示例工程中的 initI18n()，需在 main.uts 于创建应用前调用，且项目中存在 locale/index.uts 所依赖的 *`@/locale/.json** 等资源（路径以你工程为准）。不使用 **t()`** / 内置文案时可省略本步。

全局样式（App.uvue）

在应用根组件样式中引入（与示例工程一致）：

@import '@/uni_modules/m-unix/index.scss';

图标字体（m-icon / iconfont）

m-icon 与部分组件（如 m-empty 默认空状态图标）使用 font-family: "iconfont" 的 TTF 字库。接入时除引入 index.scss（已包含 .iconfont 基础样式）外，还需保证工程内存在字体文件，并按端加载。

1. 放置字体文件

将 iconfont.ttf 放到宿主工程 static/iconfont/iconfont.ttf（路径固定，与样式中的 url("/static/iconfont/iconfont.ttf") 一致）。字体文件须与包内 m-icon 中 getIconChar 的 Unicode 映射一致；若使用自建 iconfont，需同步维护映射或替换字库后更新 components/m-icon/m-icon.uvue。

2. App / H5：启动时 loadFontFace

小程序下 uni.loadFontFace 对 /static 等地址限制较多，包内已通过 libs/css/mp.scss 的 @font-face 引用同一 TTF，一般无需在 App.uvue 再加载。
非小程序端请在 App.uvue 的 onLaunch（或等价入口）中调用 uni.loadFontFace，并与 #ifndef MP 条件编译配合，例如：

onLaunch(() => {
  // #ifndef MP
  uni.loadFontFace({
    family: 'iconfont',
    source: 'url("/static/iconfont/iconfont.ttf")',
    success: () => {
      console.log('图标字体加载成功')
    },
    fail: (err) => {
      console.log('图标字体加载失败', err)
    }
  })
  // #endif
})

3. 页面中使用

在已配置 easycom 的前提下，直接使用 m-icon，name 为字库中已映射的名称（部分名称含别名，如 person 与 user 等价）：

<m-icon name="search" color="#333333" size="20"></m-icon>

可用名称清单可参考本仓库 pages_demo/icon 演示页，或查看 components/m-icon/m-icon.uvue 内 getIconChar 映射。

按需引入组件

仅使用个别组件时，可直接按路径引用（easycom 与按需二选一即可，勿重复注册）：

import MButton from '@/uni_modules/m-unix/components/m-button/m-button.uvue'

按需引入工具（libs / m-tools）

常用工具在 libs/utils.uts；网络请求在 components/m-tools/Request.uts（无 libs/request.uts 路径）：

import { formatDate, debounce } from '@/uni_modules/m-unix/libs/utils.uts'
import { request, http } from '@/uni_modules/m-unix/components/m-tools/Request.uts'

业务配置：@/common/config（可选）

工具层（Request.uts、Upload.uts、Storage.uts、Auth.uts、config.uts / mUi）以及 m-login、m-upload、m-update（版本号）等，统一通过包内 components/m-tools/ProjectConfig.uts 的 getHostProjectConfig() 读取配置。

• 不配 common/config：不注入即可；库内带有安全默认值（例如 baseUrl、各 API 路径可为空），工程可正常编译，仅实际发请求 / 自动上传时需自行传完整 URL 或运行时调用 injectMUnixHostProjectConfig。
• 要配 common/config：在业务工程中建 common/config.ts（或 .uts），导出与下文「字段约定」一致的对象 config，并在 任意 import '@/uni_modules/m-unix'（或会间接加载上述工具）之前完成 注入。

1. 入口注入（必须早于 m-unix）

在 main.uts 最顶部先执行注入，再 import mUnix。推荐单独放一个文件（与本仓库示例一致）：

inject-m-unix-host.uts（路径可自定，勿放进 uni_modules 内）

import { config } from '@/common/config'
import { injectMUnixHostProjectConfig } from '@/uni_modules/m-unix/components/m-tools/ProjectConfig.uts'

injectMUnixHostProjectConfig(config)

main.uts

import './inject-m-unix-host.uts'
import App from './App.uvue'
import { createSSRApp } from 'vue'
import mUnix from '@/uni_modules/m-unix'

export function createApp() {
  const app = createSSRApp(App)
  app.use(mUnix)
  return { app }
}

也可从插件主入口按需引用：injectMUnixHostProjectConfig、getHostProjectConfig、clearMUnixHostProjectConfig 已从 @/uni_modules/m-unix（index.js）再导出。

2. common/config 导出对象字段约定

与 ProjectConfig.uts 中 MUnixHostProjectConfig / injectMUnixHostProjectConfig 可合并字段对齐即可；以下为常用业务侧结构说明（未列字段可省略，走库内默认）。

业务侧完整 TypeScript 示例可参考开源示例工程中的 common/config.ts（export const config）。若对接主仓 mms-api-unix，*`api.路径与 Query/Body** 约定见工程内 **docs/mms-api-unix-接口适配.md`**。

3. 运行时覆盖 / 调试

• injectMUnixHostProjectConfig(obj)：将传入对象与库内默认合并后作为当前生效配置；再次调用会以新入参重新合并（后一次覆盖前一次的注入结果，适合切换环境）。
• clearMUnixHostProjectConfig()：清空注入，恢复库内默认。
• getProjectConfigInfo()（Ut.uts）：读取当前 configInfo，区别于 $m.configInfo()（与 getMUiConfig() 对齐的展示用对象）。

4. 包内源码约定（自检）

uni_modules/m-unix 下 .uts、.uvue、index.js 的脚本中不包含 import '@/common/config'、import '@/common/api/...'（含 mallApi）。业务接口与全局 config 仅在宿主工程中实现，通过 injectMUnixHostProjectConfig 或组件 props（例如 m-update 的 check-update-fn）接入。

若使用 main.uts 中的 initI18n()，locale/index.uts 会 import '@/locale/zh-Hans.json' 等——需在宿主项目 locale/ 下提供对应 JSON，与 common/config 无关。

组件列表

以下与 uni_modules/m-unix/components 下 *`m-组件目录**一致（按功能归类，便于检索）。**props / 事件 / 平台差异** 以 [在线文档](https://mmsadmin.cn/m-unix/README.html) 与源码注释为准；**changelog.md`** 记录版本级变更。

布局与结构

导航与路由辅助

表单与输入

展示与信息

反馈与弹层

业务与扩展

工具库（非 m-* 标签，随包或按需 import）

版权信息

mmsUnix（m-unix） 遵循 MIT 开源协议：可自由用于商业或个人项目，保留许可证声明即可。

出品：陕西品创网络