本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-plugin

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-tabbit

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• ready — 已安装 1.9.0 或更高版本的正式版 Tabbit 且运行时正在运行，Agent 继续通过 tabbit-cli 操作浏览器。
• restart-required — 已安装的版本达标，但 tabbit-cli 常驻运行时未运行，提示用户重启一次 Tabbit 浏览器。
• 多个 Tabbit 实例同时运行时，仍判定 Runtime 可用；模型根据 CLI 提示设置 TABBIT_PLAYWRIGHT_INSTANCE，不会把实例选择歧义误报为 Runtime 未运行。
• 诊断当前平台调用 CLI 所需的 DSH sandbox mode；Windows 返回 cliSandboxMode: danger-full-access，其他平台返回 default。
• 按 Agent session 缓存成功的环境检查；仅在 Runtime/launcher 失败或安装变化后通过 refresh: true 主动失效并重新检查。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

必须在使用前手动安装 Tabbit 浏览器吗？

不必须。如果系统没有检测到 1.9.0 及以上版本的稳定版 Tabbit，插件会自动启动后台任务下载对应地区和架构的安装包到 Downloads 目录，由用户手动完成最后的原生安装。

支持哪些操作系统？

仅支持 macOS（Apple Silicon 与 Intel）和 Windows 64 位。Linux 系统无法通过本插件获取安装包，且源码中也没有为 Linux 平台准备检测逻辑。

装好插件后是否还需要单独安装 tabbit-browser Skill？

不需要。插件随包自带 bundled Skill（rank=600），通过 cordis.patch.yml 自动注册到 DSH 的 Skill Provider。

检测结果会重复跑吗？

不会。每次成功检测的结果会按 agent session 缓存，后续调用直接返回 cached: true。只有在 Runtime/launcher 失败或浏览器有变更时，传 refresh: true 才会失效重检。

同一个 agent 内同时跑多次下载会怎样？

插件会按 agent 跟踪当前进行中的 job，重复调用会返回已有的 jobId 并提示「已经有下载在跑」，不会并发启动多个下载任务。

Windows 上 CLI 连接失败该怎么排查？

插件本身不会主动要求 Full Permission。先正常调用 tabbit-cli tasks 做连接探测；如果返回 BROWSER_RUNTIME_UNAVAILABLE 且浏览器与 Runtime 进程都已检测到，才让用户把当前 DSH 会话切到 Full Permission，并停止当前任务，不要重试。

国内和海外用户下载到的安装包有什么区别？

插件读取系统地区：大陆地区 CN 从 tabbit.com 下载国内版（Tabbit Browser），其他或未知地区从 tabbit.ai 下载国际版（Tabbit）。两套版本都支持，但识别名与 bundleId 不同。

如何卸载插件？

使用 dsh plugin --profile web remove github:Tabbit-Browser/dsh-plugin；插件不修改系统外的持久数据，检测缓存仅在当前 DSH agent 会话内存中，重启后自动失效。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: >=20
• Platforms: macOS (Apple Silicon), macOS (Intel), Windows x64

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则