bsk 截图指南3 个场景一条命令从视口到全页长图【免费下载链接】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/BrowserSkillbsk 是 BrowserSkill 的命令行入口让任何能调 shell 的 AI Agent 直接驱动你已登录的真实浏览器完成截图。它自带后台守护进程你在终端敲一条bsk screenshotPNG 就落到你指定的文件上。五分钟装好 bsk 并验证截图命令可用这节帮你从空机器跑通第一条 bsk 截图命令全程不超过五分钟。macOS/Linux 用官方脚本一键安装默认装进~/.local/bincurl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh export PATH$HOME/.local/bin:$PATH bsk --versionexport只对当前 shell 生效Agent 每次新开 shell 也要带上同样的 PATH换过安装目录时记得对齐BSK_INSTALL_DIR或直接用二进制绝对路径。Windows 用户改用仓库根的install.ps1irm ... | iex位置相同。浏览器端从应用商店装好扩展再跑bsk install-skill把 skill 一键写进 Cursor、Claude Code、Codex 等 Agent不想自动化的话把SKILL.md手动复制进 Agent 的 skill 目录也行。最后跑一遍bsk doctor确认 CLI、daemon、扩展三者连通并顺手处理告警。bsk 截图前启动会话并选对目标标签这节解决命令报会话无效的坑所有 bsk 截图模式都要求一个活跃会话 ID。先用bsk session start创建会话它对应浏览器里的一个专用 Agent Window。目标标签必须属于这个会话——由会话创建或用bsk tab borrow从你的个人窗口借一个。--tab-id只选中目标、不会激活它默认目标是 Agent Window 当前激活的标签。截图全程保持目标标签选中、视口尺寸稳定即可。CLI → daemon → 扩展的完整链路可查 docs/architecture.md。bsk 截图的三个场景怎么选这节给你三种模式的最短命令照抄就能用。视口截图只拍当前看得见的区域适用快速看一眼页面现状。bsk screenshot --session id --out viewport.png✅ 成功后打印输出路径加--json时返回tab_id、width、height、format、path、byte_size六个字段。省略--out时存进系统临时目录文件名形如bsk-screenshot-毫秒时间戳.png。元素截图用 --ref 裁出 observe 返回的 e3适用只要某个控件或 Canvas 区域。先跑bsk observe或bsk snapshot把返回的eN引用喂给--refbsk screenshot --session id --ref e3 --out element.png✅ 成功后同样给出上面六个字段针对 Canvas 的截图还会签发一次性的capture_idsingle use供后续点击等操作使用取不到时附带capture_unavailable说明原因。全页长图--full-page 把页面从上滚到底适用超长页面要一张完整长图。bsk screenshot --session id --full-page --timeout 5m --out page.png✅ 成功后比前两种模式多一个已确认的scope字段。--timeout是捕获/编码的截止时间默认 2 分钟必须搭配--full-page使用。--scope同样只能配--full-pagefollow默认跟随滚动中追加的新内容current只拍捕获开始时测得的文档高度但仍会滚动该区域以暴露懒加载图片。⚠️ 不这里没有警告位——注意--full-page与--ref互斥二者只能选一个。全页长截图安全落盘一次 bsk 截图的完整时间线这节把图很大、传输不稳、中途想取消三件事一次讲清让你放心把长图交给 Agent。全页模式走三步 RPCtool.screenshot_full_page发起滚动捕获tool.screenshot_read分块取数tool.screenshot_release收尾。捕获阶段扩展把页面从顶部滚到底相邻视口之间留约 15% 重叠滚动中新加载的内容一并收入结束后还原原始滚动位置与临时样式。扩展侧很省内存整页数据以 512 像素高的小瓦片存在浏览器自己的 OPFS 文件区导出时逐瓦片读出、按行做 PNG 滤波再流式压缩全程不拼出整张像素缓冲。传回阶段像快递分箱大 PNG 拆成一箱箱发出每箱贴好序号与重量。技术上 CLI 按字节offset分块调tool.screenshot_read每块上限 256 KiB逐块校验非空、offset len next_offset严格连续、eof标志与文件末尾一致任何一箱不合规就整体中止绝不把坏块拼进图里。落盘阶段像草稿纸核对了才盖正本CLI 先在输出目录写一个.part临时文件边收边写并落盘收满全部字节后才原子替换目标文件——Unix 用renameWindows 用带 REPLACE 标志的MoveFileEx。所以目标路径上要么是旧图、要么是完整新图永远不会出现半张。像拼图没拼全就不上墙Ctrl-C 或传输失败都不会保存残缺图片失败时临时文件被清掉成功时已存在的输出文件会被照常覆盖。收尾阶段无论成功、本地失败还是 Ctrl-CCLI 都会调tool.screenshot_release释放扩展侧的导出扩展自身还有 10 分钟无读取自动过期、每分钟一次的后台清扫兜底。全页导出由 CLI 直写磁盘不经过扩展 popup 结果页也不触发浏览器下载。滚动、稳定判定与容错细节见 docs/long-screenshot.md。bsk 全页截图拍不了的页面清单这节帮你避开必然失败的页面⚠️ 以下场景官方明确不支持Chrome 内部页面、Chrome 网上应用店禁止注入内容脚本自动全页不可用嵌套滚动面板、虚拟化列表如无限滚动列表文档不断增长时滚动会持续可能直接撞上--timeout截止线捕获期间的页面导航或切换标签会中止捕获页面被隐藏可能停止捕获期间需保持目标标签选中、视口稳定。普通视口截图与--ref裁切不受上述限制照常可用。bsk 截图翻车自检遇到 X 就做 Y这节是出错时的对照表⚠️ 按症状逐条排查全页模式报扩展未确认 scope并拒绝保存旧版扩展没认--scope current去应用商店更新扩展后重试升级了 CLI 但全页行为异常跑bsk daemon restart重启已有守护进程让 CLI 与扩展重新对齐版本——旧扩展会直接拒绝新 RPC而不是回一张错误的视口图bsk doctor有告警按提示逐项处理并用bsk --version、bsk status核对两侧版本图没出现在预期位置多半漏了--out默认落在系统临时目录终端提示找不到bsk回看第一节把安装目录补进 PATH。让 Agent 代跑时可直接参考 crates/bsk-cli/skill/SKILL.md 里固化的截图规范如--full-page仍需--session、--ref与--full-page互斥、全页需要受控标签少踩一遍这些坑。【免费下载链接】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），仅供参考
bsk 截图指南：3 个场景一条命令，从视口到全页长图
bsk 截图指南3 个场景一条命令从视口到全页长图【免费下载链接】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/BrowserSkillbsk 是 BrowserSkill 的命令行入口让任何能调 shell 的 AI Agent 直接驱动你已登录的真实浏览器完成截图。它自带后台守护进程你在终端敲一条bsk screenshotPNG 就落到你指定的文件上。五分钟装好 bsk 并验证截图命令可用这节帮你从空机器跑通第一条 bsk 截图命令全程不超过五分钟。macOS/Linux 用官方脚本一键安装默认装进~/.local/bincurl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh export PATH$HOME/.local/bin:$PATH bsk --versionexport只对当前 shell 生效Agent 每次新开 shell 也要带上同样的 PATH换过安装目录时记得对齐BSK_INSTALL_DIR或直接用二进制绝对路径。Windows 用户改用仓库根的install.ps1irm ... | iex位置相同。浏览器端从应用商店装好扩展再跑bsk install-skill把 skill 一键写进 Cursor、Claude Code、Codex 等 Agent不想自动化的话把SKILL.md手动复制进 Agent 的 skill 目录也行。最后跑一遍bsk doctor确认 CLI、daemon、扩展三者连通并顺手处理告警。bsk 截图前启动会话并选对目标标签这节解决命令报会话无效的坑所有 bsk 截图模式都要求一个活跃会话 ID。先用bsk session start创建会话它对应浏览器里的一个专用 Agent Window。目标标签必须属于这个会话——由会话创建或用bsk tab borrow从你的个人窗口借一个。--tab-id只选中目标、不会激活它默认目标是 Agent Window 当前激活的标签。截图全程保持目标标签选中、视口尺寸稳定即可。CLI → daemon → 扩展的完整链路可查 docs/architecture.md。bsk 截图的三个场景怎么选这节给你三种模式的最短命令照抄就能用。视口截图只拍当前看得见的区域适用快速看一眼页面现状。bsk screenshot --session id --out viewport.png✅ 成功后打印输出路径加--json时返回tab_id、width、height、format、path、byte_size六个字段。省略--out时存进系统临时目录文件名形如bsk-screenshot-毫秒时间戳.png。元素截图用 --ref 裁出 observe 返回的 e3适用只要某个控件或 Canvas 区域。先跑bsk observe或bsk snapshot把返回的eN引用喂给--refbsk screenshot --session id --ref e3 --out element.png✅ 成功后同样给出上面六个字段针对 Canvas 的截图还会签发一次性的capture_idsingle use供后续点击等操作使用取不到时附带capture_unavailable说明原因。全页长图--full-page 把页面从上滚到底适用超长页面要一张完整长图。bsk screenshot --session id --full-page --timeout 5m --out page.png✅ 成功后比前两种模式多一个已确认的scope字段。--timeout是捕获/编码的截止时间默认 2 分钟必须搭配--full-page使用。--scope同样只能配--full-pagefollow默认跟随滚动中追加的新内容current只拍捕获开始时测得的文档高度但仍会滚动该区域以暴露懒加载图片。⚠️ 不这里没有警告位——注意--full-page与--ref互斥二者只能选一个。全页长截图安全落盘一次 bsk 截图的完整时间线这节把图很大、传输不稳、中途想取消三件事一次讲清让你放心把长图交给 Agent。全页模式走三步 RPCtool.screenshot_full_page发起滚动捕获tool.screenshot_read分块取数tool.screenshot_release收尾。捕获阶段扩展把页面从顶部滚到底相邻视口之间留约 15% 重叠滚动中新加载的内容一并收入结束后还原原始滚动位置与临时样式。扩展侧很省内存整页数据以 512 像素高的小瓦片存在浏览器自己的 OPFS 文件区导出时逐瓦片读出、按行做 PNG 滤波再流式压缩全程不拼出整张像素缓冲。传回阶段像快递分箱大 PNG 拆成一箱箱发出每箱贴好序号与重量。技术上 CLI 按字节offset分块调tool.screenshot_read每块上限 256 KiB逐块校验非空、offset len next_offset严格连续、eof标志与文件末尾一致任何一箱不合规就整体中止绝不把坏块拼进图里。落盘阶段像草稿纸核对了才盖正本CLI 先在输出目录写一个.part临时文件边收边写并落盘收满全部字节后才原子替换目标文件——Unix 用renameWindows 用带 REPLACE 标志的MoveFileEx。所以目标路径上要么是旧图、要么是完整新图永远不会出现半张。像拼图没拼全就不上墙Ctrl-C 或传输失败都不会保存残缺图片失败时临时文件被清掉成功时已存在的输出文件会被照常覆盖。收尾阶段无论成功、本地失败还是 Ctrl-CCLI 都会调tool.screenshot_release释放扩展侧的导出扩展自身还有 10 分钟无读取自动过期、每分钟一次的后台清扫兜底。全页导出由 CLI 直写磁盘不经过扩展 popup 结果页也不触发浏览器下载。滚动、稳定判定与容错细节见 docs/long-screenshot.md。bsk 全页截图拍不了的页面清单这节帮你避开必然失败的页面⚠️ 以下场景官方明确不支持Chrome 内部页面、Chrome 网上应用店禁止注入内容脚本自动全页不可用嵌套滚动面板、虚拟化列表如无限滚动列表文档不断增长时滚动会持续可能直接撞上--timeout截止线捕获期间的页面导航或切换标签会中止捕获页面被隐藏可能停止捕获期间需保持目标标签选中、视口稳定。普通视口截图与--ref裁切不受上述限制照常可用。bsk 截图翻车自检遇到 X 就做 Y这节是出错时的对照表⚠️ 按症状逐条排查全页模式报扩展未确认 scope并拒绝保存旧版扩展没认--scope current去应用商店更新扩展后重试升级了 CLI 但全页行为异常跑bsk daemon restart重启已有守护进程让 CLI 与扩展重新对齐版本——旧扩展会直接拒绝新 RPC而不是回一张错误的视口图bsk doctor有告警按提示逐项处理并用bsk --version、bsk status核对两侧版本图没出现在预期位置多半漏了--out默认落在系统临时目录终端提示找不到bsk回看第一节把安装目录补进 PATH。让 Agent 代跑时可直接参考 crates/bsk-cli/skill/SKILL.md 里固化的截图规范如--full-page仍需--session、--ref与--full-page互斥、全页需要受控标签少踩一遍这些坑。【免费下载链接】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），仅供参考
