Align Agent CLI docs to host shared python on PATH
All checks were successful
技能自动化发布 / release (push) Successful in 7s

This commit is contained in:
2026-07-15 13:58:41 +08:00
parent 296798a0f3
commit b016b3b411
9 changed files with 42 additions and 60 deletions

View File

@@ -1,7 +1,7 @@
---
name: 技能开发模板(通用业务版)
description: "OpenClaw 通用业务技能开发模板,供复制后定制新业务 skill。定制步骤见 development/DEVELOPMENT.md。"
version: 1.0.43
version: 1.0.44
author: 深圳匠厂科技有限公司
metadata:
openclaw:
@@ -51,19 +51,15 @@ Agent 执行契约细节:`references/CLI.md`、`references/ACTIONS.md`、`refe
## 共享 Python必读
宿主共享 runtime 注入进程环境:`JIANGCHANG_PYTHON_EXE``VIRTUAL_ENV`,并把 venv 的 `bin`/`Scripts` 前置到 `PATH`
**推荐调用式Agent**
宿主共享 runtime `{JIANGCHANG_DATA_ROOT}/python-runtime/.venv`,并已前置到 PATH同时设 `VIRTUAL_ENV`)。短 CLI 一条命令直接跑:
```bash
"$JIANGCHANG_PYTHON_EXE" {baseDir}/scripts/main.py health
"$JIANGCHANG_PYTHON_EXE" {baseDir}/scripts/main.py version
"$JIANGCHANG_PYTHON_EXE" {baseDir}/scripts/main.py config-path
"$JIANGCHANG_PYTHON_EXE" {baseDir}/scripts/main.py init-db
python {baseDir}/scripts/main.py health
python {baseDir}/scripts/main.py version
python {baseDir}/scripts/main.py config-path
python {baseDir}/scripts/main.py init-db
```
Windows cmd 可用 `"%JIANGCHANG_PYTHON_EXE%"`。若环境已注入共享 venv也可写 `python {baseDir}/scripts/main.py …`(须确认不是系统/临时解释器)。
- 公共库来自共享 venv 的 `jiangchang-platform-kit>=1.2.0`(包名路径 `jiangchang_skill_core`**不要 vendor** `scripts/jiangchang_skill_core/`
- 根目录 `requirements.txt` **只声明技能特有**依赖;不要写 `jiangchang-platform-kit` / `playwright`
- `metadata.openclaw.platform_kit_min_version` 是宿主兼容声明,**不是** pip 依赖。