OpenParable
Skip to content
← Back to skills

Btpanel Runtime

DevOps & Security
btpanel_runtime

Btpanel Runtime is an Agent Skill for devops & security published in the aaPanel/BaoTa repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/aaPanel/BaoTa/blob/HEAD/data/agent/skills/btpanel/btpanel_runtime/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/btpanel-runtime, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

强制约束

  • 只处理运行环境版本：本技能只处理 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 命令查询版本列表确认安装结果。

目录结构

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