commit 5ae4635a9190d71554e90628d4aa3b64dfcc050a
Author: Reasonix AI <ai-agent@reasonix.local>
Date:   Wed Aug 19 07:40:40 2026 +0800

    docs: 初始化关注的代码库合集骨架

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..73884ec
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+# 关注的代码库合集（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` 同步。