Skip to content

Customization

pfeiwu edited this page Jan 25, 2026 · 21 revisions

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

💡 提示

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

1.输入片假名

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

切换方式如下:

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

2.切换布局

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

  1. romaji 罗马字,适配了训令式和赫本式的罗马字输入方式,额外增加了 q键 作长音 ,以释放 -/= 键作翻页之用
  2. ansikana 适配ANSI键盘的假名布局 查看定义
  3. 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/sentence/size 配置项,将值修改成你希望输出的数目

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

4.添加自定义短语

你可以在 kagiroi_custom_phrases.txt处添加自定义短语,自定义短语将优先输出

如果你是通过 plum 安装,你需要自己创建这个文件

# Rime table
# coding: utf-8
#@db/db_name	kagiroi_custom_phrases
#@db/db_type	tabledb

# Add your own words here, format:
# Word{Tab}Pronounciation(in hiragana)
中州韻	ちゅうしゅういん
小狼毫	うぃーぜる
鼠鬚管	すくわーる

5.義訓

kagiroi本身就会将用户上屏的词添加到userdict中,这种特性一般称作"自动造词"

但是在日语输入中也有自动造词无法覆盖的场景

例如『由崎星空』这个词,读作『ゆざきなさ』,『ゆざき』的部分还好,『星空』通常是读作『ほしぞら』,而不是『なさ』,所以通过自动造词是无法造出这个词的,而这就是『義訓』的适用场景

下面我们来通过『義訓』功能添加这个词汇

先打这个词的发音部分 『ゆざきなさ』

義訓示例1

输入;,按空格确认读音,此时出现『義訓』的提示

義訓示例2

继续输入能将『由崎星空』这四个字打出来的发音,例如『ゆざきほしぞら』

義訓示例3

按空格进入选重环节

義訓示例4

确认上屏,完成添加

再次输入 『ゆざきなさ』,可以发现该词已经进入了候选列表

義訓示例5

如果想要删除『義訓』添加的词,可以通过Rime默认的方式,即将高亮块移动到想要删除的词上面,按 Control+kControl+Delete

Clone this wiki locally