Skip to main content
本文档适用于 Devin 的联邦部署。返回 Devin 文档
气隙版 Devin Desktop 和 Devin CLI 专为无法访问互联网的网络环境而设计。推理请求会发送到你自行托管的模型端点，访问权限由经过签名并在本地校验的许可证文件控制，所有事件都会写入本地审计日志。 本指南面向负责安装、配置和维护该产品的管理员，采用运行手册的形式编排：每个页面介绍部署的一个环节，并在末尾列出可能遇到的错误代码及处理方法。
Beta 版。 气隙版目前以 Beta 版形式提供，支持的平台包括 macOS (Apple 芯片和 Intel) 、Linux (x86_64 和 aarch64) 以及 Windows (x64 和 arm64) 。

​
产品构成

Desktop 与其内置的 CLI 基于同一个发布版本 commit 构建，因此单个 Desktop 文件包即可完成一次完整且自洽的安装。

​
开始之前

​
由 Cognition 提供

​
你需要提供

​
产品使用的端点

气隙版 CLI 和 Desktop 完全通过主机上的文件进行配置。它们使用的端点就是你所配置的端点：
  • 您的模型文件中列出的模型端点。不存在 cloud 模型目录：模型列表、模型选择器和推理路由均来自该文件。端点必须使用 https://；只有回环主机 (localhost、127.0.0.0/8、[::1]) 才接受普通的 http://，例如运行在同一台机器上的 vLLM 或 Ollama 服务器。
  • 您的身份提供商 (如果你启用了 SSO (单点登录) ) 。CLI 会读取签发方的 OIDC 自动发现文档，并使用其中的授权端点、令牌端点和 JWKS 端点。
  • 你在本地配置的 MCP 服务器 (如有) 。
  • 门户 (windsurf.fedstart.com) ，管理员通过浏览器访问该门户，下载文件包并签发许可证。
审计日志和诊断信息报告均写入本地磁盘。devin update 已禁用；新版本需使用从门户下载的文件包进行安装 (参见更新) 。

​
访问控制方式

  1. 许可证 (始终启用) 。CLI 启动时，会使用嵌入在二进制程序中的公钥验证许可证文件的签名和有效期。如果没有有效的许可证，CLI 将无法启动；请参阅许可证。
  2. SSO (单点登录) (可选) 。如果你创建了一个指定 "mode": "sso" 的认证文件，则每个用户还必须通过 devin auth login 登录您的 IdP。你可以将登录权限限定为指定组的成员，正在运行的会话也会根据缓存的令牌重新验证；请参阅 SSO。
这两种机制均由 CLI 强制执行，因此无论是单独在终端中使用，还是 Desktop 中的智能体，都同样适用。

​
后续步骤

安装

从门户下载并校验安装包，完成安装后运行首次健康检查。

错误代码

完整的 LIC、IDP、MDL、NET 和 CFG 错误代码目录，以及运维人员的相应处理措施。

故障排查

devin airgap doctor 运行手册，以及需要提交给支持团队的信息。

磁盘存储格式

各操作系统下的配置路径，以及供 SIEM 摄取的审计日志 JSONL schema。