[建议 / Feature] Remote Control 支持端口转发/网页代理,让手机直接访问开发机内网或虚拟机里的 Web 服务
Nobody has claimed this yet.
- 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
痛点
手机远程时完全无法访问虚拟机内的前端页面:
- 内置浏览器面板仅桌面端可用(官方文档明确),手机端会话只能看到文本和截图;
- 远程开发不提供端口转发,文档仅建议用户自行 ssh -L,且该方案只通到宿主机、到不了手机;
- Agent 截图回传只能"看"不能"操作",无法真实交互调试页面;
- 第三方内网穿透(frp/ngrok/cloudflared)需要公网暴露或额外组网,企业内网环境通常不被允许。
影响
所有"手机远程 + 服务跑在内网/虚拟机/远程工作区"的用户都受益;
这也是与 VS Code tunnels 对齐的竞争力功能。
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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