Jev 对话助手（Windows PC 版）

简体中文 | English | Français | Русский | 日本語 | 한국어

版本：v1.4.0

• 先校对，再分析：桌面采集与粘贴解析后，可修改正文、发言方、增删和调整消息顺序；确认后才调用分析服务。原始输入与初始补充内容仍参与交易检查，校对草稿不落盘。
• 回复目的：通用回复、礼貌拒绝、澄清误会、结束话题、缓和冲突，可与长度、风格和语言组合；仅保留在本次会话中，确认分析时冻结。
• 候选改写：逐条选择更短、自然或委婉，支持撤销、取消和失败重试。修改后旧评分清除，可手动重新排序；只供查看和复制。

本项目是基于开源项目https://github.com/Liyucheng1997/332_lab-jev-chat 的判断题库与分析流程进行的 Windows PC 端再开发。

Windows 版可框选桌面上的聊天区域，使用本地 OCR 识别可见文字，通过 Jev 分析对话；也可配置回复模型生成三条候选回复，再由 Jev 排序。候选回复只供查看和复制，不会自动填入或发送。

• 完整上下文：默认分析全部消息，可主动选择最后 10／20／50 条。补充的前文先与当前消息合并，再按所选范围取消息；选中消息的正文与背景说明合计最多 20,000 字符，超过时需缩小范围或精简内容，不会静默截断。界面显示消息总数、实际使用条数、字符数、所选上限与省略条数。交易内容检查覆盖完整输入，包括未选中的消息、前文与背景说明。
• 补充前文与背景：前文支持 我：／对方： 和 me:／other:，背景只作说明，不充当聊天消息。补充内容仅保留在内存，可手动清空；切换绑定的目标窗口或退出应用时清除。同一窗口内切换联系人无法自动检测，请自行清空，避免混用不同会话。
• 窗口跟随：新安装默认使用窗口跟随；已有固定选区继续使用固定屏幕区域模式，重新框选也不会自动切换。要启用跟随，请先选择“跟随窗口”模式再重新框选。跟随模式下，窗口移动时选区随之移动；跨 DPI 显示器仅在窗口几何信息保持一致时继续跟随。窗口尺寸变化超过 2 DIP 时需重新框选；目标窗口关闭或应用重启后，必须确认候选窗口后才能恢复绑定。
• 按需采集：仅在点击分析时采集可见选区，不持续在后台 OCR，也不提供最小化或被遮挡窗口的后台采集；先恢复窗口并让聊天区域可见。

• 粘贴文本分析：无需框选，支持 我：／对方： 和 me:／other:。最多 20,000 个字符，分析最后 10 条消息，交易内容检查覆盖完整输入。
• 取消与分阶段重试：保留已完成的判断和候选，失败时只重试未完成阶段；排序失败仍可复制候选。取消会停止后续流程，但不能撤销已经发送的服务端请求。
• 回复偏好：选择简短或详细、自然／正式／委婉／直接，以及六种回复语言或跟随界面语言；支持全局默认与不落盘的本次覆盖。
• 任务隔离：开始分析时冻结配置，旧请求结果不会覆盖新任务；聊天和阶段缓存仅保留在内存。

下载 v1.4.0 Windows 版 · 完整更新日志

• Windows 10/11（x64）
• Microsoft Edge WebView2 Runtime
• 源码运行或构建需要 Python 3.12、Node.js 20+ 和 npm
• 首次使用需要 TypeSafe / Jev API Key；回复模型 API Key 可选

在仓库根目录打开 PowerShell：

powershell -ExecutionPolicy Bypass -File .\windows\install.ps1
powershell -ExecutionPolicy Bypass -File .\windows\start.ps1

首次使用时，在设置页填写 Jev API Key。需要生成候选回复时，再添加回复模型配置、API Key 和模型名称。

支持简体中文、English、Français、Русский、日本語、한국어（韩文／朝鲜语）。在设置页选择“界面语言”后立即保存并切换，无需重启，也不会提交其他未保存的设置。新用户默认跟随 Windows 界面语言（包含韩文），不支持的系统语言回退英语；旧版用户升级后保持简体中文。

界面支持多语言提示和分析结果标签；聊天原文与用户填写的关系说明保持原内容。OCR 能力沿用现有版本，回复语言可在设置中单独指定或跟随界面语言。

1. 打开要辅助的聊天窗口，进入普通文字聊天。
2. 点击“框选对话区域”，拖动选择聊天消息范围。
3. 点击“采集并校对”，修正文字、发言方和顺序，选择回复目的后点击“确认并分析”。
4. 查看候选，需要时改写、撤销或重新排序；检查并复制合适的内容，再自行决定是否发送。

也可在首页切换“粘贴文本”，解析并校对后确认分析，支持 我：／对方： 和 me:／other: 前缀。设置页可保存回复长度、风格和语言，首页可临时覆盖并选择回复目的。分析中可取消，失败后可按阶段重试，排序失败仍可复制候选。

程序不会读取聊天数据库、操作聊天输入框或自动发送消息。转账、红包、收款和支付等交易内容会被安全检查拦截。图片、语音及引用卡片中的内容目前无法可靠还原。

powershell -ExecutionPolicy Bypass -File .\windows\build.ps1

构建产物：dist\Jev对话助手\Jev对话助手.exe。分发时请保留其旁边的 _internal 目录；目标电脑也需要安装 Microsoft Edge WebView2 Runtime。

前端已构建时，可加 -SkipFrontendBuild 复用 windows/frontend/dist，跳过 npm ci 与 npm run build。

流水线配置在 .github/workflows/ci.yml，main 分支推送、v*.*.* 标签推送、PR 和手动触发都走这一个工作流。

1. 同步 windows/jev_windows/__init__.py 的 __version__、windows/frontend/package.json 与 lock 文件的版本，以及各语言 README，并在 windows/CHANGELOG.md 中补上对应版本的章节，提交并推送：

git push origin main

这一步只运行检查（前端构建 + pytest），不会发版。

2. 打标签并单独推送标签：

git tag v1.4.0
git push origin v1.4.0

这一步运行同一条流水线，在检查通过后构建并创建或更新 GitHub Release。请分两次推送，不要用 git push --follow-tags：一次推送同时包含分支和标签时，GitHub 会发两个 push 事件，Actions 里会出现两条运行记录。仅推送标签时只产生一条记录。

• OCR 在本机执行；点击分析后，识别出的聊天文本会发送给 TypeSafe Jev。
• 启用回复模型后，对话文本和 Jev 判断会发送给所选模型服务生成候选回复。
• 检查应用内更新时，仅向 GitHub 查询最新版本号，不发送任何聊天内容。
• API Key 保存在 Windows 凭据管理器；%APPDATA%\JevChatAssistant\settings.json 仅保存非机密设置。
• 模型列表和连接测试不会发送聊天内容。

更多配置、使用说明与限制见 windows/README.md。