4Runr OS 系统

工作正在进行

此套件目前处于活性开发阶段,不处于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 软件包。 编辑应用程序后, 运行 :

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 完整的细节.

QQ 屏幕截图

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

启动屏幕

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

主接口

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

QQ 快速启动

安装

npm install -g 4runr-os

使用量

4r

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

* 特性

完整的操作系统

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

企业安全特征

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

实时监测

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

自动更新系统

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

开发者经验

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

QQ 命令

全球命令

终极命令

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

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

QQ 配置

自动更新设置

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

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

环境变量

# 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

• 设置指南 - 详细的设置指示和故障排除
• 用户隐私 - 隐私政策和数据处理
• 简单使用( E) - 快速参考指南
• 捐款 - 如何为项目捐款

* 解决问题

"没有找到"

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

npm install -g 4runr-os-mk3

"4r:没有找到命令"

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

# 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 。 您必须配置自己的 :

# 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 问题
• 文档数字 : 完整文档
• 网站数字 : 4Runr.com (英语)

许可证

麻省理工学院执照 - 看 自由主义 详细文件.

承认

以下列方式建造:

• 拉塔图伊语Name - 终端 UI 库
• 锈 - 系统编程语言
• 节点.js - JavaScript 运行时间