zai-org / zai-org/feedback

[建议 / Feature] Remote Control 支持端口转发/网页代理,让手机直接访问开发机内网或虚拟机里的 Web 服务

Open
#289 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority: P2 status: 待评估 type: 功能建议
Dominant language
No language data
Stars
22
Forks
1
PR merge metrics
No merged PRs in 30d

Description

提交前确认 · Pre-submission checklist
  • 我已搜索过现有 issue,确认这不是重复提议 / I searched existing issues and confirmed this isn't a duplicate.
  • 我已阅读 CONTRIBUTING.md / I've read CONTRIBUTING.md.
问题类别 · Category

其他 / 不确定 · Other / Not sure

涉及的 Agent 框架 · Agent framework

ZCode Agent(自研)

使用场景 · Use case

开发环境为 Windows 宿主机 + Linux 虚拟机(VMware/WSL),前端 dev server 运行在虚拟机内网。
手机不在同一局域网,通过 Remote Control 远程跟进 ZCode 任务。

建议方案 · Proposal

会话或手机端提供"转发此端口"入口,生成一个经 ZCode 中继、带鉴权的临时 HTTPS/HTTP URL 即可。

预期价值 · Expected value

类似 VS Code Remote Tunnels 的端口转发能力:
Remote Control 的中继通道把桌面端可达的端口(含远程工作区/WSL/虚拟机内的 localhost 服务)
以 URL 形式暴露给手机,手机浏览器直接打开并交互,无需任何第三方穿透工具。
安全性可沿用 Remote Control 现有的"临时钥匙"机制:停止远程控制即失效。

你认为的优先级 · Your perceived priority

中 · Medium

你使用的 ZCode 版本 / 环境 · ZCode version / environment

v3.7.7

补充材料 · Additional context

痛点

手机远程时完全无法访问虚拟机内的前端页面:

  1. 内置浏览器面板仅桌面端可用(官方文档明确),手机端会话只能看到文本和截图;
  2. 远程开发不提供端口转发,文档仅建议用户自行 ssh -L,且该方案只通到宿主机、到不了手机;
  3. Agent 截图回传只能"看"不能"操作",无法真实交互调试页面;
  4. 第三方内网穿透(frp/ngrok/cloudflared)需要公网暴露或额外组网,企业内网环境通常不被允许。

影响

所有"手机远程 + 服务跑在内网/虚拟机/远程工作区"的用户都受益;
这也是与 VS Code tunnels 对齐的竞争力功能。

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No implementation files, entry points, or tests are named in the issue. Start by reading CONTRIBUTING.md and locating the existing Remote Control relay and authentication paths; done should be a temporary authenticated URL that lets a phone reach host, WSL, or VM web services and expires when remote control stops.

Written by the indexing model from the issue text.

Assessment

Domain
networking
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.