chika5105/raxis
GitHub: chika5105/raxis
RAXIS 是一个为自主 AI 智能体设计的运行时约束内核，通过十二条不可妥协的不变量和隔离 microVM 确保智能体无法执行任何超出结构权限的操作。
Stars: 3 | Forks: 0
# RAXIS
十二个不可妥协的不变量确保了智能体无法执行权限在结构上未允许的任何操作。隔离的 microVM、密码学审计链、凭证代理、故障关闭（fail-closed）的意图准入。请参阅 [`raxis/specs/invariants.md`](raxis/specs/invariants.md) 获取完整的不变量目录，并参阅 [`raxis/README.md`](raxis/README.md) 获取项目级别的概述。
观看当前演示：。
## 仓库布局
```
flowchart TD
root["Repository root"]
root --> workspace["raxis/
Rust workspace: kernel, planner-core, IPC, audit, store, dashboard backend"] root --> site["raxis-site/
Next.js marketing site and docs browser"] root --> ci[".github/
CI, release, spec graph, CLA check, branch protection"] root --> license["LICENSE + raxis/LICENSE-SSPL.txt
SSPL terms"] ``` `raxis/` 是一个独立的 Cargo workspace；`raxis-site/` 是一个独立的 Next.js 项目，它为公共文档站点 镜像了 `raxis/specs/` / `raxis/guides/` 的内容。
## 文档导航
| 需求 | 从这里开始 |
|---|---|
| 通过 Homebrew 安装并运行首个倡议 | [`raxis/guides/getting-started/`](raxis/guides/getting-started/) |
| 从源码构建并运行本地内核 | [`raxis/guides/SETUP.md`](raxis/guides/SETUP.md) |
| 维护发布 / Homebrew pipeline | [`raxis/release/README.md`](raxis/release/README.md) |
| 查找针对性的运维指南 | [`raxis/guides/recipes/`](raxis/guides/recipes/) |
| 了解安全模型 | [`raxis/guides/security/raxis-security-model.md`](raxis/guides/security/raxis-security-model.md) |
| 检查不变量与规格说明 | [`raxis/specs/README.md`](raxis/specs/README.md) 和 [`raxis/specs/invariants.md`](raxis/specs/invariants.md) |
## 安装
```
brew tap chika5105/raxis
brew install raxis
export RAXIS_INSTALL_DIR="$(brew --prefix raxis)/share/raxis"
raxis doctor signing-key-fp
raxis doctor canonical-images --install-dir "$RAXIS_INSTALL_DIR"
```
接下来请遵循 [`raxis/guides/getting-started/02-first-initiative.md`](raxis/guides/getting-started/02-first-initiative.md)。
## 从源码构建
```
# Rust workspace
cd raxis
cargo build --workspace --locked
# Dashboard frontend
cd dashboard-fe
npm install
npm run build
# Marketing/docs site
cd ../../raxis-site
npm install
npm run dev
```
如需完整的源码内核安装，包括宿主机要求、客户机镜像构建、信任锚点嵌入以及 macOS 代码签名，请使用 [`raxis/guides/SETUP.md`](raxis/guides/SETUP.md) 和 [`raxis/specs/v2/system-requirements.md §9`](raxis/specs/v2/system-requirements.md#9-building-from-source)。
`.github/workflows/` 中的任务从仓库根目录运行，在 Rust 步骤中设置 `working-directory: raxis`，而在站点构建时设置于 `raxis-site/` —— 无需重写路径。
## 许可证
SSPL-1.0。请参阅 [`LICENSE`](LICENSE)（SSPL 头部）和 [`raxis/LICENSE-SSPL.txt`](raxis/LICENSE-SSPL.txt)（完整的 SSPL 文本）。
贡献需要通过项目 CLA 签署：请参阅 [`raxis/CLA.md`](raxis/CLA.md)。每个 pull request 都以 [`.github/PULL_REQUEST_TEMPLATE.md`](.github/PULL_REQUEST_TEMPLATE.md) 开启，其中包含一个 CLA 同意复选框；`cla-check` workflow 会验证该复选框是否被勾选，并且它是 `main` 分支上的一个必需状态检查（参见 [`.github/scripts/protect-main.sh`](.github/scripts/protect-main.sh)）。
## 出处
此仓库于 2026-05-14 从 `chika5105/aegis-ai` 中拆分出来，旨在为 RAXIS 提供其独立的仓库身份。
`raxis/` 和 `.github/` 的历史记录通过 `git filter-repo` 原封不动地迁移过来（仅保留了 `main` 分支）；`raxis-site/` 作为 `git subtree` 加入，因此其 28 次提交在该前缀下均完全可达。原始的 `chika5105/aegis-ai` 仓库作为只读后备保留在原处。
Rust workspace: kernel, planner-core, IPC, audit, store, dashboard backend"] root --> site["raxis-site/
Next.js marketing site and docs browser"] root --> ci[".github/
CI, release, spec graph, CLA check, branch protection"] root --> license["LICENSE + raxis/LICENSE-SSPL.txt
SSPL terms"] ``` `raxis/` 是一个独立的 Cargo workspace；`raxis-site/` 是一个独立的 Next.js 项目，它为公共文档站点
标签：Rust, Streamlit, 可视化界面, 审计系统, 网络流量审计, 访问控制, 通知系统, 隔离运行环境