OpenCluely

面试难题隐形外挂，AI 实时助攻，截图即答

OpenCluely 是一个免费开源的 Cluely 替代品，专为技术面试（如 DSA、在线测评 OA、竞赛编程 CP）设计。它通过一个隐形悬浮层提供实时 AI 辅助，支持智能图像处理快速抓取题目，并具备多语言能力。项目基于 JavaScript，强调 100% 可定制和隐私保护，用户可完全掌控数据。它解决的是面试中遇到难题时快速获取思路或答案的需求，同时避免被面试官察觉。核心能力包括：隐形覆盖层、实时 AI 响应、题目截图识别、多语言支持及本地化部署选项。作为早期项目（755 星），其功能聚焦且轻量，适合追求隐私和灵活性的开发者使用。

开源 free 办公效率

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1001

维护状态维护中

是否开源是

定价模式 free

项目数据

分类办公效率

开发团队TechyCSR

所属国家

官网地址https://opencluely.techycsr.dev

GitHubhttps://github.com/TechyCSR/OpenCluely

定价模式free

价格说明完全免费的开源项目，无付费版本，可自行部署使用。

访问状态

是否开源是

开源协议Apache-2.0

主要语言JavaScript

技术栈/模型ai-assistant,cluely,cluely-alternative,dsa,gemini,interview-helper,interview-preparation,open-source,open-source-cluely,trending,whisper

GitHub 星标★ 1001

30天Star增速

HF 下载量

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

最近更新2026-09-23 00:00:00

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

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

环境要求

Node.js 与 npm（setup.sh 会安装 Node 依赖，支持 npm install / npm ci）
Git（用于克隆仓库）
Unix 类系统并具备 bash，可执行 ./setup.sh
Python 虚拟环境（本地 Whisper 转写时由脚本自动创建 .venv-whisper）
可选：sox（麦克风支持）、ffmpeg（转写非 PCM 音频格式）

安装与启动步骤

1克隆仓库

把 OpenCluely 源码下载到本地并进入项目目录，后续脚本都在此目录执行。
```
git clone https://github.com/TechyCSR/OpenCluely.git
cd OpenCluely
```
2运行安装脚本

setup.sh 会自动安装 Node 依赖、从示例生成 .env、创建本地 Whisper 虚拟环境并启动应用。
```
./setup.sh
```
3填写 Gemini 密钥

首次启动会自动打开 Settings 窗口，粘贴 Google AI Studio 的免费密钥，或直接编辑 .env，改完无需重启。
4仅安装不启动

想先完成环境准备、稍后再启动应用时使用该选项。
```
./setup.sh --no-run
```
5安装麦克风依赖

需要语音提问却无法录音时，用该选项安装 sox 支持麦克风输入。
```
./setup.sh --install-system-deps
```
6跳过本地 Whisper

不想在本地跑离线转写、节省磁盘与安装时间时使用。
```
./setup.sh --skip-whisper
```
7构建分发包

为当前操作系统打包可分发版本，适合分享或离线分发。
```
./setup.sh --build
```

关键配置

配置项	必填	说明	示例
`.env 中的 Gemini API Key`	是	唯一必填配置项，用于实时 AI 回答	`AIzaSyxxxxxxxxxxxxxxxxxxxxxxxx`
`SPEECH_PROVIDER`	否	切换语音识别后端，设为 azure 时使用 Azure Speech	`azure`

如何确认成功

首次启动自动弹出 Settings 窗口；填入 Gemini 密钥后悬浮层与聊天面板出现，语音或截图提问能实时流式返回回答。

常见问题

Q：必须自己准备 API Key 吗？

A：是。README 说明唯一必填值就是 Gemini API Key，可在 Google AI Studio 免费获取，填入设置窗口或直接改 .env，改动无需重启。

Q：麦克风无法工作怎么办？

A：执行 ./setup.sh --install-system-deps 安装 sox 以支持麦克风输入。

Q：如何离线做语音转写？

A：./setup.sh 会自动创建 .venv-whisper、安装 openai-whisper、生成 .whisper-models 并做语音测试；转写非 PCM 格式需自行准备 ffmpeg。

Q：只想安装、暂时不启动？

A：使用 ./setup.sh --no-run 仅完成环境准备；CI 环境可改用 ./setup.sh --ci 走 npm ci。

Q：怎么换成云端语音服务？

A：在 Azure Portal 创建 Speech 资源，把 key 与 region 写入 .env，并设置 SPEECH_PROVIDER=azure。

注意事项

setup.sh 会从示例文件生成 .env，只有 Gemini API Key 是必填项。
本地 Whisper 会额外创建 .venv-whisper 与 .whisper-models 目录，占用一定磁盘空间。
--ci 使用 npm ci 替代 npm install，适合自动化环境。
应用为桌面端悬浮层，README 强调其对录屏与会议工具不可见，请自行确认使用场景合规。

核心亮点

隐形悬浮层设计，降低面试中使用的暴露风险
智能图像处理，截图/拍照即可自动识别题目并获取答案
支持多语言，适配不同地区面试场景

不足之处

早期项目，功能稳定性和兼容性待验证
文档/社区待观察

适用场景

技术面试中遇到算法题或 DSA 难题时快速获取提示
在线编程竞赛（CP）中辅助解题思路
准备 OA 在线测评时模拟练习和查漏补缺

替代项目

Cluely、Interview Coder、LeetCode 面试模拟工具

项目介绍

OpenCluely 是编程开发领域的开源项目，由 TechyCSR 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,001）位列前 30%，在编程开发分类中处于中上游。

项目仍在小幅维护中，最近一次代码更新于 2026-09-23。完全免费的开源项目，无付费版本，可自行部署使用。

它主要面向的使用场景是：技术面试中遇到算法题或DSA难题时快速获取提示。同类可对比的替代方案包括 Cluely、Interview Coder、LeetCode 面试模拟工具。

上一篇：claude-code.nvim

下一篇：autodev-vscode