# RISE-RL

**Repository Path**: zgc-webcompetition/RISE-RL

## Basic Information

- **Project Name**: RISE-RL
- **Description**: 北京中关村学院“大模型驱动下的大规模强化学习算法研究与应用”项目组主页
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-11
- **Last Updated**: 2026-02-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RISE-RL 项目组官网

RISE-RL（Reasoning, Intrinsic, Self-Evolving, Exploration）项目组官网源码。
主题：**大模型应用驱动下的大规模强化学习算法研究与实践**。

## 技术栈

- Vue 3 + Vite + TypeScript
- Vue Router（Hash 路由，适配 Pages 类静态托管）
- 全量中英双语（默认中文，记忆上次语言）
- 数据驱动内容结构（负责人/导师/成员/成果/招募）

## 页面结构

- `/#/` 首页
- `/#/team` 团队介绍
- `/#/news` 动态与成果
- `/#/join` 加入我们

## 本地开发

```bash
npm install
npm run dev
```

## 构建

```bash
npm run build
```

构建产物位于 `dist/`。

## 部署到 GitHub Pages（推荐：Actions 自动部署）

本仓库已内置工作流：`.github/workflows/deploy-pages.yml`。

1. 将代码推送到 GitHub 仓库（默认监听 `main/master`）。
2. 在 GitHub 仓库进入 `Settings -> Pages`。
3. `Source` 选择 `GitHub Actions`。
4. 再次推送一次代码（或在 `Actions` 页面手动运行 `Deploy to GitHub Pages`）。
5. 发布成功后访问：`https://<你的GitHub用户名>.github.io/<仓库名>/`。

说明：

- 工作流会自动设置 `VITE_BASE_PATH=/<仓库名>/`，无需手动改 `base`。
- 当前是 Hash 路由，刷新不会出现 404 路由问题。

## GitHub 自动同步到 Gitee 私有云

本仓库已内置工作流：`.github/workflows/sync-to-gitee-private.yml`。

配置清单（必须）：

1. GitHub 仓库 -> `Settings -> Secrets and variables -> Actions -> Secrets`：
   - `GITEE_PRIVATE_USER`：仅用户名，例如 `Tianhe`（不要填完整 URL）。
   - `GITEE_PRIVATE_TOKEN`：z.gitee.cn 的个人访问令牌（PAT），需有目标仓库写权限。
2. GitHub 仓库 -> `Settings -> Secrets and variables -> Actions -> Variables`：
   - `GITEE_TARGET_BRANCH`：私有云目标分支，通常填 `main` 或 `master`。

默认同步行为：

1. 每次 GitHub `main` 分支有新提交，会自动触发同步工作流。
2. 工作流会把 GitHub 当前提交推到私有云 `${GITEE_TARGET_BRANCH}`。
3. 同时推送 tags（`git push --tags`）。
4. 需要同步全部分支时，在 Actions 页面手动运行并勾选 `sync_all_branches=true`。

手动验收步骤（推荐第一次配置后执行）：

1. 打开 `Actions -> Sync GitHub to Gitee Private -> Run workflow`。
2. 观察日志里是否出现：
   - `Checking network reachability...`
   - `Checking authenticated access...`
   - 没有 `Push branch failed` / `Push tags failed`。
3. 到 `https://z.gitee.cn/web-competition/RISE-RL` 查看提交是否同步。

常见问题：

1. `GITEE_TARGET_BRANCH` 配到 Secrets：无效。它应放在 **Variables**。
2. `GITEE_PRIVATE_USER` 填成 URL：无效。必须是纯用户名。
3. `Push branch failed`：常见是 PAT 权限不足、目标分支策略限制、或目标分支名不一致。
4. 长时间卡在 Push：通常是网络路径或服务端策略问题；建议先用本地命令手动推一次验证。

## 部署到 Gitee Pages（组织仓库）

目标路径示例：`https://zgc-webcompetition.gitee.io/RISE-RL/`

1. 在组织 `zgc-webcompetition` 下创建仓库 `RISE-RL`。
2. 在本地执行 `npm run build`，生成 `dist/`。
3. 推送代码到仓库，并确保 Pages 使用 `dist` 目录（或单独 Pages 分支存放 `dist` 内容）。
4. 在仓库页面进入 `服务 -> Gitee Pages`。
5. 选择要部署的分支与目录（推荐目录：`dist`）。
6. 启动服务，等待发布完成后访问页面。

## 路径与 404 说明

- `vite.config.ts` 的 `base` 支持自动策略：
  - GitHub Actions 构建时：自动使用 `/<仓库名>/`。
  - 本地构建默认：`./`（相对路径，适配 Gitee 私有云的“分支+目录”部署）。
  - 可通过 `VITE_BASE_PATH` 覆盖（例如：`/RISE-RL/`）。
- 当前使用 Hash 路由，刷新不会触发服务端路由 404。
- 若改为 History 路由，需额外配置服务端回退规则。

## 数据来源

本仓库根目录中的以下资料已结构化进前端数据层：

- `汪跃-项目负责人.md`
- `合作导师团队.md`
- `个人简介汇总.md`
- `动态与成果.md`

## 资源说明

- 主办方 Logo 使用本地文件：
  - `北京中关村学院院徽+书法字体组合.png`
  - `北京人工智能研究院院徽+书法组合.png`
- 团队头像已统一本地化到 `public/assets/avatars/`。
- 机构 Logo 墙支持“有图显示、无图文字占位”。

## 后续建议

1. 完成英文文本人工校对（术语与姓名拼写）。
2. 持续在 `src/data/*.ts` 中维护成果与成员更新。