adewaskar/jarvis

项目介绍

JARVIS 是一个运行在桌面浏览器中的免提语音助手，界面用 Three.js 和 GLSL 做成钢铁侠风格的全息交互效果。说出“Hey Jarvis”后，它会把语音转成文字，交给 Claude Code 大脑处理，再用语音回答。大脑可以访问你已配置的 MCP 服务器，因此能搜索网页、生成图片、控制 Android 手机、驱动 Playwright，或读取账号连接器。

系统分为两个进程：浏览器负责界面和语音，本地 Node 桥接进程（bridge/server.mjs，端口 8787）负责大脑和操作。桥接进程运行 Claude Agent SDK，以无头方式启动真正的 claude CLI，并复用你已登录的 Claude Code 账号，不需要单独提供 API key。应用本身是小型 Node Web 应用，模型计算发生在 Anthropic 服务器上。

快速使用

准备：已安装并登录 Claude Code、Node.js 20 或更高版本，以及可访问麦克风和 WebGL 的真实 Chrome 或 Edge 窗口。ElevenLabs API key 可选，用于提升语音和转写质量。

npm install
npm start

在 Chrome 中打开终端打印的地址，点击 INITIALISE，允许麦克风权限，然后说“Hey Jarvis”。也可以分两个终端启动：npm run bridge 启动大脑，npm run dev 启动界面，再打开 本地应用。嵌入在编辑器或预览面板中的窗口会阻止麦克风访问，必须使用真实浏览器窗口。npm run setup 会逐项检查这些前提条件。

操作与能力

按空格键可以不喊唤醒词直接说话；JARVIS 说话时插话会打断他（barge-in）。D 打开诊断面板，T 做音频自检，V 切换浏览器语音，Escape 让助手待机。智能体还能通过 ui_theme、ui_reactor、ui_orbit、ui_chrome、ui_effect 等工具控制界面，所以可以用语音命令改颜色或把图片放到反应堆轨道上。HUD 面板的 HTML 会经过 DOMPurify、类名白名单和严格 CSP 清洗后再渲染。

权限与安全

工具门控默认只读：搜索、生成和查询可以运行，发送、点击、删除、安装、支付等有副作用的操作会被拒绝。文件工具被限制在 ~/.jarvis/workspace、临时目录以及 JARVIS_FILE_ROOTS 指定的目录；~/.ssh、~/.claude 等存放凭据的路径即使在这些目录内也会被拒绝。要允许有副作用的工具（包括 Bash、Write、Edit），需运行 npm run bridge:writes 或 npm start -- --writes。开启写入后，shell 能访问你的用户账号可访问的任何位置，启用前应先阅读 decideTool()。

配置与限制

模型默认使用 claude-opus-5、推理强度 medium，可通过 JARVIS_MODEL 和 JARVIS_EFFORT 修改。桥接进程通过环境变量配置，前端设置写在由 .env.example 复制的 .env.local 中。桥接进程默认监听 127.0.0.1，如果暴露到网络，应先加自己的身份验证。claude.ai 的账号连接器默认不加入会话，需要设置 JARVIS_ACCOUNT_CONNECTORS=1。测试用 npm test 运行，不会打开智能体会话。项目使用 MIT 许可证；public/audio/ 中的启动音效随项目用于演示，如果用于商业化，需自行处理音频版权。

HotRepo 点评

项目创建于 2026-08-02，现有 836 个 Star 和 358 个 Fork；目前记录到的唯一一条 TypeScript 日榜快照来自 2026-11-12，当天排名第 11、新增 43 个 Star。这个快照说明它获得过关注，但可用的同口径数据太少，不足以判断趋势。更值得关注的是架构取舍：复用已有的 Claude Code 登录降低配置成本，但助手实际能做什么，取决于你 ~/.claude.json 中已经安装的 MCP 服务器。对于无法弹出确认对话框的语音界面，默认只读和显式的 --writes 开关是具体的防护设计。