gongwen

为什么是公文助手

一篇公文从「写完」到「能发」，中间还隔着多轮核稿：主送、抄送有没有串位，文号、日期、密级是否合规，附件引用能否对上，落款是否跨页，印发份数有没有算错。很多问题并不难，却分散在全文和不同办文节点里；越临近送签，越依赖经办人的记忆与耐心。

公文助手不把这些风险再包装成一张更长的检查表，而是把规则做进编辑、预览和导出流程：

办文现场	系统怎样接住	业务结果
起草时，正文与要素分散填写，改一处容易漏一处	单位、人员、文号、密级、日期独立建模，正文只承载正文	要素不再靠复制粘贴维持一致
核稿时，需要在几十个细节间来回跳转	必错、疑似、提示分级呈现，逐条定位到问题位置	核稿从「通篇找错」变成「按项处置」
送签前，既要看内容，也要看落到纸面后的效果	预览、Word、PDF 共用编号、栏宽和版式度量	屏幕所见更接近最终成品
印发时，份数、份号、页码与版记必须互相吻合	自动合计印数，涉密件逐份编号，每份独立归页	减少最后一道环节的机械差错
改稿时，领导关心「改了什么」，经办人还要保留过程	提交版本、增删对照、花脸稿与基准版回退	修改有据可查，送审表达更清楚
送批时，呈批件后面还跟着函稿、报告，某件一改就得重新整理	呈批件挂上随行件，按各件提交版一键合并成一个 PDF，归档时钉住送出去的那一版	整套材料随改随出，送出去的是哪一版有据可查
归档时，定稿与盖章扫描件容易散落	草稿 → 发布 → 归档，终态冻结并集中管理盖章件	一篇公文形成完整、可追溯的闭环

[!IMPORTANT] AI 不是规则的替代品。 它只能提交待采纳的修订建议，不能直接改正文，也不能改单位、人员、文号、密级、日期等公文要素；任何 AI 产物落地前仍要经过确定性闸门。

一篇公文怎样在这里走完

01 立稿	02 拟稿	03 核稿	04 送签	05 印发	06 归档
选文种建要素	Markdown 写作实时预览	规则扫描逐条处置	版本对照导出花脸稿	Word / PDF打印与份号	冻结定稿收存盖章件

这条路径里，程序负责可重复验证的事情，人负责政策判断、事实确认和最终表达。即使不配置任何模型，排版、校对、版本管理、导出和归档也能完整使用。

核稿保障：把容易出错的地方变成确定性检查

以下检查不是泛泛的「AI 提醒」，而是由本地程序按字段、词表和文档结构逐项判定。结果进入统一审校面板，保留「必错 / 疑似 / 提示」三档，不让低风险提示淹没真正需要处置的问题。

份数与印发

• 「共印 X 份」不用填也不用算：主送 + 抄送 + 承办单位自动合计，表单一改份数跟着变，永远不会两处对不上；
• 涉密件勾选「逐份编号」，导出 PDF 自动含 N 份、份号 01…N，每份页码各自归 1。

单位名称与排序

• 主送、抄送多选时勾选顺序不影响输出——成稿顺序一律按词库里的排序走，排名先后只维护一处；
• 选下级单位自动补全上级全称；同一上级的多个下级用顿号连接、跨上级用逗号分组，不会重复罗列上级名；
• 外部行文自动改用单位的「对外名称」；同一单位同时出现在发文、主送、抄送里会被拦下——不能给自己发文。

人名与电话的一致性

• 联系人从词库选人就自动带出绑定电话，电话框只读回显，从源头杜绝抄错；
• 手填电话与词库中该人的号码不一致必报；联系人必须属于同行承办单位（人随事走）；联合发文的承办单位和联系人成对录入，数量天然一一对应。

文号、密级、日期

• 文号按「机关代字〔年份〕序号」三件套录入，即时拼出成品预览「X政函〔2026〕12号」；年份必须四位、序号只能填数字；正文里写成方括号 [2026] 会提示改六角括号〔〕；
• 密级与保密期限挂钩：秘密 ≤ 10 年、机密 ≤ 20 年、绝密 ≤ 30 年，超上限直接拦；
• 成文日期只在导出这一刻检查：过期必报（精确到「距今 N 天」），编辑期间不打扰；正文里残留的「今天 / 明天 / 下周三」必报并要求换算成具体日期，日期与星期不符也报。

结语与行文语气

• 白头件、红头呈批件缺「妥否，请指示。」必报；出现两处以上请示结语报「疑似一文多事」；普通文种里夹带请示结语直接判必错；
• 函是平行文：对不相隶属单位写「要求 / 责成 / 责令 / 务必」会提示宜写「请贵单位」；上行文提事项应用「建议、请、恳请」；
• 同一篇里既称「贵局」又称「你局」必报——单看每句都对，只有通读全文才发现前后不一。

附件

• 附件名称自动写：正文结束后、落款之前自动列「附件：×××」，取自附件区的正式标题，不用在正文里手抄；
• 正文写「附件共三份」实际只有两份、「见附件 2」实际只有一份——这类对不上的引用必错。

版式细节

• 正文没跨到第二页时，落款页自动标注「（此页无正文）」；正文跨页则不出，按实际量高判定，不靠猜；
• 段末孤字双保险：编辑时即时粗估提示，排版后由排版器实测坐标回传精确结果——是「量过」，不是「估的」；
• 页码严格按 GB/T 9704—2012 编排：一字线、上距版心下边缘 7 mm，双面打印页码居外侧。

排版：丰富灵活，但一致性不打折

紧缩模式分两档：「全局紧缩」把全篇最深一级标题与紧随的正文并为一行；「节内紧缩」以节为边界各自合并，只收局部。接不接排逐条由源码决定：标题下一行紧贴正文就接排，空一行就照常另起一段。合并后的段落保留标题与正文各自的字体，三个输出端（预览 / Word / PDF）效果一致。

编号全自动：标题编号链「一、→（一）→ 1. →（1）」由导出器统一生成——先清掉正文里残留的旧编号再重编，增删段落永不跳号；正文列表不分有序无序，一律按设置里的编号样式排。独立列表项下比它多缩进两格写的子行认作该项的子项，并进这一项按段内编号接排（1.主要任务：①……；②……。），只分两级。万一别处粘来的手写序号有跳号、重号、错序，有专门规则全篇兜底。

表格不用调：列宽按内容自动排版，横向合并的单元格把宽度需求按跨度摊到各列，合并表头不会单独撑大某一列；居中单元格按导出规则分词均衡换行，多出一两个字时横向压缩字形保持单行；表格在竖页排不下时该附件自动转横页，下一个附件前恢复竖页——逐附件独立判定，打印时横页自动放正。普通公文还可在要素表单勾「横页排版」，整份文件（含附件）排成横向 A4、左侧装订，PDF、Word 与预览一致。

长单位名撑不破版式：承办区三栏宽度一次算定、三端共用——联系人栏姓名归一（两字名加空格、四字名压缩），电话栏按最长号码定宽，承办单位栏一律不换行、放不下就按比例横向压窄字形。标题超出一行不到两个字宽时横向压缩字形保持单行；两行标题自动枚举断点，首行不短于末行、头不轻脚不重。

开箱即用：不装 Office，也能出成品

• 内置完整的排版引擎与字体：公文与研究报告的 PDF 都由程序内置的 Typst 排版引擎直接排出（一份公文几十毫秒），不依赖本机装任何排版软件；发布包带全套公文字体（方正小标宋、方正黑体、方正楷体、方正仿宋、方正书宋，中文覆盖 GBK），其中仿宋、楷体是合成字体——西文、数字、带圈数字与符号取仿宋_GB2312 / 楷体_GB2312，页码数字另接宋体字面的随包拉丁子集，保住国标字面；没有装 Word 的机器上也能直接出 PDF；Windows 安装包不足百兆。
• 生僻字不丢字：内置中文字体一律覆盖 GBK，人名里的「喆」「赟」「堃」直接就能排，预览、Word、PDF 三端一致；换成自己的本机字体后，那支字体排不出的字仍由内置兜底接管。要排 GBK 以外的字（如「𠮟」），可在设置里另选一支字库更大的本机字体兜底。
• 应用内直接打印：程序自带的打印对话框在 Windows、macOS、麒麟上长得一样——选打印机与状态、份数与逐份、页码范围、双面（长边 / 短边 / 手动翻面）、颜色、纸张、纸盒、缩放，左边还有按真实尺寸画的页面预览；双面、颜色、纸张、纸盒与缩放按打印机分别记住，打印有进度与取消。Windows 上按纸张实际大小出图（公文版心按毫米打准、横页不再缩小），另可转到驱动自带的「打印机首选项…」；macOS 与麒麟交给 CUPS。打开双面排了页码的稿件或送批材料合并件时，默认给长边双面，并按稿件情况给公文提醒。起草页功能区也有「打印…」直达：只导一份 PDF，排好自动弹同一个对话框。
• PDF 应用内预览：纯 Rust 渲染，连续滚动与单页翻页两种模式——单页模式下窗口够宽就并排多页、翻页按整屏步进，触控板滑一下翻一格；跳页、缩放齐备，鼠标可直接选字、⌘C / Ctrl+C 复制文字，导出的成品和归档的盖章扫描件都能在标签页里直接翻看。
• 研究报告两套模板：除经典的正式研究报告版式外，另有终端风的「研究终端」模板——细网格页框、元数据栏、无衬线中文配等宽西文，章节、目录、图表、文框、公式与文献的语义和编号一律照旧；可选暗场阅读（深底浅字、青色标注、琥珀强调）或白图打印（白纸墨字、朱红强调）两套配色，预览与 PDF 一致，Word 走白图适配样式。模板与配色随稿件及版本保存，旧稿件自动用经典版式。
• 研究报告的文献引用：.bib 文献库按 GB/T 7714—2015 顺序编码制著录，序号按正文首次引用的先后排，只有引过的进参考文献表；[@key] 的序号印成上标，作句子成分时写 @key（如“见文献@key”）与正文平排，上标写在标点后面时审校会提示；「文献引用」下拉列出已引 / 未引两组，可搜索、键盘选行、勾选多条一次插成 [@a; @b]，指针停在一行上直接看它在参考文献表里的整条著录。预览里排出的参考文献表与 PDF 逐条一致，缺哪个 key 源码里画橙色虚线。
• 导入旧材料：Word / Excel / PPT / ODF / RTF / EPUB / CSV / PDF（电子版）等 24 种格式可直接转成 Markdown 新建文档；外部 txt / csv / md 自动识别编码，GBK、UTF-16 的老文件不必先另存为 UTF-8。导入时按版式还原标题与列表层级（「一、」「（一）」「1.」各归各位），文档里嵌入的图片一并入库（PNG / JPEG 等按原图保存，Visio 图、旧版 Office 图表这类 EMF / WMF 矢量图转成高清 PNG），取不出的图在原位留注释，不阻断导入。
• 粘贴即转换：起草页 Ctrl+V 把 Word / WPS / 网页 / Excel 的富文本与多行纯文本直接转成公文助手 Markdown——标题按所在章节定级，点分、罗马与字母编号识别还原（跳号会报告），列表整理成紧凑两级，句中粘贴只保留行内格式，粘贴的材料在 AI 侧栏保留表格；剪贴板里的图片随文字入库，网络图片不下载、原位留注释，Ctrl+Shift+V 始终原样粘贴，智能粘贴后可一键「改为原样粘贴」。
• 清理与规范有专门的分区：功能区「清洗」分区做公文编号与 Markdown 编号互转、去 Markdown 标记、空格与半角标点规范化、目录 / 链接 / 脚注 / 代码围栏与表格残留清理，导入的旧稿一键收拾干净。
• 界面随人：界面字体直接用本机字体，不随应用打包；主题见下文「界面一览」。

文稿管理：从起草到归档的全流程

• 版本管理：随时提交版本（带名称和备注），任意两版增删对照；对照视图左栏是可编辑的统一 diff（删除的旧行原位红底、新行绿底，每个变更块一键还原），右栏同步出花脸稿预览；「导出花脸稿」把删掉的字留在原位画红色删除线、新增的字就地套蓝色方框，字体行距与定稿完全一致；可一键回退到基准版。
• 永不丢稿：改动定时自动保存（间隔可配，30–600 秒）；新稿一动就静默建档；退出程序时逐篇汇总提示「未保存 / 未提交版本」；下次启动恢复上次打开的全部标签现场。配置文件损坏时原文件留底改名，启动弹窗提示，不静默丢配置；上次异常退出的崩溃日志在启动时弹窗，可复制路径、可打开日志目录。
• 备份与恢复在设置里一键完成：全量数据（配置、稿件库、图片、数据接口、词表、技能）打成 ZIP 备份，恢复前自动校验结构与条目名、先给当前目录留底，解压失败回滚，不出半吊子状态。
• 首次启动与版本更新：首次启动自动载入两篇示例稿（公函与白头件），可直接改可删；关于窗里点「检查更新」查最新发布版本，离线或内网镜像地址不通时优雅降级。
• 公文引用自动识别：正文里写「《名称》（发文字号）」就是引用本身，不必再插标记、粘富文本。程序按「代字〔年份〕序号号」的形状确定性识别，年份写成 [2026]、(2026) 也认；写法不规范、与来源不一致、来源已变或尚未登记都会在校对里提示并给一键改法，登记一次以后全篇通用。公文登记簿把本机发过的公文连名称、文号、正规写法攒在一起，写新文时直接引用，名字对不对当场可比对。
• 同事间共享：稿件导出为加密的稿件包（.gwx），对方双击即可导入（拖进窗口也行）；安装后系统已登记文件类型并配好文档图标，程序正开着时双击的稿件包交给已开的窗口，不另开窗口。包内随附完整标准词库，另一台电脑导入时按编码与姓名增量合并，不覆盖对方已有词条——人换电脑、文换机器，要素保持一致。
• 送批材料一键成册：白头件、红头呈批件可挂上随行件（要发的函稿、相关公文、支撑用的研究报告）。面板里每件用哪一版、有没有未提交的修改、送出后是否又改过一目了然；「导出合并 PDF」按提交版逐件排版、依序合成一个文件，可加目录页，每件从奇数页起、双面打印后能拆开装订，成品在应用内直接打印。归档时各件钉在送出去的那一版，同步稿件包连同随行件一起带走。
• 归档闭环：草稿 → 发布 → 归档全生命周期；归档是唯一终态，归档后标题、日期、正文一律冻结，只可增删盖章扫描 PDF 附件；批量导出时盖章件自动以「（盖章）」命名区分。

AI：重做成能干活的智能体，而不是一个输入框

本版起，AI 从「起草页里的一个对话框」重新设计为右侧 AI 侧栏 + 技能 + 数据接口 + 内核加固的工作台形态。 设计前提没变——先管住，再帮忙——但形态、能力和可核查性都换了：

• 技能是干活的单位：一个技能是一份 SKILL.md，开头写流程、参数与能用的工具，正文是各步提示词。内置十五个技能覆盖起草、修改与审核三类；输入框敲 / 选技能，敲 @ 引用文章（按技能声明当证据 / 基准稿 / 材料 / 来函）；技能可复制改写、导入导出、自己新建。自主步骤（step: agent）让模型自己决定调哪些工具，程序执行每一次调用并留痕。
• 问清楚再动手，答案能改变往下怎么走：动笔前的问题不止单选——多值要素（主送、抄送、呈报领导）和要你挑的资料画成勾选框，勾中的才用；正文里留下的「【待核实】」在侧栏顶上列成待决事项，逐条填完直接出对照当前正文的提案；来源不明的事实与材料里的说法对不上时，选项里带上材料原文（「按材料：15项」）；整段候选（如研究报告的题名）并排比选，挑一个或自己写。授权类要素永远不出题、也不给建议。
• 产出永远是提案，逐块取舍：审阅窗左当前稿、右 AI 提案，逐处可看；每个变更块可以「不要这处」，被排除的块接受时保留原文，主按钮随之变成「接受其余 N 处」。关键事实变化清单随排除实时重算，排除组合造出清单之外的事实变化会被拦下；合并后的正文重新过闸门，版式按合并结果重算。
• 崩了能接着跑：引擎每一步成功后自动把检查点存进稿件库。「已中断 / 已停止 / 失败」的卡片上给「接着跑 / 从头重来 / 丢弃」，另有「从这里重跑（存了 N 份）」；恢复只有一个入口，闸门、定稿、提案只有一份，正文改过就不许「从这里重跑」。每轮保留「首 + 近 5」份。
• 每一轮都有用量与出处：卡片末尾记「模型调用 N 次 · 约 输入 X / 输出 Y token · 用时 M 分 S 秒」，抬头下记「技能 · 模型 · 证据 K1–K3 · 时间」；主模型不可用时自动改用备用并当场说明，已经开始吐字后出错、点停止、上下文超长都不切换。
• 数据接口以 OpenAPI 为中心：一个服务一份 OpenAPI 文件（存配置目录 apis/，可在 Postman / Apifox 打开），支持导入 OpenAPI / Swagger / Postman / cURL、导出为 OpenAPI（不带密钥与环境地址）。每个接口配一组「用例 + 期望」逐条实测留记录，再用「说一句话让 AI 调」证明模型挑对了接口、填对了参数。只查询的接口才给 AI 调，会改数据的发前要人工确认。
• 配置提供商化：模型地址与密钥收进「模型服务商管理」，「模型服务」按功能（起草 / 复核 / 知识库）选模型；知识库页显示「最近一次检索 3.6 秒」。

三条红线原样不变，且逐条都有界面落点：

• AI 永远不直接写入正文，只能交提案，逐块采纳才落地；侧栏说「把 AI 工作稿提交到正文」时弹的是写入确认卡，不交给模型自己决定；
• 公文要素分两级：授权类（密级与保密期限、文号、份号、签发人、成文日期、印发机关与印发日期）AI 只读不写、不出题也不给建议；描述类（标题、主送、抄送、附件说明，以及发文单位、落款单位、呈报领导、承办单位、联系人、联系电话）可以给建议，但单位与人员必须是标准词库里的词条，标题与附件说明取自材料原文，并注明出处，采纳要你点；发函代字、呈批代字随发文单位按表单规则带出；
• 确定性闸门既是工具也是关卡：事实比对、要素校验、词表复扫可以在智能体循环里自查自改，落地前程序再强制跑一遍；硬闸门挡住落地，软闸门转成修订建议附在提案上。

其余保留能力：不掌握真实数据就不许写数据（起草前强制「提取事实单 → 人工逐项确认」，拿不准写「【待核实：…】」）；力度词按行文方向自动切换；四种仿写策略；小模型逐句复核语病（温度锁 0）；把本程序的 Markdown 公文子集与文种规则打成 Agent Skill（gongwen-markdown）供外部 AI 工具使用；数据不出本机（默认连接本机 LM Studio / Ollama 的 OpenAI 兼容接口，涉密单位可用）。

技术：首次实现 Markdown 到公文的精准还原

• 预览就是成品：预览不是「大概其的样子」，而是把 Markdown 连同表单锁定的要素按导出后的样子画出来——标题编号、承办区栏宽、版式度量在预览、Word、PDF 三端共用同一套计数器与换算，屏幕上看到什么编号，印出来就是什么编号。
• 刻度条导航，替代 Word 导航窗格：预览右缘一列极淡细刻度映出全文结构（一条一个标题、按层级定长短、当前位置高亮），鼠标靠近推出亚克力大纲板、挪开即收回——不占版心宽度，不干扰推稿子；导航里的字体随纸上层级（一级黑体、二级楷体），附件区段单独标出。
• Markdown 源码导航：源码模式左侧可展开分级标题目录，点标题直接回到原文；右侧缩略图按编辑器实际换行绘制，长稿可在缩略图内滚动，固定高度的可见框支持点击或拖动定位。两列可分别收起，窗口过窄时临时让出正文宽度。
• 标题聚焦编辑：光标放进一节，Ctrl+Shift+H 弹出该节同级标题的对照编辑框，字数、用语一眼对齐；「大字」模式按纸上公文字体放大，供投屏时给领导看着改。
• 候选区：暂时用不上又舍不得删的段落，右键或 Ctrl+Shift+X 移进编辑区底部的候选区，需要时整条或挑句放回；按稿件各存一份，不进版本、不进同步包、不进导出文件。
• 选中文字拖动：源码编辑器里选中的文字可直接拖到别处，鼠标下浮出摘录卡提示落点，跨行也能就近插入。
• 孤行不靠估算：排版时在段首段尾埋入探针坐标，排完把末行位置回报给应用，实测结果压住粗估提示。
• 导出闸门只有一道：「正文为空」。要素缺失、名称不规范都只进审校面板提示，不挡导出——你往往正是要拿这份 PDF 去看版式、请人过目。

界面一览

界面不是把 Word 的按钮重新排一遍，而是围绕办文动作组织：左侧管要素，中央看纸面，右侧处置问题；需要对照时，再切换到大纲、修订建议或版本视图。常用动作都围绕当前稿件展开，不必在多个工具之间来回搬运内容。

要素与纸面并排：填的是字段，看到的是成品

左侧按「版头 / 主体 / 版记」分组填写，缩略导航图会标出缺项所在区段；右侧同步呈现公文纸面。文种改变后，只显示当前文种需要的字段和规则，避免让经办人在无关选项里找内容。主送、抄送、承办单位、呈报领导这些单位下拉框能检索：打汉字、全拼、拼音首字母、简称或层级编码都行，选项只来自标准词库。

校验结果不是一串提示，而是一张待办清单

「必错」优先暴露格式和要素冲突，「疑似」保留人工判断空间，「提示」承接版式与表达建议。每一项都带原文、依据与定位入口；能确定替换的才提供修改，不能确定的只提醒，不擅自替作者下结论。

从正文结构到改稿痕迹，都有专门视图

六套界面主题，明暗随心

明色三套（Claude 奶油、MDEX 纸墨、锤子稿纸）、深色三套（北欧、复古暗、MDEX 夜墨），默认跟随系统明暗（浅色系统用 Claude 奶油，深色系统用复古暗），菜单「外观主题」或设置页即点即换；界面缩放给 80%–175% 的常用档位，点选即用。公文纸面可随主题联动，也可强制明 / 暗——夜里推稿子不刺眼，白天投影不打折。终端气质的 MDEX 纸墨与 MDEX 夜墨用直角细线勾界面，配各自的应用图标。锤子稿纸用灰棕渐变工具栏、浅木纹底板与横线信纸呈现拟物写作体验，支持源码和对照模式。

文种、导出与平台

维度	支持情况
文种	公函、电话通知、电话记录单、普通公文、会议议程、白头件（呈批件）、红头呈批件、研究报告（共 8 种；研究报告可导出 PDF 与 Word）
导出	Markdown、DOCX（Word）、PDF（内置 Typst 排版，公文与研究报告）、Typst 包（模板 + 数据 + 资源，用 typst CLI 编译）、花脸稿、送批材料合并 PDF、稿件包（.gwx）
校对	内置 155 条校对词表（错别字 / 近义混淆 / 语病 / 套话虚词 / 称谓规范 / 公文用语六组，必错一键替换）+ 20 条文档级规则（文号 / 日期 / 标题 / 附件 / 称谓 / 句末 / 行文语体），规则按文类收紧并在「校对词表」页可查编号、依据与适用范围
导入	24 种格式文件新建文档（Word / Excel / PPT / ODF / RTF / EPUB / CSV / PDF 电子版…），词库与校对词表支持 Excel 导入导出
平台	Windows x64 安装程序、Linux ARM64 deb（GLIBC 2.28，兼容 Ubuntu 20.04 / 麒麟 V10，含国产系统打印兼容）（均附 SHA-256）

快速开始

下载安装：到 GitHub Releases 下载对应平台安装包，安装后即可离线使用。各平台详细说明见 安装指南。

首次使用三步走：

1. 在「标准词库」维护本单位的单位与人员（可下载 Excel 模板批量导入）；
2. 「起草」页选文种、填要素——写到哪一步，校验就跟到哪一步；
3. 需要 AI 起草时，在「设置」中配置本地模型服务（LM Studio / Ollama）；不配也能用，排版、校对、导出全部功能不受影响。

从源码构建：Rust stable（edition 2024），cargo run 即可。

文档

• 使用手册：完整用户手册，22 章 + 3 附录，覆盖写作全流程、AI 能力、词表知识库与设置。应用内也可读：菜单 →「使用帮助」或按 F1
• 安装指南：各平台发布包、Arch/Omarchy 与 fcitx5 候选窗说明、从源码构建
• AI 架构设计：三条红线、确定性闸门与修订建议总线的设计细节

项目结构与开发

src/                应用代码（约 25.2 万行 Rust，2337 项自动化测试）
assets/             图标与界面资源
examples/           示例公文
skills/             gongwen-markdown 技能包（Agent Skill，随安装包分发）
vendor/             随仓库分发的第三方源码（mdx、latex-rust、typst-layout）
scripts/            版本号更新、完整包与增量升级包构建脚本
runtime/            随包字体（不进入 Git）
config.example.json 示例配置

Windows 打包分两种：scripts/package-dev.ps1 打完整安装包（字体等资源全带，约 65 MB）； scripts/package-upgrade.ps1 打增量升级包——按新旧两份 SHA256SUMS.txt 做差，只携带 真正变化的文件并删除已消失的文件，字体没改动就不进包（几十 KB～几 MB），装在已有 安装之上，共用同一个卸载器。基线默认取本机已安装目录的清单，给别的机器做包用 -BaselineDir 指向旧包目录。

cargo fmt --all -- --check
cargo clippy --all-targets -- -D warnings
cargo test --all-targets

GitHub Actions：CI 在 Windows x64 与 Linux ARM64（GLIBC 2.28）两个平台执行格式、静态检查和测试；推送 v* 标签后自动构建 Windows x64 安装程序与 Linux ARM64 deb（兼容 Ubuntu 20.04）及 SHA-256 校验和并创建 Release。

许可

本项目继续以 GPL-3.0-or-later 协议开源。旧输入法内核已移除。 第三方组件、随包数据与字体的许可与署名见 THIRD_PARTY_NOTICES.md。

应用内输入法是词表输入法：主菜单的「输入法词表」页管基础表、导入表与个人词条——搜索框认文字或编码，双击就地改，复选批量移除，检查页可一次改用建议码，最近一步操作能撤销；查码、来源启停、构词规则与修改记录收在「更多」里。加词按基础表反推的构词规则自动出码。初始基础表随安装包携带，只收公文可用词。见 词表输入法设计与交接。