OpenShell 0.1.x 中的重要新特性：稳定的发布节奏、新的隔离原语、扩展的扩展表面以及新的 API。阅读 0.1.0 升级指南。OpenShell 是舰队自主 AI 代理的安全、私密运行时。代理在可以读取文件、安装软件包、调用 API 和使用凭据时最有用。OpenShell 提供这种能力，而无需让它们无限制访问您的数据、秘密或网络。您在策略中声明每个代理可以接触什么，OpenShell 则执行这些策略。如何运作 OpenShell 通过两种方式管理代理可以做什么：它对内核进行工具化，以在运行时对每个文件访问、系统调用和网络连接执行策略，并使用形式验证在应用政策变更之前检查其允许的内容。内核级执行。每个代理在隔离的沙箱中运行。内核控制限制它可以访问的文件和可以进行的系统调用，而且每个网络连接在离开沙箱之前都要通过政策检查。代理永远不会看到真实凭据；OpenShell 仅将它们添加到面向批准终端的请求中。形式验证的政策变更。在策略变更获得批准之前，OpenShell 使用形式验证标识它将授予的风险新的访问权限，例如使用凭据访问新主机或调用新 API 方法，因此这些更改需要等待人工审核。关于网关、监督者和沙箱如何组合在一起，请参见架构。快速入门 您需要 Linux、Apple Silicon 上的 macOS 或带有 WSL 2（实验性）的 Windows，以及 Docker、Podman 或主机虚拟化。有关详细信息，请参见支持矩阵。curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh openshell sandbox create --name demo 安装程序设置 CLI 和本地网关。默认沙箱镜像为未安装代理的最小 Ubuntu。要运行真实代理，请遵循运行您的第一个代理：它会针对免费的 OpenRouter 模型运行 OpenCode，并展示如何在代理需要时批准新的访问权限。进一步探索 沙箱：镜像、运行时、GPU 和生命周期。政策：文件系统、网络和进程规则，带有顾问和证明器用于审核更改。提供者：仅在批准的终端上有效的凭据，包括推理。网关：沙箱、策略和访问控制平面。Kubernetes：使用 Helm 部署网关。您的 CNI 必须执行 NetworkPolicy。可扩展性：中间件、拦截器和计算驱动程序。教程：逐步政策和代理演练。预发布和开发版：尝试即将发布的版本或 main 上的最新提交。代理技能 为您的编码代理安装公共 OpenShell 技能：npx skills add NVIDIA/OpenShell 这些技能教您代理如何驱动 OpenShell CLI、编写沙箱策略以及调试网关和推理路由。它们位于 skills/ 中，无需 OpenShell 源结帐即可工作。SDK SDK 连接应用程序与 OpenShell 网关。它们不安装 CLI。尽可能使用相同的 OpenShell 版本进行 SDK 和网关。语言 安装 文档 Python uv add openshell README TypeScript npm install @nvidia/openshell-sdk (GitHub Packages) README Go go get github.com/NVIDIA/OpenShell/sdk/go@latest README Rust cargo add openshell-sdk --git https://github.com/NVIDIA/OpenShell --tag <release-tag> 安装和使用 社区问题和讨论：GitHub Discussions 错误报告和功能请求：GitHub Issues，使用问题模板 安全漏洞：遵循 SECURITY.md。请勿打开 GitHub 问题。路线图：OpenShell 路线图和 RFC 板块 在云中试用：Brev 可启动的 OpenShell 以代理优先的方式构建：它是与其所支持的相同代理驱动工作流开发的。有关开发设置和贡献工作流，请参见 CONTRIBUTING.md，AGENTS.md 了解代码库编码惯例。遥测 OpenShell 收集匿名遥测，限于操作类别和数量，以帮助改善项目。它不收集沙箱名称、主机名、文件路径、提示、凭据、提供者或模型名称或用户内容。要禁用它，请在网关上设置 OPENSHELL_TELEMETRY_ENABLED=false，或者在 Helm 安装中设置 server.telemetryEnabled=false。您还可以完全编译遥测。有关详细信息，请参见遥测以及社区遥测报告以获取已发布的使用趋势。免责声明和声明 本软件会自动检索、访问或与外部材料互动。所检索的材料不会与本软件一起分发，仅受单独的条款、条件和许可的管辖。您独自负责查找、审核并遵守所有适用的条款、条件和许可，并验证任何检索材料的安全性、完整性和适用性，以满足您的特定用例。本软件按“原样”提供，不附带任何类型的保修。作者不作任何陈述或保证。