# 4runr-os 中文文档

规范地址：https://npmcn.com/package/4runr-os/

版本：2\.11\.13
npm 元数据更新时间：2026-07-30T16:00:45.655Z
中文译文更新时间：2026-11-05T22:55:29.966Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/4runr-os
原文对照：https://npmcn.com/package/4runr-os/?lang=original
项目主页：https://github.com/KyanBergeron4Runr/4Runr-AI-Agent-OS#readme
源码仓库：https://github.com/KyanBergeron4Runr/4Runr-AI-Agent-OS

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

- 包体积（解压后）：343 MB，15012 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：5 个
- 首次发布：2025-12-01T18:49:11.385Z
- 最新版本发布：2026-07-30T16:00:45.517Z
- 近 30 天下载量：10345（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：551（近 12 个月 551 个）

## 中文简介

4Runr AI Agent OS - AI代理的安全终端接口. v2.11.13: 修复Windows更新器挂起(重新移动查找/超时等;可靠启动交接).

## 安装

```sh
npm install 4runr-os
```

也可以使用：`pnpm add 4runr-os`、`yarn add 4runr-os`、`bun add 4runr-os`

## README

# 4Runr OS 系统

![4Runr OS](https://img.shields.io/npm/v/4runr-os?style=for-the-badge) ![License](https://img.shields.io/npm/l/4runr-os?style=for-the-badge) ![Node](https://img.shields.io/node/v/4runr-os?style=for-the-badge)

**AI代理的完整操作系统 - 包括终端接口(TUI),AI代理证书的网关组件,基础管弦结构,以及与外部工具的连接.**

[安装](https://npmcn.com/package/4runr-os/#readme--installation) 二. 支助 [特征](https://npmcn.com/package/4runr-os/#readme--features) 二. 支助 [文档](https://npmcn.com/package/4runr-os/#readme--documentation) 二. 支助 [支助](https://npmcn.com/package/4runr-os/#readme--support)

* * *

## 工作正在进行

**此套件目前处于活性开发阶段,不处于MVP(最小活性产品)状态.**

-   特征正在得到积极开发,可能会发生变化
-   一些功能可能是不完整或实验性的
-   不同版本之间可能发生断裂变化
-   目前不建议使用

**状态 :** MVP前/开发阶段

## Monorepo发展

如果你在监狱里工作的话 **4Runr-AI-代理操作系统** repo:出入口和MK3 TUI **来源** 住在楼下 **`apps/os-server`** 财务报告和审定财务报表 **`apps/os-tui`**中文本 **`packages/os-cli/apps/os-server`** 财务报告和审定财务报表 **`packages/os-cli/os-tui`** 用于 npm 软件包。 编辑应用程序后, 运行 :

```bash
cd packages/os-cli
npm run sync:vendored
```

见 **`docs/CANONICAL-SOURCES.md`** (取取根)为通治.

## 安全通知

**2.2.0+版本包括全面的安全保护:**

✅ **固定(v2.2.0):**

-   命令注射保护
-   SSRF( 服务器- 系统请求伪造) 保护
-   所有敏感数据的加密存储(AES-256-GCM)
-   JSON 计划验证
-   软件包完整性核查

✅ **固定(v2.1.56):**

-   任意代码执行( 工具测试已禁用)
-   路径向外攻击( 用户名验证)
-   不安全文件权限

**仍然预用 MVP - 谨慎使用 :**

-   生产环境中不使用
-   QQ 不使用管理员/ root 权限运行
-   QQ 不连接到未信任的网关

**保护的是什么**

-   QQ 配置文件加密 `~/.4runr/`
-   QQ 会话符号加密
-   QQ 私人IP 地址被屏蔽
-   QQ 软件包更新验证完整性

见 [安全资料-2.2.0.md](https://npmcn.com/package/4runr-os/SECURITY-FIXES-2.2.0.md) 完整的细节.

* * *

## QQ 屏幕截图

> **说明:** GitHub上有屏幕截图。 如果图像不显示,可能需要被推到寄存器.

### 启动屏幕

![4Runr OS Boot Screen](https://github.com/KyanBergeron4Runr/4Runr-AI-Agent-OS/raw/master/packages/os-cli/images/screenshot-boot.png)

_初始化屏幕显示系统启动和准备状态._

### 主接口

![4Runr OS Terminal Interface](https://github.com/KyanBergeron4Runr/4Runr-AI-Agent-OS/raw/master/packages/os-cli/images/screenshot.png)

_完整的终端接口显示系统状态,操作日志,资源和能力._

* * *

## QQ 快速启动

### 安装

```bash
npm install -g 4runr-os
```

### 使用量

```bash
4r
```

**就这样!** 终端接口自动发射.

* * *

## \* 特性

### 完整的操作系统

-   **终端接口( TUI)** - Rust + Ratatui高性能本地终端
-   **网关组件** - AI代理证书和认证的内置组件
-   **管线层** - Node.js后端管理系统操作和结构
-   **实时更新** - 实时监测代理运行、系统资源和网络状况
-   **美丽的设计** - 有4Runr品牌颜色的清洁、专业界面
-   **跨平台** - 在Windows、macOS和Linux上工作

### 企业安全特征

-   **盾牌系统** - PII检测、注射阻断、幻觉检查
-   **哨兵监测** - 实时安全监测和警报
-   **政策执行** - 具体的安全政策和控制措施
-   **审计日志** - 完成所有业务的审计跟踪

### 实时监测

-   **系统状态** - CPU、内存、网络监测
-   **代理业务** - 实时日志流和状态更新
-   **网关构成部分** - 内部网关组成部分状况和衡量标准
-   **外部网关连接** - 与外部工具和服务的连接状况
-   **资源追踪** - 主动运行、连接和能力

### 自动更新系统

-   **自动更新** - 自动检查并安装新版本
-   **可配置** - 通过配置命令启用/失效自动更新日期
-   **0 休整时间** - 更新在背景中无缝进行

### 开发者经验

-   **0 配置** - 工作出来的盒子
-   **预建二进制** - 没有需要的Rust或建造工具
-   **快速启动** - 优化快速发射时间
-   **综合日志** - 调试的详细日志

* * *

## QQ 命令

### 全球命令

| 命令 | 说明 |
| --- | --- |
| `4r` | 启动4Runr OS终端接口(建议) |
| `4runr` | 别名 `4r` |
| `4runr-os` | 别名 `4r` |
| `4runr-setup` | 运行初始设置向导 |

### 终极命令

一旦TUI运行,您就可以使用这些命令:

-   `help` - 显示所有可用的命令
-   `config` - 管理配置设置
-   `status` - 显示系统状态
-   `agents` - 列出现有代理人
-   `runs` - 查看代理运行历史
-   `exit` 或者说 `Ctrl+C` - 离开终端

* * *

## QQ 配置

### 自动更新设置

控制操作系统内部的自动更新:

```bash
4r
# Then in the terminal:
config auto-update disable   # Disable automatic updates
config auto-update enable    # Enable automatic updates
config auto-update status    # Check current setting
```

### 环境变量

```bash
# Disable auto-update (still checks for updates)
NO_AUTO_UPDATE=1 4r

# Disable update check entirely
NO_UPDATE_CHECK=1 4r

# Set gateway URL (REQUIRED - no default for security)
# You must provide your own gateway URL - the package does not include any default server
GATEWAY_URL=http://your-gateway:3001 4r

# Or connect via command
4r gateway connect http://your-gateway:3001
```

### 配置文件

设置保存于 `~/.4runr/config.json` 并且持续到整个会议.

* * *

## 所需经费

-   **节点.js** 18.0.0 或更高
-   **无** (来与节点.js)

**没有Rust或建造工具需要!** 预建的二进制包括用于:

-   视窗 (x64)
-   macOS (x64, ARM64) (中文(简体) )
-   Linux (x64, ARM64) (英语)

* * *

## 建筑

4Runr OS是一个完整的操作系统,包括:

-   **终端接口( TUI)**: Rust + Ratatui 前端 - 用户界面
-   **网关组件**: 处理AI代理证书和认证(OS的一部分)
-   **管线层**: Node.js后端管理系统操作
-   **外部网关连接**:与外部工具和服务的链接(不是本地的)
-   **基础结构**: 用于监测、安全和资源管理的OS核心构成部分
-   **通讯**: HTTP/SSE 用于组件之间的实时更新
-   **安全系统**: 已建盾牌和哨兵系统

```
┌─────────────────────────────────────┐
│         4Runr OS                    │
│  ┌───────────────────────────────┐  │
│  │  Terminal Interface (TUI)     │  │  ← User Interface (Rust + Ratatui)
│  │  (Rust + Ratatui)             │  │
│  └───────────┬───────────────────┘  │
│              │                       │
│  ┌───────────▼───────────────────┐  │
│  │  Orchestration Layer          │  │  ← System Management (Node.js)
│  │  (Node.js)                    │  │
│  └───────────┬───────────────────┘  │
│              │                       │
│  ┌───────────▼───────────────────┐  │
│  │  Gateway Component            │  │  ← AI Agent Credentials (OS Component)
│  │  (AI Agent Auth)              │  │
│  └───────────┬───────────────────┘  │
│              │                       │
│  ┌───────────▼───────────────────┐  │
│  │  External Gateway Connections │  │  ← External Tools & Services
│  │  (Non-local)                  │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘
```

**关键点**: 网关是一个 **组件** 证书,与网关分开 **连接** 用于外部工具。 操作系统包括TUI,网关组件,管弦乐,以及基础结构——不仅仅是接口.

* * *

## 页:1

-   **[设置指南](https://npmcn.com/package/4runr-os/SETUP.md)** - 详细的设置指示和故障排除
-   **[用户隐私](https://npmcn.com/package/4runr-os/USER-PRIVACY.md)** - 隐私政策和数据处理
-   **[简单使用( E)](https://npmcn.com/package/4runr-os/EASY-USAGE.md)** - 快速参考指南
-   **[捐款](https://npmcn.com/package/4runr-os/CONTRIBUTING-CLI.md)** - 如何为项目捐款

* * *

## \* 解决问题

### "没有找到"

包将尝试自动安装. 如果失败:

```bash
npm install -g 4runr-os-mk3
```

### "4r:没有找到命令"

确保 npm 全球 bin 在您的路径 :

```bash
# Check PATH
echo $PATH | grep npm

# Add to PATH if needed (add to ~/.bashrc or ~/.zshrc)
export PATH=$PATH:$(npm config get prefix)/bin
```

### 终端太小

TUI要求最低航站楼尺寸为80x24. 调整您的终端窗口大小 .

### 连接问题

**关键是:** 该软件包不包括任何用于安全的默认网关 URL 。 您必须配置自己的 :

```bash
# Set gateway URL (required)
export GATEWAY_URL=http://your-gateway:3001

# Test gateway connection
curl http://your-gateway:3001/health

# Then run
4r
```

**安全说明:** 软件包中没有包含服务器URL,IP地址,或证书. 用户必须配置自己的网关连接.

* * *

## ++ 辅助

-   **问题**数字 : [GitHub 问题](https://github.com/KyanBergeron4Runr/4Runr-AI-Agent-OS/issues)
-   **文档**数字 : [完整文档](https://npmcn.com/package/4runr-os/SETUP.md)
-   **网站**数字 : [4Runr.com (英语)](https://4runr.com/)

* * *

## 许可证

麻省理工学院执照 - 看 [自由主义](https://npmcn.com/package/LICENSE) 详细文件.

* * *

## 承认

以下列方式建造:

-   [拉塔图伊语Name](https://github.com/ratatui-org/ratatui) - 终端 UI 库
-   [锈](https://www.rust-lang.org/) - 系统编程语言
-   [节点.js](https://nodejs.org/) - JavaScript 运行时间

* * *

**由四跑队制作**

[回到顶部](https://npmcn.com/package/4runr-os/#readme-4runr-os)

## 常见问题

### 4runr-os 是什么？

4Runr AI Agent OS - AI代理的安全终端接口\. v2\.11\.13: 修复Windows更新器挂起\(重新移动查找/超时等;可靠启动交接\)\.

### 如何安装 4runr-os？

在项目目录运行 npm install 4runr-os，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 4runr、4runr-os、4r、4runr-smoke、4runr-setup，可以用 npx 4runr 直接运行。

### 4runr-os 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### 4runr-os 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### 4runr-os 需要什么版本的 Node\.js？

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

### 4runr-os 可以商用吗？

4runr-os 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### 4runr-os 的下载量有多少？

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

### 4runr-os 还在维护吗？

最新版本 2\.11\.13 发布于 2026/07/31（3 个月前）；至今共发布 551 个版本，其中过去 12 个月发布了 551 个；首次发布于 2025/12/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。