SuperAPI AI 工具集

astrale-cli

通用与其它

查看项目

更新于 10-15 17:20

技能介绍

用途:astrale 连接已有的 Astrale Kernel,用于选取实例与身份、执行图读取与变更、调用 callable、安装运行中的 Domain、读取 Kernel journal、打开已认证视图。它只负责连接,不构建或运行 Domain;构建、部署、发布、diff、yank、list、lint、package、test 由 SDK 的 astrale-domain 二进制负责。

主要能力与命令:status、whoami、use、get、query、introspect、mutate、call、execution、token、logs、view、ui、instance、domain、identity、auth、idp、admin、issue。涉及 Kernel 的命令共享 --format、--json、--raw、--url、-i/--instance、--timeout、--as、--creds、--anonymous、--debug 等选项。--anonymous 会省略调用者凭据,不能与 --as 或 --creds 同用。

使用方式:分发为内置 Bun 运行时的独立可执行文件,无需 Node/npm/Bun;npm 分发已退役。源码开发使用仓库固定工具链,开发入口为 bun cli/bin/astrale.ts <command>。命令帮助以 astrale --help 与 astrale <command> --help 为准。路径使用规范 Kernel Path,如 /:notes.example.dev、/:notes.example.dev:class.Note、@node-id、@self。

UI 项目:astrale ui init --preset astrale 初始化 React 与 Tailwind CSS v4 项目;支持 ui search、ui request、ui add、ui doctor、ui preset apply。ui 为本地项目工具,不接受 Kernel、实例、身份或凭据选项,但 astrale ui request 是已认证 Kernel 命令。

实例与 Domain:instance 命令合并管理端实例与本地书签,支持 create、root import、invite、invitation status、status、list、use、bookmark、forget。domain install 接受部署 URL 或已发布版本(如 <origin>@1.5.0、<origin>@1.5),多个引用可原子安装;domain uninstall 默认安全模式,--destructive 删除事实。安装或卸载是持久 Execution,默认等待 110 秒,--no-wait 立即返回;不要重跑,应使用 astrale execution status|result <execution> 跟进。退出码 0 表示完成或等待结束时仍在运行,1 表示执行前被拒、取消、暂停或其他错误,2 表示失败结束,5 表示操作冲突,75 表示结果读取时执行未结束,130 表示中断且执行继续。

限制:CLI 不构建或运行 Domain;无已部署 Admin Domain 时 instance list 无法获取受管实例,可用 --bookmarked。资料未提供收费、价格与平台支持信息。