把微信、飞书、企业微信的消息键入 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 / 云端环境只能编译与静态检查,无法验证真实键盘输入。
- 三个来源:微信(私聊)、飞书(机器人单聊)、企业微信(智能机器人单聊),另有调试用的控制台输入
- 扫码即用:凭证扫码获得并自动保存,重启免扫码;飞书扫码时自动识别国内版或国际版 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
-
准备
TalkType.exe(不需要事先写配置文件,首次运行会自动生成settings.json,见「配置文件与工作目录」) -
运行程序,默认来源是微信:
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 秒后自动退出。中途退出也没关系,下次启动重新按此流程检查。网络暂时不通导致无法判断时,不会当作失效,该来源直接启动并自动重连。 -
首次运行会打印扫码链接并自动打开浏览器,用手机扫码确认(企业微信还要按提示给机器人发一次配对码)
-
把目标窗口切到前台并点中输入框,或按 Alt+. 锁定目标窗口、终端
-
在手机上给机器人发送文字,程序会自动键入并回车;发送图片、文件等附件时,程序会保存并粘贴(见「附件」)
程序常驻运行,登录成功后无需再次扫码。凭证失效或想换账号时:
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 按配置文件所在目录。
配置文件按这个顺序确定:
- 给了
--config(情形 A):用它,文件必须存在,不存在或是目录就报错退出。 - 没给
--config、给了--work-dir(情形 B):用<工作目录>\settings.json;不存在就在那里生成。 - 都没给(情形 C):依次找
<用户目录>\.talktype\settings.json、TalkType.exe所在目录下的settings.json、当前目录下的settings.json,用第一个存在的。都没有就在<用户目录>\.talktype\下生成;取不到用户目录时改在 exe 所在目录生成。找到的文件格式有错时直接报错,不会改用下一个位置。
自动生成的文件内容与默认配置一致:生成在用户目录下时 work_dir 写 "~/.talktype",生成在其他位置(情形 B、exe 目录)时写 ".",即工作目录就是配置文件所在目录。在情形 C 里生成失败只打印警告,改用内存里的默认配置继续运行;情形 B 生成失败直接报错退出。
工作目录按这个顺序确定:
--work-dir- 配置文件的
work_dir(空串或不写表示未指定) <用户目录>\.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指向旧目录后自行整理。 -
配置键改名:
旧键 新键 injectdeliveryreconnect.min_delay_msreconnect.min_delayreconnect.max_delay_msreconnect.max_delayinject.type_delay_msdelivery.type_delayinject.enter_delay_msdelivery.enter_delayinject.press_enterdelivery.press_enterinject.max_retriesdelivery.max_retriesack.max_acked_idsack.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 节。
- 消息始终键入到当前光标位置并回车,没有 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 的两倍时整份重写,只留最近的;进程中断导致最后一行没写完时,
读取时丢弃该行。删除这些文件只会失去去重记录,不影响登录。
用手机微信扫码登录 ClawBot,然后在微信里给 ClawBot 发文字。
- 收消息走 iLink 长轮询(
getupdates挂起约 35 秒) - 键入成功才推进并保存游标,失败时保留游标重放,按消息 ID 去重
- 创建时间早于本次启动的消息(离线期间积压的)只确认、不键入,日志打印
- 支持图片、语音、文件、视频附件
- 只接受扫码人本人的消息;凭证里没有扫码人时接受所有人(与官方插件一致)
- 会话过期(
-14)时自动清除凭证并重新扫码 - iLink 只支持私聊;ClawBot 名额通常只有一个,重复扫码可能顶掉之前的绑定
协议细节见 docs/wechat.md。
首次运行会打印一个飞书授权链接,并在 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。
首次运行会打印企业微信的扫码页面地址,并在 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。
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,这样电脑上双击就能播放,粘贴给对方后点开也能播放。
- 识别按文件头魔数,不看扩展名:微信 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 键都可以。按下到提示卡片出现,实测 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。
- 投递文字前把
\r\n、\r、\n、U+2028、U+2029 和 U+0085 各替换为delivery.newline;默认值为↵,连续换行不合并,首尾空格、其他字符和 Tab 保持不变。 - 文本按 UTF-16 码元拆分为
KEYEVENTF_UNICODE键事件(每个码元一次按下 + 一次抬起),制表符使用VK_TAB - 每 512 个事件一批调用
SendInput,中文、Emoji 无需剪贴板或输入法 - 可选等待后发送回车按下/抬起;这个回车只由
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/appinternal/cli只负责 cobra 参数解析、配置绑定和统一退出;不依赖internal/appinternal/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 重新构建。
