Lu Fan(SonnyCalcr)
ef28cf690d
* fix(ui): SVG 按整像素栅格化、滚动改为跟手的指数滑动，并可预热 D3D 设备 - GetSvgBitmap 按四舍五入的像素尺寸建位图，避免 D2D 向上取整后被挤压采样 - ScrollViewer 平滑滚动改为按帧时间逼近目标：连续滚轮不再每格从零速重起， 内容按整设备像素排布，滑动中文字不再抖动 - 新增 DeviceResources::PrewarmComposition，在后台线程提前创建 D3D11 设备， 首帧复用，省去约 200ms 的驱动初始化 * fix(server): 修复 Direct2D 设置窗口的图标、检查更新与热力图交互，加快冷启动 - 侧栏等 SVG 图标对齐设备像素绘制，不再发糊 - 关于页「检查更新」：页面持有状态，点击不再无反应；按钮加悬停描边与按下位移； 后台任务结果改为投递消息回窗口，窗口被遮挡时不再因 WM_TIMER 被压制而卡在「正在检查…」 - 弹窗按显式宽度测量内容，换行文字不再与下一行重叠 - 以 --about 打开时侧栏指示条落在「关于」 - 日历热力图可横向滚动（拖动滑块、点击轨道、Shift+滚轮），滚动条与竖向一致： 8px、无箭头、2px 圆角；悬停格子 500ms 后显示日期与字数 - 滚轮每格 60px；暗色主题首帧前不再闪白（按主题色擦底并在首帧前隐藏窗口） - 启动时预热 D3D 设备，首帧从约 300ms 降到约 140ms * fix(ui-html): 热力图滚动条与页面竖向滚动条一致，检查更新按钮加悬停与按下反馈 与 Direct2D 设置窗口的同步改动保持一致。
Metasequoia IME UI HTML
水杉输入法 Windows 端的界面资源。Server 加载这里的页面来渲染候选窗、悬浮工具栏、托盘菜单和设置窗口。
webview2/shared/ 是引擎 web 契约的副本，由 scripts/sync-contracts.py 从 ../engine/contracts/webview/ 生成，CI 用 --check 验证两者一致。要改契约请改那边，再在同一个提交里重新生成，不要直接改这个目录。
同仓的相关组件：../windows/（TSF 前端）、../server/（后端与窗口宿主）、../engine/（输入引擎与契约）。
目录
| 路径 | 内容 |
|---|---|
webview2/candwnd/ |
候选窗，含 skins/ 下的皮肤 |
webview2/ftb/ |
悬浮工具栏 |
webview2/menu/ |
托盘菜单 |
webview2/settings/ime-settings/ |
设置页，唯一需要构建的部分，Vite + TypeScript |
webview2/default-themes/、webview2/other-themes/ |
主题 |
除设置页外都是直接分发的静态资源，改完即生效。
构建设置页
设置页是发布安装包的必要输入之一，pnpm build 的产物 dist/ 会被打包脚本收集。
cd webview2/settings/ime-settings
corepack enable
pnpm install --frozen-lockfile
pnpm build
pnpm 版本由 package.json 的 packageManager 字段固定，corepack enable 之后不用自己装。开发时用 pnpm dev 起本地服务。
本地调试
把本仓链接到 Server 的数据目录，改页面就不用重新打包：
$target = Join-Path $env:LOCALAPPDATA 'metasequoiaime\html'
if (Test-Path -LiteralPath $target) {
Remove-Item -LiteralPath $target -Recurse -Force
}
New-Item -ItemType SymbolicLink -Path $target -Target (Resolve-Path .).Path
必须用绝对路径，Resolve-Path 就是用来把当前目录转成绝对路径的。设置页走这条路时链接的仍是仓库目录，页面读的是 webview2/settings/ime-settings/dist/，所以改完设置页要重新 pnpm build。
与 C++ 侧的边界
窗口归 Server，页面归本目录。HWND、尺寸、位置、DPI、Z-order 和 WebView2 controller 的生命周期都在 ../server/src/window/ 与 ../server/src/webview2/；页面结构、样式和浏览器端交互在这里。
C++ → 页面主要经 WebView2 导航和脚本执行，页面 → C++ 经 window.chrome.webview.postMessage(...)。改消息 type、JSON 字段、页面导出的 JS 函数或 DOM 标识时，必须同步检查 Server 的消息解析与拼接代码，两边没有编译期约束。
候选内容和输入状态的权威在 Server 和引擎，页面只负责展示与发出用户动作；不要在页面侧复制候选选择、翻页、输入模式或配置持久化的状态机。
完整的组件边界约定见仓库根 AGENTS.md。