更新资源协议文档，新增资源获取实现说明，明确AI系统在资源加载中的主动获取责任和加载验证要求，提升文档的实用性和清晰度。

2025-05-19 22:06:55 +08:00
parent ac2f5d8d4a
commit e7aa2c7a60
5 changed files with 272 additions and 1 deletions
--- a/protocol/tag/resource.tag.md
+++ b/protocol/tag/resource.tag.md
@ -140,4 +140,14 @@ query_params ::= '?' param_name '=' param_value {'&' param_name '=' param_value}
 4. 相对路径解析基于当前上下文的工作目录或基础路径
 5. 资源加载语义前缀（@、@!、@?）优先于其他部分解析，决定资源的加载策略

+### 资源获取实现说明
+
+对于支持工具调用能力的AI系统:
+1. **主动获取责任**: AI需主动使用工具调用(例如read_file)获取@引用的资源，而非等待系统自动加载
+2. **立即加载义务**: 特别是对于@!前缀资源，AI必须立即执行工具调用获取内容
+3. **自主判断懒加载**: 对于@?前缀资源，AI应记录位置但暂不加载，直到实际需要使用时
+4. **加载验证**: AI应验证资源是否成功加载，并适当处理加载失败情况
+
+这种主动获取模式确保AI能正确执行协议定义的资源加载语义，而不依赖系统层面的自动处理。
+