Files
2026-10-20 21:04:03 +08:00

2.3 KiB

PIGWay

PIGWay Raspberry Pi Console Plugin

简体中文 | English

磁盘呈现统一版本已上线,需要 Console v2.7.0:默认按设备返回顺序,同组支持上移/下移、显示名称及隐藏,所有显示偏好保存到 Console,首页与配置页共用。Agent 的名称和隐藏定义继续作为设备默认值保留。扫描仍只由配置页按钮触发。

当前 v1.6.14 支持统一磁盘显示设置与手动扫描,需要 Console v2.7.0、Agent v3.11.1;新磁盘仅手动发现,已知磁盘容量继续刷新。见 磁盘发现说明。

独立维护的树莓派接入插件:连接现有 PIGWay Raspberry Pi Agent,不在树莓派安装新进程。设备 API、状态转换、配置字段、服务/进程监控、硬件界面及其翻译均由本仓库维护。

依赖 Python 标准库;接入 Console JSON-RPC v1 与可信前端扩展 console-ui-v1。插件 ID 保持 pigway-agent,已有设备可直接继续使用。

打包:

mkdir -p dist
python3 package.py plugin dist/pigway-agent-1.6.14.zip

在控制中心的机器管理页面安装 ZIP,再启用。开发时可用 PIGWAY_ADAPTER_PATH=/absolute/path/pigway-console-adapter-raspberry-pi/plugin 加载源码;Docker 推荐使用持久化数据卷中的安装包。

包根目录包含 manifest、worker、ui 与 LICENSE;打包工具、文档和 Git 元数据不进入插件包。前端扩展通过 Console 的共享状态、请求、翻译与基础显示函数接入,不注入额外安装步骤。只应安装可信插件:前端模块与主页面共享 JavaScript 执行环境,加载失败、同步异常及 Promise 拒绝可降级,但不能隔离死循环或恶意代码;后端独立进程的隔离也不是安全沙箱。

正式仓库:https://tea.pigway.com/way/pigway-console-adapter-raspberry-pi 。首次独立版本为 v1.0.0,需要 Console v2.0.0。与 Console 的集成回归使用后者 tests 下的模拟 Agent,不操作真实设备。

命名与兼容性

本项目面向 Raspberry Pi,不承诺支持其他 Linux 平台。仓库名称不改变现有 pigway-agent 适配器 ID,以及 pigway-pi-control 服务、配置和 API 标识。

文档目录