豆包输入法词库导入工具 v1.0.0

攀爬蜗牛

# 豆包词库导入工具 · 使用说明

一个把**搜狗输入法用户词库**（或任意词表文件）导入**豆包输入法**的小工具。
自动找路径 → 自动备份 → 写入 → 读回自检 → 自动重启输入法引擎，全程一次点击。




## 一、最快用法（推荐）

1. 双击 `豆包词库导入工具.exe`
2. 界面里两行路径通常**已经自动填好**（① 搜狗词库 ② 豆包词库 `usr.dat`）
3. 先点 **「预览（不写入）」** 看看会新增多少条
4. 确认没问题，点 **「一键导入」**

完成后底部日志会写清楚：新增多少条、跳过多少条、备份在哪、引擎有没有重启成功。
一般 2～5 秒，全程不需要重启电脑。

> 界面三个按钮：`预览（不写入）`、`一键导入`、`编解码自检`。
> 两个勾选项默认都开着：写入前自动备份、写入后重启豆包输入法引擎。

---

## 二、命令行用法

不想用界面、或者想批量/脚本调用时：

| 命令 | 作用 |
|---|---|
| `豆包词库导入工具.exe --cli` | 自动找搜狗词库并导入 |
| `豆包词库导入工具.exe --cli --dry-run` | 只预览，不写任何文件 |
| `豆包词库导入工具.exe --cli --words 我的词表.txt` | 导入指定词表 |
| `豆包词库导入工具.exe --cli --list` | 显示自动检测到的路径 |
| `豆包词库导入工具.exe --cli --export 备份.txt` | 把豆包现有词库导出成文本 |
| `豆包词库导入工具.exe --self-test` | 编解码自检 |

常用附加参数：`--no-backup`（不备份）、`--no-restart`（不重启引擎）、`--out 新文件.dat`（结果写到新文件，不动原词库）。

在 cmd / PowerShell 里直接运行即可，中文输出正常。

---

## 三、支持哪些词表来源

| 来源 | 说明 |
|---|---|
| `sgim_gd_usr.bin` | 搜狗输入法用户词库，**自动检测**（`%LOCALAPPDATA%\..\LocalLow\SogouPY.users\<ID>\sgim_gd_usr.bin`） |
| `.txt` / `.csv` | 每行一个词，`#` 开头是注释；UTF-8 / ANSI / UTF-16 都能认；可选「词 + Tab + 首字母串」覆盖自动首字母 |
| `usr.dat` | 豆包自己的词库，可以拿来做两个词库之间的合并 |

中英混排、纯英文缩写、生僻字（如「曌翀骉麤」）都支持。

---

## 四、安全 / 回滚

- **每次写入前自动备份** 到同目录，文件名形如 `usr.dat.bak_20260911_141353`
- 写入用「先写临时文件再原子替换」，中途断电/关窗也不会写坏原词库
- 写完后会把整个词库读回来校验一遍，对不上会明确报错
- **回滚**：把对应时间的 `.bak_...` 文件复制回 `usr.dat`（覆盖），然后在工具里随便导入一次（或重启输入法）即可生效

豆包词库默认位置：`%APPDATA%\DoubaoIme\dict\usr.dat`

---

## 五、注意事项

- 免安装、不需要装 Python
- 电脑上要先装好**豆包输入法**（没有的话工具也能用，会自动新建一个空词库文件）
- 如果 Windows 弹「已保护你的电脑」/ 杀软报毒：这是 PyInstaller 打包的常见误报，选「更多信息 → 仍要运行」
- 只支持 Windows（依赖 Windows 的路径与输入法引擎）

---

## 六、常见问题

**Q：日志里出现「含不支持字符(U+XXXX)」？**
那个字不在豆包的拼音音节表里（例如「嗯」），无法编码，只能跳过。属正常现象，绝大多数词不受影响。

**Q：出现「词已存在」/「新增 0 条」？**
说明这些词早就在豆包词库里了，工具会跳过、不会重复写入，也不会覆盖成别人的词。

**Q：导入成功但打字打不出来？**
① 看日志里引擎是否重启成功；没有的话注销/重启一次系统即可（豆包引擎是首次输入时才读词库）。
② 用全拼输入，如 `cikudaorugongju` → 词库导入工具。

**Q：找不到搜狗词库？**
工具会在 `%LOCALAPPDATA%\..\LocalLow\SogouPY.users\*\` 下逐个找 `sgim_gd_usr.bin`，多个用户目录时取最大的那个；也可以点「浏览…」自己选文件。

**Q：词太多了塞不下？**
索引槽位和数据区会按需自动扩容（向上对齐），不用手动改参数。

---

## 七、已验证

- 对现有词库「读出 → 重新生成」，输出与原文件**字节级完全一致**（md5 `61699326cac2`），说明生成结果与原格式完全同构
- 真机实测：用工具写入的新词在豆包输入法里为**候选第 1 位**，例如 `ci'ku'dao'ru'gong'ju` → 词库导入工具、`ma'nong'xiao'zhu'shou` → 码农小助手


---

## 八、下载地址

https://wwbeg.lanzoub.com/iKzAv47ybnza
密码:52pj

huiyi2026

测试了 可以 但是 感觉很多没导入进去 是不是错觉   

zf7101

谢谢分享，谢谢

紫月青魂

请问这个网站上的搜狗细胞词库怎么导入到豆包呀？
https://pinyin.sogou.com/dict/