client-commons/skill-template
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
chendelian
2026-07-15 13:58:41 +08:00
parent 296798a0f3
commit b016b3b411
9 changed files with 42 additions and 60 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
development/RUNTIME.md
View File

@@ -8,7 +8,7 @@
| 场景 | 推荐做法 |
|------|----------|
| 日常运行（宿主 / Agent） | 使用 `JIANGCHANG_PYTHON_EXE` 或 PATH 已指向的共享 venv `python` |
| 日常运行（宿主 / Agent） | 使用 PATH 上的共享 venv `python`（`{JIANGCHANG_DATA_ROOT}/python-runtime/.venv`） |
| 手工排查 / 测试机（环境未注入时） | `{JIANGCHANG_DATA_ROOT}/python-runtime/.venv/.../python` 执行 `scripts/main.py` |
| **禁止** | 在技能目录内 `uv run python …` — 会创建临时 venv，加载不到宿主共享 runtime |
@@ -16,7 +16,7 @@
```text
推荐（已注入环境时）:
"$JIANGCHANG_PYTHON_EXE" {baseDir}/scripts/main.py health
python {baseDir}/scripts/main.py health
Windows（未注入时）:
{JIANGCHANG_DATA_ROOT}\python-runtime\.venv\Scripts\python.exe {baseDir}\scripts\main.py health
@@ -25,7 +25,7 @@ Unix（未注入时）:
{JIANGCHANG_DATA_ROOT}/python-runtime/.venv/bin/python3 {baseDir}/scripts/main.py health
```
`<shared-python>` / `JIANGCHANG_PYTHON_EXE` 通常指向 `{JIANGCHANG_DATA_ROOT}/python-runtime/.venv`。数据根由宿主注入（见 `jiangchang_skill_core.runtime_env`）。
共享解释器通常位于 `{JIANGCHANG_DATA_ROOT}/python-runtime/.venv`。数据根由宿主注入（见 `jiangchang_skill_core.runtime_env`）。
## Runtime 诊断（platform-kit 1.2.0+）