0 Fork 0

Files

T

Evan Hu 910c4e2b35 docs: give the README a download entry and correct the runtime requirement

README 此前没有任何下载、安装或 Releases 的入口，docs/installation.md 也没有被链接过。补一节放在开头。

安装文档里「Visual C++ 运行库无需单独安装」是错的：TSF DLL 确实是静态 CRT，但 Server 与设置程序用的是 x64-windows 动态三元组，缺运行库时进程直接退出。这正是官网下载页专门写了一整节的那个问题。已改正，并把原本空着的常见问题一节补上。

两段贡献方向清单与组织级招募帖逐条重复，收敛为入口加 Issue 标签筛选链接。

2026-09-05 19:10:14 +09:00

4.0 KiB

Raw Blame History

安装水杉输入法

适用版本：v0.0.9.2（2026 年 8 月 25 日发布，内测版）若你安装的是更新版本，请以 Releases 中的说明为准。

环境要求

项目	要求
操作系统	Windows 10 / Windows 11
处理器架构	同时提供 64 位与 32 位组件，x64 / x86 Windows 均可安装
磁盘空间	安装包约 61 MB，安装后占用约 250 MB［待确认：实测安装后目录大小］
网络	云联想、AI 联想、语音输入、候选词翻译等在线功能需要联网；离线状态下本地输入不受影响
其他	使用手写识别需先在 Windows 中安装「中文手写包」
Visual C++ 运行库	需要 x64 版。TSF DLL 采用静态 CRT 构建，被加载进宿主进程时不依赖 MSVCP140 / VCRUNTIME140；但 Server 与设置程序是动态 CRT 的 64 位程序，缺少运行库时会表现为服务反复退出、设置窗口一闪即关。详见下文常见问题

下载

打开 Releases 页面。
下载最新的安装包 MetasequoiaIME_Setup_v<版本号>.exe（例如 MetasequoiaIME_Setup_v0.0.9.2.exe）。

注意：当前发布版本均标记为 Pre-release（内测版），功能与稳定性可能变动，重要环境建议先在虚拟机或非主力机试用。参与内测与反馈：Telegram 群、QQ 群 829919142。

安装与注意事项

双击安装包，按安装向导提示完成安装。

安装默认路径是C:\Program Files\MetasequoiaIme
安装程序会把水杉输入法加入输入法列表，无须手动添加
安装完成后自动启动 MetasequoiaImeServer

在Windows中启用水杉

使用 Win + 空格 在已安装的输入法之间切换，或用 Ctrl + Shift 切换。

常见问题

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

绝大多数情况是缺少 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 无法启动，就是这个原因。

候选窗始终不出现

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

手写识别没有候选结果

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

其他问题

在 Issues 中反馈。为便于定位，请附上：输入法版本号、Windows 版本（Win + R 输入 winver）、出问题的宿主程序、以及最小复现步骤。

与按键、候选窗相关的问题，可以在 %LOCALAPPDATA%\metasequoiaime\config.toml 的 [general] 段设 tsf_diagnostic_log = true，复现一次后附上日志。日志中可能包含你输入的内容，贴出前请先自行检查。

4.0 KiB Raw Blame History Unescape Escape