diff --git a/python-runtime/README.md b/python-runtime/README.md
index 3867ccd..70a1f46 100644
--- a/python-runtime/README.md
+++ b/python-runtime/README.md
@@ -9,7 +9,8 @@
 `{JIANGCHANG_DATA_ROOT}/python-runtime/`
 
 并在该目录执行 `uv sync` 生成 `{JIANGCHANG_DATA_ROOT}/python-runtime/.venv/`。  
-Playwright 浏览器缓存目录：`{JIANGCHANG_DATA_ROOT}/playwright-browsers/`（由宿主设置 `PLAYWRIGHT_BROWSERS_PATH`）。
+
+**Playwright**：仅安装 Python 包 `playwright` 即可；技能通过 **`channel=chrome` / `msedge`** 使用用户本机已安装的 Chrome 或 Edge。**不要**在宿主流程里执行 `playwright install chromium`（避免下载约 170MB 的自带 Chromium）。
 
 ## 维护流程
 
diff --git a/sdk/jiangchang_skill_core/runtime_env.py b/sdk/jiangchang_skill_core/runtime_env.py
index 59b42e7..7582ea0 100644
--- a/sdk/jiangchang_skill_core/runtime_env.py
+++ b/sdk/jiangchang_skill_core/runtime_env.py
@@ -5,7 +5,8 @@ JIANGCHANG_* 数据根与用户目录：解析规则 + 可选本地 CLI 默认
 
 宿主在 skills.entries 与 Gateway 中注入：
 - PATH 前缀：{JIANGCHANG_DATA_ROOT}/python-runtime/.venv/(Scripts|bin)
-- PLAYWRIGHT_BROWSERS_PATH、VIRTUAL_ENV、JIANGCHANG_PYTHON_EXE
+- VIRTUAL_ENV、JIANGCHANG_PYTHON_EXE
+Playwright 使用本机 Chrome/Edge（launch 时 channel=chrome|msedge），不依赖宿主下载的 Chromium 包。
 技能勿在仓库内维护独立 .venv；依赖以 jiangchang-platform-kit/python-runtime 锁文件为准。
 """