Wi-Fi：连接电脑。Wi-Fi: connect to your computer.

安装与你的电脑匹配的桌面端

Install the desktop client for your computer

本页手机操作专用于 Android。Wi-Fi 需要电脑运行手机扫码枪 PC 端；先下载匹配系统和 CPU 架构的官方发布包，并保留包内文件。

The phone instructions here are for Android. Wi-Fi output requires Scan Input Desktop running on the computer. Download the official package for your operating system and CPU architecture and keep its bundled files.

macOS：打开 DMG 并拖入应用程序

macOS: open the DMG and copy the app

1. 在“关于本机”确认 Apple 芯片还是 Intel，选对应 DMG。macOS 桌面端要求 macOS 13 及以上。 Check About This Mac for Apple silicon or Intel and choose its DMG. The macOS desktop client requires macOS 13 or later.
2. 打开 DMG，将 Scan Input Desktop.app 拖入“Applications / 应用程序”，再从应用程序文件夹启动。 Open the DMG, drag Scan Input Desktop.app into Applications, and launch it from there.
3. 若系统阻止打开，核对官方来源和应用名称后按“隐私与安全性”的系统提示处理。自动输入权限在下方设置。 If opening is blocked, confirm the official source and app name, then follow the system Privacy & Security prompt. Configure typing permission below.

Windows：解压整个 ZIP，再运行 EXE

Windows: extract the full ZIP before running the EXE

1. 将 ScanInput-windows-x64.zip 解压到固定文件夹，保留所有 DLL、插件、数据库驱动和 legal 等随包目录。 Extract ScanInput-windows-x64.zip to a stable folder. Keep all bundled DLLs, plugins, database drivers, and legal files.
2. 启动解压目录中的 DroidCodeScannerPC.exe，不要直接在 ZIP 预览中运行或单独移动一个 EXE。 Launch DroidCodeScannerPC.exe in that folder. Do not run it from the ZIP preview or move only the EXE elsewhere.
3. 启动失败时可运行包内 diagnose_release.bat（若有），将错误信息交给技术支持。 For a launch failure, use diagnose_release.bat if included and report its error to support.

Linux：启动 AppDir 或 AppImage

Linux: launch AppDir or AppImage

1. 解压 ScanInput-linux-x86_64.tar.gz，先阅读包内 RUN_GUIDE.txt（若有）。 Extract ScanInput-linux-x86_64.tar.gz and read RUN_GUIDE.txt if included.
2. AppDir 包进入 DroidCodeScannerPC.AppDir/usr/bin，运行 ./DroidCodeScannerPC。保留整个 AppDir；缺少运行库时依据错误和发行版包管理器处理。 For AppDir, open DroidCodeScannerPC.AppDir/usr/bin and run ./DroidCodeScannerPC. Keep the full AppDir and resolve missing runtime libraries using the error and your distribution’s package manager.
3. 若包内提供 AppImage，先在文件属性中允许执行，再启动它。Linux 自动输入另需 ydotool 或适用 X11 的 xdotool，详见下方。 If an AppImage is provided, allow execution in file properties and launch it. Linux typing also needs ydotool or xdotool for X11, as explained below.

启动服务并确认 IP / 端口

Start the service and check IP / port

1. 确认“服务运行中（端口 …）”及“等待客户端连接…”。显示“服务已停止”时点“开启服务”。 Check for Running (port …) and Waiting for client connection…. If stopped, click Start service.
2. 端口被占用时选择 1～65535 内另一个可用端口，点“应用端口”。运行中改端口会重启服务，需让手机按新端口/二维码重新连接。 For a busy port, choose another available port from 1–65535 and click Apply port. Changing a running service’s port restarts it; reconnect the phone using the new port or QR code.
3. 点“刷新 IP”更新地址。未找到 IP 或服务未监听时不生成连接二维码。 Click Refresh IP for the current address. A QR code is not generated without a usable IP and running listener.
4. 电脑防火墙询问传入连接时，允许桌面端在你使用的本地网络接收连接；所选 TCP 端口须允许手机访问。 If the firewall prompts for incoming access, allow the desktop client on your local network and make its selected TCP port reachable from the phone.

确保手机能访问电脑局域网地址

Make the computer’s local address reachable

• 手机与电脑位于可互通的本地网络；电脑接路由器网线、手机接同一路由器 Wi-Fi 也可以，不必都无线。 Use a reachable local network. The computer can be wired to the router while the phone uses its Wi-Fi; both need not be wireless.
• 2.4 GHz / 5 GHz 通常可互通，但访客网络、AP 隔离或企业网络规则可能阻止设备互访。 A router’s 2.4 GHz and 5 GHz networks commonly communicate, but guest networks, AP isolation, or enterprise rules can block access.
• 用电脑实际局域网 IPv4，不要填写手机 IP、127.0.0.1、公网或示例地址。换网络或地址变化后重新刷新。 Use the computer’s actual local IPv4, not the phone’s IP, 127.0.0.1, a public IP, or an example. Refresh after network/address changes.
• VPN 和多网卡可能影响二维码地址。如果地址不是手机可达的网段，用手动连接填写电脑实际可达地址。 VPNs and multiple adapters can affect the QR address. If it is unreachable from the phone, enter the computer’s reachable address manually.

结果通过本地 TCP 发送，不需要手机扫码枪账号。相机画面在手机识别；电脑收到扫码文本。

Results are sent through local TCP without a Scan Input account. Recognition occurs on the phone; the computer receives the scan text.

方式一：扫描电脑连接二维码

Option 1: scan the computer’s connection QR code

接受和拒绝都不保存有效连接二维码到历史。确认后可退出扫码，回“历史”核对连接图标；再按下方步骤检查实际录入。

A valid connection QR is not saved to history whether accepted or declined. Return to History to check the link state, then verify actual output below.

方式二：手动填 IP 地址与端口

Option 2: enter the IP address and port manually

1. 在“历史”或“设置”点右上角连接图标；已有连接先“断开”，再打开连接入口。 Tap the top-right connection icon on History or Settings. Disconnect an existing connection before reopening the entry.
2. Android 9+ 选择菜单“Wi-Fi 连接”；Android 6～8 直接出现 Wi-Fi 弹窗。 On Android 9 or later choose Wi-Fi connection; Android 6–8 opens its dialog directly.
3. “IP 地址”填目标电脑可达的局域网 IPv4，“端口”填电脑正在监听的端口，默认 9876。 Enter the target’s reachable local IPv4 in IP address and its current listening Port, default 9876.
4. 点“连接”，弹窗随请求关闭。右上角转圈时等待；“连接成功”后图标变为闭合链环。 Tap Connect. The dialog closes after the request. Wait for the top-right progress indicator; a successful connection shows a closed link.

按电脑系统配置自动输入

Configure typing for the computer’s system

macOS：允许辅助功能访问

macOS: allow Accessibility access

桌面端通过系统键盘事件输入。权限提示出现时到“系统设置 → 隐私与安全性 → 辅助功能”，允许正在运行的 Scan Input Desktop / 手机扫码枪 PC 端；必要时退出再启动。再在普通文本编辑器中点光标并测试。

The client types through system keyboard events. If prompted, open System Settings → Privacy & Security → Accessibility and allow the running Scan Input Desktop app. Restart if needed, then focus and test a plain text editor.

Windows：可编辑焦点与程序权限层级

Windows: editable focus and process privileges

Windows 端模拟 Unicode 键盘输入，不需要额外打字工具。先点击普通文本编辑器或表格单元格。如果目标以管理员权限运行、桌面端为普通权限，系统可能阻止注入；优先让目标以普通权限运行并测试。依据 Microsoft SendInput 文档。

Windows sends Unicode keyboard events without an extra typing tool. Click a plain text editor or spreadsheet cell first. A normally running client may be blocked from typing into an administrator-level target; test the target without elevation first. See Microsoft’s SendInput documentation.

Linux：输入工具与桌面会话条件

Linux: typing tools and desktop session requirements

1. 优先调用 ydotool type：ydotool 必须在桌面端进程 PATH 中可找到，并能访问可用 ydotoold 服务和 socket；只安装命令未必能输入。 The client tries ydotool type first. It must be on the desktop process’s PATH and able to reach a working ydotoold service/socket. Installing the command alone may not enable typing.
2. ydotoold 需访问 /dev/uinput，按发行版与 ydotool 官方说明配置服务和权限。完成后用普通编辑器测试短英文/数字内容。 ydotoold needs /dev/uinput access. Configure its service/permissions using your distribution and the ydotool documentation, then test short English/numeric content in a plain editor.
3. 仅 ydotool 无法启动时才尝试 xdotool type --clearmodifiers。xdotool 适用 X11，不适用于普通 Wayland 应用；Wayland 使用配置好的 ydotool。参见 xdotool 官方说明。 Only if ydotool cannot start does the client try xdotool type --clearmodifiers. xdotool suits X11, not ordinary Wayland applications; use a configured ydotool setup for Wayland. See the xdotool documentation.
4. ydotool 已启动但返回错误时，当前版本不会自动回退 xdotool，需检查服务、socket 和权限。 If ydotool starts but returns an error, this version does not fall back to xdotool automatically. Check the service, socket, and permissions.

完成一次实际录入检查

Check one known scan end to end

1. 核对手机最新结果/历史与预期原文；提示音或震动只证明手机处理了识别结果。 Compare the latest phone result/history with the expected raw content. A beep or vibration only confirms recognition handling.
2. 查看电脑“连接服务”日志和“扫码记录”，确认收到了该条；再检查目标输入框是否得到相同文字。 Check the desktop connection log and Scan history for receipt, then inspect the target field for the same text.
3. 检查回车/Tab 后光标行为；扫完移开同一码，避免持续对准导致再录入。 Check the cursor behavior after Enter/Tab. Move away from the same code after reading it to avoid another entry.

电脑有记录但输入框空时检查焦点和上方系统输入条件；仅手机有记录时检查网络。手机发送失败仍保存记录。Android 无历史“重发”按钮，可恢复连接后重新扫描，或复制并自行粘贴。

If the desktop has the item but the target is empty, check focus and platform typing setup. If only the phone has it, inspect the network. Failed sending still retains phone history. Android has no history Resend button; reconnect and scan again, or copy/paste manually.

相机多码冻结后点选一个；相册识别处理所选单张图片的全部解码结果。更多历史与导出操作见 Android 全流程教程。

Multiple live codes freeze for choosing one. Scan from gallery processes every decoded result from the chosen single image. See the Android walkthrough for history and export.

断开、更换网络与自动恢复

Disconnect, change networks, and restore

上次成功 IP / 端口会保存并回填。“自动恢复上次连接”默认开启，App 回到前台且未连接、未手动断开、无连接进行时可尝试恢复；不保证后台持续重连。

The last successful IP/port is saved and prefilled. Automatic restoration is enabled by default and can retry when the app returns to the foreground while disconnected, not manually disconnected, and without an ongoing attempt. It does not guarantee continual background reconnection.

1. 停止输出：在历史/设置页点闭合链环 → “断开”。仅退出扫码不会断开电脑。 Stop output with the link icon → Disconnect on History/Settings. Exiting the scanner alone does not disconnect.
2. 换目标：扫码新电脑连接二维码并确认，或先断开再手动填新 IP / 端口。 Switch targets by scanning the new computer’s connection QR and confirming, or disconnect and enter its IP/port manually.
3. 换网络/端口：电脑刷新 IP、检查服务运行，手机用新二维码/地址重连。旧缓存不代表当前可达。 After a network/port change, refresh the desktop IP and service state, then reconnect with the new code/address. A saved address may no longer be reachable.

故障排查：区分识别、网络与输入

Troubleshoot recognition, network, and typing

二维码为空或服务启动失败

Empty QR code or service start failure

确认电脑联网，点“刷新 IP”“开启服务”。端口启动失败时换可用端口并应用，同步修改手机输入值。只有服务监听且有可用 IP 才显示二维码。

Check the network and click Refresh IP/Start service. For a port start failure, apply an available port and update the phone. A QR code requires an active listener and usable IP.

手机连接失败或持续等待

Phone connection failure or prolonged waiting

依次检查电脑端运行、监听端口一致、电脑局域网 IP 正确、网络可互访、防火墙允许传入 TCP；排除访客隔离与 VPN 路由影响。多网卡可用手动连接填实际可达地址。

Check that the client runs, ports match, the local IP is correct, devices can communicate, and incoming TCP is allowed. Check guest isolation and VPN routing. For multiple adapters, manually enter a reachable address.

手机有结果，电脑没有新增记录

Phone result but no new desktop item

核对手机“Wi-Fi 已连接”及目标 IP，确认扫描的是普通码而不是连接码。恢复后移开镜头再扫描已知条码；手机识别成功不表示电脑收到。

Check Wi-Fi connected and its target IP, and confirm the scanned item is ordinary content rather than a connection code. Reconnect, move away, and rescan a known code. Recognition does not prove desktop receipt.

电脑记录已有，目标输入框为空

Desktop record but an empty target field

点击普通可编辑字段，避免焦点在电脑端按钮或只读区域。Mac 查辅助功能，Windows 查权限层级，Linux 查 ydotoold / xdotool 条件。当前没有“开启自动输入”开关，收到普通扫码结果就会尝试打字。

Focus a normal editable field rather than a client button or read-only area. Check Accessibility on Mac, privilege levels on Windows, and typing tools on Linux. There is no Enable automatic typing switch; each received ordinary result triggers a typing attempt.

重复录入、后缀或分隔符不符合预期

Repeated entries or unexpected suffixes/separators

扫码后移开镜头，按目标软件选“无/回车/Tab”。手机历史保存原文，发送时加后缀并把不可输入控制分隔符转为空格。正式录入前用已知内容核对。

Move the camera away and choose None/Enter/Tab for the target app. Phone history retains raw text; output adds the suffix and replaces untypable control separators with spaces. Check known content before actual use.

安装与你的电脑匹配的桌面端Install the desktop client for your computer

Wi-Fi 需要电脑运行手机扫码枪 PC 端；先下载匹配系统和 CPU 架构的官方发布包，并保留包内文件。

Wi-Fi output requires Scan Input Desktop running on the computer. Download the official package for your operating system and CPU architecture and keep its bundled files.

macOS：打开 DMG 并拖入应用程序

macOS: open the DMG and copy the app

1. 在“关于本机”确认 Apple 芯片还是 Intel，选对应 DMG。macOS 桌面端要求 macOS 13 及以上。 Check About This Mac for Apple silicon or Intel and choose its DMG. The macOS desktop client requires macOS 13 or later.
2. 打开 DMG，将 Scan Input Desktop.app 拖入“Applications / 应用程序”，再从应用程序文件夹启动。 Open the DMG, drag Scan Input Desktop.app into Applications, and launch it from there.
3. 若系统阻止打开，核对官方来源和应用名称后按“隐私与安全性”的系统提示处理。自动输入权限在下方设置。 If opening is blocked, confirm the official source and app name, then follow the system Privacy & Security prompt. Configure typing permission below.

Windows：解压整个 ZIP，再运行 EXE

Windows: extract the full ZIP before running the EXE

1. 将 ScanInput-windows-x64.zip 解压到固定文件夹，保留所有 DLL、插件、数据库驱动和 legal 等随包目录。 Extract ScanInput-windows-x64.zip to a stable folder. Keep all bundled DLLs, plugins, database drivers, and legal files.
2. 启动解压目录中的 DroidCodeScannerPC.exe，不要直接在 ZIP 预览中运行或单独移动一个 EXE。 Launch DroidCodeScannerPC.exe in that folder. Do not run it from the ZIP preview or move only the EXE elsewhere.
3. 启动失败时可运行包内 diagnose_release.bat（若有），将错误信息交给技术支持。 For a launch failure, use diagnose_release.bat if included and report its error to support.

Linux：启动 AppDir 或 AppImage

Linux: launch AppDir or AppImage

1. 解压 ScanInput-linux-x86_64.tar.gz，先阅读包内 RUN_GUIDE.txt（若有）。 Extract ScanInput-linux-x86_64.tar.gz and read RUN_GUIDE.txt if included.
2. AppDir 包进入 DroidCodeScannerPC.AppDir/usr/bin，运行 ./DroidCodeScannerPC。保留整个 AppDir；缺少运行库时依据错误和发行版包管理器处理。 For AppDir, open DroidCodeScannerPC.AppDir/usr/bin and run ./DroidCodeScannerPC. Keep the full AppDir and resolve missing runtime libraries using the error and your distribution’s package manager.
3. 若包内提供 AppImage，先在文件属性中允许执行，再启动它。Linux 自动输入另需 ydotool 或适用 X11 的 xdotool，详见下方。 If an AppImage is provided, allow execution in file properties and launch it. Linux typing also needs ydotool or xdotool for X11, as explained below.

启动服务并确认 IP / 端口Start the service and check IP / port

1. 确认“服务运行中（端口 …）”及“等待客户端连接…”。显示“服务已停止”时点“开启服务”。 Check for Running (port …) and Waiting for client connection…. If stopped, click Start service.
2. 端口被占用时选择 1～65535 内另一个可用端口，点“应用端口”。运行中改端口会重启服务，需让手机按新端口/二维码重新连接。 For a busy port, choose another available port from 1–65535 and click Apply port. Changing a running service’s port restarts it; reconnect the phone using the new port or QR code.
3. 点“刷新 IP”更新地址。未找到 IP 或服务未监听时不生成连接二维码。 Click Refresh IP for the current address. A QR code is not generated without a usable IP and running listener.
4. 电脑防火墙询问传入连接时，允许桌面端在你使用的本地网络接收连接；所选 TCP 端口须允许手机访问。 If the firewall prompts for incoming access, allow the desktop client on your local network and make its selected TCP port reachable from the phone.

确保手机能访问电脑局域网地址Make the computer’s local address reachable

• 手机与电脑位于可互通的本地网络；电脑接路由器网线、手机接同一路由器 Wi-Fi 也可以，不必都无线。 Use a reachable local network. The computer can be wired to the router while the phone uses its Wi-Fi; both need not be wireless.
• 2.4 GHz / 5 GHz 通常可互通，但访客网络、AP 隔离或企业网络规则可能阻止设备互访。 A router’s 2.4 GHz and 5 GHz networks commonly communicate, but guest networks, AP isolation, or enterprise rules can block access.
• 用电脑实际局域网 IPv4，不要填写手机 IP、127.0.0.1、公网或示例地址。换网络或地址变化后重新刷新。 Use the computer’s actual local IPv4, not the phone’s IP, 127.0.0.1, a public IP, or an example. Refresh after network/address changes.
• VPN 和多网卡可能影响二维码地址。如果地址不是手机可达的网段，用手动连接填写电脑实际可达地址。 VPNs and multiple adapters can affect the QR address. If it is unreachable from the phone, enter the computer’s reachable address manually.

结果通过本地 TCP 发送，不需要手机扫码枪账号。相机画面在手机识别；电脑收到扫码文本。

Results are sent through local TCP without a Scan Input account. Recognition occurs on the phone; the computer receives the scan text.

按电脑系统配置自动输入Configure typing for the computer’s system

macOS：允许辅助功能访问

macOS: allow Accessibility access

桌面端通过系统键盘事件输入。权限提示出现时到“系统设置 → 隐私与安全性 → 辅助功能”，允许正在运行的 Scan Input Desktop / 手机扫码枪 PC 端；必要时退出再启动。再在普通文本编辑器中点光标并测试。

The client types through system keyboard events. If prompted, open System Settings → Privacy & Security → Accessibility and allow the running Scan Input Desktop app. Restart if needed, then focus and test a plain text editor.

Windows：可编辑焦点与程序权限层级

Windows: editable focus and process privileges

Windows 端模拟 Unicode 键盘输入，不需要额外打字工具。先点击普通文本编辑器或表格单元格。如果目标以管理员权限运行、桌面端为普通权限，系统可能阻止注入；优先让目标以普通权限运行并测试。依据 Microsoft SendInput 文档。

Windows sends Unicode keyboard events without an extra typing tool. Click a plain text editor or spreadsheet cell first. A normally running client may be blocked from typing into an administrator-level target; test the target without elevation first. See Microsoft’s SendInput documentation.

Linux：输入工具与桌面会话条件

Linux: typing tools and desktop session requirements

1. 优先调用 ydotool type：ydotool 必须在桌面端进程 PATH 中可找到，并能访问可用 ydotoold 服务和 socket；只安装命令未必能输入。 The client tries ydotool type first. It must be on the desktop process’s PATH and able to reach a working ydotoold service/socket. Installing the command alone may not enable typing.
2. ydotoold 需访问 /dev/uinput，按发行版与 ydotool 官方说明配置服务和权限。完成后用普通编辑器测试短英文/数字内容。 ydotoold needs /dev/uinput access. Configure its service/permissions using your distribution and the ydotool documentation, then test short English/numeric content in a plain editor.
3. 仅 ydotool 无法启动时才尝试 xdotool type --clearmodifiers。xdotool 适用 X11，不适用于普通 Wayland 应用；Wayland 使用配置好的 ydotool。参见 xdotool 官方说明。 Only if ydotool cannot start does the client try xdotool type --clearmodifiers. xdotool suits X11, not ordinary Wayland applications; use a configured ydotool setup for Wayland. See the xdotool documentation.
4. ydotool 已启动但返回错误时，当前版本不会自动回退 xdotool，需检查服务、socket 和权限。 If ydotool starts but returns an error, this version does not fall back to xdotool automatically. Check the service, socket, and permissions.

手动填写电脑地址，并允许本地网络Enter the desktop address and allow Local Network

1. 在“历史”点右上连接状态图标（未连接时为链环加号图标），打开“Wi-Fi 连接”。填电脑端当前 IP 地址、端口，不填写手机自身 IP，也不要把示例 IP 当成自己的地址。On History, tap the connection status icon—the link with a plus badge when disconnected—to open Wi-Fi connection. Enter the computer’s current IP and port, not the phone’s IP or an address copied from a screenshot.
2. 端口默认 9876；若电脑修改了监听端口，应输入电脑显示的实际值（1～65535）。点“连接”后键盘自动收起，等待连接结果；地址与端口始终采用左侧标题、右侧输入框的布局；未连接时输入框为黑字、浅色背景，可编辑。连接过程中输入框变为灰字、灰色背景并禁用，连接按钮也禁用，防止重复发起。The default port is 9876. If the desktop listen port differs, use the shown value (1–65535). Tap Connect to dismiss the keyboard automatically, then wait for the result. The address and port always use labels on the left and text fields on the right. When disconnected, the editable fields have black text and a light background. While connecting, the fields have gray text and gray backgrounds and are disabled, and Connect is disabled to prevent another attempt.
3. 首次系统提示时允许本地网络访问。成功后地址与端口输入框继续保持灰字、灰色背景且不可编辑，窗口显示已连接状态；下方只显示水平居中的“断开连接”按钮，右上“完成”关闭窗口并返回主界面。Allow Local Network on the first system prompt. On success, the address and port fields remain gray with gray backgrounds and cannot be edited. The connected status appears. Below the fields, only a horizontally centered Disconnect button appears; Done at the top right closes the sheet and returns to the main screen.

扫描电脑二维码后确认“扫码连接”Confirm the desktop connection QR

1. 电脑端服务运行后显示连接二维码，手机打开“扫码”并对准它。未连接提醒可先选“继续扫码”。With the desktop service running and its connection QR visible, open Scan and point the phone at it. Choose Continue scanning if the disconnected reminder appears.
2. 识别到连接码后弹出“扫码连接”，核对提示中的 IP、端口与当前电脑一致，点“连接”；不希望连接则点“不连接”。不会仅因识别到二维码就自动连接。A connection code opens the Scan to connect alert. Compare its IP/port with the intended desktop, then tap Connect, or Don’t connect to cancel. Recognition alone does not connect.
3. 等待连接状态成功，再去电脑目标输入框放好光标并扫描业务码。连接二维码本身不保存进历史、不作为普通内容发送，也不会自动关闭扫码页。Wait for successful status, then focus the computer target and scan a business code. The connection QR is not saved in History or sent as ordinary content and does not automatically close the scanner.

电脑地址改变后重新扫描当前二维码或手填新地址。多网卡电脑应选手机能访问的局域网地址，不能用 127.0.0.1 作为手机连接电脑的目标。After an address change, scan the current QR or enter the new address. On computers with several adapters, choose the LAN address reachable by the phone; 127.0.0.1 is not the computer address from the phone.

验证发送、实际录入与后缀Check sending, target input and suffix

1. 电脑打开普通文本编辑器并点输入区域，确保光标位于要录入的位置；表格先选择可编辑单元格。Open a plain text editor on the computer and focus its input area. In a spreadsheet, select an editable cell.
2. 手机“设置 → 扫码后缀”选择“无”“回车”或“Tab”，再识别一个内容已知的码。默认回车；具体换行、提交或焦点移动由目标软件决定。Choose None, Enter or Tab under Settings → Scan suffix, then recognize a known code. Enter is the default; the receiving software determines line breaks, submission and focus movement.
3. 核对手机“最新扫码结果”和历史，电脑端收到的内容，以及目标软件实际文字。手机保存成功不等于电脑输入完成，电脑收到记录也不代表自动输入成功。Check Latest scan result and phone History, desktop receipt, and the actual text in the target software. A saved phone record does not prove computer typing, and desktop receipt does not prove automatic insertion.

相机和相册多码都需要选一个结果；未选结果不发送。发送后缀不写入手机历史、复制或导出内容。Wi-Fi 可传输中文和混合文字，先用已知样例检查完整内容。Camera and gallery multi-code results both require one selection; unselected results are not sent. Sending suffixes do not alter History, copying or export. Wi-Fi carries Chinese and mixed text; test a known sample for completeness.

断开、自动恢复与前后台Disconnect, restore and foreground behavior

1. 已连接时可在“Wi-Fi 连接”窗口点居中的“断开连接”；断开后地址和端口恢复编辑，下方恢复“连接”按钮，可填写新目标再连接。主界面右上已连接链环也会直接断开，没有 Android 那样的断开确认弹窗。Once connected, tap the centered Disconnect button in the Wi-Fi sheet. The address and port become editable and Connect returns, so you can enter a new target. Tapping the connected link on the main screen also disconnects immediately without an Android-style confirmation alert.
2. “设置 → 自动恢复上次连接”默认开启。App 启动和回到前台时，会尝试最近成功的 Wi-Fi 地址；手动断开后再回前台也可能重连。需要保持断开时关闭这一项。Automatic restoration is enabled by default in Settings. At launch and on foreground return, the app retries its last successful Wi-Fi address. Returning after a manual disconnect can reconnect; disable restoration if you need to stay disconnected.
3. 锁屏、App 进入后台、电脑休眠或网络切换后，回 App 核对状态，必要时手动连接。自动恢复不保证后台持续在线或持续扫码。After locking, backgrounding, computer sleep or a network change, return to the app and check status, then connect manually if necessary. Restoration does not guarantee continuous background connection or scanning.

按连接失败或输入失败分别排查Troubleshoot connection and input separately

1. 连接失败：检查电脑服务运行、当前 IP 和端口、本地网络授权、双方可互通局域网及电脑防火墙。访客 Wi-Fi 隔离、VPN 和换网络会改变可达性。Connection fails: check the desktop service, current IP/port, Local Network permission, LAN reachability and desktop firewall. Guest isolation, VPNs and network changes affect access.
2. 未获得本地网络授权：到系统对应 App 设置允许，再回 App 重新连接。相机权限不会代替本地网络权限。Local Network denied: enable it in the app’s system settings, return and reconnect. Camera permission does not substitute for network access.
3. 电脑已收到记录但不输入：先用普通编辑器测试焦点，再按本页电脑系统条件检查 macOS 辅助功能、Windows 目标权限或 Linux 输入工具。Desktop receipt without typing: test focus in a plain editor, then inspect macOS Accessibility, Windows target privileges or Linux typing tools as described above.
4. 连接成功却没有业务记录：确认识别的是业务码而非连接二维码，多码已点选一个结果，手机没有发送失败提示。需要重试时重新扫一条已知内容。Connected without a business record: check that you scanned a business code rather than a connection QR, selected one multi-code result, and saw no send-failure message. Rescan known content when retrying.

安装与你的电脑匹配的桌面端Install the desktop client for your computer

Wi-Fi 需要电脑运行手机扫码枪 PC 端；先下载匹配系统和 CPU 架构的官方发布包，并保留包内文件。

Wi-Fi output requires Scan Input Desktop running on the computer. Download the official package for your operating system and CPU architecture and keep its bundled files.

macOS：打开 DMG 并拖入应用程序

macOS: open the DMG and copy the app

1. 在“关于本机”确认 Apple 芯片还是 Intel，选对应 DMG。macOS 桌面端要求 macOS 13 及以上。 Check About This Mac for Apple silicon or Intel and choose its DMG. The macOS desktop client requires macOS 13 or later.
2. 打开 DMG，将 Scan Input Desktop.app 拖入“Applications / 应用程序”，再从应用程序文件夹启动。 Open the DMG, drag Scan Input Desktop.app into Applications, and launch it from there.
3. 若系统阻止打开，核对官方来源和应用名称后按“隐私与安全性”的系统提示处理。自动输入权限在下方设置。 If opening is blocked, confirm the official source and app name, then follow the system Privacy & Security prompt. Configure typing permission below.

Windows：解压整个 ZIP，再运行 EXE

Windows: extract the full ZIP before running the EXE

1. 将 ScanInput-windows-x64.zip 解压到固定文件夹，保留所有 DLL、插件、数据库驱动和 legal 等随包目录。 Extract ScanInput-windows-x64.zip to a stable folder. Keep all bundled DLLs, plugins, database drivers, and legal files.
2. 启动解压目录中的 DroidCodeScannerPC.exe，不要直接在 ZIP 预览中运行或单独移动一个 EXE。 Launch DroidCodeScannerPC.exe in that folder. Do not run it from the ZIP preview or move only the EXE elsewhere.
3. 启动失败时可运行包内 diagnose_release.bat（若有），将错误信息交给技术支持。 For a launch failure, use diagnose_release.bat if included and report its error to support.

Linux：启动 AppDir 或 AppImage

Linux: launch AppDir or AppImage

1. 解压 ScanInput-linux-x86_64.tar.gz，先阅读包内 RUN_GUIDE.txt（若有）。 Extract ScanInput-linux-x86_64.tar.gz and read RUN_GUIDE.txt if included.
2. AppDir 包进入 DroidCodeScannerPC.AppDir/usr/bin，运行 ./DroidCodeScannerPC。保留整个 AppDir；缺少运行库时依据错误和发行版包管理器处理。 For AppDir, open DroidCodeScannerPC.AppDir/usr/bin and run ./DroidCodeScannerPC. Keep the full AppDir and resolve missing runtime libraries using the error and your distribution’s package manager.
3. 若包内提供 AppImage，先在文件属性中允许执行，再启动它。Linux 自动输入另需 ydotool 或适用 X11 的 xdotool，详见下方。 If an AppImage is provided, allow execution in file properties and launch it. Linux typing also needs ydotool or xdotool for X11, as explained below.

启动服务并确认 IP / 端口Start the service and check IP / port

1. 确认“服务运行中（端口 …）”及“等待客户端连接…”。显示“服务已停止”时点“开启服务”。 Check for Running (port …) and Waiting for client connection…. If stopped, click Start service.
2. 端口被占用时选择 1～65535 内另一个可用端口，点“应用端口”。运行中改端口会重启服务，需让手机按新端口/二维码重新连接。 For a busy port, choose another available port from 1–65535 and click Apply port. Changing a running service’s port restarts it; reconnect the phone using the new port or QR code.
3. 点“刷新 IP”更新地址。未找到 IP 或服务未监听时不生成连接二维码。 Click Refresh IP for the current address. A QR code is not generated without a usable IP and running listener.
4. 电脑防火墙询问传入连接时，允许桌面端在你使用的本地网络接收连接；所选 TCP 端口须允许手机访问。 If the firewall prompts for incoming access, allow the desktop client on your local network and make its selected TCP port reachable from the phone.

确保手机能访问电脑局域网地址Make the computer’s local address reachable

• 手机与电脑位于可互通的本地网络；电脑接路由器网线、手机接同一路由器 Wi-Fi 也可以，不必都无线。 Use a reachable local network. The computer can be wired to the router while the phone uses its Wi-Fi; both need not be wireless.
• 2.4 GHz / 5 GHz 通常可互通，但访客网络、AP 隔离或企业网络规则可能阻止设备互访。 A router’s 2.4 GHz and 5 GHz networks commonly communicate, but guest networks, AP isolation, or enterprise rules can block access.
• 用电脑实际局域网 IPv4，不要填写手机 IP、127.0.0.1、公网或示例地址。换网络或地址变化后重新刷新。 Use the computer’s actual local IPv4, not the phone’s IP, 127.0.0.1, a public IP, or an example. Refresh after network/address changes.
• VPN 和多网卡可能影响二维码地址。如果地址不是手机可达的网段，用手动连接填写电脑实际可达地址。 VPNs and multiple adapters can affect the QR address. If it is unreachable from the phone, enter the computer’s reachable address manually.

结果通过本地 TCP 发送，不需要手机扫码枪账号。相机画面在手机识别；电脑收到扫码文本。

Results are sent through local TCP without a Scan Input account. Recognition occurs on the phone; the computer receives the scan text.

按电脑系统配置自动输入Configure typing for the computer’s system

macOS：允许辅助功能访问

macOS: allow Accessibility access

桌面端通过系统键盘事件输入。权限提示出现时到“系统设置 → 隐私与安全性 → 辅助功能”，允许正在运行的 Scan Input Desktop / 手机扫码枪 PC 端；必要时退出再启动。再在普通文本编辑器中点光标并测试。

The client types through system keyboard events. If prompted, open System Settings → Privacy & Security → Accessibility and allow the running Scan Input Desktop app. Restart if needed, then focus and test a plain text editor.

Windows：可编辑焦点与程序权限层级

Windows: editable focus and process privileges

Windows 端模拟 Unicode 键盘输入，不需要额外打字工具。先点击普通文本编辑器或表格单元格。如果目标以管理员权限运行、桌面端为普通权限，系统可能阻止注入；优先让目标以普通权限运行并测试。依据 Microsoft SendInput 文档。

Windows sends Unicode keyboard events without an extra typing tool. Click a plain text editor or spreadsheet cell first. A normally running client may be blocked from typing into an administrator-level target; test the target without elevation first. See Microsoft’s SendInput documentation.

Linux：输入工具与桌面会话条件

Linux: typing tools and desktop session requirements

1. 优先调用 ydotool type：ydotool 必须在桌面端进程 PATH 中可找到，并能访问可用 ydotoold 服务和 socket；只安装命令未必能输入。 The client tries ydotool type first. It must be on the desktop process’s PATH and able to reach a working ydotoold service/socket. Installing the command alone may not enable typing.
2. ydotoold 需访问 /dev/uinput，按发行版与 ydotool 官方说明配置服务和权限。完成后用普通编辑器测试短英文/数字内容。 ydotoold needs /dev/uinput access. Configure its service/permissions using your distribution and the ydotool documentation, then test short English/numeric content in a plain editor.
3. 仅 ydotool 无法启动时才尝试 xdotool type --clearmodifiers。xdotool 适用 X11，不适用于普通 Wayland 应用；Wayland 使用配置好的 ydotool。参见 xdotool 官方说明。 Only if ydotool cannot start does the client try xdotool type --clearmodifiers. xdotool suits X11, not ordinary Wayland applications; use a configured ydotool setup for Wayland. See the xdotool documentation.
4. ydotool 已启动但返回错误时，当前版本不会自动回退 xdotool，需检查服务、socket 和权限。 If ydotool starts but returns an error, this version does not fall back to xdotool automatically. Check the service, socket, and permissions.

鸿蒙手机连接：二维码确认与手动地址HarmonyOS phone connection: QR confirmation and manual address

断开、恢复与前后台Disconnecting, restoration and foreground behavior

点主界面链环查看当前连接，选择“断开当前连接”停止；“取消”只关闭状态窗口，不会断开。更换电脑或扫描连接二维码前，先断开旧连接。自动恢复默认开启，当前只在 App 启动加载状态时尝试最近成功的目标，不保证每次切回前台自动连接。网络地址变化时刷新电脑 IP / 端口，重新连接。Tap the main-screen link to inspect the current connection and choose Disconnect current connection. Cancel closes the state window without disconnecting. Disconnect the old target before switching computers or scanning a connection QR. Restoration is enabled by default and currently retries a saved successful target when startup loads state, not on every foreground return. Refresh the desktop IP/port and reconnect after network changes.

检查收到记录和目标文字Verify receipt and actual target text

1. 在电脑编辑器、表格或业务系统点可编辑位置放好光标；手机设置后缀为无、回车或 Tab。Focus an editable position in the computer editor, spreadsheet or business system and choose None, Enter or Tab as the phone suffix.
2. 扫描一条已知业务码，分别核对手机识别与历史、电脑接收记录、目标位置实际文本及后缀。提示音不代表电脑完成输入。Scan known business content and independently verify phone recognition/History, desktop receipt and target text/suffix. A beep does not prove desktop entry.
3. 连接失败先检查服务、可达 IP、端口、网络隔离和防火墙；电脑收到但未输入，检查本页 macOS 辅助功能、Windows 目标权限或 Linux 输入工具。For connection failure check service, reachable IP, port, network isolation and firewall. For receipt without typing, check the macOS Accessibility, Windows target permissions or Linux tools described above.
4. 同图多码只发送选中一条；相册也需要从候选列表单选。含中文或混合文字优先 Wi-Fi，确保电脑收到完整内容。Only one selected multi-code result is sent; gallery results also require one list selection. Prefer Wi-Fi for Chinese or mixed text and verify complete receipt.