如何在Jfrog CLI的spec文件中指定AQL返回的额外字段？

我完全懂你现在的困扰——直接调用Artifactory REST API时，轻松就能用.include("stat")这类语法指定AQL要返回的特定字段，但切换到JFrog CLI的spec文件模式时，翻遍官方的AQL文档和spec文件文档，都找不到对应的配置位置，甚至去扒Go语言的spec解析模块源码也没找到相关逻辑，确实挺让人头疼的。

现状明确说明 #

• 目前JFrog CLI的spec文件格式确实没有官方支持的配置项来设置AQL的.include()过滤，不管是AQL的官方文档还是spec文件的说明文档，都完全没覆盖这个场景。
• 我核对了你提到的Go语言spec解析模块的代码，确实没有处理这类字段的逻辑——spec文件里的AQL配置只是把你写的查询语句原封不动传递给Artifactory API，没有预留额外参数来添加返回字段的过滤规则。

两个可行的替代解决方案 #

方案1：直接在AQL语句中嵌入INCLUDE子句 #

其实AQL本身就支持在查询语句里直接写INCLUDE，根本不用依赖API的.include()方法。比如你原来在REST API里用.include("stat")，可以把AQL改成下面这样：

items.find({"repo": "your-target-repo"})
.include("stat", "name", "repo", "path")

把这个完整的AQL直接写到spec文件的aql字段里就行，JFrog CLI会把整个查询原封不动传给Artifactory，这样就能精准得到你需要的特定字段了。

方案2：用jf rt curl直接调用REST API #

如果spec文件的限制让你觉得束手束脚，也可以直接用JFrog CLI的rt curl命令发送AQL请求，这样就能完全按照REST API的方式自由控制返回字段：

jf rt curl -X POST "/api/search/aql" -H "Content-Type: text/plain" -d 'items.find({"repo": "your-target-repo"}).include("stat")'

这种方式既保留了CLI的认证便利性（不用自己手动处理token或密码），又能完全灵活地使用AQL的所有语法特性。

额外建议 #

如果你觉得这个功能很有必要，可以去JFrog的GitHub官方仓库提交Feature Request，很多实用的功能都是用户反馈后被纳入后续版本的。

内容的提问来源于stack exchange，提问作者Dustin Oprea