用途:run-railway 是操作已安装 Railway CLI 的路由层,帮助代理在平台运维中为每个 Railway 问题选择正确的参考、命令和作用域(本地二进制还是上游文档)。
主要能力:区分近似命令(up 与 deploy、redeploy 与 restart、delete 与 unlink、connect 与 ssh、run 与 shell 与 dev);处理日志、部署状态、扩缩容、变量编辑、域名绑定、数据库 shell;解析 Railway 仪表盘 URL 或判断当前链接的项目/服务/环境;处理版本漂移;覆盖 functions、volumes 与 shell 补全;支持 Postgres、MySQL、Redis、Mongo 的一手数据库分析。
使用方式:以本地快照为已安装二进制的准绳,上游文档仅作上下文;不凭记忆猜参数、别名或嵌套子命令,路由到 references/cli/railway-cli-command-reference.md。默认只读,除非用户明确要求,不执行 up、redeploy、restart、down、delete、unlink、variable set、domain add、scale 等变更命令。回答按“作用域→命令→参数→近似命令区分→版本漂移说明”输出。升级后可运行 node scripts/extract-railway-cli-help.mjs 与 railway --version 刷新本地快照。
适用场景:用户输入或粘贴 railway <子命令> 需要正确参数;在近似命令间选择;读取日志、检查部署、扩缩容、编辑变量、绑定域名、打开数据库 shell;粘贴仪表盘 URL 或询问当前链接;文档显示本地 CLI 没有的命令;询问 functions、volumes 或补全输出;需要基于 CLI 的一手数据库分析。
限制:不用于编写 Makefile 部署目标(应使用 init-makefiles);不用于纯仪表盘、GraphQL 或 REST API 且无 CLI 决策的任务;不用于无 Railway 上下文的通用 shell、Git 或容器构建问题;不用于无已安装 railway 二进制的基础设施架构规划。上游独有命令须明确标注,不得当作本地可用;显式标识符优先于当前目录链接状态。