SuperAPI AI 工具集

asta-documents

办公与效率

查看项目

更新于 10-15 19:55

技能介绍

用途:为 Asta 技能与工具提供本地文档元数据索引,跟踪研究论文、文档和资源的 URL、摘要、标签等信息,相当于带搜索能力的书签管理器。默认索引位于当前工作目录下的 .asta/documents/index.yaml,使用默认位置时 --index-path 可省略。

主要能力:通过 asta documents CLI 完成增删改查。list 列出文档,search 按 summary、name、tags、extra 字段搜索,支持多字段交集(默认)与并集(--union);add 添加文档并写入 name、summary、tags、mime-type、extra 等元数据;get 获取元数据,update 更新,fetch 抓取内容并本地缓存;add-tags/remove-tags 管理标签;cache list/stats/clean/clear/info 管理缓存;show 显示文档计数。所有命令加 --json 可输出机器可读结果。

使用方式:其他 Asta 技能向 .asta/ 写入文档后,应扫描目录并自动索引,file:// URL 需使用绝对路径(如 $(pwd)/...)。远程索引使用 asta://{url-encoded-index-url}/{uuid} 格式,需解析并 URL 解码索引地址、下载到临时文件,再通过 --index-path 访问;远程索引为只读。支持 http://、https://、file://、s3://、gs:// 协议,S3 需 AWS CLI,GCS 需 gsutil。

适用场景:研究论文与文档的元数据管理、按摘要或标签检索、抓取并缓存文档内容、共享远程文档集合。

限制:索引仅存元数据,内容需通过 URL 抓取;远程索引不支持增删改;应始终使用 CLI 操作,避免直接读写索引文件;云存储协议需额外安装与配置凭据。安装、收费与平台支持等细节资料未完整提供。