fanlusky
f91dae7644
release.yml runs the Server job on a persistent self-hosted runner while ci.yml runs it on a fresh windows-2025 image, so only the release path kept a MetasequoiaImeServer.exe alive between jobs. That leftover holds Local\MetasequoiaImeServer_SingleInstance, the Server started by probe-server.ps1 returns 0 straight out of the guard, and the probe then completes its handshakes against the older build. Probes 1-4 pass because they do not ask for CharacterSetShortcut; probe 5 does, the pre-6ff1cff Server never advertises it, and the run dies on a capability mismatch that nothing in the tree can explain. v0.6.3 and v0.6.4 both failed this way. Stop any Server and Watchdog before starting one, and fail loudly if the Server this script starts exits on its own. Also stop test-server.ps1 from reporting every non-zero verify-contracts exit as a lock mismatch. A dubious-ownership git failure on the same runner surfaced as "The engine submodule does not match the product lock" while the lock was correct. Also ignore installer/LICENSE.txt, which Prepare-PackageFiles.ps1 generates from the repository LICENSE on every local packaging run.
Metasequoia IME Installer
本目录的脚本从 Windows 合仓目录收集产物、签名、用 Inno Setup 打成安装包。它服务两条流程：
- 正式发布：由
MSIME-Windows的 release workflow 驱动，用真实证书签名MetasequoiaImeServer.exe（保证uiAccess生效）和最终安装包；产物是挂在 Release 上的MetasequoiaIME_Setup_v<版本>.exe，并携带与 Release 二进制匹配的 PDB 符号文件。见下面「CI 契约」 - 本地测试：手工跑，用本机自签名证书，用来在自己机器上验证安装流程。本文其余部分讲的是这条
版本号不是固定的，由 Prepare-PackageFiles.ps1 的 -TargetVersion 决定，默认 0.0.1；正式发布时 CI 传入真实版本。
本仓库 不包含 正式代码签名证书、私钥、指纹，也不包含编译好的 EXE/DLL、词库或安装包。
签名脚本会在你自己的机器上生成并复用一张自签名测试证书。
CI 契约
根 .github/workflows/release.yml 不加修改地调用本目录的 Prepare-PackageFiles.ps1 和 Compile-Installer.ps1。源目录名是 Prepare-PackageFiles.ps1 的参数，不是写死在脚本里的字面量：默认值为 windows/、server/、ui-html/ 和仓根授权文件；旧目录或自定义布局通过参数覆盖。回归检查同时执行默认路径和显式参数的打包。辅助码默认读取 vendor/MetasequoiaImeEngine/helpcode/，词库缓存位于 MetasequoiaImeDict/out/。
合仓后 release workflow 传的是本仓的目录名，辅助码随固定 Engine gitlink 检出，词库按产品锁下载到仓根缓存：
pwsh -File ./Prepare-PackageFiles.ps1 -TargetVersion 1.2.3 -RepoRoot .. `
-TsfDirectory windows -ServerDirectory server `
-UiHtmlDirectory ui-html -NoticesDirectory .
由此产生几条约束：
- 改动
Prepare-PackageFiles.ps1里那些Assert-PathExists的源路径，会直接弄坏发布流水线。 它断言的源路径由 workflow 逐一准备，改了要同步改.github/workflows/release.yml。目录名本身可以由调用方指定，但每个目录内部的相对路径（如build-release\bin\Release）仍是硬契约 THIRD_PARTY_NOTICES.txt从-NoticesDirectory指向的目录取，随安装包装到程序目录。 合仓后这份声明覆盖整个产品、放在仓根，所以它和-TsfDirectory分成了两个参数。词库主体含 rime-ice（GPL-3.0）内容，其许可要求保留署名，所以这份文件缺失会让打包直接失败，而不是静默跳过Sign-PackageBinaries-Local.ps1和Sign-Installer-Local.ps1只用于本地验证，CI 不会调用它们。 它们创建本机自签名证书并尝试写入受信任存储，正式发布走 workflow 里用仓库 secret 中真实证书的签名步骤- 词库不再从相邻的
MetasequoiaImeDict工作目录取，CI 从MSIME-Engine的dict-*release 下载并校验 SHA256，再放到脚本期望的位置 windows-2025runner 自带 Inno Setup 6.7.1，Compile-Installer.ps1能自己找到ISCC.exe。但它不带ChineseSimplified.isl，msime_setup.iss的[Languages]段依赖那个文件，所以 workflow 会在编译前按固定 revision 和校验和把它装进去
依赖
- Windows 10/11，PowerShell 7（
pwsh） - Inno Setup 6.6 或更高版本
- Windows SDK（提供
signtool.exe） - 先初始化本仓 submodule，并完成
windows/、server/的 Release 编译以及ui-html/设置页构建。Release 构建必须生成同目录 PDB；打包脚本会拒绝缺少匹配符号的产物。 - 在仓库根目录运行
python scripts/product_lock.py fetch-dictionaries --staging-root .，下载并验证产品锁中的词库。 vendor/MetasequoiaImeEngine/helpcode/helpcodes/随引擎检出，无需旧 HelpCode 仓库。
本地打包路径
从 installer/ 运行上面的带参数打包命令即可。-RepoRoot 指向 MSIME-Windows 根目录；目录不同时通过参数指定，无需编辑脚本中的复制路径。
一键测试
先准备上述构建依赖与锁定词库。然后在管理员 PowerShell 中（把本机测试证书写入受信任存储需要提升权限）：
cd path\to\MSIME-Windows\installer
pwsh -File .\test.ps1
test.ps1 会按顺序做这些事：
- 编译本仓 TSF、Server，并构建设置页；缺少组件入口则失败
Prepare-PackageFiles.ps1— 收集server_exe\、tsf_dll\、app_data\及匹配的 PDB，并把msime_setup.iss的版本写成0.0.1Sign-PackageBinaries-Local.ps1— 本机自签名包内 EXE/DLLCompile-Installer.ps1— 编译出Output\MetasequoiaIME_Setup_v0.0.1.exeSign-Installer-Local.ps1— 本机自签名安装包Install.ps1— 启动安装程序
也可以按上面的顺序逐步运行。
本机测试证书
第一次运行签名脚本时，会在当前用户证书存储里创建：
CN=Metasequoia IME Local Test Code Signing
之后复用同一张证书。产物只适合本机或已导入该证书公钥的测试机，不要当作正式分发包。
想让另一台测试机信任这张证书，把公钥导出成 .cer 后在那台机器上执行：
certutil -addstore Root MetasequoiaImeLocalTest.cer
certutil -addstore TrustedPublisher MetasequoiaImeLocalTest.cer
不要把 .cer / .pfx 提交进本仓库。