# project-portal **Repository Path**: markets2022/project-portal ## Basic Information - **Project Name**: project-portal - **Description**: 个人项目总览门户:全部项目与仓库全景,数据驱动单页 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-09 - **Last Updated**: 2026-10-31 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 项目总览门户 · Project Portal 个人全部项目的统一展示与检索平台:**重点项目卡片 + 仓库全景两张视图**,数据驱动、单文件、零构建。 > 用途:项目散落在 Gitee / GitHub / 魔搭 / Lighthouse / 阿里云 / WorkBuddy / 腾讯文档等各处,时间久了自己都记不清有什么、在哪、能不能体验。这个页面就是"自己的项目自己的说明书"。 --- ## ✨ 功能 ### 重点项目区(data.js 手工梳理) - **卡片网格**:名称 / 一句话简介 / 状态徽章(运行中·维护中·开发中·已交付·规划中)/ 分类 / 更新日期 - **平台彩色徽章**:魔搭紫 · Gitee 红 · GitHub 黑 · Lighthouse 蓝 · 阿里云橙 · WorkBuddy 青 · 微信小程序绿…(一眼看清项目在哪) - **🚀 体验按钮**:有线上部署的项目,卡片上直接一键直达,无需进详情 - **详情弹窗**:状态 / 分类 / 平台 / 简介 / 技术栈 / **🚀 体验(绿)与 📦 源码(蓝)分组链接按钮** / 黄色备注提示块 - 搜索(项目名·描述·技术栈·平台名)+ 分类筛选 + 状态筛选 ### 仓库全景区(自动生成) - Gitee + GitHub 全部仓库列表(当前 240 个),可搜索、按平台筛选、按更新时间排序 - 公开/私有/fork 标记,仓库名直链跳转 --- ## 🚀 快速开始 ```bash # 方式一:本地直接双击 index.html(file:// 下 data.js 同目录可正常加载) # 方式二:任意静态服务(推荐,体验最佳) python3 -m http.server 8765 # 浏览器打开 http://127.0.0.1:8765 ``` 无依赖、无构建、无后端。**AK/SK 等敏感信息一律不进本项目。** --- ## 📁 文件结构 ``` project-portal/ ├── index.html # 页面(渲染器,日常不用动) ├── data.js # 全部数据(唯一需要维护的地方) └── README.md ``` --- ## 🛠 日常维护(只改 data.js) ### 新增 / 修改重点项目 在 `PORTAL.curated` 数组里加一条: ```js { id: "my-project", // 唯一 ID(英文) name: "项目名称", desc: "一句话简介(卡片上最多显示两行)", category: "工具应用", // 分类(新增分类会自动出现在筛选条) status: "运行中", // 运行中/维护中/开发中/已交付/规划中 updated: "2026-10-09", // 更新日期 platforms: ["魔搭 ModelScope", "Gitee"], // 平台徽章(见下方配色表) tech: "React18 + Vite", // 技术栈(可选) links: [ // 体验/源码链接(可选) { label: "体验地址(魔搭)", url: "https://xxx.ms.show/" }, { label: "源码(Gitee 私有)", url: "https://gitee.com/xxx/xxx" } ], notes: "关键备注,如部署限制、必须保持私有等" // 可选 } ``` ### 链接自动分类规则(体验 vs 源码) 页面按以下规则把 links 分成「🚀 体验」(绿)/「📦 源码」(蓝)两组,**无需手动标注**: 1. label 含 `体验 / 线上 / 主站 / 服务器 / demo` → 体验 2. 或 URL 域名为 `*.ms.show / 127.0.0.1 / quickform.cn / ai.zmrobo.com / 49.232.137.248` → 体验 3. 其余 → 源码 > 想强制指定可加 `type: "demo"` 或 `type: "code"`。 > 注意:只看**域名**不看路径,所以仓库名里带 "demo"(如 discuz-modeai-demo)不会被误判。 ### 平台徽章配色表 在 `index.html` 的 `PLAT_COLOR` 里定义,已内置: `魔搭 ModelScope` 紫 / `Gitee` 红 / `GitHub` 黑 / `LightHouse` 蓝 / `阿里云`·`阿里云百炼` 橙 / `WorkBuddy` 青 / `腾讯文档` 蓝 / `微信小程序` 绿 / `Cloudflare` 橙 / `本机` 灰 / `WordPress` 蓝。 新平台名不在表里会自动用灰色兜底,想配专属色就在表里加一行。 ### 重新生成仓库全景(Gitee + GitHub 全量) ```bash # 需要 gitee_token.json(含 token),GitHub 部分无需认证 python C:/Users/PC/AppData/Local/Temp/build_portal_data.py # 生成后替换 data.js 中 repos 部分(脚本会自动注入) ``` 建议频率:每个季度一次,或新增仓库较多时手动跑。 --- ## 🌐 部署到服务器(可选) 纯静态,扔进任意目录即可。挂在**子路径**下也完全兼容(前端按页面路径自适应拼接,后端式 API 不存在所以无需反代): ```bash # 例:Nginx location /p/portal/ { alias /var/www/project-portal/; } # 例:Apache 直接 DocumentRoot 下建 portal 目录放文件 ``` 想私藏就放内网/加 Basic Auth;想随时手机看可挂到自己的 VPS。 --- ## 📦 备份与同步 - 私有仓库:`https://gitee.com/markets2022/project-portal`(markets2022 账号) - 本地改完同步: ```bash git add -A && git commit -m "更新项目数据" && git push gitee master ``` --- ## 📌 设计决策 | 决策 | 理由 | |------|------| | 数据与页面分离 | 页面是渲染器,加项目只改 data.js,页面零改动 | | 单文件 + 零构建 | 本地双击就能开,任何静态托管都能放,十年后还能用 | | 体验/源码链接分色 | 最重要的动作(去看 demo)一秒能找到 | | 平台彩色徽章 | 项目分散多平台,平台信息比分类更常被想起 | | 仓库全景自动生成 | 240 个仓库手工维护不现实,脚本全量抓取 | ## 🕘 版本历史 | 日期 | 版本 | 说明 | |------|------|------| | 2026-10-09 | v3 | 体验地址体系:卡片 🚀 体验按钮 + 弹窗体验/源码分组 + 实测补全线上地址 | | 2026-10-09 | v2 | 浅色主题重设计 + 修复初始化顺序导致卡片不可点的 bug + 平台彩色徽章 | | 2026-10-09 | v1 | 首版:重点项目 24 项 + 仓库全景 240 仓 |