chenacc1/agentbridge ↗★ 1

@chenacc/agentbridge

Control local coding agents from a phone through a secure WeChat QR web console.

패키지
@chenacc/agentbridge
호환성
미검증
버전
0.2.2
라이선스
MIT
최근 업데이트
2026. 11. 8.

설치

검증된 bundle이 없거나 호환성 검사에 실패했습니다. 먼저 저장소 설명을 읽어 주세요. 전체 README 읽기 ↗

常用配置

完整变量见 .env.example。

桥本身:

变量默认值含义
AGENTBRIDGE_PORT8787HTTP 监听端口
AGENTBRIDGE_HOST0.0.0.0监听地址
AGENTBRIDGE_PROJECTS当前目录项目白名单,分号分隔 别名=绝对路径
AGENTBRIDGE_DATA_DIR~/.agentbridge(CLI / 插件)/ 启动目录(npm start)会话、事件、密钥、隧道状态的目录
AGENTBRIDGE_PUBLIC_ORIGIN自动(公网隧道或局域网地址)写进二维码的访问地址;设了它就不再自动开隧道
AGENTBRIDGE_ACCESS_KEY未设置访问密钥;对公网开放时自动生成并写入 access-key 文件
AGENTBRIDGE_PAIRING_TTL_MS300000配对码有效期(5 分钟)
AGENTBRIDGE_SESSION_TTL_MS259200000设备会话有效期(72 小时)
AGENTBRIDGE_CLAUDE_MODEL供应商默认可选的 Claude / Kimi 模型 ID
AGENTBRIDGE_NOTIFY_WEBHOOK未设置通知 Webhook;未设置时该功能静默
AGENTBRIDGE_NOTIFY_IMPORT未设置通知设置存在旧数据目录时,指向它一次即可自动迁过来

通知设置(webhook / token / 静默开关)保存在桥的数据目录下的 notify.json,默认是 %USERPROFILE%\.agentbridge。DSH 插件接管网关后数据目录换过位置,老配置如果留在原来的 .agentbridge 里,用 AGENTBRIDGE_NOTIFY_IMPORT= 启动一次就会自动迁过去;也可以直接在桌面控制台的「通知」面板重填一次。桥启动日志里有一行 Notifications: pushplus/clawbot 或 Notifications: off — no webhook configured in …,能直接看出它到底读到了哪个文件。

跨网络(CLI 与插件都认):

变量默认值含义
AGENTBRIDGE_REMOTEauto走哪条路径:auto / cloudflare / named / funnel / tailscale / zerotier / lan
AGENTBRIDGE_NO_TUNNEL未设置设为 1 等价于 AGENTBRIDGE_REMOTE=lan
AGENTBRIDGE_TUNNEL_URL未设置直接指定隧道域名(给"隧道自己管"的人)
AGENTBRIDGE_CLOUDFLARE_TUNNEL未设置Cloudflare 命名隧道的名字;设了它 auto 会优先用它
AGENTBRIDGE_CLOUDFLARE_HOSTNAME未设置命名隧道对应的公网域名
AGENTBRIDGE_CLOUDFLARED自动查找用你自己那份 cloudflared;设了它既不搜索也不下载
AGENTBRIDGE_CLOUDFLARED_URL官方 Releases换下载源(内网镜像),下载后照样过 --version 校验
AGENTBRIDGE_NO_DOWNLOAD未设置设为 1 禁止自动下载 cloudflared
AGENTBRIDGE_TAILSCALE自动查找指定 tailscale 可执行文件(装在非常规位置时用)
AGENTBRIDGE_ZEROTIER自动检测网卡直接指定 ZeroTier 分配到的 IPv4

插件 / CLI 专用:

变量默认值含义
AGENTBRIDGE_ORIGINhttp://127.0.0.1:8787插件连接的本地桥地址
AGENTBRIDGE_LOCAL_ORIGINhttp://127.0.0.1:8787CLI 连接的本地桥地址
AGENTBRIDGE_NO_AUTOSTART未设置设为 1 关掉"插件加载时自动起桥"

变量要设在真正启动 DSH Desktop / 终端的环境里,不是设在跑桥的另一个窗口里。