Jia Sui
d4a0796400
原「智能标点」是小狼毫 digit_separators 的语义：字母或数字后的 , . : 直出英文， 2 秒内再按同一标点转回中文——后半段靠 SendInput 往应用里补一个 Backspace 再打 字符，落点全靠光标当时在哪。这次换掉主路径：输入中文标点后按空格，用 TSF 编辑 会话就地把它改写成对应英文（。，！？；：、 → . , ! ? ; : /），2 秒内再按同一标点 键撤回中文；原来的直出降为子开关，整个家族默认全关、改为显式开启。 - 按键与会话：转换/撤回是本地文档改写，不进 IPC、不进延迟队列；判据落在 _IsKeyEaten，OnTestKeyDown 的预判与 _DispatchKeyDown 的第二遍预判共用同一份， 声称吃掉的键不交还宿主。改写走编辑会话，请求不上时另起一个最小会话把键本身 的字符写回去，避免已吃掉的键静默丢失。 - 状态：原来散落的九个成员收成一个 SmartPunctuationAction（None / ChineseCommitted / AsciiConverted），带焦点令牌、前台窗口和 beforeChar 指纹；清理以分类结果为准， 丢焦点与上下文栈变化一并清掉。 - 转换范围：。，！？；：、 与单独出现的 “”‘’【】《》（） 都是映射表里的单字符 条目，路径完全一致；成对补全产生的一对（autoClosedPair）不 arm，按空格只落空格， 不会留下 <》 这类孤儿。 - 开关：总开关 + 中文标点后按空格转换 + 同键转回中文 + 数字后直出 + 字母后直出， 五键全部默认关；直出拆成数字/字母两个独立子开关（IPC 24 收窄为数字、25 追加为 字母），TSF 按前字符类型分别查键。 - 命名：子开关「独立符号」改名「中文标点后按空格转换」，配置键 smart_punctuation_standalone → smart_punctuation_space_convert，IPC 22 只改常量名 （SmartPunctuationSpaceConvertChanged），编号与语义不变、新旧测试包互通；设置页 文案同步重写，五处配置链路与死宿主一并跟改。 - 兼容：旧键未出厂、不迁移（升级合并按模板缺键丢弃、取默认 false）；编号 23 随 「按空格整体转换一对」的设计退役并留空不复用。 - 验证：TSF x86/x64 与 Server Release 编译、Server 335 单测、windows_ipc_contract x64/x86、设置页 build + 27 测试、clang-format 18.1.8 全绿。真机未跑。 Signed-off-by: Jia Sui <jsfaint@gmail.com>
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。