📢 Release 1.0.0-beta.12(2026-08-12)现已推出
Arcadia

使用方法

arcadia run <name/path/url> [--options]

文件名称 name

仅限 scripts 个人目录下的代码文件,并且仅涵盖 根目录,你可以把你常用的代码文件(脚本)存放在这里

路径 path

相对路径或绝对路径,支持使用 ../ 作为当前目录和用 ../ 作为上级目录,如果运行本地的个人代码文件则可以省略路径
如果运行的是已配置的代码仓库中的代码文件可以使用相对路径,例如 /arcadia/repo/<仓库目录名称>/example.js 可以使用 repo/example.js 替代

链接地址 <url>

运行后代码文件默认保存在 scripts 个人目录,支持链接自动纠正功能
链接自动纠正功能是当拉取位于远程托管仓库的代码文件时可自动将 blob 链接转换为 raw 原始文件链接,此功能已应用到整个项目

命令选项 [--options]

用于实现一些扩展功能,具体请查看下方的文档内容


基础概念


命令选项

使用方法:追加在命令的末尾,熟练后可以使用简写

一个高级的应用程序CLI指令往往有着复杂的命令选项设计,这可能是一个漫长的学习过程~

选项用途选项值描述
-l, --loop循环运行连续多次运行代码文件,选项后需跟 循环次数(正整数),该选项与 等待执行延迟执行 参数同时使用时仍然有效互不干涉
-s, --silent静默运行静默运行任务不推送任何通知消息
-w, --wait推迟执行等待指定时间后再运行代码文件,选项后需跟 等待时间单位 作为参数值,具体参照 sleep 命令的用法
-D, --delay延迟执行随机倒数一定秒数后再运行代码文件,该秒数上限可以在配置文件中定义
-a, --agent网络代理为 JavaScript 和 TypeScript 代码文件启用全局 HTTP/HTTPS 代理,使用方法详见下方说明
-T, --timeout运行超时设置运行任务超时机制,选项后需跟 timeout 指令的参数作为选项值
-N, --no-log禁用日志不记录代码运行日志
-p, --proxy启用下载代理仅适用于执行位于 GitHub 仓库的代码文件,该代理固定为 jsDelivr 公共 CDN 加速代理
-c, --concurrent并发运行默认运行1个任务,若想增加运行任务数量那么请传参 任务数量(正整数)
-t, --thread指定并发线程指定同时运行的最大任务数量,选项后需跟正整数,需与并发运行同时使用
-b, --background后台运行不在前台输出代码执行进度,不占用终端命令行
-r, --recombine-env变量重组按照指定顺序重新组合复合变量的成员值,选项后需跟变量名称、分隔符、重组表达式。表达式语法:多个值用 , 隔开,值区间用 - 连接,可以用 % 表示值的总数
-R, --recombine-env-group分组运行基于变量重组功能上的扩展应用,为每组变量单独运行代码文件,传参与变量重组功能基本一致,其中重组表达式内用 @ 来区分不同组
-S, --split-env拆分运行将复合变量的成员值拆分后为每个值声明变量并单独运行代码文件,选项后需跟需要拆分的变量名称、分隔符
-E, --exec-args执行参数将该选项后面的内容作为参数传递给代码执行器
--传递选项将该选项后面的所有内容都作为选项参数传递给代码文件
--deno, --use-denoDeno使用 Deno 运行时
--bun, --use-bunBun使用 Bun 运行时
--node, --use-nodeNode.js使用 Node.js 运行时
--tsx, --use-tsxTypeScript Execute (tsx)使用 tsx 执行
--ts-node, --use-ts-nodets-node使用 ts-node 执行