需要 macOS 13+。下载即用：解压后把 jev-jarvis.app 拖进「应用程序」。

第一次打开：右键（或按住 Control 点）→ 打开 → 再点「打开」。未做 Apple 公证，双击会被 Gatekeeper 拦，只需这一次。
若弹「已损坏，无法打开」（浏览器下载常见，右键无效）：终端执行 sudo xattr -r -d com.apple.quarantine /Applications/jev-jarvis.app 后再打开。
第一次启动：联网装依赖（uv 缓存命中就很快）；只需给 jev-jarvis 授予「屏幕录制」权限，然后退出重开，无需单独授权 python3.12。
判断层默认跑本地模型，首次要下载约 3.8 GB（之后离线可用）。不想下载：在 ~/.config/jev-jarvis/env 里给判断层配一个 key 走云端，见 README「配置」。

本次包含

• chore: 发版 0.6.2——校准模式填入优先 AX；补公告两件套
• fix(hud): 手动校准模式填入优先 AX 写入，定位不到再回退复制兜底 (#142) (#143)
• docs(agents): 补三条实测教训——uv lock 同步、防截屏灰度与 AX 无关、测试副本命名坑
• chore: uv.lock 同步 0.6.1 版本号
• test(hud): fill 假对象补齐 #139 新增的兜底常量与诊断函数
• feat(fill): 剪贴板兜底触发时记录 AX 诊断日志 (#139)

需要 macOS 13+。下载即用：解压后把 jev-jarvis.app 拖进「应用程序」。

第一次打开：右键（或按住 Control 点）→ 打开 → 再点「打开」。未做 Apple 公证，双击会被 Gatekeeper 拦，只需这一次。
若弹「已损坏，无法打开」（浏览器下载常见，右键无效）：终端执行 sudo xattr -r -d com.apple.quarantine /Applications/jev-jarvis.app 后再打开。
第一次启动：联网装依赖（uv 缓存命中就很快）；只需给 jev-jarvis 授予「屏幕录制」权限，然后退出重开，无需单独授权 python3.12。
判断层默认跑本地模型，首次要下载约 3.8 GB（之后离线可用）。不想下载：在 ~/.config/jev-jarvis/env 里给判断层配一个 key 走云端，见 README「配置」。

本次包含

• fix(fill): 填入 fallback 改为复制+手动粘贴，微信路径停用合成事件 (#139)
• docs: AGENTS 补 dispatch 型 workflow 的 env 空映射坑（#137 收尾验证载体） (#138)
• ci: Run agent 不再注入 GH_TOKEN——评审署名回归 pullfrog[bot] (#137)
• ci: 删掉从未成功的 workflow_run 自动评审，归位控制台 Auto-review (#136)
• fix(config): session override 空串覆盖真正生效，离线回归隔离本机真实配置 (#134)
• chore: 文案优化
• docs: 文档优化
• docs: 统一平台表述
• docs: 精简平台支持表述
• docs: 文档优化
• docs: 恢复 2 群二维码——README 群码表与公众号稿配图都还原为四张
• docs(readme): 公众号二维码提到顶部「反馈与帮助」——第一屏可见；文末交流反馈只留群码
• docs: 公告两件套群口径同步 README——1、2 群满从 3 群扫，公众号私信置顶
• docs(readme): 交流反馈精简——公众号置顶（合作/反馈/进群私信），群码 1、2 群满从 3 群扫
• docs: 校准预览成功样例图（对方4·我2·未确认0）
• docs: 校准选框图解（标注版引导图）
• docs: 公众号图文稿 v0.6.0 + README 过期口径清理 + AGENTS 发版流程补 README 核验
• docs(readme): 手动校准已随 v0.6.0 发布——去掉「fork 实验分支」过时措辞
• docs(release): v0.6.0 公告文档——校准/识别效果实拍配图归位
• docs: 回退 readme 配图改动——配图归位 release notes（下一提交）

jev-jarvis v0.6.0

一句话：QQ（QQNT）来了；微信 4.x 有了人工区域校准，独立聊天窗、贴底输入区这些「识别不到」的场面都能治；填入手感也顺了。

这版的重点

人工区域校准：识别准确度大幅提高（#81、#89）

微信 4.x 联系人列表可拖宽、独立聊天窗乱飘，固定比例的自动识别经常漏消息、读到列表摘要。人工校准按你框选的真实气泡整理消息——识别准确度大幅提高：短句不再被当杂字丢掉、多行正文完整合并、左右归属更准。

打开 app 时，点击右上角手动校准图标即可进入：

同一界面拖框选消息识别区域（绿框）与输入区域（蓝框），预览通过后一次保存：

• 消息区（绿框）罩住整个消息流（双方头像与气泡都在内），排除左侧列表、标题、公告和输入区，对方/我自动判定
• 确认不了归属的文字不进上下文、不自动回复
• 校准数据存在本地配置，窗口挪动不用重画

QQ（QQNT）支持（#77）

• 同一个悬浮窗同时适配微信与 QQ：谁在前台读谁、给谁填
• QQ 走系统无障碍树直接读消息——不截图、不 OCR、不解密，纯只读原则不变
• QQ 的「填入」同样辅助功能（AX）写入优先、键盘事件后备，不发送、不碰剪贴板、不覆盖草稿

一键「立刻分析」/「重新生成推荐回答」（#74）

• 面板底部两个按钮：前者重新读屏+完整分析，后者沿用当前判断只重跑候选（换话术后快速重出）
• 菜单栏「J」里同样有「立即重新分析」

新话术：狗头军师·恋爱三件套 / 夸夸（#90）

内置新增恋爱向「狗头军师」三件套（稳健 / 会撩 / 抽离）与「夸夸」。识别效果实拍——微信消息实时框选标注，面板按话术分组给出候选并带本地排序概率：

自定义话术加最低质量门槛：描述太糊会拒绝加载并提示怎么写，不再悄悄失效。

会话背景进上下文（#79）

• 自动带上最近几轮对话做背景，判断意图与生成候选更贴合上下文
• 历史只存本地，可随时清除

判断模型：离线加载 + 国内镜像（#98）

• 模型已缓存时完全离线加载，启动不再卡网络检查
• 首次下载不可达时自动切国内镜像，下载有实时进度

顺手修掉的

• 切回微信一片空白 / 独立聊天窗识别不到（#92）：读屏窗口改为跟随系统焦点窗口，适配微信 4.x 独立聊天窗
• 拖窗口面板跟不上（#94）：面板吸附与读屏解耦，拖窗后 0.5 秒内跟上
• 「填入」防呆（#106）：输入目标不属于前台应用时拒绝并提示等检测框更新；修复手动校准模式下误报「属于另一应用」导致填入必失败的回归
• 填入后鼠标停在微信里（#108）：视觉填入完成自动把光标送回原位，换话术不用再挪鼠标
• 刷屏时漏消息/串台（#76）：OCR 空帧沿用上一帧不重置停稳，在途任务及时作废
• 抓图加固（#84、#85）：新版 macOS 上抓图卡死改为带超时的子进程采集，失败有兜底、日志降噪
• 读屏日志如实分开「抓取 / OCR」两段耗时（#110）

给开发者的

• CI：覆盖率双棘轮门禁（#87）、合并队列（#100）、issue 每小时自动 triage（#102）、首个「认领」评论自动设 assignee（#97）、子 issue 全关自动收父 issue（#114）
• 完整变更见 commit 列表

安装 / 升级

需要 macOS 13+、Apple Silicon。下载 zip，解压把 jev-jarvis.app 拖进「应用程序」。

• 第一次打开：右键（或按住 Control 点）→ 打开 → 再点「打开」。未做 Apple 公证，双击会被 Gatekeeper 拦，只需这一次。
• 若弹「已损坏，无法打开」（浏览器下载的 zip 常见，右键无效）：终端执行 sudo xattr -r -d com.apple.quarantine /Applications/jev-jarvis.app 后再打开。
• 权限：读微信需授「屏幕录制」；读 QQ 与「填入」需授「辅助功能」——首次使用时系统会弹。
• 判断层未配 key 时首次启动会引导选择（在线 or 离线模型），也可以稍后再说。

从旧版升级：直接用新的 .app 覆盖旧的即可，配置在 ~/.config/jev-jarvis/env（含校准数据），不受影响。

文件校验：SHA256SUMS 与安装包在同一 Release 页。

反馈

合作、反馈、进群，请公众号私信；也可扫码进交流群（1、2 群已满，从 3 群开始扫）。二维码见 README 文末「交流反馈」。bug 和建议走 Issues 最好跟踪。

jev-jarvis v0.5.0

一句话：新用户上手不再懵——首次启动自己选判断方式，离线模型不再偷偷下载、下载有实时进度；面板默认多一组「阴阳怪气」。

这版的重点

首次启动自己选判断方式（#38）

未配置判断层 key 的新用户，首次启动会弹一次选择：

• 配置 key 在线判断（推荐）：轻量、无下载，走 TypeSafe Jev 或任意兼容网关
• 下载离线模型（约 3.8 GB）：下载后完全离线可用
• 稍后再说：先跳过，面板会持续提示

离线模型不再启动即偷偷下载；选过的不再问，之后随时可在「模型设置 → 判断 · Jev」页改主意、删除离线模型（页面显示实际占用）。

模型下载有实时进度了（#41）

旧版首次下载/加载模型时，面板一片安静，分不清「在下载」还是「卡死了」。这版状态行实时显示：

下载判断模型 34% · 1.2/3.8 GB → 加载判断模型… → 预热判断模型…

完成自动恢复消息状态；下载/加载失败会红字说明原因，不再无声无息。旧版「一片空白不知道在干嘛」的问题从此根治——老版本用户建议直接升到这版。

面板默认三组话术，「阴阳怪气」直接可用

默认话术从两组变三组：高情商话术 / 贴吧老哥 v1.0 / 阴阳怪气。旧版第三格默认「不用」，实测大家都会手动勾上它——现在默认就有，每个下拉随时可换成其余语气或关掉。

自定义 key 怎么配

判断与生成都支持自带 key，全部在**悬浮窗右上角齿轮（模型设置）**里可视化编辑，三组密钥各自独立、互不干扰：

• 「获取模型列表」直接从该服务的 /models 拉取下拉选择，接口不支持可手填
• 「测试连接」发送固定问候语实测可用性（不读取微信内容，可能产生少量服务费用）
• 保存后退出并重新打开应用才生效；优先级：环境变量 > 用户 env > 项目 .env > 内置共享 key
• 不配任何 key 也能用：判断走本地模型，生成层打包版内置共享 key

兼容性与修复

• WeChat 4.x 底部贴窗输入区兼容（#52）：新版微信贴底输入区识别更稳
• 短联系人标题保留（#36）：单字/两三个字的联系人名不再被当杂字丢掉；聊天右侧控件不再混进消息；无消息可附着的孤立发送者名丢弃（#72）
• 窗口选择更准（#56）：只认「微信 / WeChat / Weixin」精确应用名，微信读书、微信输入法、企业微信不再干扰窗口选择
• OpenRouter 等网关兼容（#53）：判断层 TYPESAFE_BASE_URL 支持非版本段+动作词的网关地址（如 https://openrouter.ai/api/alpha/decisions + 模型 typesafe/jev-1.13，key 用 OpenRouter 的 sk-or-…）
• Intel Mac 启动提示（#57）：x86_64 环境启动时中文明确提示仅支持 Apple Silicon（不要用 Rosetta，torch 无 Intel 版）
• 日志如实标注后端：排序耗时行按实际后端显示（Jev https://… 或 本地 decider-2b），不再写死「本地模型」

开发与文档

• CI：PR 与 master push 自动跑离线回归（103 条，macOS runner）
• FAQ：新增 docs/FAQ.md 与置顶 issue——配置文件 / 日志 / 模型路径 / 安装报错 / 旧版空白，一条卡一个命令
• 隐私说明：PRIVACY.md 上线，数据流向一页说清

安装 / 升级

需要 macOS 13+、Apple Silicon。下载 zip，解压把 jev-jarvis.app 拖进「应用程序」。

• 第一次打开：右键（或按住 Control 点）→ 打开 → 再点「打开」。未做 Apple 公证，双击会被 Gatekeeper 拦，只需这一次。
• 若弹「已损坏，无法打开」（浏览器下载的 zip 常见，右键无效）：终端执行 sudo xattr -r -d com.apple.quarantine /Applications/jev-jarvis.app 后再打开。
• 第一次启动：按提示授予「屏幕录制」权限后退出重开；「填入」首次使用时另授「辅助功能」。
• 判断层未配 key 时首次启动会引导选择（在线 or 离线模型），也可以稍后再说。

从旧版升级：直接用新的 .app 覆盖旧的即可，配置在 ~/.config/jev-jarvis/env，不受影响。旧版「启动后一片空白」的现象在这版根治，建议尽快更新。

文件校验：SHA256SUMS 与安装包在同一 Release 页。

反馈

交流群（1 群已满，从 2 群开始扫）和个人微信、公众号都在 README 文末「交流反馈」；有新版本发布会在群里和公众号通知，建议关注。bug 和建议走 Issues 最好跟踪。

需要 macOS 13+。下载即用：解压后把 jev-jarvis.app 拖进「应用程序」。

第一次打开：右键（或按住 Control 点）→ 打开 → 再点「打开」。未做 Apple 公证，双击会被 Gatekeeper 拦，只需这一次。
第一次启动：联网装依赖（uv 缓存命中就很快）；只需给 jev-jarvis 授予「屏幕录制」权限，然后退出重开，无需单独授权 python3.12。
判断层默认跑本地模型，首次要下载约 7GB（之后离线可用）。不想下这么大：在 ~/.config/jev-jarvis/env 里给判断层配一个 key 走云端，见 README「配置」。

本次包含

• chore(release): v0.4.0
• docs: AGENTS.md 红线同步视觉填入后备路径（配套 afb58cf）
• docs: README 交流反馈并排加个人微信二维码
• feat(release): 发版附固定资产名 + 显式 --latest + 发布后指针自检 (#31)
• feat(hud): 优化意图分析悬浮面板视觉层 (#28)
• feat(config): 新增可视化模型设置并明确重启生效 (#27)
• docs: CONTRIBUTING 红线同步 #26 的视觉填入后备路径
• fix(fill): 标记输入区并兼容无辅助功能输入控件的微信 (#26)
• docs: bootstrap 回归命令改为 uv run python（系统 python3 过旧会缺参数）
• fix(bootstrap): 修复 uv 自动安装并增加失败兜底 (#20)
• docs: README 披露本地模型与 venv 的位置、大小、清理方法 (#22)
• docs: README 再精简（146→88 行）并适配 #15/#16；补 issue 标签约定
• fix(packaging): 归一屏幕录制权限到应用 (#16)
• fix(perception): 防止自己消息触发回复并丢弃过期结果 (#15)
• docs: 新增贡献指南与认领协议；AGENTS.md 入库
• docs: 新增贡献指南与认领协议（issue 认领三步自检 + 分层自测要求）

需要 macOS 13+。下载即用：解压后把 jev-jarvis.app 拖进「应用程序」。

第一次打开：右键（或按住 Control 点）→ 打开 → 再点「打开」。未做 Apple 公证，双击会被 Gatekeeper 拦，只需这一次。
第一次启动：联网装依赖（uv 缓存命中就很快）；按提示授予「屏幕录制」权限，然后退出重开。
判断层默认跑本地模型，首次要下载约 7GB（之后离线可用）。不想下这么大：在 ~/.config/jev-jarvis/env 里给判断层配一个 key 走云端，见 README「配置」。

本次包含

• docs: 统一命名为 jev-chat-jarvis（README/推广稿/App 显示名）
• docs: 仓库迁移后同步链接（jev-chat/jev-chat-jarvis-mac）
• chore(release): v0.3.1
• feat(generate): 内置默认凭据（零配置开箱可用）+ 关思考透传 + 模型名运行时解析
• fix(perception): 修复主窗口选择与发出消息识别 (#10)
• fix(perception): 折行与最后一行比间距，3 行以上消息不再被拆碎

需要 macOS 13+。下载即用：解压后把 jev-jarvis.app 拖进「应用程序」。

第一次打开：右键（或按住 Control 点）→ 打开 → 再点「打开」。未做 Apple 公证，双击会被 Gatekeeper 拦，只需这一次。
第一次启动：联网装依赖（uv 缓存命中就很快）；按提示授予「屏幕录制」权限，然后退出重开。
判断层默认跑本地模型，首次要下载约 7GB（之后离线可用）。不想下这么大：在 ~/.config/jev-jarvis/env 里给判断层配一个 key 走云端，见 README「配置」。

本次包含

• chore(release): v0.3.0
• docs(readme): 瘦身重写（205→152 行）+ 同步提速/YOLO/鱼塘主口径
• feat(hud): YOLO 检测框 + 端到端提速（生成早跑/停稳提前/先上屏后排序）+ 两处修复
• feat(styles): 内置话术「鱼塘主」（海王海后技巧蒸馏）
• perf(perception): 采集降到 1x + Message 带跨行框几何 + y 顶边语义修正
• perf(http): keep-alive 连接池，生成/判断层共用
• test(judge): 回归直接 import 线上 INTENTS；记录 prompt 瘦身实测教训
• feat(generate): 候选生成改流式，首字 ~0.6s 上屏，不等最慢话术 (#8)
• perf(hud): 本地判断挪进停稳窗口并行跑，消息→意图再省约 1 秒 (#7)
• docs(readme): 入群二维码挪到开头演示下方
• fix(generate): thinking 模型 0 条候选时面板直接点名模型并给出换型建议 (#6)
• perf(warmup): 启动后台预热判断模型 + Vision OCR（首条消息判断 14759ms→0.8s，端到端 15351ms→2.2s） (#5)

需要 macOS 13+。下载即用：解压后把 jev-jarvis.app 拖进「应用程序」。

第一次打开：右键（或按住 Control 点）→ 打开 → 再点「打开」。未做 Apple 公证，双击会被 Gatekeeper 拦，只需这一次。
第一次启动：联网装依赖（uv 缓存命中就很快）；按提示授予「屏幕录制」权限，然后退出重开。
判断层默认跑本地模型，首次要下载约 7GB（之后离线可用）。不想下这么大：在 ~/.config/jev-jarvis/env 里给判断层配一个 key 走云端，见 README「配置」。

本次包含

• fix(release): 干净 worktree 里先 uv sync 再生成图标（无 venv 时图标静默缺失、发版卡在回验）
• chore(release): v0.2.0
• docs(readme): 精简至一半并同步今日实测；issue/PR 模板换成简版 markdown
• perf(poll): 聊天区指纹跳过 OCR + 快慢双档轮询；分析挪独立线程（消息→分析 2.0s→1.2–1.7s，静止 CPU 33%→15%）
• perf(perception): 进程内抓图 + CGImage 直喂 Vision（读屏 430-800ms→280-300ms）；接口拒绝时回退并记日志
• perf(judge): MPS 上改用 float16（bf16 走慢路径，实测判断 1.4s→0.75s，准确率不变）
• docs(readme): 实测数字按今天测量修正（判断稳态 1.4s 而非 0.7s、端到端 ~3.7s）；启动日志写后端
• fix(log): 日志统一写到 ~/Library/Logs/jev-jarvis.log（两种启动方式一致，stdout 已是该文件时不重复写）
• feat(context): 判断层和生成层共用「最近 4 轮 + 谁说的」；修掉被判断消息混进自己上下文的 bug
• perf(perception): OCR 去掉 en-US（实测逐块一致、省 30%）；首次调用在日志里标注 Vision 加载
• docs(readme): 下一步补两条（文章卡片过滤、模型预热）；OCR 耗时改成实测区间
• feat(hud): 分阶段耗时日志（读屏/判断/生成/排序/端到端），不含消息正文；README 加排查一节
• fix(hud): 面板高度贴合内容，不再拉长到微信窗口高度（放大微信时会拖近 300pt 空白）
• feat(styles): 候选按话术分组（组内一稳一放、一话术一并发请求）；面板高度对齐微信；JEV_TONES 可自定义话术
• docs(readme): 用法一节加 Releases 下载入口

需要 macOS 13+。下载即用：解压后把 jev-jarvis.app 拖进「应用程序」。

第一次打开：右键（或按住 Control 点）→ 打开 → 再点「打开」。未做 Apple 公证，双击会被 Gatekeeper 拦，只需这一次。
第一次启动：联网装依赖（uv 缓存命中就很快）；按提示授予「屏幕录制」权限，然后退出重开。
判断层默认跑本地模型，首次要下载约 7GB（之后离线可用）。不想下这么大：在 ~/.config/jev-jarvis/env 里给判断层配一个 key 走云端，见 README「配置」。

本次包含

• fix(packaging): --target 解析成完整 SHA（GitHub 不认短 SHA）
• chore(packaging): release.sh 支持 --target，把 release 钉在指定提交
• chore(packaging): 新增 release.sh（zip + 解压校验 + 发布）；构建包钉定 Python 版本、带上 LICENSE
• refactor(hud): 话术下拉框移到候选列表下方，竖排三行标 #1/#2/#3
• feat(styles): 内置 9 种话术 + 面板下拉框选择（默认 2 种、最多 3 种）
• docs(promo): 加 linux.do 推广文案
• docs(readme): 加演示动图（GIF，16s / 1.2MB）
• docs(readme): 加交流群二维码 + docs/ 素材目录
• chore(contributing): issue/PR 模板 + area/* 模块标签；修正 README 过时的「下一步」
• initial commit