Copilot Remote Bridge

Copilot Remote Bridge 是一个 VS Code 扩展，用于把当前 VS Code 窗口中的远端 Copilot Agent 能力桥接到移动端客户端。

功能

• 将手机端请求转发到当前 VS Code 工作区
• 通过 @remote chat participant 在 VS Code Chat 中显示回复
• 尽量复用 VS Code / Copilot Chat 默认只读工具链路
• 对有副作用的操作走 bridge 代理工具，并把审批同步回移动端
• 当前 bridge 自带的副作用工具只有：
  • run_terminal_command
  • write_workspace_file

要求

• VS Code ^1.95.0
• 已安装并可用 GitHub Copilot Chat
• 可访问 Copilot Remote Relay 服务

配置

本扩展提供以下设置：

• copilotRemoteBridge.relayUrl: Relay WebSocket 地址，默认 ws://127.0.0.1:8787/ws
• copilotRemoteBridge.relayToken: Relay 鉴权令牌
• copilotRemoteBridge.deviceName: 可选，当前桥接设备展示名
• copilotRemoteBridge.debugLogs: 是否输出详细调试日志，默认 false

使用方式

1. 启动 Relay 服务。
2. 在 VS Code 中安装本扩展。
3. 配置 copilotRemoteBridge.relayUrl 与 copilotRemoteBridge.relayToken。
4. 执行命令 Copilot Remote: Start Bridge，或等待扩展自动连接。
5. 在 Chat 中使用 @remote 发起请求。

多设备与扫码配对

• 每个 Bridge 会持久化一个设备 ID
• 可以配置 copilotRemoteBridge.deviceName 作为展示名称
• 执行命令 Copilot Remote: Copy Pairing Link 后，会为当前设备生成一个短期有效的配对链接并复制到剪贴板
• 执行命令 Copilot Remote: Open Pairing Dashboard 后，会直接打开 Broker 的浏览器控制台，列出在线设备并可一键生成配对码
• 该链接可直接转成二维码，供移动端、小程序或 Web 客户端扫码绑定当前 VS Code 设备

如果要给小程序使用，Relay 建议部署在公网并启用 wss://。

只发布 Bridge 时的说明

可以单独发布本扩展，不要求先发布 Web / 小程序客户端。

但要注意：

• 安装扩展 不需要先部署服务端
• 真正使用远程配对与转发 仍需要一个可访问的 Relay / Broker 服务

所以，Bridge-only 发布适合：

• 先做桌面端内测
• 先走 VSIX 分发
• 先上 Marketplace 占位
• 服务端后续再部署

当前版本为 MVP，适合私有部署、内测和持续迭代。

正式发布（插件）

1) 生成内测安装包（.vsix）

pnpm --filter copilot-remote-vscode-bridge release:vsix

执行完成后，会在插件目录下生成 .vsix 文件，可用于企业内部分发或灰度验证。

2) 发布到 VS Code Marketplace

先在当前终端设置发布令牌（PAT）：

$env:VSCE_PAT="你的PAT"

然后在插件目录执行：

pnpm release:publish

如果希望自动升级版本号并发布，可使用：

pnpm release:publish:patch
pnpm release:publish:minor
pnpm release:publish:major

3) 发布前检查建议

• 确认 publisher 已在 Azure DevOps 创建并与 Marketplace 绑定
• 确认 version 未与线上重复
• 确认 README.md、CHANGELOG.md、LICENSE 已更新
• 如果暂时只发布 Bridge，README 中要明确说明仍需单独配置 Relay 服务
• 先发 .vsix 给内部验证，再推 Marketplace 正式版

4) 推荐发布顺序

1. 先执行 release:vsix 做本地安装验证
2. 内部验证配对、审批、命令执行、写文件链路
3. 确认版本号后再执行 release:publish

隐私与安全

• 终端命令与文件写入属于有副作用操作。
• 这些操作会在 VS Code Chat 中显示工具调用，并需要确认。
• 如果请求来自移动端，Bridge 也会继续走移动端审批链路。