mirror of https://github.com/ialley-workshop-open/uni-halo.git synced 2026-09-12 16:40:40 +08:00

Files

T

小莫唐尼 beaf2c39ca feat: 实现全站布局偏好系统，支持多页面独立配置

本次提交完成了完整的偏好设置体系重构：
1. 新增preferences.md文档说明布局偏好设计与映射规则
2. 重构布局配置结构，按页面分组管理列表布局与卡片样式
3. 实现后端preferences字段到本地配置的自动映射转换
4. 完成首页、文章列表、归档页的布局动态切换逻辑
5. 重构投票组件样式绑定，改用unocss类名实现样式分离
6. 新增偏好设置页面，支持按页面配置布局参数
7. 兼容旧版布局参数的自动归一化转换
8. 补充完整的单元测试用例覆盖新旧数据迁移场景

2026-09-09 14:48:55 +08:00

1.9 KiB

Raw Blame History

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 单次运行

1.9 KiB Raw Blame History

unibest · Hermes 规范

三条铁律

文档索引

常用命令

1.9 KiB

Raw Blame History