Commit Graph
555 Commits
Author SHA1 Message Date
fanlusky 663f72301d fix(server): 独立上屏的整句候选也落库
上一个提交改的是 InputSession::commit(),而 Windows 前端根本不走那条路:选词由
ProcessSelectionKey 自己驱动。那里 CandidateSource::Generated 走提前返回,落库的
闸门 ShouldStoreEarlyReturnPhrase 要求造词前缀非空,也就是只认"先选前缀、再用整句
收尾"这一种形状;用户直接选一条完整的整句时 creating_word 没激活,条件为假,什么
也不做就返回了。Google 解码器那条整句(Fallback)不在提前返回的名单里,走普通
路径,但同样没有行可以调频。

因此拆出 ShouldStoreStandaloneSentence:整句候选独立上屏时就该落库,带 7 音节
上限(对标 quanpin::WordLatticeOptions::max_phrase_syllables)。接在造词前缀
后面的那一支由用户一段段选出来,维持原样不设限。

顺带修掉同一处的读音拼接:前缀为空时不能带上那个分隔符,'na'yi'tiao 这种前导
撇号会让整条读音作废。

原先有一条测试把这个缺陷钉住了(断言没有前缀就不落库),按新的意图翻过来。
2026-09-19 13:48:26 +08:00
Lu Fan(SonnyCalcr) 4dea1cd12f Merge pull request #420 from metasequoiaime/feat/ctrl-arrows-segment-caret
feat(input): 组词内按分词的光标与删除(#35 / #187 / #347)
2026-09-18 12:35:52 +08:00
Jia Sui 2576986881 feat(windows): Ctrl+左右键按分词移动光标
组词中 Ctrl+Left/Right 按一个字的拼音(音节段)移动光标,
与 Ctrl+Backspace 的删除粒度共用同一套引擎分段边界。

- 闸门归纳为 SegmentEditFunction(code, modifiers):Ctrl-only + 组词存在,
  VK_BACK/LEFT/RIGHT 分别映射到 segment 函数;三处判据与延迟投影共用
- 新增 FUNCTION_MOVE_LEFT_SEGMENT / FUNCTION_MOVE_RIGHT_SEGMENT,
  编辑会话只按 CompositionRestored 的 caret 移动本地光标,不重建 buffer
- Server 用 segment_raw_boundaries() 取前/后边界,能力位与非 UiLess 时回包;
  非拼音/本地模式/UiLess/旧端仍按单字符 ±1 回退

Refs #187
2026-09-17 23:36:34 +08:00
Jia Sui b1ec3ab1e0 feat(server): Ctrl+Backspace 按分词删除前置拼音(#187)
组词中 Ctrl+Backspace 删除光标前的一个分词单元:剩余拼音非空时删
最后一个字的拼音(音节段),剩余拼音为空时删除最后一段已选分词。

engine:
- InputSession::segment_raw_boundaries() 作为按段删除/移动的唯一分段来源:
  全拼把纠错显示串的分隔符映回 raw 下标,双拼与 pinyin_segmentation 共用贪心谓词,
  2 字辅助码自成一段;非拼音方案与本地模式返回空表示无单位模型
server:
- IsSegmentBackspaceKey(Ctrl-only)、整段丢弃 / 边界截断 / 单字符回退三分支,
  截断点残留分隔符清理
- 复用 CompositionRestored 回包(含 caret),仅协商能力位且非 UiLess 时发送;
  新出现「只剩已选汉字、无拼音」的中间态
windows:
- 两处 Ctrl 闸门对组词中的 Ctrl+VK_BACK 放行,新增 FUNCTION_BACKSPACE_SEGMENT
  与 _HandleCompositionBackspaceSegment(读回包重建,失败回退单字符)
- 空 raw 状态渲染、终态清理 word_for_creating_word,延迟投影失效处理

Closes #187
2026-09-17 23:01:31 +08:00
fanlusky bc37ac9a9e feat(installer): 安装时可自定义数据目录位置
词库、用户配置和皮肤此前固定在 %LOCALAPPDATA%\metasequoiaime,整包几百 MB
全压在 C 盘。安装向导新增一页,允许把这部分数据放到任意盘。

程序本体仍固定装在 Program Files:MetasequoiaImeServer.exe 带 uiAccess=true,
只有在受信任目录里这个标志才生效。

运行期的权威来源是 HKLM\Software\Metasequoia\MetasequoiaIME 的 DataDir。
Server、TSF DLL 和引擎三个组件各自按同一顺序解析:METASEQUOIA_IME_DATA_DIR
环境变量 -> 该注册表值 -> %LOCALAPPDATA%\metasequoiaime。三处各持一份实现,
因为组件边界规则禁止 windows/ 与 server/ 互相 include。32 位 TSF DLL 用
KEY_WOW64_64KEY 读,避开 WOW64 重定向。

安全相关的两个约束:

- 安装器在数据目录里写 .metasequoiaime-data 标记。覆盖安装的清理和卸载的整目录
  删除只在看到这个标记(或目录就是历史默认位置)时才执行——用户可能把数据目录
  指到一个本来就有自己文件的文件夹。
- 选择页与 /DATADIR= 走同一套校验:拒绝相对路径、盘符根目录、不存在的盘、程序
  目录内部,以及 Windows/Program Files/各 AppData/用户主目录本身。

升级时改了位置,PrepareToInstall 在停掉输入法进程后用 robocopy /MOVE 搬运用户
拥有的数据(msime_user.db 及其 WAL/SHM/journal、config.toml、config.base.toml、
skins\),词库和前端资源由本次安装重新写入。跨卷移动目录 MoveFile 会失败,所以用
robocopy。用户词库搬运失败会中止安装:否则新版本对着空的 msime_user.db 启动,
ssPostInstall 的回放只记一句 skipped,用户的自造词就静悄悄没了。

测试侧新增 METASEQUOIA_IME_CONFIG_DIR,只改 config.toml 的位置而不搬词库。原先
靠重定向 LOCALAPPDATA 做隔离的办法在装了正式版的机器上已不再成立——注册表值
的优先级高于它。
2026-09-17 22:49:19 +08:00
fanlusky a898c3b11c feat(candidate): Ctrl+Enter 上屏候选右侧的译文
候选框开着且高亮候选带译文时,Ctrl+Enter 上屏那条译文而不是候选本身。
译文只有一条就直接上屏;有多条时把候选框整个换成这几条译义,空格/数字键
照常选一条上屏。

TSF 端原先在分类器最前面把所有 Ctrl 组合都还给应用,Ctrl+Enter 到不了
Server。现在在那条拦截之前先判一次:候选框开着才认,否则组合仍归应用。
认下来的键走既有的 FUNCTION_SERVER_CANDIDATE_KEY 通道,由 Server 决定
是上屏(CommitExactText)还是只开一个新候选页(NavigationIgnored)。

译文页复用同一份 candidate_ui.items,因此云/AI/英文/emoji/颜文字这些异步
回调和候选扩展都要在这个子模式下让路,否则会把译文冲掉。输入串全程没动,
退出时把存下来的 items 和页码原样放回去即可。译文页上的空格/数字键只回
Normal / OutofRange——SELECT_BY_NUMBER 的 TSF 路径只认这两种。
2026-09-17 20:21:56 +08:00
Jia Sui e64195731e feat(server): Backspace 删空剩余拼音后退选已选分词(#35)
已选分词是造词中间态:删空剩余拼音时不再整条 composition 丢弃,
而是退选最后一段并恢复其原始拼音与候选。

engine:
- SelectionTransition 暴露本次选择消费掉的原始输入(保留大小写与双拼按键)
engine/contracts:
- 新增回复类型 CompositionRestored=14 与能力位 CompositionRestore;
  MaxKnown 同步抬高,Server 按协商能力位门控发送,旧 DLL 不会收到未知帧
server:
- 造词中间态压 (consumed_raw, previous_creating_word) 快照,边界 Backspace 弹栈退选
- 任何清空 raw 的路径同时清 creating_word 与快照历史,避免跨 composition 泄漏
windows:
- _HandleCompositionBackspace 提示退选时读回包重建 keystroke buffer / word / 预编辑 / 光标
- NeedToCreateWord 与 CompositionRestored 共用载荷解析;旧 Server 与 UiLess 回退旧行为

Closes #35
2026-09-17 18:45:01 +08:00
Jia Sui d4a0796400 feat(windows): 重构智能标点
原「智能标点」是小狼毫 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>
2026-09-17 09:29:57 +08:00
fanlusky ef7840a4c6 fix(voice): 语音条水平按整屏居中,任意任务栏边缘都居中偏底部
上一版改用工作区(rcWork)定位后,任务栏在左/右边时工作区被挤窄,
水平中心会相对屏幕中心偏移,语音条不再位于屏幕正中。

明确目标行为:任何情况下都让语音条“屏幕水平正中、偏底部”。
 - 水平改回按整屏矩形(rcMonitor)居中,不受左/右任务栏影响;
 - 垂直仍贴工作区(rcWork)底部,自动避开底部任务栏。

把 GetMonitorWorkArea() 换成一次解析同一显示器、同时返回整屏与工作区的
GetForegroundMonitorMetrics(),供上述两个维度共用,避免两次解析落到不同
显示器。
2026-09-16 16:12:24 +08:00
fanlusky 7e493b6a6d fix(voice): 语音条按工作区定位,兼容任务栏在任意边缘
update_window_bounds() 此前用"整屏矩形 - 底部任务栏高度"来定位语音条,
隐含假设任务栏在底部。任务栏放到左/右/上边时,语音条会算偏(位置错误或
与任务栏重叠)。

改为使用显示器工作区(MONITORINFO.rcWork)——它已扣除任意边缘的任务栏/
应用栏,水平居中于工作区、贴其底部上方 10px 放置。任务栏在底部时行为不变
(rcWork.bottom == monitor.bottom - taskbar_height)。

顺带把只服务于旧定位方式的 GetTaskbarHeight() 与返回整屏矩形的
GetMonitorCoordinates() 替换为 GetMonitorWorkArea()(二者原本仅此一处使用),
并移除不再需要的 <shellapi.h>。
2026-09-16 16:07:37 +08:00
fanlusky 510f70c1a5 fix(voice): 语音条适配分辨率/DPI 切换——与候选框一致
语音提示条(WaveOverlay)在切换屏幕分辨率/DPI 后尺寸与缩放错乱,
候选框已有的适配逻辑此前未覆盖到语音这一块。根因有二:

1. update_dpi_scale() 用 GetDpiForWindow(hwnd_) 取缩放,而定位用的是前台
   窗口所在显示器(GetMonitorCoordinates),两者可能不同源,且切换分辨率
   时 GetDpiForWindow 可能返回陈旧值。改用 GetDpiForMonitor(MDT_EFFECTIVE_DPI)
   按目标显示器计算,与候选框 ScaleFromMonitor 同一套技术,并让定位矩形与
   缩放同源。
2. ID2D1HwndRenderTarget 的 DPI 只在创建时定过一次,切换后不更新,导致
   draw() 里逻辑坐标映射到错误像素尺寸。现在在 update_dpi_scale() 中同步
   刷新渲染目标 DPI(等价于候选框 SetDpiOverride/SetDpi)。

同时把 WM_DISPLAYCHANGE 从 WM_PAINT 分支拆出单独处理,并让
update_window_bounds() 每次重新定位都刷新缩放,对齐候选框"每次显示都
重算"的行为。
2026-09-16 15:49:19 +08:00
Jia Sui b149a500b0 fix(server): 按数字选词偶发选错——以屏幕上的候选列表为准
按数字 2 想选第 2 个词,有时上屏的却是第 1 个:后台按手里的最新候选列表
数序号结算,而用户看到的是窗口还没重画完的旧画面;调频(一次置顶)每次
选完都改顺序,两者的时间差就会撞出「看 2 选 1」。关掉调频或固定候选位置
后顺序不再变化,问题消失——与报障观察一致。

修法:候选列表带版本号,窗口画完后回报画到第几版;按数字或空格时如果
窗口还没画到最新,后台最多等 30 毫秒再按用户看到的那一版结算。等待上限
是硬约束:必须留在 TSF 50ms 回复窗口内,超时会触发管道重连与按键重放。
窗口不可见、宿主自绘(UILess)、鼠标点击不等待。

- 发布候选页时递增版本号,快照携带该值;
- D2D 绘制完成、WebView2 DOM 回调(含 dedup 分支)回写实际渲染快照的版本号,
  异步回调捕获快照值而非回读实时值;
- 单测覆盖等待判定与 30ms 常量;阴性验证:等待失效时「落后 → 等待」用例
  失败,恢复后 333 项测试全绿;
- 真机验证(调频 pin + 快速同拼音 + 连按数字)待跟进。
2026-09-15 11:02:39 +08:00
fanlusky 5a5dea6b7e feat(japanese): 日语模式禁用 -/= 翻页并用 - 打长音符
日语模式下把 - 让给长音符(ー)输入,同时禁掉 -/= 的候选翻页:

- 罗马字方案接受 VK_OEM_MINUS,set_raw_input 不再把 - 过滤掉;
  罗马字表里本来就有 - 到 ー 的条目,只缺按键准入。
- n 后面接 - 时按辅音处理,让前面的 n 收成 ん,避免 n- 卡在 pending。
- 空编码时单独按 - 也起头组合,候选框第一项是 ー、第二项是普通 -。
- 组词流程同样适用:判据只看日语模式加组合状态,不再走翻页和词转字。
- -/= 在日语模式下不翻页,_ = + 这些没有假名写法的字符退回标点上屏,
  并把 = _ 补进服务端的标点集合,和 TSF 侧保持一致,否则会等不到回包。

TSF 侧的影子分类、IsVirtualKeyNeed(ForFreshComposition) 和服务端按键策略
三处同时改,统一以配置项 input_mode == japanese 为判据(R 模式不在范围内,
TSF 侧看不到临时会话,用会话类型判断会让两侧分类打架)。
2026-09-15 01:57:50 +08:00
fanlusky 9e2aedc915 chore(settings): 调整设置启动页提示文案与字号
将启动动画页的副标题提示由「首次启动可能需要稍等片刻」改为
「冷启动可能需要稍等片刻」,并将该行字号由 13.0 DIP 加大到 14.0 DIP。
2026-09-15 00:27:58 +08:00
Evan 30a22e6f3d feat(ipc): reserve dedicated voice control pipe 2026-09-14 19:04:20 +08:00
Evan b10b8184d3 fix(ipc): reject malformed voice control fields (#398) 2026-09-14 10:40:29 +00:00
Evan 6b33e678fb feat(ipc): dispatch validated voice lifecycle commands 2026-09-14 10:32:24 +00:00
Evan 497b46e067 feat(ipc): validate voice control leases
* feat(ipc): validate voice control leases

* style(ipc): format voice control dispatcher

* fix(ipc): use local engine contract path
2026-09-14 18:21:49 +08:00
Evan e31964ce4f feat(voice): expose serialized lifecycle controls 2026-09-14 10:01:18 +00:00
Jia Sui 3dea733f64 fix(ui,server): 候选窗 D2D 阴影按皮肤对齐 webview——Card 支持 pass 列表
D2D 候选窗的 Card 阴影是内置 Win11 漫射三层(σ11/6/2.8,α0.42/0.30/0.48):
四边对称、无偏移,紧贴边缘合成 α≈0.49、暗晕铺到 15~20 DIP。webview 端候选窗
皮肤 CSS 用的是带右下偏移的双层软阴影(light: 8px 10px 24px rgba(0,0,0,.18)
+ 2px 3px 8px rgba(0,0,0,.10))。用户实机截图剖面实测:webview 底边峰值 α≈0.16、
D2D 0.41,差 2.5 倍,即「D2D 阴影偏重」的根因。对称三层无论怎么调参都拟合不了
带偏移的衰减曲线;浮动工具栏已有的 SetShadowScale 只缩模糊半径压不了深度
(高斯在边缘恒贡献 α/2)。

给 Card 拆出数据驱动的阴影 API,阴影参数跟皮肤走(与颜色/圆角同模式):

- ui/include/msimeui/Layout.h、ui/src/Layout.cpp:ShadowPass{σ,α,offset} +
  SetShadowPasses(空列表保持内置 Mist 三层,逐位不变)、SetShadowEnabled
  (整体开关,语义对齐 Popup 同名 API)、SetShadowOpacity(uniform 缩 α,与
  SetShadowScale 正交);渲染统一走 DrawGaussianShadowPass,无 device context
  时兜底 DrawLayeredMistShadow
- server/src/window/candidate_presenter.cpp:ApplySkin 按皮肤设阴影——内置四皮肤
  与自定义包用皮肤 CSS 标准对(σ=blur÷2)light {12,0.18,(8,10)}+{4,0.10,(2,3)}、
  dark α .34/.22;默认皮肤 webview 端 body HTML 无 box-shadow,D2D 同步关掉
- 浮动工具栏(scale=0.45)与托盘菜单(全默认)不触新 API,观感不变
- 透明垫余量重验:新 pass 可见范围(α>0.02 阈值)左16/上14/右32/下34 DIP,
  均在左32/上20/右32/下40 垫内,无裁切切痕
2026-09-14 12:34:10 +08:00
fanlusky f05507ade8 fix(config): 升级时保住用户已填的 API token 等凭证
用户反映更新后 API token 被清空、需要重填。根因不在安装器(它早已用
onlyifdoesntexist 且清理时保留 config.toml / config.base.toml,从不覆盖用户
配置),而在 Server 启动时的合并路径 SyncConfigWithInstalledTemplate:当
config.toml 存在、非空但解析不过(上次写入被打断留下半截文件,或 token 里混入
破坏 TOML 的字符)时,旧逻辑直接拿出厂模板覆盖,等于把用户全部配置——尤其是
凭证——清零。

配置升级本质上已经是「逐条把用户值重放到新模板」(MergeTomlIntoTemplate),因此
不另建配置操作日志,而是把「逐条重放」精准用在最难重填的凭证上,并堵掉硬重置:

- ReapplyRealCredentials:合并结束时把用户填过真值的凭证逐条重放回去,有键改值、
  无键则在其分节插入。覆盖 token / api_key / apikey / secret_id / secret_key /
  app_id / asr_app_key 及所有 per-provider 槽位(token_* / asr_token[_*] /
  polish_token[_*]),真值判定复用 VoiceInput::IsPlaceholderToken。这样模板漂移
  漏掉某个 token 键也不会静默丢失;占位符不粘住,新默认值照常生效。
- SyncConfigWithInstalledTemplate 的 unparseable 分支:先把坏文件备份成
  config.toml.corrupt-<时间戳> 留证,再逐行抢救可识别赋值重放到新模板;即便整体
  抢救结果仍解析不过,也只回退到「模板 + 重放凭证」,而非纯模板。

新增回归测试:模板漏键时真 token 被写回、未填的占位符跟随新默认、损坏配置能捞回
真 token,以及读安装器真正分发的 config.default.toml 逐分节确认所有凭证键挺过升级。
2026-09-14 03:15:16 +08:00
fanlusky 529060a359 feat(settings): API Key 配置项增加连通性测试按钮
设置页中所有需要用户自填 API Key 的配置项(AI 助手、候选词翻译、
语音识别、语音润色)旁增加「测试配置」按钮,点击后用当前填写的凭据
向服务发一个最小请求,即时反馈配置是否有效。

- server: 新增 ApiCredentialTest::Run 统一分发(chat 发 1-token 请求、
  ASR 传静音 WAV、翻译发单词校验、豆包走 DoubaoAsrClient::TestCredentials),
  settings 可执行文件补上 curl/zlib/bcrypt/winhttp 及 cloud/voice 源。
- engine/contracts: 新增 apiCredentialTest / apiCredentialTestResult 消息,
  已 generate.py 重新生成并 sync-contracts 同步至 ui-html/shared。
- ui-html: credential-test 模块负责发消息与渲染结果;测试按钮改小两号;
  外观页补充字体下拉框加宽至 1.5 倍、加号按钮宽度减半。
- docs(agents): 补充格式化会卡 CI 的注意事项——clang-format 须为 18.1.8,
  且 format.sh 在 Windows 上因 venv 布局失效,需直接调 clang-format 自查。
2026-09-13 22:11:09 +08:00
fanlusky e350a94509 feat(translation): 候选词翻译支持小牛翻译(NiuTrans)
在线翻译服务由「腾讯云 / 自定义 DeepLX」扩展为三选一,新增小牛翻译。

- 新增 NiuTrans provider(/v2/text/translate):按官方规则对参数加 apikey
  排序拼接后取 MD5 作为 authStr(BCrypt 实现,无新增依赖),表单编码逐条
  翻译,解析 tgtText,errorCode/errorMsg 视为失败
- cloud_translation 调度改为 Provider 枚举,优先级 niutrans > custom > tencent,
  缓存 key 带 provider 区分
- 配置层新增 [niutrans](enabled/app_id/apikey)及读取与读写接口
- 设置界面新增「小牛翻译」下拉项与 APP ID / API Key 输入框,切换时保持
  provider 互斥
- 新增 test_niutrans_translation(凭据校验、鉴权 MD5、响应解析)
2026-09-13 20:54:45 +08:00
fanlusky 8097aa7df2 feat(voice): 豆包语音识别支持新版控制台单 API Key 鉴权
新版豆包控制台只签发一个 API Key,以 X-Api-Key 发送,不再需要 App ID。
原先这条路径是靠「asr_app_key 是否为空」隐式推断的,而随包配置里
asr_app_key 带有占位符(<YOUR_OWN_DOUBAO_APP_ID>)且非空,全新安装会被
判定为旧版控制台,带着占位符发送 X-Api-App-Key 导致鉴权失败。

改为显式配置项 voice_input.doubao_auth_mode(api_key | legacy):

- voice_providers 新增 NormalizeDoubaoAuthMode()/UsesDoubaoLegacyAuth(),
  集中处理模式解析。该项缺失时按 asr_app_key 是否为「可用值」推断,占位符
  不计入,因此既有配置升级后行为不变。
- DoubaoAsrClient 构造函数改收显式 legacy_auth,新版模式下忽略配置中残留
  的 App ID;连接失败提示按模式区分文案。旧版 App ID + Access Token 路径
  完整保留。
- 设置界面新增「豆包鉴权方式」下拉框,新版模式下隐藏 App ID 输入框并把
  Token 标签改为「API Key」。

同时把官方推荐用于输入法场景的 bigmodel_nostream 整句流式接口做成设置里的
可选项,与原有「接口地址」文本框双向同步。默认端点仍为 bigmodel_async,避免
改变既有用户的实时上屏行为。

新版文档将 payload_msg.result 描述为列表,而原 ParseResponse 只按对象读取,
接上该端点会安静地返回空转写。新增 ExtractTranscript() 同时接受对象与数组两
种结构,一套解析覆盖两个端点。
2026-09-13 18:58:39 +08:00
Jia Sui a3b1e4380c feat(server): 模糊音首次启用播种规则并持久化标记
总开关默认关不变;出厂态(fuzzy_seeded 未置位)第一次开总开关时,用一次
WriteConfiguredValues 批量写 13 键(总开关 + 11 规则全 true + 播种标记),
单文件原子写无部分失败态。标记置位后总开关任何翻动只写总开关一个键,
用户修剪过的选择在临时停用/恢复间原样保留。

播种信号靠持久化标记而不是「规则位全零」:用户故意全部取消勾选后位图
同样是零,无标记会把每次开启都误判成首次启用。fuzzy_seeded 是内部键,
设置快照不下发不展示;两份 toml 模板补键,缺键会被升级合并丢弃导致
老用户升级后误重播种。设置页勾选态由 host 处理 configUpdate 后重发的
configSnapshot 驱动,前端无播种逻辑。

新增首次播种用例(播种全开、修剪子集反复开关、重启保持、全取消后不
重播种);默认值三形态补标记断言;既有往返/门控/注入用例改走不门控
视图或规则键直设,避开播种路径保持用例意图纯净。
2026-09-13 09:33:14 +08:00
Jia Sui b807f50d69 feat(server): 模糊音增加总开关并在聚合 getter 门控
[input] 新增 fuzzy_pinyin 总开关,默认关;GetConfiguredFuzzyPinyinOptions
在总开关关时返回全零 options,规则位缓存保留,临时停用后重开立即恢复。
设置页快照改用不门控的规则位视图,总开关关闭时复选框仍展示已存勾选;
configUpdate 分发把精确分支 input.fuzzy_pinyin 排在 fuzzy_ 前缀分支之前。
注入用例改为带总开关的 A-B-A-B,新增门控与默认值断言。
2026-09-13 09:12:45 +08:00
Jia Sui feb7db6de4 feat(server): 模糊音规则接入配置与会话注入
- [input] 段新增 11 个平铺模糊音键(fuzzy_z_zh … fuzzy_uan_uang,默认全关),
  读取用固定键表驱动,键名即 FuzzyPinyinRule 枚举名小写,单一映射可评审;
  位掩码缓存 uint32,reload 先清零再按位合成
- GetConfiguredFuzzyPinyinOptions 合成引擎选项,SetConfiguredFuzzyPinyinRule
  按键写盘(未知名拒绝且不动位图), ApplyConfiguration 每键注入,
  全拼与双拼同路径生效,设置改动即时生效
- settings_app configSnapshot 补 11 字段,ApplyConfigUpdate 用 input.fuzzy_
  前缀分发;windows_webview2 死宿主不接线(InitWebviewSettingsWnd 零调用者)
- 测试:默认值三形态、逐键往返与 0x7ff 合成、未知键拒绝、
  全拼/双拼 zhang→zang 候选注入用例;开发模板同步 11 键
2026-09-13 08:35:25 +08:00
fanlusky eadcca9f1b fix(server): 候选窗贴边后不再随内容变化上下左右乱飘
候选窗一旦贴住屏幕右边缘,删字后右边缘就会离开边缘;靠近屏幕下边缘时,它有时
正常停在当前行上方,有时却盖住当前行的文字。两者是同一个病根:最终定位用的不是
候选卡片本身,或者压根没有重新定位。

D2D:PlaceAndShow 末尾的水平夹取用的是宿主窗口宽度。宿主带透明阴影内边距、向上
取整到 64px、而且打字过程中只增不减,于是卡片被这些余量整体推离右边缘;删字后过
大的宿主宽度被保留,卡片左边缘就被冻住。改成夹取不透明卡片,和紧随其后的垂直夹取
用同一条规则,透明宿主允许越过屏幕边缘。

WebView2:内容更新只走「重绘不重排」的两条路径,它们从不重做上下翻转判定,只是
(a) 用「MarginTop -= 高度差」这个累加器去粘住底边,(b) 交给
KeepCandidateCardInsideHostAndMonitor 夹取,而后者在卡片底边越过工作区下边界时
直接把卡片往上推。于是本来在光标下方勉强放得下的候选窗,一旦下一个键多出一行释义
变高,就被径直推到当前行文字上面。现在两条路径都改为用实际绘制出来的尺寸重新推导
锚点(ReanchorCandidateHostToPaintedCard)——翻转判定只能信这个高度——两个累加器
随之删除。

另有两处一致性修补:MarginLeft/MarginTop 超出宿主可用余量时改为平移宿主而不是截断,
截断会让卡片毫无理由地吸到宿主的另一端;翻转判定的下边界改用 coordinates.bottom -
edgePadPx,与下游所有夹取共用一条线,否则会判定「下方放得下」,再被 2 DIP 边距顶
回来压到文字上。

已知未处理:翻转时的行高仍是写死的 24 DIP,因为 IPC 只传了文本范围的 left 和
bottom,行高在 GetPhysicalTextAnchor 里就被丢掉了。宿主报出的行比 24 DIP 高时,
翻转后的卡片底边仍会压进那一行——但现在是稳定的偏低,不再忽上忽下。
2026-09-13 03:07:52 +08:00
fanlusky 426bb9d544 feat(server): WebView2 候选窗口支持滚轮翻页,并加上开关
PR #351 只给 D2D 候选窗口加了滚轮翻页,WebView2 后端还没有。

网页端只上报一个以 WHEEL_DELTA 为单位的原始 delta,notch 累加仍然
交给 CandidateWheel::ConsumeWheelDelta,两个宿主最终都汇聚到
WM_PAGE_CANDIDATE,翻页逻辑一份不重复。Chromium 的 wheelDeltaY 本身
就是 ±120/格,正是原生累加器期望的单位,deltaY 作标准回退。

同时把滚轮翻页做成可配置的 general.paging_mouse_wheel,默认关闭:
候选宿主是 NOACTIVATE 且从不获得焦点,滚轮只有在 Windows「当我悬停
在非活动窗口上方时滚动它们」开启时才会送达,无法无条件承诺,所以设为
opt-in,设置页里也写明了这个前提。开关只在 WM_PAGE_CANDIDATE 一处
判断;D2D 那边在 WM_MOUSEWHEEL 顶部提前返回 false,关闭时消息照旧
交给 DefWindowProc,与功能加入前一致。
2026-09-13 01:02:02 +08:00
Lu Fan(SonnyCalcr) 87158b2262 Merge pull request #351 from LilyCarry/feat/candwnd-mousewheel-paging
feat(server): support mouse wheel paging on candidate window (refs #81)
2026-09-13 00:38:00 +08:00
fanluskyandCarry 63eab2f88f refactor(server): 滚轮翻页复用键盘翻页逻辑并移出按键热路径
在 #351 的基础上收敛几处实现:

- CloseContextMenu 里新增的 hover 清理和 Present 原本无条件执行,而
  ShowFromGlobalState 和 Hide 每次按键都会调它。没有菜单时按键路径上会多出
  一次整屏重绘,画的还是更新前的旧场景。改为只在确实有 popup 要销毁时才做。
- 分页与动态扩充的逻辑从键盘路径复制了一份。抽成
  ExpandCandidatesKeepingPagePosition 和 MoveCandidatePage,键盘与滚轮共用。
- 每一格滚轮直接投一个任务,而每个任务都可能回引擎和用户词库。改为在队列里
  合并成 page_steps,一次快速滚动只重绘一次。
- 窗口层不再直接调 EnqueueCandidateUiAction,改为与其它候选窗动作一致,
  PostMessage 到宿主 WndProc(WM_PAGE_CANDIDATE)。EnqueueCandidateUiAction
  的序号校验随之恢复原样。
- 滚轮累加拆成纯函数 CandidateWheel::ConsumeWheelDelta 并补上单元测试;
  候选窗隐藏时忽略迟到的滚轮消息。

滚轮翻页仍然把页内高亮重置为首项,键盘翻页仍然保留原有的页内索引。

Co-authored-by: Carry <xu762556@outlook.com>
2026-09-13 00:16:18 +08:00
fanlusky e860eaab43 fix(server): 避免 WebView2 候选窗阴影被裁切 2026-09-12 23:50:31 +08:00
fanlusky c01327cc0b feat(server): 设置窗口关闭后先隐藏,十分钟后才真正退出
设置是独立进程,每次关闭都销毁窗口,于是每次打开都要重新建 WebView2 并等首屏
导航,冷启动的等待完整地落在用户那一侧。现在用户关闭窗口只隐藏,进程继续持有
已经导航完成的 WebView2,十分钟内重新打开直接显示,超时后才走原来的退出路径。

隐藏期间停掉 300ms 的配置轮询并把 controller 置为不可见,让页面被浏览器降频,
免得一个看不见的窗口白占 CPU。重新露面时在 CancelLinger 里对称地恢复,并调用
WM_ACTIVATE 早就接好、此前一直是空操作的 Resume()。

窗口隐藏时保留的那一帧会在下次打开时先显示出来,所以隐藏前要清掉标题栏按钮的
悬停高亮,复用 WM_SIZE 在最小化/还原时已经用的那个 helper。页面自己的关闭按钮
在点击时清,这里覆盖 Alt+F4、启动图关闭按钮等不经过页面的路径。顺带清掉本地的
g_maximize_button_hover:隐藏的窗口收不到 WM_NCMOUSELEAVE,那个标志会一直是脏
的,下次真的移进去时不再发 enter。

两个边界:

首帧之前被关掉直接真退出,不留半初始化的进程——那种进程重新打开时启动图已经
dismiss 过,用户会对着一个空窗口等。这条同时覆盖启动图自己的关闭按钮,它发的
也是 WM_CLOSE。

CloseSettingsApplication() 是 Ctrl+Shift+Alt+T 的终止通道,紧接着 Server 自己
也要退出。它原来发 WM_CLOSE,而 WM_CLOSE 现在只隐藏,会把设置进程留在 Server
之后,所以改发新的 kQuitSettings 直通真正的退出。

OpenSettingsApplication() 不再自己 ShowWindow,改为投 kActivateSettings 让设置
进程自己处理:在这边直接显示不会取消延迟退出定时器,窗口会在用户面前被销毁,
而且 SW_SHOWNORMAL 还会把之前最大化的窗口还原掉。
2026-09-12 22:48:31 +08:00
Carry 0fb8001022 feat(server): support mouse wheel paging on candidate window (fixes #81) 2026-09-12 19:46:24 +08:00
fanlusky 2717000084 fix(server): 候选窗右侧截断——去重的 show 不再让待应用的裁剪区失效
WebView2 后端下候选窗右边总是被竖切一刀,且多半切在最后一个候选上。

根因在 WndProcCandWindow:g_candidate_content_generation 在处理函数最顶
部无条件自增,早于下面的去重判断。IME 每次按键会投递两次 show,于是每一
次按键的时序都是:

  gen N   -> path=content-only,InflateCandWnd 带着捕获 gen N 的回调发出
             DOM 更新;
  gen N+1 -> 帧签名相同,走 path=dedup,什么都没画、什么都没排,但把计数
             器留在了 N+1;
  gen N 的 dom-callback 触发,发现 N != N+1,直接 return。

结果 SetWindowRgn 只会被完整的 FineTune 刷新,区域一直冻结在上一次
FineTune 量到的宽度上。后面的候选页一旦更宽,就会画到过期区域之外 —— 右
边缘的硬切;更窄时只是多出一块看不见的透明留白,所以这个 bug 时隐时现。

诊断日志(851 行)里的证据:path=content-only 18 次,dom-callback 世代
不匹配 18/18,clip-measure-submit / apply / drop 全为 0,ui-region 7 次且
全部来自 path=full-layout。区域算术本身在 7 个样本里都正确。

修复:去重分支把世代还回去(compare_exchange,仅在期间无人自增时生效),
因为一次去重的 show 什么都没画,DOM 里仍然正是那次在途测量对应的帧。上面
的 path=superseded 出于同样的原因在自增之前就返回。

顺带修掉同一个 bug 的另一半与它为何一直查不出来:

- 去掉 #msime-fast-layout 那张给 .container/.row-wrapper 强加
  white-space:nowrap!important 的样式表(并在应用外观时移除历史残留),
  它让卡片长过 --msime-max-width-dip 的上限,再被 overflow-x:hidden 从字
  中间切开;
- ApplyCandidateFrame 与测量脚本改用 max-content,不再写死 nowrap;
- 量测宽度纳入 scrollWidth,并把 rw/ow/sw/cw 一并回传;
- webview_utils.cpp 里被 #define 成空操作的 ui-measure 日志恢复,裁剪路径
  的静默 return 补上 clip-refresh-skip 一行 —— 正是这两处的沉默让「区域
  从不刷新」在日志里毫无痕迹。

新增的日志只记录数字、坐标与状态,不含任何用户输入或候选文本。

Release / Debug 构建通过,ctest -C Debug 2/2 通过,打包安装后人工验证不再截断。
2026-09-12 18:42:04 +08:00
fanlusky a8c10a63a6 feat(settings): add a restart-server button under the UI backend setting
界面渲染 only takes effect at Server startup, so the setting already told the
user to restart the IME process but offered no way to do it outside the
Ctrl+Shift+Alt+R developer shortcut. Add a 重启 button in the same section.

Settings runs in its own process, so the request travels the Aux pipe — the
supported cross-integrity control path the config notifications already use —
and the Server exits with the Watchdog restart code. The shortcut and the
button now share RestartServerProcess().
2026-09-12 16:41:13 +08:00
fanlusky e835e09c20 fix(engine): give whole-sentence fallback candidates a canonical pinyin
The Google-pinyin whole-sentence candidate is inserted at index 0 in both
quanpin and shuangpin, so it is what Space commits.  All four construction
sites built it without a canonical quanpin reading, so when it finished a
word-creation session update_creating_word_progress() had no reading to
join and can_store stayed false: the prefix plus the sentence went to the
host app but were never learned.

Carry the converted quanpin segmentation on those candidates, and extract
the early-return storage condition into a testable predicate.
2026-09-12 15:53:54 +08:00
fanlusky ad77865f67 fix(server): learn generated-sentence phrases and keep AI context
PR #344 restored the selected prefix in the committed text for Generated
candidates, but the special-candidate early-return branch still skips the
rest of the post-commit work in ProcessSelectionKey.

Two consequences remained:

- The composed phrase was never stored. Word creation persists through
  EnqueueStoreUserPhraseTask in the creating-word completion block, which
  sits after the early return. Committing "西" + the generated sentence
  "你好中国" displayed correctly but was never learned, so the same input
  had to be composed again every time.
- g_ai_context was not advanced, so text committed through this branch was
  missing from the context sent to the AI suggestion provider.

Store the phrase before returning, restricted to Generated candidates in an
active creating-word state. Both pinyin halves are canonical quanpin
(creating_word.pinyin is accumulated by append_canonical_pinyin, and the
lattice candidate carries the whole-sentence key in canonical_pinyin), so a
single "'" joins them. Syllable/han-character agreement is validated by
create_word_from_canonical_pinyin, which rejects a mismatch instead of
writing a bad row.

Append to the AI context as well. The prefix was already appended by its own
ProcessSelectionKey call on the normal path, so only the current segment is
added here. The trim logic is factored into AppendAiContext and shared with
the existing call site rather than duplicated.

Refs #261.
2026-09-12 15:34:11 +08:00
Ouchihao 2cf9cda89e fix(server): preserve selected prefix when committing generated candidates 2026-09-12 14:01:08 +08:00
fanlusky a7779d2b05 refactor(engine): 将 engine 从 submodule 内嵌为仓内一等组件
`vendor/MetasequoiaImeEngine` submodule 改为 `engine/` 目录,导入的是
product-lock.json 原本钉住的提交 c810d201,逐文件核对过 blob,因此这是一次
搬迁而不是引擎升级。引擎自己的嵌套 submodule(googlepinyinime-rev、utfcpp、
miniaudio)按各自 gitlink 一并展开,来源与提交见 engine/UPSTREAM.md。

Windows 专门化裁掉了不属于本产品的部分:whisper.cpp 与本地推理 provider、
macOS 示例宿主、整个 dictionary/ 建库流水线、上游 CI 与 release-please 配置。
词库仍按 product-lock.json 在构建时取发布产物。

引擎不再进 product-lock.json:没有 gitlink 就没有可比对的东西,锁里写一个上游
commit 等于宣称这棵树仍等于上游,而第一个 Windows 专门化改动落地时这句话就假了。
verify-contracts / verify-checkout 随之移除,verify-published 保留。

CI 与工具链:引擎源码并入根 scripts/format.sh(删掉引擎自己的那份,避免两套排除
列表分叉);引擎 voice.yml 里的 silero_vad.onnx 摘要校验移到本仓 lock job;
engine-bump-triage 工作流与其测试删除;gitsubmodule 的 dependabot 频率由 daily
改为 monthly。

README、README.en、AGENTS.md、CONTRIBUTING、docs/product-release.md 及各子目录
文档同步说明新的位置与边界。
2026-09-12 03:40:48 +08:00
fanlusky 54e5c68f94 refactor(server): clear the Server and test /W4 warnings
Most of them come from logging that is compiled out. The disabled DIAG_LOGF /
FANY_IPC_LOG* macros expanded to `((void)0)`, so every HRESULT and parameter
that exists only to be logged looked unreferenced (C4189/C4100). They now
expand to `((void)sizeof(DiscardLogArgs(__VA_ARGS__)))`: the arguments stay in
an unevaluated context, so nothing is computed and no side effect runs, but the
names count as used.

The rest:

- C4100: commented out the parameter names that are genuinely unused
  (WinMain's hPrevInstance/nCmdShow, AdjustWndPosition's hwnd/height, the
  WebView2 callbacks' sender, and the no-op logging sinks).
- C4189/C4101: removed the dead locals and the unused catch bindings left over
  with the log statements.
- C4244: made the DIP-to-pixel and int-to-float conversions explicit in
  globals.h, ime_windows.cpp and the menu placement.
- C4456: renamed the shadowing `hwnd` and `lock` locals.
- C4005: guarded the tests' `#define NOMINMAX` with #ifndef; the test targets
  already define it on the command line.

Release builds clean and ctest passes for the server, the tests and msimeui.
Warnings under vendor/ are untouched: those are submodules with their own
repositories.
2026-09-12 00:55:57 +08:00
Jia Sui 753312f32c fix(server): RDP 会话中候选窗缩放跟随宿主应用实际渲染比例 2026-09-11 22:21:57 +08:00
Jia Sui bd7cf1114d fix(server): D2D 内置皮肤补齐 light 配色,对齐 WebView2 CSS
Signed-off-by: Jia Sui <jsfaint@gmail.com>
2026-09-11 22:19:24 +08:00
Jia Sui 1ae63ad13f fix(server): D2D 候选窗明暗主题跟随设定与系统切换实时刷新
ApplySkin 的指纹缓存只含 theme_cand 原始值,follow 之下改 theme_mode
或系统明暗切换时指纹不变,候选窗停留在首次渲染的暗色 token。
把 ResolveConfiguredTheme 的解析结果并入指纹,让明暗变化穿透缓存。

同时补上系统明暗切换的实时刷新路径:WM_SETTINGCHANGE(ImmersiveColorSet)
时候选窗可见则重绘、常驻的悬浮工具栏即时 ApplyTheme;托盘菜单每次
打开已先 ApplyTheme,无需处理。
2026-09-11 22:19:24 +08:00
Neptrue_Lin 972cf729c9 Merge pull request #326 from ouchihao/codex/fix-298-numpad-punctuation
fix(windows): commit highlighted candidates with numpad punctuation
2026-09-11 20:18:16 +08:00
Neptrue_Lin 3eb82c7878 Merge branch 'develop' into feat/issue-234-rime-dict-import 2026-09-11 20:06:16 +08:00
Ouchihao 1d2431add6 fix(windows): commit highlighted candidates with numpad punctuation 2026-09-11 19:32:17 +08:00
Lu Fan(SonnyCalcr) 0eaa35eed1 Merge pull request #274 from linyanm/fix/issue-155-settings-lag
fix(server,ui-html): 降低设置窗口拖动与工具栏首屏卡顿
2026-09-10 21:33:31 +08:00
fanlusky 9447881c54 Merge branch 'develop' into fix/dictionary-replay-non-ascii-path
Conflict resolutions:

* windows/src/Utils/FanyUtils.h -- develop deleted GetIMEDataDirPath too
  (via #273), so both sides had identical content and the whole-file
  conflict was only develop's .gitattributes LF normalisation. Took
  develop's version; the symbol is now gone repo-wide.

* server/src/skin/candidate_skin_catalog.cpp -- #273 landed the same
  wide-path manifest read on develop. Took develop's code verbatim so
  this hunk is a no-op against develop, keeping only the comment that
  explains why toml::parse_file(manifest.string()) is unusable here.

* server/tests/src/test_quanpin_scheme.cpp (x2) -- union: this branch's
  test::Utf8(db_path) plus develop's `both` autocorrect-flag local.

Verified: server Release build clean, 282 tests pass.
2026-09-10 20:50:17 +08:00
fanlusky 093b485124 Merge branch 'develop' into fix/issue-242-settings-cannot-save
冲突解决:

- windows/src/Utils/FanyUtils.h:develop 通过新增的 .gitattributes 把整个文件
  从 CRLF 规范化成 LF,与本分支删除 GetIMEDataDirPath() 声明的改动整文件冲突。
  取 develop 的 LF 版本,再删掉该声明。
- server/tests/src/test_config_non_ascii_path.cpp:仅 include 块冲突,取两侧并集
  (algorithm/filesystem/fstream/iterator/string/system_error)。另修正一处错误的
  自动合并——develop 新增的候选回退字体断言本属于
  config_round_trips_under_non_ascii_profile_path,git 却按上下文并进了本分支新增的
  config_migrates_legacy_acp_mangled_path,已移回原测试。
2026-09-10 19:33:43 +08:00