# @gakim-digital/dexter-bridge 中文文档 规范地址：https://npmcn.com/package/%40gakim-digital/dexter-bridge/ 版本：0\.13\.13 npm 元数据更新时间：2026-11-05T14:55:35.752Z 中文译文更新时间：2026-11-15T21:22:47.268Z 软件包许可：SEE LICENSE IN LICENSE 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40gakim-digital/dexter-bridge 原文对照：https://npmcn.com/package/%40gakim-digital/dexter-bridge/?lang=original 项目主页：https://instawebai.com/dexter-bridge ## 关键信息（来自 npm 元数据） - 包体积（解压后）：698 kB，31 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=22 - 运行依赖：15 个 - 首次发布：2026-07-20T12:37:24.494Z - 最新版本发布：2026-11-05T14:55:35.552Z - 近 30 天下载量：4821（2026-10-16 至 2026-11-14，npm 官方下载统计） - 已发布版本数：57（近 12 个月 57 个） ## 中文简介 InstaWebAI和Dexter的本地桥——在你的机器上运行了Codex,Claude Code,或者OpenCode. ## 安装 ```sh npm install @gakim-digital/dexter-bridge ``` 也可以使用：`pnpm add @gakim-digital/dexter-bridge`、`yarn add @gakim-digital/dexter-bridge`、`bun add @gakim-digital/dexter-bridge` ## README # 本地代理桥 InstaWebAI和Dexter的本地桥CLI. 它连接用户已有的 Codex, Claude 代码, 或 OpenCode 设置而不发送这些登录证书 前往InstaWebAI(英语:InstaWebAI). 这两种产品共用了桥包,但并非其配对状态. API (英语) 配对时指定产品身份; CLI 无法转换一个产品的 将代码配对到另一个产品的连接中. ## InstaWebAI 应用程序构建器 连接页面提供单独的Codex,Claude代码和OpenCode卡. 选择代理, 复制其命令, 在构建时保持终端打开 : ```bash 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-v4`Dexter 不建模 帧器的交互特性: 模型构建任何能力的行为 框架文档,以节点宣布每个行为 应随行,然后标出每个携带它的帧器属性 节点( 例如 `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、 代理和模型 : ```bash 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`。 。 。 . 有用的服务命令 : ```bash 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 填入: ```bash npx --yes @gakim-digital/dexter-bridge@latest connect 123456 --api https://api-insta.instawebai.com/iwm-api/0.0.1 --agent codex ``` 运行 `connect` 没有代码可以重用保存的配对。 低级指挥部留任 支助和自动化: ```bash 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 窗口可以运行 : ```powershell claude --version claude auth status ``` 如果 Claude 代码安装在自定义目录中, 请设定其绝对路径 在运行 Dexter 命令之前, PowerShell 会话: ```powershell $env:DEXTER_BRIDGE_CLAUDE_BIN = "C:\path\to\claude.exe" ``` `dry-run` 核查配对、进行投票和举办活动,不编辑 画布. `claude-code` 通过本地 CLI 执行。 Codex 使用一个持久性 `codex app-server` 认证、线索、使用和取消的程序: ```bash 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追踪: ```bash ~/.dexter-bridge/logs/run-.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`数字 : ```bash 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 服务流量 见上文. 建议释放 ```bash 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 是什么？ 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 和提交记录判断。