librezoo · voloo librezoo · voloo
Agent-native Hardware电源开关
Agent-native Hardware · 电源开关

给设备一个能编程的电源开关

直流电源接 IN，设备接 OUT，USB-C 接电脑。开关、主动泄放和断电重启，交给电脑、脚本或 AI Agent；每一步都读回确认。

npm install -g @librezoo/voloo
开源链接 ↗ 模拟试玩 →

⚠正负极接反会损坏硬件。设备与 USB 操作电脑请分别使用独立电源，不共用同一适配器。上电前请读 接线须知。

voloo 外壳渲染图：黄紫外壳、绿色端子、橙色按压件，红线接正极、黑线接负极，USB-C 位于前侧
红线＋黑线−线色辅助，核对标记
OFF ≠ 0 V泄放并确认输出 ≤ 1 V

产品图：AI 辅助效果渲染

在线台架 · 模拟设备

按住开关，或者直接敲命令

下面是一台模拟的 voloo，连接 12 V 电源和带输出电容的设备。看看普通 OFF 和主动泄放的区别：OFF 只是断开，电容里的电会慢慢漏；discharge 会把 VOUT 拉到 1 V 以下并确认。

模拟数据，不连接真实硬件
VIN12.004V
VOUT0.000V
off

bench-a（模拟）

按住 0.6 秒切换模拟输出。短按只会提示。

设备输出电容470 µF

曲线使用简化模型演示残压变化，不是实测波形或放电时间承诺。

产品重点

它只做一件事：
把供电这一步交给程序

一根 USB-C，免装专用驱动

使用系统的 USB CDC 驱动，无需安装专用驱动。USB 负责控制，设备由独立直流电源供电；系统串口权限可按使用说明设置。

每一步都读回确认

开关之后会再检查设备状态，告诉你执行结果。连接中断、结果不确定时会明确提示，让你先查状态再继续。

OFF 之外还有泄放

关断后仍可能有残压。discharge 主动泄放并确认输出 ≤ 1 V；cycle 再接上等待和重新上电，方便重复冷启动。

四种入口，同一套逻辑

习惯点按钮，就用网页仪表盘；习惯写脚本，就用命令行或本地 HTTP API。AI Agent 可以通过 MCP 接入。

多台并排，按名字叫

每台 voloo 各自通过 USB 连接电脑。设置昵称（如 bench-a）后，重新插拔仍可识别，多台按名字查看和控制。

锁定、日志、自检

操作锁会在锁定期间拒绝供电和改名操作，明确解锁后恢复。日志记录操作来源与结果；voloo doctor 提供 USB、权限和读数的排查建议。

AI Agent 也能用

让 Agent 控制
设备供电

确认目标后，Agent 可调用 voloo 关断、主动泄放并重新上电。需要查看设备启动日志时，可结合现有串口工具继续调试。先安装 voloo，再按客户端配置本地 MCP 服务：

claude mcp add voloo -- voloo mcp

安装 voloo 后，在终端执行这条注册命令。

以上是本地 stdio MCP 的配置示例；配置位置和权限设置依客户端版本而异。接入后先读取设备列表和状态，明确目标后再控制供电。

Agent 可以查看设备、读取状态、开关电源和查询操作日志。需要只读使用时，在 voloo 的 ~/.voloo/config.toml 的 [mcp] 下设置 read_only = true。

模拟对话
固件刚烧好。帮我把 bench-a 冷启动一次。
voloo_power {"device":"bench-a","action":"cycle","off_ms":2000}
discharge completed: VOUT 0.41 V ≤ 1 V waited 2000 ms on completed, state: on, VOUT 4.98 V
bench-a 已泄放到 0.41 V，等了 2 秒后重新上电，现在 VOUT 是 4.98 V。可以去看串口的启动日志了。

预设内容演示，未连接真实 Agent 或设备。

放进你的工作流

少拔一次线，
多做一次实验

把重复的供电操作交给 voloo，让注意力留在正在调试的东西上。

01

固件改完，冷启动

泄放、等待、重新上电，一条命令完成。接着查看启动日志，反复验证启动行为。

voloo cycle bench-a --off-ms 2000
02

把断电写进测试

把开关电源接进现有脚本。每一步查看执行结果，让启动测试和故障复现可以重复进行。

voloo status bench-a --json
03

多台设备，各有名字

给每台 voloo 起个好记的名字，在仪表盘查看状态，控制前确认目标。临时不想被改动，就锁定它。

voloo ui
开始前了解这些

接得上，也用得顺

连接电脑USB-C免装专用驱动，USB 负责控制
标称工作电压3.3–28 V DC实测工况：3 A 恒流负载
泄放完成≤ 1 V读回输出电压确认，超时会报错
支持系统macOS · Linux · Win同一套命令，也能使用网页仪表盘

标称 3.3–28 V / 最高建议电流 3 A

最高建议电流 3 A28 V × 3 A ≈ 84 W

超过 3 A 可能损坏硬件。3 A 恒流负载已实测工作正常。功率按 P = U × I 换算；84 W 对应 28 V、3 A 这个工作点，不能据此在低压下使用超过 3 A 的电流。

有效 VIN > 30.5 V 时自动关闭输出并锁定过压保护。VIN < 30.0 V 时，过压锁定自动解除，但输出仍保持关闭。用户需在仪表盘长按“开启供电”，或发送新的开启命令，才会恢复供电；不需要额外的过压复位命令。保护阈值不改变标称工作范围。

实测恒流负载不等于任意启动浪涌或感性回灌保证。voloo 不自动调压、限流或限功率，请使用外部电源限流；主动泄放用于断电后的残压，不是持续吸收功率的电子负载。

接线须知

上电前，先看这两条

正负极接反会损坏硬件。负载的供电电源与通过 USB 操作 voloo 的电脑，请分别使用独立电源/适配器，不要共用同一个适配器。

1不要接反电源

  • 正负极接反会损坏硬件。接线前确认电源极性，关闭电源输出后再接线。
  • 按实物 IN、OUT 和 + / − 标记接线：IN 接电源，OUT 接设备，不要仅凭图片左右位置判断。
  • 图中按红线接＋、黑线接−示意。接线前仍需用万用表确认电源极性，再关闭电源并核对实物标记接线。
外壳俯视图：左侧输入端子，右侧输出端子，中间标有 + 和 − 以及进出箭头
图示红线接＋、黑线接−，颜色仅作辅助。AI 辅助效果渲染，接线前仍需确认电源极性并核对实物 IN、OUT 和 + / − 标记。

2不要共用同一适配器

  • 负载供电与 USB 操作电脑必须使用不同的适配器/独立电源。即使同一个适配器有多个输出口，也不要同时用于这两路供电。
  • 设备只从 voloo 的 OUT 取电。voloo 控制期间，不要再从设备自己的 USB 口、调试器的 VCC / 3V3 或其他电源给它供电。
  • 调试器、USB 转串口接到设备时，只连 GND 和信号线。

正确接法：电源 A → voloo IN / OUT → 设备；另一电源 B → USB 操作电脑。设备只从 OUT 取电，不从电脑 USB 或其他接口同时取电。

端子怎么接：按住橙色件，线进绿色圆孔

橙色件负责夹线，不是电源开关。只在断电后接拔线；如有残压，先执行泄放并确认输出 ≤ 1 V，再断开外部电源和 USB-C。

未处理导线剥线11毫米，线芯整齐1 · 剥线 11 mm

线芯齐整，不留散丝；预制端头先确认匹配。

朝电路板方向按住对应的橙色按压件2 · 按住橙色件

按住对应按压件，方向朝电路板，使夹口打开。

持续按住橙色件，将导线插入绿色圆孔3 · 插入绿色圆孔

持续按住，把线插入相邻圆孔，铜芯完全进入。

松开橙色件后轻拉导线确认夹紧4 · 松开，轻拉

确认夹紧，孔外不露铜。橙色开口不是插线孔。

取线时先确认断电，按住对应橙色件后再取出，不要硬拽。看配图快速说明 → · 下载 A4 两页版

接线自查

SOURCE 的 + / − 用万用表确认过吗？
负载电源与 USB 操作电脑是否共用同一适配器？
设备还有别的供电吗？（自带 USB、调试器 VCC、电池……）
回答这三个问题

确认接线及电气边界后，再打开电源。

开始使用

准备好，voloo ls

先安装 Node.js 18 或更新版本，再执行 npm 安装命令。安装后运行 voloo ls 查看设备，或用 voloo demo 先体验模拟仪表盘。

# Node 18+ · 安装 voloo
$ npm install -g @librezoo/voloo
# 或者不安装，直接运行
$ npx @librezoo/voloo ls
npm 安装包 ↗ 开源链接 ↗ 快速上手 ↗ 完整中文说明 ↗
1

接电源到 IN

先量电源极性，再关闭电源接线，+ 对 +。

2

接设备到 OUT

设备只从这里取电，拔掉它的其他供电。

3

插 USB-C，看一眼

voloo ls 列出设备；输出关闭且空闲时，可用 voloo name <UID> bench-a 设置昵称。

4

开始控制

确认接线、限流和目标后，使用 voloo on bench-a 或 voloo discharge bench-a；也可运行 voloo ui。