在同一台 Mac 上,把 Typeless 的账号数据从一个账号迁移到另一个账号。
Typeless 是一款基于 Electron 的语音输入工具,官方没有提供数据导出或账号迁移功能。这个工具帮你解决这个问题。
| 数据 | 方式 | 说明 |
|---|---|---|
| 历史记录 | SQLite user_id 替换 |
全部听写记录 |
| 录音文件 | 文件复制 | Recordings/ 下的 .ogg 文件 |
| 应用设置 | 文件复制 | 快捷键、麦克风配置等 |
| 自定义词典 | API 签名请求 | 云端存储,本地没有副本 |
| 机器码 | 缓存与 Keychain 重置 | 让新账号重新生成设备 ID,模拟真实新设备环境 |
- macOS(Apple Silicon 和 Intel Mac 均支持)
- Python 3.9+
- Typeless 桌面应用已安装
sqlite3CLI(macOS 自带)
安装 Python 依赖:
pip install requests下载 DMG 安装包,打开即用,无需安装任何依赖。
或者从源码运行:
pip install flet requests
python3 gui.pygit clone https://github.com/mercy719/typeless-migrator.git
cd typeless-migrator
pip install requests
./run.sh两种方式功能完全一样:自动检查依赖、备份数据、提示你切换账号、然后完成迁移。全程只需要你在切换账号时手动操作一下。
如果你更喜欢自己一步步来:
登录旧账号的状态下运行:
./backup.sh会在 ~/Backups/typeless/ 下创建一个带时间戳的备份目录,包含数据库、录音、配置文件。
仍然在旧账号登录状态下:
python3 dictionary.py backup词典数据会保存到备份目录的 dictionary_backup.json。
- 打开 Typeless,登出旧账号
- 登录新账号
- 等应用加载完成
./migrate.sh ~/Backups/typeless/<时间戳>会把历史记录、录音、设置迁移到新账号,并重置 Typeless 机器码。
python3 dictionary.py import ~/Backups/typeless/<时间戳>/dictionary_backup.jsonTypeless 的本地数据在 ~/Library/Application Support/Typeless/:
typeless.db— SQLite 数据库,history/history_v2等历史表的每行都有user_id字段Recordings/— 录音的.ogg文件app-settings.json— 快捷键、麦克风等设置app-storage.json— 账号状态和部分本地缓存user-data.json— 通过electron-store加密的认证 token
迁移原理是把所有历史表里的 user_id 全部替换成新账号的 user_id。
迁移本地数据后,工具会在重启 Typeless 前清理设备 ID:
~/Library/Application Support/now.typeless.desktop/device.cacheapp-storage.json里的TYPELESS_DEVICE_ID- Keychain 中已知的 Typeless device identifier 项
这样新账号启动后会重新生成机器码,更接近真实换设备/重新安装后的环境。迁移前会把当前 app-storage.json 和 device.cache 一起放进安全备份目录。
词典数据只存在服务器上,本地没有任何文件。dictionary.py 的工作流程:
- 解密
user-data.json提取认证 token(双重 PBKDF2 + AES-256-CBC) - 生成 API 安全签名头,复现应用本身的签名协议:
- HMAC-SHA1 请求签名
- CryptoJS 兼容的 AES 加密生成
X-Authorization头
- 调用 Typeless API(
/user/dictionary/list、/user/dictionary/add)
user-data.json 使用 Electron 的 electron-store(conf v13)加密:
加密密钥 = PBKDF2-SHA256(SHA256("darwin-{arch}").hex() + "Typeless", "typeless-user-service", 10000, 32)
逐值密钥 = PBKDF2-SHA512(加密密钥, IV.toString('utf-8'), 10000, 32)
文件格式 = [16字节 IV] + ':' + [AES-256-CBC 密文]
其中 arch 为 arm64(Apple Silicon)或 x64(Intel Mac),自动检测。
typeless-migrator/
├── gui.py # 图形界面(推荐!)
├── run.sh # 命令行交互式引导脚本
├── backup.sh # 备份本地数据(数据库、录音、配置)
├── migrate.sh # 迁移本地数据到新账号
├── dictionary.py # 备份和导入词典(云端 API)
├── crypto_utils.py # 加密/签名工具库
└── README.md
- 仅支持 macOS(数据路径是 macOS 特有的)
- 已验证适配 Typeless v1.4.1 和 v1.7.0;如果 Typeless 后续更新版本可能需要重新验证 API 签名和数据库结构
- 需要安装 Typeless 应用
- 如果你用了代理(如 Clash),设置环境变量
HTTPS_PROXY
MIT
