From 6360e5fd96d25ca825f497ad39026ba68c700fad Mon Sep 17 00:00:00 2001
From: jack <jack@local>
Date: Tue, 7 Apr 2026 18:17:35 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=20ChromiumOS=20?=
 =?UTF-8?q?=E5=86=85=E6=A0=B8=E5=AF=B9=E7=85=A7=E4=B8=BA=E6=9C=AC=E6=9C=BA?=
 =?UTF-8?q?=E5=8F=AF=E9=80=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .gitignore                  |  4 ++++
 REPO_INDEX.md               |  2 +-
 chromiumos_kernel/README.md | 30 ++++++++++++++++++++++++++++++
 3 files changed, 35 insertions(+), 1 deletion(-)
 create mode 100644 chromiumos_kernel/README.md

diff --git a/.gitignore b/.gitignore
index af646c46f6..967c57dc9d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -10,3 +10,7 @@ reference/chromeos-ubuntu-sound-diffs/diff-u_*.txt
 
 # dh_* 本地缓存（勿提交；可能含旧路径如 kernel-src）
 debian/.debhelper/
+
+# ChromiumOS 内核对照树（体积大，默认不入库；仅保留 README）
+chromiumos_kernel/v5.15/
+chromiumos_kernel/v5.15-new/
diff --git a/REPO_INDEX.md b/REPO_INDEX.md
index e55210adee..b2c2e7db88 100644
--- a/REPO_INDEX.md
+++ b/REPO_INDEX.md
@@ -7,7 +7,7 @@
 | 路径 | 说明 |
 | ---- | ---- |
 | [`.cursor/`](./.cursor/) | Cursor 配置，非业务源码 |
-| [`chromiumos_kernel/v5.15/`](./chromiumos_kernel/v5.15/) | 可选对照用 ChromiumOS 5.15 树（浅克隆常见） |
+| [`chromiumos_kernel/v5.15/`](./chromiumos_kernel/v5.15/) | 可选对照用 ChromiumOS kernel 工作树（**默认不入库**；深克隆/镜像/分支说明见 [`chromiumos_kernel/README.md`](./chromiumos_kernel/README.md)） |
 | [`reference/ucm2/`](./reference/ucm2/) | Kaisa UCM2 overlay；见 [reference/ucm2/README.md](./reference/ucm2/README.md) |
 | [`reference/chromeos-ubuntu-sound-diffs/`](./reference/chromeos-ubuntu-sound-diffs/) | 可选：本机 `diff -u` 生成物目录（见目录内 README） |
 | [`_bmad/`](./_bmad/) | BMad 模块；总表 [`_bmad/_config/bmad-help.csv`](./_bmad/_config/bmad-help.csv) |
diff --git a/chromiumos_kernel/README.md b/chromiumos_kernel/README.md
new file mode 100644
index 0000000000..ce57dac005
--- /dev/null
+++ b/chromiumos_kernel/README.md
@@ -0,0 +1,30 @@
+# chromiumos_kernel
+
+本目录为 **ChromiumOS `third_party/kernel`** 对照树，默认放在 `v5.15/`（目录名可与分支无关；当前克隆的远程分支以该目录内历史为准）。
+
+## 深克隆（完整历史）
+
+在 `v5.15` 目录下执行：
+
+```bash
+git fetch --unshallow origin
+```
+
+若尚未克隆，可直接深克隆（无 `--depth`）：
+
+```bash
+git clone https://chromium.googlesource.com/chromiumos/third_party/kernel.git
+cd kernel
+git checkout chromeos-6.1   # 或与设备/文档一致的分支
+```
+
+网络不稳定时可增大缓冲后重试 `fetch --unshallow`：
+
+```bash
+git config http.postBuffer 2147483648
+git fetch --unshallow origin
+```
+
+## 与本仓库的关系
+
+父仓库 **不包含** `v5.15/.git`：内核以**普通文件树**提交，便于与你的远端 **一次 `git push` 带上全部源码**。更新内核时可在本机拉取/合并后，再删掉 `v5.15/.git` 重新提交父仓库，或改用子模块/单独镜像（按需）。