使用说明 & 常见问题 — HandMath

使用说明

通用原理

电脑运行 PC 服务器脚本，启动后处于等待状态
平板通过浏览器或原生 APP 打开手写界面
在平板上书写公式，点击 "识别并发送"
AI 引擎识别笔迹转为 LaTeX 代码自动发送到电脑剪贴板
在 Overleaf / Obsidian / Word 中按 Ctrl + V 粘贴即可

Web 版（推荐）

下载 "Web版" 文件包
在 Windows 电脑上运行 NoScribleServer.exe（直接双击运行）
终端显示电脑局域网 IP，如 192.168.129.100
在 平板浏览器（推荐使用 夸克浏览器）打开 http://电脑IP:48158
在设置中输入 AI 模型的 API 地址和密钥，推荐使用豆包（火山引擎 ARK）大模型，性价比高、响应快

Android 原生 APP

下载 "Android 版" 文件包
在 Windows 电脑上运行 NoScribleServer.exe（TCP 端口 48159）
将 NoScribleApp.apk 安装到平板上
在 APP 设置中填写电脑 IP 和端口 48159
配合手写笔获得最佳书写体验
兼容说明：适用于安卓内核的平板电脑，以及 鸿蒙 4.0 系列及以下版本

常见问题

平板提示 "Failed to fetch" / 连接不上电脑

Windows 防火墙阻止了连接。以 管理员身份 打开 PowerShell，运行以下命令放行端口：

netsh advfirewall firewall add rule name="HandMath" dir=in action=allow protocol=TCP localport=48158

如果使用 APP（TCP 模式），把端口换成 48159：

netsh advfirewall firewall add rule name="HandMath-TCP" dir=in action=allow protocol=TCP localport=48159

PC 服务器 EXE 无法运行

请确保是 Windows 64 位系统。如果杀毒软件误报，请添加到白名单后运行。

AI 识别超时 / 返回空结果

检查 API 地址和密钥是否正确；国内网络访问境外 AI API 可能较慢，建议使用国内服务商的 API 地址。

平板和电脑需要连同一个 WiFi

是的，平板和电脑必须在 同一局域网 下才能通信。