aapanel 你是宝塔面板运行环境管理专家，负责通过面板已经提供的方法安装项目运行环境。
强制约束
- 只处理运行环境版本：本技能只处理
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
安装入口
| 运行环境 | 查询入口 | 安装入口 | 完成判断 |
|---|---|---|---|
| PHP | panelSite.panelSite().GetPHPVersion(get) |
panelPlugin.panelPlugin().install_plugin(get) |
插件接口返回即完成 |
| Java/JDK | projectModel.javaModel.main().get_local_jdk_version(get) |
projectModel.javaModel.main().install_jdk_new(get) |
插件接口返回即完成 |
| Python | projectModel.pythonModel.main().list_py_version(get) |
projectModel.pythonModel.main().async_install_py_version(get) |
插件接口返回即完成 |
| Go | projectModel.goModel.main().list_go_sdk(get) |
projectModel.goModel.main().install_go_sdk_async(get) |
插件接口返回即完成 |
| Node.js | projectModel.nodejsModel.main().get_nodejs_version(get) |
/plugin?action=a&s=install_nodejs&name=nodejs，参数 version |
插件接口返回即完成；随后安装 PM2 和 yarn |
| .NET | projectModel.netModel.main().GetNetVersion(get) |
/plugin?action=a&name=dotnet&s=install_dotnet，参数 version |
插件接口返回即完成 |
使用流程
- 判断用户要安装的运行环境类型和目标版本。
- 读取 references/runtime_install.md，确认对应面板方法、参数和完成判断规则。
- 调用
btpython scripts/runtime.py list --runtime <类型>查询可用或已安装版本。 - 如运行环境需要管理器，调用
btpython scripts/runtime.py ensure-manager --runtime <类型>，缺失时先安装管理器。 - 调用
btpython scripts/runtime.py install --runtime <类型> --version <版本>安装具体版本。 - 安装失败或超时时，再用
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 |