# 译层｜作品集展示导出

> **一句话成果：** 我把需要复制、切换窗口的翻译动作，做成了一层会等待阅读意图、贴近原文出现，并在输入、滚动或敏感场景中主动退场的 Windows 全局翻译体验。

## 当前真实状态

| 项目 | 事实 |
|---|---|
| 产品 | “译层”，Windows 10/11 全局屏幕翻译工具 |
| 当前本地版本 | **4.14.0** |
| 源码快照 | `3296f6b`，提交日期 2026-08-28 |
| 导出与复核日期 | **2026-09-02**（Asia/Shanghai） |
| 当前状态 | 本地可运行、可构建；核心体验、可靠性策略、自动化测试与 Windows 安装包链路已实现 |
| 发布边界 | 本地分支比 `origin/master` 超前 19 次提交；未发现 `v4.14.0` 标签或公开 Release，因此不声称“已公开发布 4.14.0” |
| 截图来源 | 当前 4.14.0 打包程序的真实运行；使用隔离的本地配置与不含个人数据的中性阅读页完成捕获 |

截图只按应用/中性阅读窗口边界裁切，并去除了 Win32 捕获产生的无内容黑边；**没有重绘、替换或伪造界面内容**。真实翻译图中选中的是临时本地阅读页上的 `quiet interface`，译层实际返回“安静的界面”。运行检查来自全新隔离会话，仅包含这 1 次中性短语请求；其中“成功率 100.0%”表示 1/1 请求流程完成，不代表译文准确率评测。

## 展示素材

| 核心入口 | 真实选词翻译 |
|---|---|
| ![译层控制中心](screenshots/01-control-center.png) | ![译层真实选词翻译](screenshots/02-selection-translation.png) |

| 智能伴随设置 | 隐私控制 |
|---|---|
| ![译层使用方式设置](screenshots/03-settings-use-mode.png) | ![译层隐私设置](screenshots/04-settings-privacy.png) |

| 真实运行检查 |
|---|
| ![译层运行检查](screenshots/05-runtime-diagnostics.png) |

品牌文件位于 `brand/`：正式应用图标、256 px 图标、PNG/SVG 标志和 Windows ICO。未收录损坏的文字组合 Logo、早期方案板或合成演示 GIF。

## 我的个人贡献

以仓库现有 **83 次提交、唯一 Git 作者 JXJ** 为可核验证据，我负责：

- 从产品定位、阅读场景和“安静、可信、克制”的交互原则出发定义体验；
- 实现 Windows 桌面客户端，以及选中文字、框选 OCR、原位翻译和智能伴随等核心路径；
- 设计页面稳定性、阅读意图、陈旧结果取消、窗口生命周期、服务回退和有界后台任务等可靠性机制；
- 实现密码/登录/验证码等敏感场景保护、完全离线模式及按应用联网规则；
- 完成控制中心、设置、运行检查、自动化测试、PyInstaller 构建与 Inno Setup 安装链路。

Git 记录可以证明提交归属和实现范围，但不能证明开发过程中是否使用过生成式 AI，因此这里不作“全部纯手工”之类无法核验的声明。

## AI、开源与第三方边界

- **项目代码与产品实现：** 仓库以 MIT License 发布，版权标记为 CodeviaX。
- **运行时 AI：** DeepSeek 是用户可选、需自备密钥的在线翻译服务；它不是本项目自研模型。
- **其他在线服务：** Google 免费翻译与 MyMemory 是第三方回退服务，其输出不计为本人原创内容。
- **文字获取：** Windows OCR 与 UI Automation 属于系统能力；项目负责调用、调度、隐私门控和结果呈现，并未训练自有 OCR 模型。
- **离线数据：** ECDICT 是第三方 MIT 词典数据；个人术语表与调度逻辑属于项目实现。
- **工程工具与依赖：** Python 依赖见根目录 `requirements.txt`；PyInstaller 与 Inno Setup 用于构建和安装。EasyOCR、MediaPipe、OpenCV 为可选能力，当前安装包未包含 EasyOCR。
- **开发阶段 AI 辅助：** 仓库没有足以核验其范围的记录；本导出既不把第三方/AI 服务输出冒充为本人原创，也不声称从未使用 AI 辅助。

## 可验证证据

1. **版本一致：** `app_meta.py`、`installer.iss`、`assets/brand/version_info.txt` 与现有 EXE 文件版本均为 `4.14.0`。
2. **固定工具链质量门禁：** Python 3.12.9、Ruff 0.16.2、Mypy 2.3.0、Pytest 9.1.1；实测 Ruff 通过、Mypy 配置内 10 个源文件无问题、**363 passed / 1 skipped**，并完成 **10,000 次**运行时压力测试。
3. **干净构建：** 在项目外的 HEAD clean archive 中，PyInstaller 6.22.0 与 Inno Setup 7.0.2 成功重新生成主程序和安装器；这证明可构建，不声称字节级可复现。
4. **现有交付物校验：** `dist/installer/译层-安装程序.exe` 的 SHA-256 为 `8c1643ec36ff49e3309f39a36eff07d1152c88785ef787707525b1d962292789`，与旁置校验文件一致。
5. **个人实现范围：** `git rev-list --count HEAD` 为 83，`git shortlog -s HEAD` 仅列出作者 JXJ；提交覆盖产品实现、测试、可靠性与发布工程。

可复核命令：

```powershell
ruff check .
mypy
pytest -q
python scripts/stress_runtime.py --iterations 10000
git rev-list --count HEAD
git shortlog -s HEAD
Get-FileHash .\dist\installer\译层-安装程序.exe -Algorithm SHA256
```

## 尚未完成或未经完整验证

- 未验证 `v4.14.0` 的公开 Release；当前只能保守表述为本地完成并验证的版本。
- 当前主程序和安装器均未进行 Authenticode 数字签名。
- EasyOCR 真实集成测试是唯一跳过项，且当前打包版本不包含 EasyOCR；在线翻译服务的地区可用性与长期稳定性也不由本项目保证。
- 尚未对全部应用、所有 DPI/多显示器组合和长期在线场景完成自动化端到端覆盖；本次真实翻译截图只证明一个中性短语在当前环境下完成，不应外推为所有场景均已验证。
- Ruff 当前聚焦严重语法、未定义名称和控制流问题，Mypy 覆盖配置中的 10 个核心文件，不等于全仓库严格静态分析。
- 部分文档基线仍有漂移，例如根 README 的测试数量仍写 265，SECURITY 支持版本与当前 4.14.0 尚未同步。

## 隐私核验

- 未包含账号名、邮箱、密钥、个人历史原文、用户文件、通知、桌面图标或其他项目内容；
- 未包含 `config.json`、数据库、日志、诊断包或任何本机绝对路径；
- 隐私设置截图中的联网规则字段为空，未显示真实应用名单；
- 每个素材的来源、用途、真实运行状态、脱敏状态、尺寸、字节数和 SHA-256 见 `manifest.json`。