Начало Каталог Помощ
Регистрация Вход
liaoxg
/
cfc
1
1
Разклонения 0
Файлове Задачи 0 Заявки за сливане 0 Уики
Клон: cfclub
Клонове Маркери
cfc
/
docs
/
superpowers
/
plans
/
2026-08-07-tabbar-restructure.md

2026-08-07-tabbar-restructure.md 20 KB
Постоянна връзка История Директен файл

TabBar 重构实施计划

面向 AI 代理的工作者： 必需子技能：使用 superpowers:subagent-driven-development（推荐）或 superpowers:executing-plans 逐任务实现此计划。步骤使用复选框（- [ ]）语法来跟踪进度。

目标： 将小程序底部 TabBar 从 5 个五维标签（行/心/身/智/富）重构为 4 个功能标签（首页/健康/成长/我的）+ 中间五维启动器按钮，点击弹出半屏浮层显示 5 个维度入口。

架构：

  • 4 个主包 TabBar 页：首页（index-home 复用）、健康（新建）、成长（growth/index 从分包移入）、我的（profile 从分包移入）
  • 5 个五维页（mind/body/wisdom/wealth）从主包移入分包，通过中间按钮 navigateTo 访问
  • 自定义 TabBar（custom-tab-bar/index.vue）重构为 4 Tab + 中间按钮 + 半屏浮层
  • 统一跳转工具 utils/nav.js 封装 switchTab/navigateTo 判断逻辑

技术栈： uni-app Vue 2（微信小程序）、自定义 TabBar

关键数据：

  • 主包体积变化：188KB → ~75KB+健康页（实际更小，无超限风险）
  • 需改 switchTab 引用：4 处（index-home、wisdom、self-quiz ×2）
  • teacher 独立 TabBar 保留不变

任务 1：创建 utils/nav.js 统一跳转工具

文件：

  • 创建：cfc-frontend/utils/nav.js

职责： 封装跨维度跳转逻辑，自动判断目标页是 TabBar 页（switchTab）还是分包页（navigateTo），避免后续所有页面重复判断。

  • [ ] 步骤 1：编写 nav.js

    /**
* 统一导航工具
* TabBar 页面列表（4个新Tab）
*/
var TAB_BAR_PAGES = [
'/pages/index-home/index',
'/pages/health/index',
'/pages/growth/index',
'/pages/profile/profile'
]

/**
* 跳转到维度页面（五维页已移出 TabBar，统一用 navigateTo）
* 行 = index-home（仍是 TabBar 页，用 switchTab）
* 心/身/智/富 = 分包页，用 navigateTo
*/
function goDimension(dimCode) {
var dimMap = {
action: '/pages/index-home/index',
mind: '/pages/mind/index',
body: '/pages/body/index',
wisdom: '/pages/wisdom/index',
wealth: '/pages/wealth/index'
}
var url = dimMap[dimCode]
if (!url) return
if (TAB_BAR_PAGES.indexOf(url) !== -1) {
uni.switchTab({ url: url })
} else {
uni.navigateTo({ url: url })
}
}

/**
* 通用页面跳转
* 自动判断目标是否为 TabBar 页
*/
function goPage(url) {
if (!url) return
if (TAB_BAR_PAGES.indexOf(url) !== -1) {
uni.switchTab({ url: url })
} else {
uni.navigateTo({ url: url })
}
}

module.exports = {
TAB_BAR_PAGES: TAB_BAR_PAGES,
goDimension: goDimension,
goPage: goPage
}

  • [ ] 步骤 2：Commit

    git add cfc-frontend/utils/nav.js
git commit -m "feat: add unified navigation utility for tabbar restructure"

任务 2：改造 pages.json

文件：

  • 修改：cfc-frontend/pages.json

职责： 将 TabBar 从 5 页改为 4 页（首页/健康/成长/我的）；将 mind/body/wisdom/wealth 从主包 pages 数组移入分包；将 growth/index 和 profile/profile 从分包移入主包。

  • 步骤 1：修改 pages.json 的 main pages 数组

将主包 pages 数组从 5 页改为 4 页：

{
  "pages": [
    { "path": "pages/index-home/index", "style": { "navigationBarTitleText": "首页" } },
    { "path": "pages/health/index", "style": { "navigationBarTitleText": "健康" } },
    { "path": "pages/growth/index", "style": { "navigationBarTitleText": "成长" } },
    { "path": "pages/profile/profile", "style": { "navigationBarTitleText": "我的" } }
  ]
}

  • [ ] 步骤 2：修改 tabBar.list

    "tabBar": {
"color": "#7A7E83",
"selectedColor": "#F97316",
"borderStyle": "black",
"backgroundColor": "#FFFFFF",
"list": [
{ "pagePath": "pages/index-home/index", "text": "首页", "iconPath": "static/tab-home.png", "selectedIconPath": "static/tab-home-active.png" },
{ "pagePath": "pages/health/index", "text": "健康", "iconPath": "static/tab-health.png", "selectedIconPath": "static/tab-health-active.png" },
{ "pagePath": "pages/growth/index", "text": "成长", "iconPath": "static/tab-growth.png", "selectedIconPath": "static/tab-growth-active.png" },
{ "pagePath": "pages/profile/profile", "text": "我的", "iconPath": "static/tab-profile.png", "selectedIconPath": "static/tab-profile-active.png" }
]
}

注意：需要准备 4 组新的 TabBar 图标（首页、健康、成长、我的），放在 static/ 目录下。可复用现有 teacher 模式的图标或重新设计。

  • 步骤 3：将五维页移入分包

将 mind/body/wisdom/wealth 的 index 页面从主包移到对应的 detail 分包中：

// 在 pages/body-detail 分包中添加 body/index
{ "root": "pages/body-detail", "pages": [
  { "path": "index", "style": { "navigationBarTitleText": "身" } },
  // ... 已有页面 health-report, health-dimensions, checkin 等
] }

// 在 pages/mind-detail 分包中添加 mind/index
{ "root": "pages/mind-detail", "pages": [
  { "path": "index", "style": { "navigationBarTitleText": "心" } },
  // ... 已有页面 articles, training, emotion-report 等
] }

// 在 pages/wisdom-detail 分包中添加 wisdom/index
{ "root": "pages/wisdom-detail", "pages": [
  { "path": "index", "style": { "navigationBarTitleText": "智" } },
  // ... 已有页面 cognitive-report, member-wisdom-detail 等
] }

// 新增 pages/wealth 分包，含 wealth/index + 现有 wealth-sub 内容
// 或将 wealth/index 放入 pages/wealth 分包
{ "root": "pages/wealth", "pages": [
  { "path": "index", "style": { "navigationBarTitleText": "富" } }
] }
  • 步骤 4：从原分包移除 growth/index 和 profile/profile

从 pages/growth 分包的 pages 数组中移除 { "path": "index", ... }。 从 pages/profile 分包的 pages 数组中移除 { "path": "profile", ... }。

  • [ ] 步骤 5：Commit

    git add cfc-frontend/pages.json
git commit -m "refactor: restructure tabbar from 5-dim to 4-tab + center button"

任务 3：替换所有 switchTab→五维页 的调用

文件：

  • 修改：cfc-frontend/pages/index-home/index.vue:852-858
  • 修改：cfc-frontend/pages/wisdom/index.vue:371-388
  • 修改：cfc-frontend/pages/wisdom/self-quiz.vue:453
  • 修改：cfc-frontend/pages/wisdom-detail/self-quiz.vue:453

职责： 将所有对五维页的 switchTab 调用改为 nav.goPage() 或 nav.goDimension()，确保五维页移出 TabBar 后跳转正常。

  • [ ] 步骤 1：修改 index-home/index.vue 的 onFuncClick

    // 引入 nav.js
var nav = require('../../utils/nav.js')

// 修改 onFuncClick
onFuncClick: function(item) {
var nativeTabs = ['/pages/index-home/index', '/pages/body/index', '/pages/mind/index', '/pages/wisdom/index', '/pages/wealth/index']
if (nativeTabs.indexOf(item.page) !== -1) {
nav.goPage(item.page)  // 改用 nav.goPage 自动判断
} else {
uni.navigateTo({ url: item.page })
}
}

  • [ ] 步骤 2：修改 wisdom/index.vue 的 onFuncClick

    var nav = require('../../utils/nav.js')

// 修改 onFuncClick
onFuncClick: function(item) {
if (item.needLogin && !this.isLoggedIn) {
uni.showModal({
  title: '提示',
  content: '请先登录后使用此功能',
  success: function(res) { if (res.confirm) uni.navigateTo({ url: '/pages/login/login' }) }
})
return
}
if (item.page) {
var nativeTabs = ['/pages/index-home/index', '/pages/body/index', '/pages/mind/index', '/pages/wisdom/index', '/pages/wealth/index']
if (nativeTabs.indexOf(item.page) !== -1) {
  nav.goPage(item.page)
} else {
  uni.navigateTo({ url: item.page })
}
}
}

  • [ ] 步骤 3：修改 wisdom/self-quiz.vue:453

    // 原代码
uni.switchTab({ url: '/pages/wisdom/index' })
// 改为
uni.navigateTo({ url: '/pages/wisdom/index' })

  • [ ] 步骤 4：修改 wisdom-detail/self-quiz.vue:453

    // 原代码
uni.switchTab({ url: '/pages/wisdom/index' })
// 改为
uni.navigateTo({ url: '/pages/wisdom/index' })

  • [ ] 步骤 5：全局 grep 兜底检查

运行：grep -rn "switchTab.*/pages/\(mind\|body\|wisdom\|wealth\)" --include="*.vue" . 预期：无输出（无遗漏）

  • [ ] 步骤 6：Commit

    git add cfc-frontend/pages/index-home/index.vue cfc-frontend/pages/wisdom/index.vue cfc-frontend/pages/wisdom/self-quiz.vue cfc-frontend/pages/wisdom-detail/self-quiz.vue
git commit -m "fix: replace switchTab with navigateTo for dimension pages moved out of tabbar"

任务 4：重构 custom-tab-bar/index.vue

文件：

  • 修改：cfc-frontend/custom-tab-bar/index.vue

职责： 将自定义 TabBar 重构为 4 个功能 Tab + 中间五维启动器按钮。点击中间按钮弹出半屏浮层，显示行/心/身/智/富 5 个维度入口。

  • [ ] 步骤 1：重构 custom-tab-bar 模板

    <template>
<view class="tab-bar-wrap" v-if="isLoggedIn">
<!-- 普通用户 TabBar -->
<view v-if="currentRole !== 'teacher'" class="tab-bar">
  <!-- 4 Tab -->
  <view v-for="(item, index) in mainTabs" :key="index"
    class="tab-item"
    :class="{ active: currentIndex === index }"
    @click="switchTab(item, index)">
    <image class="tab-icon" :src="currentIndex === index ? item.selectedIcon : item.icon" mode="aspectFit" />
    <text class="tab-text">{{ item.text }}</text>
  </view>

  <!-- 中间五维启动器按钮 -->
  <view class="tab-center-btn" @click="toggleDimOverlay">
    <view class="center-btn-inner">
      <text class="center-btn-icon">⭐</text>
    </view>
  </view>
</view>

<!-- 规划师 TabBar（保持不变） -->
<view v-else class="tab-bar">
  <view v-for="(item, index) in teacherTabs" :key="index"
    class="tab-item"
    :class="{ active: currentIndex === index }"
    @click="switchTab(item, index)">
    <image class="tab-icon" :src="currentIndex === index ? item.selectedIcon : item.icon" mode="aspectFit" />
    <text class="tab-text">{{ item.text }}</text>
  </view>
</view>

<!-- 五维半屏浮层 -->
<view class="dim-overlay-mask" v-if="showDimOverlay" @click="toggleDimOverlay">
  <view class="dim-overlay" @click.stop>
    <view class="dim-overlay-header">
      <text class="dim-overlay-title">五维能量</text>
      <text class="dim-overlay-close" @click="toggleDimOverlay">✕</text>
    </view>
    <view class="dim-grid">
      <view class="dim-item" v-for="dim in dimensions" :key="dim.code" @click="goDimPage(dim)">
        <view class="dim-icon-wrap" :style="{ background: dim.bgColor }">
          <text class="dim-icon">{{ dim.icon }}</text>
        </view>
        <text class="dim-name">{{ dim.name }}</text>
        <text class="dim-title">{{ dim.title }}</text>
      </view>
    </view>
  </view>
</view>
</view>
</template>

  • [ ] 步骤 2：重构 script 逻辑

    var nav = require('../utils/nav.js')

export default {
data() {
return {
  currentIndex: 0,
  showDimOverlay: false,
  mainTabs: [
    { text: '首页', pagePath: '/pages/index-home/index', icon: '/static/tab-home.png', selectedIcon: '/static/tab-home-active.png' },
    { text: '健康', pagePath: '/pages/health/index', icon: '/static/tab-health.png', selectedIcon: '/static/tab-health-active.png' },
    { text: '成长', pagePath: '/pages/growth/index', icon: '/static/tab-growth.png', selectedIcon: '/static/tab-growth-active.png' },
    { text: '我的', pagePath: '/pages/profile/profile', icon: '/static/tab-profile.png', selectedIcon: '/static/tab-profile-active.png' }
  ],
  teacherTabs: [
    { text: '首页', pagePath: '/pages/teacher/index', icon: '/static/tab-action.png', selectedIcon: '/static/tab-action-active.png' },
    { text: '家庭', pagePath: '/pages/teacher/families', icon: '/static/tab-family.png', selectedIcon: '/static/tab-family-active.png' },
    { text: '团队', pagePath: '/pages/teacher/team', icon: '/static/tab-team.png', selectedIcon: '/static/tab-team-active.png' },
    { text: '成长档案', pagePath: '/pages/growth/index', icon: '/static/tab-growth.png', selectedIcon: '/static/tab-growth-active.png' },
    { text: '我的', pagePath: '/pages/teacher/teacher-profile', icon: '/static/tab-profile.png', selectedIcon: '/static/tab-profile-active.png' }
  ],
  dimensions: [
    { code: 'action', name: '行', title: '知行合一', icon: '🌿', color: '#10B981', bgColor: 'rgba(16,185,129,0.15)' },
    { code: 'mind', name: '心', title: '大爱传承', icon: '🔥', color: '#FF6B9D', bgColor: 'rgba(255,107,157,0.15)' },
    { code: 'body', name: '身', title: '主动健康', icon: '🌏', color: '#FF8C42', bgColor: 'rgba(255,140,66,0.15)' },
    { code: 'wisdom', name: '智', title: '赋能未来', icon: '⚡', color: '#6366F1', bgColor: 'rgba(99,102,241,0.15)' },
    { code: 'wealth', name: '富', title: '利他创富', icon: '💧', color: '#F59E0B', bgColor: 'rgba(245,158,11,0.15)' }
  ]
}
},
computed: {
isLoggedIn() { return !!uni.getStorageSync('token') },
currentRole() { return uni.getStorageSync('currentRole') || 'parent' }
},
methods: {
toggleDimOverlay() { this.showDimOverlay = !this.showDimOverlay },
goDimPage(dim) {
  this.showDimOverlay = false
  nav.goDimension(dim.code)
},
switchTab(item, index) {
  this.currentIndex = index
  var nativeTabPages = ['/pages/index-home/index', '/pages/health/index', '/pages/growth/index', '/pages/profile/profile']
  if (nativeTabPages.indexOf(item.pagePath) !== -1) {
    uni.switchTab({ url: item.pagePath })
  } else {
    uni.redirectTo({ url: item.pagePath })
  }
}
}
}

  • [ ] 步骤 3：添加半屏浮层样式

    /* 五维半屏浮层 */
.dim-overlay-mask {
position: fixed;
top: 0; left: 0; right: 0; bottom: 0;
background: rgba(0,0,0,0.5);
z-index: 1000;
display: flex;
align-items: flex-end;
}
.dim-overlay {
width: 100%;
background: #fff;
border-radius: 32rpx 32rpx 0 0;
padding: 40rpx 30rpx 60rpx;
animation: slideUp 0.3s ease;
}
@keyframes slideUp {
from { transform: translateY(100%); }
to { transform: translateY(0); }
}
.dim-overlay-header {
display: flex;
justify-content: space-between;
align-items: center;
margin-bottom: 32rpx;
}
.dim-overlay-title {
font-size: 32rpx;
font-weight: bold;
color: #333;
}
.dim-overlay-close {
font-size: 36rpx;
color: #999;
padding: 8rpx;
}
.dim-grid {
display: flex;
flex-wrap: wrap;
gap: 20rpx;
}
.dim-item {
width: calc(33.33% - 14rpx);
display: flex;
flex-direction: column;
align-items: center;
padding: 24rpx 0;
border-radius: 16rpx;
background: #f8f9fa;
}
.dim-icon-wrap {
width: 80rpx;
height: 80rpx;
border-radius: 50%;
display: flex;
align-items: center;
justify-content: center;
margin-bottom: 12rpx;
}
.dim-icon { font-size: 36rpx; }
.dim-name { font-size: 28rpx; font-weight: bold; color: #333; }
.dim-title { font-size: 20rpx; color: #999; margin-top: 4rpx; }

/* 中间按钮 */
.tab-center-btn {
flex: 0 0 auto;
display: flex;
align-items: center;
justify-content: center;
width: 100rpx;
position: relative;
top: -20rpx;
}
.center-btn-inner {
width: 88rpx;
height: 88rpx;
border-radius: 50%;
background: linear-gradient(135deg, #F97316, #FB923C);
display: flex;
align-items: center;
justify-content: center;
box-shadow: 0 4rpx 16rpx rgba(249,115,22,0.4);
}
.center-btn-icon { font-size: 40rpx; }

  • [ ] 步骤 4：Commit

    git add cfc-frontend/custom-tab-bar/index.vue
git commit -m "feat: redesign custom tabbar with 4 tabs + center 5-dim launcher"

任务 5：创建「健康」Tab 页

文件：

  • 创建：cfc-frontend/pages/health/index.vue

职责： 主动健康干预闭环的聚合入口，展示健康概览、测评入口、报告、打卡、饮食/运动/作息等模块。

  • [ ] 步骤 1：创建 health/index.vue

    <template>
<view class="container">
<tab-transition v-if="showTabTransition" dimCode="body" ref="tabTransition" @close="showTabTransition = false" />

<!-- 未登录态 -->
<template v-if="!isLoggedIn">
  <PageBanner theme="body"
    tagline="科学管理全家健康"
    quote="身体健康是幸福的基础" />
  <LoginGuideCard
    title="登录后查看全家健康数据"
    :items="['查看健康报告', '记录每日健康打卡', '查看专属健康商品']" />
</template>

<!-- 登录态 -->
<template v-else>
  <PageBanner theme="body"
    tagline="主动健康 · 闭环管理"
    quote="测评→报告→方案→执行→追踪" />

  <FamilyMemberStrip
    :members="familyMembersVisible"
    :selectedMemberId="selectedMemberId"
    @select="onFamilyMemberSelect" />

  <!-- 健康概览卡片 -->
  <view class="section">
    <view class="health-score-card">
      <text class="health-score-label">健康综合评分</text>
      <text class="health-score-value">{{ healthScore || '--' }}</text>
    </view>
  </view>

  <!-- 闭环入口网格 -->
  <view class="func-grid">
    <view class="func-item" @click="goAssessment">
      <text class="func-icon">📋</text>
      <text class="func-label">测评</text>
    </view>
    <view class="func-item" @click="goReports">
      <text class="func-icon">📊</text>
      <text class="func-label">报告</text>
    </view>
    <view class="func-item" @click="goCheckin">
      <text class="func-icon">✅</text>
      <text class="func-label">打卡</text>
    </view>
    <view class="func-item" @click="goDiet">
      <text class="func-icon">🍽️</text>
      <text class="func-label">饮食</text>
    </view>
    <view class="func-item" @click="goExercise">
      <text class="func-icon">🏃</text>
      <text class="func-label">运动</text>
    </view>
    <view class="func-item" @click="goSleep">
      <text class="func-icon">😴</text>
      <text class="func-label">作息</text>
    </view>
    <view class="func-item" @click="goMeditation">
      <text class="func-icon">🧘</text>
      <text class="func-label">冥想</text>
    </view>
    <view class="func-item" @click="goBodyDetail">
      <text class="func-icon">🌏</text>
      <text class="func-label">身体能量</text>
    </view>
    <view class="func-item" @click="goMindDetail">
      <text class="func-icon">🔥</text>
      <text class="func-label">心智能量</text>
    </view>
  </view>
</template>

<AIFloatingAvatar />
</view>
</template>

注：完整页面需包含 data、onLoad/onShow、方法实现（跳转到各分包页）、数据加载等。方法实现参考现有 body/mind 页面的导航逻辑。

  • [ ] 步骤 2：Commit

    git add cfc-frontend/pages/health/index.vue
git commit -m "feat: add health tab page as health intervention closed-loop hub"

任务 6：验证 teacher 角色 TabBar 流程

文件：

  • 检查：cfc-frontend/custom-tab-bar/index.vue
  • 检查：cfc-frontend/pages/profile/profile.vue

职责： 确保 teacher 角色的独立 TabBar 不受影响，profile 页面的 teacher 重定向逻辑保持正常。

  • 步骤 1：检查 teacher 流程

确认 teacher 的 TabBar 在 custom-tab-bar 中通过 v-if="currentRole === 'teacher'" 分支渲染，中间按钮不显示。

  • 步骤 2：检查 profile 重定向

profile.vue 中 onShow 检测 currentRole === 'teacher' 时 redirectTo teacher-profile 的逻辑不变。teacher 点击"我的"Tab 时，切到 profile 但立即重定向，不影响体验。

  • [ ] 步骤 3：Commit

    git add cfc-frontend/custom-tab-bar/index.vue
git commit -m "fix: preserve teacher tabbar and role redirect logic"

任务 7：构建验证

职责： 确保项目构建通过，无路由错误。

  • [ ] 步骤 1：npm run build

    cd cfc-frontend && npm run build:mp-weixin

预期：构建成功，无报错。

  • [ ] 步骤 2：全局路由引用检查

    grep -rn "switchTab.*\/pages\/\(mind\|body\|wisdom\|wealth\)\/index" --include="*.vue" .

预期：无输出（所有 switchTab 已改为 navigateTo）。

  • [ ] 步骤 3：Commit

    git add .
git commit -m "chore: verify build and route integrity"