更新记录

1.0.0（2026-09-15） 下载此版本

• 首次发布：近体诗（五/七绝、五/七律）平仄教学检测
• 支持平水韵 / 中华新韵韵脚对照
• 支持自动匹配体式、「一三五不论」通融与严格模式
• 提供 Vue 教学组件与 analyzePoem / analyzeCouplet API
• 内置教学常用字库，支持 extendDict 扩展

平台兼容性

uni-app(4.45)

uni-app x(4.45)

zy-poem-meter（诗词格律教学助手）

近体诗 / 对联 教学辅助 工具：对照格律模板检查平仄，按平水韵或中华新韵检查韵脚，失律字标色并给出讲解。

定位：课堂教学与自学对照，不是审定或创作权威工具。多音字、通押、入声等请以教材与教师讲解为准。

能做什么

纯 JS，无原生依赖；可跑在 H5 / 小程序 / App（含鸿蒙 Next 的 uni-app 前端）。

安装

导入后目录：uni_modules/zy-poem-meter/

• 组件：components/zy-poem-meter/zy-poem-meter.vue
• API：utils/index.js
• 示例：example/PoemMeterDemo.vue

组件快速使用

<template>
  <zy-poem-meter v-model="text" rhyme-book="pingshui" @analyzed="onDone" />
</template>

<script>
export default {
  data() {
    return { text: '白日依山尽，黄河入海流。欲穷千里目，更上一层楼。' }
  },
  methods: {
    onDone(res) {
      console.log(res.pass, res.formName, res.pingze, res.rhyme)
    }
  }
}
</script>

easycom（uni_modules）下一般无需手动注册。

Props

事件

• analyzed：完整分析结果
• charClick：点击某字
• update:modelValue / input

API 使用

import {
  analyzePoem,
  analyzeCouplet,
  analyzeChar,
  extendDict,
  listForms
} from '@/uni_modules/zy-poem-meter/utils'

const res = analyzePoem('白日依山尽，黄河入海流。欲穷千里目，更上一层楼。', {
  rhymeBook: 'pingshui',
  strict: false
})

console.log(res.formName, res.pass)
console.log(res.pingze.errors)
console.log(res.rhyme.feet)

const dui = analyzeCouplet('海内存知己', '天涯若比邻')

extendDict([{ char: '鹳', tone: 'Z', ps: '', xy: 14 }])

analyzePoem 主要返回字段

• formName / formId：匹配到的体式
• pingze.lines[][]：逐字 { char, expectLabel, actualLabel, status, message }
  • status：ok | error | soft | unknown | poly | missing
• rhyme.feet：韵脚字与韵部
• tips[]：教学提示
• meta.disclaimer：免责声明

体式 id 一览

• 五绝：wujue-ze-buyun / wujue-ze-yun / wujue-ping-buyun / wujue-ping-yun
• 七绝：qijue-*（同上后缀）
• 五律：wulv-*
• 七律：qilv-*

用 listForms() 可列出全部。

教学说明

1. 二四分明：偶数字位（尤其韵脚）宜严格合律。
2. 一三五不论：默认不把奇数位失律判为硬错误；strict: true 可关闭。
3. 平水韵 vs 中华新韵：古近体课用平水韵；当代创作课可用中华新韵，二者结论可能不同。
4. 字库有限：常见教学用字已收录；生僻字会标「未知」，请 extendDict 或查教材。

版本

见 changelog.md