Vector Control

核心功能

该 Skill 提供了一套完整的 Vector 机器人远程控制能力，基于 Wirepod 本地 HTTP API（/api-sdk/* 端点）实现。用户可通过命令行工具执行多种操作，包括：

• 运动控制：差速轮速驱动（0-200 范围）、头部俯仰、升降臂调节
• 语音交互：文本转语音播报，支持自定义内容
• 视觉获取：从 /cam-stream 捕获 MJPG 视频流并转换为静态图像
• 音频播放：MP3/WAV 文件流式传输（自动转码为 8kHz 单声道）
• 自主行为：确定性巡逻（Patrol）与随机探索（Explore）两种预设模式

显著优点

• 零云端依赖：完全基于本地网络通信，无需 Anki/Digital Dream Labs 云服务
• 低延迟直连：Pi/Wirepod 主机与 Vector 同网络部署，响应迅速
• 预置行为模式：巡逻与探索脚本封装了复杂的运动序列，降低开发门槛
• 开放生态：Wirepod 开源项目背书，可扩展自定义端点

潜在局限

• 硬件专属性：仅支持 Anki Vector 机器人，需配合 Wirepod 越狱固件使用
• ESN 依赖：需预先获取机器人序列号（从 /etc/wire-pod/ 配置读取）
• 并发限制：语音与运动命令存在互斥，需手动插入延迟避免冲突
• 网络绑定：必须处于同一局域网，无公网远程控制能力
• 维护风险：Wirepod 为社区项目，长期 API 兼容性无官方保障

适用人群

• 拥有越狱 Vector 机器人的硬件爱好者
• 希望构建本地化智能家居/安防巡逻系统的 DIY 开发者
• 机器人教育场景下的教学演示用户
• 拒绝云服务、注重隐私的机器人控制需求者

常规风险

• 物理安全：自动巡逻/探索模式下可能碰撞家具或坠落台阶
• 设备锁定：未正确 release 控制权可能导致机器人处于"假死"状态，需手动重启
• 音频爆音：格式转换异常可能产生刺耳噪声
• 隐私泄露：摄像头流虽本地传输，但若网络未隔离存在被截获风险

核心用法

vector-control 是一款面向 Anki Vector 机器人的本地化控制工具，通过 Wirepod 开源框架提供的 /api-sdk/* HTTP 端点与机器人交互。用户可通过捆绑的 Python CLI 脚本完成设备接管、运动控制、头部/升降台调节、语音合成、摄像头抓拍、音频播放以及自主巡逻/探索等操作。

使用前需确保机器人与 Wirepod 主机（通常为 Raspberry Pi）处于同一本地网络，并获取设备的 ESN 序列号（可从 /etc/wire-pod/wire-pod/jdocs/botSdkInfo.json 读取）。所有控制指令均通过 localhost:8080 本地端口发送，无需互联网连接。

显著优点

1. 纯本地架构：所有通信局限于本地网络，无数据外泄风险，物理隔离外部攻击面
2. 零依赖设计：仅使用 Python 标准库（urllib、subprocess、uuid 等），彻底消除供应链攻击隐患
3. 功能完整：覆盖 Vector 机器人核心能力——差速移动、头部俯仰、升降台调节、TTS 语音、MJPG 视频流、音频播放、自主巡逻与随机探索
4. CLI 友好：提供结构化的命令行接口，支持脚本化自动化和快速调试

潜在缺点与局限性

• 硬件绑定：必须拥有 Vector 机器人及 Wirepod 搭建的本地环境，普适性受限
• 网络隔离依赖：虽为安全特性，但也意味着无法远程操控，适用场景局限于局域网覆盖范围
• T3 来源可信度：由个人开发者维护，非企业级背书，长期维护承诺存在不确定性
• 功能边界明确：定位为底层控制工具，不提供高级 AI 视觉分析或复杂任务规划能力

适合的目标群体

• Vector 机器人爱好者：希望深度定制机器人行为、开发个性化互动的硬件玩家
• 教育机器人实验者：用于机器人学、物联网、嵌入式系统教学的师生团队
• 本地自动化需求者：需要在隔离网络环境中部署可控硬件实体的开发者或研究机构
• 隐私敏感型用户：拒绝云端服务、追求数据完全本地化的极客用户

使用风险

尽管安全评级达 S+，仍需注意以下常规风险：

• 物理安全风险：运动控制指令若参数不当可能导致机器人跌落或碰撞，建议始终在 assume 控制状态下操作并配备 release 应急机制
• 资源竞争冲突：语音合成与运动指令存在中断竞争，需在设计序列时预留缓冲延迟
• 设备状态依赖：Wirepod 服务稳定性直接影响控制可靠性，需确保主机供电及网络连通
• 版本兼容性：Wirepod API 升级可能导致端点变更，建议锁定测试通过的版本组合