用途:为 Asta 技能和工具提供本地文档元数据索引,跟踪研究论文、文档与资源,支持存储和检索“Asta 中的文档”。
主要能力:通过 asta documents CLI 管理文档元数据(URL、摘要、标签、额外字段),支持列表、按字段搜索、添加、获取、更新、抓取内容、标签增删和缓存管理。搜索支持 --summary(混合/BM25/FTS5/子串)、--name、--tags、--extra(JSONPath 风格,支持 >、>=、<、<=、==、contains),多字段可用交集(默认)或 --union 并集,结果按摘要、名称、创建时间分层排序。
使用方式:默认索引为 .asta/documents/index.yaml,自定义位置用 --index-path。常用命令如 asta documents list、asta documents search --summary="query"、asta documents add <url> --name=... --summary=... --tags=...、asta documents get <uuid>、asta documents fetch <uuid> -o /tmp/document.pdf。加 --json 输出机器可读结果。远程索引使用 asta://{url-encoded-index-url}/{uuid} 格式,需解析、URL 解码、下载索引后用 --index-path 访问,远程索引只读。
安装:需 Python 3.11+ 与 uv,命令为 uv tool install --force git+https://github.com/allenai/asta-plugins.git@v0.16.0。
适用场景:索引其他 Asta 技能写入 .asta/ 的文档(如文献报告),添加和整理论文,搜索并抓取内容,批量标签管理,缓存维护。
限制:索引仅存元数据,内容需通过 URL 抓取;支持 http/https、file、s3、gs 协议,S3 需 AWS CLI,GCS 需 gsutil;应始终使用 CLI 操作,避免直接读写索引文件;远程索引不可增删改。其他细节暂未提供。