Skip to content

feature.remote-connect.md

Latest commit

 

History

History
83 lines (66 loc) · 7.57 KB

feature.remote-connect.md

File metadata and controls

83 lines (66 loc) · 7.57 KB
Raw

id: feature.remote-connect kind: feature category: connect title_zh: "Remote Connect 与多设备" title_en: "Remote Connect & devices"

Remote Connect 与多设备 / Remote Connect & devices

功能 / Feature

从手机、Bot 或另一台 OpenBitFun 设备远程查看会话、回答权限并继续工作。手机与同账号设备互控默认使用官方 Relay，无需部署服务器；官方与局域网模式登录时均需联网。

Inspect sessions, answer permissions, and continue work from mobile, a bot, or another OpenBitFun device. Mobile and same-account device control use the official Relay by default, with no server deployment; both official and LAN modes need internet access for sign-in.

完整功能清单 / Everything included

  • 智能体可定位入口，需交互完成 / Agent opens; interaction required · 使用官方 Relay 或桌面内置局域网 Relay；两者可同时运行，登录均需联网
    • Use the official or Desktop-hosted LAN Relay; both can run together and need internet for sign-in
  • 智能体可直接控制 / Direct Agent control · 启动、停止 Remote Connect 并查看实时连接状态和设备信息
    • Start or stop Remote Connect and inspect live status and device information
  • 智能体可定位入口，需交互完成 / Agent opens; interaction required · 查看局域网 IP、网络信息与可分享的连接配置
    • Inspect LAN IP, network details, and shareable connection configuration
  • 智能体可直接控制 / Direct Agent control · 配置飞书、Telegram、微信等 Bot 并单独停止 Bot
    • Configure Feishu, Telegram, WeChat, and other bots, and stop a bot independently
  • 智能体可定位入口，需交互完成 / Agent opens; interaction required · 通过共享登录页使用 GitHub 或邮箱验证码登录、退出并查看身份状态
    • Sign in through the shared page with GitHub or an email code, sign out, and inspect identity status
  • 智能体可定位入口，需交互完成 / Agent opens; interaction required · 列出、连接、查看设备型号与系统、设置别名和删除同账户设备
    • List, connect, inspect model and OS, set aliases, and remove same-account devices
  • 智能体可定位入口，需交互完成 / Agent opens; interaction required · 进入 Peer Device Mode，把另一台 OpenBitFun 设备作为命令与事件数据面
    • Enter Peer Device Mode and use another OpenBitFun device as the command and event data plane

怎么用 / How to use it

  1. 打开 Remote Connect，选择网络、Bot 或账户入口 Open Remote Connect and choose Network, Bot, or Account
  2. 手机或设备互控：宿主与控制端以相同方式登录同一账号，官方 Relay 无需部署 For mobile or device control, sign in on the host and controller with the same method and account; the official Relay needs no deployment
  3. 手机可扫描官方或桌面局域网邀请，确认目标设备；二维码不授予访问权，目标宿主须保持在线 On mobile, scan an official or Desktop LAN invitation and confirm the target; the QR code grants no access and the host must stay online
  4. Bot 远控：在对应平台完成机器人配置与配对，检查监听状态 For bot control, configure and pair the bot on its platform, then check listener status

入口 / Entry: OpenBitFun 内的对应控制界面

智能体可替你做什么 / What an agent can do for you

操作 / Action 中文说明 English description
查看远控状态 / Inspect Remote Connect status 读取当前执行主机的监听、配对、停用与恢复错误；不返回凭据，监听任务存活不等于消息已完成往返。 Read listener, pairing, disabled and restore-error state on the executing host without credentials. A live listener task does not prove a message round trip.
启动远控渠道 / Start a Remote Connect channel 启动指定机器人或手机网页远控。CLI 自动启动 daemon，退出当前聊天后继续监听。新机器人需将返回的配对码发给机器人；CLI 不支持局域网 Relay。 Start the selected bot or Mobile Web. CLI starts its daemon and keeps listening after this chat exits. Send the returned pairing code to a new bot. CLI does not host a LAN Relay.
停用远控渠道 / Stop a Remote Connect channel 停用选定渠道并保留配置和会话。机器人停用状态跨重启保留。关闭手机网页会同时断开该主机的 Peer 设备路由，机器人保持运行。 Stop the selected channel while retaining configuration and sessions. Bot disablement survives restart. Stopping Mobile Web also disconnects Peer routing on this host; bots keep running.
从主机凭据文件配置机器人 / Configure a bot from a private host credential file 读取执行主机上用户提供的私有 JSON 凭据文件并保存配置；不会自动启动。文件包含 bot_type 和对应凭据字段，需绝对路径和仅所有者可读权限；不要把凭据贴到聊天中。远程工作区路径不能用作主机凭据路径。 Load a user-supplied private JSON BotConfig file on the executing host, with bot_type and provider credential fields; save without starting. Requires an absolute host path and owner-only permissions. Do not paste credentials into chat or use a remote-workspace path.
开始微信扫码登录 / Begin WeChat QR login 生成微信登录二维码。CLI TUI 在工具卡片中直接显示 qrTerminal，无需模型重写；其他终端逐字显示，图形界面显示 qrImageUrl，再用 sessionKey 轮询。扫码本身尚未完成机器人监听和配对。 Create a WeChat login QR. CLI TUI renders qrTerminal in the tool card without model transcription; other terminals show it verbatim and graphical surfaces show qrImageUrl. Poll using sessionKey; scanning alone does not complete listening and pairing.
完成微信登录并启动监听 / Complete WeChat login and start listening 轮询同一登录会话。确认后在主机保存凭据并启动监听，向用户展示返回的机器人配对码。凭据不会返回给模型。 Poll the same login session. Confirmation saves credentials on the host and starts listening; show the returned bot pairing code. Credentials are never returned to the model.
设置机器人详细输出 / Set bot verbose output 切换所有机器人的详细输出模式并保存。 Persist verbose output mode for all bot channels.

可配置选项 / Configurable options

选项 / Option 可用值 / Values 中文说明 English description
在界面中配置 / Configure in the UI — 此页面的设置在对应界面中完成。 Configure this page in its matching UI.

可以直接对智能体说 / Try saying

  • “打开 Remote Connect”
    • “Open Remote Connect”
  • “我想配置手机远程控制”
    • “I want to configure mobile remote control”
  • “带我管理已连接设备”
    • “Take me to connected-device management”
  • “启动微信机器人并持续监听消息”
    • “Start the WeChat bot and keep listening”
  • “关闭 Telegram 机器人”
    • “Stop the Telegram bot”
  • “开启手机网页远控”
    • “Enable Mobile Web remote control”

智能体会先查找相关功能或设置，确认目标后再替你打开、执行或修改。完整能力目录不会预先塞进对话上下文。

The agent first finds the relevant feature or setting, confirms the target, and then opens, runs, or changes it for you. The full catalog is never embedded in the conversation context.