工程师OS 连接器
连接本地编码代理或臭虫猎人主机到 EngineerOS.
所需资源
- 在Windows,macOS或Linux上的节点.js 22或更新和npm.
- 一个 EngineerOS 配对命令和访问您选择的编码代理 .
- 连接代码存储器时的 Git .
- 被保护的证书存储:Windows证书管理器/数据保护,macOS keychain,或Linux保密服务. 在 Linux 上安装
secret-tool(单位:千美元)libsecret-tools)并运行GNOME Keyring或KWallet等未解锁的密钥环.
安装
npm install --global @engineeros/connector@latest
engineeros-connector version
在不安装全局的情况下运行, 替换 engineeros-connector 以下命令中 npx --yes @engineeros/connector@latest。 。 。 .
连接工作空间
在EngineerOS中,打开 项目指导-连接工作空间 并复制配对命令。 在您的工程文件夹中运行 。 例如,使用 Codex :
engineeros-connector agent codex-acp install
engineeros-connector pair PAIRING_CODE --url https://your-engineeros.example --workspace . --onboard --agent codex-acp
用 EngineerOS 的值替换代码和服务器 URL. 提醒时向代理签名; 对于 Codex , 运行 codex login 在另一个终端。 保持连接终端开放.
运行 engineeros-connector agents 以列出支持的代理人。 在以上两个命令中使用选中的代理标识; 对于 Claude, 使用 claude-acp。 。 。 .
重新启动一个已经对齐的工作空间 :
engineeros-connector start --workspace .
目标执行和恢复
目标执行使用合同4,需要匹配的EngineerOS后端. 服务器保留了重启和复修期间的维修预留,包括规划、机票和仓库质量的维修。 恢复新的工作树木不能重新设置这些津贴;保留原来的检查站并完成工作.
范围扩大需要用户明确批准存储处与相关处 Path: 问题及其受影响的文物。 被排除的路径被排除在外。 普通证明不能授权未经批准的档案.
在服务器修复会计保留其证据并保存头部之前创建的运行 。 使用明确审查的后续目标来继续修改其代码;未知的历史备抵从未被初始化为未使用。 保存的完成结果仍可按其最初的行刑尝试交付.
没有寄存器连接臭虫猎人
选择 在运行中的应用程序中查找错误 在 EngineerOS 中,添加您的目标并复制其主机命令:
engineeros-connector hunt-host PAIRING_CODE --url https://your-engineeros.example --project PROJECT_UUID --agent codex-acp
命令准备代理,并在缺失时自动安装连接器被绑定的 Playwright 运行时间并匹配被管理的 Chromium. 工作空间 pair 财务报告和审定财务报表 start,打猎和录入的签入使用相同的浏览器设置路径. 完成请求代理签入并保持终端开放. 不需要单独的 Playwright 设置命令 .
在Linux上,使用可用的管理员访问设置检查并安装缺失的系统依赖性. 终端可以请求您的密码; 如果无法访问, 背景进程永远不会提示并报告准确的管理员命令 。 被禁用的工具仍然被禁用,完整性或版本不匹配需要明确的修复. 在浏览器准备失败时会保留已验证的软件包,所以从已安装的软件包继续重试. 设置验证真实的孤立上下文,合成导航,HTTP/WebSocket截取,状态恢复,截图/追踪捕获和证据存储. 根据需要在 Bug Hunter 设置中配置测试账户, 应用程序构建和设备 .
初始导航前只公开浏览块状态变化/未知的HTTP操作和WebSockets. 解析、清晰的图表QL 查询 /graphql 端点可能随JSON操作文件而通过;突变,订阅,分批,多段和坚持/未知文件不通过. 同样的政策也适用于明确的请求步骤和每个浏览器通过Chromium响应截取重定向hop. 在网络接入前无法建立此守护的帧/弹出被无支持能力诊断屏蔽. 连接器-本地代理验证和标定实际套接字目的地和重定向;元数据/保留地址仍然被拒绝。 私人 DNS 目标需要在允许的主机中每一个经批准的私人地址;本地主机名称必须完全解决回回回回回回回回. 本地外观后缀不允许私人网络访问. 地址更改需要新的授权运行 。 健康/版本检查、发射准备状态、重设接钩、计程检查和发现使用同样的防守套接字规则;只有公共赠款才能拒绝发射/种子/重设效应. 当无法执行此套接字边界时, 带有被保护的 HTTP( S) 目标的 Cloud web 浏览器和 Electron 被屏蔽 。 纯粹是局部的电动动作和本土的WebDriver保留了各自独立的执行路径,没有合格的网络运输覆盖.
网络案件必须声明 Effects, (中文(简体) ), Test data 财务报告和审定财务报表 Cleanup starts 在马克登。 写出自己的文件 {unique} 数据和最后清理范围。 清理在断言失败后进行,并保留了原来的失败. 未完成的清理工作停止了进一步的自动工作,直到自有数据得到解决,操作员明确恢复. 没有申报的现有案例仍然保留,在执行前需要明确的再生或修复;如果模型没有产生可执行的案例,则计划进口从未制造出可执行的案例.
在加密的猎人/环境分类账中,未完成的清理、探测或重新观察作为原始结果散列之外的事件予以保留。 一个重启在目标工作前报告,无法启动另一个执行 。 解决所命名的自有数据,同步事件,再以理由恢复EngineerOS中被停止的猎人,并开始新的授权运行. 只有承认有确切的事件身份才能清除当地的障碍。 最初的结果、失败、儿童证明和尝试预算保持不变.
已录入的签入绑定工程,环境,连接器,账号,角色和精确的应用源. 记录一次登录,然后开始测试;不需要签入标记. 在高级账户选项下配置的标记在每个案件之前,在单独的只读上下文中添加了明确的身份检查. 没有记录,跑者将直接恢复记录,并报告在测试中遇到的签入重定向。 单靠恢复状态并不能声称已核实的登录健康。 被保护主机保存应用程序 cookie, localStorage, sessionStorage和索引DB,包括更新会话;可选的健康检查从不收集截图或发现事实. 早先的无约束录音需要明确重新记录.
该app自己的浏览器请求可以在包括Supabase在内的其他来源上到达公共API和登录服务,而无需将这些服务配置为测试目标. 这适用于录音、密码签名和恢复会话。 明确的案例导航/API请求仍然有范围;只读规则、TLS/CORS和私人网络保护仍然得到执行。 仅保留该应用的经批准的cookie/存储来源;联系公共身份提供者不会捕捉其登录状态.
屏幕截图和活框默认关闭. 设置 在新猎捕中允许截图 允许新的不可改变的任务,包括本地捕获;它不会改变现有的运行。 可见的测试数据可以在授权的图像中出现. 未经许可,运行时保留允许的文字观察和检查;不充分的片面证据仍然被隔离。 已知的认证值被从文本元数据中去除,具有认证的发现路径被排除在外,而不是被重写成回放URL. 浏览器准备状态只捕捉它自己的合成局部固定.
以 :
engineeros-connector hunt-host --project PROJECT_UUID
连接器代理默认值
工作空间任务和Bug Hunter代理转而使用连接器所运出的执行政策:简洁报告、有限度的阅读、对所提供上下文/记忆的再利用、目标明确的核查以及明确的能力差距。 必要的覆盖范围、证据、许可和反应合同仍然适用。 该政策附加在新会话上;继续重复使用。 它不将这个寄存器的开发指令复制到另一个项目,也不在那里创建指令/技能文件.
| 探员 | 连接器控制 | 剩余遗产 |
|---|---|---|
代码CLI和 codex-acp | 禁用已安装的插件、应用、捆绑技能和自动技能目录。 连接器默认覆盖扩展设置; ACP 忽略环境 CODEX_CONFIG。 。 。 . | 认证,提供者配置,寄存器规则和无关的本地设置(包括单独配置的MCP服务器)仍然可用. |
claude-acp | 提供空的用户/项目/本地设置源,插件和技能列表;仅接受会话提供的 MCP 配置;禁用即时建议. 应用到新加载的会话 . | 现有的登录和管理政策依然存在。 仓库指令在工作空间工作需要时会被明确读取. 需要支持适配器 claudeCode.options 届会元数据. |
| 双子座 | 强制 --extensions none。 。 。 . | 其他设置和技能可能仍然在装入;发出警告. |
| 打开代码 | 提供连接器工具目录; 禁用工程配置和外部/ Claude 技能发现; 替换继承的内置配置覆盖 . | 用户级插件和设置可能仍会加载;发出警告. |
| 非加太集团或习惯 | 提供共同执行政策. | 配置排除不支持; 发出警告并继续进行 。 Forge保留其现有的用户范围MCP注册. |
这些控制仅适用于连接器的发射. 它们不会编辑编码代理的全局设置或复制证书. 不支持的适配器仍可用警告;其扩展上下文无法保证. 使用当前 Codex 或 Claude ACP 适配器执行插件排除 。 配置控制会减少可避免的上下文;实际的象征性节省需要比较记录的等效跑用.
解决问题和更新
engineeros-connector doctor --workspace .
npm install --global @engineeros/connector@latest
- 缺少配对 : 从 EngineerOS 复制一个新的配对命令.
- 代理登录失败 : ,然后重新启动连接器.
fetch failed或网络错误代码 : 运行doctor并从连接器的机器中检查 DNS 主机名 .ENOTFOUND编号 :EAI_AGAIN显示解析失败;ECONNREFUSED指目的地拒绝连接;连接超时需要检查路由,防火墙和服务器/代理收听器. 证书错误需要修复证书或信任的 CA 链. 继续启用 TLS 校验 。 从未收到过HTTP确认的请求不能确定无效配对或API-key拒绝;在调查时保留配对.- 证书存储不可用 : 解锁或配置上面列出的保护商店,然后重新启动 。 无头Linux主机也需要运行的特勤局.
- 结果执行被中断 : 已完成的即时答案和失败在本地保存,并在重新连接后重新测试。 如果 EngineerOS 永久拒绝结果,终端会命名保留的证据文件和理由. 调查时保留文件; 拒绝的结果不会自动重运行代理 .
本地分娩管理时间
先给工作空间配对 绘制本地 JSON 运行时配置 kind: docker-readonly-tmpfs-v1,不可改变的消化固定 image 财务报告和审定财务报表 proxy_image, (中文(简体) ), connector_entry: /opt/engineeros/bin/engineeros-connector.mjs,以及安装的适配器 agent_config (单位:千美元)agent_protocol选项 agent_command, (中文(简体) ), agent_args, (中文(简体) ), agent_name) (中文(简体) ). 将提供者证书保存在单个本地文件中. 每一个明确 credentials 条目名称绝对正则文件 source一个独特的 /run/credentials/<name> 目标 readonly: true; 目录和同义链接被拒绝. 永远不要在JSON中置入证书价值或环境秘密.
engineeros-connector delivery configure --profile /absolute/path/runtime.json --workspace .
engineeros-connector delivery status --workspace .
重新启动连接器来广告配置的隔离身份 。 保留真实的隔离,流程,资源,恢复,提供者约束和范围测量,在实施受管计划前获得环境批准. 配置和 delivery probe 单凭时间不合格。 更改的证书、图像或能力散列需要重新获得资格。 原生范围使用完整的被测量的CLI捆绑和文件系统所有权;它不执行每个工具的过滤. 缺少先决条件在发射前拒绝工作并保留现有证据/会计.
- 上传输入被拒绝 : 使用公共的 HTTPS 存储或 Hunter 主机的本地输入文件夹 。 下载拒绝私人/元数据地址,限为25 MB和60秒.
- 在公司代理的背后: 设定
HTTPS_PROXY(或HTTP_PROXY),以及NO_PROXY用于内部主机,在启动连接器之前。 连接器自己的EngineerOS,npm和代理-注册流量然后使用该代理;回路地址总是绕过它. 对于私人证书管理机构,也设置NODE_EXTRA_CA_CERTS到它的 PEM 文件。 编码代理使用他们自己的代理设置,Bug Hunter目标流量保持其单独的被守护路径.
许可证
版权(c)2026 Techmirus 创新。 。 。 .
这个 EngineerOS 连接器 二进制使用许可证 允许个人和商业使用官方可执行文件的分发。 原始来源仍为专有. 第三方依赖者保留自己的许可证;捆绑的语法通知在 语法/NOTIEC.md。 。 。 .
保留工作历史
engineeros-connector history compact --workspace <folder> 合并已确认的终端报告文件,同时保留所有加密证据机构、确认和执行身份。 在未接到或拒绝报告时,当地保留的证据和中断/不确定的工作没有改变。 新终端报告自动压缩 。 在这个存储layout切换之前停止旧的连接器版本; 它们不能读取压缩的档案 。 该命令使用局部被保护的存储而无需联系EngineerOS. 见 留存额合同。 。 。 .