codebase-collection/README.md

关注的代码库合集（Codebase Collection）

用途：聚合我们关注 / 追踪的代码库。外部代码库镜像同步到 git.vanusys.com（保证国内/内网可达），合集中通过 Git 子模块统一引用。 更新日期：2026-08-16 相关文档：分类方案 · 镜像同步方案

收录清单

分类见 分类方案.md；镜像状态：待建远程镜像 = git.vanusys.com 上还没有镜像仓库。

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

使用说明

• 首次克隆（含全部子模块，全部走内部镜像，无需外网）：

  git clone --recursive <合集仓库地址>
  

• 跟随上游最新代码（更新子模块引用后需提交）：

  git submodule update --remote
  git add .
  git commit -m "chore: 同步子模块引用"
  

• 新增一个代码库（完整流程见 分类方案.md 收录流程）：

  git submodule add <内部镜像地址> <分类>/<仓库名>
  git commit -m "chore: 收录 <名称>"
  

收录规范

• 子模块一律指向内部镜像地址（git.vanusys.com），不直接指向 GitHub —— 保证合集在宁波/内网环境可完整 clone。
• 镜像维护：运行 tools/sync-mirrors.ps1 或服务器定时任务（见 同步方案.md），定期把上游变更推到内部镜像。
• 子模块记录的是提交引用，不会自动跟随上游，需定期执行 git submodule update --remote 并人工确认提交。