From 75a332e7b8a0ed62472e6a6f7259dcdd7f130fb7 Mon Sep 17 00:00:00 2001 From: chendelian <116870791@qq.com> Date: Wed, 8 Apr 2026 14:00:42 +0800 Subject: [PATCH] release: docs, browser_service, runtime_env, SKILL v1.0.52 --- SKILL.md | 4 ++-- references/ERRORS.md | 2 +- references/RUNTIME.md | 4 ++-- scripts/jiangchang_skill_core/runtime_env.py | 3 ++- scripts/service/browser_service.py | 4 ++-- 5 files changed, 9 insertions(+), 8 deletions(-) diff --git a/SKILL.md b/SKILL.md index 9a649da..1a374f0 100644 --- a/SKILL.md +++ b/SKILL.md @@ -1,7 +1,7 @@ --- name: 账号管理 description: 多平台多账号管理。管理各平台账号与Chrome Profile的对应关系，供publisher类Skill调用获取账号信息。 -version: 1.0.51 +version: 1.0.52 author: 深圳匠厂科技有限公司 metadata: openclaw: @@ -16,7 +16,7 @@ allowed-tools: ## JIANGCHANG 共享 Python（匠厂桌面） -依赖由宿主安装到 `{JIANGCHANG_DATA_ROOT}/python-runtime/.venv`（技能市场安装时自动 `uv sync`）。勿在技能目录内创建 `.venv`。Playwright 浏览器目录：`{JIANGCHANG_DATA_ROOT}/playwright-browsers`（`PLAYWRIGHT_BROWSERS_PATH`）。 +依赖由宿主安装到 `{JIANGCHANG_DATA_ROOT}/python-runtime/.venv`（技能市场安装时自动 `uv sync`）。勿在技能目录内创建 `.venv`。Playwright 使用本机 **Chrome / Edge**（`channel=chrome|msedge`），**不**下载自带 Chromium。 ## 使用时机 diff --git a/references/ERRORS.md b/references/ERRORS.md index c56a9ca..e465ad9 100644 --- a/references/ERRORS.md +++ b/references/ERRORS.md @@ -35,7 +35,7 @@ | 前缀 | 含义 | |------|------| -| `ERROR:需要 playwright：pip install playwright && playwright install chromium` | 未安装 Playwright 或浏览器未安装 | +| `ERROR:需要 playwright Python 包：…` | 未安装 `playwright` 包，或本机无 Chrome/Edge（channel 模式，**不**需 `playwright install chromium`） | | `ERROR:PROFILE_DIR_MISSING` | 账号记录中 `profile_dir` 为空 | ## 非前缀输出 diff --git a/references/RUNTIME.md b/references/RUNTIME.md index 7405b41..9dd53cc 100644 --- a/references/RUNTIME.md +++ b/references/RUNTIME.md @@ -46,10 +46,10 @@ | `JIANGCHANG_LOGIN_POLL_INTERVAL_SECONDS` | DOM 轮询间隔，默认 `1.5`，限制在 `0.5..10` | | `JIANGCHANG_LOGIN_DOM_GRACE_SECONDS` | 打开 URL 后等待再检测，默认 `4`，减轻跳转误判 | -依赖：**本机已安装 Chrome 或 Edge**；Python 环境需 **`playwright`** 且已执行 `playwright install chromium`（错误信息见 CLI 输出）。 +依赖：**本机已安装 Chrome 或 Edge**；Python 环境需 **`playwright` 包**（匠厂共享 `python-runtime` 已包含）。运行时使用 **Playwright `channel=chrome|msedge`** 调系统浏览器，**不要**执行 `playwright install chromium`（避免下载自带 Chromium）。 ## 常见问题（简要） -- **`ERROR:需要 playwright`**：安装 `playwright` 并安装浏览器内核。 +- **`ERROR:需要 playwright Python 包`**：确认共享 venv 已 `uv sync`；本机安装 Chrome 或 Edge。 - **`ERROR:PROFILE_DIR_MISSING`**：库中该账号 `profile_dir` 为空，需检查数据或重新添加账号流程。 - **登录检测一直失败**：关闭占用同一 profile 目录的其它浏览器；可调高超时与环境变量；查看统一日志文件。 diff --git a/scripts/jiangchang_skill_core/runtime_env.py b/scripts/jiangchang_skill_core/runtime_env.py index 59b42e7..7582ea0 100644 --- a/scripts/jiangchang_skill_core/runtime_env.py +++ b/scripts/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 锁文件为准。 """ diff --git a/scripts/service/browser_service.py b/scripts/service/browser_service.py index 63d9a16..6daa8eb 100644 --- a/scripts/service/browser_service.py +++ b/scripts/service/browser_service.py @@ -146,7 +146,7 @@ def _run_login_browser_session( except ImportError: log.error("login_aborted playwright_missing") if verbose_ui: - print("ERROR:需要 playwright：pip install playwright && playwright install chromium") + print("ERROR:需要 playwright Python 包：请在匠厂共享环境中已含 playwright；本机需安装 Google Chrome 或 Microsoft Edge（channel 模式，无需 playwright install chromium）") return False, "playwright_missing" profile_dir = (target.get("profile_dir") or "").strip() @@ -362,7 +362,7 @@ def cmd_open(account_id): try: import playwright # noqa: F401 except ImportError: - print("ERROR:需要 playwright：pip install playwright && playwright install chromium") + print("ERROR:需要 playwright Python 包：请在匠厂共享环境中已含 playwright；本机需安装 Google Chrome 或 Microsoft Edge（channel 模式，无需 playwright install chromium）") return profile_dir = (target.get("profile_dir") or "").strip()