jev-chat/jev-chat-jarvis-mac · 上手攻略

  • 仓库：jev-chat/jev-chat-jarvis-mac
  • 链接：https://github.com/jev-chat/jev-chat-jarvis-mac
  • 分类：效率工具 · macOS 聊天辅助 / 本地 AI 判断
  • 作者：Tom
  • 更新：2026-09-25

这是什么

jev-chat-jarvis-mac 是一个macOS 悬浮窗助手，专门为聊天场景设计：当聊天应用（微信 / QQ）收到消息时，它立刻读取屏幕内容，用本地模型判断发送者的真实意图和风险等级，再生成候选回复供你一键复制或填入输入框。整套流程纯本地运行，不截图、不 OCR 解密数据库、不注入任何内容——只是"看屏幕 + 本地模型判断"。

核心定位：把"对方这句话到底想说啥"和"怎么回复最合适"这两件事，在悬浮窗里一次搞定。

解决什么问题

  • 微信/QQ 消息来了，光看文字不确定对方是试探、抱怨、还是开玩笑，怕回复错了踩雷
  • 想高情商回复但一时想不到合适的话术，需要候选参考
  • 不希望任何聊天内容上传云端，隐私要求高（纯本地模型判断）
  • 在多聊天窗口之间切换时，需要快速了解每条消息的意图而不逐个点开

快速安装

⚠️ 仅支持 Apple Silicon Mac，macOS 13+，不支持 Intel Mac，也不要通过 Rosetta 运行（torch 无 Intel 版本）。

方式一：直接下载（推荐）

# 下载最新 .zip
https://github.com/jev-chat/jev-chat-jarvis-mac/releases/latest/download/jev-jarvis-macos-latest.zip

解压后将 jev-jarvis.app 拖入「应用程序」文件夹。

方式二：Gatekeeper 解除

如果双击提示"已损坏，无法打开"，在终端执行：

sudo xattr -r -d com.apple.quarantine /Applications/jev-jarvis.app

⚠️ 若.app 改了名（如「jev-jarvis 2.app」），把命令里的目录名换成实际路径。

方式三：从源码运行

git clone https://github.com/jev-chat/jev-chat-jarvis-mac.git
cd jev-chat-jarvis-mac
./start.command

⚠️ 版本号：当前最新稳定版为 v0.6.0（2025 年），建议优先使用 Release 页面标注的版本，GitHub 拉取前请确认。

首次权限配置

  1. 启动 app 后按系统提示授予「屏幕录制」权限（系统设置 → 隐私与安全性 → 屏幕录制 → 打开 jev-jarvis）
  2. 「填入」功能另需「辅助功能」权限（第一次点「填入」时弹系统授权框）
  3. 退出并重新打开 app 使权限生效

核心用法

启动后的基本界面

启动后菜单栏出现一个「J」图标，点击展开悬浮窗，顶部显示当前聊天分析状态。消息进来后，悬浮窗同时显示：

  • 意图类型（8 类，零样本准确率 86.4%，在 22 条回归测试集上测得）
  • 风险等级（0–9 分 + 行动建议）
  • 候选回复（按话术分组，每组 1–5 条可选）

话术配置

内置 14 种话术，可同时启用 3 种，分组显示在面板底部。可选话术包括：

  • 高情商话术
  • 贴吧老哥 v1.0
  • 阴阳怪气
  • 狗头军师·稳健 / 会撩 / 抽离（恋爱向三件套，v0.6.0 新增）
  • 夸夸（v0.6.0 新增）

切换话术后，候选立刻按当前消息重新生成。

校准模式（v0.6.0 新增）

微信 4.x 支持独立聊天窗口、可拖动联系人列表，自动识别区域可能漏消息或读到列表摘要。v0.6.0 起支持人工区域校准：

  1. 点击悬浮窗右上角校准图标（四角取景框）
  2. 拖动绿框选中消息识别区域（包含双方头像与气泡）
  3. 拖动蓝框选中输入区域（排除底部工具栏和发送按钮）
  4. 点击「预览识别」→「确认并启用」

⚠️ 校准数据保存在 ~/.config/jev-jarvis/env 的 JEV_MESSAGE_REGION 和 JEV_INPUT_REGION，仅限当前窗口尺寸有效，窗口整体移动无需重画。

模型配置（env 文件）

全部配置在一个文件：

mkdir -p ~/.config/jev-jarvis
cat > ~/.config/jev-jarvis/env <<'ENV'
# 判断层（可选）：TypeSafe Jev，不填用本地 decider-2b（约 3.8 GB）
export TYPESAFE_API_KEY=""

# 生成层（可选）：OpenAI 兼容端点
export OPENAI_API_KEY="sk-your-key"
export OPENAI_BASE_URL="https://api.deepseek.com"
export OPENAI_MODEL="deepseek-chat"

# 思考模式要关掉（Qwen3 等，否则 max_tokens 吃光，候选 0 条）
# export OPENAI_EXTRA_BODY='{"enable_thinking":false}'
ENV
chmod 600 ~/.config/jev-jarvis/env

判断层路径选择： - JUDGE_BACKEND=cloud：在线判断（配 TYPESAFE_API_KEY） - JUDGE_BACKEND=local：离线判断（首次启动下载 decider-2b 约 3.8 GB） - 不填：模型已在本地就本地用，未下载则面板提示引导

国内网络加速：首次下载时若 huggingface.co 不可达（探测 2.5 秒），自动切换到 hf-mirror.com 镜像。也可在 env 里显式指定：

export HF_ENDPOINT="https://hf-mirror.com"

⚠️ 不要用思考模型做生成层（如 deepseek-chat 的思考模式）：思考会耗尽 max_tokens，导致候选生成 0 条，面板只报「候选生成失败」。

典型适用场景

  1. 微信聊天防踩雷：别人发了一条模糊消息，先看意图判断再决定怎么回
  2. 跨时区工作协调：夜里收到海外消息，高情商候选帮你快速组织语言
  3. 隐私敏感用户：所有判断和生成都在本地，不经过任何云端
  4. 多聊天窗口并行：同时开着微信和 QQ，悬浮窗跟随前台窗口各自判断

坑与注意

⚠️ 1. 仅 Apple Silicon + macOS 13+ Intel Mac 完全不支持（torch 无 Intel 版本），这不是 bug，是底层依赖限制。

⚠️ 2. 屏幕录制权限是必须的 即使只用文本接口路径（纯辅助功能），macOS 仍要求屏幕录制权限才能读屏。授予后退出重开生效。

⚠️ 3. 候选生成依赖生成层模型 如果只配了判断层（本地 decider-2b）但没配置生成层，候选回复无法生成，只能看到意图和风险。

⚠️ 4. YOLO 检测框（可选） JEV_BOXES=1 开启后会在聊天窗口上实时框出 OCR 命中的消息（对方/我分色 + 置信度），菜单栏可切换开关。

⚠️ 5. 手动校准是微信 4.x 用户的必选项 微信 4.x 有独立聊天窗口、可拖动联系人分栏，自动模式会漏消息。v0.6.0 校准后建议每次换窗口尺寸时重新校准。

⚠️ 6. 聊天标题为空时不分析 识别不到聊天标题时悬浮窗不会触发分析，这是预期行为。

⚠️ 7. "填入"仅写入文字，不发送 用户始终在聊天应用里手动按发送，jev-jarvis 不会自动发送任何内容。

⚠️ 8. 判断层离线模型约 3.8 GB 首次启动选择离线模式会下载模型，已缓存后完全离线（从本地快照加载，不查新版本）。

与同类对比

工具 平台 核心能力 本地模型 隐私 安装方式
jev-chat-jarvis-mac macOS（Apple Silicon） 意图判断 + 候选生成 + 填入 ✅ ✅ 完全离线 .app 下载
WeChat AI Helper Windows 聊天摘要 / 自动回复 ❌ ❌ 云端 Windows 端
ChatGPT for WhatsApp WhatsApp Bot 对话生成 ❌ ❌ 云端 Telegram Bot
本地 LLM + 快捷指令 iOS 触发式生成 ✅ ✅ Shortcuts

核心差异：jev-chat-jarvis-mac 是目前唯一一个原生 macOS 菜单栏级别的聊天意图判断工具，深度整合 Apple Vision + 本地 torch 模型，纯只读屏幕感知，不依赖任何云端 API（生成层可选本地或云端）。

一句话推荐结论

如果你在 macOS 上用微信或 QQ，且经常遇到"这句话到底什么意思、怎么回才合适"的困扰，jev-chat-jarvis-mac 把意图判断和候选话术直接送到屏幕旁边，全程本地运行、隐私无虞——v0.6.0 的人工校准和 QQ 支持让准确率大幅提升，是目前同类工具里完成度最高的。