qiming/qiming-noVNC/LOCAL_DEV.md

本地开发指南

⚠️ 注意: 本文档及 scripts/ 目录下的脚本仅用于开发调试，不影响原始业务逻辑。

启动开发服务器

npm run dev
# 或
pnpm dev

服务器将在 http://localhost:8080 启动。

启动虚拟桌面服务

# 使用 npm 运行（推荐）
npm run start:desktop

# 或直接运行脚本
./scripts/start_desktop.sh

# 自定义提示词
npm run start:desktop -- "你好，帮我完成一个任务"

# 自定义配置
API_HOST=192.168.1.34 API_PORT=8086 USER_ID=my_user npm run start:desktop

测试地址

连接到内网 VNC 服务器

http://localhost:8080/vnc.html?host=192.168.1.34&port=8088&path=computer/vnc/user_123/666/websockify&encrypt=0&resize=scale&autoconnect=true

URL 参数说明

参数	说明	示例值
host	VNC WebSocket 服务器地址	192.168.1.34
port	WebSocket 端口	8088
path	WebSocket 路径	computer/vnc/user_123/666/websockify
encrypt	是否加密 (0=ws://, 1=wss://)	0
resize	缩放模式 (off, scale, remote)	scale
autoconnect	是否自动连接	true

完整 WebSocket 地址

上述配置对应的 WebSocket 连接地址为：

ws://192.168.1.34:8088/computer/vnc/user_123/666/websockify

配置默认值

可以通过修改 defaults.json 来设置默认连接参数：

{
  "host": "192.168.1.34",
  "port": 8088,
  "path": "computer/vnc/user_123/666/websockify",
  "encrypt": false,
  "resize": "scale",
  "autoconnect": true
}

注意: URL 参数会覆盖 defaults.json 中的配置。