VoxLink

跨平台文本传输系统 — 用手机输入，电脑实时接收

简介

VoxLink 是一个轻量级的跨设备文本传输工具，让你在手机上输入文字，电脑上即时接收。

典型使用场景：

• 在手机上语音输入中文，发送到电脑终端

---

快速开始

1️⃣ 安装部署

详细的安装步骤请参考 部署文档

2️⃣ 启动电脑客户端

Windows 用户（推荐）：

cd voxlink\client
node .\dist\index.js
或者以daemon形式运行
node .\dist\index.js --start

linux：

./voxlink-linux
或者与windows一样
cd voxlink\client
npm install
npm run build:unix
node .\dist\index.js

客户端会在后台运行，接收服务器信息。

守护模式命令行参数：

参数	作用
--start	启动守护进程，在后台持续运行
--stop	停止正在运行的守护进程
--watch	监视模式

使用示例：

# 启动守护进程
node ./dist/index.js --start

# 停止守护进程
node ./dist/index.js --stop

# 开发模式（自动重启）
node ./dist/index.js --watch

3️⃣ 使用流程

┌─────────────┐                    ┌─────────────┐
│   手机      │                    │   电脑      │
│             │                    │             │
│  1. 打开    │                    │ 2. 客户端   │
│     Web     │◄──────────────────►│    已启动   │
│     页面    │     Cloudflare     │  (daemon)   │
│             │       Workers      │             │
│  4. 输入    │                    │ 3. 按下     │
│     文字    │──────────────────►│   快捷键激活    │
│             │                    │ 5. 鼠标位置 │
│             │                    │    接收     │
└─────────────┘                    └─────────────┘

---

使用说明

步骤一：启动电脑客户端

客户端会在后台以守护模式运行。

步骤二：手机登录 Web 界面

1. 用手机浏览器打开地址
2. 输入密码登录（密码与客户端配置一致）

步骤三：电脑激活输入

1. 将鼠标放在你想要输入的位置（终端、编辑器、浏览器等）
2. 按下快捷键 Ctrl+Alt+V 激活接收模式

步骤三：在手机上输入文字

在 Web 页面的文本框中输入你想要发送的内容。

文字会自动输入到电脑上激活的窗口

---

快捷键

快捷键	功能
Ctrl+Alt+V	激活接收模式，将手机输入的文字发送到当前光标位置
再按禁用

---

配置文件

Windows 配置文件位置

%APPDATA%\voxlink\config.json

手动创建步骤：

1. 打开文件资源管理器
2. 地址栏输入：%APPDATA%\voxlink
3. 如果目录不存在，先创建 voxlink 文件夹
4. 在该目录下创建 config.json

配置示例

{
  "server": {
    "url": "https://voxlink1.futuregadget.science",
    "password": "your_password_here"
  },
  "hotkey": {
    "trigger": "ctrl+alt+v"
  },
  "windowHotkeys": {
    "default": "Ctrl+Shift+V",
    "mappings": [
      { "windowClass": "gnome-terminal", "hotkey": "Ctrl+Shift+V" },
      { "windowClass": "konsole", "hotkey": "Ctrl+Shift+V" },
      { "windowClass": "alacritty", "hotkey": "Ctrl+Shift+V" },
      { "windowClass": "kitty", "hotkey": "Ctrl+Shift+V" },
      { "windowClass": "tilix", "hotkey": "Ctrl+Shift+V" },
      { "windowClass": "xfce4-terminal", "hotkey": "Ctrl+Shift+V" },
      { "windowClass": "chrome", "hotkey": "Ctrl+V" },
      { "windowClass": "firefox", "hotkey": "Ctrl+V" },
      { "windowClass": "vscode", "hotkey": "Ctrl+V" },
      { "windowClass": "code", "hotkey": "Ctrl+V" },
    ]
  }
}

---

项目结构

voxlink/
├── client/          # 客户端程序
│   ├── src/         # TypeScript 源码
│   ├── dist/        # 编译后的 JavaScript
│   └── package.json
├── worker/          # Cloudflare Workers 服务端
└── shared/          # 共享代码

故障排除

问题	解决方案
无法连接服务器	检查 config.json 中的 server.url 是否正确
认证失败	确认客户端密码与服务端密码一致
快捷键不生效	检查是否有其他程序占用相同快捷键
文字未正确输入	确保鼠标已放在目标窗口内，且窗口处于激活状态

---

许可证

MIT