Files

T

mirror-to-gitee / mirror (push) Successful in 5s

Details

排版语言
- 引入独立视觉系统 .vitepress/theme/styles/portal.css：
  中性底色 + 单一强调色（#4f46e5），正文靠留白与层级取胜，
  不使用大面积彩色底、渐变铺满或装饰性图形
- CSS 变量定义在 :root（原先挂在 .portal 下，导致内容页拿不到值）
- 完整支持暗色模式，变量在 html.dark 下整体替换

首页（pages/index.md → HomePage.vue）
- hero：居中大标题（强调色渐变仅作用于一个词组）、双按钮、四格数据条
- 项目区：三栏卡片，标题 + 状态徽标 + 定位 + 说明 + 技术栈标签
- 通用能力：六格编号卡片
- 组合方式：三栏场景步骤卡，每张带一条可复制命令
- 底部 CTA 区块
- 页面改用 layout: page，通过 Layout 包装层去掉默认窄栏

项目详情页
- iotLCM / DTU：能力矩阵改为标签切换（CapabilityTabs），
  每个业务域一屏，点击切换，替代原先的大宽表
- XiuAdmin：22 项内置功能按用途归为四组标签墙（FeatureGrid）
- 内容页二级标题加短强调线，表格首列不换行，属性表不再竖排

数据
- 新增 data/content.ts 承载首页文案、能力分组、长期事实统计，
  与 projects.ts 并列；文案口径取自各项目 README/详情页，无凭空数字
- 修正 scripts/check-registry.mjs：原先扫描 data/ 下所有 .ts 的 id，
  新增 content.ts 后把业务分组 id 误判为项目；改为只读 projects.ts

验证
- 构建通过，12 个页面，193 条引用 0 失效
- HTTP 实测 12 个路径全 200，不存在路径 404
- 暗色模式与移动端（390px）已截图核对，无横向溢出

2026-11-04 14:13:50 +08:00

2.1 KiB

Raw Blame History

title, description, outline

title	description	outline
关于	雪羊科技开源项目门户说明	deep

关于

雪羊科技开源项目门户汇集公司对外发布的开源项目。当前收录物联网卡管理平台（iotLCM）、DTU 设备管理平台（秀杰 DTU）与中后台开发框架（XiuAdmin）。

许可证

全部项目以 Apache-2.0 发布。

允许	需要
自由使用、修改、商用、再分发	保留版权声明与许可证原文
用于闭源商业产品	对修改过的文件注明变更
专利授权（贡献者授予）	各项目上游依赖保留其原始许可

各项目仓库

项目	仓库
iotLCM	https://git.5iot.com/iotlcm-public/iotlcm
秀杰 DTU 管理平台	https://gitee.com/snowgoat/xiu-dtu
XiuAdmin	https://gitee.com/snowgoat/xiu-admin
本门户站	https://git.5iot.com/iotlcm-public/website

参与贡献

步骤	做什么
1	从目标项目的默认分支切出特性分支，命名 `feat/xxx`、`fix/xxx`
2	提交前确保构建与测试通过：Go 服务跑 `go build ./...` 与 `go test ./...`，前端跑 `pnpm build`
3	提交合入请求，说明变更动机与影响范围

提问与反馈

类型	去哪
使用问题与缺陷	对应仓库开 issue
功能建议	issue 里描述清楚场景与期望
部署排错	先看各项目详情页的常见问题表，再开 issue 并附 `docker compose ps` 与相关日志

边界说明

项	说明
飞书通知机器人	`with-bot` profile 下的运维自用工具，需要自建应用凭据才能启动，不是平台功能，未配置不影响运行
运营商凭据	通道的生产凭据不随仓发布，需自行向运营商申请与配置
老平台私有模块	开源版发布的是微服务家族，不含历史项目的私有定制部分

门户本身

门户是一个独立的 VitePress 工程，与平台代码不在同一个仓库。构建产物是纯静态站点，可用任意静态服务器或容器托管。

镜像构建与部署说明见门户部署。

2.1 KiB Raw Blame History

关于

许可证