ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

gstack /open-gstack-browser 侧边栏扩展没有出现在工具栏时如何手动加载?

gstack /open-gstack-browser 侧边栏扩展没有出现在工具栏时如何手动加载? gstack /open-gstack-browser 侧边栏扩展没有出现在工具栏时如何手动加载【免费下载链接】gstackUse Garry Tans exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA项目地址: https://gitcode.com/GitHub_Trending/gs/gstack运行 gstack 的/open-gstack-browser后GStack BrowserPlaywright 控制的 Chromium会启动gstack 侧边栏扩展本应通过launchPersistentContext在启动时自动加载但你有时会发现工具栏里没有 gstack 图标或图标点开后 Side Panel 处于未连接状态。本文说明如何排查这种情况并在确认扩展确实没有加载后用 “Load unpacked” 把它手动加载进来让 Side Panel 连上端口 34567 的 browse server。适用环境通过$B connect启动的 Playwright Chromium不是你日常使用的 Chrome扩展目录来自 gstack 安装目录。注意 Playwright Chromium 的地址栏同样支持输入chrome://extensions下文步骤在该窗口内执行。先确认 connect 连接本身是健康的在手动加载扩展之前先排除 “browse server 没起来” 这种情况因为 Side Panel 必须连接到 browse server 才有意义。先确认browse二进制可用setup 检查_ROOT$(git rev-parse --show-toplevel 2/dev/null) B [ -n $_ROOT ] [ -x $_ROOT/.claude/skills/gstack/browse/dist/browse ] B$_ROOT/.claude/skills/gstack/browse/dist/browse [ -z $B ] B$HOME/.claude/skills/gstack/browse/dist/browse if [ -x $B ]; then echo READY: $B else echo NEEDS_SETUP fi如果输出NEEDS_SETUP说明还没完成一次性构建约 10 秒按文档提示运行cd SKILL_DIR ./setup若系统没有bun需先安装bun版本 1.3.10带文档给出的 sha256 校验。连接后确认状态$B status输出里应看到Mode: headed。再看状态文件里的端口cat $(git rev-parse --show-toplevel 2/dev/null)/.gstack/browse.json 2/dev/null | grep -o port:[0-9]* | grep -o [0-9]*connect固定使用端口34567Side Panel 扩展就是靠它自动连接的读出的值如果不是 34567记下实际端口后面手动输入端口时用这个值。如果$B status显示 server 不健康先重跑/open-gstack-browser的 Step 0 预清理杀掉.gstack/browse.json中记录的旧 browse 进程、删除.gstack/browse.json并清理$HOME/.gstack/chromium-profile下的SingletonLock、SingletonSocket、SingletonCookie三个锁文件再重新$B connectserver 健康但窗口不可见时用$B focus把浏览器带到前台。这些都属于连接层问题解决后扩展通常也能正常显示。找到扩展目录的实际路径手动加载需要一个含manifest.json的扩展目录。用下面的脚本同时覆盖仓库内安装.claude/skills/gstack和用户目录安装~/.claude/skills/gstack两种情况_EXT_PATH _ROOT$(git rev-parse --show-toplevel 2/dev/null) [ -n $_ROOT ] [ -f $_ROOT/.claude/skills/gstack/extension/manifest.json ] _EXT_PATH$_ROOT/.claude/skills/gstack/extension [ -z $_EXT_PATH ] [ -f $HOME/.claude/skills/gstack/extension/manifest.json ] _EXT_PATH$HOME/.claude/skills/gstack/extension echo EXTENSION_PATH: ${_EXT_PATH:-NOT FOUND}输出形如EXTENSION_PATH: /some/path/.claude/skills/gstack/extension。如果输出NOT FOUND说明 gstack 安装不完整先运行./setup或/gstack-upgrade再重试。扩展的身份信息可在 extension/manifest.json 中核对name为gstack browsemanifest_version: 3使用sidePanelAPIside_panel.default_path指向sidepanel.html。在chrome://extensions列表里看到的名字就是这个gstack browse。手动加载扩展扩展是在启动时加载进 Playwright Chromium 的有时不会立刻出现在工具栏里。排查顺序按文档给出的分支在该浏览器的地址栏输入chrome://extensions回车。查看列表里是否有gstack browse。有且已启用问题只是没固定pin。回到任意页面点工具栏的拼图扩展图标找到gstack browse点旁边的图钉pin图标再点击工具栏上固定的 gstack 图标Side Panel 应从右侧打开并显示活动 feed。完全没有列出需要手动加载见下面的 “Load unpacked” 步骤。如果加载了但 Side Panel 角标一直是灰色disconnected点击 gstack 图标手动输入端口34567或上一步读到的实际端口。方式一直接操作Playwright Chromium 内在chrome://extensions页面打开Developer mode开发者模式位于页面右上角这是 “Load unpacked” 按钮出现的前提。点击Load unpacked。在弹出的文件选择对话框中按CmdShiftGmacOS粘贴上一步得到的扩展路径点Select。加载完成后回工具栏把 gstack 图标固定点击图标打开 Side Panel。方式二用仓库自带的 helper 脚本可选面向日常 Chrome仓库里有一个现成的辅助脚本 bin/gstack-extension它会自动查找扩展目录仓库内extension/或~/.claude/skills/gstack/extension/以哪个存在manifest.json为准把路径复制到剪贴板pbcopymacOS尝试打开chrome://extensions页面并打印完整的六步安装指引如果仓库根存在.gstack/browse.json还会顺带读出 browse server 端口一并打印。副作用只有打开 Chrome 页面和写剪贴板不涉及删除文件或改动系统环境。bin/gstack-extension需要说明的是该脚本文档定位是给 “你自己的日常 Chrome” 安装扩展用的它用osascript/open唤起的是系统里的 Google Chrome。如果你要在 Playwright Chromium 里加载直接走方式一即可脚本打印的路径和端口信息同样适用。验证 Side Panel 已连接加载并固定扩展、打开 Side Panel 后做两条验证在 Side Panel 中应能看到活动 feed 界面而不是灰色未连接角标。文档还描述了正常启动的窗口特征页面顶部有一条金色 shimmer 线说明这是 Playwright 控制的 GStack Browser。跑一条真实命令看 feed 是否实时更新$B goto https://news.ycombinator.com等 2 秒再执行$B snapshot -i然后查看 Side Panelgoto和snapshot两条命令应实时出现在活动 feed 中。文档明确说 “Every command Claude runs shows up here in real time”——feed 有更新即代表扩展与 browse server 的连接已恢复。一个已知的一次性干扰项v1.63 的扩展 ID 重置BROWSER.md 记录了v1.63 通过 manifest 的key字段固定了扩展身份因此旧的 unpacked 安装会拿到一个新的扩展 ID面板本地状态包括已保存的端口会重置一次产品内有一次性的提示说明此事。如果你升级前后遇到的正是 “扩展还在、但 Side Panel 又回到未连接、端口没了” 的现象这是预期行为按上文重新输入端口 34567 即可不需要重装扩展。边界说明本文只覆盖 “Playwright Chromium 里侧边栏扩展未出现/未连接” 这一条路径BROWSER.md 中 “把扩展装进日常 Chrome” 属于另一目标日常 Chrome 里用 Side Panel操作相同但对象不同不在此展开。手动加载不会改变connect的自动加载行为下次重新$B connect时扩展仍会按原逻辑自动加载本文步骤只是当前的补救手段。【免费下载链接】gstackUse Garry Tans exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA项目地址: https://gitcode.com/GitHub_Trending/gs/gstack创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表