Skip to content

veryinf/type-bridge

Repository files navigation

Type Bridge - 手机电脑输入同步工具

📱 手机扫码,电脑打字 - 让手机成为电脑的无线键盘

✨ 功能特点

  • 📝 文本同步 - 手机输入文字,直接发送到电脑当前窗口
  • 🔄 智能替换 - 支持正则表达式自动替换(如:输入"毫安时"自动变成"mAh")
  • 远程控制 - 发送回车、撤销、删除等操作
  • 🖱️ 光标移动 - 远程控制电脑光标方向
  • 🔤 符号包裹 - 快速输入括号、引号等符号配对
  • ⌨️ 组合键 - 支持发送 Ctrl+V 等组合键操作
  • 📋 快捷模板 - 数据库存储常用文本模板,一键发送
  • 🎛️ 控制台配置 - JSON 驱动的按钮布局,可自定义按钮、分组和命令序列
  • 📊 操作日志 - 桌面端和手机端实时查看
  • 🖥️ 系统托盘 - 最小化后在后台运行
  • 🎨 主题切换 - 桌面端支持浅色/深色主题
  • 📡 多网卡支持 - 自动检测局域网 IP,支持多网卡切换

📥 下载安装

  1. Releases 页面下载最新版本
  2. 解压到任意目录
  3. 运行 TypeBridge.exe

🚀 快速使用

第一步:启动程序

双击运行 TypeBridge.exe,程序会显示一个二维码和访问地址。

第二步:手机连接

  1. 确保手机和电脑连接到同一个 WiFi 网络
  2. 用手机扫描屏幕上的二维码
  3. 或者在手机浏览器输入显示的地址(如:http://192.168.1.100:5000

第三步:开始使用

在手机上输入文字,点击"发送"按钮,文字就会出现在电脑当前光标位置。

📖 功能说明

基本操作

按钮 功能
发送 将输入框的文字发送到电脑(应用替换规则)
回车 发送回车键
提交 发送文字 + 回车(适合聊天、表单提交)
清空 清空输入框

光标与编辑

按钮 功能
↑↓←→ 移动电脑光标
删除 删除电脑上的字符
撤销 撤销上一次发送

符号输入

点击符号按钮可以快速在输入文字两端添加符号对:

  • () "" 「」 []
  • 可在控制台配置中自定义更多符号

全屏编辑

点击输入框右侧的展开按钮,可以打开全屏编辑器,适合输入长文本。

历史记录

手机端保存发送过的历史文本,可快速重新发送。

快捷模板

支持创建常用文本模板(如常用句式、代码片段),在手机端一键发送。模板存储在数据库中,支持增删改查。

长按帮助

长按任意功能按钮可查看该按钮的详细说明。

⚙️ 配置说明

控制台配置

程序使用 console.json 文件驱动手机端控制台的按钮布局和替换规则。文件结构如下:

{
  "help_text": "按钮帮助文本(支持 Markdown)",
  "inputButtons": [
    {
      "id": "send",
      "label": "发送",
      "variant": "primary",
      "commands": [
        { "action": "text", "text": "{{input}}", "applyRules": true }
      ]
    }
  ],
  "actionGroups": [
    {
      "title": "光标控制",
      "columns": 4,
      "buttons": [...]
    }
  ],
  "rules": [
    { "pattern": "毫安时", "replacement": "mAh", "enabled": true }
  ]
}

按钮类型

variant 说明
primary 主要操作(发送)
info 信息操作(回车、提交)
secondary 次要操作(撤销)
danger 危险操作(删除)
cursor 光标控制
symbol 符号操作
white 扩展弹窗顶部按钮

命令类型

每个按钮可配置一组命令序列,支持以下命令:

action 字段 说明
text text, applyRules 发送文本,{{input}} 为输入框内容占位符
key key 按键(如 enter, backspace, left
combo keys 组合键(如 ["ctrl", "v"]
delay ms 延迟(毫秒)
undo - 撤销上一次操作

替换规则

console.jsonrules 数组中配置:

{
  "pattern": "正则表达式",
  "replacement": "替换文本",
  "enabled": true
}

规则说明:

  • 支持正则表达式
  • enabled 字段可单独启用/禁用规则
  • 替换在发送时自动执行

常用规则示例

[
  { "pattern": "毫安时", "replacement": "mAh", "enabled": true },
  { "pattern": "赫兹", "replacement": "Hz", "enabled": true },
  { "pattern": "(艾特)\\s*(QQ)\\s*点", "replacement": "@qq.", "enabled": true }
]

💡 使用技巧

  1. 快速输入 - 输入常用短语后点击"发送",比打字更快
  2. 命令组合 - 一个按钮可配置多条命令,如"发送文字 + 延迟 + 回车"
  3. 模板管理 - 在桌面端管理常用模板,手机端一键调用
  4. 自定义布局 - 编辑 console.json 自定义手机端按钮布局
  5. 符号配对 - 输入文字后点击符号按钮,自动在文字两端添加符号
  6. 全屏编辑 - 使用全屏编辑器输入长文本,支持多行编辑

❓ 常见问题

Q: 手机无法连接电脑?

A: 请检查:

  1. 手机和电脑是否连接到同一个 WiFi 网络
  2. 电脑防火墙是否阻止了程序(尝试关闭防火墙或添加例外)
  3. 程序是否正常运行(检查系统托盘图标)
  4. 桌面端主页可切换不同的局域网 IP 地址

Q: 文字发送后没有出现在电脑上?

A: 请检查:

  1. 电脑上是否有正在输入的窗口(如文本框、编辑器)
  2. 尝试点击电脑上的目标窗口,确保它是活动窗口
  3. 检查程序日志查看是否有错误信息

Q: 替换规则不生效?

A: 请检查:

  1. console.jsonrules 数组格式是否正确
  2. 规则的 enabled 字段是否为 true
  3. 保存配置后规则会自动重新加载,无需重启程序

Q: 如何让程序开机自启动?

A: 目前需要手动设置:

  1. 创建程序的快捷方式
  2. 将快捷方式放到启动文件夹:
    • Win + R,输入 shell:startup
    • 将快捷方式粘贴到打开的文件夹中

Q: 如何更新程序?

A:

  1. 程序会自动检查更新(在"关于"页面)
  2. 下载新版本后,关闭旧程序
  3. 用新文件替换旧文件即可(配置文件和数据库会保留)

📱 支持平台

  • ✅ Windows 10/11 (amd64)
  • ✅ macOS 12.0+ (Intel amd64 / Apple Silicon arm64)
  • ✅ 手机浏览器:Chrome、Safari、Firefox 等现代浏览器

🛠️ 从源码构建

以下内容面向开发者,普通用户请直接下载 Releases 版本。

环境要求

构建

task build            # 一键构建(前端 + 远程界面 + Go 二进制)
task build:frontend   # 仅构建桌面端前端
task build:remote     # 仅构建手机端远程界面

开发模式

wails3 dev            # 启动完整开发环境(热重载)
cd frontend && pnpm dev    # 仅启动桌面端前端(端口 9245)
cd remote && pnpm dev      # 仅启动手机端远程界面(端口 3020)

详细开发文档请参阅 docs/ 目录。


感谢使用 Type Bridge! 🎉

About

Type Bridge - 手机电脑输入同步工具

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors