开始使用

← 指南目录 · English

「设置」中提供可选的共享账号入口。Qonlang 与 Qonsona 使用同一账号，登录不影响本地工程的使用。

1. 安装与启动

安装包都在 GitHub Releases 上。GitHub 在国内有时很慢或打不开，下载前请先确认能访问 GitHub。

• Windows：Qonlang-<版本>-setup.exe，可选安装目录，桌面快捷方式叫「千语集」。安装包没有签名：浏览器提示「不常下载」时，请在下载记录里选「保留」；第一次运行时如果弹出「Windows 已保护你的电脑」，请点击「更多信息」，再点击「仍要运行」即可。数据目录在 %APPDATA%\Qonlang（偏好设置、最近项目、自动备份、下载的字体都在这里）。
• macOS：Qonlang-<版本>-mac-arm64.dmg（Apple 芯片）或 -x64.dmg（Intel），打开后把千语集拖进「应用程序」。应用没有签名与公证，第一次打开会被系统拦下：
  • macOS 14 及更早：请右键点击千语集，选「打开」，在弹窗里再点击「打开」即可。
  • macOS 15 起：请先双击打开一次（提示无法打开时点「完成」），然后打开「系统设置 → 隐私与安全性」，在下方找到千语集被阻止的提示，点击「仍要打开」并输入密码即可。
  • 提示「已损坏，无法打开」时，请在终端执行 xattr -cr /Applications/Qonlang.app，之后照常双击打开。

  数据目录在 ~/Library/Application Support/Qonlang。

• Linux：Qonlang-<版本>.AppImage，下载后请在文件属性里勾上「允许作为程序执行」（或执行 chmod +x Qonlang-*.AppImage），再双击即可；Debian、Ubuntu 也可以用 .deb 安装包（sudo apt install ./qonlang_<版本>_amd64.deb）。数据目录在 ~/.config/Qonlang。
• 从源码运行：git clone 后，Windows 双击仓库里的 dev.cmd（不经过 PowerShell，不受执行策略限制），macOS / Linux 执行 sh dev.sh，首次会自动 npm install。

每个版本的 Windows 安装包、macOS dmg 与 Linux 的 AppImage、deb 都由 GitHub Actions 在打 tag 时同时构建，挂在同一个 Release 下。版本号带 -beta 的（如 1.0.0-beta.1）是测试版，在 Release 页上标着「Pre-release」：装着正式版的不会收到测试版的更新提示，想试请到 Release 页下载；装了测试版的，之后的测试版和正式版都会照常提示。

第一次打开时，界面语言跟着系统：系统语言是九种界面语言之一就用它，其余用英文；之后随时可以在开始页左下角的「语言」里换。

如果系统提示「禁止运行脚本」，那是 PowerShell 的执行策略在拦 npm.ps1，用 dev.cmd 或直接用 exe 即可。

2. 首页

首页左边一栏是「怎么开始」，中间是你的项目和小游戏。左上角的字标跟着界面语言换：简体中文、繁体中文、英文、俄文、阿拉伯文各有一版，其余界面语言用英文那版。

1. 每日一句：最上面一条，从最近打开的项目（最多 3 个）里抽语料例句、短语和带配图的词，一张一张换着看。例句、短语用渐变色做底，带配图的词拿那张图模糊了当底。鼠标移上去左右两边出现箭头，点了换下一张；顺序按当天的日期打乱，同一天打开第一张不变。这门语言有文字时，例句、短语的卡片上面还有一行按文字的映射规则转出来的文字写法（用那套文字的字体），有几套文字就几行，卡片跟着长高。卡片左上角的小图标说明这张是例句、短语还是带配图的词，右上角写着「每日一句」（配图的词写「每日一词」），右下角的落款写到具体语言（项目 · 语言）。例句、短语照原文带着标点显示，里面的词都可以悬浮看词卡——认词跟语料页是同一套（用语素边界符号连着的词、词缀都认得，存着的分析没挂上词条的也按词形、构形词缀、切分反查，拆开的每一段也点得开），卡片上的「在词库中查看」会先打开那个项目再跳过去；例句里的词认错了就点「改」，同样先打开项目，跳到语料里那一句挑正确的词（见语料 · 悬浮词卡）。最近打开的项目里什么都抽不到（或者还没打开过项目）时不显示。
2. 起步模板（点左边那个「新建项目」才展开）：
   • 空白单语：一门语言，从零开始，先验语默认选这个。
   • 语系：一门祖语加若干子语言（每行一个名字），之后用音变把词从祖语推到子语言。
   • 从 Lexicanter 导入：读取 .lexc 文件，词库、义项、方言、发音规则、字母表、词源、短语、文档一次进来。
   • 从 CSV 导入：先建空白项目，然后自动打开 CSV 列映射向导。
3. 最近项目：一排四张、最多两排（八个），每个最近打开过的项目一张卡片，写着项目名和作者，右下角是用这个项目自己的文字写的一个词（文件一个一个读，卡片先出来、文字随后补上；太长的那头淡出去，竖排的往下淡）。鼠标停上去卡片里有一层跟着指针走的光，点一下就打开。
4. 小游戏：最近项目下面一排四个玩法，都拿你自己的词库出题。点一个先挑项目（只读来出题，不会打开、也不会改动），再挑语言：
   • 单词卡：正面词、背面释义，点卡片翻面；可以反过来（先看释义）。答「记得 / 没记住」，没记住的这一轮末尾再来一次。
   • Sage 拼词（玩法同 elfdict 的 Sage）：上面列几条释义，下面一堆字母——这些字母正好能拼出那几个词。点字母组词，点已经选中的撤回；某一条实在想不出来，点它右边的灯泡看答案。
   • 猜词：六次机会猜出一个词。按这门语言的字母表判对错，th、ll 这类多字母的字母算一格；字长 3～7 可选。绿色是位置对，黄色是词里有但位置不对。
   • 填字：用词库排一张填字盘，提示是释义。「对答案」看填得对不对，「看答案」直接摊开；导出网页存成一个 .html，别人用浏览器打开就能填、能对答案，也能直接打印或另存为 PDF；导出图片是空白盘面加提示，适合打印出来用笔填。
5. 最近打开：左边一栏下方的列表，文件不存在时会自动从列表移除。

左边一栏还有：新建项目、打开项目、示例工程、使用指南。「示例工程」带两个虚构项目，合起来把每个模块的功能都摆了一遍——想看某个功能长什么样、数据该怎么填，打开翻一翻最快：

• Aelith（黏着先验语）：祖语→现代语的语系与姊妹语 Merun（关系图里对比同源词）、元音和谐、多槽位后缀、流水线构形的八种步骤、变体与继承、屏蔽槽位与手填表、作用于所有词的连读浊化（微调里现写的一对音类）、复合词类、检视器模块、词源链与关系图、配图与方言、已 gloss 并确认、带标点的语料、卢恩刻文、特征与重音规则（还有一条两个音并成一个：元音之间的 t、d 都变 r）、自定义重音、词条的「对重音影响」、「Ael 语系」节点与分组统计、历时阶段 CAe → Ae 与词条的历史形式（kaso：PAe kasu → CAe kaso → Ae kaso）、从「复数.主格」继承的复数各格、影响发音的位格（kasoda 读 ˈkasoða）、按维度取值挑的异体形（复数标记在与格前是 -lAn：kasolanka）、动词第三人称那几格故意不写（简洁模式下接着「极性.时」两个维度的槽位往下变）。
• Tsahun（孤立声调语）：五个声调、罗马化与西里尔双正字法（按写法切音节、数音）、音节文字的拼合与竖排、重叠构形与带空格的屈折形、同形词候选、异体字模块、按字号写的意音文字、量词与整套借入的数词。

界面不是中文时，示例工程里的几篇文档（「关于这个示例」「语法概要」等）显示英文版；词条、例句这些示例数据不变。

每个示例卡片上有「打开」和「复制一份」。「打开」是拿来试的：随便改，但存不下来——顶栏在保存按钮的位置换成「示例」徽标和「复制一份」，Ctrl+S 只给一句提示，不会标成有未保存的改动，关掉时也不会问。「复制一份」（示例卡片上的，或者打开后顶栏上的）先问存到哪，存出来的就是你自己的普通项目，之后照常保存。

底部六个按钮：请我喝咖啡、更新日志（就是仓库里的 CHANGELOG.md；界面不是中文时显示英文的 CHANGELOG.en.md）、开发者、友链、致谢、规则语法，点了在右侧面板里显示（开始页一打开，右侧面板显示的就是更新日志）；「开发者」面板最上面是「报告问题」和「复制诊断信息」（见设置 · 关于）；再往左是「使用指南」，也就是本站。

左下角还有三个：语言（界面语言）、主题（明暗与主题预设）、设置（设置里「应用」那一档，跟项目无关的都在这儿）——不打开项目也能调。

3. 项目文件

• 一个项目 = 一个 *.laim.json 文件，里面是全部语言、规则集、词类维度、语素、词条、构形、例句、短语、缩写表、文档页与项目设置。文字里内嵌的字体也以 data URL 存在里面，所以换机器打开仍能显示。
• 设置 → 导出为文件夹格式：每个集合一个 JSON、规则集另出一份纯文本、文档页导出为 .md，便于放进 git 看 diff。
• 自动保存：设置里的间隔（秒，0 关闭）。另外每 5 秒会写一份快照到数据目录，意外崩溃后重启会提示恢复。
• 备份：每次保存前，旧文件会复制到数据目录的 Backups/，默认保留 20 份。
• 关闭保护：有未保存改动时关窗口或点导航栏的「千」回首页，会弹提示条让你选保存或丢弃。
• 保存前先看文件有没有被改过：保存（包括自动保存）前，先看文件在打开或上次保存之后有没有被别的程序改过——另一个千语集窗口、网盘同步之类。改过的话会先问你：「覆盖保存」用现在的内容盖掉那边的改动；「另存为…」存成另一个文件，原文件不动；「先不保存」这次什么都不写，并暂停自动保存，之后按 Ctrl+S 可以重新选择。
• 同时开两个千语集：可以，后开的那个会先提醒一句「已经有一个千语集开着」。同一个项目请只在一个窗口里修改；两个窗口各存各的崩溃恢复快照，不会互相覆盖。
• 格式承诺：从 1.0 起，之后的每个版本都能打开 1.0 以来保存的项目文件（纯欣赏副本也一样）。

4. 推荐的建库顺序

1. 语言页：确认语言名、缩写、颜色；语系项目先把树画对。
2. 音系页：点 IPA 表建音位表，一键生成 C / V 音类，写「正字法 → IPA」规则。
3. 词库页：先录一批词（或 CSV / Lexicanter 导入），词类与维度在「词类与维度」子页定义。
4. 语素页：词根与词缀。
5. 构形页：把维度组合成槽位，写生成器，绑定词类，推导写入。
6. 音变页（语系项目）：规则集、阶段绑定语言、整库演化。
7. 文字页：如果有自己的书写系统。
8. 语料页：例句自动 gloss，确认后成为其他句子的首选。
9. 文档 / 短语：语法说明、常用语。
10. 词库 → 导出：词典 HTML / Markdown / PDF。

顺序不是强制的，任何页面随时可以回头改，联动都是自动的。

5. 顶栏

• 项目名与「已保存 / 未保存」徽章，右边是搜索框（词库、语素、语料、短语页面才出现，占位文字跟着模块走，换页面自动清空）。
• 当前语言下拉：多数页面只显示当前语言的数据；选「全部语言」看整个项目。语料、短语、文档等页面新建内容时默认归属当前语言。
• 保存按钮（示例工程是「复制一份」，见上）、检视器开关、关闭项目。

6. 网页版

同一套代码可以用 npm run build:web 打成静态站点，在浏览器里用 File System Access API 读写本地项目文件，IndexedDB 存快照与字体。功能一致，只是 PDF 导出走浏览器打印对话框。