mirror of
https://github.com/ialley-workshop-open/uni-halo.git
synced 2026-09-11 16:00:44 +08:00
小莫唐尼
d528d214b5
1. 调整全局默认卡片样式为image_top，更新各页面默认布局配置 2. 给文章卡片添加variant属性适配双列/单列布局 3. 优化文章内容区域文字样式与评论列表空状态 4. 简化快捷导航组件代码，移除冗余样式与多余props 5. 优化markdown渲染配置与评论头像空格格式
unibest · Hermes 规范
Hermes = 项目的信使:把工程规范传递给每一位开发者(和 AI)。
基于 unibest 4.4.1(uni-app + Vue3 + TS + Vite5 + UnoCSS)的实际配置提炼。
三条铁律
- 生成物不手改:
src/pages.json、src/manifest.json、src/types/*.d.ts全部由*.config.ts生成,手改会在下次构建被覆盖 - 平台差异只用条件编译:
#ifdef H5 / #ifdef MP-WEIXIN / #ifdef APP-PLUS,编译期能确定的不留到运行时 - UI 优先原子类:先 UnoCSS 原子类,再考虑自定义 CSS
文档索引
| 文件 | 内容 |
|---|---|
| architecture.md | 架构规范：事实源与生成物、平台接缝、校验边界、目录分层 |
| conventions.md | 代码规范：命名、SFC 结构、TS、状态、提交与验证命令 |
| platforms.md | 平台适配手册：差异决策树、条件编译速查、本项目差异点表、多端地址 |
| api.md | 请求层规范：分层、httpGet/Post 用法、错误四分类、401 双 token 策略 |
| preferences.md | 偏好设置：两层结构、按页面分组的布局偏好、后端 getConfigs 字段映射 |
| sop-new-page.md | 新页面/组件/分包/tabbar/hooks SOP 与验证清单 |
| performance.md | 性能与分包：主包体积、内置优化表、包体积检查、编码侧规则 |
| release.md | 发布流程：upload:mp 全流程、changesets、uvm 升级、环境切换、合入门禁 |
常用命令
pnpm dev # H5 开发
pnpm dev:mp # 微信小程序开发
pnpm dev:app # APP 开发
pnpm build:mp # 微信小程序生产构建
pnpm type-check # vue-tsc 类型检查(合入前必过)
pnpm lint:fix # ESLint 修复
pnpm test:run # vitest 单次运行