docs: 合集加入分类方案与Gitea镜像同步方案，收录astryx

同步方案.md

@@ -0,0 +1,57 @@
+# 镜像同步方案（外部代码库 → git.vanusys.com）
+
+> 版本：v1 · 2026-08-16 · 状态：**待评审**
+> 目标：把我们关注的 GitHub 等外部代码库**定期镜像**到 git.vanusys.com，让内部服务器（宁波、局域网等无法直连 GitHub 的环境）也能直接拉取，并在合集中用子模块统一引用。
+
+## 架构
+
+```
+GitHub (facebook/astryx 等上游)
+      │  ① 定期 fetch（香港服务器可直连 / 或本机 openssl 后端）
+      ▼
+镜像工作区 mirrors/<name>.git（本机或香港服务器上的裸仓库）
+      │  ② push --mirror
+      ▼
+git.vanusys.com/VanuSystems/<mirror 命名>（内部镜像仓库）
+      │  ③ submodule 引用
+      ▼
+codebase-collection（合集，内部全链路可达）
+```
+
+- **镜像层**：每个关注仓库一个镜像，与上游保持全量历史同步（`git push --mirror` 同步所有分支/标签）。
+- **合集层**：`codebase-collection` 的 submodule **只指向内部镜像地址**，不直接指向 GitHub，保证国内/内网 clone 合集时无需外网。
+- 子模块默认记录某个提交引用；需要跟随上游时在合集中执行 `git submodule update --remote` 并提交（手动，避免自动漂移）。
+
+## 同步脚本（草案）
+
+### 方式 A：本机 Windows 计划任务（推荐先用这个）
+
+`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 | 待建远程镜像 |