@gakim-digital/dexter-bridge

中文文档
0.13.13发布于 2026/11/05SEE LICENSE IN LICENSEES Module近 30 天下载 4821

InstaWebAI和Dexter的本地桥——在你的机器上运行了Codex,Claude Code,或者OpenCode.

中文使用文档
文档目录6 节
  1. InstaWebAI 应用程序构建器
  2. 用于帧器的 Dexter
  3. MacOS上的克洛德代码
  4. 临时 CLI 连接
  5. 调试
  6. 桌面发布

本地代理桥

InstaWebAI和Dexter的本地桥CLI. 它连接用户已有的 Codex, Claude 代码, 或 OpenCode 设置而不发送这些登录证书 前往InstaWebAI(英语:InstaWebAI).

这两种产品共用了桥包,但并非其配对状态. API (英语) 配对时指定产品身份; CLI 无法转换一个产品的 将代码配对到另一个产品的连接中.

InstaWebAI 应用程序构建器

连接页面提供单独的Codex,Claude代码和OpenCode卡. 选择代理, 复制其命令, 在构建时保持终端打开 :

npx --yes @gakim-digital/dexter-bridge@latest connect 123456 \
  --api https://api-insta.instawebai.com/iwm-api/0.0.1 \
  --runtime codex

使用 --runtime claude-code 或者说 --runtime opencode 其他的卡片。 这个 CLI 自动将每个连接存储在一个孤立的目录中, 其下 ~/.dexter-bridge/app-builder/,所以任何组合 三个特工可以是 同时连接. 选中的运行时间必须已经安装 在同一计算机上签名或配置.

配对会话范围为InstaWebAI所选择的运行时间. 修改 命令不能为不同的运行时间要求配对代码.

用于帧器的 Dexter

Dexter Framer的跑步是第一位的 API发出一个范围化的结果 指定连接的 Codex、 Claude 代码或 OpenCode 运行时间。 那个 直接通过 当插件仍然是聊天、进展、取消和 结果界面.

Framer 控制器只接收这些工程范围的工具:

  • framer_read 财务报告和审定财务报表 framer_edit
  • framer_instructions 财务报告和审定财务报表 framer_view_image
  • framer_plan_task, (中文(简体) ), framer_verify_interactions,以及 framer_read_website

本地 shell、文件系统、网络和不相关的项目访问被禁用 帧结果运行 。 除非未来明确转让,否则将拒绝出版 授权它.

桥梁广告 framer-interaction-verification-v4Dexter 不建模 帧器的交互特性: 模型构建任何能力的行为 框架文档,以节点宣布每个行为 应随行,然后标出每个携带它的帧器属性 节点( 例如 loopEffect 或者说 link) (中文(简体) ). 该桥证实财产在 现场节点。 结果为: verified, (中文(简体) ), contradicted (数值不同),或 unknown (未找到财产)。 未知 报告为未核实;未限制的目标或矛盾离开运行 不完整 .

账户连接在 Dexter 内部处理,并在模型之前完成 开始 :

  • 用户将一个帧账户连接一次 。 Dexter 存储刷新符号 加密后只给桥上一个短命的访问符.
  • 该桥通过Framer MCP打开了工程. 编辑已发布的工程 dexter是这么说的.
  • 在 Dexter 中断开连接,或在 Framer 中撤销 Dexter, 以后停止运行,直到 账户再次连接.

用户从未创建工程 API 密钥 。 刷新标志留在API上.

桥梁报告供应商在终端事件上的象征性使用,包括 中断并取消运行 。 克劳德报告 可用时将存储美元成本; 仅使用 Codex 令牌运行按 API的模型成本目录.

在MacOS上,桥只持有一个闲眠的说法,而声称的跑步是 活动,然后立即释放。 仍然可以关闭笔记本盖 暂停本地进程; 不间断地密闭执行需要运行 永远在机器上的桥 或主机吊带跑者.

对于 App Builder 运行,规划仍然是服务器拥有的. 一旦工作流程 合同、数据模型、依赖性和设计方向都准备好了,桥梁 获得一个有限度的产品结果加上可支配源的快照。 这个 被选中的牵引装置将实现完整功能结果 工作空间。 API 然后验证并应用已修改的文件并运行其 自有类型、授权、API-合同、浏览器-工作流程、响应和视觉 检查。 一次未完成的核查作为分组修复摘要返回,截至2004年12月31日 在保存的工作空间被暂停审查之前,大多数三次完整的尝试.

每个支持的编码带都得到同样的七个工具:

  • workspace_inspect 财务报告和审定财务报表 workspace_sync 可支配源树.
  • shell_run 用于软件包安装、代码生成、测试、构建和 孤立建筑工人中的其他项目命令.
  • preview_control 财务报告和审定财务报表 browser_control 现场申请.
  • data_inspect 用于所有者范围、编辑的开发数据.
  • verification_run 用于确定和浏览器工作流程检查.

Codex作为本土活性工具接收这些. Claude 代码和 OpenCode 接收 同一份合同通过一个当地保护的MCP桥。 命令从不 穿过桥机外壳 API把他们送到一个 project- confined 建築工, 有离线默认; 只有脚本功能障碍 npm 依赖命令获得注册访问。 API仍然有权 项目所有权、受保护的平台文件、数据访问、命令执行、, 和最后核查.

当依赖性需要建立生命周期时, 绳子可以运行 npm rebuild 安装后作为单独的离线命令。 这允许软件包代码 在不将任意的脚本执行和互联网合并的情况下准备自己 访问.

MacOS上的克洛德代码

Dexter的Claude设置法师使用Homebrew,所以桥会自动启动 在登录时,用户可以在设置后关闭终端。 巫师填入 配对代码、 API URL、 代理和模型 :

brew install gakim-digital/tap/dexter-bridge \
  && dexter-bridge pair 123456 --api https://api-insta.instawebai.com/iwm-api/0.0.1 --agent claude-code --model claude-code:sonnet \
  && brew services restart gakim-digital/tap/dexter-bridge

Claude代码必须已经安装并签名在同一Mac上 记录已解析的克劳德可执行路径 ~/.dexter-bridge/config.json 因此背景服务可以找到由 NVM 或其他管理的设备 特定外壳工具 .

服务本身保持时态. Dexter给新桥取名后 没有运行中, 它运行中 brew update 财务报告和审定财务报表 brew upgrade,然后重新启动 在新版本上。 它每小时试一次 不停地运行电流 版本,如果升级失败。 日志在 $(brew --prefix)/var/log/dexter-bridge.log。 。 。 .

有用的服务命令 :

brew services info gakim-digital/tap/dexter-bridge
brew services restart gakim-digital/tap/dexter-bridge
brew services stop gakim-digital/tap/dexter-bridge
dexter-bridge status
dexter-bridge doctor

没有Homebrew的用户可以在向导中选择临时命令. 那个 用途 npx 在Dexter使用克洛德密码时必须保持开放.

临时 CLI 连接

一对命令并上线——Dexter插件的 Connect 向导打印它 配对代码和 API URL 填入:

npx --yes @gakim-digital/dexter-bridge@latest connect 123456 --api https://api-insta.instawebai.com/iwm-api/0.0.1 --agent codex

运行 connect 没有代码可以重用保存的配对。 低级指挥部留任 支助和自动化:

npx @gakim-digital/dexter-bridge pair 123456 --api http://localhost:3800/iwm-api/0.0.1
npx @gakim-digital/dexter-bridge start --agent claude-code
npx @gakim-digital/dexter-bridge start --agent codex
npx @gakim-digital/dexter-bridge start --agent cursor
npx @gakim-digital/dexter-bridge status
npx @gakim-digital/dexter-bridge doctor
npx @gakim-digital/dexter-bridge logout

光标需要在同一台计算机上签名的光标 CLI (单位:千美元)curl https://cursor.com/install -fsS | bash,则 cursor-agent login) (中文(简体) ). 大桥开通了 cursor-agent acp 带有 Cursor 的外壳、文件和网络工具 已拒绝, 因此 Cursor 只能使用 Dexter 的框架工具 。 设定 DEXTER_BRIDGE_CURSOR_BIN 若为 cursor-agent 在其它地方安装.

在 Windows 上,桥梁检查本地的 Claude 代码安装于 %USERPROFILE%\.local\bin\claude.exe 计外 PATH在配对之前, 验证相同的 PowerShell 窗口可以运行 :

claude --version
claude auth status

如果 Claude 代码安装在自定义目录中, 请设定其绝对路径 在运行 Dexter 命令之前, PowerShell 会话:

$env:DEXTER_BRIDGE_CLAUDE_BIN = "C:\path\to\claude.exe"

dry-run 核查配对、进行投票和举办活动,不编辑 画布. claude-code 通过本地 CLI 执行。 Codex 使用一个持久性 codex app-server 认证、线索、使用和取消的程序:

DEXTER_BRIDGE_AGENT=claude-code npx @gakim-digital/dexter-bridge start
DEXTER_BRIDGE_AGENT=codex npx @gakim-digital/dexter-bridge start

桥会从本地的登录运行时间中找到模型而不是依赖 在发布时间列表。 克劳德密码模型来自SDK特工 supportedModels() 结果, 代码模型来自 App 的每页 服务器 model/list 结果。 桌面桥会刷新此目录 其正常心跳回路; CLI每5分钟刷新一次.

代码应用程序 服务器运行规划转换为专用的只使用模型的引擎 空临时工作空间。 对于一个 App 构建器的结果, 它得到一次性的 短片和工作空间-写入只在该快片内; 网络, app, 钩子,内存,多代理,MCP,插件,图像,和网络访问仍然被禁用. 桥面读取有效的 Codex 提供者配置并仅转发 提供方明确提及的环境变量,例如: env_key;不相关的过程秘密仍然被排除在外。 配置的提供者 首选时使用缓存的 OpenAI/ChatGPT 账户作为倒置 没有所需的供应商证书。 可重新利用规划会议; 每个编码结果都使用一个新的孤立的工作空间. 该桥默认最多保留了32个最近的 Codex 线程; 覆盖此 与 DEXTER_BRIDGE_CODEX_MAX_THREADS。 。 。 .

CLI 将设备符号存储在 ~/.dexter-bridge/config.json 有模式 0600 支持的地方。 macOS 桌面应用软件通过 Electron 存储符号 safeStorage,由用户的macOS认证加密支持. Dexter 平台 附带运行不收费;后端记录报告使用 为能见度.

生产API端点必须使用HTTPS. 普通 HTTP 仅被准确接受 本地开发期间的 localhost 回回地址 .

Claude Code计划转而作为只使用模型的引擎运行. App 构建器结果运行 启用本地读取/写出/编辑/搜索工具 严格的InstaWebAI MCP工具集. Shell 检查、预览、浏览器动作, 编辑数据检查,并通过服务器所属的系统进行核查 工作空间边界; 本地 shell、 网络和外部指令访问 继续禁用。 该桥提供严格的JSON计划 和产品专用 系统即时.

Claude Code运行使用流线 JSON 和 Codex运行使用 JSONL 这样桥就可以 报告输入、输出、缓存和推理符号,即使转弯 中断 。 克劳德的报告 total_cost_usd 显示为估计数 API等同成本,不是Dexter收取的金额. 如果年长或定制 CLI 不支持结构化输出, 设置 DEXTER_BRIDGE_STRUCTURED_USAGE=false· ; 运行将继续下去,但是其符号使用将被标记为不可用 而不是从文本中估计.

DEXTER_BRIDGE_AGENT_TIMEOUT_MS 是非活动限制, 每次重排 本地模型输出. DEXTER_BRIDGE_AGENT_MAX_DURATION_MS 这是 硬墙时钟天花板; API 可从 其余的运行预算。 Claude在故意计划车道上失手了 和后续/恢复回合, 和中等努力的开口设计回合. 以 DEXTER_BRIDGE_CLAUDE_PLANNER_EFFORT, (中文(简体) ), DEXTER_BRIDGE_CLAUDE_MAIN_EFFORT, (中文(简体) ), DEXTER_BRIDGE_CLAUDE_FOLLOWUP_EFFORT,或 DEXTER_BRIDGE_CLAUDE_EFFORT。 。 。 .

调试

Dexter Bridge终点站是贝壳 dexter-bridge start 正在运行. 对于每个伴跑,桥上也写有被编辑的JSONL追踪:

~/.dexter-bridge/logs/run-<runId>.jsonl

设定 DEXTER_BRIDGE_LOG_DIR=/path/to/logs 以覆盖位置。 桌面 app在其应用日志旁边写同样的运行痕迹; 使用 显示日志 输入 打开文件夹的桌面窗口.

在卡通运行中有用的事件 :

  • model_turn 编号 : agent_process_spawn ——克劳德法典或法典被援引.
  • outcome - 正在利用这一手段落实完整的有限产品成果.
  • agent_process_timeout ——当地代理在超时前未返回.
  • event_post_done ——大桥将一个模型完成还给共享服务器环.
  • run_done ——本地模式转会或结果完成.

桌面发布

从 framer-plugin数字 :

npm run bridge:desktop:dev
npm run bridge:desktop:build:mac
npm run bridge:desktop:build:win
npm run bridge:desktop:dist
npm --prefix packages/dexter-bridge-desktop run verify:mac
npm --prefix packages/dexter-bridge-desktop run verify:win

Mac 构建的发音 .dmg 财务报告和审定财务报表 .zip 文物来自 packages/dexter-bridge-desktop/release。 。 。 .

Windows x64 构建了 NSIS 的发射程序 .exe 安装器和 a .zip 文物来自 同一个发布目录。 直接或通过 Windows 构建 .github/workflows/dexter-bridge-windows.yml; 不可依赖 Windows 包装 在开发者的macOS环境中.

当开发者 ID 身份可供使用时, 释放会自动建立签名 电子建设器. 公证从 afterSign 当两个 App 存储 连接 API 证书( E)APPLE_API_KEY, (中文(简体) ), APPLE_API_KEY_ID, (中文(简体) ), APPLE_API_ISSUER)或苹果ID证书(APPLE_ID, (中文(简体) ), APPLE_APP_SPECIFIC_PASSWORD, (中文(简体) ), APPLE_TEAM_ID)已配置。 设定 DEXTER_REQUIRE_NOTARIZATION=true cI 丢失的证明文件失败 而不是生产未经公证的文物.

Windows 签名是通过电子构建器的标准证书配置的 环境变量,例如 CSC_LINK 财务报告和审定财务报表 CSC_KEY_PASSWORD设置 DEXTER_REQUIRE_WINDOWS_SIGNING=true 运行时 verify:win 为公众服务 释放。 未签名的安装器只适合内部测试.

未签名的桌面应用程序不是公共克洛德设置路径. 直到公证 已建立, macOS Claude 用户应接受 Homebrew 服务流量 见上文.

建议释放

FRAMER_COMPANION_DOWNLOAD_URL=https://instawebai.com/dexter-bridge
NEXT_PUBLIC_DEXTER_BRIDGE_VERSION=0.11.5
NEXT_PUBLIC_DEXTER_BRIDGE_DOWNLOAD_BASE_URL=https://instawebai.com/downloads/dexter-bridge
NEXT_PUBLIC_DEXTER_BRIDGE_MAC_ARM64_URL=https://instawebai.com/downloads/dexter-bridge/Dexter-Bridge-0.11.5-mac-arm64.dmg
NEXT_PUBLIC_DEXTER_BRIDGE_MAC_X64_URL=https://instawebai.com/downloads/dexter-bridge/Dexter-Bridge-0.11.5-mac-x64.dmg
NEXT_PUBLIC_DEXTER_BRIDGE_MAC_ZIP_URL=https://instawebai.com/downloads/dexter-bridge/Dexter-Bridge-0.11.5-mac-universal.zip
NEXT_PUBLIC_DEXTER_BRIDGE_WIN_X64_URL=https://instawebai.com/downloads/dexter-bridge/Dexter-Bridge-0.11.5-win-x64.exe

版本与发布记录

@gakim-digital/dexter-bridge 共发布 57 个版本,首次发布于 2026/07/20;过去 12 个月发布了 57 个版本。

版本发布日期距今
0.13.13latest2026/11/0510 天前
0.13.122026/11/0510 天前
0.13.112026/11/0511 天前
0.13.102026/11/0411 天前
0.13.92026/11/0312 天前
0.13.82026/11/0214 天前

关于 @gakim-digital/dexter-bridge 的常见问题

@gakim-digital/dexter-bridge 是什么?

InstaWebAI和Dexter的本地桥——在你的机器上运行了Codex,Claude Code,或者OpenCode.

如何安装 @gakim-digital/dexter-bridge?

在项目目录运行 npm install @gakim-digital/dexter-bridge,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dexter-bridge,可以用 npx dexter-bridge 直接运行。

@gakim-digital/dexter-bridge 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/gakim-digital__dexter-bridge 是否存在。

@gakim-digital/dexter-bridge 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@gakim-digital/dexter-bridge 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@gakim-digital/dexter-bridge 可以商用吗?

@gakim-digital/dexter-bridge 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@gakim-digital/dexter-bridge 的下载量有多少?

根据 npm 官方下载统计,@gakim-digital/dexter-bridge 在 2026/10/16 – 2026/11/14 这 30 天内被下载 4,821 次,日均约 161 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gakim-digital/dexter-bridge 还在维护吗?

最新版本 0.13.13 发布于 2026/11/05(10 天前);至今共发布 57 个版本,其中过去 12 个月发布了 57 个;首次发布于 2026/07/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。