项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1177
使用教程
环境要求
- 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 面试模拟工具
上一篇:claude-code.nvim
下一篇:autodev-vscode
同类项目推荐
DSHA
开源
手机装个 APK,免 ROOT 跑 DeepSeek 编码智能体
免 ROOT 免 Termux,在手机上跑 DeepSeek Harness。完整 Ubuntu 环境 + proroot 零 ptrace···
aiac
开源
用大白话描述云资源,自动生成 Terraform 等 IaC 代码
Artificial Intelligence Infrastructure-as-Code Generator.
proxypal
开源
一份 AI 订阅,接进所有编程工具
A desktop app that lets you use your AI subscriptions (Claude, ChatGPT, Gemini, GitH···
GitBot
开源
把编码智能体封装成可复用机器人,本地批量跑仓库任务
Create reusable bots powered by Claude Code, Codex, or OpenCode. Run them locally ac···
spec-kitty
开源
给 AI 编码装上规格看板,多任务并行不打架
Spec-Driven Development with organizational governance. Specs tell AI agents what to···
LeanCopilot
开源
在 Lean 里写证明时,让 LLM 实时给下一步建议
LLMs as Copilots for Theorem Proving in Lean
SwiftUI-Agent-Skill
开源
给 AI 装上 SwiftUI 老司机经验,少写烂代码
Add expert SwiftUI Best Practices guidance to your AI coding tool (Agent Skills open···
hindsight
开源
会话结束自动复盘,只留可复用经验,让 AI 越用越少踩坑。
A self-improvement skill for AI coding assistants — reviews a session end-to-end an···
fuzz4all
开源
用大模型自动生成测试输入,发现各种软件漏洞
️Fuzz4All: Universal Fuzzing with Large Language Models
