# @acefelix/jarvis 中文文档

规范地址：https://npmcn.com/package/%40acefelix/jarvis/

版本：2\.5\.1
npm 元数据更新时间：2026-11-07T17:48:43.753Z
中文译文更新时间：2026-11-08T09:32:00.947Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40acefelix/jarvis
原文对照：https://npmcn.com/package/%40acefelix/jarvis/?lang=original
项目主页：https://github.com/aceFelix/jarvis
源码仓库：https://github.com/aceFelix/jarvis

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：22.5 kB，4 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=14\.0\.0
- 运行依赖：0 个
- 首次发布：2026-08-14T07:39:06.763Z
- 最新版本发布：2026-11-07T17:48:43.629Z
- 近 30 天下载量：1834（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

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

## 安装

```sh
npm install @acefelix/jarvis
```

也可以使用：`pnpm add @acefelix/jarvis`、`yarn add @acefelix/jarvis`、`bun add @acefelix/jarvis`

## README

![J.A.R.V.I.S.](https://raw.githubusercontent.com/aceFelix/jarvis/master/assets/jarvis-reactor-header.svg)

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

[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/aceFelix/jarvis/blob/master/LICENSE) [![Python 3.11-3.14](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue.svg)](https://www.python.org/downloads/) [![npm version](https://img.shields.io/npm/v/@acefelix/jarvis?logo=npm&logoColor=white)](https://www.npmjs.com/package/@acefelix/jarvis) [![PyPI version](https://img.shields.io/pypi/v/jarvis-agent?logo=python&logoColor=white)](https://pypi.org/project/jarvis-agent/) [![CI](https://github.com/aceFelix/jarvis/actions/workflows/ci.yml/badge.svg)](https://github.com/aceFelix/jarvis/actions) [![GitHub stars](https://img.shields.io/github/stars/aceFelix/jarvis?style=social)](https://github.com/aceFelix/jarvis)

> **J**ust **A** **R**ather **V**ery **I**ntelligent **S**ystem
> 
> 「随时为您效劳，先生。」

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

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

* * *

## 安装

```bash
npm install -g @acefelix/jarvis
```

安装完成后即可运行：

```bash
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]"`（更快）。 详细安装方式与各平台系统依赖见 [安装指南](https://github.com/aceFelix/jarvis/blob/master/docs/guide/installation.md)。

## 快速开始

```bash
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`，密钥进系统凭据管理器 |
| 大多数助手**每次都像初见**，交代过的背景全忘 | 三层记忆：会话存盘 + 长期记忆 + 画像记忆（自动提炼你的习惯偏好），越用越懂你 |

## 核心能力

| 能力 | 一句话 |
| --- | --- |
| 🖥️ **终端原生 Agent** | Rich 终端 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 工作台](https://raw.githubusercontent.com/aceFelix/jarvis/master/assets/screenshots/desktop-workbench0.png) ![终端 REPL](https://raw.githubusercontent.com/aceFelix/jarvis/master/assets/screenshots/repl-chat0.png)

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

## 了解更多

-   📦 项目主页与完整文档：[https://github.com/aceFelix/jarvis](https://github.com/aceFelix/jarvis)
-   🚀 新手上手指南：[USER\_GUIDE.md](https://github.com/aceFelix/jarvis/blob/master/USER_GUIDE.md)
-   🖥️ 桌面应用：[jarvis-desktop](https://github.com/aceFelix/jarvis-desktop)

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

## 反馈

J.A.R.V.I.S. 仍处于**开发与验证阶段**，使用中如遇问题欢迎反馈：**[13985465782@163.com](mailto:13985465782@163.com)**。

## 许可证

Apache License 2.0 © aceFelix

## 常见问题

### @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 和提交记录判断。