JevIntent · 微信消息「意图 / 情绪 / 回复姿态」分析插件

一个 FkWeChat 插件：长按任意微信消息 → 调用 TypeSafe Jev 判定模型 → 几秒后在屏幕上弹出结论。不发任何消息、不改聊天记录，对方完全不知道。

①  意图：打招呼或闲聊 85%
    情绪：平静 56% · 客套 42% · 着急 2%
②  着急：不着急 · 0.48/3
③  建议：正常交流 90%

用途：对方这句话到底什么意思？该用什么姿态回？——判定用的，不是自动回复机器人。

⚡ v1.9 起基本是"点完就出"：长按弹出的那一刻就开始算（预判），你点中「意图」时结果通常已经回来了 —— 实测冷启动第一次 1144ms → 9ms。数字和做法都在下面《有多快》。

🔗 姊妹项目：旁观者 · JevBystander —— 同一个判定口径的安卓无障碍版：不用 root / 不用 Xposed，只读屏 + 固定 3 条 Toast。 装不了 LSPosed、或者怕 hook 微信的话用它；两套实现完全独立，同一台手机也能共存。 （代价：无障碍版只看得到屏幕上已显示的文字）

1. 手机装好 FkWeChat（LSPosed 模块）并在宿主里开启插件支持。

2. 把这个目录里的 main.java、info.prop 拷到：

   /storage/emulated/0/Android/media/com.tencent.mm/FkWeChat/Plugin/JevIntent/
   

3. 填你自己的 TypeSafe/Jev key（没有 key？看 docs/如何获取API密钥.md，免费，1 分钟）。两种填法任选：

   • 改 config.properties：把 config.example.properties 复制成 config.properties（同一目录），写 api_key=apikey_你的key
   • 不改文件：等插件第一次长按生成了 设置.properties，直接在最上面的 【1】接口密钥 后面写 apikey_你的key （两边都填以 设置.properties 为准；那边留空就回落到 config.properties）

4. 插件管理器里启用并重载（或重启微信）→ 看到 Toast「JevIntent 就绪 v1.9」就成功了。

5. 在任意聊天里长按一条文本消息（引用回复的消息也支持）→ 菜单出现「意图」。

⚠️ 仓库里不含任何密钥。config.properties、设置.properties、presets.properties 都是本地文件，已写进 .gitignore。

长按消息 → 菜单只有两项：

关系是「每个会话一个」（同事群和女朋友可以是两套结论），所以放不进全局设置文件，用这个菜单项切。

长按任意文本消息（引用回复的也支持）→ 菜单弹出，只有两项：

意图
关系＝普通朋友          ← 标题就是这个会话「当前的关系」

点一下「关系＝普通朋友」→ 立刻 Toast 「本会话关系 → 陌生人」，菜单标题同步变。 循环顺序：普通朋友 → 陌生人 → 家人 → 情侣 → 死党 → 同事 → 客户 → 领导 → 同学 → 网友 → 回到普通朋友。

按会话分别记：跟同事聊和跟女朋友聊是两套结论，互不影响（存在 presets.properties）。

关系影响有多大？同一句「我爱你」—— 情侣 = 高兴 94% / 建议肯定赞赏；同事 = 高兴 56% + 讽刺 34% / 建议温和婉拒。

[立即]      Toast：Jev 分析中…                    ← 可在设置里关掉
[3~10 秒]   Toast：意图：打招呼或闲聊 85%
                  情绪：平静 56% · 客套 42% · 着急 2%
[+2 秒]     Toast：着急：不着急 · 0.48/3
[+2 秒]     Toast：建议：正常交流 90%

默认 结果方式=A：全程只在本机弹提示，一条消息都不发，对方完全不知道。 失败也会明说（Jev 失败：Read timed out 之类），不会静默。

把「结果方式」改成 B 引用回复 / C 直接发消息，结果会作为真实消息发进聊天（对方能看到）， 适合"发给自己小号当备忘"这类玩法，慎用。

.../FkWeChat/Plugin/JevIntent/
├── main.java              插件本体（你放进去的）
├── info.prop              插件信息
├── config.properties      你的 key（可选，也可以填在设置文件里）
├── 设置.properties        ← 第一次长按后自动生成：所有开关都在这里改
└── presets.properties     ← 每个会话的关系/性别记在这

打开 设置.properties，把想要的那项等号后面的字母改掉（例：情绪条数=C），保存。 下次长按即时生效，不用重载插件、不用改代码。字母写错也不会崩（自动取第一个选项）。

第一次长按后会自动生成 设置.properties（和 main.java 同目录，带完整中文注释）。 改等号后面的字母 → 保存 → 长按消息立即生效（不用重载插件、不用改代码）。 这个文件永远不会被自动覆盖，删掉它下次长按会重新生成一份。

生成出来长这样：

# 【1】情绪条数
#     A. 只显示 1 条
#     B. 显示 3 条
#     C. 显示 5 条
情绪条数=B

字母写错（比如写 Z）不会崩，自动取第一个选项，日志里会记一行。

先把延迟拆开量了一遍（同一台 PC、同一个真接口、同样的 7 个问题）：

顺手证伪了两件事，省得白折腾：

• 砍问题不省时间：只问 3 题（意图/情绪/姿态）TTFB 283314ms，问满 7 题 291295ms —— 基本没差。
• 省握手没用：TLS 会话复用已经生效，连接复用时握手只要 9ms，省不出东西。

真正有用的是把等待藏起来。v1.9 三件套：

「预判」的代价：如果你点了「关系＝…」而不是「意图」，这次调用就白花了。 点「意图」这条常见路径调用次数不变（预判那次就是正式那次），只是等待被挪到了你挑菜单的时候。

• 情绪是概率分布的前 3 名，不是三次独立判断 —— 所以 平静 56% · 客套 42% 表示"像平静 56%、像客套 42%"。 第一名低于 40% 时说明它自己也拿不准，看前三名比看第一名有用。
• 着急 是 0~3 的连续分 + 四档档位（不着急/一般/急/非常急）。
• 建议 = 回复姿态（只给姿态，不给措辞），例如 建议：正常交流 90% 意思是"用正常交流的姿态回"。

同一个「我爱你」：情侣读成"高兴/该肯定赞赏"，非情侣全读成"高兴 + 讽刺/该温和婉拒"。 上下文比关系更能翻盘：情侣加两句"刚吵完"，姿态就从「肯定赞赏」变成「先安抚道歉 85%」。

1. onMsgMenu(msg) 挂上长按菜单，拿到被长按的 msg（含内容、时间、引用块）。

2. 组一个 state（关系 / 对方性别 / 会话类型 / 最近对话 / 待分析消息）+ 7 个问题， POST https://api.typesafe.ai/v1/systemone：

   { "state": "{\"关系\":\"情侣\",\"最近对话\":[…],\"待分析消息\":\"我爱你\"}",
     "model": "jev-latest",
     "questions": { "intent": {"type":"choice","criteria":{…}},
                    "emotion": {"type":"choice","criteria":{…}},
                    "urgency": {"type":"score","criteria":[…]},
                    "reply_style": {"type":"choice","criteria":{…}}, … } }

   choice 类问题会返回完整概率分布（probabilities），所以一个情绪问题就能给出前 3 名 + 比例。

3. 结果按固定 3 条 Toast 弹出（或引用回复 / 直接发消息，取决于设置）。

为什么设置是文件而不是界面：宿主插件 API 只暴露了 toast 一个 UI 原语， 没有弹窗、没有输入框（其他函数 一节里只有 toast）。所以"文件即面板"是最稳的方案。

更多排查手法（含"阶梯自检"调试法）见 docs/详细文档.md。

main.java                   插件本体（单文件，拷进插件目录的就是它）
info.prop                   插件元信息（名称/作者/版本）
config.example.properties   配置模板 → 复制成 config.properties 再填 key
设置.properties             首次长按自动生成（选项面板，本地文件不入库）
docs/如何获取API密钥.md      ⭐ 没有 key 先看这个：官网注册 → 建 key → 填进插件
docs/详细文档.md            全部实跑数据、关系对照、bsh 踩坑记录
test/                       本地离线测试（不用手机就能跑完整流程）
tools/package_release.py    打 Release 安装包：一条命令 → dist/JevIntent-v<版本>.zip

python tools/package_release.py     # 先跑密钥自检，不干净直接中止

产物 dist/JevIntent-v1.9.0.zip（约 30 KB）：main.java / info.prop / config.example.properties / README.md / LICENSE / docs/ —— 就是"拷到手机插件目录就能用"的那几个文件， 然后把 zip 拖到 GitHub Release 的 assets 里即可。 （GitHub 每个 Release 自动生成的 Source code (zip) 是整仓源码，跟这个安装包不是一回事。）

插件是 bsh（BeanShell）脚本，可以直接用 bsh 2.0b6 在 PC 上加载跑通全流程： 见 test/README.md。其中 test/lex_audit.py 是专门防止 "中文 + 反斜杠转义"混写字面量把 bsh 词法器搞崩 的静态检查（这个坑不可捕获， 详见详细文档）。

test/test_speed.bsh 是 v1.9 的速度专项测试：真打接口，验证连接复用（第二次握手应 <80ms）、 预判能提前拿到结果、缓存 40 条上限 —— 输出里会直接打印「握手 Xms + 服务端 Yms」。

PC 上用 JDK 17 跑 bsh 需要放行两个内部包（安卓真机不需要）： java --add-exports java.base/sun.net.www.protocol.https=ALL-UNNAMED --add-opens java.base/sun.net.www.protocol.https=ALL-UNNAMED --add-exports java.base/sun.net.www.protocol.http=ALL-UNNAMED --add-opens java.base/sun.net.www.protocol.http=ALL-UNNAMED -cp "bsh-2.0b6.jar;." bsh.Interpreter test_speed.bsh

• 只做判定，不生成回复文案。
• 设置只能改文件（宿主没有弹窗 API）。
• 关系/性别是"每会话"的，只能用菜单循环切换，或直接编辑 presets.properties。
• 取上下文最多前后各 7 句。
• 依赖第三方 API（TypeSafe Jev），需要自备 key。
• 速度下限由服务端决定：算法本身要 250330ms，且约 3% 的请求会抖到 1.51.8s。 预判只能把这 300ms 藏进"你挑菜单"的时间里，消不掉服务端抖动（想要更稳可以自己加重试）。

Jev 判定能力来自 TypeSafe（jev-latest）。本项目为个人自用插件，MIT License。