release: python-runtime, runtime_env sync, docs

python-runtime/README.md

@@ -0,0 +1,20 @@
+# 匠厂共享 Python 运行时（JIANGCHANG）
+
+本目录为 **技能第三方依赖的唯一声明源**：与匠厂桌面应用内 `resources/jiangchang-python-runtime/` **保持文件一致**（`pyproject.toml`、`uv.lock`）。
+
+## 安装目录（用户机器）
+
+宿主将模板同步到：
+
+`{JIANGCHANG_DATA_ROOT}/python-runtime/`
+
+并在该目录执行 `uv sync` 生成 `{JIANGCHANG_DATA_ROOT}/python-runtime/.venv/`。  
+Playwright 浏览器缓存目录：`{JIANGCHANG_DATA_ROOT}/playwright-browsers/`（由宿主设置 `PLAYWRIGHT_BROWSERS_PATH`）。
+
+## 维护流程
+
+1. 在本目录修改 `pyproject.toml` 依赖。
+2. 执行 `uv lock` 更新 `uv.lock`。
+3. 将 `pyproject.toml` 与 `uv.lock` **复制到** ClawX/匠厂 仓库的 `resources/jiangchang-python-runtime/` 后发布应用。
+
+各技能仓库 **不再** 维护独立 `.venv`；技能仅声明业务逻辑，运行时依赖以本锁文件为准。