 Dai0814
|
39209ef591
|
fix(portal): 导航栏锚点项点击后正确高亮
mirror-to-gitee / mirror (push) Successful in 3s
问题：点「产品功能 / 核心能力 / 界面预览 / 官方文档」跳转后图标不变蓝。
根因：VitePress 的 isActive() 只比较 path，不看 hash。nav 里
「首页 /」「产品功能 /#features」「核心能力 /#core」的路径部分都是 `/`，
默认逻辑要么把首页和当前锚点同时点亮，要么只亮首页。
改动
- 新增 .vitepress/theme/nav-anchor.ts 接管首页内锚点项的激活判定：
用 data-anchor-active 属性标记，规则为
在首页且有 hash → 只有 hash 匹配项亮；在首页无 hash → 只有「首页」亮；
不在首页 → 清标记交回 VitePress 默认逻辑
- 样式侧用 html.portal-nav-home 限定压制默认 active 的作用域，
只影响首页，不影响 /projects/ 与 /about 的正常高亮
- 导航「项目」加 activeMatch: '^/projects/'，
使 /projects/iotlcm/ 等详情页也保持高亮
- MutationObserver 监听导航 DOM 变化（SPA 切换、主题切换会重建）
踩的坑
- Layout 是函数式组件，onMounted 在其中无效（Vue 报"no active component
instance"），改用 nextTick 调度
- 初版用 hashOf(a) 判空来识别「首页」，但 /projects/ 与 /about 也没有 hash，
被误判成首页项一起点亮；改为判断 href 解析后是否为 '/'
- 抑制规则最初没加作用域，导致非首页页面的正常 active 也被压成黑字
验证（8 个场景逐个实测）
首页顶部→首页 / 四个锚点→各自高亮 / 项目页→项目 /
关于页→关于 / iotLCM 详情→项目；构建 13 页 274 引用 0 失效
|
2026-11-04 15:23:37 +08:00 |
|
|
Dai0814
|
9955e830ce
|
refactor(portal): 对齐 facms.cn 架构，区块顺序归位并撤掉深色块
mirror-to-gitee / mirror (push) Successful in 4s
对比 https://www.facms.cn 后调整三处结构性差异：
1. 顺序归位
参考站是「产品功能 → 核心能力」，先讲做什么再讲凭什么。
上一版我把核心能力提到前面并染成深色，属于人为制造差异。
现在改回：项目 → 产品功能 → 核心能力 → 界面预览。
2. 撤掉深色块
参考站全程浅色，靠留白与间距分段，没有深色区块打断。
移除 .p-section--deep 的使用，核心能力回归 p-section--alt 浅灰，
与前后白底交替，和整站色阶统一。
（样式定义保留，后续需要强调区块时可用。）
3. 核心能力改标签切换
参考站核心能力是一条「通用特性」+ 9 个产品分组的标签切换。
新增 abilityGroups：通用底座 / iotLCM / 秀杰 DTU / XiuAdmin 四组，
每组 6 项，复用 CapabilityTabs（加 source="home" 与 cols 参数）。
替代原先 8 张平铺卡片。
4. 产品功能密度对齐
参考站产品功能 9 张卡各带 6 项功能点。原先我们只有 3 张卡
（每条产品线一张），信息密度偏低。
拆成 9 张：卡与库存 / 通道与上游 / 资费与计费 / 组织与账号 /
生产与研发 / 代理与客户 / 设备接入 / 中后台底座 / 开发效率。
验证
- 构建 13 页，274 条引用 0 失效
- 浏览器实测区块顺序：hero → projects → features → core → preview
→ foundation → how → docs → cta，无 .p-section--deep 残留
- 产品功能 9 卡、核心能力 4 标签每标签 6 卡
- 移动端 390px 无横向溢出
|
2026-11-04 14:42:35 +08:00 |
|
|
Dai0814
|
ccb3f5e39a
|
feat(portal): 首页补齐产品功能、核心能力、界面预览、官方文档四个区块
mirror-to-gitee / mirror (push) Successful in 4s
用户反馈首页缺产品功能、核心能力与界面预览，且没有官方文档入口。
新增区块
- 产品功能：三条产品线（iotLCM / 秀杰 DTU / XiuAdmin），
每条列 6 项能力，卡片底部直达详情页
- 核心能力：8 张带标签的卡片，讲工程层面的硬指标
（部署、接入、开放、治理、韧性、交付、数据、维护），
与"产品功能"区分开：前者是做什么，后者是凭什么能用住
- 界面预览：ScreenshotPreview 组件，Web 管理端 / 小程序端两组标签切换，
首屏大图 + 缩略图条，带浏览器窗口装饰
- 官方文档：6 个入口卡片（文档中心、Web 手册、小程序手册、部署手册、
OpenAPI 合同、门户部署说明），外链自动加 target=_blank
界面预览的占位机制
- previewShots 里 file 留空时渲染带图注的占位框，不报错、不影响构建
- 补图只改 file 字段，组件无需改动
- 新增 pages/public/screenshots/README.md 写清命名、尺寸、脱敏要求
导航
- 增加产品功能、核心能力、界面预览、官方文档四个锚点项
- 窄屏（≤860px）隐藏中间三个锚点项，避免挤压
验证
- 构建 13 页，208 条引用 0 失效
- 浏览器实测：7 个导航项、5 个 section 锚点齐全
- 移动端 390px 无横向溢出
- 文档站 5 个外链地址均实测 200 可达
|
2026-11-04 14:27:48 +08:00 |
|
|
技小云
|
fe63dacae2
|
feat: 开源项目门户站首版（iotLCM / 秀杰 DTU / XiuAdmin 三项目，注册表驱动）
|
2026-11-04 11:08:47 +08:00 |
|