diff --git a/.gitignore b/.gitignore
index 954bb72..c7dbcf2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,7 @@
+# 外部源码目录（通过 git clone 获取，不纳入本项目仓库）
+chatwoot/
+twenty/
+
 # 敏感配置文件（含 API keys / tokens / secrets）
 bridge/chatwoot.config.json
 bridge/llm.config.json
@@ -7,9 +11,6 @@ chatwoot/.env
 twenty/packages/twenty-docker/.env
 docker-compose.yml
 
-# 外部源码目录
-chatwoot/
-twenty/
 
 # 运行时生成
 public/vite-dev/
diff --git a/.idea/vcs.xml b/.idea/vcs.xml
index 900361a..a1e0f89 100644
--- a/.idea/vcs.xml
+++ b/.idea/vcs.xml
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
     <mapping directory="$PROJECT_DIR$/chatwoot" vcs="Git" />
     <mapping directory="$PROJECT_DIR$/twenty" vcs="Git" />
   </component>