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
33 changes: 29 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,22 +24,47 @@
2. 解压到固定目录,例如 `%LOCALAPPDATA%\LightTranslate`,双击 `LightTranslate.exe`。
3. 在桌面应用中选中英文,查看鼠标旁的译文。

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

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

## 按自己的习惯设置

设置保存在应用目录的 `settings.json`。退出轻译后修改,重新启动即可生效。
可以通过 `ExcludedApps` 排除指定应用,填写进程名称,例如:
在托盘“译”图标上右键,选择 **设置…**。面板分为“翻译、浮层、启动”三页,保存后生效:

- **翻译**:自动划词开关、剪贴板取词开关、微软在线目标语言、单次选区长度上限、排除应用和最低英文占比。托盘开关会立即生效并同步到已打开的面板;面板中的改动在保存后应用。关闭剪贴板取词后不获取选区。目标语言只影响微软在线翻译,本地词库和腾讯备用仍输出中文。
- **启动**:读取实际的当前用户启动项,显示当前目录是否开机自启;只有改变选择并保存时才创建或移除启动快捷方式。不写入 `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`;开机自启保存在当前用户启动文件夹。
取消或关闭窗口不会保存配置,也不会改动启动项。
“恢复配置默认值”只恢复面板里的配置输入,保留自启选择,点击保存后才生效;不修改隐藏的诊断开关。
旧配置缺少新字段时沿用原有字体、主题、停留时间和语言过滤。
诊断开关保留为开发排查用的文件配置,不在普通面板中显示。缓存仍为进程内部行为。
排除应用每行一个进程名称,可带或不带 `.exe`,也可用逗号或分号分隔;原有配置未改动的值会保留。例如:

```json
"ExcludedApps": ["SomeApp", "AnotherApp"]
```

如需开机启动,在解压目录使用 PowerShell 7 运行:
开机自启沿用 `startup.ps1` 的当前用户 `LightTranslate.lnk`,无需从面板运行脚本。
指向其他副本的同名启动项、无法读取的状态或 Windows 禁用记录不会被覆盖;面板会提示检查并可刷新。
Windows 已禁用的启动项需在系统启动应用中处理,面板不会更改系统审批或防护设置。
便携目录移动后,应先检查原启动项。

现有命令行脚本仍保留。如需手动创建开机启动项,在解压目录使用 PowerShell 7 运行:

```powershell
pwsh -File .\startup.ps1
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
51 changes: 49 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,8 @@ GitHub Actions 会执行编译、词库构建和离线自检,并上传构建

## 配置字段

修改应用目录的 `settings.json`,重启后生效。
托盘“设置…”分为翻译、浮层和启动三页。配置保存后立即生效,修改应用目录的 `settings.json` 则重启后生效。
自动翻译的托盘快捷切换与已打开面板同步;保存开关失败会恢复托盘勾选并提示错误。
`Diagnostics` 开关每两秒读取一次,可在排查后直接关闭,无需重启。

| 字段 | 默认值 | 作用 |
Expand All @@ -50,9 +61,39 @@ 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` 沿用早期字段名,当前取词路径统一使用剪贴板。

面板纳入 `Enabled`、`ClipboardFallback`、`Target`、`MaxSelectionLength`、`ExcludedApps`
和五项阅读选项。目标语言只校验修改后输入的语言标签语法,不联网获取语言列表;服务是否支持自定义标签由微软决定。
修改后的选区上限要求正整数,排除应用支持换行及中英文逗号/分号,按进程名校验、去重。
未改动的原有自定义目标、长度和排除数组逐值保留;隐藏的 `Diagnostics` 克隆保留,不因普通设置或恢复默认值而重置。

### 开机自启

开机自启以当前用户启动文件夹的 `LightTranslate.lnk` 和实际目标路径为准,不额外持久化一个可能失真的 JSON 布尔值。
读取还会保守检查当前用户 `StartupApproved/StartupFolder` 的常见 12 字节记录:已禁用或未知状态不视为启用,且不修改审批注册表。
同名快捷方式指向其他目标或带有参数时不覆盖/删除;读取失败显示无法确认,其他配置仍可保存。
仅用户改变自启选择并保存时写入当前目录的快捷方式,不使用服务、计划任务、提权或安全设置变更。
写入后重新读取验证;配置保存失败时恢复启动项原字节,无法恢复时明确报错并显示重新读取的状态。
回滚发现启动项已被其他程序更改时拒绝覆盖新内容。

统一设置测试使用模拟后端覆盖往返、取消、保存失败、部分失败、未知/禁用状态及托盘同步;
真实 WScript 快捷方式测试使用输出目录中的独立临时文件夹,验证创建/读取/移除、原字节恢复、异目标保护及 I/O 失败,
不使用真实 Startup 目录、不读取或写入真实审批值。测试结束清理自身临时文件。
另生成 `settings-translation-preview.png`、`settings-startup-preview.png` 和 `settings-startup-error-preview.png`。
图中的自启状态是明确标注的隔离/模拟样例,不代表测试机真实状态。

## 取词与数据处理

程序使用带内部标记的 `Ctrl+C` 获取选区,并尝试保存、恢复原剪贴板的各格式。
Expand Down Expand Up @@ -85,7 +126,7 @@ Windows 的低级监听超时机制见 [Microsoft 文档](https://learn.microsof
从普通权限进程获取管理员应用的选区受 Windows 权限限制。

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

## 手动验证清单

Expand All @@ -100,3 +141,9 @@ OCR、朗读、翻译历史、原位替换、AI 润色、图形设置、自动
7. 连续快速选择不同文字,检查旧响应是否影响当前译文。
8. 检查终端、密码框、排除应用、多显示器、DPI 和屏幕边缘。
9. 持续运行数小时,并在重启 Windows 后检查自启动与划词。
10. 在设置的浮层页选择不同字体、10/48 字号及浅/深/中等亮度背景;确认实际浮层、预览、文字对比度、缩放和长译文滚动。
11. 将时间设为 1/10/120 秒,鼠标停在选区附近但不覆盖浮层检查超时;悬停后移回附近检查重新计时,移远和外部操作仍提前收起。
12. 比例设为 60%,选择 `abc中文` 应翻译,设为 61% 则不触发;选择 `abc中文!? 123` 的结果相同。100% 时纯英文触发、中英混合不触发;0% 保留旧过滤。
13. 输入非法颜色、字号、秒数或比例,确认就地报错且不保存;取消和关闭设置不应用,重启后保留已保存的值且不改动自动翻译开关等其他设置。
14. 打开面板后切换托盘自动翻译,再保存其他选项,确认开关不会被旧值覆盖;目标语言、选区上限、排除应用和取词开关即时应用,取消不应用。
15. 自启验证只在隔离目录或模拟后端完成;打开、勾选、恢复配置默认值和取消均不得写入,只有保存才能修改;覆盖禁用/未知/异目标以及保存和回滚失败状态。真实用户启动项由用户自行选择,不作为自动测试动作。
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