用途:为配置属性新增策略、修改已有策略(改名、调整分类等)、审查涉及策略注册的 PR,以及通过 IPolicyData 添加基于账号的策略支持。策略可经系统级机制(Windows 组策略、macOS 托管偏好、Linux 配置文件)或 Copilot 账号级策略数据锁定设置。
架构:策略来源分层、后写者胜,包括 NativePolicyService(系统级,经 @vscode/policy-watcher)、FilePolicyService(读取 /etc/vscode/policy.json)、AccountPolicyService(读取 IDefaultAccountService 的 policyData)及 MultiplexPolicyService(组合系统级与账号策略)。关键文件包括 src/vs/base/common/policy.ts、src/vs/platform/policy/common/policy.ts、configurations.ts、accountPolicyService.ts、policyExport.contribution.ts 等。
主要步骤:1)在配置属性中添加 policy 对象,含 name(PascalCase 唯一)、category、minimumVersion(取自 package.json 的 major.minor,勿硬编码旧版本)、localization.description;账号策略可加 value 函数处理 IPolicyData;字符串加枚举时必须提供等长的 enumDescriptions,否则导出失败。2)导入 PolicyCategory,现有类别含 Extensions、IntegratedTerminal、InteractiveSession、Telemetry、Update。3)运行 npm run compile-check-ts-native 验证编译。4)运行 npm run export-policy-data 重新生成 build/lib/policies/policyData.jsonc,禁止手动编辑该文件。合并到 main 需 codeowner 审查。
扩展策略:扩展作者无法直接加 policy 字段,需在 vscode-distro 的 product.json 的 extensionConfigurationPolicy 中定义,并在三个 quality 的 product.json 中添加条目、更新 package.json 中的 distro commit、重新生成并同步测试夹具。
GitHub 预览功能:若设置控制 Copilot/chat 预览或实验功能,且组织管理员应能禁用,需加 value 函数检查 policyData.chat_preview_features_enabled,用 === false 判断,返回禁用值或 undefined。
限制:值函数返回具体值覆盖用户设置,返回 undefined 则不覆盖。export-policy-data 需 GITHUB_TOKEN。常见失败原因是在错误工作目录运行导出。