Files
qingjian/apps/windows/tsf/tests/protocol_loop.rs
T
ym lee 96820dde4c fix(windows): 按 review 收尾:CI 两处、激活时缺省值盖设置、判键回到原口径
- `ipc_loop.rs` / `pipe.rs`:开会话现在多回一条 `SessionOpened`,期望的条数从 5 改成 6
  (`pipe.rs` 那个是读 6 条、只取其中的 `KeyResult`)
- `protocol_loop.rs`:`EngineClient::open` 改成返回元组之后这个文件没跟着改 ——
  它是 `#![cfg(unix)]`,Windows 上根本编不到,只有 CI 会红
- `Activate`:`connect()` 已经把 Server 下发的设置应用了,紧接着的
  `apply_input_settings(InputSettings::default())` 又把它盖成缺省值,要等下一拍 `SyncMode` 才改回来 ——
  关掉内置英文模式的人每次激活都会先登记上中 / 英按钮、之后也不会撤。缺省值改成只在没连上 Server 时用。
- `eats_key`:字母判定回到原来的口径(组句外 Shift + 大写归应用,V / U / I 例外),
  `push_shifted` / `apply_chinese` 那条属于另一个改动,这个 PR 不带。

另外按 review 去掉了「`-` `=` 由壳自己插入」那个提交:main 上已经有通用机制
(Server 放行没吃掉的按键时由 DLL 自己把字符插进文档),不用为它单开一条路。
2026-09-17 22:22:36 +08:00

165 lines
6.0 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! DLL 引擎层的端到端协议测试:把 [`EngineClient`] 接到真正的 Server(`qingjian-windows-server` 的
//! [`Router`] + [`serve`](qingjian_windows_server::ipc::serve)),两端各在一条 socketpair 上,验证
//! 「开会话 → 敲拼音收到候选 → 空格上屏」这条 IPC 闭环。
//!
//! 用 `UnixStream::pair` 起真双工流,所以只在 Unix 跑(mac 上开发时能验证 client 编排);Windows 上
//! 同一套 [`EngineClient`] 由命名管道驱动,靠交互测试。样例词库来自 `assets/sample/`,无需产品数据。
#![cfg(unix)]
use std::os::unix::net::UnixStream;
use std::path::PathBuf;
use std::thread;
use qingjian_core::Language;
use qingjian_platform::protocol::{KeyEvent, KeyModifiers, KeyOutcome, SessionId};
use qingjian_tsf::client::{EngineClient, KeyReply, KeyResponse};
use qingjian_windows_server::{AssemblySpec, Router, RouterConfig, assembly, ipc};
const SESSION: SessionId = SessionId(1);
/// 一个字母键(`character` 带小写字母,虚拟键码用其大写 ASCII)。
fn letter(c: char) -> KeyEvent {
KeyEvent::new(c.to_ascii_uppercase() as u32, Some(c), Default::default())
}
/// 取常规按键结果;收到「读选区」请求(不该在这些用例里出现)就 panic。
fn result(reply: KeyReply) -> KeyResponse {
match reply {
KeyReply::Result(response) => response,
KeyReply::NeedSelection { .. } => panic!("没料到 Server 要读选区"),
}
}
/// 起一个后台 Server:用样例词库装 Router,在 `server_end` 上 serve 到对端关闭。
fn spawn_server(server_end: UnixStream) -> thread::JoinHandle<()> {
thread::spawn(move || {
let root = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("../../..");
let dict = root.join("assets/sample/dict.tsv");
let glossary = root.join("assets/sample/glossary-en.tsv");
let engine = assembly::assemble(&AssemblySpec {
glossary: Some((Language::English, glossary)),
..AssemblySpec::new(dict)
})
.expect("assemble engine from sample data");
let mut router = Router::new(engine, RouterConfig::default());
let mut stream = server_end;
let _ = ipc::serve(&mut stream, &mut router);
})
}
#[test]
fn client_types_pinyin_and_gets_candidates() {
let (client_end, server_end) = UnixStream::pair().unwrap();
let server = spawn_server(server_end);
let (mut client, _input) = EngineClient::open(client_end, SESSION, None).expect("open session");
let mut last = None;
for c in "nihao".chars() {
last = Some(result(client.key(letter(c)).expect("key round-trips")));
}
let response = last.unwrap();
assert_eq!(response.outcome, KeyOutcome::Consumed);
assert_eq!(response.commit, None);
let preedit: String = response
.frame
.preedit
.iter()
.map(|s| s.text.as_str())
.collect();
assert_eq!(preedit, "ni'hao");
let texts: Vec<&str> = response
.frame
.candidates
.items
.iter()
.map(|c| c.text.as_str())
.collect();
assert!(
texts.contains(&"你好"),
"候选里应有「你好」,实际:{texts:?}"
);
client.close().expect("close session");
server.join().unwrap();
}
#[test]
fn space_commits_first_candidate() {
let (client_end, server_end) = UnixStream::pair().unwrap();
let server = spawn_server(server_end);
let (mut client, _input) = EngineClient::open(client_end, SESSION, None).expect("open session");
for c in "ni".chars() {
client.key(letter(c)).expect("key round-trips");
}
let space = result(
client
.key(KeyEvent::new(0x20, Some(' '), Default::default()))
.expect("space round-trips"),
);
assert_eq!(space.outcome, KeyOutcome::Consumed);
assert_eq!(space.commit.as_deref(), Some("你"), "「ni」首选应是「你」");
assert!(space.frame.is_empty(), "上屏后应收起候选");
client.close().expect("close session");
server.join().unwrap();
}
#[test]
fn commit_returns_raw_text() {
let (client_end, server_end) = UnixStream::pair().unwrap();
let server = spawn_server(server_end);
let (mut client, _input) = EngineClient::open(client_end, SESSION, None).expect("open session");
for c in "nihao".chars() {
client.key(letter(c)).expect("key round-trips");
}
let text = client.commit().expect("commit round-trips");
assert_eq!(text.as_deref(), Some("nihao"), "失焦时拼音原样交出");
assert_eq!(
client.commit().expect("commit round-trips"),
None,
"缓冲已清空"
);
client.close().expect("close session");
server.join().unwrap();
}
/// 「翻译选中文字」快捷键在云服务关着时不劫持:样例词库没配 predictor,Ctrl+Alt+T 不该要求读选区,
/// 而是走常规分派(带 Ctrl/Alt 的键 Router 一律 Passthrough 交回应用)。真正的翻译闭环靠真机测(要云服务)。
#[test]
fn translate_combo_is_dormant_without_cloud() {
let (client_end, server_end) = UnixStream::pair().unwrap();
let server = spawn_server(server_end);
let (mut client, _input) = EngineClient::open(client_end, SESSION, None).expect("open session");
// Ctrl+Alt+T(缺省 translate_selection):character = 't',修饰键 ctrl+alt。
let combo = KeyEvent::new(
b'T' as u32,
Some('t'),
KeyModifiers {
ctrl: true,
alt: true,
..Default::default()
},
);
let reply = client.key(combo).expect("combo round-trips");
match reply {
KeyReply::Result(response) => {
assert_eq!(
response.outcome,
KeyOutcome::Passthrough,
"云服务关着,带 Ctrl/Alt 的键应放行给应用"
);
assert!(response.frame.is_empty(), "不该起组句 / 候选");
}
KeyReply::NeedSelection { .. } => panic!("云服务关着不该要求读选区"),
}
client.close().expect("close session");
server.join().unwrap();
}