# Jrvs：本地优先的智能体运行时与孵化框架

> Jrvs（Jarvis Council）是一个本地优先的智能体AI产品基础框架，支持个人和团队工作流。它提供权限化运行时、自适应任务执行、Council运行时API和CLI，以及基于SQLite的本地状态管理，可选Docker隔离执行。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-13T08:15:14.000Z
- 最近活动: 2026-05-13T08:28:19.800Z
- 热度: 161.8
- 关键词: 智能体运行时, 本地优先, Jarvis, AI框架, Docker可选, 权限管理, SQLite, 多通道, Council Runtime
- 页面链接: https://www.zingnex.cn/forum/thread/jrvs
- Canonical: https://www.zingnex.cn/forum/thread/jrvs
- Markdown 来源: ingested_event

---

# Jrvs：本地优先的智能体运行时与孵化框架

## 项目概述

**Jrvs**（Jarvis Council的缩写）是一个**本地优先的智能体AI产品基础框架**，专为个人和团队工作流设计。它提供了一个完整的智能体运行时环境，支持权限管理、自适应任务执行、子智能体编排，以及可选的Docker隔离执行。

与完全依赖云端的智能体平台不同，Jrvs强调**本地执行**和**用户控制**，所有敏感操作都经过用户批准，数据保留在本地环境中。这种设计理念对于注重隐私、需要离线工作能力或希望完全掌控AI行为的用户具有重要价值。

---

## 核心组件架构

| 组件 | 实现 | 说明 |
|-----|------|------|
| **运行时/大脑** | Council Runtime | 核心智能体执行引擎 |
| **仪表盘** | Council Dashboard | 可视化管理界面 |
| **桌面外壳** | Aegis | 桌面环境集成 |
| **Python包** | `jarvis-core` | 遗留内部兼容性（v0.1期间） |

---

## 安装方式

### macOS/Linux（一行命令）

```bash
curl -fsSL https://raw.githubusercontent.com/suhas12345685-pro/Jrvs/main/install.sh | bash
```

### Windows PowerShell

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/suhas12345685-pro/Jrvs/main/install.ps1 | iex"
```

配置官方域名后，安装命令可简化为：
```bash
curl -fsSL https://<your-domain>/install.sh | bash
```

---

## v0.1已实现功能

### 权限化运行时

- **权限区域（Permission Zones）**：定义安全边界
- **安全工作区边界**：隔离不同项目/任务的数据访问

### 自适应任务运行时

- **执行路由**：本地任务 vs 编排任务自动选择执行路径
- **前台模式**：用户交互式执行
- **后台模式**：无人值守执行
- **批准暂停模式**：敏感操作等待用户确认
- **辅助模式**：人机协作执行

### Council运行时API和CLI

位于`council/jarvis-core`：
- 完整的API服务器
- CLI工具集
- `jarvis` CLI保留为v0.1内部兼容性

### 个人模式入职/配置脚手架

- 用户引导流程
- 配置文件自动生成

### 健康/状态端点

- 运行时健康检查
- 基础聊天端点

### 本地SQLite后端

- 运行时状态持久化
- 基于文件的配置管理

---

## 执行模型

Jrvs**不强制**沙盒执行器模型。运行时根据任务特性选择正确的执行路径：

| 模式 | 适用场景 |
|-----|---------|
| **前台模式** | 需要用户交互的任务 |
| **后台模式** | 长时间运行的批处理任务 |
| **批准暂停模式** | 涉及文件修改、网络请求等敏感操作 |
| **辅助模式** | 需要人类监督的协作任务 |

---

## Docker可选性

**Docker是可选的**，不是必需的。

**何时使用Docker**：
- 用户在设置期间选择Docker
- 任务涉及不受信任/未知生成的代码

**设置期间用户可配置**：
- 安装路径
- 安全工作区路径
- OS原生运行时或Docker运行时
- Docker工作区/挂载路径（如选择Docker）

这种设计平衡了**安全性**（Docker隔离）和**便利性**（原生性能），让用户根据具体场景做出选择。

---

## 手动快速开始

### Windows

```powershell
git clone https://github.com/suhas12345685-pro/Jrvs.git
cd Jrvs/council/jarvis-core
uv sync --extra dev --extra server
uv run python -c "import jarvis.server; print('server import ok')"
uv run ruff check .
uv run pytest tests/test_laptop_permissions.py -q
```

### macOS/Linux

```bash
git clone https://github.com/suhas12345685-pro/Jrvs.git
cd Jrvs/council/jarvis-core
uv sync --extra dev --extra server
uv run python -c "import jarvis.server; print('server import ok')"
uv run ruff check .
uv run pytest tests/test_laptop_permissions.py -q
```

---

## 安全与安全保障

| 特性 | 说明 |
|-----|------|
| **安全工作区边界** | 正常文件/项目工作在用户批准的工作区内进行 |
| **权限区域** | 强制执行安全工作区、用户文件夹、敏感数据和系统路径之间的边界 |
| **Docker可选性** | 用户可选择Docker进行隔离执行，但不是正常本地使用的必需项 |
| **回滚** | 文件修改在支持的情况下捕获先前状态 |
| **回收站** | 删除操作将文件移至本地回收站/恢复路径 |
| **批准门** | 风险操作暂停等待用户批准 |

---

## 可选适配器（通道）

运行时支持的可选适配器集合：

- WhatsApp
- Discord
- Telegram
- Slack
- Teams
- Google Chat
- iMessage
- WeChat

**重要**：这些通道是可选适配器，默认不应全部启动。

---

## Hatchery系统

Hatchery为每个智能体生成身份/配置文件：

- `IDENTITY.md`
- `SOUL.md`
- `AGENTS.md`
- `USER.md`
- `MEMORY.md`
- `HEARTBEAT.md`
- `TOOLS.md`

**用户可见的智能体名称**在Hatchery设置期间选择。在此之前，使用**Agent**或**Agent Runtime**。不要硬编码Jarvis作为公共智能体名称。

---

## 项目价值与定位

Jrvs的定位介于完全托管的云智能体平台和底层开发框架之间：

**vs 云端智能体平台**：
- ✅ 数据本地存储，隐私可控
- ✅ 离线工作能力
- ✅ 无供应商锁定
- ❌ 需要本地安装和配置

**vs 纯开发框架**：
- ✅ 开箱即用的运行时和仪表盘
- ✅ 预置安全模型和权限系统
- ✅ 多通道集成支持
- ❌ 比专用框架灵活性稍低

**适用场景**：
- 注重数据隐私的个人用户
- 需要离线AI辅助能力的团队
- 希望完全控制智能体行为的开发者
- 需要本地知识库和记忆层的长期项目

---

## 相关资源

- 项目仓库：https://github.com/suhas12345685-pro/Jrvs
- 贡献指南：参见`CONTRIBUTING.md`