deploy_or_update_napcat
Deploy or upgrade a local Windows NapCatQQ runtime, extract the package, and configure OneBot 11 ports 3000/3001 after a two-stage confirmation preview.
Instructions
自动下载、解压并部署或升级本地 Windows NapCatQQ 运行时环境,同时自动写入 OneBot 11 (3000/3001) 端口配置。
适用场景:当 check_napcat_environment 显示未安装(选 action='deploy')或存在新版本需升级(选 action='update')时使用。不适用与替代:若运行时已安装且仅需启动、重启或切换账号,请改用 switch_qq_account 或 call_napcat_api,切勿重复重装。
参数约束与两阶段门禁:强制采用两阶段确认锁——首次调用必须传 confirmed=False 获取只读预览计划;向用户展示计划并获得明确许可后,再传 confirmed=True 真正执行文件覆写。target_uin 若指定须为 5~11 位纯数字 QQ 号字符串。
行为与副作用:confirmed=True 时会终止现有本地 NapCat 进程并覆写运行时目录(升级失败或健康检查不通过时自动回滚至旧版本备份);仅支持本地 Windows 模式,外部远程 OneBot URL 调用将直接返回 status='failed'。
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "deploy_or_update_napcat"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | 执行模式,枚举值 'deploy'(全新部署安装)或 'update'(备份旧版并升级,失败自动回滚),默认 'deploy' | deploy |
| confirmed | No | 两阶段安全门禁开关;False 时仅返回只读部署预览计划,True 时执行真实下载解压与进程重启 | |
| target_uin | No | 部署后自动绑定 OneBot 端口的 5~11 位纯数字 QQ 号字符串;留空则沿用当前默认账号 | |
| use_local_zip_if_available | No | 为 True 时优先解压本地已缓存的离线 Release 压缩包以避免重复网络下载,默认 True |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | 接口返回的业务负载数据(对象或数组,具体字段依工具而定) | |
| status | No | 执行状态标识,成功为 'ok'(或特定生命周期状态),失败为 'failed' 或 'error' | |
| message | No | 状态说明或错误诊断详情 | |
| retcode | No | OneBot 11 响应状态码,0 表示成功,非 0 表示协议端或网络错误 |