kana-ascii 用于在终端里学习日语假名。它由 npm 包与配套技能组成:包负责把假名渲染成点阵 ASCII 图形,技能在图形之上叠加教学,包括笔顺、记忆口诀、练习和上下文。
主要能力方面,包支持渲染单个假名、按顺序渲染多个假名、切换片假名模式,以及把罗马字转换为假名并显示覆盖率。罗马字输入约定为小写转平假名、大写转片假名,转换由 hepburn 完成。它还提供编程 API,如 render、lookup、renderWord、renderAll、list。
使用方式举例:一次性运行可用 npx kana-ascii あ,npx kana-ascii aiueo 会依次渲染あいうえお,npx kana-ascii AIUEO 为片假名模式,npx kana-ascii konnichiwa 会转换罗马字并显示覆盖率。全局安装可运行 npm install -g kana-ascii,之后可用 kana-ascii --list 与 kana-ascii --all。
技能的使用流程是:展示学习者可自行运行的命令、以点阵系统内联绘制该假名、用 [1][2] 标签和笔画类型讲笔顺、给出鲜明易记的口诀、再通过提问与描摹进行练习,直到学习者能脱离提示描述该字。触发场景包括要求绘制某假名、使用 kana ascii 或 ascii mode、用户已在用该包,以及课程中引入新假名时。
点阵系统为 13 宽 × 9 高的点画布,笔画字符包括 -、|、/、\、(、)、~、^、*、+,标签用 [1][2][3] 而非带圈数字,以保证等宽显示。
限制方面,npm 包 v0.1.0 仅覆盖平假名与片假名的元音行共 10 个字符,更多字符每周补充,可用 npx kana-ascii --list 查看当前覆盖范围。