企业官网建设流程全解析

水杉输入法（MSIME）是一款免费开源的下一代跨平台中文输入法，一套共享输入引擎同时覆盖 Windows、macOS、Linux、Android、iOS 与 HarmonyOS（鸿蒙）六大平台，支持全拼、双拼、五笔、日文、韩文、粤拼、注音、越南文、藏文和笔画等方案，安装后即可体验整句联想、拼写纠错和个性化学习。本文按平台逐一给出从下载安装到首次打字的完整步骤，零基础也能 10 分钟上手。

安装前快速了解：水杉输入法支持哪些平台？

先确认你的设备属于哪一列，再跳转到对应章节。每个平台都有自己的原生宿主，共享同一套 Rust 输入引擎（crates/engine），架构说明可看 docs/ARCHITECTURE.md。

💡 小提示：手机版本（Android、iOS）目前仍标注为测试版，桌面端功能最完整。各平台发布完全独立，版本号互不相通。

Windows 安装步骤：双击安装包，再点一下「去添加」

Windows 版通过 Inno Setup 安装包分发，安装器会注册 TSF 输入服务并随包附带词库，源码打包脚本见 installer/msime_setup.iss。

1. 到官方下载页取回 Windows 安装包，双击运行，按向导完成安装；
2. 安装完成后安装器自动启动 Server，首次准备运行配置成功时会自动打开设置窗口首页；
3. 设置页顶部的「输入法状态卡」会检查水杉是否已加入 Windows 键盘列表、是否为当前输入法，点击「去添加」和「设为默认」即可；系统拒绝自动修改时，它会打开「设置 → 时间和语言 → 语言和区域」供你手动添加；
4. 切到输入法的编辑器里敲拼音，开打。

喜欢命令行的话，Windows 也上架了包管理器（包定义模板见 platforms/windows/packaging/）：

winget install Metasequoia.MetasequoiaIME # 或 Scoop：scoop bucket add msime 后 scoop install msime # 或 Chocolatey：choco install msime

📌 卸载默认保留数据目录（词库、学习记录、设置、皮肤），重装后接着用，不会丢学习数据。

macOS 安装步骤：pkg 安装 + 输入源注册两步走

macOS 版是 InputMethodKit 输入法 bundle（产物名水杉输入法.app），发布包为同时支持 Apple 芯片和 Intel 的 universal pkg，安装方式就是「下载、双击、能打字」。设置应用内嵌的输入法图标如下：

1. 双击 pkg 安装包，按提示输入管理员密码，装到/Applications，结束后设置应用（MSIME.app）自动打开；
2. 首次安装时设置应用先弹出安装窗口，点「立即安装」，它会把内嵌的输入法复制到~/Library/Input Methods并注册输入源，几秒完成；
3. 全新机器上这一步之后窗口会提示「还差一步：注销并重新登录」——这是 macOS 对首次出现的新输入源标识符的固有限制，重新登录后即可被系统看到；
4. 进入「系统设置 → 键盘 → 文字输入 → 输入源」添加水杉，选择输入法方案（全拼/双拼/五笔等）开始输入；
5. 之后输入法本体通过 Sparkle 静默自动更新，不用再下载安装包。

⚠️ 注意：如果输入源没出现在添加列表里，先看设置页顶部的状态提示，按提示「打开键盘设置」；仍不行就注销重新登录一次。开发者自签安装（ad-hoc 签名）无法被系统登记为输入源，请从官方渠道下载。开发机侧的安装脚本为 scripts/install.sh，它负责重签名、原子替换与注册核查。

Linux 安装步骤：装包后补词库，IBus 与 Fcitx5 任选

Linux 版提供 IBus 与 Fcitx5 两条并列的系统入口（链接同一份 host-api ABI），发布包由 CPack 产出 DEB 与 TGZ，完整说明见 platforms/linux/README.md。

1. 安装 DEB / TGZ 安装包（按你的发行版选择），postinst会自动注册本机匿名账号；
2. 安装本身不准备词库，首次运行配置工具补齐（词库首次下载约 270 MB，按词库锁逐项校验 SHA-256）：

msime-linux-setup --download # 按随装的词库锁取回缺失词库并准备运行配置 msime-linux-setup --list-downloads # 只列出下载地址、大小与 SHA-256，不联网配置

3. 注册输入法：msime-linux-setup --register，或在 IBus 输入源列表 /fcitx5-configtool中选中「MSIME」；
4. 默认快捷键Ctrl+Space切换中英文，开始输入。

📌 下载慢时，可在首次配置页展开「手动下载词库」，用浏览器按清单保存后再点「开始配置」。GNOME Wayland + Fcitx5 场景若遇到候选窗闪烁，README 中给出了~/.xinputrc的排除方案。

Android 安装步骤：APK 直装，六个版本可共存

Android 版是独立的输入法服务（app.msime.android.MSIMEInputService，跑在:ime进程），发布包是不含 Tauri/React 的原生 Java 设置 APK，构建脚本见 build-apk.sh。

1. 下载msime-android.apk（或对应版本包），允许「安装未知应用」后直接安装；
2. 打开系统「设置 → 键盘/输入法」，在键盘列表勾选水杉输入法并设为当前输入法；
3. 首次启动按引导选择输入方案（full 版提供全拼、双拼、五笔、手写、日文、粤拼、注音、越南文、藏文、笔画等）；
4. 日文词典、五笔码表等附加词库为按需下载，选到对应方案时才会在设置里下载，启动时不会偷偷联网拉资源。

✨ 亮点：full、拼音、五笔、日语、越南语、藏文共 6 个版本 applicationId 各不相同，可以同时装在一台手机上，数据彼此隔离。

iOS 安装步骤：添加键盘扩展 + 允许完全访问

iOS 版是一个原生 App 内嵌键盘扩展（MSIMEKeyboardExtension），两者通过 App Group 共享状态，签名与安装细节见 platforms/ios/README.md。

1. 安装 App（正式发布前需经开发者签名，真机装机的xcodebuild流程与 TestFlight 步骤见 iOS 宿主文档）；
2. 进入「设置 → 通用 → 键盘 → 键盘」，添加「水杉输入法」；
3. 在水杉键盘详情里打开「允许完全访问」（语音输入等功能需要）；
4. 任意输入框长按地球键切到水杉键盘，敲拼音即可出候选；
5. 粤拼、大千注音、越南语、笔画等附加方案默认关闭，在 App 的「输入方案」页打开后才会出现在键盘的方案选择里，缺失词库时对应方案自动隐藏。

HarmonyOS 鸿蒙安装步骤：装完直接进系统输入法列表

鸿蒙版由 ArkTS 的KeyboardExtensionAbility承载键盘，经 NAPI 模块libmsimeclient.so调 host-api，构建发布细节见 platforms/harmony/README.md。

1. 安装 HAP 包（零售设备需 AppGallery Connect 签名的正式包）；
2. 打开 App，首页五个动作中的「设置」会直接打开系统输入法列表——这就是安装第二步的去处；
3. 在系统输入法管理里选中水杉并启用，即可在所有输入框使用；
4. 词库随 HAP 内置（含发音词典），无需额外下载；按华为应用市场要求，鸿蒙版暂不提供需要实名认证的 AI 生成类功能，属于正常裁剪。

📱 注意：API 12 起输入法扩展使用独立沙箱，与设置应用互相看不到对方files/，这是系统机制，不属于安装失败。

安装完成后的通用注意事项

• 词库更新：六大平台的设置应用默认每天检查一次官方词库 Release，自动下载兼容版本并按 SHA-256 交叉校验，可手动检查或恢复上一版；
• 隐私：新装的默认配置下，没有任何功能会把你的输入内容发出设备；匿名使用统计（不含输入内容）默认开启，可在设置里关闭，逐条核对见 PRIVACY.md；
• 项目协议：源码 GPL-3.0-only，输入引擎msime-engine单独为 MPL-2.0，全文见 LICENSE 与 README.md。

按上面的清单操作，六大平台的水杉输入法都能顺利装上。遇到平台特有的坑（如 macOS 首次登录限制、Linux 词库下载），对应章节的 README 都有专门一节可以对照排查。祝你输入愉快！🚀