PocketKVM 使用文档

适用于 PocketKVM VGA / HDMI · Windows 客户端 v1.0.1 · 在线控制台

第一章 产品概述

PocketKVM 是艾途工匠推出的便携式 KVM-over-USB 解决方案：把硬件盒接在「操作机（宿主）」与「被控机（目标机）」之间，宿主即可看到目标机画面并注入键盘、鼠标——用一台笔记本电脑替代独立的键盘、鼠标、显示器。

核心特性

  • 零配置被控端： 目标设备无需安装任何软件或驱动、无需接入网络——它只会把 PocketKVM 识别为一台标准 USB 键盘/鼠标
  • 控制端选择： 当前桌面客户端支持 Windows 10 / 11（x64）；在线控制台支持 Chrome / Edge 浏览器免安装使用
  • BIOS 级访问： 在操作系统启动前即可控制目标设备，支持 BIOS/UEFI 设置、系统安装、救急恢复
  • 本地实时画面： 桌面客户端最高支持 1080p30 画面，视频参数以状态栏实际显示为准
  • 全程离线： 无账号、无云同步、无遥测，画面与数据不出本机

第二章 系统要求

2.1 控制端（您的电脑）

项目 要求
操作系统 桌面客户端：Windows 10 / 11（x64）；macOS 客户端尚未发布
浏览器（仅在线控制台） Google Chrome 或 Microsoft Edge 最新两个版本
USB 接口 至少一个可用的 USB-A 或 USB Type-C 接口
网络 无需互联网连接

2.2 被控端（目标设备）

  • 无需任何配置，无需安装驱动，无需接入网络
  • 仅需具备 HDMI 视频输出接口（VGA 版请用 VGA 输出）与一个 USB 接口

第三章 硬件连接

3.1 产品端口

PocketKVM VGA 版与 HDMI 版端口对比图
PocketKVM VGA 版与 HDMI 版端口对比
  • VGA IN / HDMI IN： 连接目标设备的视频输出端口
  • K/M OUT： 连接目标设备的 USB 端口（传输键盘鼠标信号）
  • Type-C： 连接控制端电脑（双向传输视频流与控制信号）

3.2 连接步骤

PocketKVM HDMI 硬件连接步骤

PocketKVM HDMI 版连接关系与信号方向示意图
视频接入 HDMI IN，键鼠连接 K/M OUT，Type-C 双向连接控制端电脑。
  1. 视频连接： 使用 HDMI 线缆将目标设备的 HDMI 输出端口连接至 PocketKVM 的 HDMI IN 端口。
  2. 键鼠连接： 使用附带的 USB-A to USB-C 短数据线将目标设备的 USB 端口连接至 PocketKVM 的 K/M OUT 端口。
  3. 控制端连接： 使用附带的 USB-A to USB-C / USB-C to USB-C 长数据线将 PocketKVM 的 Type-C 端口连接至您的控制端电脑。

PocketKVM VGA 硬件连接步骤

PocketKVM VGA 版连接关系与信号方向示意图
视频接入 VGA IN，键鼠连接 K/M OUT，Type-C 双向连接控制端电脑。
  1. 视频连接： 使用 VGA 线缆将目标设备的 VGA 输出端口连接至 PocketKVM 的 VGA IN 端口。
  2. 键鼠连接： 使用附带的 USB-A to USB-C 短数据线将目标设备的 USB 端口连接至 PocketKVM 的 K/M OUT 端口。
  3. 控制端连接： 使用附带的 USB-A to USB-C / USB-C to USB-C 长数据线将 PocketKVM 的 Type-C 端口连接至您的控制端电脑。

提示

若遇到设备反复断开，请优先更换质量更好的数据线并直连（避免延长线和无供电 Hub）。

第四章 软件安装

PocketKVM 提供两种控制方式：Windows 桌面客户端（功能完整）与在线控制台（免安装）。当前可用安装包可从首页客户端区域直接下载。

4.1 Windows 桌面客户端

  1. 下载 PocketKVM-Setup-1.0.1-x64.exe（Windows 10 / 11 x64 安装版，约 124.2 MB）
  2. 内测期说明： 安装包未做代码签名，首次运行 SmartScreen 可能提示「Windows 已保护你的电脑」。请先核对下方 SHA-256，再选择「更多信息 → 仍要运行」
  3. 按安装向导选择目录完成安装，首次启动后跟随接线、驱动和权限检测向导完成设置
  4. 配置文件位于 %APPDATA%\PocketKVM，卸载或重置时可按需备份后删除该目录

PocketKVM-Setup-1.0.1-x64.exe

SHA-256：

ce8d426832c1302acbe63a959a7e7a0435ef851ef75d5a900c69d844c21c8557

4.2 macOS 桌面客户端（尚未发布）

当前没有可下载的 macOS 桌面客户端，也不提供未经发布的版本说明或下载链接。macOS 用户可先使用兼容的 Chrome / Edge 在线控制台。

4.3 在线控制台（免安装）

  1. 用 Chrome / Edge 浏览器打开 pocketkvm.atool.cloud 即可使用（仅支持 Chrome / Edge 浏览器）
  2. 首次使用键鼠功能时，浏览器会弹出串口授权框，选中 USB Serial（CH340） 确认即可；之后打开页面自动识别、自动连接

提示

在线控制台提供视频、基础键鼠、画质/视图/布局/鼠标模式等核心能力；截图、录屏、OCR、宏、诊断等进阶功能请使用桌面客户端。

4.4 串口驱动

键鼠控制功能依赖串口驱动。桌面客户端的首次使用向导已内置驱动「一键安装」，一般无需手动下载；以下安装包供手动安装或排查时使用：

  • Windows：CH341SER.EXE，安装完成后重新插拔 PocketKVM 的 Type-C 连接线，设备管理器「端口 (COM 和 LPT)」下应出现新的 USB-SERIAL 设备
  • macOS：CH34xVCPDriver.dmg，按向导完成安装后重新插拔设备

第五章 首次使用向导

桌面客户端首次启动自动进入 3 步卡片向导（每步可跳过，总时长不超过 3 分钟）：

PocketKVM 客户端首次使用向导
  1. 接线与驱动检测： 实时检测串口设备、采集卡与驱动。Windows 若缺串口驱动，点「一键安装」自动完成安装（需管理员授权）；30 秒未检测到设备时按界面分诊树排查（换 USB 口 → 检查线序 → 确认目标机已输出视频）。
  2. 权限授权： Windows 按向导完成设备检测与授权；如安装串口驱动，需按系统提示授予管理员权限。
  3. 键鼠自检： 在输入框打一句话、在下方区域点一下鼠标，验证键鼠能到达被控机；确认被控机屏幕上出现你输入的内容即完成。

完成后自动进入主控台。之后可随时在「关于与诊断」页点「重新运行上手向导」重进。

第六章 主控台操作

PocketKVM 客户端工具栏与功能菜单

6.1 鼠标捕获与释放

  • 单击画面进入捕获：本机指针隐藏，键鼠全部转向被控机；首次捕获有教学浮层提示
  • 按 Esc 释放：捕获态第一次 Esc=释放鼠标（不退全屏），已释放时再按 Esc=退出全屏

6.2 状态栏

左起依次为：键鼠链路（连接中/已连接/已断开/重连中）、视频链路（视频 1080p30 等实际参数）、捕获态、鼠标模式；右侧为设置、关于与诊断入口及版本号。

6.3 画质与视图

  • 画质分段（工具条右侧）：720p / 1080p 两档手动锁定；带宽不足自动降档并显示「自动」角标
  • 视图档：右键菜单切换「适应窗口 / 100% 原始尺寸」——后者 1:1 像素显示文字最锐利，可拖拽平移，捕获时视口自动跟随指针

6.4 鼠标模式

模式 说明 适用场景
绝对模式（默认） 点哪到哪，鼠标直接映射到屏幕绝对坐标 BIOS/UEFI 界面、日常桌面操作
相对模式 指针锁定连续移动，基于相对位移 游戏 / 3D / 嵌套远程桌面

坐标不准时：右键菜单 →「校准鼠标坐标…」按 9 个点校准一次即可（工具条「鼠标」下拉同入口）。

6.5 虚拟按键

工具条「虚拟按键」：被本机系统拦截的组合键（Ctrl + Alt + Del、Win + R / L / E / D）、F1–F12、Del、方向键一键下发；底部「逐键输入框」可输入任意 ASCII 文本发送到被控机。

6.6 文本粘贴（Ctrl+Shift+V）

复制文本后在捕获态按 Ctrl + Shift + V（或工具条/右键菜单），确认后逐键重放到被控机；支持中止。仅保证 ASCII；中文经被控端输入法重放（Windows 微软拼音/搜狗已验证支持，需被控端中文输入法在线）。

6.7 截图与录屏取证

  • 截图（Ctrl + Shift + S）：当前画面存为 PNG，文件名含时间戳，保存目录可在设置中修改
  • 录屏：工具条/右键菜单开始录制，状态栏显示红点呼吸+时长+[停止]；H.264/MP4 内嵌时间戳水印；磁盘剩余 <10% 预警，不足自动停录并保全已录文件；支持「证据包」导出（录屏+日志+系统信息打包 zip）

6.8 OCR 提取文字

设置→工具开启 OCR 后，右键菜单「OCR 提取文字」：

  • 拖动框选要识别的区域（推荐，更准更快），或双击/回车=整帧识别
  • 本地模型离线识别中英文（画面不出本机），结果按行展示、一键复制全文，用于抄录报错码
  • 关闭开关后识别引擎立即释放，不占内存

6.9 宏录制与回放

右键菜单「宏…」→ 开始录制 → 在捕获态进行键鼠操作 → 停止并命名保存；列表中可回放、循环 N 次（回放中可随时按 Esc 中止）。

6.10 防锁屏微动（jiggler）

设置→工具或右键菜单开启后，按周期（默认 60 秒，30–300 可调）向被控机发送视觉不可见的微动，防止自动锁屏；状态栏常驻「防锁屏中」标识；捕获态有真实输入的周期自动顺延不打扰操作。

政企受控环境请注意

本设备在被控机上仅模拟标准 USB 键盘/鼠标，不安装软件、不读写磁盘、不联网，可被常规 USB 外设审计策略识别与管控。在受管办公环境使用前请获得贵司 IT 部门许可。

6.11 快捷键自定义

设置→快捷键中可改绑：双击全屏、F11 全屏、截图、粘贴四项；改绑即时生效，冲突（如 Esc、已被占用的组合）会被阻止并提示占用方；可随时「恢复默认」。

第七章 设置与诊断

PocketKVM 客户端设置页
  • 设置（状态栏齿轮图标）：常规（主题/截图与录屏目录）、视频（默认画质）、键鼠（布局/默认鼠标模式）、快捷键、工具（OCR/防锁屏微动）、隐私（诊断导出/合规说明），改动即时生效
  • 关于与诊断（状态栏信息图标）：版本信息、检查更新、固件说明、FAQ、诊断包导出（应用日志+设备快照+系统信息 zip）、重新运行上手向导

第八章 常见问题

Q：黑屏/没有画面？

依次检查——目标机是否已输出视频（接显示器验证）→ HDMI 线缆 → 更换 USB 数据线并直连 → 状态栏视频链路是否显示已连接。目标机关机、休眠、BIOS 黑屏属正常显示内容，等待其恢复输出即可。

Q：为什么没有画面但状态显示已连接？

采集卡在线≠目标机有输出。请确认目标机已开机且显卡在工作（部分无头服务器需插显示器或负载模拟器）。

Q：键盘输入错乱/大小写不对？

设置→键鼠中检查键盘布局（默认跟随被控端；被控机为英文 UK 布局时请手选 en-GB）；中文输入请确认被控端处于中文输入法状态。

Q：鼠标指针位置偏移？

右键菜单→「校准鼠标坐标…」完成九点校准；游戏/3D 场景建议切相对模式。

Q：支持 ISO 挂载/文件传输吗？

不支持。替代方案：在被控机旁的电脑上运行本软件，用系统自带共享或远程桌面软件传输文件。

Q：支持串口 console 吗？

不支持。设备的 USB 通道仅用于键鼠模拟，被控机侧没有串口物理通路。

Q：支持异地远程吗？

不支持。设备无网口，画面只在本地。替代方案：在被控机旁的电脑上运行本软件，再用任意远程桌面软件连到该电脑。

Q：会被杀毒软件拦截吗？

内测版未做代码签名，Windows 可能提示 SmartScreen 拦截（点「仍要运行」）；软件全程零外联、无账号、无遥测，可抓包验证。

Q：VGA 版与 HDMI 版有什么区别？

核心功能完全一致，仅视频输入接口不同。VGA 版适合服务器、工控机等带有 VGA 输出接口的设备；HDMI 版适合树莓派、开发板、台式机等带有 HDMI 输出接口的现代设备。

第九章 故障排查速查表

现象 优先排查
提示「未检测到设备」 USB 线序（两端是否插反）、更换数据线、直连不用 Hub
向导卡在驱动检测 Windows：点「一键安装」装串口驱动后重新插拔；macOS：系统设置→隐私与安全性→摄像头 中允许
频繁掉线重连 更换优质短数据线、直连电脑后置 USB 口、检查供电
画面模糊 视图切到「100% 原始尺寸」；确认未被自动降档（工具条 720p 档有无「自动」角标）
录屏无法开始 确认视频已出流；检查录屏目录磁盘剩余空间（<10% 会预警）
OCR 结果乱 框选更小的文字区域重试；确认画面未被缩放失真（用 100% 档框选）