fanlusky
482e43c38e
去掉对按键回放、恢复前缀和「DeliveryAmbiguous 不能无条件本地重放」的描述， 新增「按键失败：不回放」一节：被吃掉的键要么处理、要么有意吞掉，绝不交还宿主、 绝不处理两次；失败时清组合、吞队列，从空开始。列出 Stale / Resync / Transport / Offline 四类失败的来源与动作，说明新增失败点应走 _FailDeferredKey / _ResetSessionAfterFailure 而不是单独调用 MarkNamedpipeSessionDirty*，以及翻页和 高亮移动键回复缺失是软错过。并注明派发 token 在代码里仍叫 deferredReplayToken。
windows —— TSF 文本服务
水杉输入法在 Windows 上的前端：一个纯 TSF 方案的文本服务 DLL，注入宿主进程，负责按键预判、焦点与线程归属、composition 的 edit session 写入，以及与 Server 之间的命名管道协议。候选窗、工具栏、设置页和实际的候选计算都在 ../server/，本目录只做宿主适配。
产品介绍、安装和功能说明见仓库根目录的 README；本目录的代码地图、TSF/COM 硬约定和改动要求见 AGENTS.md。
构建
从仓库根目录配置，源码目录是本目录：
cmake -S windows -B windows/build -A x64 `
-DCMAKE_TOOLCHAIN_FILE="$env:VCPKG_INSTALLATION_ROOT/scripts/buildsystems/vcpkg.cmake" `
-DVCPKG_TARGET_TRIPLET=x64-windows-static
cmake --build windows/build --config Release --parallel
ctest --test-dir windows/build -C Release --output-on-failure
Win32 用 -A Win32 和 x86-windows-static；安装包两种架构都要。scripts/ 下是本机开发用的生成、构建、注册和签名脚本，从本目录运行。
引擎契约来自 ../engine/contracts/，是本仓的目录，普通检出就有。TSF 只引用这些头文件，不链接引擎运行库。