SuperAPI AI 工具集

policy-and-managed-settings

编程与开发

查看项目

更新于 10-16 00:32

技能介绍

用途:该技能用于在 VS Code 仓库中新增、修改或审查涉及 Copilot、智能体、LLM、AI 工具、权限、沙箱、MCP、模型、遥测、功能开关等企业策略与管理设置时,确定策略应放置的位置及其实现方式。

主要能力与规则:按受控行为的实现位置而非请求团队来选择策略目标。Copilot 智能体行为的大多数控制属于 SDK/运行时而非 VS Code。运行时的强制执行对运行时内执行的行为具有权威性;不要在 VS Code 中重复运行时的解析器、匹配器或安全决策;VS Code 策略仅适用于编辑器/工作台自身的行为。新的 Copilot 企业控制应面向共享的 managed-settings/SDK 模型。VS Code 设置到 managed-settings 的桥接仅用于旧设置兼容,不应为桥接而新增 VS Code 设置;桥接本身无条件生效,不应重新引入兼容性开关。

决策路径:先判断是否为 VS Code 1.133.0 之前引入的既有权限策略,是则走 1.133 之前兼容迁移;否则按受控行为实现位置区分:Copilot 运行时、工具、MCP、沙箱或智能体循环归为 SDK/运行时管理设置;VS Code 编辑器或工作台归为 VS Code 配置策略;扩展提供的设置归为扩展策略;运行时与编辑器行为相互独立时拆分为运行时/编辑器双重控制。

必要用法:每次 VS Code 或扩展策略变更都要运行 npm run export-policy-data,禁止手动编辑 build/lib/policies/policyData.jsonc。

限制与历史:GitHub token/账号策略数据(AccountPolicyService 消费的 IPolicyData 字段)对新增控制已弃用,不应再从中新增授权或策略属性,既有字段保留兼容。1.133 之前的权限策略转换是一次性有界迁移,不是可复用通道。更改策略分类、applied-requirement 谓词或管理员迁移就绪诊断时,应参考 support-maintenance 指南。新增控制时优先信任可执行源码与测试,而非规划文档。具体实现细节与本地策略测试方法暂未提供。