MagicScript 开发工具

MagicScript VSCode 插件，提供设备管理功能。

功能特性

设备管理

• 添加设备：通过 IP 地址和端口添加 MagicScript 设备
• 删除设备：删除不需要的设备
• 连接设备：通过 WebSocket 连接到指定设备（同时只能连接一个设备）
• 断开连接：断开当前连接的设备
• 刷新列表：刷新设备列表显示
• 智能验证：自动验证 IP 地址格式和端口范围，防止重复添加

MagicScript 控制台

• 自动显示: 设备WebSocket连接成功时自动显示控制台
• 输出面板: 在VSCode底部输出面板查看格式化日志
• 集成终端: 自动创建设备专用终端
• 手动控制: 使用面板标题栏的"显示控制台"和"清空控制台"按钮
• 智能管理: WebSocket断开时自动清理控制台资源

使用方法

1. 打开设备管理面板

在 VSCode 的资源管理器侧边栏中，找到「设备管理」面板。

2. 添加设备

• 点击设备管理面板标题栏的「+」按钮
• 输入设备的 IP 地址（例如：192.168.1.100）
• 输入设备的端口号（默认：9800）
• 系统会验证 IP 格式并检查是否重复

3. 管理设备

• 连接设备：右键点击未连接的设备，选择「连接设备」
  • 系统会自动尝试WebSocket连接 (ws://IP:PORT/ws/logs)
  • 连接成功后设备状态变为「已连接」，自动打开MagicScript控制台
  • 开始实时接收设备日志，连接失败时会显示错误提示
• 断开设备：右键点击已连接的设备，选择「断开设备」
• 删除设备：右键点击任意设备，选择「删除设备」

4. 设备状态

• 设备列表显示每个设备的 IP 地址
• 连接状态通过「已连接」/「未连接」标识显示
• 同时只能有一个设备处于连接状态

5. MagicScript 控制台

• 自动显示：连接设备时自动打开控制台面板和终端
• 输出面板：在底部面板显示「MagicScript - [设备IP]」输出通道
• 集成终端：自动创建专用终端用于命令交互
• 手动控制：
  • 点击「显示控制台」按钮重新打开控制台
  • 点击「清空控制台」按钮清空输出内容
• 自动清理：断开设备或删除设备时自动销毁控制台

快捷操作

设备管理面板

• 标题栏按钮:
  • ➕ 添加设备（输入IP和端口）
  • 🔄 刷新设备列表
  • 📺 显示控制台（WebSocket连接后可用）
  • 🗑️ 清空控制台（WebSocket连接后可用）

设备右键菜单

• 连接设备: 尝试WebSocket连接到 ws://IP:PORT/ws/logs
• 断开设备: 断开WebSocket连接
• 删除设备: 从列表中移除设备

MagicScript 控制台功能

• 智能连接: 自动检测WebSocket连接状态，5秒超时机制
• 实时日志: 解析JSON格式日志并按级别彩色显示
• 错误处理: WebSocket连接失败时显示详细错误信息
• 资源管理: 连接断开时自动关闭WebSocket和清理控制台