49 lines
1.5 KiB
Markdown
49 lines
1.5 KiB
Markdown
# 关注的代码库合集（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` 同步。
|