Skip to content

About

Backup and migrate Typeless account data (history, audio, settings, dictionary) between accounts

Resources

Stars

11 stars

Watchers

1 watching

Forks

Repository files navigation

Typeless Migrator

在同一台 Mac 上,把 Typeless 的账号数据从一个账号迁移到另一个账号。

Typeless 是一款基于 Electron 的语音输入工具,官方没有提供数据导出或账号迁移功能。这个工具帮你解决这个问题。

Typeless Migrator GUI

能迁移什么

数据 方式 说明
历史记录 SQLite user_id 替换 全部听写记录
录音文件 文件复制 Recordings/ 下的 .ogg 文件
应用设置 文件复制 快捷键、麦克风配置等
自定义词典 API 签名请求 云端存储,本地没有副本
机器码 缓存与 Keychain 重置 让新账号重新生成设备 ID,模拟真实新设备环境

环境要求

  • macOS(Apple Silicon 和 Intel Mac 均支持)
  • Python 3.9+
  • Typeless 桌面应用已安装
  • sqlite3 CLI(macOS 自带)

安装 Python 依赖:

pip install requests

快速开始

方式一:图形界面(推荐)

下载 DMG 安装包,打开即用,无需安装任何依赖。

或者从源码运行:

pip install flet requests
python3 gui.py

方式二:命令行

git clone https://github.com/mercy719/typeless-migrator.git
cd typeless-migrator
pip install requests
./run.sh

两种方式功能完全一样:自动检查依赖、备份数据、提示你切换账号、然后完成迁移。全程只需要你在切换账号时手动操作一下。

手动使用

如果你更喜欢自己一步步来:

1. 备份当前账号

登录旧账号的状态下运行:

./backup.sh

会在 ~/Backups/typeless/ 下创建一个带时间戳的备份目录,包含数据库、录音、配置文件。

2. 备份词典(云端数据)

仍然在旧账号登录状态下:

python3 dictionary.py backup

词典数据会保存到备份目录的 dictionary_backup.json。

3. 切换账号

  1. 打开 Typeless,登出旧账号
  2. 登录新账号
  3. 等应用加载完成

4. 迁移本地数据

./migrate.sh ~/Backups/typeless/<时间戳>

会把历史记录、录音、设置迁移到新账号,并重置 Typeless 机器码。

5. 导入词典

python3 dictionary.py import ~/Backups/typeless/<时间戳>/dictionary_backup.json

原理

本地数据

Typeless 的本地数据在 ~/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.cache
  • app-storage.json 里的 TYPELESS_DEVICE_ID
  • Keychain 中已知的 Typeless device identifier 项

这样新账号启动后会重新生成机器码,更接近真实换设备/重新安装后的环境。迁移前会把当前 app-storage.json 和 device.cache 一起放进安全备份目录。

词典(纯云端)

词典数据只存在服务器上,本地没有任何文件。dictionary.py 的工作流程:

  1. 解密 user-data.json 提取认证 token(双重 PBKDF2 + AES-256-CBC)
  2. 生成 API 安全签名头,复现应用本身的签名协议:
    • HMAC-SHA1 请求签名
    • CryptoJS 兼容的 AES 加密生成 X-Authorization 头
  3. 调用 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

License

MIT

About

Backup and migrate Typeless account data (history, audio, settings, dictionary) between accounts

Resources

Stars

11 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages