Repository navigation
Releases: ooboqoo/shiping
Release list
v3.4.0
✨ 改名「识屏 Shiping」
「截屏解题助手」改名为「识屏 Shiping」，仓库地址改为 ooboqoo/shiping，旧地址会自动跳转。本项目的核心一直是「截屏 + AI 理解」，用途不止面试和考试，新名字直接说明它做什么。功能不变，原因和具体变动见 README 的「关于改名」。
- 应用名改为「识屏」，安装包改为
shiping-3.4.0-…；截图模式的标题改为「截屏解答」 - 全新应用图标：截图取景框的四个角围着一颗 AI 星芒，替换原来的 Electron 默认图标
- 截图、对话记录的默认保存目录改为 图片/Shiping、文档/Shiping。只影响没有指定目录的，旧文件留在原处
🐛 修复
- 以后仓库再改名，macOS 也能照常收到新版本提示
升级说明：设置、AI 配置、提示词场景、资料库会在首次启动时自动迁移，不需要重新配置。
Windows 用户请注意：覆盖安装即可，安装位置不变，开始菜单和桌面快捷方式改名为「识屏」。用局域网手机同步的，程序文件名变了，防火墙可能要重新放行一次（弹出的是系统窗口，共享屏幕时对方能看到，请提前处理）。
macOS 用户请注意：
- 新版是「识屏.app」，拖进「应用程序」后可以删掉旧的「截屏解题助手.app」。签名证书和应用标识没变，一般不用重新授权；如果系统音频没声音，到「系统设置 → 隐私与安全性 → 屏幕与系统音频录制」里重新打开「识屏」
- 3.3.0 在仓库改名后收不到新版本提示，用 3.3.0 的请手动下载本版本
- 从 3.2.0 及更早版本升级的，需要重新授权一次屏幕录制，步骤见 3.2.1 的说明
- 首次打开被系统拦截（提示「已损坏」或「无法验证」）时，按 Wiki 在终端执行
sudo xattr -cr /Applications/识屏.app - 仅提供 Apple Silicon（arm64）版本，Intel 芯片的 Mac 请从源码运行
Full Changelog: v3.3.0...v3.4.0
v3.3.0
✨ 新功能
手机同步 —— 截图模式的解答和对话模式的提示实时显示在手机浏览器上，手机只看不操作，不用装 App。手机可以立在一旁看，电脑屏幕上不用留任何窗口。在「设置 → 手机同步」里打开，默认关闭。感谢 @okey2oo（#117）
- 局域网：手机和电脑连同一个 Wi-Fi，扫设置页里的二维码即可，什么都不用部署
- 公网中转：手机用流量也能看，需要在自己的服务器上跑中转服务，部署见 relay/README.md
- 电脑上按上翻 / 下翻快捷键，手机跟着翻页；切换截图 / 对话模式，手机切到对应的标签
- 手机页面顶栏的太阳按钮让手机屏幕常亮
- 二维码只显示在设置页里，共享屏幕时对方看不到。二维码链接相当于只读密码，别外发；泄露了就点「更换二维码」
🐛 修复
- macOS 有时收不到新版本提示：检查新版本用的 GitHub 接口按 IP 限流，同一个代理出口的人多了就查不到。现在改查发布页地址，不再受限流影响
升级说明：原有设置全部保留，不需要重新配置。
Windows 用户请注意：首次开启局域网同步时会弹出防火墙提示，请允许。这个提示是系统窗口，共享屏幕时对方能看到，请在面试前设置好。手机打不开时见 README 的「在手机上看答案」。
macOS 用户请注意：
- 从 3.2.0 及更早版本升级的，需要重新授权一次屏幕录制，步骤见 3.2.1 的说明；从 3.2.1 及之后的版本升级不需要
- 首次打开被系统拦截（提示「已损坏」或「无法验证」）时，按 Wiki 在终端执行
sudo xattr -cr /Applications/截屏解题助手.app - 仅提供 Apple Silicon（arm64）版本，Intel 芯片的 Mac 请从源码运行
Full Changelog: v3.2.2...v3.3.0
Contributors
Assets 6
v3.2.2
✨ 改进
- 标题栏重新布局：截图 / 对话切换移到标题栏中间，标题和版本号在最左边；窗口变窄时先压缩标题，版本号和「有新版本」不会被挤到切换按钮上
- 解题耗时移到底部状态栏：生成中显示「正在生成... 12s」，结束后显示「用时 1m05s」
- 答案最后一行不再被状态栏挡住：滚到底时能完整看到结尾
升级说明：原有设置全部保留，不需要重新配置。
macOS 用户请注意：
- 从 3.2.0 及更早版本升级的，需要重新授权一次屏幕录制，步骤见 3.2.1 的说明；从 3.2.1 升级不需要
- 首次打开被系统拦截（提示「已损坏」或「无法验证」）时，按 Wiki 在终端执行
sudo xattr -cr /Applications/截屏解题助手.app - 仅提供 Apple Silicon（arm64）版本，Intel 芯片的 Mac 请从源码运行
Full Changelog: v3.2.1...v3.2.2
v3.2.1
✨ 新功能
新版本在窗口内提示 —— 以前 Windows 用系统对话框询问是否更新，macOS 则收不到任何提醒。系统对话框和通知不受内容保护，面试中弹出来会出现在共享的屏幕上。现在只在主窗口里提示：标题栏版本号后面显示「有新版本」，点进帮助页「简介」可以看到详情和按钮。
- Windows：不再自动下载，由你点「下载」，显示下载进度，下完点「重启安装」；没点的话退出应用时也会自动安装。下载失败会显示原因，可以重试
- macOS：不支持自动更新，卡片会说明怎么替换安装，并链接到发布页
- 只提示正式版（Latest），不提示预发布版；启动时检查一次，之后每 6 小时检查一次，检查失败不打扰
🐛 修复
- macOS 选「系统音频」开始监听时报
Permission denied by system：截图正常，系统音频却始终被拒绝，删掉授权重新添加也没用。原因是 macOS 版没有正确签名，系统音频由应用的一个子进程获取，macOS 给它判权限时认不出它属于本应用。现在 macOS 版带有固定的签名，以后升级也不用重新授权。关联 #104 - 打包版点「框选区域」后应用消失、无法框选：框选窗口一直没显示出来，主窗口又已隐藏，看起来应用消失了，要等 5 分钟才恢复。现在框选正常；万一框选窗口 10 秒内没出来，也会自动取消并恢复主窗口。关联 #109
- macOS 其他应用全屏时窗口有时消失：在全屏的会议软件或浏览器上方，主窗口和工具条有时看不到，显示 Dock 图标时更容易出现。现在不管是否隐藏 Dock 图标，都能浮在全屏应用之上。关联 #112
- macOS 框选区域后 Dock 图标消失：显示 Dock 图标时，框选一次图标就没了，取消框选也不回来；在其他应用的全屏界面里框选时，那块屏幕上也看不到框选窗口。两个问题都已修复
📖 文档
升级说明：原有设置全部保留，不需要重新配置。
macOS 用户请注意：
- 从这个版本开始 macOS 版带有签名。从 3.2.0 及更早的版本升级后，需要重新授权一次：在「系统设置 → 隐私与安全性 → 屏幕与系统音频录制」里用「−」删掉截屏解题助手，打开应用截一次图，在弹窗里重新允许，再按提示重新打开。以后再升级就不用了
- 首次打开被系统拦截（提示「已损坏」或「无法验证」）时，按 Wiki 在终端执行
sudo xattr -cr /Applications/截屏解题助手.app - 仅提供 Apple Silicon（arm64）版本，Intel 芯片的 Mac 请从源码运行
Full Changelog: v3.2.0...v3.2.1
v3.2.0
✨ 新功能
显示思考过程 —— 以前用思考模型（DeepSeek、Qwen3、GPT 等）时，思考阶段只能对着转圈干等；现在能看到模型正在想什么。
- 截图模式：答案上方是一个固定三行高的思考框，边想边往上滚，不会把页面挤得跳来跳去；正文开始输出后折叠成一行，点开可以回看
- 追加截图、追问各有自己的思考块，排在它们各自的回答上面
- 对话模式：每张提示卡片里可以展开「思考过程」，看这条提示是怎么想出来的
- 打开了「关闭思考」的配置不受影响：模型不思考，界面和以前一样
感谢 OneCuriousLearner 贡献 (#93)
保存对话记录 —— 面试结束后想复盘？在「设置 → 对话模式」打开「保存对话记录到本地」，对方说的话和 AI 提示会自动保存成 Markdown 文件。关联 #102
- 一段对话一个文件，文件名是开始时间（
对话记录_<日期>_<时间>.md），默认存在「文档/InterviewCoder」，可以换目录；清空对话后另起一个新文件 - 边聊边保存，退出应用时也会立即写入
- 出错、被撤回和「（无需回应）」的提示不写入，只留下有用的内容
🐛 修复
- Windows 按住截图快捷键不再反复截图、反复请求：以前按住快捷键（或按键卡住）会连续触发，同一张截图被发出多个 AI 请求，答案互相穿插写在一起，停止键也停不下来。现在按住只触发一次，截图过程中再按也只发一个请求，停止键能取消正在进行的截图。移动窗口、翻页、调透明度仍然可以按住连续调整。关联 #100
- 对话模式的新提示完整显示：提示多了以后，新卡片会停在提示栏底部只露出第一句，后面的内容在看不到的地方生成。现在新提示总是从提示栏顶部完整显示；写完如果超出可视区域，会自动往下翻一页（生成过程中你自己滚动过就不翻）。从设置页回来时也直接定位到最新的提示。关联 #98
- 系统音频启动失败时显示具体原因：以前只提示一句「请检查系统音频权限」，看不出哪里出了问题。现在提示末尾会附上原始错误（如
AbortError: Error starting capture），反馈问题时请一并贴上；macOS 还会指向「屏幕与系统音频录制」权限，并提醒授权后要⌘Q完全退出再重新打开。另外修复了 macOS 未授予屏幕录制权限时，开启语音转录或对话模式「开始监听」毫无反应的问题。关联 #104
📖 文档
- 帮助页新增常见问题「截图后提示 API 调用失败，或一直显示正在生成」
- README 新增「遇到问题」一节，链接到 Wiki 中按类别整理的排查页：AI 模型配置与调用失败、截图问题、窗口与快捷键问题、语音与对话模式
- 隐身能力的相关讨论统一到 #21
升级说明：原有设置全部保留，不需要重新配置。「保存对话记录到本地」默认关闭，需要的话自己打开。
macOS 用户请注意：仅提供 Apple Silicon（arm64）版本，Intel 芯片的 Mac 请从源码运行。
Full Changelog: v3.1.0...v3.2.0
v3.1.0
✨ 新功能
资料库 —— 让 AI 作答时参考你自己的资料。在「设置 → 资料库」导入简历、项目笔记，或把准备好的问答直接粘贴成文本：
- 支持 PDF、Word（.docx）、Markdown、TXT，可以拖入导入；提取出的文字可以编辑（PDF 排版错乱时可手动修正），也可以从原文件重新导入
- 经历类问题会结合简历里的项目和数据，用第一人称回答；资料里有现成回答的问题，按你准备的要点和说法来
- 每份资料可以分别选择用于截图模式、对话模式（新导入的默认两种都用）；两种模式的设置页会显示各自用了多少资料
- 资料放在场景提示词之前，切换场景不影响；DeepSeek、OpenAI 等平台会自动缓存这段重复的前缀，连续提问时更快也更便宜
- 扫描件、旧版 .doc、加密 PDF 会给出对应提示；TXT 自动识别 UTF-8 / UTF-16 / GBK 编码
关联 #91
🎨 改进
- 请求超出模型上下文长度时，报错会说明原因并指向资料库
- 帮助页 FAQ、README 补充资料库的说明
注意：资料只保存在本机，但会随每次请求发给该模式使用的 AI 平台。资料越多回答越慢、费用越高，建议每个模式不超过 3 万字（超过时设置页会提示）。
macOS 用户请注意：仅提供 Apple Silicon（arm64）版本，Intel 芯片的 Mac 请从源码运行。
Full Changelog: v3.0.0...v3.1.0
v3.0.0
v3 新增对话模式：语音面试时，根据面试官刚说的话实时给出回答提示，不需要截图。加上原有的截图解题，本软件从「看屏幕解题」变成「看屏幕 + 听对话」，因此版本号升到 3.0。
只有截图解题的 v2 版本保留在 v2 分支，不再更新，此后只维护 v3。
✨ 新功能
对话模式 —— 点窗口顶部的「对话」（或按 ⌥⇧M / Ctrl+Shift+M）切换过去，按 ⌥T / Ctrl+T 开始监听。左边逐句显示对方说的话，右边给出简短提示：一句能直接说出口的开场，加上几个要点。
- 自动出提示（默认）：对方说完一句话立刻出提示；如果对方其实还没说完，这条提示会先撤回，等说完后重写到同一张卡里。「好的」「嗯」这类太短的句子不会触发
- 手动出提示：只在按
⌥G/Ctrl+G时出。两种方式下都可以随时按它立即出提示，没有新内容时再按一次会换个说法重出；⌥⇧G/Ctrl+Shift+G切换自动 / 手动 - 预设「技术面试」「行为面试」「英文面试」三个场景，也可以自己新增
- 可以单独选用一个 AI 配置，建议选打开「关闭思考」的快模型
- 采集的是系统音频（会议里对方的声音），自己说话不会触发提示；需要在「设置 → 语音」填写阿里云百炼 API Key
- 鼠标移到提示上，左边会高亮它对应的问题；去设置页调整时监听不中断，对话也不会丢
设置页改为分组导航 —— 配置项越来越多，整页从头滚到尾很难找。现在左侧导航分为通用（AI 模型 / 语音 / 界面与隐私 / 快捷键）和模式（截图模式 / 对话模式），一次只显示一组，不常用的项收进「高级」。
AI 配置按模式选用 —— 可以保存多套 AI 配置（API 地址、密钥、请求头、模型、思考开关），截图模式和对话模式各选一个：截图模式用能识图的模型，对话模式用更快的模型，互不影响。⌥[ / ⌥] 在当前模式的配置间切换。模型下拉会标出不能识图的模型，截图模式不能选用这类配置。多配置最早由 @abing7k 贡献 (#89)
关闭模型思考 —— 每个 AI 配置可单独打开「关闭思考」，跳过看不见的思考过程。用 Two Sum 截图实测，DeepSeek V4.1 Flash、GLM-4.5V 的首字从 4–28 秒降到 1–2 秒。模型不支持时自动去掉该参数重试，不会导致请求失败。
多显示器与截图区域 —— 截图屏幕可以跟随鼠标或固定某块屏幕；也可以框选一块区域，之后每次截图只截这块，AI 看得更准、响应更快。设置页、悬浮工具条和快捷键 ⌥⇧R / Ctrl+Shift+R 都能重新框选。关联 #80
算法题代码自动保存 / 复制 —— 解答里的代码可以自动复制到剪贴板，或按语言保存为源文件，文件名和重名规则可以自定义。感谢 @abing7k (#89)
快捷切换提示词场景 —— ⌥⇧P / Ctrl+Shift+P 或悬浮工具条按钮依次切换场景，下次提问生效，不清空当前对话；标题栏显示「场景 · 模型」。预设场景也可以删除，快捷键只在剩下的场景间循环。
答案渲染数学公式 —— 支持 $...$、$$...$$ 以及 \(...\)、\[...\] 写法。关联 #81
自定义请求头 —— 适配除 API Key 外还要求额外请求头的平台或网关（Azure、Cloudflare AI Gateway 等）。关联 #78
标题栏显示解题耗时 —— 从按下截图到答案生成完毕，精确到秒。感谢 @abing7k (#89)
🎨 改进
- 流式答案按帧合并渲染，长答案不再越出越慢
- 鼠标穿透不再依赖悬浮工具条，设置页新增独立开关
- 悬浮工具条的按钮随模式变化，最后一个按钮用来切换模式
- 快捷键按「截图模式 / 对话模式 / 两种模式通用」重新分组
- 新增「隐藏快捷键提醒」开关
- 截图模式标题改为「截屏解题」，与对话模式的「对话提示」对齐
- README 按两种模式重写
🙌 新贡献者
升级说明：
- 原有的 AI 配置、提示词、快捷键全部保留，两种模式默认都使用你原来在用的 AI 配置
- 行为变化：「设置 → AI 模型」里点选配置现在只是打开它来编辑，不再切换使用中的配置。要改某个模式用哪个配置，点配置里的「用于」，或到「截图模式」「对话模式」设置组里选
- 新增快捷键
⌥G/⌥⇧G/⌥⇧M（Windows 为Ctrl+G/Ctrl+Shift+G/Ctrl+Shift+M），如与常用软件冲突，可在「设置 → 快捷键」修改；已改过的快捷键保留不变
macOS 用户请注意：仅提供 Apple Silicon（arm64）版本，Intel 芯片的 Mac 请从源码运行。
Full Changelog: v2.1.0...v3.0.0
Contributors
Assets 6
v2.1.0
✨ 新功能
浅色背景主题 —— 做题、考试页面大多是白底，默认的深色半透明窗口盖在上面很显眼。现在可以在「设置 → 界面设置 → 背景主题」切换为浅色（白底黑字），主窗口、悬浮工具条和代码高亮一起跟随，切换即时生效。感谢 @Simon404Error (#84)
Model 与 API Base URL 联动 —— 同一个模型在各家平台的写法不一样（DeepSeek 官方是 deepseek-flash，OpenRouter 是 deepseek/deepseek-v4.1-flash），以前模型列表和 Base URL 互不相干，很容易填错。现在：
- Model 下拉按当前平台的写法列出推荐模型，并从平台接口加载完整模型列表（OpenRouter、硅基流动只列出支持图片输入的模型）
- 切换 API Base URL 时，模型自动换成新平台的写法；没有对应模型时，恢复你上次在该地址用的模型，再不行就用平台推荐模型。切换后会弹出提示，可一键撤销
- 模型写法与平台不符、平台上找不到该模型、模型不支持图片输入时，Model 下方会给出提示，多数情况可一键替换
- 自定义模型和上次使用的模型按 Base URL 分别记住
API Base URL 改为下拉框 —— 预设 DeepSeek、OpenRouter、硅基流动，并标注平台名；也可以直接输入自定义地址保存到列表里。设置页和首次配置弹窗都已换成下拉框，首次配置选好平台后会自动带出该平台的推荐模型。感谢 @Simon404Error (#84)
界面显示版本号 —— 主窗口标题栏和帮助中心显示当前版本，反馈问题时方便确认。
🎨 改进
- 推荐模型更新：GPT 系列升级为 GPT-6（
gpt-6-luna/gpt-6-sol/gpt-6-astra）；DeepSeek 改为deepseek-flash（官方接口）/deepseek/deepseek-v4.1-flash（OpenRouter），替代 2.0.2 的deepseek/deepseek-v4-flash-vision-exp。之前选的 GPT-5.6 仍能识别，切换平台时照常转换写法 - 下拉框关闭后自动清空搜索词
🐛 修复
- Windows 下悬浮工具条按钮点击无效 —— 工具条是不抢焦点的窗口，Windows 会直接丢弃这类窗口的鼠标按下事件，所以悬停触发一直正常、点击却没反应。现在改为松开鼠标时触发；拖动工具条左右边缘调整宽度的问题也一并修复。macOS 不受影响
- 超长模型名（如
deepseek/deepseek-v4-flash-vision-exp）撑破设置页布局，出现横向滚动条
🙌 新贡献者
- @Simon404Error 在 #84 完成了首次贡献
升级说明：本版本没有配置项迁移，从 2.0.x 直接覆盖安装即可，原有设置全部保留。之前添加的自定义模型会在所有 Base URL 下继续列出。
macOS 用户请注意：仅提供 Apple Silicon（arm64）版本，Intel 芯片的 Mac 无法使用。
Full Changelog: v2.0.2...v2.1.0
Contributors
Assets 6
2.0.2
本版本是 2.0.1 的替换版（2.0.1 已下架），下面的内容包含 2.0.1 的全部改动。
✨ 新功能
窗口大小可自由调整 —— 拖动主窗口的边缘或四角即可缩放，不再受限于固定尺寸。可在「设置 → 界面设置 → 允许调整主窗口大小」中关闭，关掉后鼠标移到边缘不会再出现缩放光标。感谢 @renyumeng1 (#61)
由于透明无边框窗口用不了系统原生缩放（会破坏 Windows 上的透明效果），缩放改由主进程跟踪光标实现。
新增「截图展示方式」设置 —— 主界面上的截图可以选择「显示全部缩略图」（默认）、「卡片显示截图数量」或「不展示」。无论选哪种，截图都会照常发送给 AI，只是不再占用版面 —— 窗口开得小的时候可以把空间全留给答案。
新增预置模型 deepseek/deepseek-v4-flash-vision-exp
🎨 改进
- 悬浮工具条整体更紧凑（504×52 → 404×44），少占屏幕
- 工具条也可以拖动左右边缘调整宽度（高度由按钮行决定，固定不变）。按钮尺寸始终保持不变，宽度不够时会从右侧开始隐藏放不下的按钮
🐛 修复
- 拖动主窗口时悬浮工具条会不断变大 —— Windows 在 125% / 150% / 175% 这类非整数缩放下必现：工具条几秒内撑满整个屏幕，吞掉所有鼠标点击（鼠标穿透只作用于主窗口），而且因为工具条开着内容保护，截图也跟着作废。macOS 不受影响
- 软隐藏窗口后快捷键与工具条失灵 —— 窗口被移到屏幕外时系统判定为「被遮挡」并冻结渲染进程，导致快捷键要等到下次点击窗口才响应、工具条的悬停触发完全不工作。感谢 @OneCuriousLearner (#68)
- 标题栏的设置 / 帮助 / 关闭按钮贴着窗口边缘的那几个像素被缩放热区盖住，点不动
- 缩放拖拽在个别情况下松开鼠标后没有结束，窗口会继续跟着光标跑（最长 30 秒）
- 「卡片显示截图数量」在追加超过 5 张截图后，数字一直停在 5 —— 缩略图只保留最近 5 张，但每一张都是发给了 AI 的
🧹 其他
- 移除 Linux 构建支持。此前一直没有实际维护，且 Electron 在 Linux 上会把窗口尺寸约束钉死，新的缩放功能在该平台上本就无法工作
升级说明：本版本没有配置项迁移，从 2.0.0 / 2.0.1 直接覆盖安装即可，原有设置全部保留。
macOS 用户请注意：仅提供 Apple Silicon（arm64）版本，Intel 芯片的 Mac 无法使用。
Full Changelog: v2.0.0...v2.0.2
Contributors
Assets 6
2.0.0
新增了工具栏，交互模式有了较大的变化，故升级版本到 2.0。但原有快捷键模式依然保留，且新增的工具栏也支持通过配置关闭。
变更项：
- 新增工具栏，通过鼠标操作（甚至只需要移动鼠标，不需要点击），可规避按键检测 @BigDevil82
- 增加可以 选择 音频的输入和输出 配置项 @liuche20083736
- 新增「能力测评」提示词场景 @renyumeng1
Full Changelog: v1.8.0...v2.0.0
