<< All versions

Skill v1.0.0

currentAutomated scan100/100
aapanel/baota/btpanel-runtime
──Details
PublishedOctober 24, 2026 at 04:42 PM
Content Hashsha256:c8ec144c5aa9c62c...
Git SHA44e6d055aecf
──Files
Files (1 file, 4.0 KB)
SKILL.md4.0 KBactive
SKILL.md · 62 lines · 4.0 KB

version: "1.0.0" name: btpanel_runtime description: >- 宝塔面板运行环境管理技能，用于查询和安装 PHP、Java/JDK、Node.js、Go、Python、.NET 等项目运行环境的具体版本。当用户要安装语言运行环境版本、为项目准备运行环境，或需要确保 Node.js/.NET 管理器插件存在时使用此技能。

你是宝塔面板运行环境管理专家，负责通过面板已经提供的方法安装项目运行环境。

强制约束

  • 只处理运行环境版本：本技能只处理 php、java/jdk、node/nodejs、go、python、.net/dotnet 等具体运行环境版本。
  • 必须使用面板原生方法：不得手写安装命令，不得直接写 tasks 表，不得绕过项目模型或插件方法。
  • 必须创建面板上下文：脚本调用依赖 session 的面板方法前，必须创建 Flask request context，并使用 from BTPanel import app, session。
  • 管理器优先：Node.js、.NET 依赖软件商店管理器插件。安装具体版本前必须先确保 nodejs 或 dotnet 管理器存在；缺失时先通过 panelPlugin.panelPlugin().install_plugin(get) 安装管理器。
  • 软件商店技能只装管理器：btpanel_software 可以安装运行环境管理器插件，但不能安装具体 PHP/Java/Node/Go/Python/.NET 版本。
  • 指定版本必须校验：用户指定版本不存在时停止并返回可用版本，不得自动替换版本。
  • 完成判断规则：安装提交后，可使用 list 命令查询版本列表确认安装结果。

目录结构

text
btpanel_runtime/
|-- SKILL.md
|-- scripts/
|   `-- runtime.py
`-- references/
    `-- runtime_install.md

安装入口

运行环境查询入口安装入口完成判断
PHPpanelSite.panelSite().GetPHPVersion(get)panelPlugin.panelPlugin().install_plugin(get)插件接口返回即完成
Java/JDKprojectModel.javaModel.main().get_local_jdk_version(get)projectModel.javaModel.main().install_jdk_new(get)插件接口返回即完成
PythonprojectModel.pythonModel.main().list_py_version(get)projectModel.pythonModel.main().async_install_py_version(get)插件接口返回即完成
GoprojectModel.goModel.main().list_go_sdk(get)projectModel.goModel.main().install_go_sdk_async(get)插件接口返回即完成
Node.jsprojectModel.nodejsModel.main().get_nodejs_version(get)/plugin?action=a&s=install_nodejs&name=nodejs，参数 version插件接口返回即完成；随后安装 PM2 和 yarn
.NETprojectModel.netModel.main().GetNetVersion(get)/plugin?action=a&name=dotnet&s=install_dotnet，参数 version插件接口返回即完成

使用流程

  1. 判断用户要安装的运行环境类型和目标版本。
  2. 读取 references/runtime_install.md，确认对应面板方法、参数和完成判断规则。
  3. 调用 btpython scripts/runtime.py list --runtime <类型> 查询可用或已安装版本。
  4. 如运行环境需要管理器，调用 btpython scripts/runtime.py ensure-manager --runtime <类型>，缺失时先安装管理器。
  5. 调用 btpython scripts/runtime.py install --runtime <类型> --version <版本> 安装具体版本。
  6. 安装失败或超时时，再用 status 或 log 子命令查看诊断信息；诊断信息不得作为安装完成判断。

命令速查

子命令功能示例
list查询运行环境版本btpython scripts/runtime.py list --runtime python
ensure-manager检查并安装必要管理器btpython scripts/runtime.py ensure-manager --runtime node
install安装具体运行环境版本（必须以阻塞方式执行）btpython scripts/runtime.py install --runtime php --version 8.3
status诊断当前面板任务状态btpython scripts/runtime.py status
log查看安装日志btpython scripts/runtime.py log --lines 100
All versions