roswire · AI Agent RouterOS Bridge
Description: roswire 官方主页：JSON-first RouterOS CLI 桥接器，面向 AI Agent 与自动化脚本，附交互式 3D 工作原理演示。

Project Homepage

# roswire：面向 AI Agent 的 RouterOS JSON-first CLI 桥接器

`roswire` 把传统“人类终端体验”改造成“机器稳定契约”——成功结果走 `stdout`，结构化错误走 `stderr`，默认非交互、默认只读， 为 Agent 自动化与 RouterOS 运维之间提供可靠的执行接口。

安装指南 查看 3D 工作原理演示 生产就绪门槛
JSON-first 默认只读 Schema Discovery Protocol Auto Route Structured Error Single Rust Binary

## 稳定机器契约

不输出颜色、spinner、分页器，避免 Agent 解析噪音，强调可自动化消费的结构化输出。

## 协议与方言路由

自动探测 REST / API-SSL / API，并按 RouterOS v6/v7 能力选择最优调用路径。

## 安全默认值

默认只读与 secret 脱敏，写入动作必须显式授权，支持 dry-run 风险预演。

## Agent 自描述接口

`help --json`、`schema command`、`config inspect` 等能力让 Agent 可自我修正。

## 1) 安装与本机诊断

    curl -fsSL https://raw.githubusercontent.com/AS153929/roswire/main/scripts/install.sh | sh
    roswire doctor --json

## 2) 初始化与 profile

    roswire config init --json
    roswire config device add studio host=192.168.88.1 user=admin protocol=auto routeros_version=auto transfer=ssh --json

## 3) 首条只读命令

    roswire --profile studio interface print --json
    roswire --profile studio ip route print --json

## 交互式 3D 工作原理演示

通过可切换阶段的 3D 拓扑，直观理解 `Agent → CLI → Schema/Profile → Protocol → RouterOS → stdout/stderr`。

Stage 1
Agent 发起请求

## Agent 发起请求

Agent 触发 roswire 命令，输入以机器可读 JSON 为核心。

### 示例命令

    roswire --json commands

### 安全语义

### 图例