更新记录

1.0.0（2026-08-31） 下载此版本

无

平台兼容性

uni-app(5.21)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
× √ √ √ √ - √ √ √
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
√ √ - - - - - - - - - -

其他

多语言 暗黑模式 宽屏模式
× √ ×

yxxin-uniappdemo

一个开箱即用的 uni-app (Vue 3 + TypeScript) 项目模板，内置登录、忘记密码、Tab 主导航、错误页等标准功能样板，全部基于 yixin-ui 组件库，可跨 H5 / 微信 / 支付宝 / 抖音小程序 / Android App / iOS App 六端运行。

想基于本模板创建新项目？看 docs/快速开始.md。 本模板的 AI 协作规范见 AGENTS.md 与 .agents/。

技术栈与定位

  • 框架：uni-app + Vue 3 + TypeScript
  • 组件库：yixin-ui（主题 / 国际化 / 网络 / 设备 / 存储 / 工具 + 57 个组件）
  • 设计规范：壹新视觉规范（MD3 字阶层级 + 主题令牌 + 哀悼模式）
  • 多语言：简体中文 / 繁体中文 / English
  • 通信：RPC-POST + 会话（Cookie）管理

写代码前必看（改错必告警）：样式请遵守 视觉规范——文字大小只能用 15 级令牌 var(--yx-*-size)、颜色只能用 var(--yx-color-*)，禁止裸值 font-size/color；且不要对 input/textarea 设置 box-sizing: border-box（H5 会导致无法输入）。页面可见文案必须写入 locale/*.ts 三语包用 t() 取，禁止在模板硬编码。

内置样板

能力 说明
单页主导航 单一常驻容器 + v-show 切换 7 个 Tab，含 AI 对话面板
登录 / 忘记密码 YxInput + 短信验证码 + 密码登录，RPC-POST 对接业务后端
错误页 冷启动身份认证失败时的锁定页与重试
主题系统 深浅色跟随系统、主题色预设/自定义、字号缩放、哀悼模式
多语言 三语即时切换、持久化

目录一览

AGENTS.md                  # 给 AI：模板协作规范（摘要）
.agents/                   # 给 AI：模板组成与各功能固定写法
docs/                      # 给你：使用说明（如何在模板上建项目、怎么跑）
uni_modules/yixin-ui/       # yixin-ui 组件库（独立插件，发布到插件市场后模板自动依赖）
package.json               # uni_modules 项目模板声明（templatetype + 依赖 yixin-ui）
navigation/main.ts          # 主导航配置
services/                   # 网络请求、请求载荷、运行时身份
pages/                      # 功能页面（主导航/Tab/登录/忘记密码/错误页）
locale/                     # 三语语言包
config.ts                   # 宿主配置（后端地址等，默认空配置）
manifest.json               # 发布用干净 manifest（不含任何 appid）
manifest.local.json         # 本地开发用真实 appid 副本（gitignored），供你本地直接运行各端

发布与本地运行

本项目即要发布的 插件市场项目模板，同时本身是可直接运行项目（uni_modules/yixin-ui/ 既是模板组件来源、又可改码运行）。

  • 本地运行各端：manifest.json 是发布用的干净版（无 appid）。本地开发请先把真实 appid 的 manifest.local.json 覆盖回 manifest.json，再运行微信/抖音/App 等平台。网络线路同理：向宿主获取后填入 config.ts（后端地址）。
  • 发布 yixin-ui：对 uni_modules/yixin-ui 点右键「发布到插件市场」（分类：前端组件，插件ID 为 yixin-ui），模板才能按依赖自动下载它。
  • 发布模板：对本项目根目录 package.json 点右键「发布到插件市场」，分类选 uni-app前端项目模板，上传完整示例工程。发布前确认 manifest.json 无任何 appid，且 config.ts 不含真实域名。

文档导航

License / 免费开放

本项目永久免费开放源码，采用 MIT License（uni_modules/yixin-ui/ 同款）。无需付费即可通过插件市场下载模板与组件库源码、用于商业项目；使用、复制、修改、分发、再授权均受 MIT 保护。详情见根目录 LICENSE 与 uni_modules/yixin-ui/LICENSE.md。

隐私、权限声明

1. 本插件需要申请的系统权限列表：

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

插件不采集任何数据

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

许可协议

MIT License

Copyright (c) 2024 yixin-ui contributors

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

评论列表 撰写评论 向官方投诉

暂无用户评论。