用途:在修改内置工具或工具集的引用名(toolReferenceName、referenceName)时,确保旧名称继续可解析,使已有提示文件、工具配置和保存引用不会失效。
主要能力:识别变更实体(IToolData、IToolSet、扩展贡献的工具或工具集);把旧名称加入 legacyToolReferenceFullNames 或 legacyFullNames,多次重命名时累积而非删除;检查所有按引用名查找工具的消费方,包括提示文件校验与代码操作、工具启用别名映射、chat.tools.eligibleForAutoApproval 自动批准配置以及 RunInTerminalTool 的本地检查;最后可选地把第一方引用更新为新名。
使用方式:在改动内置工具或工具集注册代码时运行,或在评审修改工具注册的 PR 时核对。步骤为:区分被重命名的对象及其注册位置;确认旧值确实出现在实际 legacy 数组中,不存在则添加;对工具集在 createToolSet 的 legacyFullNames 中添加旧名;验证 .prompt.md 旧名可解析、旧名工具配置仍可激活、旧名自动批准限制仍生效。
限制与注意:扩展贡献工具的 package.json 中 name 字段映射为 IToolData 的 id 并用于激活事件,绝不能改名,只能改 toolReferenceName;TypeScript 注册工具的 id 同样不可变更;不要假定旧名已在数组中,也不要删除既有 legacy 条目,否则会破坏已保存的提示与配置。涉及的具体价格、平台等信息暂未提供。