SuperAPI AI 工具集

autoverse-cli

智能体与模型

查看项目

更新于 10-16 03:13

技能介绍

用途:本技能是 Autoverse 的系统层 Skill,只负责让 Agent 正确安装、登录、发现和调用 autoverse CLI。产品链路为 scholar-relay API → autoverse CLI,CLI 是唯一稳定执行面。仅在用户要安装、升级、验证 autoverse,登录/退出/切换 profile/检查身份,查看点数与价目,了解命令旗标、JSON、退出码或错误 code,CLI 调用失败需按结构化错误恢复,或开发/CI 需要平台 Key 时使用。普通“找论文、做开题、沿种子扩展”请求不应单独触发本技能。

安装与版本:pipx install autoverse;autoverse --version;autoverse --help。要求 Python 3.12+,包名和命令都是 autoverse。升级用 pipx upgrade autoverse。

登录与凭证:默认 autoverse login,autoverse whoami,浏览器由人完成邮箱或 GitHub 确认。凭证进入 OS 钥匙串,不要写入论文项目、Skill 或对话,不索要或打印 API Key。CI/脚本明确需要平台 Key 时才用 AUTOVERSE_API_KEY 或 login --token。--profile <name> 是全局旗标,放在动词前,不同 profile 使用独立凭证。

Agent 标准调用:固定为 autoverse --json --quiet <动词> ...。成功时 stdout 只有一行 {request_id,data},stderr 为空;失败时 stdout 为空,stderr 只有一行 {error:{code,message,request_id,retryable}}。只根据 code、retryable 和退出码分支,不解析自然语言日志。用法/输入错误退出 2,运行时/鉴权/点数/上游错误退出 1。支持 --fields 按需字段投影,高级调试走 api 逃生舱。具体命令、字段或错误可读 references/commands.md。

原子命令:账户与认证含 login、whoami、logout;点数与充值含 usage、topup、topup --plan <plus|pro|ultra|test>(企业支付宝直连,生成 ~/.config/autoverse/alipay_qr.png 并轮询到账);文献与作者检索含 search、resolve、batch -f、authors、related --via <references|cited-by|similar>;导出含 export --format <ris|bibtex|markdown> -f <json-file>(0 点数,无需网络)。本技能只提供原子能力合同,不含串行科研作业流程。

错误恢复:INVALID_SESSION/NOT_AUTHENTICATED/401 需重新 login;INSUFFICIENT_CREDITS/402 先 usage 再 topup,不可静默重试;REQUEST_OUTCOME_UNKNOWN 先核验是否扣点,不直接重发写请求;ALL_SOURCES_UNAVAILABLE 若 retryable=true 最多重试一次,不得谎报“检索到 0 篇”;CURSOR_OPTION_CONFLICT 带 cursor 时只能指定 --limit;UNKNOWN_PLAN 只可选 plus、pro、ultra、test;INPUT_FILE_、OUTPUT_FILE_、RELATED_ID_* 需修正输入输出或 ID 后重试。retryable=true 最多重试 1 次,false 立即终止。