diff --git a/README.md b/README.md
index 50f90f3..acb0519 100644
--- a/README.md
+++ b/README.md
@@ -30,3 +30,15 @@ cd pkgs/pipeline_core && pip install .
 ```
 wwwroot/pipeline_core -> ../pkgs/pipeline_core/wwwroot
 ```
+
+## 通用会话产线隔离（2026-09-05）
+
+配合 pipeline-service 的 7 层隔离（详见其 README），本模块承担：
+
+- `agent_config.load_agent_config(generic=True)`：不挂产线能力包，
+  并剔除 GENERAL_TOOLS 中 category=project/shell 的工具（schema 层防线，
+  LLM 根本看不见项目管理/命令执行工具）
+- `upload_tools.resolve_upload_dir(generic=True)`：通用会话上传文件落
+  `_general/{uid}` 专属目录，与 AgentExecutor 的文件根一致
+  （_resolve_ws_path 越界保护只认该目录）
+- `wwwroot/api/agent_chat_generic.dspy`：纯通用会话入口（generic=True）