真实每天黎声树 · 技术博客
← 使用文档

词律助手 · 单机版(Windows)使用说明

写给:想离线用、或电脑上常备的人 · 对应 词律助手 v1.6.2 · 更新于 2026-09-30

这一篇讲 Windows 单机版(下载一个压缩包,解压双击即用,全程在本机跑、不联网)。 功能与网页版完全一样,看功能怎么用请读那一篇;本篇只讲「怎么装起来、怎么启动、出问题怎么办」。

一、它是什么

  • 把《词律助手》网页版原样搬到本机运行的一个 exe:双击打开,自动用默认浏览器显示界面。
  • 全程在本机跑,不联网、不需要账号、不弹防火墙授权框(只听 127.0.0.1,外网访问不到)。
  • 引擎与网页版是完全相同的一份 C++ 代码,界面也是同一份网页 —— 单机版只是给它换了个外壳。
  • 词谱数据(826 词牌 / 2304 体)随包附带。

二、下载与安装

  1. 到下载页下「词律助手 · 单机版」(Windows 10 / 11)。
  2. 把整个文件夹解压到一个固定位置(比如 D:\词律助手)。 ⚠️ 不要在压缩包里直接双击 exe —— 那样数据文件读不到。
  3. 双击「词律助手.exe」。 - 32 位系统(很少见)改用「词律助手-32位.exe」。
  4. 会弹出一个黑色控制台窗口 + 自动打开浏览器页面。

那个控制台窗口是程序的「电源开关」:用完直接关掉它,程序就退出了。别关掉之后还奇怪页面为什么打不开。

三、目录里都有什么

词律助手-单机版-1.6.2/
├── 词律助手.exe          ← 双击这个
├── 词律助手-32位.exe     ← 32 位系统用这个
├── 使用说明.txt          ← 就是本篇的文字版
└── data/                 ← 词谱与韵表数据(9 个 json)
    ├── cipai.json        词牌与体
    ├── cinames.json      词牌别名
    ├── yun_cilin.json    《词林正韵》韵表
    ├── yun_pingshui.json 《平水韵》韵表
    ├── shi_formats.json  律诗格式
    ├── fanqie.json       反切(中古音)
    ├── hanzi.json / hanzifj.json / renamemap.json

exe 与 data/ 必须在一起,移动位置时整个文件夹一起移。

四、命令行参数(一般用不到)

词律助手.exe              随机空闲端口 + 自动开浏览器
词律助手.exe 8090         指定端口
词律助手.exe --no-browser 启动但不自动开浏览器
词律助手.exe --version    看版本号

五、常见问题

Q:Windows 提示「已保护你的电脑」? 未签名程序的正常提示。点「更多信息 → 仍要运行」。杀毒软件误报同理,放行即可。

Q:浏览器没自动打开? 看控制台窗口里打印的那行 http://127.0.0.1:端口/,手动复制到浏览器打开即可。

Q:提示「数据加载失败」? 确认 exe 同级的 data/ 目录在,里面有 9 个 json。

Q:文件夹路径里有中文会不会出问题? 不会,已专门处理。

Q:端口被占用? 不填端口时程序会自动挑一个空闲端口,不会冲突。

Q:生成图片时没反应? 图片是本地生成的,稍等一两秒;浏览器会把它下载下来。

Q:怎么知道有没有新版? 打开界面时若有新版会提示;也可以到下载页看更新记录。

Q:手机上能用吗? 单机版是 Windows 程序。手机请用网页版(建议添加到主屏幕),或用 Android 版(见下载页)。

六、这一版的已知边界(测试版)

  • 数据文件(data/)放在 exe 同级目录,还没有打进 exe 里 —— 所以必须整个文件夹一起挪。
  • 引擎有 3 处与原版单机版的差异仍在核实(「呐」字判定 / ruOK 参数 / 匹配不硬凑)。

七、版本更新记录

最新版本的更新内容见下载页的「更新记录」。单机版更新需要重新下载压缩包覆盖(网页版刷新即可)。


相关:词律助手 · 网页版 使用说明 · 下载页 · 返回使用文档目录

← 返回使用文档目录