docs: 镜像统一放 VanuSystems-Mirror 组织

README.md

@@ -10,7 +10,7 @@
 
 | 名称 | 分类 | 子模块路径 | 镜像地址（git.vanusys.com） | 上游地址 | 用途 | 关注原因 | 镜像状态 |
 |------|------|-----------|---------------------------|---------|------|---------|---------|
-| Astryx | frontend | frontend/astryx | VanuSystems/facebook-astryx | https://github.com/facebook/astryx | Meta 开源设计系统（可定制、Agent-ready） | AI 前端 / 设计系统方向，官网可跟踪 | 待建远程镜像 |
+| Astryx | frontend | frontend/astryx | VanuSystems-Mirror/facebook-astryx | https://github.com/facebook/astryx | Meta 开源设计系统（可定制、Agent-ready，MIT，React 19 + StyleX） | AI 前端 / 设计系统方向，活跃维护 | 镜像同步中 |
 
 ## 使用说明
 

同步方案.md

@@ -1,57 +1,48 @@
 # 镜像同步方案（外部代码库 → git.vanusys.com）
 
-> 版本：v1 · 2026-08-16 · 状态：**待评审**
+> 版本：v2 · 2026-08-18 · 状态：**Gitea 原生镜像已启用（astryx 已收录）**
 > 目标：把我们关注的 GitHub 等外部代码库**定期镜像**到 git.vanusys.com，让内部服务器（宁波、局域网等无法直连 GitHub 的环境）也能直接拉取，并在合集中用子模块统一引用。
 
-## 架构
+## 结论：使用 Gitea 原生镜像（pull mirror）
+
+`git.vanusys.com` 为 **Gitea 1.27.1**，服务器位于**香港**（154.21.200.211，可直连 GitHub）。
+采用 **Gitea 仓库镜像（pull mirror）**：Gitea 服务端按周期主动从 GitHub 拉取，**不依赖任何本机定时任务**。
+
+- 镜像仓库：`VanuSystems-Mirror/facebook-astryx`（private，mirror=true；镜像统一放 **VanuSystems-Mirror 组织**）
+- 上游：https://github.com/facebook/astryx （MIT，16k+ 提交，~666MB，含 200+ 分支）
+- 同步周期：24h（已通过 API 设置 `mirror_interval`）
+
+### 新增镜像的标准流程（下次收录同类仓库）
+
+1. 调 Gitea API 创建镜像仓库（见下）。
+2. 等待首次同步完成（大仓库可能需 10~30 分钟）。
+3. 在合集中 `git submodule add <内部镜像地址> <分类>/<仓库名>`，提交收录。
+
+### Gitea API 创建镜像仓库（参考命令，凭据取自本机 GCM，勿回显）
 
 ```
-GitHub (facebook/astryx 等上游)
+POST /api/v1/repos/migrate
-      │  ① 定期 fetch（香港服务器可直连 / 或本机 openssl 后端）
+{
-      ▼
+  "clone_addr": "https://github.com/<org>/<repo>",
-镜像工作区 mirrors/<name>.git（本机或香港服务器上的裸仓库）
+  "repo_name": "<org>-<repo>",
-      │  ② push --mirror
+  "repo_owner": "VanuSystems-Mirror",
-      ▼
+  "mirror": true,
-git.vanusys.com/VanuSystems/<mirror 命名>（内部镜像仓库）
+  "private": true,
-      │  ③ submodule 引用
+  "description": "Mirror of <org>/<repo> (auto-sync from GitHub)",
-      ▼
+  "mirror_interval": "24h0m0s"
-codebase-collection（合集，内部全链路可达）
+}
 ```
 
-- **镜像层**：每个关注仓库一个镜像，与上游保持全量历史同步（`git push --mirror` 同步所有分支/标签）。
+创建后检查 `mirror_interval` 是否生效（PATCH /api/v1/repos/{owner}/{repo} 可补设）。
-- **合集层**：`codebase-collection` 的 submodule **只指向内部镜像地址**，不直接指向 GitHub，保证国内/内网 clone 合集时无需外网。
+注意：迁移完成前（repo 处于 migrating 状态）无法转移/删除仓库。
-- 子模块默认记录某个提交引用；需要跟随上游时在合集中执行 `git submodule update --remote` 并提交（手动，避免自动漂移）。
 
-## 同步脚本（草案）
+## 备用方案：本机脚本同步（仅当 Gitea 镜像不可用时）
 
-### 方式 A：本机 Windows 计划任务（推荐先用这个）
+`tools/sync-mirrors.ps1`（本机）或香港服务器 cron 方式，保持可用但**不再作为首选**：
-
+GitHub → 本地裸镜像（mirrors/）→ `git push --mirror` → git.vanusys.com。
-`tools/sync-mirrors.ps1`（见下），配合 Windows 任务计划程序每日/每周运行。
-注意：本机 schannel 后端在受限环境有 TLS 问题，脚本统一显式指定 `-c http.sslBackend=openssl`。
-
-### 方式 B：香港服务器 cron（154.21.200.211，可直连 GitHub）
-
-待服务器上配置 git 凭据（专用镜像账号或 token）后，用 bash 版脚本 + cron（如每天 03:00）：
-
-```bash
-# 示例：/root/mirror-sync/astryx.sh
-cd /root/mirror-sync/astryx.git
-git fetch --prune origin '+refs/*:refs/*'
-git push --mirror https://<token>@git.vanusys.com/VanuSystems/facebook-astryx.git
-```
-
-## 待确认事项
-
-1. **git.vanusys.com 服务类型**（Gitea / GitLab / 其他）：
-   - 若支持**平台原生镜像**（Gitea 迁移/镜像、GitLab mirroring），可直接在网页上建镜像仓库并启用"定时同步"，无需自建脚本 —— 这是最省事的路径，需确认。
-   - 若不支持，采用上述脚本方案。
-2. **镜像仓库归属与命名**：`VanuSystems/facebook-astryx` 还是单独 `mirrors/` 组织？命名是否用 `facebook-astryx` 格式？
-3. **同步频率**：每日 / 每周 / 手动？
-4. **执行位置**：本机计划任务（先跑通）还是香港服务器 cron（长期更稳）？
-5. **首次建仓**：需要有人登录 git.vanusys.com 网页创建空镜像仓库（我的执行环境无法完成 HTTPS 认证）。
 
 ## 收录清单登记表
 
-| 上游仓库 | 镜像地址（计划） | 分类 | 状态 |
+| 上游仓库 | 镜像地址 | 分类 | 同步方式 | 状态 |
-|---------|----------------|------|------|
+|---------|---------|------|---------|------|
-| https://github.com/facebook/astryx | git.vanusys.com/VanuSystems/facebook-astryx | frontend | 待建远程镜像 |
+| https://github.com/facebook/astryx | git.vanusys.com/VanuSystems-Mirror/facebook-astryx | frontend | Gitea pull mirror（24h） | ✅ 已镜像 |