diff --git a/.vscode/README.md b/.vscode/README.md
new file mode 100644
index 0000000..62de120
--- /dev/null
+++ b/.vscode/README.md
@@ -0,0 +1,20 @@
+<!-- -----------------------------------------------------------
+ ! SPDX-License-Identifier: GFDL-1.3-or-later
+ ! -------------------------------------------------------------
+ ! Doc Type      : Markdown
+ ! Doc Name      : (for VS Code Devers) README.md
+ ! Doc Authors   : Aoran Zeng <ccmywish@qq.com>
+ ! Contributors  :  Nul None  <nul@none.org>
+ !               |
+ ! Created On    : <2025-06-18>
+ ! Last Modified : <2025-06-18>
+ ! ---------------------------------------------------------- -->
+
+> 相信我，有了这个目录，你用 `VS Code` 开发 `chsrc` 会神清气爽。
+>
+> 以此铭记我们被 `VS Code` 满屏警告折磨了一年半的岁月
+>
+> -- ccmywish
+
+1. `Ctrl-Shift-B` 直接构建
+2. `F5` 直接开始 Debug