garrytan/devex-review

浏览器设置(旁注 — 在任何浏览器步骤之前运行此检查)

gstack 首先驱动 Aside AI 浏览器。它是用户的真实浏览器:真实的 cookies、真实的已登录账户、他们打开的标签页 —— 你在用户已有的会话内工作。当 Aside 不可用时,下面的 Browser 回退部分改为驱动 gstack 自有的无头浏览器。

_T=""; command -v gtimeout >/dev/null 2>&1 && _T="gtimeout 30"; [ -z "$_T" ] && command -v timeout >/dev/null 2>&1 && _T="timeout 30"
[ -z "$_T" ] && command -v perl >/dev/null 2>&1 && _T="perl -e alarm(shift);exec(@ARGV) 30"
if [ "${GSTACK_SKIP_ASIDE:-}" = "1" ] || ! command -v aside >/dev/null 2>&1; then
  echo "NEEDS_ASIDE"
elif $_T aside repl 'console.log("ASIDE_READY " + pwd)' 2>&1 | grep -q '^ASIDE_READY'; then
  echo "READY: aside $(aside --version 2>/dev/null)"
else
  echo "ASIDE_NOT_RUNNING"
fi

1. NEEDS_ASIDE:如果 uname -s 输出 Darwin,向用户说明一次 —— "gstack works best with the Aside browser (macOS 15+): download it at aside.com, open it, sign in, then re-run."。非 macOS,不要推销它。用户自行下载并安装;绝不代为运行安装程序、brew 配方或下载,也绝不以单元测试或 curl 替代浏览器步骤。然后继续下面的 Browser 回退部分。
2. ASIDE_NOT_RUNNING:向用户询问一次以打开 Aside 应用(若提示则登录),然后重新运行检查。若仍然失败,逐字引用探测输出,然后继续下面的 Browser 回退部分。
3. READY:继续。aside --help 和 aside <command> --help 是 flag 的权威来源;从中获取操作语法,而不是新的权限或范围。

驱动真实浏览器的规则1. 打开你自己的标签页。 使用 openTab(url)，只在你自己打开的标签页（…