Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 16 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,15 +24,29 @@
2. 解压到固定目录,例如 `%LOCALAPPDATA%\LightTranslate`,双击 `LightTranslate.exe`。
3. 在桌面应用中选中英文,查看鼠标旁的译文。

启动后,系统托盘会出现“译”图标。右键可开关自动翻译、打开设置文件或退出;
启动后,系统托盘会出现“译”图标。右键可开关自动翻译、打开阅读设置、打开设置文件或退出;
双击图标可直接切换自动翻译。

轻译面向支持复制选区的桌面应用,默认跳过终端和纯中文选区,每次最多选择 2,000 个字符。
当前译文目标为简体中文。

## 按自己的习惯设置

设置保存在应用目录的 `settings.json`。退出轻译后修改,重新启动即可生效。
在托盘“译”图标上右键,选择 **阅读设置…**:

- **字体和字号**:选择已安装字体,字号范围为 10–48,默认 14。
- **背景色**:留空跟随系统明暗主题,或使用选色器 / `#RRGGBB`;文字颜色自动调整,保持至少 4.5:1 的对比度。
- **自动消失**:默认按译文长度停留 6–22 秒,也可设置 1–120 秒。鼠标悬停时续时;移远、打字、点击外部、滚动外部页面或切换应用仍会提前收起。等待和错误提示保留原来的时长,短停留时间不会提前中断等待中的翻译。
- **最低英文占比**:范围 0–100%。大于 0% 时,A–Z/a–z 字母数占全部 Unicode 文字字母数的比例达到阈值(含等于)才翻译;中文和其他语言字母计入分母,标点、空白、数字、表情及组合音调符号不计入。全角字母和带重音字母计入分母,但不计为 A–Z/a–z。例如 `abc中文` 为 60%,`Hello中文` 约为 71%。

默认 0% 关闭新增比例限制,保留原有的非中文语言过滤(包括原先可翻译的其他语言);
纯符号、纯数字、空白和纯中文选区仍跳过。大于 0% 时,选区必须含 A–Z/a–z。
这只是字符规则,不是自然语言识别。

保存后上述设置立即生效并写入应用目录的 `settings.json`;取消不会保存。
“恢复阅读默认值”仅重置这五项阅读选项的预览,点击保存后才生效。
旧配置缺少新字段时沿用原有字体、主题、停留时间和语言过滤。
其他高级配置仍可退出轻译后修改文件、重启生效。
可以通过 `ExcludedApps` 排除指定应用,填写进程名称,例如:

```json
Expand Down
3 changes: 2 additions & 1 deletion build.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,12 @@ $references = @('System.dll','System.Core.dll','System.Net.Http.dll','System.Dra
ForEach-Object { '/r:' + (Join-Path $framework $_) }
$references += @('WindowsBase.dll','PresentationCore.dll','PresentationFramework.dll') |
ForEach-Object { '/r:' + (Join-Path $framework ('WPF\' + $_)) }
$sourceFiles = @(Get-ChildItem -LiteralPath (Join-Path $PSScriptRoot 'src') -Filter '*.cs' -File | ForEach-Object { $_.FullName })
& $compiler /nologo /target:winexe /platform:x64 /optimize+ `
('/out:' + (Join-Path $outputPath 'LightTranslate.exe')) `
('/win32manifest:' + (Join-Path $PSScriptRoot 'src\LightTranslate.manifest')) `
('/win32icon:' + (Join-Path $PSScriptRoot 'assets\LightTranslate.ico')) `
@references (Join-Path $PSScriptRoot 'src\LightTranslate.cs')
@references @sourceFiles
if ($LASTEXITCODE -ne 0) { throw 'Compilation failed.' }
Copy-Item -LiteralPath (Join-Path $PSScriptRoot 'src\LightTranslate.exe.config'),
(Join-Path $PSScriptRoot 'LICENSE'), (Join-Path $PSScriptRoot 'README.md'),
Expand Down
28 changes: 26 additions & 2 deletions docs/TESTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,16 @@ pwsh -File .\scripts\test.ps1
请求取消、对象回收和浮层窗口样式。它会创建自己的测试控件并渲染浮层,
不会显示窗口或向其他桌面应用注入输入。

阅读设置自检额外覆盖旧配置兼容、非法数值回退、字体/背景/时间/比例保存、
表单校验、保存失败不应用、取消与恢复默认值不误保存。配置写入先使用临时文件,
再原子替换原配置。测试只在输出目录创建自己的临时配置并在结束时清理。
自检还覆盖悬停续时、移远宽限期和超时边界,以及英文比例的等号边界、混合文字、
补充平面 Unicode 和标点/数字/空白/表情排除。背景文字对比度检查采样 4,096 个 RGB 颜色。

输出目录中会生成 `reading-settings-preview.png`、`reading-settings-custom-preview.png`
和 `reading-settings-error-preview.png`,使用真实 WPF 控件离屏渲染默认、定制及错误状态。
这些渲染图不代替实际桌面的焦点、键盘、选色器、DPI 和滚动交互验收。

输入监听回归测试会阻塞 UI 调度器,检查独立监听线程仍能处理消息;
随后移除本进程的原生监听,检查恢复机制自动重新安装,并确认捕获的消息交回 UI 调度器。

Expand All @@ -39,7 +49,7 @@ GitHub Actions 会执行编译、词库构建和离线自检,并上传构建

## 配置字段

修改应用目录的 `settings.json`,重启后生效。
托盘“阅读设置…”保存后立即生效;修改应用目录的 `settings.json` 则重启后生效。
`Diagnostics` 开关每两秒读取一次,可在排查后直接关闭,无需重启。

| 字段 | 默认值 | 作用 |
Expand All @@ -50,6 +60,16 @@ GitHub Actions 会执行编译、词库构建和离线自检,并上传构建
| `MaxSelectionLength` | `2000` | 单次选区字符数上限 |
| `ExcludedApps` | `[]` | 排除的进程名称,可带或不带 `.exe` |
| `Diagnostics` | `false` | 触发诊断日志开关 |
| `BubbleFontFamily` | `Microsoft YaHei UI` | 浮层字体族,使用已安装的字体;缺失或未知字体回退默认 |
| `BubbleFontSize` | `14` | 浮层字号,10–48 DIP(随系统 DPI 缩放) |
| `BubbleBackground` | `""` | 空字符串跟随系统主题,或不透明的 `#RRGGBB`;自动选择对比度 ≥4.5:1 的文字颜色 |
| `AutoHideSeconds` | `0` | 0 沿用原有译文时长(6–22 秒);1–120 为译文固定秒数,保留悬停续时及提前收起规则。等待和错误提示仍使用原来的时长,避免短设置值中断请求 |
| `MinEnglishPercent` | `0` | 0 关闭新增过滤并保留旧语言规则;1–100 为 A–Z/a–z ÷ 全部 Unicode 字母的最低百分比,等于阈值也触发 |

这些新字段缺失时保留原有默认行为;手动写入越界或非有限字号、非法颜色、未知字体时回退对应默认值。
英文比例排除空白、标点、数字、表情及组合音调符号;中文和其他语言字母计入分母。
补充平面的字母按 Unicode 标量计一次,全角 Latin / 重音字母计入分母但不计英文分子。
大于 0% 时没有 A–Z/a–z 的文本不触发;0% 时无文字字母或纯中文仍被原有规则跳过。

`ClipboardFallback` 沿用早期字段名,当前取词路径统一使用剪贴板。

Expand Down Expand Up @@ -85,7 +105,7 @@ Windows 的低级监听超时机制见 [Microsoft 文档](https://learn.microsof
从普通权限进程获取管理员应用的选区受 Windows 权限限制。

当前功能聚焦划词阅读:本地词库可离线,句子翻译使用网络。
OCR、朗读、翻译历史、原位替换、AI 润色、图形设置、自动更新、安装器和代码签名暂未实现。
OCR、朗读、翻译历史、原位替换、AI 润色、自动更新、安装器和代码签名暂未实现。

## 手动验证清单

Expand All @@ -100,3 +120,7 @@ OCR、朗读、翻译历史、原位替换、AI 润色、图形设置、自动
7. 连续快速选择不同文字,检查旧响应是否影响当前译文。
8. 检查终端、密码框、排除应用、多显示器、DPI 和屏幕边缘。
9. 持续运行数小时,并在重启 Windows 后检查自启动与划词。
10. 在阅读设置中选择不同字体、10/48 字号及浅/深/中等亮度背景;确认实际浮层、预览、文字对比度、缩放和长译文滚动。
11. 将时间设为 1/10/120 秒,鼠标停在选区附近但不覆盖浮层检查超时;悬停后移回附近检查重新计时,移远和外部操作仍提前收起。
12. 比例设为 60%,选择 `abc中文` 应翻译,设为 61% 则不触发;选择 `abc中文!? 123` 的结果相同。100% 时纯英文触发、中英混合不触发;0% 保留旧过滤。
13. 输入非法颜色、字号、秒数或比例,确认就地报错且不保存;取消和关闭设置不应用,重启后保留已保存的值且不改动自动翻译开关等其他设置。
7 changes: 6 additions & 1 deletion settings.example.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,5 +4,10 @@
"Target": "zh-Hans",
"MaxSelectionLength": 2000,
"ExcludedApps": [],
"Diagnostics": false
"Diagnostics": false,
"BubbleFontFamily": "Microsoft YaHei UI",
"BubbleFontSize": 14,
"BubbleBackground": "",
"AutoHideSeconds": 0,
"MinEnglishPercent": 0
}
Loading
Loading