Jia Sui
2557ee4a63
spec 校对时逐条核对「文件:行号」锚点发现，五处文档描述与代码现状不符： - windows/AGENTS.md：格式化遵循的是本目录 .clang-format，仓库没有根目录 .clang-format - 根 AGENTS.md：engine/... 前缀 include 只对 server/ 成立，windows/ 无仓库根，走相对路径 - scripts/format.sh：注释声称 CI 会跑 generate.py --check，实际没有任何 CI 作业调用 - server/AGENTS.md：测试源文件数与三处行号锚点过期 - server/CMakeLists.txt：注释里的 "eleven add_test()" 实际是 24 个，删去具体数字 纯文档与注释改动，无行为变化。
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 只引用这些头文件，不链接引擎运行库。