Skip to content

Customization

pfeiwu edited this page Jul 28, 2025 · 21 revisions

本页面主要针对 kagiroi 的功能及相关配置项作出说明

💡 提示

下面的内容如果涉及到配置项的修改,如果没有额外说明,都是在 kagiroi.schema.yaml 中进行的。你可以直接修改这个文件,更好的做法是创建一个 kagiroi.custom.yaml 通过patch的方式进行修改, 这样在更新时你的修改将得到保留

1.输入片假名

词库中存在片假名候选,不过和其他日语输入法一样,用户也可以通过快捷键将编辑区的文本变成片假名从实现快速输入

切换方式如下:

快捷键 模式 示例
Control+u 默认 平假名模式
Control+i 片假名 片假名模式
Control+o 半角片假名 半角片假名模式

2.切换布局

kagiroi中预置了三种布局可以切换

  1. romaji 罗马字,适配了训令式和赫本式的罗马字输入方式,与主流罗马字输入方式大体相同,除了下面两点改动
  • q可以输入长音
  • x可以输入拨音
  1. ansikana 适配ANSI键盘的假名布局 查看定义
  2. szromaji 作者自定义的一套扩展假名布局

如何切换?

找到配置文件的末尾 kagiroi/layout 配置项, 修改成希望的值即可

kagiroi:
  layout: ansikana

需要额外注意的是,ansikana布局比较特殊,它需要用到数字和某些标点符号键,即所谓的四段式布局,需要额外做以下额外调整

找到下方的 kagiroi/speller 配置项,将其配置成 __include: kagiroi:/alphabet/4_dan 以使kagiroi的speller能正确处理额外的按键

kagiroi:
  speller:
    # __include: kagiroi:/alphabet/3_dan
    # use 4_dan if you want to use ansikana or other layout that requires 4 rows of keys
    __include: kagiroi:/alphabet/4_dan

rime本身的speller也需要知道额外按键的存在,找到上方的 speller,将其配置成 __include: kagiroi:/alphabet/4_dan_hira

speller:
  # __include: kagiroi:/alphabet/3_dan_hira
  # use 4_dan_hira if you want to use ansikana or other layout that requires 4 rows of keys
  __include: kagiroi:/alphabet/4_dan_hira

由于数字和部分的符号键被占用,标点处理器的配置也需要做调整以让出键位,找到 punctuator,将其配置成 kagiroi:/alphabet/4_dan

punctuator:
  __patch:
    # - kagiroi:/punct/3_dan
    # use 4_dan if you want to use ansikana or other layout that requires 4 rows of keys
    - kagiroi:/punct/4_dan

这样我们就把kagiroi的键位布局调整成了ANSI键盘的假名布局

当然,如果不是用到4段式键盘的布局,只需要改layout的值就可以了

3.调整输出句子的数量

kagiroi支持输出多个句子候选 (即完整的匹配),默认设置成了2个,可以进行手动调整

找到文件中的 kagiroi/translator/size/size 配置项,将值修改成你希望输出的数目

kagiroi:
  translator:
    sentence: 
      # number of sentence candidates
      size: 1 

Clone this wiki locally