词律助手 · 单机版 1.6.2
================================================

一、这是什么
  把《词律助手》网页版原样搬到本机运行的一个 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 给句子找词牌（匹配）
    手里有几个好句子，不知道能写成哪个词牌？顶部「匹配」=>
    把句子贴进去（一句一行，用逗号句号隔开也行）=> 点「找词牌」。

    它会找**能原样容纳这些句子**的词牌——你的字一个都不用改；结果分两块：
      左边是候选（显示「落位 8/8 句 · 补写 0 句」，排在前面的就是最省事的）
      右边是落位图：第几句 → 词牌的第几个句位，每行都给出该句位的平仄谱
    空着的句位标「（待补写）」，旁边灰色小字是该句位的例词，照着谱补就行。
    选中合适的候选，点「拿去创作 →」会带着词牌和你已有的句子跳到创作页接着写。

    上面可以筛：篇幅（小令 14~58 / 中调 59~90 / 长调 91+ 或自填区间）、韵（平韵/仄韵/换押韵）、
    句数；「高级选项」里还有：允许舍句、允许补句、以入代平有效、常用词牌优先、韵脚疏密度。
    默认全部不限，并且**默认不许舍句**（你的句子一个字都不丢）；实在找不到再看「允许舍句」。

  2.5 出图分享
    校验或创作出结果后，结果卡片顶部有一行工具：
      「落款/名章」输入框：填自己的名字（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.6.2  2026-09-22  四处修正
    · 【重要】自动匹配修好了：以前只要有一个字出律，整首词就匹配不上
      （校验能给 95 分、匹配却说全库找不到一首）。现在出律一两个字照样匹配得上，
      最多给出 5 个候选供挑选
    · 谱行末尾的韵脚标记由 ●1 ●2 改成 韵1 韵2 —— 手机上实心点和平仄符号大小一样，容易看错
    · 结果卡片的用韵分析改成每个韵脚一行，直接写出韵脚字和它所属的韵部
    · 笺图 / 词笺的分列改成各行均分：以前八句七言会排成「上面七句、下面只剩一句」，
      现在是四句加四句

  v1.6.1  2026-09-18  出图瘦身：默认存清晰小图
    · 生成的词笺图、平仄图、笺图默认存成 1080 宽的清晰小图（约 100~300 KB）。
      原来一张是 1568 宽的无损 PNG（0.45~1.03 MB），手机上发微信偏重
    · 要打印、存档，预览层里点「存原图」，可存全尺寸 PNG（1568 宽）
    · 文件名跟着格式走：小图存 .jpg，原图存 .png

  v1.6.0  2026-09-18  署名、笺图与笺纸
    · 词笺图与平仄图可以署款了：作者名最多 12 字、竖排写在正文末尾；
      名章另填、最多 4 字。一直缺输入框的「题」也放出来了，写在词牌名下方
    · 【新页】「笺图」：不校验格律，把文章、题记、诗句排成竖排笺图（正文最多 300 字）。
      一进页面就有成品，改字、换纸、换字体即时预览
    · 九款笺纸可选：素笺 / 宣纸 / 洒金 / 朱丝栏 / 洒金朱丝栏 / 松花 / 桃红 / 浅云
      （笺图页另有做旧古笺），默认宣纸。纸纹是画出来的，同一首诗每次出图一模一样；
      「换一张纸」可换纹理
    · 出图改成先预览再保存，预览里就能「换一张纸」，不用关掉重来
    · 标点按中文竖排的规矩排：句末标点挤压半格、贴在前一字的右下角。
      以前每个句号独占一格，几个句号会在正下方排成一条孤立的点行
    · 长词折行时每一行都让出词牌/题那两栏，整块正文右侧留一条整齐的空边
    · 首页新增「笺图」入口卡

  v1.5.4  2026-09-18  新增「律诗校验」
    · 新增「律诗校验」页：五言/七言 · 绝句/律诗/排律，逐字对谱，看平仄与押韵
    · 谱表取自原版《绝句分析助手》源码，28 种格式（平起/仄起 × 入韵/不入韵 × 平韵/仄韵）逐字一致
    · 一三五不论、二四六分明；偶句必押韵、韵脚须同部（词林正韵、平水韵两把尺子，任一成立即可）
    · 提示：出韵点名到字，另有孤平（仄平仄仄平）、三平尾的提醒

  v1.5.1  2026-09-18  韵组：看得见哪几句要押同一个韵
    · 词牌库新增「韵组」：每个词体都带着——有几组韵、每组是平韵还是仄韵、每组是哪几个韵脚
    · 同一段里的韵脚成一组。《浣溪沙》「前段三句三平韵，后段三句两平韵」= 两组，
      前后段各用各的韵也算对（以前会被判「不同韵」）
    · 谱面上韵脚带彩点：同色 = 要押同一个韵；多组时点后标组号（第 1 组、第 2 组…）
    · 谱面配色改中性：●仄 ○平 ◎应仄可平 ⊙应平可仄 统一墨色。
      红只表示「与谱不合」，紫红只表示「用韵不合」

  v1.5.0  2026-09-18  韵脚跑部会点名了
    · 校验结果多一行「用韵」：每个韵脚字属于哪一部都列出来，并说明全篇（或各段）用的韵
    · 同一段里的韵脚必须同属一个韵——跑部的那几个字标紫红，并写明它属于哪一部
    · 「同一个韵」按两把尺子量：①《词林正韵》同一部；②《平水韵》同一韵
      （词林正韵把十灰、九佳、十三元拆成两半，平水韵里本是一韵，
        如晏殊《浣溪沙》的杯/台/回/来/徊 都是「十灰」，按第二把尺子不算错）
    · 本来就换韵的词按段各自判：《菩萨蛮》两仄两平、《清平乐》前段仄韵后段平韵、
      《西江月》平韵叶韵——前后段各押一韵不算错

  v1.4.1  2026-09-17  找词牌更准了
    · 修正落位图里多音字显示成「?」（现在与校验页一致，按该句位的平仄谱显示）
    · 排序改按「已写进去的字 − 放不进的字 − 还要补的字」，不再把要补两三百字的大曲排前面
    · 候选里直接显示完成度（你写的字占该词牌总字数的百分比）
    · 默认允许舍句（目标是为大多数句子找到词牌），结果里写明有几句放不进

  v1.4.1  2026-09-17  修正「共 0 体」
    · 用「自动匹配」认出词牌后，结果头部原显示「共 0 体」，现在正确显示该词牌的全部体数
    · 别名之间补上分隔号（原来挤成一串）

  v1.4.1  2026-09-17  为句子找词牌
    · 新增「匹配」页：有几个句子，帮你找能原样装进去的词牌——你的字一个字都不用改
    · 自动看落位：哪几句已就位、还差哪几句；空着的句位显示词谱与例词，照着补就行
    · 候选按「落位多、补写少、常用词牌优先」排
    · 可按篇幅（小令/中调/长调）、韵（平/仄/换押韵）、句数筛选，也能自填字数区间
    · 「拿去创作」一键把词牌和已有的句子带进创作页接着写

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

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

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