桌面端完整使用手册：Windows 与 Linux

一、这份手册适用于什么版本

本手册按 0.1.86 Windows 与 Linux 公开版本编写。Windows 使用码圈自己的候选窗和设置中心；Linux 通过 Fcitx4、Fcitx5 或 IBus 接入桌面。输入功能相近不代表菜单、皮肤和鼠标操作完全相同，文中会注明区别。

设置页一般使用「应用／保存」确认修改；Linux 按当前页的保存提示操作。安装包升级与普通设置修改不同：Windows 更新后重开正在输入的应用，Linux 更新后重启电脑，避免继续使用旧进程。

二、Windows 安装、启用和升级

1. 01

   下载安装

   从官网选择 Windows 安装程序，按提示安装。已有用户直接覆盖安装，通常不需要先卸载。安装前可导出重要个人词库，系统要求管理员确认时核对文件来源。

2. 02

   选择码圈

   安装完成后在可编辑窗口按 Win＋空格，从系统输入法列表选择码圈。任务栏语言／输入指示器也可切换。若找不到，先关闭重开应用，按安装提示重启后再检查。

3. 03

   打开设置

   使用码圈任务栏状态图标的功能设置入口，或在码圈生效的输入框按 Ctrl＋/。开始菜单中的码圈设置也可用于管理方案。

4. 04

   验证

   先在新打开的记事本用全拼 nihao 选「你好」，再切自己的形码输入一个已知字词。不要只在已有的旧聊天进程里判断新版是否生效。

5. 05

   日常更新

   基本设置可检查更新、设置自动更新。也可从官网重新下载安装。即使版本号相同，公告注明补充包时也需重新下载；不要只凭文件名判断是不是新包。

是否支持当前 Windows 版本及处理器架构，以下载页对应安装包说明为准。不要把 Linux 包、Android APK 或码表转换工具当成 Windows 输入法安装器。

• 下载正式安装包

三、Linux 先认框架，再选安装包

在日常登录用户的桌面终端检查，而不是只在 SSH 或 root 会话判断。下面哪条进程查询有结果，就优先核对对应框架；没有结果时先检查系统是否启动了输入法。

uname -m
pgrep -a -u "$(id -u)" -x fcitx
pgrep -a -u "$(id -u)" -x fcitx5
pgrep -a -u "$(id -u)" -x ibus-daemon

可使用同一个官方安装脚本先检测，再安装。先下载文件，可自行查看内容；--dry-run 只显示检测和计划。框架不明确时脚本停止，不会自动替换系统输入法框架。

curl -fsSLo install-maquan-linux.sh https://maquan.app/install-maquan-linux.sh
bash install-maquan-linux.sh --dry-run
bash install-maquan-linux.sh

已明确框架时，在最后一条命令后加 --framework fcitx4、--framework fcitx5 或 --framework ibus，三选一。手动下载 DEB 后用 sudo apt install ./文件名.deb；RPM 用 sudo dnf install ./文件名.rpm，让包管理器检查依赖。不要同时安装三套码圈前端，不要强制忽略依赖。

当前包要求 glibc 至少 2.28；Fcitx4 至少 4.2.9.6，Fcitx5 至少 5.0.21，其他依赖由安装工具检查。满足最低版本不代表每个国产系统镜像都已实机认证；遇到缺库不要手工替换系统 libc，也不要删除系统输入法来迁就安装包。

• 国产系统逐版本对照、具体包名与安装命令
• Linux 下载区

四、Linux 安装之后：添加输入源与打开设置

1. 01

   重启

   安装或升级完成后重启电脑，再进入日常桌面用户会话。仅显示软件包安装成功，不代表框架已经重新加载。

2. 02

   Fcitx4 添加

   从托盘输入法图标打开配置，或运行 fcitx-configtool／fcitx-config-gtk3。点击添加，必要时取消「只显示当前语言」，搜索码圈并加入。国产桌面的控制中心也可能提供入口。

3. 03

   Fcitx5 添加

   打开 fcitx5-configtool 或托盘配置，把码圈输入法加入当前输入法列表，应用后用系统已有的切换键选中。

4. 04

   IBus 添加

   在桌面设置的键盘／输入源中添加中文下的码圈，或使用 ibus-setup；具体名字随 GNOME 等桌面环境变化。

5. 05

   码圈自身设置

   从应用菜单打开码圈设置，或运行 jdime-settings；个人词库页可用 jdime-settings --dict。Fcitx5／IBus 状态菜单也有设置入口，Fcitx4 状态菜单较少时用独立设置程序。

系统切换输入法的快捷键由桌面或框架管理，不应把 Ctrl＋空格、Super＋空格等当成码圈统一固定键。Wayland 下候选位置和快捷键也受应用、桌面及框架影响。先在普通文本编辑器测试，再检查特定应用。

五、初次设置与三种中文输入方式

1. 01

   选择输入模式

   Windows 在「基本设置」，Linux 在「输入模式」选择仅拼音、仅形码或形码＋拼音。Windows 还可选择纯英文；日常临时输入英文通常使用中英切换即可。

2. 02

   分别选方案

   选择自己要用的形码表，以及全拼或某套双拼。选择拼音方案不意味着形码码表被删除；它们保存不同用途的选择。

3. 03

   应用并试打

   点应用／保存，再回输入框。全拼先试 nihao；双拼按所选键位试一个熟悉词；形码先试原表单字和词组。暂时不同时开启全部学习和自动上屏开关。

仅形码适合按原表稳定输入；仅拼音适合全拼或双拼；形码＋拼音提供混合使用和临时切换能力，按键冲突时需结合快捷键设置判断。不会拆字时可用 Alt＋Z 反查，不必为了查一个字重新导入码表。

六、日常打字、选词、翻页与中英标点

字母输入编码，候选编号对应当前页。通常空格确认首选，数字选择相应候选；退格修改编码，Esc 取消当前输入。回车行为可受设置或应用影响，不要把回车与空格选词混用。完成选词前看到的下划线编码仍属于输入中的内容。

某个按键没有按预想翻页或输出标点，先看是否还在组字、是否进入快符／反查，以及这个键是否同时用于编码、辅助码或候选选择。不要把同一个键同时安排给多个常用动作。

七、Ctrl＋~、Ctrl＋1、Ctrl＋2 快捷菜单

新配置默认正常形码模式、辅助码关闭。菜单打开后按数字快选，Esc 取消；Windows、Fcitx5／IBus 还可使用方向键和回车，Fcitx4 使用数字快选。先确认或取消正在输入的内容，再切方案或模式。

Windows 菜单优先跟随文字光标，应用没有提供光标位置时回退到鼠标位置；Linux 位置由框架和应用提供，不能保证所有桌面都采用同样的回退行为。Windows 与 Fcitx5／IBus 的状态区另有独立辅助码菜单，在检字范围附近；Fcitx4 未提供全部同样入口，用快捷键或设置中心。

Ctrl＋~ 指键盘反引号／波浪号所在键的组合，具体布局不同可能影响识别。若被编辑器、终端或远程桌面占用，到快捷键设置重新绑定，再在普通本机输入框测试。

八、Alt＋Z 编码反查与临时拼音

1. 01

   先选要查的方案

   切到目标形码表，在可编辑窗口选中码圈并保持中文状态。

2. 02

   进入反查

   按 Alt＋Z，看到反查状态后输入全拼，例如 ni。找到「你」，查看候选旁的当前形码提示，而不是输入五笔字母去查拼音。

3. 03

   退出

   按 Esc 退出反查，回原形码输入。换了码表，反查显示的编码也可能不同。

4. 04

   冲突时改键

   Alt＋Z 是默认值，不是必须固定。应用占用时，到快捷键设置修改「编码反查」。不要改回常被应用用于撤销的 Ctrl＋Z，除非明确接受冲突。

临时拼音／形码＋拼音切换是另一类功能，用于临时按拼音输入；可设置手动切回，或上屏若干次后回到形码。反查的重点是看编码，不等同于把日常输入方案永久切成全拼。

Windows 更新后，旧记事本、聊天软件可能仍使用旧组件。先关闭并重新打开目标应用，必要时重启，然后再测试反查；看到设置里已改键不能证明旧应用已加载新包。Linux 也要确认真正选中码圈，而不是其他输入法。

九、全拼、双拼、简拼与显示设置

全拼可以逐字、逐词或连句输入，不必每个音节都按空格。双拼使用所选方案的声韵键位；例如自然码「你好」输入 nihk，其他双拼方案请使用对应键位。切换双拼不会各建一份拼音个人词库。

自定义双拼在方案管理中创建、导入或编辑，先试打检查转换结果，再保存并选用。双拼方案文件定义键位，形码表定义字词编码；选错导入入口不能自动把两类文件互相转换。

十、双拼直接／间接辅助码

1. 01

   找到设置

   Windows 在拼音设置下方，Linux 在拼音页选择辅助码表、辅助方式，并开启辅助码。仅双拼生效，默认关闭。

2. 02

   直接方式

   每个两键音节后可补 0、1、2 位辅码，句中自由混用，不用引导符。自然码双拼＋自然码辅码的「你好」示例：nihk、nirhk、nirehknz。不要将这个示例用于另一张辅码表。

3. 03

   间接方式

   音节后按设定引导符，再补 1～2 位辅码。Windows 默认斜杠，其他端或个人设置可能不同；以页面实际值为准。斜杠时 ni/re 对应自然码辅码的「你」。

4. 04

   继续下个音节

   间接方式补一位辅码后用单引号分隔下一音节；两位后可直接继续。例如引导符为斜杠时 ni/r'hk/nz，可输入自然码示例「你好」。

5. 05

   快速切换

   使用 Ctrl＋1 按 1／2／3 关闭或选择方式。要更换辅码表，仍需回拼音设置，不是在小菜单里选双拼方案。

可选内置辅助码表，也可导入自己的 UTF-8 TSV：一字＋Tab＋1～2 位小写 a-z，同字多码写多行，最大 4 MiB。Windows 可先导出模板；导入后点应用／保存，核对启用状态。迁移到另一设备时保留自定义文件，不要只复制开关设置。

辅助码、形码本身的字根编码和快符引导符是不同功能。间接辅码的标点在合法位置会被当作引导键；它同时被用于翻页或二三选时，应调整冲突设置。

十一、形码正常输入与候选词序

使用自己的形码表时，先以正常模式、固定词序验证原码单字及词组。整句是额外的输入能力，不能把整句推断候选与原表某个编码下的列表完全等同。快捷 Ctrl＋2 → 1 可回正常；仍需检查过滤与个人词序。

想完全核对原表时，除固定词序外，还要确认没有单字过滤、范围限制、个人置顶或屏蔽。候选数较少时记得翻页；后续编码补全项也不等于这串码的精确词条。

十二、形码整句的完整操作

1. 01

   开启并等待首次准备

   形码设置中勾选「形码智能整句（实验）」，选择识别模式，应用。也可 Ctrl＋2 → 2 快速开启。首次可能需要等待准备完成，再重新打开输入窗口测试。

2. 02

   全识别

   按各字有效编码连续输入，可混用每字 2、3、4 码；本来不足四码的字用它自己的完整码，不必补键。不要把这种混输理解为任意错误截码或所有备用长码都能识别。

3. 03

   两码模式

   每字固定取前两码连续输入，保持统一节奏。切换模式后按对应规则重新输入，不能把完整码串直接当两码串来比较。

4. 04

   检查与确认

   观察编码分组和候选，必要时退格修改，确认后再上屏。完整字词首选更稳定，不代表重码和分词歧义消失；仍应看候选。

5. 05

   回到固定字词输入

   Ctrl＋2 → 1 正常，关闭整句并选择固定词序。希望单字先显示可选 3；单字优先不是强制只出单字。

不存在「超过 8 码才算句子」的固定门槛。整句仍为实验功能，某些备用编码和标点码元的多字连续输入有已知限制。重视原表位置、使用特殊标音或标点码元方案时，先用正常模式验证。

• 整句输入与编码分割专题

十三、形码常用设置逐项说明

十四、标点、配对与标点作为码元

普通标点、辅助码引导、二三选、翻页和码表码元可能使用同一个物理键。空闲输入标点与组字中按标点不是同一场景；先核对当前候选和模式。当前版本按码表识别标点码元，不需要另外寻找旧的「启用两笔 30 键」按钮。

开启标点顶字时，普通标点会先确认已有候选；关闭时普通标点可留在未上屏编辑内容中，随后继续输入并一并确认。标点能合法续码时仍用于编码；部分唯一且无后续的标点尾码可按原方案习惯自动确认。整句里第二个字以后使用标点码元仍有已知限制，不能据此承诺所有特殊方案都已完善支持。

在 Windows 快捷键设置或 Linux 标点与符号中启用智能配对，可自动补齐支持的括号、引号。兼容极点旧式 @／& 映射的开关会改变相关键用途，不沿用旧习惯就不必开。输入邮箱和网址前先确认当前字词，并切到合适的英文标点／半角状态。

十五、候选窗口、词组联想与手工调序

候选设置分别调整形码和拼音数量（1～9），与对应输入设置中的数量同步。横排／竖排改变窗口排列；编码显示位置控制在应用编辑区、候选框或两处显示，不改变实际按键和词库。

词组联想在字词上屏后出现，选择只追加后半部分，继续输入编码则退出；形码和拼音独立开关。它不是上一条未选中的整句候选，也不要求把输入应用中的所有文字重新输入一次。

固定词序不自动取消已经保存的手工排序。电脑端没有统一的「恢复全部自动词序」入口时，不要照抄手机路径；先导出完整个人词库，再对具体项目处理或反馈，不要直接删除数据目录。

十六、码表下载、导入与自定义方案管理

1. 01

   找对入口

   Windows 用「方案管理」导入本地码表，「形码设置」有在线码表目录；Linux 用设置中的方案管理及在线码表页面。词库管理的导入按钮用于个人词，不用于安装整个形码方案。

2. 02

   下载或导入

   在线目录先刷新、选家族及具体表，再下载／更新；本地导入先解压文件，选择极点 .mb、冰凌文本或 Rime 静态词典，确认显示名称。Rime 脚本、动态转换和整套配置不能保证一并导入。

3. 03

   选中并验证

   导入完成后在基本设置／输入模式中选中目标表，应用后试原表已知的一简、完整单字码和词码。仅出现在目录里不代表已经成为当前方案。

4. 04

   管理

   按页面支持的改名、导出、删除功能整理。删表或更新前保留原文件并导出重要个人词；随包系统表受保护时不能删除，不要手工删安装目录强行处理。

自然龙、汉心龙按独立形码表安装和使用，词条编码需要符合原方案，不能假定任意新词可由通用规则自动推导。汉心双拼辅助码则在拼音辅助码处选择。巧码、光码等仍使用各自码表，不能把五笔个人词码直接导入后当成它们的编码。

导入错误时用原文件另存副本处理，保留报错和相关几行。MaQuanTableTool 可检查、转换支持的静态码表，并回读检查导出结果；它不是把任何格式自动转换成任意方案的工具。

• MaQuanTableTool 使用说明

十七、个人词库：新增、编辑、搜索与剪贴板造词

1. 01

   打开目标词库

   Windows 用 Ctrl＋Shift＋/ 或设置中的词库管理；Linux 可运行 jdime-settings --dict。先选方案：拼音个人词共享，形码按具体表分开。

2. 02

   新增

   填写词条，等待自动编码建议，核对后修改。拼音按规范全拼，例如银行 yinhang、行走 xingzou；形码必须核对当前表的实际规则，没有正确建议就手填。点新增／加入才会保存。

3. 03

   搜索与修改

   按词条或编码搜索并刷新，选中已有词，修改后点保存修改／编辑选中。页面可能限制单次显示数量，不能只数首屏行数判断个人词库丢失。

4. 04

   验证

   回输入框打相应编码，检查词条是否出现；双拼日常输入仍按双拼键位，不能把个人库显示的全拼当成双拼按键。

5. 05

   剪贴板造词

   先复制要保存的文字，在码圈空闲、没有未确认编码时按默认 Ctrl＋Alt＋=，进入词库确认页。检查目标方案、词条及编码后再保存；这不会静默把所有剪贴板内容自动加入词库。

删除一个个人词之前先确认目标码表和条目；想换位置使用置顶／调序，不用删除。更换输入方案后看到另一份个人词列表是正常现象，不代表旧词消失。

十八、自动组词、确认次数与调频

Windows 在形码／拼音设置中分别选择自动组词方式，Linux 在对应页设置。连续选出的几个单字可以形成临时词；能再次打出来不一定已经永久保存。

先用一个小词验证「形成临时词 → 选中整词 → 在个人词库查到」的过程。长名称或特殊形码建议手工添加。形码规则各不相同，自动组词推出错误编码会影响后续使用；默认关闭的方案不要未验证就全开，龙码等显式词码尤其如此。

智能调频是调整已存在候选顺序，不是创建新词；形码「词组自动调频」只调整词组。个人置顶、固定词序、码表词频、使用次数是不同影响来源，排查排序时逐项对照，不同时改多个开关。

• 自动造词的完整例子与确认次数

十九、导入导出、备份与跨设备迁移

1. 01

   旧设备导出

   每张需要迁移的形码表分别导出个人词；拼音导出一份即可。文件名标清方案和日期，另存原码表。

2. 02

   新设备先装方案

   安装码圈及对应形码／双拼方案，再打开个人词库选正确目标。相近名称不意味着编码规则相同。

3. 03

   合并导入

   选择支持的完整词库、文本、CSV 或标准 Rime 词典文件，按提示合并。已有本机使用记录不应通过错误方案混导；完整格式拒绝不匹配时检查目标，不要去掉头信息绕过检查。

4. 04

   回读验证

   搜索几条关键词，回输入框试打；保留迁移前导出文件直到确认完成。重要备份至少在另一磁盘或设备保存一份。

手机的设置＋个人词库 ZIP 与桌面词库导入不是同一个入口。跨平台优先使用按方案导出的 .jdlex 或支持的文本格式；不要把手机整份 ZIP、原码表文件和个人词文本互相改扩展名导入。

二十、账户同步、最新词源和自建服务

「同步最新词源」是下载公共词条更新；「同步个人词库」是同步自己的学习数据，两者不同。Windows 词库页有分别对应的按钮；Linux 也可在账户／词库页按相应入口操作。不同步账号也能本地输入。

1. 01

   登录目标服务器

   在账户与同步中确认服务地址再登录。自建服务与官网账号独立，不共享登录状态。

2. 02

   启用并保管恢复码

   按界面提示启用个人同步，妥善另存恢复码。账号密码用于登录，恢复码用于恢复加密个人数据，不能相互替代。

3. 03

   连接第二台设备

   在同一服务器使用同一账号和恢复码，先备份两边重要词库，再执行同步并检查状态。目标设备还需要安装对应方案。

4. 04

   自定义服务器

   Windows／Linux 填完整 HTTPS 地址，包括非默认端口，保存后再登录。私有 CA 或自签名场景按页面设置 PEM 公共证书路径，并保留该文件；不要使用服务器私钥。

候选与本地预测在电脑上处理。联网码表、公共词源更新、程序更新和个人同步各有用途，不能把「开启本地 AI」理解为上传正在输入的句子。同步也不自动备份第三方应用文档；忘记恢复码时先保留还可访问的数据，不要急着重置保险箱。

• 自建 Windows 局域网同步服务器教程

二十一、快符、符号表与附加词库

Windows「快捷键设置」、Linux「快捷键」可启用快符，设置一个英文标点为引导符，再导入／编辑快符表。输入引导符和字母编码后选择符号；唯一匹配可自动输出，多候选按数字或空格选择。Esc 取消，退格改码，连按两次引导符输出引导符本身。

编辑表通常每行「字母编码＋Tab＋符号」，按页面提示保存。空闲时快符直接输出，整句输入中可进入未上屏内容；合法方案码元、辅助码和候选专用键优先。页面提示引导符冲突时，先换一个不冲突的符号，不要以关闭所有正常标点功能解决。

英文／IT、Emoji、颜文字、最新词源分别控制。想减少英文候选可关英文／IT或调后置位置；关闭这一组不必然关闭表情。表情与颜文字的插入规则不同于英文，不能只改一个数字要求所有类别一起移动。

二十二、皮肤、候选位置、字体和状态栏

字变方框先判断是字体缺字还是根本没有该候选：前者换包含该字的字体，后者核对码表和检字范围。全角／半角、中文／英文状态不会补齐字体缺字。

二十三、快捷键总表与冲突处理

快捷键设置按菜单与窗口、输入与候选、标点与翻页／快符等分组。修改后应用／保存，再在码圈实际生效的输入框测试；不需要的项目可按页面支持填 disable。不要把正常字母随意设为全局功能键，也不要把多项设成同一个组合。

快捷键没有响应时：确认当前是码圈 → 确认中文状态和是否有未上屏内容 → 查看实际绑定 → 换普通编辑器 → 排除系统、应用、终端或远程桌面的冲突。Linux 的系统输入源切换键应在桌面／框架设置修改，不是在码圈 Ctrl＋1 菜单修改。

二十四、常见问题与安全排错

反馈请附系统完整版本、CPU 架构、码圈版本／下载时间；Linux 另附框架及桌面会话。说明码表名称、准确按键、期望候选、实际结果和相关开关，码表问题附对应几行。遮住账号、恢复码、私有文本；不要只发「打不出来」而没有按键。

二十五、更新、换框架与卸载前的准备

Windows 沿官网渠道覆盖安装后重开应用；Linux 使用对应软件源和包管理器更新，完成后重启。要从 Fcitx4 换到 Fcitx5 或 IBus，先确认系统支持目标框架并备份个人词库，按对应包操作，不只是把原插件改名。

不再使用时，先从系统切换到其他输入法并导出个人词库。Windows 使用系统卸载入口；Linux 只移除实际安装的码圈包，例如 sudo apt remove maquan-ime-fcitx4，其他包用它自身名称。不要执行 fcitx* 等通配符卸载，以免删除系统及其他输入法。是否保留个人数据按卸载提示核对，备份放在应用目录以外。

• 移动端完整使用手册
• 国产 Linux 安装与系统对照
• 0.1.86 新功能专题
• 更新记录