@acefelix/jarvis

中文文档
2.5.1发布于 2026/11/08Apache-2.0零依赖近 30 天下载 1834

J.A.R.V.I.S — 你的钢铁侠同款桌面 AI 助手。可对话、可操作电脑、可后台常驻、能听会说,内置 70+ 工具(MCP 生态接入后可扩展至 100+)、多模型动态切换。

中文使用文档
文档目录8 节
  1. 安装
  2. 快速开始
  3. 为什么需要 JARVIS?
  4. 核心能力
  5. 效果展示
  6. 了解更多
  7. 反馈
  8. 许可证
J.A.R.V.I.S.

J.A.R.V.I.S.

License: Apache 2.0 Python 3.11-3.14 npm version PyPI version CI GitHub stars

Just A Rather Very Intelligent System

「随时为您效劳,先生。」

J.A.R.V.I.S. 是一个主动陪伴你电脑的 AI 智能管家——致敬《钢铁侠》里的贾维斯。它常驻你的操作系统,能看、能听、能说、能动手:对话只是入口,把事情办了才是目的。你说"下周五前交项目报告",它登记截止日期并提前提醒你;你说"退下",它安静待机,第二天早上用一句"先生,早上好"向你播报今日简报。

不是聊天框,不是语音助手——你还没开口,它已经把事情办了。


安装

npm install -g @acefelix/jarvis

安装完成后即可运行:

jarvis

环境要求:Node.js 18+ 与 Python 3.11+(Jarvis 核心为 Python 实现,npm 包负责自动装好它)。 安装时会弹出功能选装菜单,可选装语音、GUI 操控、浏览器自动化、摄像头、MCP 等能力; 直接回车即全装,输入序号用逗号分隔(如 1,3,5)按需安装,0 只装核心。

也可以用 Python 直接安装:pip install "jarvis-agent[all]" 或 uv tool install "jarvis-agent[all]"(更快)。 详细安装方式与各平台系统依赖见 安装指南。

快速开始

jarvis --init    # 交互式配置:选厂商 → 确认模型 → 输 Key → 自动测试连接 → 保存
jarvis           # 开聊:自然语言直接说,输入 "/" 弹命令面板,Tab 补全
  • 默认接阿里云 DashScope(qwen3.7-plus 多模态),也可 export DASHSCOPE_API_KEY=sk-xxx 后直接启动
  • 所有配置在 ~/.jarvis/(settings.toml + models.toml),/mode 切换权限模式,/think 调深度思考
  • 遇到功能不可用?jarvis --doctor 一键诊断依赖与配置

为什么需要 JARVIS?

现状痛点JARVIS 的回答
AI 聊天工具很多,但没几个能真正替你操作电脑70+ 内置工具(接入 MCP / harness 可扩展至 100+):文件、命令、浏览器、键鼠操控、截屏识图、摄像头、邮件——ReAct 循环自主规划执行,GUI 自动化像人一样点按拖拽
云端助手不认识你的电脑,数据也不在你手里本地优先:常驻你的系统、读你的文件、操控你的软件;记忆、日志、配置全在本地 ~/.jarvis,密钥进系统凭据管理器
大多数助手每次都像初见,交代过的背景全忘三层记忆:会话存盘 + 长期记忆 + 画像记忆(自动提炼你的习惯偏好),越用越懂你

核心能力

能力一句话
🖥️ 终端原生 AgentRich 终端 REPL + 70+ 工具(可扩展至 100+)+ ReAct 编排,Ctrl+C 任意阶段打断
🎙️ 能听会说/voice 逐轮语音对话,/talk 全双工实时聊天(说话即打断),TTS 播报主动提醒
🖱️ 操控电脑鼠标/键盘/截屏/窗口管理 + 视觉模板定位,像人一样操作任意软件
🗓️ 主动管家每日简报、定时提醒(桌面与终端 REPL 都能对话安排)、截止日期追踪、系统监控——不用叫,它自己看着办
🧠 三层记忆会话存盘 + 长期记忆 + 画像提炼,越用越懂你
📱 多端同会话jarvis-desktop 桌面壳 / 手机扫码 / 微信 ClawBot,三端共享同一会话
🧩 开放生态MCP 接入、插件市场、Skill 技能包、CLI-Anything 把任意软件变工具、多 Agent 协作
🔐 安全底线五层权限 + 四级沙箱 + 操作审计 + keyring 加密存储,危险操作硬阻断

接入自由:支持 11 家厂商(阿里云 DashScope / DeepSeek / OpenAI / 智谱 / Anthropic / Kimi / MiniMax / SiliconFlow / 小米 MiMo / Google Gemini / 自定义兼容服务),/models 双击即改、运行中热切换。

效果展示

jarvis-desktop 工作台 终端 REPL

桌面工作台与终端 REPL · 更多截图见 GitHub 仓库

了解更多

本 npm 包是 J.A.R.V.I.S 的官方安装入口,安装时会自动从 PyPI 拉取对应的 Python 核心包 jarvis-agent 并暴露 jarvis 命令;核心代码与文档均在上方 GitHub 仓库中开源。

反馈

J.A.R.V.I.S. 仍处于开发与验证阶段,使用中如遇问题欢迎反馈:[email protected]。

许可证

Apache License 2.0 © aceFelix

版本与发布记录

@acefelix/jarvis 共发布 18 个版本,首次发布于 2026/08/14;过去 12 个月发布了 18 个版本。

版本发布日期距今
2.5.1latest2026/11/08今天
2.5.02026/11/071 天前
2.4.02026/11/061 天前
2.3.52026/11/034 天前
2.3.42026/11/017 天前
2.3.22026/10/317 天前

关于 @acefelix/jarvis 的常见问题

@acefelix/jarvis 是什么?

J.A.R.V.I.S — 你的钢铁侠同款桌面 AI 助手。可对话、可操作电脑、可后台常驻、能听会说,内置 70+ 工具(MCP 生态接入后可扩展至 100+)、多模型动态切换。

如何安装 @acefelix/jarvis?

在项目目录运行 npm install @acefelix/jarvis,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 jarvis,可以用 npx jarvis 直接运行。

@acefelix/jarvis 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/acefelix__jarvis 是否存在。

@acefelix/jarvis 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=14.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@acefelix/jarvis 可以商用吗?

@acefelix/jarvis 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@acefelix/jarvis 的下载量有多少?

根据 npm 官方下载统计,@acefelix/jarvis 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,834 次,日均约 61 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@acefelix/jarvis 还在维护吗?

最新版本 2.5.1 发布于 2026/11/08(今天);至今共发布 18 个版本,其中过去 12 个月发布了 18 个;首次发布于 2026/08/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。