简体中文 · English

狗头军师 Jev Chat

聊天窗口旁的狗头军师：读屏、分析、生成回复草稿。 这是从狗头军师延伸出来的独立项目。目前公开提供 Mac 源码预览包、Windows 预览 ZIP 和 Android 调试 APK。Android 版目前无法截取微信聊天画面，暂不支持微信；Windows 和 Android 仍需实机测试。发送始终由用户决定。

如果这套聊天副驾对你有用，可以给项目点一个 Star，方便以后找到，也让更多有相同需求的人看到它。

感谢 PR 贡献者 @RayWangQvQ（在7楼）：通过 PR #1 修复安卓通用截图流程中的核对页消失和确认循环，并补充焦点恢复测试。他在 PR 中报告了 Soul 真机验证，详细署名见文末「贡献者与致谢」。

iOS 键盘预览版

新增 iOS 工程与安装说明：主 App 配置模型、关系阶段和目标，聊天中切换狗头军师键盘，核对原文后分析，再把候选填入当前草稿。发送由你决定。

• 本地打字：约 6.5 万条词条的中文全拼、候选选字、英文大小写、数字、符号和光标移动。日常输入不调用模型，关闭完全访问仍可打字。
• 聊天识图：相册、文件、粘贴或系统快捷指令截图；支持 Apple Vision 本地 OCR、DeepSeek 与 OpenRouter 图片识别。顶部「识图」准备接收截图，真正截屏由系统快捷指令完成；云端先预览、确认后上传。
• 军师分析：DeepSeek 或 Jev 判断，DeepSeek 或 OpenRouter 生成回复。保留可能意图、判断把握、事实／推测／未知、下一步、停止条件、候选排序、理由与代价，以及「更像我一点」。百分比是模型估计或相对权重，不代表回复成功率。
• 草稿与轮次恢复：填入确认使用键盘内页面，确认后回到自己的打字布局；收起再打开可恢复五分钟内暂存的本轮原文与结果，需要重新核对收件人。
• 主 App：可视化 Key 配置、关系资料和聊天 CSV 的本地 K 线；米白、暖橙与柴犬标识。配置页已去掉「来源」区块，开源许可证与署名保留在仓库中。

当前提供 iOS 16+ Xcode 源码预览，暂无公开签名 IPA、TestFlight 或 App Store 下载。 编译后按安装说明添加键盘；使用联网军师时需允许完全访问。键盘无法取得完整聊天历史或自动核实收件人，聊天 App 的第三方键盘支持也有差异。「屏幕捕获（实验）」尚未完成真机验收，优先使用系统快捷指令。

本机使用 Xcode 27.0 完成模拟器与签名 iPhone 编译；225 项离线检查（核心 165、打字 33、OCR 27）、UI 语法和工程元数据检查通过。已在个人 iPhone 覆盖安装并启动；不同宿主 App 的完整交互和真实接口仍需分别验证。下方 Mac、Windows、Android Release 安装包不包含 iOS。

安卓图文教程：DeepSeek 配置与 Soul 使用

打开完整教程：附 10 张实际页面截图，从 DeepSeek 开放平台充值、创建和复制 API Key，讲到 Android 安装权限、识图、策略判断、回复生成，以及 Soul 手动截屏后的核对和复制回复。

只用 DeepSeek 时，「策略判断」和「回复接口」选 DeepSeek 官方，「视觉接口」选 DeepSeek，模型填 deepseek-flash，接口地址为 https://api.deepseek.com/v1；三个密钥框可填写同一个自己的 Key。再将「截图识图方式」选为「视觉模型（DeepSeek 等）」，点击「保存全部设置」。

Soul 使用通用手动截图路径：打开聊天 → 长按军师悬浮球 → 截屏识别一次 → 核对原文并确认分析 → 复制候选后手动粘贴发送。不同手机和应用版本仍需验证；当前安卓版暂不支持微信。

请下载 v0.1.8-preview 或更新版本。 教程中的合并配置页和「系统截屏」选项已包含在新版 APK 中；v0.1.7-preview 没有这两项更新。

最新版本：v0.1.8-preview

• 修复「详细分析」和「为什么这样回」对 JSON 代码块的解析，点击后显示加载状态；失败时显示错误原因，可重试或返回候选。详情使用回复接口，不需要额外配置。
• 策略判断配置合并为一个区域：选择 Jev 或 DeepSeek 后只显示相应接口字段，原有保存设置继续适用。
• 在「设置 → 分析 → 手动截屏方式」选择无障碍截屏或系统截屏；长按悬浮球统一使用「截屏识别一次」。系统截屏每轮需 Android 授权。
• 检测全黑或不完整的截屏并提示重试，不把黑图交给 OCR；部分模拟器仍可能返回黑图或裁切，微信仍不支持。
• 最新 Android 单元测试 50 项通过，调试 APK 构建通过。Windows 与 Mac 同期重新打包，其采集和分析逻辑本轮未修改；手机上的完整模型请求仍需实际验收。

新版下载及校验文件见 GitHub Releases。旧调试 APK 若签名不同，无法直接覆盖安装；先记下配置，再卸载旧包，卸载会清除本地数据。

此前更新：Android 核对、取消任务与 DeepSeek 上下文

2026 年 10 月 6 日，Android 修复了以下使用问题：

• 隐藏核对页、停用助手或切换会话时取消旧任务，清除核对状态，阻止旧结果重新打开悬浮窗；运行中的 HTTP 连接会尝试断开。
• DeepSeek 策略判断、标签轮换和候选排序都带上当前联系人的阶段、目标、背景及所选历史；详细分析和回复解释也使用当前背景。
• 候选只接受完整 JSON 字符串数组；说明文字、错误对象和截断输出会显示错误提示。
• 相同消息的不同联系人分别处理；OCR 自动分析关闭时，自动识别只亮悬浮球。手动「截屏识别一次」仍直接打开核对页，所有模型分析都需确认。
• 补齐七种中文策略的下一步建议；自己的后续消息不会解除对方的停止联系要求，对方再次主动发消息后重新判断。
• 策略连通测试读取设置页里刚填写的回复地址与密钥，无需先保存。新增取消任务、候选格式、上下文、会话身份和边界回归测试。

2026 年 10 月 4 日，PR #1 已合并到 main。本次修复针对 Soul 等通过手动截图识别的应用中，原文核对页消失或循环返回的问题：

• 核对页编辑文字时，忽略核对期间的无障碍窗口事件，避免焦点变化把页面替换成待机状态。
• 点「确认原文并分析」后，最多等待约一秒，让焦点回到原聊天应用，再验证窗口并开始分析。
• 如果已切换聊天应用，或窗口未恢复，显示提示；新增对应的状态判断单元测试。