0 Fork 0

Files

T

Evan 4fc16952b3 wip(windows): 补齐隐私与许可交付，修好外部人的构建入口

- 新增 PRIVACY.md：逐项写明每个联网端点、发送内容、默认开关与关闭方式，明确云候选默认开启、
  token 在 config.toml 明文存储、无任何遥测
- 设置页「用户协议」「隐私政策」两个无 handler 的死按钮接上；前者改名为「开源许可协议」指向
  LICENSE，开源产品的用户条款就是许可证本身，不再承诺一份不存在的 EULA
- 安装包随包装入 GPL 正文并在安装向导显示（GPLv3 §4/§6），补上打包测试断言
- release.yml 增加 build provenance attestation，并在发布后向 MSIME-Web 发 repository_dispatch，
  让 msime.app/update.json 不再等两小时一次的 cron
- 所有 CMakePresets 的 vcpkg 路径改用 $env{VCPKG_ROOT}，server 的 Boost 回退不再指向个人目录
- ui/README.md 指向本机绝对路径的 markdown 死链改成相对链接
- 新增 check-developer-paths.sh 并接入 required 的 quality 检查，防止路径回潮
- docs/installation.md 不再写死版本号

2026-09-06 12:05:06 +09:00

4.6 KiB

Raw Blame History

安装水杉输入法

本文描述当前内测版的安装流程。具体版本号、下载链接与该版本的已知问题一律以 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。

Releases 页面上有两类发布，都标记为 Pre-release，靠标题区分：

标题形式	来源	建议
`v<版本号>（自动构建）`	每次合并到 `main` 后由 CI 自动构建发布，未经人工挑选	想要最新修复、且能接受未经验证的改动时用
`v<版本号>`	人工挑选后发布	一般情况下用这个

GitHub 的发布只有 Latest / Pre-release / Draft 三种状态，没有自定义频道，因此两类共用同一个 Pre-release 列表。

安装与注意事项

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

安装默认路径是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.6 KiB Raw Blame History Unescape Escape