水杉输入法

一款开源的自由 Windows 输入法，面向 Windows 10 / Windows 11，采用纯 TSF 方案。

2026.09.02 给水杉输入法的新用户的说明

最近两天，水杉输入法的新增用户远超预期，约有 5000 名新用户加入，内测服务的多项 API 配额也因此暂时耗尽。随着用户增长，我们收到了许多功能建议，也发现了一些内测阶段的问题。目前我正在逐一修复，同时重构 UI，并开发一套专门面向输入法场景的原生 GUI 框架。

如果你在使用过程中遇到问题，还请耐心等待后续版本。也欢迎有能力的朋友提交 PR：无论是完善输入法本身，还是参与其背后的 GUI 框架，都非常欢迎。本项目接受纯 vibe 的 PR；唯一的请求是友善交流——不要骂主包。

项目即将突破 1000 Stars。如果你是在校学生或正在求职，也欢迎通过贡献代码，或整理与学校、专业相关的词库来参与项目(刷个 PR)。输入法是一款能够直接面向大量用户的软件；如果你希望自己参与开发的软件、自己写的代码真正被人使用并获得反馈，这会是一个不错的实践机会。

本项目现在及未来都会保持 100% 开源。开源的目的之一，是探索 AI 能否参与完善输入法这类容错空间较小、与操作系统耦合较深的软件；同时，也希望为由大型厂商主导的工具软件生态提供一个开放、可控的替代选择。

如何参与贡献

不会写 TSF 或 C++ 也没关系，项目还有很多可以参与的方向：

• 完善安装、配置、升级和卸载文档；
• 补充语音输入、云服务和本地模型的接入指南；
• 编写 API 申请与配置教程；
• 整理各厂商提供的免费额度或试用额度；
• 编写常见问题、故障排查和使用技巧；
• 改进全拼、双拼、五笔等现有输入方案；
• 参与日语、注音、粤语等输入方案的设计与实现；
• 整理学校、专业、行业、地区或兴趣领域的专用词库；
• 修复程序问题或实现新的功能；
• 参与原生 GUI 框架和界面功能的开发；
• 改进界面设计、图标、动画和交互体验；
• 参与英文、日文等语言的翻译和本地化；
• 测试不同 Windows 版本、软件和硬件环境；
• 提交包含复现步骤、日志和截图的问题报告；
• 制作截图、演示视频和新手教程；
• 提出功能建议或参与技术方案讨论。

写代码、写文档、整理词库、测试 Bug、制作教程，都是非常有价值的开源贡献。可以纯手写，也可以借助 AI；但请认真检查和测试，并注意不要在 PR、Issue、截图或日志中泄露 API Key 等敏感信息。

如果你会写代码，可以参与以下方向：

• 修复 TSF 输入法核心中的 Bug；
• 改进候选词、组词、联想和排序算法；
• 优化输入响应速度、内存占用和启动性能；
• 完善全拼、双拼、五笔等现有输入方案；
• 实现日语、注音、粤语等新的输入方案；
• 开发模糊音、辅助码、纠错和智能补全功能；
• 改进中英文切换、标点转换和快捷键逻辑；
• 完善用户词库、系统词库和词频学习功能；
• 开发词库导入、导出、同步和转换工具；
• 接入语音识别、翻译或其他第三方 API；
• 为不同厂商的 API 编写统一的适配器；
• 接入本地模型或其他离线能力；
• 参与输入法原生 GUI 框架的开发；
• 开发候选窗口、设置页面和状态栏组件；
• 改进多显示器、高 DPI、缩放和深色模式支持；
• 修复不同 Windows 版本及应用程序中的兼容性问题；
• 改进崩溃恢复、异常处理、日志和诊断功能；
• 编写单元测试、集成测试和自动化测试；
• 完善编译脚本、开发环境和持续集成流程；
• 检查线程安全、资源释放和内存安全问题；
• 重构重复代码，改善模块边界和接口设计；
• 补充代码注释、接口文档和开发者文档；
• 对现有 PR 进行代码审查、测试和性能验证；
• 制作能够稳定复现问题的最小示例。

项目结构

• MetasequoiaImeTsf: 核心 TSF。
• MetasequoiaImeServer: Server 端，负责算法和窗口渲染。
• MetasequoiaImeUiHtml: UI。
• MetasequoiaImeDict: 词库。
• MetasequoiaImeHelpCode: 辅助码。
• MetasequoiaVoiceInput: 语音输入模块，也可单独使用。

功能简介

• 中文输入：全拼、双拼（小鹤 / 自然码 / 首道 / 微软）、86 五笔。
• 日文输入：罗马字方案，提供平假名、片假名和日语词库候选；中文状态下也可用临时日语（R 模式）。
• 拼音方案支持辅助码（蓝天小雨点、自然码、首右 2.0、首右 Plus、小鹤）。
• 支持谷歌云候选、AI 联想（DeepSeek / OpenAI / SiliconFlow / Groq）。
• 竖排候选窗支持中英互译释义；本地未命中时可走腾讯云机器翻译。
• 中英混输、emoji 混输、颜文字混输；独立英文候选输入模式。
• 词库管理：全拼 / 五笔 / 英文查询、新增、批量导入与导出。
• 语音输入：豆包流式识别，以及 OpenAI / SiliconFlow / Groq 转写；可选文本润色。
• 手写识别、屏幕键盘、悬浮工具栏、剪贴板历史。
• 快捷短语（K）、日期时间（T）、Unicode（U）、Emoji（E）、颜文字（M）、超级简拼（J）、临时英文（Y）、临时日语（R）。
• 智能标点、重复标点转中文、成对标点补全、以词定字、简繁转换。
• 多种皮肤：Fluent、微信绿、石墨 Graphite、杨柳青 Willow green，均支持深色 / 浅色。

核心功能指南

输入方案

在设置 → 输入中切换中文或日文模式。中文方案包括：

• 全拼：按完整拼音输入。
• 双拼：用两个按键组合声母和韵母。可选小鹤双拼、自然码双拼、首道双拼和微软双拼。
• 五笔：当前提供 86 五笔。

翻页按键可在设置中勾选：- / =、, / .、Shift + Tab / Tab、Page Up / Page Down；↑ / ↓ 用于移动高亮候选项。

中英文状态可按应用分别记忆，也可全局统一。Ctrl + Shift + E 可进入或退出独立的英文候选输入模式。Ctrl + . 切换中英文标点，Ctrl + Shift + Space 切换全角 / 半角。简繁输出可在设置中选择。

辅助码

辅助码是一种可选的形码筛选功能。输入完整的拼音后，在末尾追加辅助码，可以缩小候选范围或调整候选顺序。

辅助码方案可以在配置中选择，目前支持：

• 蓝天小雨点
• 自然码
• 首右 2.0
• 首右 Plus
• 小鹤

辅助码有“单码”和“双码”两种使用方式，也可以分别用于全拼和双拼。

单码辅助

在完整的拼音或双拼编码后追加一个辅助码。

单码辅助主要用于调整候选顺序：

• 单字：辅助码匹配汉字的任意一个形码。
• 词组：辅助码匹配词组首字或末字的首个形码。
• 匹配到的候选会被优先显示，但其他候选仍然保留。

例如，使用自然码辅助码时，“阿”的辅助码为 ek：

全拼：aE
双拼：aae 或者 aaK

双拼单码中，小写字母优先匹配候选的第一个辅助码，大写字母优先匹配第二个辅助码。对单字，这分别指该字的两个形码；对词组，分别指首字和末字的首个形码。因此，对于辅助码为 ek 的“阿”，aae 以第一码 e 优先，aaK 以第二码 k 优先。其他候选仍会保留。

注意：双拼追加的单码大小写都可以，但大小写会决定优先匹配的辅助码位置；全拼追加的单码必须是大写。

双码辅助

在完整的拼音或双拼编码后追加两个辅助码。

双码辅助会严格筛选候选：

• 单字：两个辅助码分别匹配该字的两个形码。
• 词组：第一个辅助码匹配首字的首个形码，第二个辅助码匹配末字的首个形码。
• 筛选结果只保留符合辅助码的候选。

例如，“阿”的辅助码为 ek：

全拼：aEK
双拼：aaeK、aaKe 或 aaKE

全拼输入时，两个辅助码使用大写字母。双拼输入时，第一个输入的辅助码为小写时，使用正常顺序，第二码需要大写来触发双码辅助，例如 eK 匹配 ek。第一个输入的辅助码为大写时，第二码无论大小写都会触发双码辅助，并按反转顺序匹配，例如 Ke 或 KE 都会匹配实际辅助码 ek。

双拼双码辅助的大小写规则如下：

全拼辅助是在完整的全拼后追加辅助码：

阿：aE       # 单码辅助
阿：aEK      # 双码辅助
阿姨：ayiE   # 单码辅助
阿姨：ayiEN  # 双码辅助

双拼辅助是在完整的双拼编码后追加辅助码。以小鹤双拼为例：

阿：aae       # 单码辅助
阿：aaK       # 单码辅助，第二码优先
阿：aaeK      # 双码辅助
阿：aaKe      # 双码辅助，反转顺序
阿：aaKE      # 双码辅助，反转顺序
阿姨：aayie   # 单码辅助
阿姨：aayiN   # 单码辅助，末字辅助码优先
阿姨：aayieN  # 双码辅助
阿姨：aayiNe  # 双码辅助，反转顺序
阿姨：aayiNE  # 双码辅助，反转顺序

注意：辅助码只有在前面的全拼或双拼编码完整时才会生效。如果前面的拼音尚未完整，末尾输入的字母仍会按照普通拼音处理。

日语输入

设置 → 输入 → 输入模式选择「日文」后，使用罗马字输入。候选包括平假名、片假名和日语词库结果。中文方案会在切到日文时保留，切回中文后仍使用上次的全拼 / 双拼 / 五笔。

中文模式下也可开启临时日语（R 模式）：按 Shift + R 后，后续字母按日语罗马字处理；空格上屏首选，数字选其他候选，上屏后自动回到中文输入。

云联想

当前使用谷歌的云联想 API，对网络有所要求。云联想如果返回了当前本地不存在的结果，会插入在首页的第二项。网络不可用时，本地输入不受影响。

AI 联想

全拼和双拼输入时可异步请求 AI 联想。返回内容如果不与本地以及云联想重复，会插入首页第三项。接口异常时不影响本地候选。

提供商可选 DeepSeek、OpenAI、SiliconFlow、Groq，均走 OpenAI 兼容的 Chat Completions 接口。每个提供商的 Token 分开保存。可配置模型、候选数量上限、接口地址，以及最多三套自定义提示词。

候选词翻译

开启后，仅在竖排候选窗口中为候选项显示中文与所选语种的互译，每项最多两个简短释义。优先使用本地释义；本地未命中时可选择腾讯云 TMT，或填写自建 DeepLX 兼容服务的完整接口地址和可选 Bearer API Key，由云端补全。凭据只保存在本机配置文件中。

候选项调频

可以在设置中自行选定调频算法：

• 关闭：不调整顺序。
• 一次置顶：把触发调频的候选移到首位。
• 折半调频：把候选移到当前名次与首位之间。
• 线性调频：按固定步数向前移动（步长可设为 1～6）。
• 一次置前：前五名中的候选前移一位，第五名之后的候选提到第五名。

还可设置触发频次（同一候选累计选中多少次后才调整一次，1～6）。

preedit 显示设置

用户可以通过设置 → 外观 → 行内预编辑和设置 → 外观 → 候选窗预编辑来控制应用内的拼音串和候选框内的拼音串的显示风格以及是否显示。

行内预编辑可选「原始按键」「拼音分词」或「不显示」。候选窗预编辑可选「拼音分词」或「不显示」。两者相互独立。

中英混输、emoji / 颜文字混输和英文输入法模式

开启中英混输后，中文输入时会根据字母串补充英文候选。触发字符数可在设置中选择（1～8），达到该长度后才出现英文候选项。

emoji 混输会在英文候选之后插入匹配的 emoji；颜文字混输排在 emoji 之后。若同时开启云候选或 AI 联想，这些附加项会相应顺移。

在英文模式下，按下 Ctrl + Shift + E 可以切换到独立的英文输入法模式。这个模式与中英混输不同：中英混输是在拼音候选中补充英文，英文候选模式则专门按英文词库匹配当前字母串。

标点与以词定字

• 智能标点：中文标点状态下，逗号、句点或冒号前面紧接着字母或数字时，自动输出英文 , / . / :。
• 重复标点转中文：智能标点输出英文标点后，2 秒内再次输入同一标点，会替换为对应中文标点。
• 成对标点自动补全：输入左侧括号、引号等成对符号时，自动补上右侧符号，并把光标放在中间。
• 以词定字：开启后，按 [ 上屏当前高亮候选的第一个汉字，按 ] 上屏最后一个汉字。
• 中文标点状态下，\ 输入顿号 、，反引号输入间隔号 ·，Shift + 6 输入省略号 ……，Shift + - 输入破折号 ——，Shift + , / Shift + . 输入书名号 《 / 》。

实用功能快捷模式

均在中文状态下用 Shift + 字母 进入，可在设置 → 实用功能中分别开关。

剪贴板管理开启后，复制过的文本会出现在表情面板的剪贴板分页中；关闭会立即清空记录，且只记录文本。

语音输入

需要网络服务。可在右键菜单中开始或停止录音，也可使用快捷键：

• RAlt：长按录音，松开后识别。
• Ctrl + Win、RCtrl + RAlt：同样为长按录音。
• 录音时按 Space 可锁定，松开长按键也不会停止。
• Ctrl + F9：开始 / 停止录音，也可结束已锁定的录音。
• Esc：取消本次录音。

ASR 提供商可选豆包（流式）、OpenAI、SiliconFlow、Groq。豆包支持数字格式化、标点预测、语义顺滑和热词表。可选文本润色（SiliconFlow / OpenAI / DeepSeek / Groq），预设包括精炼整理、忠实校对、中翻英、口语整理，以及三套自定义提示词。

上屏方式可选 TSF、SendInput 或 Ctrl + V。豆包流式识别还可开启 inline 预编辑：已识别文字直接显示在输入框中，松开录音键后上屏（仅 TSF 上屏时生效）。录音期间可选择暂时静音其他应用的播放声音。

独立工具见 MetasequoiaVoiceInput。

手写、屏幕键盘、悬浮工具栏与皮肤

• 手写识别板：鼠标或触控书写后显示候选汉字。若没有结果，请确认 Windows 已安装中文手写包。
• 屏幕键盘：用鼠标或触控输入文字和快捷按键。
• 悬浮工具栏：可调整缩放和图标尺寸；中英文切换始终显示，其余组件（全角、标点、简繁、表情、屏幕键盘、设置）可按需勾选。
• 皮肤：Fluent 默认、微信绿、石墨 Graphite、杨柳青 Willow green。候选窗、工具栏等界面可分别跟随全局主题，或单独指定深色 / 浅色。

词库

设置 → 词库可切换全拼、五笔和英文词库，支持查询、新增、编辑、删除和批量导入；也可导入纯汉字词组（例如人名），由输入法生成拼音。拼音和五笔批量文件使用 Tab 分隔“词语、编码、权重”三列，因此词语内可保留空格。用户词库可分别导出，便于备份和迁移。快捷短语的导入导出在实用功能页。

服务守护

Server 启动时会同时启动 Watchdog。服务意外退出后，Watchdog 会自动拉起；短时间内反复崩溃会使用指数退避（最长约 30 秒），避免重启风暴。

开发与维护快捷键（输入法服务运行期间全局生效）：

• Ctrl + Shift + Alt + 1～8：删除当前候选窗对应位置的候选项。
• Ctrl + Shift + Alt + C：清除引擎缓存。
• Ctrl + Shift + Alt + R：重启输入法服务。
• Ctrl + Shift + Alt + T：立即退出输入法服务。

软件截图

开源协议

GPL-3.0。

参考

Windows 开源输入法参考

以下是一些 Windows 的开源输入法的参考项目。

• Microsoft TSF IME Demo
• weasel
• PIME
• WindInput

一些其他输入法相关的资源

• 微软双拼方案来源：https://www.bilibili.com/opus/550351671882601523