SuperAPI AI 工具集

isolapurr-user-operations

部署与运维

查看项目

更新于 10-16 09:57

技能介绍

用途:在普通用户机器上,通过已发布的宿主工具与官方 Web 路径操作 IsolaPurr USB Hub 硬件。Agent 驱动的硬件操作默认走已发布 CLI/devd 的本地 IPC,而非浏览器自动化、项目源码命令或 localhost HTTP;Web Serial 仍是官方的人工浏览器路径,仅在所有者明确要求时使用。普通用户操作不要求源码检出、Rust、Bun、Just、espflash 或项目本地缓存。硬件接口视为 USB-A、USB-C 与 2 mm 香蕉插孔;香蕉插孔与 USB-C 共用同一 TPS/SW2303 电源通道,非独立电源轨,手动台架输出默认断开 USB-C 的 SW2303 VBUS 路径。

前置校验:任何硬件流程前先确认 isolapurr --help 与 isolapurr-devd --help 均可用;缺失即为安装门禁,应停止后续列举、扫描、状态、配网、烧录、复位、监视或诊断,不得以系统 USB/串口枚举替代,也不得改用浏览器自动化、localhost HTTP、源码命令或原始串口工具,除非所有者显式切换到 isolapurr-developer-operations。若命令存在但子命令缺失,停止并说明该发布版不支持,不得臆造命令或绕过。

安装:缺失时用所选 GitHub Release 的官方安装器安装,不得要求克隆仓库。运行前向用户展示发布来源、目标版本、安装目录与 PATH 影响并请求确认;若发布或安装资产不可用,报告阻塞并停止。macOS/Linux:curl -fsSLO https://github.com/IvanLi-CN/isolappurr-usb-hub/releases/latest/download/install-isolapurr-host.sh 后 bash install-isolapurr-host.sh;Windows:Invoke-WebRequest -Uri https://github.com/IvanLi-CN/isolappurr-usb-hub/releases/latest/download/install-isolapurr-host.ps1 -OutFile install-isolapurr-host.ps1 后 powershell -ExecutionPolicy Bypass -File .\install-isolapurr-host.ps1。安装器下载对应归档、用 SHA256SUMS 校验并装入用户目录,必要时提示 PATH。安装后用 isolapurr-devd --help 与 isolapurr --help 复验。

连接与工作流:启动本地 IPC 守护进程 isolapurr-devd serve(空闲超时后退出);优先使用已保存硬件:isolapurr hardware list / recent / available --scan。仅在浏览器或调试 UI 明确需要 localhost HTTP 桥时启动 isolapurr-devd bridge-http;--url http://<host-or-ip> 仅用于设备 LAN HTTP。不得自动选择串口,变更硬件前须先展示目标证据。若 devd 报告非 IsolaPurr 固件、下载模式或无信息响应、固件不兼容,不得执行常规 Wi-Fi/端口/电源/诊断操作,仅在明确确认目标后首次烧录,或按提示升级固件。Wi-Fi、端口、电源、设置重置与诊断导出均需已发布 CLI 暴露相应子命令,写入后复验状态;固件更新须使用发布固件目录/资产,先试运行或校验,目标、产物、哈希与身份证据清晰后再烧录。切勿在聊天、日志、截图、追踪或 PR 文本中回显 PSK 等机密。停止条件包括工具缺失、发布/安装资产不可用、目标身份不明、命令缺失、固件目录缺失、哈希不匹配、目标不匹配、本地 USB 会话占用、Web Serial 不受支持,或破坏性操作前缺少用户确认;若某工作流只能通过源码命令完成,切换到 isolapurr-developer-operations。