信息卡

一句话定位

用普通摄像头把双手变成屏幕操控接口：笔记、图片、3D 模型以玻璃卡片悬浮在相机画面上，徒手捏合、拖动、缩放，并可接入任意 AI 作为"大脑"驱动整个界面。

走红原因分析

演示视觉冲击力极强——不戴头显、不用手套、不买设备，一个网络摄像头就实现了《少数派报告》式交互，天然适合短视频传播；"a body waiting for a brain" 的定位精准踩中 Agent 热潮：任何能写文件或 curl localhost 的程序都能驱动它；手势细节有真实产品感（按手型比例判定阈值、隔空抓取的颤抖瞄准动画），完成度与趣味性兼备；配套 fullstack-agent 一键全家桶和 Discord 社区也助推了口碑扩散。

核心功能拆解

• 手势体系：捏合开关卡片、捏住拖动、静止时 3D 旋转、双手缩放、快速甩动抛掷；
• 彩蛋级手势：拍手清空板面；"抓取"张开手掌收爪后隔空把远处物体拉回手中；
• 空捏侧拖可拆解/复原 3D 模型爆炸视图；
• vault 即 markdown 文件夹：Obsidian 库直接可用，barehands.json 按 title/path/kind 配置卡片；
• 媒体分区：misc 图片、fx 透明道具、models 3D 模型、holo 蓝色全息线框渲染，且有 media/ 目录"监狱"安全约束；
• AI 戒指表情：AI 写 state 文件（thinking/idle/listening/speaking），戒指实时反映会话状态；

7. 板面即舞台：board.sh 提供 present/add_card/add_img/explode/yank/hover 白名单动作与反向 state 查询。

架构与技术栈浅析

服务端仅用 Python 标准库，手部追踪用 Google MediaPipe（Apache 2.0），3D 渲染用 three.js（MIT），两者首次运行从 CDN 加载。双协议接 AI：文件通道（state 表情 + md vault）与命令通道（board.sh 动作白名单）。调试侧提供 overlay 与姿势采样器，可让 AI 针对用户手型调校阈值。

安装与环境要求

克隆后 `python3 server.py`，Chrome 打开 http://127.0.0.1:8794/stage.html 并授权摄像头即可；Python 与浏览器是全部依赖，无额外编译。Claude Code 用户可直接说 "read barehands/barehands.md and set me up" 让 agent 完成接线。

快速上手示例

git clone https://github.com/jaredrhod/barehands
cd barehands
python server.py        # Windows
# 浏览器访问 stage.html 后照着板内 Getting Started → The Gestures 练手势

进阶使用要点

推流录制用双页面方案：追踪页持摄像头，stage.html?role=render 作为带透明 alpha 的 OBS 浏览器源；可选参数 cursors=0 隐指尖环、ss=2 两倍渲染、portrait=1 转 9:16 竖屏适配 Shorts/TikTok、res=3840x2160 提升采集分辨率；更新走 ./update.sh 且用户数据不受影响。

典型应用场景

• 直播与短视频的沉浸式 AI 助手展示舞台；
• 给 Claude Code 等 Agent 加一套可视化"身体"，戒指随会话状态发光、板面展示成果；
• 挂载 Obsidian/AI 记忆库做站姿浏览的知识看板；
• 教学与创意演示中的实体交互道具。

同类生态位对比

同赛道常见方案要么依赖头显（Vision Pro 风格）、要么基于 MediaPipe 做单点鼠标替代；barehands 的独特处是把空间 UI 当作"可被任意程序驱动的躯体"，以文件+命令双协议开放给 Agent 生态，且 AGPL 许可下个人业务免费商用、闭源需联系作者授权。

资源导航

仓库含 barehands.md（agent 接入说明）与 TROUBLESHOOTING.md；姊妹项目 ai-memory-vault（记忆库 orb）、fullstack-agent（记忆+语音+面容+双手全家桶）；视频教程频道与 Discord 见 README；总入口 jaredrhod.com；接受 Ko-fi 赞助。