词律助手 · 单机版 1.2.0（测试版）
================================================

一、这是什么
  把《词律助手》网页版原样搬到本机运行的一个 exe：
  双击打开，自动用默认浏览器显示界面，全程在本机跑，不联网、不需要任何账号。

  · 词牌查询：826 词牌 / 2304 体（钱建文先生校录《钦定词谱》）
  · 词作校验：逐字标平仄、查出律、提示韵部（词林正韵）
  · 依谱填词：逐字填格 / 直写两种写法，边写边看合不合律，出律的字标红
  · 成果图：一键导出「词笺图」「平仄图」，可署自己的名章，方便分享
  · 智能匹配：不写词牌名，直接贴词，自动认词牌

二、怎么用

  2.1 启动
    1) 把整个文件夹解压到任意位置（不要直接在压缩包里双击 exe）
    2) 双击「词律助手.exe」
    3) 会弹出一个黑色控制台窗口 + 自动打开浏览器页面
       —— 控制台窗口就是程序的“电源开关”，用完关掉它就退出了。
    4) 32 位系统请改用「词律助手-32位.exe」

    命令行参数（一般用不到）：
      词律助手.exe              随机空闲端口 + 自动开浏览器
      词律助手.exe 8090         指定端口
      词律助手.exe --no-browser 启动但不自动开浏览器
      词律助手.exe --version    看版本号

  2.2 校验一首词
    首页「词体输入」=> 填词牌名（支持别名、繁体）=> 粘贴正文 => 点「开始校验」。
    结果按句给出：词句 / 平仄谱 / 实际平仄 / 韵部，出律的位置标红并给出分数。
    忘了词牌名就选「自动匹配」，只贴正文，程序自己认词牌。

  2.3 自己写一首（创作）
    顶部「创作」=> 先选词牌（点常用词牌，或输入**完整**词牌名，如「水调歌头」）=> 选一个体。
    然后有两种写法，在卡片顶部随时切换：

    · 逐字填格：一格一字，适合边想边填。格子即时变色：
        绿 = 与谱相合    红 = 出律    灰 = 可平可仄
      韵句右侧显示该字所属韵部。

    · 直写（左谱右词）：整首直接写进去（也可以从别处粘贴），不用一格一格填。
        按格律自动分行，每句一行；出律的字**就地标红**，一眼看得出哪个字要改。
        左边是平仄谱、右边是你写的字，逐行对齐；每行末尾显示该韵脚所属韵部。
        左边谱里带点的是韵句。

    两种都可以中途退出，草稿自动存在浏览器里，下次进来接着写。

  2.4 出图分享
    校验或创作出结果后，结果卡片顶部有一行工具：
      「落款/名章」输入框：填自己的名字（1~6 字），会盖在成果图右下角；
                            留空则只盖「合律」印。
      「字体」：楷 / 宋 / 黑三选一。
      「生成词笺图」：竖排词文，韵脚点朱，落款 + 名章，适合分享或打印。
      「生成平仄图」：逐句格律对照表，标出出律处。
      「复制结果」：把校验结果整段复制成文字。
    注意：只有 100 分（完全合律）才会盖右上角的「合律」引首章。

三、为什么是「本地服务 + 浏览器界面」
  引擎与网页版是完全相同的一份 C++ 代码（golden 对照 11/11 通过），
  界面也是同一份网页 —— 单机版只是给它换了个外壳：
  跑在你自己的电脑上、只听 127.0.0.1（外网访问不到，也不会弹防火墙授权框）。

四、常见问题
  · 文件夹里有中文路径会不会出问题？—— 不会，已专门处理。
  · 浏览器没自动打开？—— 手动访问控制台里打印的 http://127.0.0.1:端口/ 即可。
  · 提示“数据加载失败”？—— 确认 exe 同级的 data/ 目录在，里面有 9 个 json。
  · Windows 提示“已保护你的电脑”？—— 未签名程序的正常提示，点「更多信息 → 仍要运行」。
  · 端口被占用？—— 不填端口时自动挑空闲端口，不会冲突。
  · 生成图片时没反应？—— 图片是本地生成的，稍等一两秒；浏览器会把它下载下来。
  · 怎么知道有没有新版？—— 打开界面若有新版会提示；也可到 https://google73.com/download/ 看。

五、数据与致谢
  词谱数据由钱建文先生校录《钦定词谱》（卷一到卷四十），依《词林正韵》标注韵部；
  例词均为公版名作。本工具以学术研究姿态呈现，欢迎指正校录疏漏。

六、本版已知边界（测试版）
  · 数据文件（data/）放在 exe 同级目录，还没有打进 exe 里
  · 引擎有 3 处与原版单机版的差异仍在核实（「呐」字判定 / ruOK 参数 / 匹配不硬凑）

七、更新记录（最新的在最上面）
  v1.2.0  2026-09-17  直写模式
    · 创作页新增「直写」模式：整首直接写进去（也可以粘贴），不用一个字一个格子填
    · 直写模式下按格律自动分行（每句一行），出律的字就地标红
    · 左边是平仄谱、右边是你写的字，逐行对齐；行尾显示韵脚所属韵部
    · 两种模式随时切换（逐字填格 / 直写），选过哪个会记住

  v1.1.0  2026-09-17  创作与成果图
    · 新增「创作 · 依谱填词」：选词牌，对着平仄谱逐句填字，实时看哪一字与谱不合、韵脚是否同部
    · 新增成果图：一键生成「词笺图」（竖排词文、韵脚点朱、可署自己的名章）与「平仄图」
    · 校验结果可一键复制
    · 首页示例增加到 3 首；词牌库增加常用词牌快捷键；格律卡可一键跳到创作
    · 修正平仄符号大小不一致的问题（手机上曾出现实心点比空心点小）
    · 新增「下载与更新」入口，打开时会检查是否有新版本

  v1.0.0  2026-09-16  首个版本
    · 词作校验：逐句平仄对照、出律位置、韵部（词林正韵）
    · 词牌库：826 词牌 / 2304 体格律查询（支持别名与繁体）
    · 智能匹配：只贴正文也能判断词牌
