#Geekit++

Geekit++ 是 Codex 桌面端的本地增强与管理应用。它提供 Geekit Provider 切换、会话管理、上下文窗口配置、页面增强、用户脚本和版本维护，不替代 Codex，也不改写 Codex 原始安装文件。

核验日期：2026-08-05

#1. 准备 Geekit 连接参数

先在 API Keys 页面生成令牌，再从模型广场确认当前可用的 Responses 模型。配置时使用：

不要把真实令牌写入文档、Issue、截图或 Git 仓库。

#2. 安装前检查

1. 安装并至少启动一次 Codex 桌面端。
2. 确认系统能正常打开 Codex，并已完成系统要求的 WebView 或运行库更新。
3. 关闭正在运行的 Geekit++ 安装程序和旧版本管理工具。

#3. 获取 Geekit++

项目主页为 yirenyiqi/geekit-plus-plus。正式发行后，从 Releases下载与系统匹配的文件：

• Windows x64：GeekitPlusPlus-<版本>-windows-x64-setup.exe。
• macOS Apple Silicon：名称包含 macos-arm64 的 DMG。
• macOS Intel：名称包含 macos-x64 的 DMG。

仓库尚未发布对应版本时，不要从第三方网盘下载安装包。开发者可以克隆源码，在安装 Node.js 20+、Rust stable 和 Tauri 2 系统依赖后执行：

cd apps/geekit-plus-manager
npm install
npm run check
npm test
npm run build

#4. 配置 Geekit Provider

1. 打开“Geekit++ 管理工具”。
2. 进入 Provider 管理，选择聚合/中转分类中的 Geekit 预设。
3. 确认 Base URL 为 https://geekit.yryq.top/v1，协议为 Responses。
4. 填入自己的 Geekit API Key，并选择账户当前可用模型。
5. 保存 Provider，完成连接测试后再切换为当前 Provider。

Geekit++ 的 Provider 预设只负责填写公开地址与协议，不包含任何用户令牌。真实令牌只应在本机配置时输入。

#5. 启动与验证

从 Geekit++ 启动 Codex，然后执行一个最小只读任务：

读取当前目录的 README，只概括项目用途，不修改文件。

同时核对：

1. Codex 可以收到完整或流式响应。
2. Geekit 调用日志出现 /v1/responses 请求。
3. 日志中的模型、Token 和状态符合预期。
4. 工具调用需授权时，Codex 正常显示确认界面。

只有文本响应成功、工具调用失败时，优先确认所选模型是否完整支持 Responses 工具调用。

#常见问题

#找不到 Codex

先单独启动一次 Codex，再回到 Geekit++ 执行应用探测。便携版或非标准安装位置可以在入口管理中手动选择应用路径并保存。

#返回 401

重新生成或复制 Geekit API Key，确认没有多余空格。不要把令牌打印到终端或诊断日志中。

#返回 404

Base URL 应为 https://geekit.yryq.top/v1，不要填写完整的 /v1/responses 端点，也不要形成 /v1/v1。

#切回官方登录

在 Provider 管理中选择官方登录模式。切换前先保存当前工作，并确认是否需要修复历史会话的 Provider 显示。

#官方资料

• Geekit++ 项目主页
• Geekit 控制台
• Codex 桌面端文档