Documentation Index
Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
Use this file to discover all available pages before exploring further.
扩展管理的企业策略
Devin Desktop 使用自己独立的策略路径,与 VS Code 分开。为 VS Code 配置的策略不会应用于 Devin Desktop,反之亦然。
Windows 组策略
Devin Desktop 会从注册表路径
Software\Policies\Windsurf\{ProductName} 读取策略 (例如 Software\Policies\Windsurf\Windsurf 或 Software\Policies\Windsurf\WindsurfInsiders) 。这与 VS Code 不同,后者会从 Software\Policies\Microsoft\{ProductName} 读取。步骤 1:获取 ADMX 和 ADML 文件
policies 目录,其中包含用于定义可用策略的 ADMX 模板文件。
你可以从现有的 Devin Desktop 安装中获取 ADMX 和 ADML 文件:
- 进入 Devin Desktop 的安装目录。
- 找到
policies文件夹。该文件夹包含 ADMX 模板文件 (e.g.windsurf.admx) ,以及一个存放不同语言 ADML 文件的locales子文件夹。
policies 文件夹。
步骤 2:安装策略定义文件
- 将
windsurf.admx文件复制到C:\Windows\PolicyDefinitions。 - 将
locales子文件夹中对应的 ADML 文件 (例如en-US\windsurf.adml) 复制到C:\Windows\PolicyDefinitions\<your-locale>(例如C:\Windows\PolicyDefinitions\en-US) 。
你需要具备管理员权限才能将文件复制到
PolicyDefinitions 目录。步骤 3:部署策略
大规模部署
在本地计算机上手动测试策略
-
打开本地组策略编辑器:
- 按
Windows+R打开“运行”对话框。 - 输入
gpedit.msc并按 Enter。 - 如果出现用户账户控制提示,请选择 是。
- 按
-
导航到 Windsurf 策略:
- 计算机配置 > 管理模板 > Windsurf
- 用户配置 > 管理模板 > Windsurf
- 配置策略:
- 双击你要配置的策略 (例如 AllowedExtensions) 。
- 选择 已启用 以强制实施该策略。
- 对于字符串策略 (例如
AllowedExtensions) ,请在文本字段中输入值。例如:{"publisher1": true, "publisher2": true}。 - 对于布尔策略 (例如 EnableTelemetry) ,选择 已启用 或 已禁用 即可设置其值。
- 选择 确定 以保存更改。
macOS 配置描述文件
.mobileconfig) ,其中包含与可用策略相对应的键值对。
这些描述文件可以通过移动设备管理 (MDM) 解决方案进行部署,也可以手动安装到单个设备上。
步骤 1:获取示例配置描述文件
.mobileconfig 文件。要在已安装 Devin Desktop 的 macOS 设备上找到该示例文件,请按以下步骤操作:
- 打开 Finder 并前往
/Applications。 - 右键点击 Windsurf.app,然后选择 Show Package Contents。
- 前往
Contents/Resources/app/policies。 - 找到示例
.mobileconfig文件。
步骤 2:配置策略值
- 将示例
.mobileconfig文件复制到一个便于操作的位置 (例如你的桌面或 Documents 文件夹) 。 - 用文本编辑器打开复制后的文件。
- 根据你的需求编辑策略值:
步骤 3:部署策略
大规模部署
在本机上手动测试策略
-
安装配置描述文件:
- 保存你编辑后的
.mobileconfig文件。 - 在 Finder 中双击该
.mobileconfig文件。 - 系统设置会随即打开。查看描述文件详情,然后选择安装。
- 如果出现提示,请使用管理员凭据完成身份验证。
- 保存你编辑后的
-
验证描述文件是否已安装:
- 打开 系统设置。
- 前往 隐私与安全性 > 描述文件 (旧版本中为 通用 > 设备管理) 。
- 确认你的 Devin Desktop 配置描述文件已显示在列表中。
- 启动 Devin Desktop,查看策略是否已生效。
策略会立即应用于新启动的 Devin Desktop 实例。如果 Devin Desktop 已在运行,你可能需要重新启动它。
移除配置描述文件
- 打开 系统设置 > 隐私与安全 > 描述文件。
- 选择 Devin Desktop 配置描述文件。
- 点击 移除 (或 -) 按钮。
- 使用管理员凭据进行身份验证,以确认移除。
Linux JSON 策略
/etc/windsurf/policies/policy.json,以在 Linux 设备上配置 Devin Desktop 的设置策略。此方法使用简单的 JSON 格式来定义策略值。
Devin Desktop 会从
/etc/windsurf/policies/policy.json 读取策略,而 VS Code 使用的是 /etc/vscode/policy.json。请确保为 Devin Desktop 将文件放置在正确的位置。步骤 1:获取示例策略文件
policy.json 文件。你可以从现有安装中获取该文件——它位于 Devin Desktop 安装路径下的 resources/app/policies 目录中。
步骤 2:配置策略值
- 将示例
policy.json文件复制到可用位置:
- 使用你偏好的文本编辑器编辑该文件:
- 配置策略值。例如,如需仅允许特定扩展发布者:
步骤 3:部署策略
大规模部署
policy.json 文件。这些工具允许管理员在所有受管 Linux 设备上远程部署、更新和移除策略。
在本地机器上手动测试策略
- 创建策略目录并复制文件:
你需要具备 root 或 sudo 权限,才能在
/etc/windsurf/policies 中创建目录并管理策略文件。- 验证策略是否已安装:
- 启动 Devin Desktop (如果已经在运行,请将其重启) 。
- 打开 File > Preferences > Settings (或按
Ctrl+,) 。 - 查找与你已配置策略对应的设置——它们应显示为由你的组织管理,或带有锁形图标。
删除策略
/etc/windsurf/policies/policy.json 文件,然后重启 Devin Desktop。
扩展管理策略
AllowedExtensions 策略允许管理员定义允许的扩展发布者允许列表。
AllowedExtensions
AllowedExtensions 策略接受一个 JSON 字符串,用于指定允许哪些扩展发布者。当此策略生效时,用户只能安装来自所列发布者的扩展。
示例值:
- Windows: 通过组策略 ADMX 模板进行设置,或直接在注册表
Software\Policies\Windsurf\{ProductName}中设置。 - macOS: 在
.mobileconfig配置描述文件中设置。 - Linux: 在
/etc/windsurf/policies/policy.json中设置。
AllowedExtensions 策略被强制执行时,Devin Desktop 中的扩展视图会显示该设置由你的组织管理,用户无法自行覆盖。
