SuperAPI AI 工具集

routeros-centrs

部署与运维

查看项目

更新于 10-16 05:47

技能介绍

用途:@tikoci/centrs 是对接真实 MikroTik RouterOS 设备或 CHR 的通道,保留 RouterOS 本身语法,负责繁琐易错的环节:把路由器名解析为地址、凭据、端口与协议;运行前校验 RouterOS 风格命令;无论用什么传输都返回同一结构化信封。适合从 shell 脚本、测试或智能体循环中运行命令、读取状态或移动文件。

主要能力:explain 离线分析命令结构语法并给出诊断;execute 运行 CLI 形读写;retrieve 读取状态;api 结构化透传(支持 -X PUT、-f k=v、--query、--stream);transfer 处理设备文件(上传/下载/列举/删除/mkdir/copy);terminal 交互控制台;discover 通过 MNDP 发现邻居并可 --save 写入 CDB;devices 管理 CDB 设备注册表;settings 管理自身偏好;mcp 提供受 CDB 限制的 stdio MCP 服务;btest 执行带宽测试。check 仅设计未实现。

用法:可用 bunx @tikoci/centrs@next --help 免安装试用,或 bun add @tikoci/centrs@next 安装。推荐先离线分析再执行,例如 centrs explain '/ip/address/add address=192.0.2.1/24 interface=ether2',再 centrs execute lab --yes '...',最后 centrs retrieve lab /ip/address --json。目标可通过 --quickchr、位置参数(读取 WinBox CDB)、--host/--port/--username/--password,或 discover 指定。支持 --group、--all、--where 等扇出选择器,优于 shell 循环。解析结果时应用 --json 读取信封,注意 meta.operation.objectCount 是可靠行数,data 形状目前不稳定(0 行为空对象、1 行为裸对象、N 行为数组),tips 与 warnings 是不同通道。

限制:0.1.x 预览版,1.0 前可能有破坏性变更,写操作应先在实验或一次性目标上验证;写形命令非交互时需 --yes,覆盖文件用 --force/--overwrite;无 --wait/--until,就绪轮询需调用方自行处理;输出可能含 RouterOS 返回的密钥(如 /file print detail),MCP 下尤其注意;REST 超时上限 60 秒;check 未实现;离线校验通过仅表示未发现明显错误,不保证 RouterOS 接受;validation/syntax 可能因菜单缺失而非语法错误,应先用 explain 判断。