FAQ

常见问题

安装后无法切换到水杉，或设置窗口一闪即关

绝大多数情况是缺少 Visual C++ 2015–2022 Redistributable（x64）。

TSF DLL 采用静态 CRT 构建，被加载进宿主进程时不依赖运行库；但 Server 和设置程序是独立的 64 位动态 CRT 程序，缺少运行库时会在启动阶段直接退出。典型表现：切换不到水杉、Server 反复退出、设置窗口打开后立即消失。

处理办法：到 微软官方下载页 下载 vc_redist.x64.exe 安装，然后重启 Windows。

x86 与 x64 是两套独立的运行库。 即使已装较新的 x86 版本，也不能替代这里需要的 x64 版本。若 Windows 事件查看器记录了 MetasequoiaImeServer.exe 或 MetasequoiaImeSettings.exe 因 MSVCP140.dll 或 VCRUNTIME140.dll 无法启动，就是这个原因。

候选项翻译功能只有部分候选项有翻译展示，短语没有翻译

这个功能需要自己配置 api key。这里建议优先使用小牛翻译。小牛翻译有持续的免费的额度赠送，足够在日常打字过程中使用。

首先，登录小牛翻译的网站，然后进入控制台，

接下来，把这里的 API-KEY 和 APIID 填写到设置中，即可生效。

如果不确定填写的配置是否生效，可以点击下面的测试配置的按钮进行测试。

候选窗始终不出现

先确认已安装 Microsoft Edge WebView2 Runtime（在「设置 → 应用 → 已安装的应用」里搜索 WebView2）。当前版本的候选窗由 WebView2 渲染，运行时缺失会导致窗口无法显示。

手写识别没有候选结果

需要先在 Windows 中安装「中文手写包」：设置 → 时间和语言 → 语言和区域 → 中文（简体，中国）→ 语言选项 → 手写。

云联想 / AI 联想 / 语音没反应

这些是在线功能，需要联网。请确认：网络可用、对应功能已在设置中开启、并已正确填入所需的 API Token 和接口地址。离线时本地输入不受影响。

辅助码打了没生效

辅助码只有在前面的拼音 / 双拼编码完整时才生效。如果前面的拼音尚未完整，末尾输入的字母会按普通拼音处理。大小写规则见 功能与配置。

如何反馈问题

在 Issues 中反馈。为便于定位，请附上：

• 输入法版本号
• Windows 版本（Win + R 输入 winver）
• 出问题的宿主程序
• 最短复现步骤

与按键、候选窗相关的问题，可在 %LOCALAPPDATA%\metasequoiaime\config.toml 的 [general] 段设 tsf_diagnostic_log = true，复现一次后贴上日志。

⚠️ 日志中可能包含你输入的内容，贴出前请先自行检查，并注意不要在截图或日志中泄露 API Key 等敏感信息。

交流群

• Telegram：https://t.me/msimegroup
• QQ 群：829919142