@guandata/guanwf 0.1.834 → 0.1.835

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## @guandata/guanwf 0.1.835 - 2026-09-18
+
+- 修复 Python 镜像版本解析：优先通过 `/api/python-images/list` 读取 `pythonVersion`，旧接口不可用时降级到 `/api/system-images/list?type=PYTHON` 并解析 `runtimeEnv`；两类结构化版本字段都缺失或无法识别时才回退产品兼容契约 Python 3.8，仍然禁止从镜像描述、名称或 URL 推断版本。
+
 ## @guandata/guanwf 0.1.834 - 2026-09-17
 
 - `schedule set --failure-strategy` 改为已废弃的兼容参数，仅接受 `CONTINUE`；显式传 `END` 会在本地校验阶段失败且不发送写请求，节点失败后的后继调度由 `FAILURE` / `ALL` 连线决定。

package/README.md

@@ -48,6 +48,10 @@ guanwf install-skill
 
 ## 版本更新
 
+### @guandata/guanwf 0.1.835
+
+- 修复 Python 镜像版本解析：优先读取 `pythonVersion`，旧接口降级解析 `runtimeEnv`，两者都不可用时才回退兼容契约 Python 3.8。
+
 ### @guandata/guanwf 0.1.834
 
 - `schedule set --failure-strategy` 仅接受 `CONTINUE`，显式传 `END` 会在本地校验阶段失败；后继调度改由 `FAILURE` / `ALL` 连线决定。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guandata/guanwf",
-  "version": "0.1.834",
+  "version": "0.1.835",
   "description": "观远工作流数据流编辑工具 - 创建、编辑、导出、预览、保存数据流",
   "bin": {
     "guanwf": "bin/run.js"

package/skills/guanwf/SKILL.md

@@ -169,7 +169,9 @@ guanwf python-runtime --dir <workdir> --format json
 `pythonVersionSource`、`imageId` 及解析状态，并写入 `<workdir>/_python_runtime_context.json`。`guanwf edit` 检测到
 Python 节点时也会自动获取并返回同一结构化上下文。生成代码时只以其中的
 `pythonRuntime.nodes[].runtime.pythonVersion`（或 `pythonRuntime.selected`）为兼容目标；
-当前接口没有正式版本字段时使用产品兼容契约 Python 3.8，并明确标记
+CLI 优先通过 `/api/python-images/list` 读取 `pythonVersion`；旧接口不可用时降级到
+`/api/system-images/list?type=PYTHON` 并解析 `runtimeEnv`。两类结构化版本字段均缺失或无法识别时，
+使用产品兼容契约 Python 3.8，并明确标记
 `pythonVersionSource: "compatibility_fallback"`；**禁止从镜像描述、名称或 URL 推断版本**。
 结构化上下文中的 `imageUrl` 会移除 userinfo、fragment 和敏感 query；落盘文件使用 0600 并自动忽略。
 固定 Runtime 输出 `runtimeMode: "FIXED_RUNTIME"`，配置镜像的动态 Pod 输出 `runtimeMode: "DYNAMIC_POD"`；

package/skills/guanwf/references/WORKFLOW_DSL.md

@@ -154,10 +154,12 @@ guanwf python-runtime --dir <workdir> --format json
 `pythonRuntime.nodes[]` 是工作区各 Python 节点根据 `PythonConfig.ImageID` 解析出的实际选择。
 兼容性判断以 `runtimeMode` 和嵌套 `runtime.pythonVersion` 为准，并检查 `runtime.pythonVersionSource`。CLI 不输出
 服务端自由文本 `imageDescription`；经过凭证脱敏的 `imageUrl` 仅供排查，禁止从中推断版本。
-CLI 会优先调用新版系统镜像 API，并自动兼容旧环境的 Python 镜像 API。
+CLI 优先调用兼容接口 `/api/python-images/list` 获取逐镜像 `pythonVersion`；该接口不可用时降级调用
+`/api/system-images/list?type=PYTHON`，并从规范字段 `runtimeEnv`（例如 `Python 3.11`）解析版本。
 
-短期兼容约定：镜像 API 尚未提供正式 `pythonVersion` 字段时，CLI 返回 Python 3.8，并标记
-`pythonVersionSource: "compatibility_fallback"`；若未来 API 返回正式字段，则优先使用并标记为 `api_field`。
+兼容约定：旧接口的 `pythonVersion` 或新接口的合法 `runtimeEnv` 均标记为
+`pythonVersionSource: "api_field"`；两者均缺失或 `runtimeEnv` 无法识别时，CLI 返回 Python 3.8，并标记
+`pythonVersionSource: "compatibility_fallback"`。
 
 固定 Runtime 标记 `runtimeMode: "FIXED_RUNTIME"`，配置镜像的动态 Pod 标记
 `runtimeMode: "DYNAMIC_POD"`。目录接口不可用或版本字段缺失时，状态与 warning 会明确说明，