diff --git a/requirements.txt b/requirements.txt
index 2fd2df6..bfad6fd 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -20,3 +20,16 @@ six==1.17.0
 spacy==3.8.7
 Twisted==25.5.0
 w3lib==2.3.1
+
+# ─────────────────────────────────────────────────────────────────────────────
+# agent/jaspersoft 子模块需要（按需取消注释安装）
+# 当前子模块 concept.py 标准库即可跑；以下为接 LLM / RAG 时才需要
+# ─────────────────────────────────────────────────────────────────────────────
+# python-dotenv>=1.0.1            # 推荐配合子模块 config.py 使用（也可不用，子模块内置简易 .env 解析）
+# openai>=1.30.0                  # Step 03+ 接 OpenAI LLM
+# anthropic>=0.30.0               # Step 03+ 接 Anthropic Claude
+# chromadb>=0.5.0                 # Step 05 RAG 向量库
+# sentence-transformers>=2.7.0    # Step 05 embedding
+# tiktoken>=0.7.0                 # Step 04 token 估算（exercise_answer 中用到的可选库）
+# pytest>=8.0.0                   # 子模块练习自测
+