BrowserSkill bsk 快速上手3 种拍法截稳 10 万像素高长页面【免费下载链接】BrowserSkillLet AI agents use your real, logged-in browser without interrupting your work. CLI extension for browser automation across any shell-capable AI agent.项目地址: https://gitcode.com/GitHub_Trending/br/BrowserSkill想让 Agent 把一页 10 万像素高的已登录数据页存成档案——手动滚动加粘贴拼图走不通整图进内存又要先付出 1.27 GiB 的裸 RGBA。而 BrowserSkill 的 bsk 就是为它准备的浏览器长截图工具一个二进制里同时装着 CLI 与本地守护进程替你驱动已登录的真实浏览器把视口、单个元素或整页长图直接存成 PNG文件由 CLI 自己落盘。 快速上手四步装好、验证、开拍装 bsk。macOS / Linux 一条安装脚本即可默认装到~/.local/binWindows 用仓库根目录的install.ps1走同样的默认目录curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh export PATH${BSK_INSTALL_DIR:-$HOME/.local/bin}:$PATH验证三方。先跑bsk --version确认二进制就位再跑bsk doctor检查 CLI、守护进程、扩展三方的连通性按它输出的告警逐条处理。有个坑要记export PATH只对当前 shell 生效如果你的 Agent 还在用旧 PATH重启它或者直接用二进制的绝对路径。配两件套。从浏览器商店装上 BrowserSkill 扩展再用bsk install-skill把 skill 写进你的 harnessCursor、Claude Code、Codex 等开会话截第一张。bsk session start会在对应浏览器里创建一个独立的 Agent Window。要拍的标签页必须属于这个会话要么由它新建要么用bsk tab borrow从你的个人窗口借过来。于是--session id必填--tab-id id只是选中某个标签不会激活它缺省时截 Agent Window 当前激活的那个bsk session start bsk screenshot --session id --out viewport.png--out省略时图片写进系统临时目录文件名形如bsk-screenshot-毫秒时间戳.png。 按内容选拍法视口、元素、整页长图各有一手三种模式共用一套参数--json输出字段也一致tab_id、width、height、format、path、byte_size。先看三条命令再对照各自的行为bsk screenshot --session id --out viewport.png bsk screenshot --session id --ref e3 --out element.png bsk screenshot --session id --full-page --timeout 5m --out page.png视口怎么截只拍当前可见区域不加--full-page扩展回传一张 base64 编码的 PNGCLI 解码后写盘对应最轻量的用法。某个元素怎么截--ref 裁到指定节点--ref eN的编号取自你最近一次bsk observe或bsk snapshot的返回图会被裁切到那个 DOM 元素或 Canvas 区域。Canvas 类截图还会附带一个一次性的capture_id供后续点击等操作引用。整页长图怎么截--full-page 从顶滚到底--full-page把页面从顶滚到底再拼成一张图围绕它有三个关键参数--timeout是捕获与编码的截止时长30s、5m均可仅全页模式可用缺省 2 分钟--scope follow跟随滚动中追加出的新内容--scope current只截开拍时测得的文档区域但该区域内仍会滚动以露出懒加载图片--full-page与--ref互斥同传会被直接拒绝。️ 截不动的场景与它的 3 个自保行为先看支持面常规可脚本化的 HTTP(S) 页面自动全页、视口、元素裁切都可用。再对照截不动的场景与 bsk 的应对场景bsk 如何应对Chrome 内部页、Chrome 应用商店页禁止内容脚本注入自动全页模式不可用可见区域模式借activeTab例外能截视口嵌套滚动面板、虚拟化列表滚动发生在页面内部bsk只跟随文档级滚动不跟页面内部滚动捕获期间页面导航、切换标签、标签被隐藏中止捕获页面自身无限增长滚动持续到你设的超时截止线目标标签失去选中、视口尺寸变化捕获期间需保持标签选中、视口尺寸稳定与之配套的防呆行为保证截不好就宁可不出图失败不存残图字节没收全或校验不过目标文件绝不被触碰Ctrl-C 可取消取消后不留半张图版本不匹配直接拒绝比如--scope current碰上不认这个参数的旧扩展CLI 拒存并提示你更新扩展而不是给你一张范围错误的图。 10 万像素高的长图如何不吃内存一张几十万像素高的长图动辄几百 MBbsk 的做法是在链路的每一环都别让整图进内存缓冲按顺序走三步加一组实测按 256 KiB 拉块逐块校验。整张 PNG 不在 CLI 与扩展之间整体搬运而是按字节offset一次拉 256 KiB 的块。每块都要过一遍检查解码后不超 256 KiB、非空、offset len恰好等于下一块起点、不越界、eof与文件末尾一致。任何一块不合格立即中止绝不把损坏的块拼进图片。先写旁路文件再一次性换上去。所谓原子落盘就是先写旁路文件、收齐后再一次性换到目标路径CLI 先在输出目录建一个.bsk-screenshot-uuid.part临时文件边收边写并强制刷盘全部字节到位后才把目标替换掉Unix 用renameWindows 用带替换与写透标志的MoveFileExW。于是目标路径上要么是旧图、要么是完整新图没有中间态失败时临时文件被清掉。捕获端切片导出端流式。整页不放进一块画布而是切成 512 像素高的 PNG 瓦片存进扩展的 OPFSOrigin Private File System浏览器为每个站点提供的私有磁盘区域。追加内容或重画页脚只替换对应瓦片导出时逐瓦片流式读取套上 PNG 的 Up 滤波器交给浏览器原生 deflate 流式压缩写 chunk全程不构造整张像素缓冲。实测数据。官方验证里一张 3170×100062 像素的导出只用了最高 512 像素的画布峰值工作缓冲约 41.7 MiB——而同一张图的完整 RGBA 数据约需 1.27 GiB。 排查速查按症状找原因症状先查怎么处理截图根本出不了图三方不通三方连通性跑bsk doctor按其输出逐条处理告警新参数直接被拒、提示更新扩展版本是否匹配bsk --version与bsk status核对 CLI 与扩展构建升 CLI 后跑bsk daemon restartCLI 已升级但表现陈旧扩展滞后商店更新可能晚于 CLI 发布旧扩展会拒收新 RPC 而非返回错误图片按提示升级--tab-id提示不属于会话会话与标签标签必须在会话内新建或bsk tab borrow标签保持选中、视口稳定不知道图落在哪里输出位置看--json里的path与byte_size或系统临时目录下的bsk-screenshot-*.png 延伸阅读想深入实现先读行为约定 docs/long-screenshot.md再对照扩展侧的捕获与导出逻辑 apps/extension/src/long-screenshot/、CLI 侧的落盘实现 crates/bsk-cli/src/cli/screenshot.rs命令的行为约定以 crates/bsk-cli/README.md 为准。【免费下载链接】BrowserSkillLet AI agents use your real, logged-in browser without interrupting your work. CLI extension for browser automation across any shell-capable AI agent.项目地址: https://gitcode.com/GitHub_Trending/br/BrowserSkill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考