Skip to content
timandyPublic

About

Windows 上的消息键入工具:微信、飞书、企业微信扫码即用,消息键入到光标处或快捷键锁定的窗口,终端后台直写,不抢焦点、不占剪贴板。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

TalkType

把微信、飞书、企业微信的消息键入 Windows / macOS:快捷键锁定任意窗口,终端后台直写,不抢焦点。文字不占剪贴板;图片、语音、视频、文件会保存到本机,并经剪贴板粘贴到目标。

在手机上给机器人发一条文字,TalkType 就把它键入到电脑当前的光标处,或者键入到用 Alt+. 锁定的窗口、终端。 三个来源都是扫码即用,不需要公网 IP,凭证和本人身份自动保存。配置文件 settings.json 首次运行时自动生成,也可以不改。仓库提供一份提交版示例配置 examples/settings.json,可复制到 ~/.talktype/settings.json 后按需修改:

Copy-Item examples/settings.json "$HOME\.talktype\settings.json"

微信来源基于官方 iLink Bot API(ClawBot,小龙虾),可替代 OpenClaw 的微信渠道插件。

支持 Windows 和 macOS。Windows 依赖 Win32 API(user32.dll / kernel32.dll),功能完整;macOS 通过 osascript 驱动 System Events 键入,不支持锁定窗口(见下文「macOS」)。 Linux / 云端环境只能编译与静态检查,无法验证真实键盘输入。

TalkType 演示:手机语音输入,文字直达电脑窗口

特性

  • 三个来源:微信(私聊)、飞书(机器人单聊)、企业微信(智能机器人单聊),另有调试用的控制台输入
  • 扫码即用:凭证扫码获得并自动保存,重启免扫码;飞书扫码时自动识别国内版或国际版 Lark
  • 只接受本人:微信、飞书自动记下扫码人,企业微信发一次配对码;之后只键入本人发来的消息
  • 不需要公网 IP:微信走长轮询,飞书、企业微信走长连接,都是程序主动连出
  • 不键入启动前的积压消息:程序没运行时发给机器人的消息,启动后会被确认但不键入,日志里提示忽略了多少条,避免一启动就往窗口里灌一堆旧消息
  • 去重与重试:已处理的消息 ID 记录在本地,重放或重推时不会重复键入;微信键入失败时保留游标重放,飞书回 500 期望重推
  • 锁定窗口或终端:Alt+. 锁定目标,Alt+/ 解除;终端(PowerShell、Windows Terminal、JetBrains / VS Code 终端)在后台直接写入,不切换窗口
  • Unicode 键入:中文、Emoji 直接输入,文字不用剪贴板和输入法
  • 多行文字按一行键入:文字中的 \r\n、\r、\n 及 Unicode 换行符会各替换为 delivery.newline,默认是一个半角空格、↵、一个半角空格;不合并连续换行,也不改变首尾空格和 Tab。设为空字符串可直接删除换行
  • 图片、语音、视频、文件:按类别保存到 files/images|audios|videos|files/,并像“复制文件再按 Ctrl+V”一样粘贴到光标处或锁定目标,三个来源通用,见「附件:图片、语音、视频、文件」
  • 断线重连:指数退避 + 抖动;凭证失效时自动重新扫码
  • 依赖很少:飞书、企业微信的 WebSocket 和协议编解码都是手写的,不依赖官方 SDK;只有音频转码引入了少量纯 Go(无 cgo)第三方库,见 NOTICE

快速开始

  1. 准备 TalkType.exe(不需要事先写配置文件,首次运行会自动生成 settings.json,见「配置文件与工作目录」)

  2. 运行程序,默认来源是微信:

    TalkType.exe

    用飞书或企业微信时加 --source(短写 -s),或把 settings.json 的 source 改成对应的值:

    TalkType.exe --source feishu
    TalkType.exe --source wecom

    同时启用多个来源时,用英文逗号分隔(逗号两边的空格会被忽略),例如 TalkType.exe --source wechat,feishu。启动时先按书写顺序逐个检查:凭证存在且能连上的来源立即开始监听;没有凭证、凭证文件缺字段(如 token、secret、扫码人)或服务端明确拒绝凭证的先记下。检查完后,再按同样的顺序逐个弹出扫码,前一个连通后才弹出下一个。每个来源最多等 5 分钟,超时没扫,或在本窗口输入 s 回车,就跳过它去弹下一个(包括最后一个);被跳过的来源本次不启动,下次启动会再检查。只启用一个来源时同样适用:没有授权会弹扫码,5 分钟内没扫就跳过。全部扫码结束后如果没有任何来源可用,会打印一行日志,5 秒后自动退出。中途退出也没关系,下次启动重新按此流程检查。网络暂时不通导致无法判断时,不会当作失效,该来源直接启动并自动重连。

  3. 首次运行会打印扫码链接并自动打开浏览器,用手机扫码确认(企业微信还要按提示给机器人发一次配对码)

  4. 把目标窗口切到前台并点中输入框,或按 Alt+. 锁定目标窗口、终端

  5. 在手机上给机器人发送文字,程序会自动键入并回车;发送图片、文件等附件时,程序会保存并粘贴(见「附件」)

程序常驻运行,登录成功后无需再次扫码。凭证失效或想换账号时:

TalkType.exe --relogin

--relogin 对所有启用的来源生效(企业微信的配对也会重新做),但不是一次全清:按配置顺序逐个来源处理,每个来源先弹扫码,扫成功才覆盖旧凭证,再轮到下一个。中途退出时,还没轮到的来源凭证原样保留;某个来源没扫成功(输入 s 回车、等满 5 分钟跳过或扫码失败)时,只要旧凭证仍然有效就沿用,来源照常启动。启动时程序也会打印一行提示。

命令行参数的完整列表见「命令行参数」,配置文件与工作目录的规则见下一节。

配置文件与工作目录

两个概念:

  • 配置文件 settings.json:共用配置,内容见「配置说明」。仓库中的提交版示例为 examples/settings.json。
  • 工作目录:凭证和已处理消息记录保存在 accounts/,附件保存在 files/。默认是 <用户目录>\.talktype,与 exe 放在哪里无关。

路径写法:--config、--work-dir 和配置文件里的 work_dir 都支持 ~(开头的 ~、~/、~\)和 ${HOME},都指用户目录;其他 ${...}(如 ${FOO})会报错。$HOME、%USERPROFILE%、~user 不展开,原样保留。相对路径的基准:命令行参数按启动时的当前目录;配置文件里的 work_dir 按配置文件所在目录。

配置文件按这个顺序确定:

  1. 给了 --config(情形 A):用它,文件必须存在,不存在或是目录就报错退出。
  2. 没给 --config、给了 --work-dir(情形 B):用 <工作目录>\settings.json;不存在就在那里生成。
  3. 都没给(情形 C):依次找 <用户目录>\.talktype\settings.json、TalkType.exe 所在目录下的 settings.json、当前目录下的 settings.json,用第一个存在的。都没有就在 <用户目录>\.talktype\ 下生成;取不到用户目录时改在 exe 所在目录生成。找到的文件格式有错时直接报错,不会改用下一个位置。

自动生成的文件内容与默认配置一致:生成在用户目录下时 work_dir 写 "~/.talktype",生成在其他位置(情形 B、exe 目录)时写 ".",即工作目录就是配置文件所在目录。在情形 C 里生成失败只打印警告,改用内存里的默认配置继续运行;情形 B 生成失败直接报错退出。

工作目录按这个顺序确定:

  1. --work-dir
  2. 配置文件的 work_dir(空串或不写表示未指定)
  3. <用户目录>\.talktype;取不到用户目录时依次回退到 TalkType.exe 所在目录、当前目录

确定后会创建目录(权限 0700)并写一个临时文件探测是否可写,失败就报错退出。启动时日志会打印实际用的配置文件和工作目录,以及各自的来源。

举例(用户目录为 C:\Users\me):

启动方式 配置文件 工作目录
TalkType.exe,哪里都没有 settings.json 新生成 C:\Users\me\.talktype\settings.json C:\Users\me\.talktype
TalkType.exe,exe 目录下已有 settings.json(用户目录下没有),其 work_dir 为空 exe 目录下的 settings.json C:\Users\me\.talktype
TalkType.exe -w D:\tt D:\tt\settings.json(没有则生成,work_dir 为 ".") D:\tt
TalkType.exe -c D:\conf\my.json,文件里 work_dir 为 "data" D:\conf\my.json D:\conf\data
TalkType.exe -c D:\conf\my.json -w E:\x D:\conf\my.json E:\x(命令行优先于文件里的 work_dir)
TalkType.exe --config D:\talktype\settings.json
TalkType.exe --work-dir D:\talktype

--lock / --unlock 只是通知正在运行的实例,不读配置文件、不创建目录,也不会生成配置文件。

命令行参数

所有参数用双杠。配置项都有同名参数,命令行给出的值优先于配置文件(即使与默认值相同也覆盖);没给的参数不影响配置文件的值。TalkType.exe --help 按下表顺序显示。

参数 短写 对应配置项 类型与默认值 说明
--source -s source 字符串,wechat 消息来源,见「配置说明」
--work-dir -w work_dir 路径,<用户目录>\.talktype 工作目录
--login-auto-open-qr login.auto_open_qr 布尔,true 扫码时自动打开浏览器
--reconnect-min-delay reconnect.min_delay 时长,1s 重连最小间隔
--reconnect-max-delay reconnect.max_delay 时长,1m0s 重连最大间隔
--delivery-type-delay delivery.type_delay 时长,0s 开始键入文字前的等待,附件粘贴不使用
--delivery-enter-delay delivery.enter_delay 时长,200ms 文字键入完成后、按回车前的等待;press_enter 为 false 时不等待
--delivery-press-enter delivery.press_enter 布尔,true 键入后是否回车
--delivery-newline delivery.newline 字符串,↵ 每个换行替换为此字符串;允许为空以直接删除换行,值不能包含换行字符
--delivery-max-retries delivery.max_retries 整数,5 键入失败的重试次数,小于 1 按 1 处理
--ack-reply-text ack.reply_text 字符串,空 非空时键入成功后回复这条文本
--ack-max-ids ack.max_ids 整数,500 保留的已处理消息 ID 数量
--config -c 无 路径 配置文件路径,必须存在
--relogin 无 开关 强制重新扫码,见「快速开始」
--lock 无 开关 在目标终端中运行,锁定该终端后退出;不能与 --unlock 同用
--unlock 无 开关 解除锁定后退出
--version -v 无 开关 显示版本(如 TalkType 1.2.3,本地编译未注入时为 TalkType dev)并退出
--help -h 无 开关 显示帮助并退出

写法说明:

  • 取值用空格或等号都行:--source feishu、--source=feishu。
  • 布尔参数关闭必须用等号:--delivery-press-enter=false。写成 --delivery-press-enter false 会把 false 当成多余的位置参数而报错。
  • 时长必须带单位,如 60ms、1s、1m30s,不支持 d(一天写 24h);--delivery-type-delay 100 这种不带单位的会报错。
  • --config、--work-dir 给了就不能是空串或只有空白;--delivery-newline= 的空值合法,表示直接删除文字换行。
  • 参数错误(未知参数、缺少值、类型不对、多余的位置参数、--lock 与 --unlock 同给)会打印原因和用法,退出码 2;运行或配置错误退出码 1。
  • 双击或从开始菜单启动时,如果报错退出,窗口会先等 5 秒再关闭,来得及看清错误;在命令行里运行不等待。

升级说明

从旧版升级时注意:

  • 参数改成双杠:旧的单杠写法 -source、-config、-relogin、-lock、-unlock 不再支持,改用 --source、--config、--relogin、--lock、--unlock。旧版里 -lock 与 -unlock 同给时 -lock 优先,新版直接报错。--config 给相对路径时按启动时的当前目录补全(旧版按 exe 目录)。

  • 配置文件改名并换位置:旧版 talktype.json 改名为 settings.json,按「配置文件与工作目录」的顺序查找。凭证和已处理记录从工作目录根部移到 accounts/ 子目录。旧位置的 config.json、talktype.json、*_token.json、*_acked.ids、files/ 不会自动迁移,程序也不提示;需要沿用时手动复制到新的工作目录(凭证和记录放入 accounts/,附件放入 files/),或用 --work-dir 指向旧目录后自行整理。

  • 配置键改名:

    旧键 新键
    inject delivery
    reconnect.min_delay_ms reconnect.min_delay
    reconnect.max_delay_ms reconnect.max_delay
    inject.type_delay_ms delivery.type_delay
    inject.enter_delay_ms delivery.enter_delay
    inject.press_enter delivery.press_enter
    inject.max_retries delivery.max_retries
    ack.max_acked_ids ack.max_ids

    旧键会被当作未知字段而报错。

  • 时长必须带单位:原来的毫秒整数改成字符串,如 "min_delay_ms": 1000 改为 "min_delay": "1s","type_delay_ms": 60 改为 "type_delay": "60ms"。

飞书个人账号的已知问题:飞书在申请应用访问凭证时可能返回 code=21001 Access denied due to platform policy。这时文字消息能正常键入,但附件下载和回执会失败。这是飞书平台对账号的策略限制,不是程序问题,社区报告见 openclaw-lark#639;换用注册时选择“企业用户”的账号可以解决。详见 docs/feishu.md 第 9 节。

macOS

  • 消息始终键入到当前光标位置并回车,没有 Alt+. / Alt+/ 锁定,也没有 --lock / --unlock。先把目标窗口切到前台、点中输入框,再发消息。
  • 键入用 osascript 驱动 System Events 的 keystroke,不读写剪贴板。首次使用时系统会要求授权:在“系统设置 → 隐私与安全性 → 辅助功能”里允许运行本程序的终端(或程序),并允许它控制“System Events”。没有授权时日志会提示,且不会重试。
  • 输入法处于中文等输入状态时,keystroke 的字符可能先进入输入法的组字,建议键入时切到英文输入法;这一点没有在真机上验证。
  • 打开二维码链接用系统的 open 命令。
  • 配置文件、工作目录(凭证和附件)的位置规则与 Windows 相同:默认在 ~/.talktype,凭证和 acked 记录位于其 accounts/ 子目录,见「配置文件与工作目录」。

编译

需要 Go 1.27+(以 go.mod 中的 go 指令为准)。引入了少量纯 Go(无 cgo)第三方库用于音频转码,见 NOTICE;它们不需要 C 编译器,CGO_ENABLED=0 也能构建,发布产物仍是单个可执行文件,不需要安装 ffmpeg 等外部程序。

推荐使用仓库根目录的 PowerShell 构建脚本。脚本以自身所在目录为仓库根目录,不依赖当前目录;默认版本来自 git describe --tags --always --dirty,也可以用 -Version 覆盖。每个目标构建前会清空对应的 dist/ 子目录:

.\build.ps1
.\build.ps1 -Target windows-amd64,darwin-arm64
.\build.ps1 -Target windows-amd64 -Version test
.\clean.ps1

-Target 可选 windows-amd64、darwin-arm64、darwin-amd64,不指定时构建全部目标。产物位于 dist/windows-amd64/TalkType.exe、dist/darwin-arm64/TalkType 和 dist/darwin-amd64/TalkType。脚本兼容 Windows PowerShell 5.1、PowerShell 7 及 macOS pwsh。clean.ps1 会删除整个 dist/ 目录。

在 Windows 上也可以直接编译:

go build -trimpath -ldflags "-s -w" -o TalkType.exe ./cmd/talktype

--version 显示的版本号由构建时注入,不注入时显示 dev:

go build -trimpath -ldflags "-s -w -X main.version=1.2.3" -o TalkType.exe ./cmd/talktype
TalkType.exe --version

输出 TalkType 1.2.3。命令行用 cobra v1.10.2 和 pflag v1.1.0,许可证见 NOTICE。

在 macOS 上直接编译:

go build -trimpath -ldflags "-s -w" -o TalkType ./cmd/talktype

在 Linux / macOS 上交叉编译 Windows 版本:

GOOS=windows GOARCH=amd64 go build -trimpath -ldflags "-s -w" -o TalkType.exe ./cmd/talktype

静态检查(云端可用):

go build ./...
go vet ./...
GOOS=windows GOARCH=amd64 go build -o TalkType.exe ./cmd/talktype
GOOS=windows GOARCH=amd64 go vet ./...
GOOS=darwin GOARCH=arm64 go build -o TalkType ./cmd/talktype
GOOS=darwin GOARCH=arm64 go vet ./...

配置说明

提交版示例配置位于 examples/settings.json。运行时使用的配置文件仍按上一节的规则确定,通常是 ~/.talktype/settings.json。

settings.json 只放各来源共用的配置,位置和生成规则见「配置文件与工作目录」。文件里没写的键使用默认值;凭证和记录的文件权限分别为 0600,accounts/ 目录由启动准备阶段按 0700 创建并探测可写。不认识的字段(包括旧版的键,见「升级说明」)会报错,避免拼错的字段被静默忽略。delivery.newline 默认是 ↵(半角空格 + U+21B5 + 半角空格),文字中的每个 \r\n、\r、\n、U+2028、U+2029 或 U+0085 都替换为它,不合并连续换行、不 trim;设为 "" 可直接删除换行,但值不能包含这些换行字符。

不需要配置、全部自动处理的内容:

  • 服务地址和协议参数:微信的 iLink 地址、bot 类型、channel_version、签名、长轮询超时,企业微信的长连接地址,都内置在程序里
  • 凭证:扫码获得,存进工作目录 accounts/ 子目录的 wechat_token.json / feishu_token.json / wecom_token.json
  • 本人身份:微信、飞书取扫码人,企业微信发一次配对码;之后只接受本人的消息
  • 飞书站点:先连国内版飞书,扫码账号属于国际版 Lark 时自动切换,并记进 feishu_token.json
  • type_delay 与重试:每条文字消息的首次键入尝试在发送文字前等待一次;同一消息的重试不重复这次前置等待。每次尝试仍在文字完成后、回车前按 enter_delay 等待
字段 默认值 说明
source "wechat" wechat(微信)、feishu(飞书)、wecom(企业微信)或 console(调试用),不区分大小写。可用英文逗号分隔同时启用多个,如 "wechat, feishu",按顺序逐个扫码;包含 console 时只启用 console,其余来源不启动。命令行 --source 可临时覆盖
work_dir "" 工作目录。空值表示使用默认的 <用户目录>\\.talktype;命令行 --work-dir 优先,支持 ~ 和 ${HOME}
login.auto_open_qr true 扫码登录时自动用浏览器打开二维码链接
reconnect.min_delay "1s" 断线重连的初始退避时间
reconnect.max_delay "1m0s" 最大退避时间,每次失败翻倍
delivery.type_delay "0s" 开始键入文字前的等待,附件粘贴不使用
delivery.enter_delay "200ms" 文字键入完成后、按回车前的等待;press_enter 为 false 时不等待
delivery.press_enter true 键入后是否发送回车
delivery.newline " ↵ " 文字中的每个换行替换为此字符串;默认值为半角空格、↵、半角空格。允许 "",表示直接删除换行;值不能包含换行字符
delivery.max_retries 5 单条消息键入失败的重试次数
ack.reply_text "" 非空时,键入成功后向发送者回一条文本作为回执
ack.max_ids 500 保留的已处理消息 ID 数量,用于去重。记录文件超过两倍时压缩

消息来源

用 settings.json 的 source 选择,也可以用命令行 --source 临时覆盖,多个来源用英文逗号分隔。多个来源同时运行时,消息按到达顺序串行键入。--relogin 的处理方式见「快速开始」。三个来源的文字消息都键入到光标处; 图片、语音、视频、文件按「附件:图片、语音、视频、文件」一节处理。表情、富文本等其他类型只在控制台打印“暂不支持”的提示,不输入、不回复。

已处理的消息 ID 逐行追加到 accounts/wechat_acked.ids / accounts/feishu_acked.ids / accounts/wecom_acked.ids(与凭证文件同在工作目录的 accounts/ 子目录), 用于在重放或重推时去重。行数超过 ack.max_ids 的两倍时整份重写,只留最近的;进程中断导致最后一行没写完时, 读取时丢弃该行。删除这些文件只会失去去重记录,不影响登录。

微信(wechat,默认)

用手机微信扫码登录 ClawBot,然后在微信里给 ClawBot 发文字。

  • 收消息走 iLink 长轮询(getupdates 挂起约 35 秒)
  • 键入成功才推进并保存游标,失败时保留游标重放,按消息 ID 去重
  • 创建时间早于本次启动的消息(离线期间积压的)只确认、不键入,日志打印
  • 支持图片、语音、文件、视频附件
  • 只接受扫码人本人的消息;凭证里没有扫码人时接受所有人(与官方插件一致)
  • 会话过期(-14)时自动清除凭证并重新扫码
  • iLink 只支持私聊;ClawBot 名额通常只有一个,重复扫码可能顶掉之前的绑定

协议细节见 docs/wechat.md。

飞书(feishu)

首次运行会打印一个飞书授权链接,并在 login.auto_open_qr 开启时自动用浏览器打开。 用飞书 App 扫描该链接的二维码并确认,飞书会自动创建一个机器人应用,App ID、App Secret 和扫码人的 open_id 保存到工作目录 accounts/ 子目录的 feishu_token.json。然后在飞书里给这个机器人发单聊消息即可。

  • 收消息走飞书长连接(WebSocket)
  • 只处理机器人单聊;群聊消息只在控制台提示
  • 支持图片(image)、文件(file)、语音(audio)、视频(media)附件;富文本(post)和表情(sticker)仍只提示。下载附件需要应用有读取消息资源的权限(未实测)
  • 只接受扫码人本人的消息
  • 键入失败时向飞书返回 500、不记为已处理,期望飞书重推;键入成功或按规则忽略时返回 200
  • 企业组织账号扫码创建的应用需要管理员审核后才能使用;审核前在飞书里找不到这个机器人

扫码用的应用注册接口取自飞书官方安装工具 @larksuite/openclaw-lark-tools,开放平台没有公开文档,接口变化时扫码可能失效。 协议细节见 docs/feishu.md。

企业微信(wecom)

首次运行会打印企业微信的扫码页面地址,并在 login.auto_open_qr 开启时自动用浏览器打开。用企业微信扫描页面上的二维码, 会创建一个智能机器人并接入本程序,Bot ID 和 Secret 保存到 wecom_token.json。

扫码结果里没有扫码人的身份,所以还要配对:控制台会显示一个 6 位配对码,在企业微信里把它发给机器人, 程序就把你的 userid 记为本人,并回复“配对成功”。配对前不键入任何消息,配对后只接受本人的消息。 换机器人或 --relogin 后需要重新配对。

  • 收消息走企业微信长连接(wss://openws.work.weixin.qq.com)
  • 只处理机器人单聊;群聊消息只在控制台提示
  • 支持图片、文件、视频附件,以及图文混排(mixed)消息里的图片;语音消息实测回调只有转写文字、没有音频 url,转写文字按文字消息键入(去重、配对、本人、回执规则与文字消息相同);若回调带 url,则下载并转成 MP3 后粘贴;两者都没有时只提示
  • 企业微信不会因为键入失败而重推,键入失败的消息只记日志
  • 同一个机器人只能有一个长连接。在别处又连上时,本程序会收到通知并退出,避免两边互相挤下线

扫码接口取自企业微信官方命令行工具 wecom-cli,长连接协议取自官方 SDK @wecom/aibot-node-sdk,都没有公开文档。 协议细节见 docs/wecom.md。

控制台(console,调试用)

TalkType.exe --source console

不连接任何服务,每在本程序窗口输入一行并回车,就当作收到一条消息。先切到目标终端按 Alt+. 锁定,再回到本窗口输入即可。 未锁定时,回车后有 3 秒时间切到目标窗口。

附件:图片、语音、视频、文件

收到附件时分两步处理:先由来源把文件下载并解密,保存到本机;保存成功后,再把这个文件粘贴到目标,效果等同于在资源管理器里复制文件、切到聊天框按 Ctrl+V。三个来源走同一条路径,所以微信收到的图片可以粘贴到飞书窗口,反之亦然。

各来源支持的附件:

来源 支持 说明
微信 图片、语音、文件、视频 一条消息里有多个附件时按顺序逐个处理
飞书 图片、文件、语音、视频 富文本(post)、表情(sticker)不支持
企业微信 图片、文件、视频,图文混排里的图片;语音消息的回调带 url 时也保存 语音实测只有转写文字、没有 url,转写文字按文字消息键入,不保存音频;带 url 时才保存并转 MP3

保存位置与文件名

文件保存到工作目录(默认 <用户目录>\.talktype,见「配置文件与工作目录」)的 files/ 下,按类别分四个目录,不再按日期分目录。files/ 已加入 .gitignore。

类别 目录 文件名
图片 files/images/ yyyyMMddHHmmssSSS_NNNNNN.扩展名
音频(语音) files/audios/ 同上
视频 files/videos/ 同上
文件 files/files/ 原始文件名;没有原名时同上
  • 图片、音频、视频一律用时间戳文件名,例如 files\images\20261120153045123_048213.jpg。yyyyMMddHHmmssSSS 是开始保存时的本机本地时间(精确到毫秒),NNNNNN 是 6 位随机数。即使来源给了原始文件名(如飞书视频消息),也只用它取扩展名,不作为文件名。同名冲突时只重新取随机数,最多尝试 100 次

  • 文件保留消息里的原始文件名(微信的 file_name,飞书的 file_name 或下载响应头,企业微信的下载响应头),例如 files\files\报告.pdf。名字会先清洗:先对百分号编码的名字(如 UI%E7%9B%B8….pdf,整体能解码为合法 UTF-8 时才解,只解一次)解码成 UI相关作品集.pdf,再去掉路径、控制字符和 Windows 不允许的字符,避免写到目录之外

  • 文件重名时不覆盖,改为 名字 (1).扩展名、名字 (2).扩展名,例如 files\files\报告 (1).pdf;超过 10000 个重名时改用时间戳文件名。文件没有原名时也用时间戳文件名

  • 扩展名按以下顺序取第一个有结果的:原名自带的扩展名(只接受字母和数字,统一转小写)、MIME 对应的扩展名、来源提供的扩展名(如视频 .mp4、微信语音 .silk,仅在语音转码失败时用到)、文件头嗅探;时间戳文件名都没有结果时用 .bin。文件的原名没有扩展名时会补上推断出的扩展名,推断不出则保持原名

  • 无法识别的附件类型按“文件”处理,保存到 files/files/

  • 单个文件上限 200 MiB,超过则放弃;这些参数都是内置的,没有配置项

  • 网络错误、服务器 5xx、限流等瞬时错误最多尝试 3 次(间隔 1 秒、2 秒),之后放弃

  • 失败时不留半截文件;不限制 files/ 的总量,也不自动清理。进程被强行结束时可能残留 .part-* 临时文件和零字节占位文件,可手动删除

  • 日志只记录结果,不记录下载地址、密钥和 token,例如:

    2026/11/20 10:30:00 [talktype-wechat] 已保存 图片 → E:\talktype\files\images\20261120153045123_048213.jpg
    2026/11/20 10:30:01 [talktype] 已粘贴 图片
    

粘贴到哪里

  • 未锁定:粘贴到当前前台窗口的光标处
  • 已锁定(Alt+.):粘贴到锁定的窗口或终端;目标不在前台时短暂切过去,粘贴完成后切回
  • 粘贴后按 delivery.press_enter 决定是否回车;设为 false 时需要自己确认发送
  • 粘贴的是文件本身,不会往光标处键入路径。文字消息的行为不变
  • macOS 可以粘贴到前台应用(Cmd+V),但不支持锁定

附件处理的其他规则:

  • 启动前积压的附件只确认、不下载,也不粘贴
  • 只处理本人单聊消息里的附件,非本人、群聊的附件不会下载
  • 一条消息里既有文字又有附件时,先键入文字,再处理附件
  • 保存失败时只在日志里记录原因,不粘贴,消息照常确认,不会反复重推。想要的话请重新发送
  • 粘贴失败(剪贴板被占用、切换窗口失败等)时只记日志,文件仍保存在 files/ 下,可以手动取用
  • 锁定的目标已关闭时,文件已保存但不粘贴,并弹出与文字相同的提示
  • 语音转 MP3:见下一节「语音转 MP3」。粘贴后只是文件消息,不是语音条

语音转 MP3

语音(音频)保存前先在内存里转成 MP3,这样电脑上双击就能播放,粘贴给对方后点开也能播放。

  • 识别按文件头魔数,不看扩展名:微信 SILK(#!SILK_V3,也接受前面多一个字节的变体)、飞书 Ogg Opus、AMR-NB 都会转成单声道 64 kbps 的 MP3;本来就是 MP3 的原样保存,不重新编码
  • 保存位置是 files/audios/,文件名为时间戳名、扩展名 .mp3;转码成功时不保留原始音频
  • 企业微信:带 url 时按同样方式下载(有 aeskey 就解密)并转码;只有转写文字(实测如此)时按文字消息键入,不保存音频
  • 转码失败(格式无法识别、数据损坏、超过 16 MiB 或 60 秒的上限、解码库出错)时保留原文件,扩展名按来源提示(如 .silk、.opus),照常粘贴,不影响确认;日志里有 语音转码失败,已保留原文件 或 语音格式无法识别,已保留原文件
  • 微信、飞书、企业微信的电脑客户端没有通过剪贴板粘贴发送语音条的方式(未实测),所以粘贴出去的始终是文件消息,不是语音条;TalkType 不会调用各平台的语音发送接口
  • 转码用到的第三方库都是纯 Go,许可证和版权声明见 NOTICE。其中 MP3 编码库使用 LGPL-2.0,本项目仍以 Apache-2.0 发布
  • 转码参数(采样率、码率)和各来源实际收到的音频格式未实测,见各来源文档

剪贴板

粘贴会临时占用系统剪贴板:先备份当前内容,把文件放进去,发送粘贴快捷键,等待片刻,按需回车,最后恢复原内容。

  • Windows 上两次写入剪贴板(放入文件、恢复原内容)都带“不进入剪贴板历史(Win+V)、不上传云剪贴板”的标记,是否在各版本上真正生效未实测
  • 无法完整恢复的内容:延迟渲染或私有句柄的格式、位图句柄类格式,以及超过 64 MiB 的部分。这些格式粘贴后会丢失,程序仍会继续粘贴,并在日志里提示
  • 粘贴期间如果你复制了新内容,程序发现剪贴板已变化就不再恢复,不会覆盖你的新内容
  • 备份的剪贴板内容只放在内存里,不写日志、不落盘

终端

终端无法通过“后台写入”接收文件,所以附件对终端是例外:短暂切到终端窗口粘贴,再切回原窗口(文字仍在后台写入)。切换期间约 1~2 秒,这时的键盘输入可能进入目标窗口。向终端粘贴图片时,程序还会额外把图片位图放进剪贴板,方便只认位图的程序读取(未实测)。

Windows Terminal、Kiro CLI、Claude Code 等对粘贴文件、图片的实际行为,以及粘贴快捷键是 Ctrl+V 还是 Alt+V,都未实测。详见 docs/clipboard.md。

锁定窗口或终端(Alt+. / Alt+/)

快捷键:

操作 效果
未锁定时按 Alt+. 锁定当前窗口或终端
已锁定,在别的窗口或终端标签里按 Alt+. 锁定切换到当前这个
已锁定,在锁定的那个里按 Alt+. 解除锁定
在任意位置按 Alt+/ 直接解除锁定

左右两个 Alt 键都可以。按下到提示卡片出现,实测 30~260 毫秒。

锁定后的发送方式:

  • 终端(PowerShell、cmd、Windows Terminal、IntelliJ IDEA / GoLand 等 JetBrains 终端、VS Code 终端): 在后台直接写入该终端,不切换窗口、不闪烁、不打断你正在别处打字。
    • Windows Terminal 有多个标签时,按窗口标题确认当前标签。
    • JetBrains / VS Code 的终端:按下 Alt+. 后,程序把窗口右边和底边临时内移再恢复(窗口右边和底部会轻微闪一下)。先内移 24 像素,没有反应再逐级加到 64、120 像素, 终端停靠在 IDE 主窗口里时也能识别。终端单独成窗口时约 0.1 秒。 IDE 只会调整正在显示的终端的尺寸,由此确定锁定哪个标签。Reworked 2025 和 Classic 引擎、Window / Float / 停靠等显示模式都适用。 通知里会显示锁定标签的提示符,方便确认。
    • 也可以在目标终端里运行 TalkType.exe --lock 精确锁定它;--unlock 解除。
  • 其他窗口(浏览器、IDE 的代码编辑器、终端被隐藏的 IDE 窗口等):发送时短暂切到该窗口输入,再切回原来的窗口。 凡是探测不到正在显示的终端,都按这种方式处理。
  • 锁定的窗口或终端关闭后,消息不再发送(该消息被丢弃),并弹出提示。
  • 每次状态变化都会在屏幕右下角弹出彩色提示卡片:新卡片把旧的往上顶,越旧越透明,几秒后淡出消失;不抢焦点,也不挡鼠标。
  • 如果 Alt+. 已被其他程序占用,启动时会打印警告,锁定功能不可用;只有 Alt+/ 被占用时,可在已锁定的目标里按 Alt+. 解除。

原理、支持的窗口类别和已知限制详见 docs/window-lock.md。

键入原理

  1. 投递文字前把 \r\n、\r、\n、U+2028、U+2029 和 U+0085 各替换为 delivery.newline;默认值为 ↵,连续换行不合并,首尾空格、其他字符和 Tab 保持不变。
  2. 文本按 UTF-16 码元拆分为 KEYEVENTF_UNICODE 键事件(每个码元一次按下 + 一次抬起),制表符使用 VK_TAB
  3. 每 512 个事件一批调用 SendInput,中文、Emoji 无需剪贴板或输入法
  4. 可选等待后发送回车按下/抬起;这个回车只由 delivery.press_enter 决定

键击作用于当前前台窗口,因此未锁定时需把目标窗口置前并点中输入框。锁定终端时改为后台写入控制台输入缓冲区, 见 docs/window-lock.md。

常见问题

现象 排查方向
一直停在等待扫码 检查网络能否访问对应来源的地址:微信 ilinkai.weixin.qq.com;飞书 accounts.feishu.cn、open.feishu.cn(Lark 为 accounts.larksuite.com、open.larksuite.com);企业微信 work.weixin.qq.com、openws.work.weixin.qq.com。公司网络可能屏蔽了其中的域名。二维码过期会自动刷新
收到消息但没有键入,日志也没报错 目标程序很可能以管理员身份运行:Windows 会静默丢弃普通权限程序发给管理员窗口的模拟按键(UIPI)。在任务管理器“详细信息”页加上“已提升”列查看;让本程序也以管理员身份运行,或让目标程序以普通权限运行
收到消息但输入到了别的窗口 未锁定时键入跟随当前前台焦点;按 Alt+. 锁定目标窗口或终端,见上文和 docs/window-lock.md
日志显示“忽略非本人的消息” 只接受扫码人(企业微信为配对人)的消息。换了账号时用 --relogin 重新扫码
企业微信一直不键入 还没配对:按控制台提示把 6 位配对码发给机器人
飞书在企业账号下找不到机器人 应用还在等管理员审核
中文变成乱码或丢失 目标控件需支持 WM_CHAR / Unicode 输入;部分游戏、远程桌面或安全控件会拦截合成键击
附件粘贴后聊天软件弹出预览或确认框,没有发出去 回车能否直接发送取决于聊天软件,未实测;需要时手动确认,或把 delivery.press_enter 设为 false 自己控制
附件已保存但没有粘贴 看日志里的“粘贴失败”原因:剪贴板被其他程序占用、切换窗口失败,或平台不支持。文件在 files/ 下对应的类别目录里,可手动取用
到哪里找收到的文件 在工作目录的 files/ 下:图片 images/、语音 audios/、视频 videos/、文件 files/。凭证和 acked 记录在同一工作目录的 accounts/ 下。
图片、视频的文件名为什么是一串数字 它是保存时刻的时间戳加 6 位随机数(yyyyMMddHHmmssSSS_NNNNNN),便于按时间排序且不会重名;只有“文件”类附件保留原始文件名
收到同名文件会不会覆盖 不会。文件重名时自动改为 名字 (1).扩展名、名字 (2).扩展名
粘贴附件时剪贴板被短暂占用 正常现象,粘贴约 1~2 秒后会恢复原内容;这期间你复制的新内容不会被覆盖
终端里粘贴图片没反应 Claude Code 在 Windows 上粘贴图片可能需要 Alt+V(未实测);也可以去 files/ 下取文件。参见 docs/clipboard.md
收到语音但没有文件 企业微信语音实测只有转写文字、没有音频文件,转写文字会像文字消息一样键入,不会保存音频;微信、飞书的语音会转成 MP3 保存;企业微信语音回调带 url 时也会保存
偶尔重复输入 来源没有提供消息 ID 时无法去重,属于预期情况
频繁出现重新扫码 平台侧主动失效或重复绑定顶号,重新扫码即可

日志直接输出到控制台,每行以时间开头,然后是前缀 [talktype];各来源自己的日志带渠道名,如 [talktype-wechat]、[talktype-feishu]、[talktype-wecom]、[talktype-console],同时运行多个来源时可据此区分。可以用日志判断登录、收消息、ACK 与重连状态。

安全与限制

  • 凭证与状态安全:*_token.json 含各来源的凭证(微信 bot_token、飞书 App Secret、企业微信 Secret),位于工作目录的 accounts/ 子目录,等同于机器人的收发权限,请勿提交或外传;程序以 0600 写入,accounts 目录以 0700 创建,已在 .gitignore 中忽略。
  • 不指定 --config 和 --work-dir 时,程序会按顺序读取用户目录、exe 所在目录、当前目录下的 settings.json。在不可信的目录里启动,可能读到别人放进去的 settings.json;这种情况用 --config 显式指定配置文件
  • 目标窗口以管理员身份运行时,本程序必须也以管理员身份运行,否则按键会被系统静默丢弃;锁定管理员终端时同样无法后台写入
  • UAC 安全桌面、部分游戏和安全控件会拒绝合成键击
  • 多行文字会按一行键入:每个换行替换为 delivery.newline,默认是 ↵;连续换行会留下对应数量的替换串,附件不经过这条文字处理路径
  • 附件保存在 files/ 下,不限制总量、不自动清理,请定期手动清理
  • 附件粘贴期间会临时占用并恢复系统剪贴板,终端目标会短暂切到前台
  • 仅支持 Windows 和 macOS;macOS 不支持锁定窗口、后台写终端,键入依赖辅助功能权限

项目结构

talktype/
├── build.ps1                  PowerShell 构建脚本,产物输出到 dist/
├── clean.ps1                  PowerShell 清理脚本,删除 dist/
├── cmd/
│   └── talktype/
│       ├── main.go              程序入口:辅助子进程识别、平台检查、控制台初始化
│       └── main_test.go         入口测试和构建二进制集成测试
├── internal/
│   ├── cli/                     命令行:cobra 根命令、参数绑定、版本和统一退出
│   │   ├── cli.go
│   │   ├── exit.go
│   │   └── *_test.go
│   ├── app/                     应用:启动准备、来源装配、运行和粘贴日志钩子
│   │   ├── startup.go
│   │   ├── run.go
│   │   ├── paste_windows.go / paste_other.go
│   │   └── *_test.go
│   ├── config/                  配置:共用配置的结构、默认值、校验
│   │   ├── config.go            Config、加载、校验、生成默认配置文件
│   │   ├── path.go              路径展开(~、${HOME})、确定配置文件与工作目录
│   │   └── duration.go          带单位的时长类型 Duration
│   ├── audio/                   音频转码:识别格式、解码 SILK / Opus / AMR-NB、编码 MP3;唯一允许导入第三方库的包
│   │   ├── detect.go            按魔数识别格式
│   │   ├── convert.go           Convert 总入口:大小与时间上限、panic 转错误
│   │   ├── silk.go / opus.go / ogg.go / amr.go   各格式解码
│   │   ├── pcm.go               下混、重采样
│   │   ├── mp3.go               MP3 编码
│   │   ├── deps.go              第三方依赖说明
│   │   └── imports_test.go      检查第三方库只出现在本包
│   ├── files/                   附件落盘:只依赖标准库
│   │   ├── types.go             Request、Info、Result、大小上限
│   │   ├── errors.go            ErrDropped、ErrTransient
│   │   ├── names.go             文件名清洗、扩展名推断
│   │   ├── place.go             类别目录、时间戳文件名、重名占位
│   │   └── saver.go             Saver:重试、流式写入、原子改名、失败清理
│   ├── source/                  消息来源
│   │   ├── source.go            来源接口 Source、消息 Message、LocalFile、Attachment、Handler、ErrDiscarded,以及同时运行多个来源的 Multi
│   │   ├── save.go              Save:把附件交给 files.Saver 保存;音频先经 internal/audio 转 MP3
│   │   ├── redact.go            日志脱敏、已保存日志文本
│   │   ├── wechat/              微信(iLink Bot API):签名、扫码、长轮询、ACK、重连、回执;attachment.go 附件下载,decrypt.go AES-128-ECB 解密
│   │   ├── feishu/              飞书:扫码创建机器人、长连接、pbbp2 帧编解码、事件处理、回执;attachment.go 附件解析与下载
│   │   ├── wecom/               企业微信:扫码创建智能机器人、长连接、配对、回执;attachment.go 附件下载,decrypt.go AES-256-CBC 解密
│   │   └── console/             控制台(调试用)
│   ├── delivery/                投递
│   │   ├── delivery.go          投递器 Deliverer、Injector、CursorInjector、FilePaster(粘贴已保存的文件)
│   │   ├── winlock/             快捷键锁定:状态与语义、目标识别、热键、提示卡片;paste_windows.go 锁定目标的附件粘贴
│   │   └── wintype/             键入:SendInput、切前台输入、后台写终端、进程快照;clipboard.go(粘贴流程编排)、dib.go(CF_HDROP、位图编码)、clipboard_windows.go / paste_windows.go(Windows 剪贴板与粘贴键)、clipboard_darwin.go(macOS 剪贴板)、clipboard_other.go(其他平台占位);macOS 键入用 osascript(applescript.go、input_darwin.go);*_other.go 为其他平台占位
│   ├── browser/                 辅助:用系统默认浏览器打开扫码链接(Windows 用 rundll32,macOS 用 open)
│   ├── store/                   辅助:凭证(*_token.json)和已处理消息 ID(*_acked.ids)的持久化
│   └── ws/                      辅助:最小 WebSocket 客户端(RFC 6455),飞书和企业微信共用
│       └── wstest/              测试用的 WebSocket 服务端
├── docs/
│   ├── window-lock.md           锁定功能的原理与支持范围
│   ├── clipboard.md             附件粘贴:剪贴板备份恢复、历史排除标记、终端粘贴与未实测项
│   ├── wechat.md                微信来源的协议细节
│   ├── feishu.md                飞书来源的协议细节与调研记录
│   ├── wecom.md                 企业微信来源的协议细节与调研记录
│   └── image/                   README 演示动画(talktype-demo.gif)
├── examples/
│   └── settings.json              提交版配置示例(与用户目录情况自动生成的配置内容一致)
├── third_party/
│   └── licenses/                第三方许可证文本(LGPL-2.0、BSD-3-Clause、goamr-nb 的 NOTICE 等)
├── LICENSE                      Apache License 2.0
├── NOTICE                       版权声明与第三方组件清单
├── go.mod / go.sum
└── README.md

运行后生成的文件不在仓库目录里,而在配置文件与工作目录(默认 <用户目录>\.talktype,见「配置文件与工作目录」)下:

<用户目录>\.talktype\
├── settings.json                自动生成的配置文件(情形 C 且用户目录下没有时)
├── accounts/                     凭证与已处理消息记录(目录权限 0700)
│   ├── *_token.json              各来源的凭证与本人身份
│   └── *_acked.ids               已处理消息 ID,一行一个
└── files/                       收到的附件,按类别分目录
    ├── images/                  图片(时间戳文件名)
    ├── audios/                  语音、音频(时间戳文件名)
    ├── videos/                  视频(时间戳文件名)
    └── files/                   文件(原始文件名,重名加 (N))

分层约定:

  • cmd/talktype 只负责进程入口、平台生命周期和调用 internal/cli / internal/app
  • internal/cli 只负责 cobra 参数解析、配置绑定和统一退出;不依赖 internal/app
  • internal/app 负责启动准备、来源装配、投递和粘贴日志钩子,不导入第三方库
  • internal/source/* 只是消息来源,只依赖 internal/source、internal/config、internal/store、internal/ws、internal/browser、internal/files(音频转码由 internal/source/save.go 调用 internal/audio),不调用键盘输入;来源可以通过 internal/files 保存附件(不直接用 os 写文件),凭证和已处理记录仍只走 internal/store
  • 第三方库只允许出现在 internal/audio(音频转码)和 internal/cli(命令行只许用 cobra、pflag),且必须是纯 Go(不使用 cgo);其他包只依赖标准库和本项目的包。新增依赖前要核对许可证并更新 NOTICE
  • internal/files 只依赖标准库;internal/delivery 不依赖 internal/files,只粘贴来源已保存的本地文件
  • internal/delivery 负责投递,Win32 调用只在 delivery/wintype 和 delivery/winlock 的 *_windows.go 里,其他包不依赖 syscall / unsafe
  • 凭证和消息记录的读写全部通过 internal/store;附件文件的写入全部通过 internal/files
  • internal/config、internal/store、internal/ws、internal/browser 没有内部依赖(ws/wstest 只依赖 ws),可被任意层引用

许可证

本项目基于 Apache License 2.0 开源,Copyright 2026 TimAndy。

音频转码使用了少量第三方库,其名称、版本、许可证和版权声明见 NOTICE,许可证文本在 third_party/licenses/。其中 MP3 编码库 shine-mp3 使用 LGPL-2.0:它只适用于该库本身,本项目没有改为 LGPL;本项目源码公开,可替换该库后用 go build 重新构建。

About

Windows 上的消息键入工具:微信、飞书、企业微信扫码即用,消息键入到光标处或快捷键锁定的窗口,终端后台直写,不抢焦点、不占剪贴板。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages