shiping

按快捷键截屏，AI 立刻看懂并解答屏幕内容

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署计算机视觉 🍴 复刻 168 🐛 待处理 39 👀 关注 8

GitHub ↗

GitHub 星标 ★ 1170

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，需自行部署

项目预览

项目数据

分类计算机视觉

开发团队ooboqoo

GitHubhttps://github.com/ooboqoo/shiping

定价模式🏷️完全免费

价格说明开源免费，需自行部署

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议NOASSERTION

主要语言TypeScript

技术栈/模型ai-assistant,coding-interview,deepseek,electron,interview,interview-assistant,leetcode,llm,ocr,online-exam,screenshot,vision

GitHub 星标★ 1170

上线时间2025-08-20 00:00:00

代码更新2026-11-06

仓库体积25.3 MB

本站数据更新2026-11-07

维护状态活跃

收录时间2026-11-06

浏览次数0

项目介绍

shiping 是一款基于 Electron 与 TypeScript 开发的桌面识屏助手，常驻系统后台，用户按下快捷键即可框选屏幕任意区域，由 OCR 识别内容并交给大模型（如 DeepSeek）分析作答。它面向代码调试、报错排查、题目解答、图表解读和外文资料理解等场景，把「截图—识别—推理—回答」压缩成一步操作。除单次截屏问答外，项目还提供对话模式，可实时听取语音问题并给出回答要点，适合面试模拟、刷题练习和在线考试辅助等需要快速获取思路的场合。整体以桌面客户端形态运行，强调低打扰与随手可用，把视觉识别与大语言模型能力结合到日常学习与开发工作流中。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-11-06 · 当前星标 ★ 1170

技术标签

ai-assistant deepseek electron interview llm

使用教程

难度：入门约 10 分钟部署方式：本地安装 8 步

环境要求

Windows 系统，或 macOS 13 及以上（目前仅 Apple 芯片版本，Intel 芯片需从源码运行）
一个兼容 OpenAI API 的 AI 平台账号与 API Key（推荐 DeepSeek）
使用对话模式需另备阿里云百炼语音识别 API Key
从源码运行需先安装 Node.js

安装与启动步骤

1下载安装包

打开项目 Releases 页面，Windows 下载 setup.exe，macOS 下载 .dmg；Intel 芯片的 Mac 没有对应安装包，需改用源码运行。
2安装并首次启动

按系统常规方式安装后打开应用，首次启动会弹出 AI 配置引导；macOS 首次打开的安全提示处理方式见官方 Wiki。
3填写 AI 接口信息

在引导页填 API Base URL 与 API Key。DeepSeek 地址已默认选好，只填 Key 即可；其他兼容 OpenAI 的平台按 Wiki 对照表填写。
4分别选择模型

进入「设置 → AI 模型」可保存多套配置，再为截图模式选支持识图的模型，为对话模式选关闭思考的快模型。
5用快捷键试用

按 Ctrl+Enter 全屏截图提问（macOS 为 ⌥ Enter），Ctrl+Alt+S 框选识别；按 Esc 隐藏窗口，快捷键回到原应用。
6启用对话模式

在「设置 → 语音」填入百炼 API Key，点窗口顶部「对话」，按 Ctrl+T（macOS 为 ⌥ T）开始监听系统音频。
7从源码运行

克隆仓库后在根目录安装依赖并启动开发模式；也可执行打包命令生成对应平台安装包。
```
npm install
npm run dev
```
8预置默认配置

在项目根目录新建 .env 文件可预填 AI 平台信息，启动时作为默认值，省去首次手动填写。

关键配置

配置项	必填	说明	示例
`API Base URL`	是	AI 平台的接口地址，DeepSeek 已默认填好	`https://openrouter.ai/api/v1`
`API Key`	是	所选 AI 平台的密钥，用于调用模型	`sk-1234567890`
`API_BASE_URL`	否	源码运行时 .env 中的平台地址默认值	`https://openrouter.ai/api/v1`
`API_KEY`	否	源码运行时 .env 中的密钥默认值	`sk-1234567890`
`MODEL`	否	.env 中可选的默认模型名	`gpt-5-mini`
`自定义请求头`	否	平台需额外请求头时，在配置「高级」里每行填一个名称: 值	`api-key: your-key`

如何确认成功

按 Ctrl+Enter 截图后窗口能流式输出解答，即说明 AI 配置与快捷键均正常。

常见问题

Q：Mac 上找不到可用安装包？

A：macOS 安装包要求 13 及以上且目前仅提供 Apple 芯片版本，Intel 芯片请按 README 安装 Node.js 后从源码运行。

Q：截图后没有解答怎么办？

A：检查 API Key 是否正确、所选模型是否支持识图，可在「设置 → AI 模型」中为截图模式单独指定能识图的模型。

Q：对话模式没有提示？

A：需先在「设置 → 语音」填入百炼 API Key，切到「对话」页并按 Ctrl+T 开始监听；采集的是系统音频，自己说话不会触发。

Q：隐身模式一定能挡住录屏吗？

A：不保证。它依赖操作系统与会议软件配合，换设备、升级系统或更换共享方式都可能失效，正式使用前请按 README 方法自测。

注意事项

隐身模式默认开启，可在「设置 → 界面与隐私」关闭；菜单栏与托盘图标不在隐身范围内，也可在同一处隐藏。
AI 请求默认跟随系统代理（含 PAC），可在「设置 → 网络代理」改为自定义 HTTP/HTTPS/SOCKS5 代理或直连。
项目已由「截屏解题助手」改名为「识屏 Shiping」，旧仓库地址会自动跳转，升级后原有设置保留。
对话模式的语音识别按分钟计费（约 0.02 元/分钟），长时间开启请注意用量。

核心亮点

快捷键框选即问，截图到答案链路极短，不打断当前工作流
常驻后台随时唤起，适合高频查报错、看题目、读外文资料
集成 OCR 与大模型推理，能处理代码、图表、公式等多类屏幕内容

不足之处

依赖第三方大模型与 OCR 服务，离线或未配置密钥时能力受限
常驻后台与屏幕截取涉及隐私权限，敏感场景需谨慎使用
项目处于成长阶段，文档与长期维护稳定性有待观察

适用场景

开发时截取报错信息，快速获得排查思路与修复建议
刷题或备考时框选题目，获取解题要点与知识讲解
阅读外文资料或图表时截屏，即时得到翻译与内容解读

替代项目

Textify、Pot-Desktop、openai-translator

上一篇：DocLayout-YOLO

下一篇：没有了！