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

> 用途：聚合我们关注 / 追踪的代码库，通过 **Git 子模块（submodule）** 统一管理。
> 更新日期：2026-08-16

## 收录清单

> 待补充。格式约定：

| 名称 | 子模块路径 | 仓库地址 | 用途 | 关注原因 | 备注 |
|------|-----------|---------|------|---------|------|
| （示例）LiveKit | livekit/livekit | https://github.com/livekit/livekit | SFU 视频会议服务 | 自建媒体服务器核心 | 外部仓库，考虑镜像 |

## 使用说明

- **首次克隆**（含全部子模块）：

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

- **拉取全部子模块最新代码**（跟随上游）：

  ```bash
  git submodule update --remote
  ```

- **新增一个代码库**：

  ```bash
  git submodule add <仓库地址> <子模块路径>
  git commit -m "chore: 收录 <名称>"
  ```

- **更新子模块引用并提交**：

  ```bash
  git add .
  git commit -m "chore: 同步子模块引用"
  ```

## 收录规范（建议）

- **内部仓库**（git.vanusys.com 上）：直接以子模块收录。
- **外部开源仓库**（GitHub 等）：
  - 优先在 git.vanusys.com 建立镜像后再收录，避免子模块依赖外部网络（国内服务器拉取 GitHub 可能超时）；
  - 或仅在本表登记地址与用途，不强制挂子模块。
- 子模块只记录**提交引用**，不会自动跟随上游改动，需定期 `git submodule update --remote` 同步。