AI 技能/插件AI 评测科研人工智能MCP 服务dsh-plugin【免费下载链接】Auto-claude-code-research-in-sleepARIS ⚔️ (Auto-Research-In-Sleep) — Lightweight Markdown-only skills for autonomous ML research: cross-model review loops, idea discovery, and experiment automation. No framework, no lock-in — works with Claude Code, Codex, OpenClaw, or any LLM agent.项目地址https://gitcode.com/gh_mirrors/au/Auto-claude-code-research-in-sleep点击查看免费下载导读本文是 ARISAuto-Research-In-Sleep仓库中 docs/CODEX_GEMINI_REVIEW_GUIDE.md 的完整实践化解读。它讲解如何在保留 Codex 作为主执行者的前提下通过本地gemini-reviewMCP 桥把外部评审者替换为 Gemini默认走 Gemini 直连 API从而实现执行器 Codex、评审者 Gemini、跨模型族独立性的 review 回路。读完本文你将掌握三层架构与安装顺序、凭据与环境变量的完整配置、review/review_reply/review_start/review_reply_start/review_status五种工具契约的调用方式、15 个评审感知技能的覆盖边界Core 8 与 Runtime 15、以及应对免费层 429 限流和长文评审超时的异步最佳实践。一、这条路径要解决什么问题ARIS 的 Codex 原生路径skills/skills-codex/本身已经支持Codex 执行 第二个 Codex 评审者的闭环。但当你希望评审者与执行者来自不同的模型家族cross-family review时就需要一条新的传输链路。本文描述的 Codex Gemini 路径定位如下Codex主执行器main executor负责读技能、发起审查、实现修复Gemini外部评审者external reviewer本地gemini-reviewMCP 桥传输层transport layerGemini 直连 API默认评审后端default reviewer backend。它在设计上是**增量additive**于上游 Codex 原生路径的并不取代skills/skills-codex/。评审者切换后overlay 技能在运行时会记录review_independence: cross-family与acceptance_status: accepted等审计字段见 skills/skills-codex-gemini-review/README.md最终是否通过仍由验证器依据各审计是否达成 accepted 保证来判定。为什么选直连 API 而不是本地 CLI指南给出了三条理由与桥的实现一一对应最大化复用原有评审感知技能桥保留了与 Claude-review overlay 相同的review*工具契约技能无需大改去除多余的本地 CLI 一跳CLI 需要额外登录、额外子进程而 API 更接近 ARIS 中其他 API 后端集成的方式更贴近 API 化集成主航道从源码看API 后端直接调用https://generativelanguage.googleapis.com/v1beta/{model}:generateContent见 mcp-servers/gemini-review/server.py整条链路是单进程内的 HTTP 请求可控性更强。二、三层架构与安装顺序2.1 三个组成部分层级仓库路径作用基础技能集skills/skills-codex/Codex 原生执行技能保持原样复用评审者覆盖层skills/skills-codex-gemini-review/只覆盖 15 个评审感知技能把评审后端指向gemini-review评审桥mcp-servers/gemini-review/本地 MCP 服务暴露review*工具契约默认对接 Gemini 直连 API安装顺序有讲究必须先装基础技能集再装覆盖层最后注册 MCP。因为覆盖层与基础包存在同名技能后安装者生效install_aris_codex.sh的selected_packages中 overlay 排在基础包之后同名技能由 overlay 覆盖见 tools/install_aris_codex.sh。2.2 安装命令指南原版手动方式克隆仓库到本地后在仓库根目录执行mkdir -p ~/.codex/skills cp -a skills/skills-codex/* ~/.codex/skills/ cp -a skills/skills-codex-gemini-review/* ~/.codex/skills/ mkdir -p ~/.codex/mcp-servers/gemini-review cp mcp-servers/gemini-review/server.py ~/.codex/mcp-servers/gemini-review/server.py cp mcp-servers/gemini-review/README.md ~/.codex/mcp-servers/gemini-review/README.md codex mcp add gemini-review --env GEMINI_REVIEW_BACKENDapi -- python3 ~/.codex/mcp-servers/gemini-review/server.pycodex mcp add命令把桥注册进 Codex 的 MCP 环境并显式传入GEMINI_REVIEW_BACKENDapi强制使用 API 后端。2.3 安装命令仓库安装器方式仓库同时提供了项目级安装器支持 overlay 参数一键安装且会维护 manifest、符号链接与 AGENTS.md 管理块bash ~/aris_repo/tools/install_aris_codex.sh ~/your-project bash ~/aris_repo/tools/install_aris_codex.sh ~/your-project --reconcile --with-gemini-review-overlay--with-gemini-review-overlay由 tools/install_aris_codex.sh 解析会额外把skills-codex-gemini-review加入待安装包列表。随后仍需手动注册 MCPmkdir -p ~/.codex/mcp-servers/gemini-review cp mcp-servers/gemini-review/server.py ~/.codex/mcp-servers/gemini-review/server.py codex mcp add gemini-review --env GEMINI_REVIEW_BACKENDapi -- python3 ~/.codex/mcp-servers/gemini-review/server.py2.4 凭据文件推荐方式桥会自动加载~/.gemini/.env若存在。推荐按如下方式创建权限收紧到仅本人可读mkdir -p ~/.gemini cat ~/.gemini/.env EOF GEMINI_API_KEYyour-key EOF chmod 600 ~/.gemini/.envchmod 600不是可选项从源码看load_private_env_file/read_private_env_lines见 server.py对.env文件有严格的预检——文件是符号链接、非普通文件、非当前用户所有、或 group/world 可写mode 含0o022位都会被整体忽略避免弱权限凭据被滥用。该函数只从.env提取GEMINI_API_KEY与GOOGLE_API_KEY两个键且仅当环境变量尚未设置时写入进程环境。三、环境变量全景从默认值到后端选择桥的所有行为都通过环境变量控制默认值集中在 server.py 顶部。下表汇总自 mcp-servers/gemini-review/README.md 与源码变量默认值说明GEMINI_REVIEW_BACKENDapi评审后端api/auto/cli/agyGEMINI_REVIEW_MODEL空评审模型覆盖api/cli后端生效GEMINI_REVIEW_API_MODELgemini-2.5-flashGEMINI_REVIEW_MODEL未设置时 API 后端的默认模型GEMINI_API_KEY/GOOGLE_API_KEY—API 密钥二选一即可GEMINI_REVIEW_SYSTEM空可选的默认系统提示词GEMINI_REVIEW_TIMEOUT_SEC600HTTP / 子进程超时秒GEMINI_REVIEW_MAX_STATUS_WAIT_SECONDS30review_status单次最长阻塞等待秒GEMINI_REVIEW_STATE_DIR~/.codex/state/gemini-review桥状态目录threads / jobs / 日志GEMINI_REVIEW_DEBUG_LOG~/.codex/state/gemini-review/debug.log调试日志路径必须落在 STATE_DIR 下GEMINI_REVIEW_WORKSPACE_ROOT进程当前工作目录本地imagePaths的根目录约束GEMINI_BIN/AGY_BINgemini/agyCLI 回退后端的可执行文件路径GEMINI_REVIEW_AGY_*见 READMEAntigravity CLI 回退专用打印超时、数据目录、产物字符上限等3.1 后端选择逻辑源码级resolve_backendserver.py决定实际后端api默认必须有GEMINI_API_KEY或GOOGLE_API_KEY否则调用失败并给出明确错误auto有 API 密钥走 API否则回退到 Gemini CLI永远不会自动选 Antigravitycli走 Gemini CLI 子进程需要单独安装gemini并完成登录agy走 Antigravity CLI需要显式指定才启用。模型选择采用优先级链model 参数 GEMINI_REVIEW_MODEL GEMINI_REVIEW_API_MODELserver.py。另外桥对模型名有家族校验require_gemini_model只接受gemini-*前缀或models/gemini-*、publishers/google/models/gemini-*的模型名防止非 Gemini 模型混入评审路径server.py。3.2 API 请求细节API 后端run_gemini_api_reviewserver.py的请求体结构contents历史对话user/model 交替加当前 user promptgenerationConfig.temperature 0.2评审任务偏确定性的低温度systemInstruction当显式传入 system 或设置了GEMINI_REVIEW_SYSTEM时携带模型路径规范化gemini-2.5-flash→models/gemini-2.5-flashpublishers/...开头则原样使用gemini_api_model_path密钥通过x-goog-api-key请求头传递走官方generativelanguage.googleapis.com。四、MCP 工具契约同步与异步五件套桥对外暴露五个工具tools/list定义见 server.py与既有 Claude-review overlay 的契约完全一致工具类型用途必需参数review同步发起一次全新评审返回threadIdresponsepromptreview_reply同步基于既有threadId续接评审会话promptthreadIdreview_start异步后台启动评审任务立即返回可恢复的jobIdpromptreview_reply_start异步后台启动既有线程的续评立即返回jobIdpromptthreadIdreview_status异步查询轮询任务状态并取回最终结果jobId同步工具返回的 JSON 包含threadId与response异步 start 工具返回jobIdstatus之后由review_status取回最终threadId、response、model、backend、stop_reasonagy 后端还会带model_provenance/requested_model/warning。此外所有工具都接受可选的model、system、backend参数以及imagePaths/image_paths仅 API 后端支持的多模态本地图片PNG/JPG/WebP。4.1 同步评审示例{ name: review, arguments: { prompt: Review this paper draft for clarity and contribution... } }返回节选{ threadId: 3f9c..., response: …评审正文…, model: gemini-2.5-flash, backend: api }4.2 异步评审与状态恢复示例启动长评审{ name: review_start, arguments: { prompt: Review this paper draft... } }立即返回{ jobId: 5d8d0a9c5a2f4f42ae44f6f0c2d73f6f, status: queued, done: false }稍后轮询{ name: review_status, arguments: { jobId: 5d8d0a9c5a2f4f42ae44f6f0c2d73f6f, waitSeconds: 20 } }多模态海报评审poster PNG{ name: review_start, arguments: { prompt: Review this poster PNG for readability and clipping., imagePaths: [poster/poster_v1.png] } }4.3 状态持久化与可恢复性源码级这是桥最关键的工程细节之一threadId是桥本地会话 ID默认持久化于~/.codex/state/gemini-review/threads/server.py可传给review_reply续接多轮对话jobId是后台任务 ID默认存于~/.codex/state/gemini-review/jobs/review_status可在MCP server 重启之后继续查询——状态落盘不是内存态状态文件包含评审 prompt/response因此异步任务与线程均可恢复状态、线程、任务、调试日志等目录尽量以属主私有权限0o700/0o600创建review_status的waitSeconds被钳制在0 ~ GEMINI_REVIEW_MAX_STATUS_WAIT_SECONDS默认 30 秒之间超限直接报错。注意状态文件里存有评审内容涉及敏感材料时不需要可恢复性即可删除GEMINI_REVIEW_STATE_DIRREADME 明确建议如需覆盖该目录选私有目录而不要用共享的/tmp。4.4 安全边界从源码结构看桥对路径与文件做了多重防护属于评审桥这一信任边界的加固所有threadId/jobId/conversationId都经normalize_safe_id校验仅允许^[0-9A-Za-z_-]$且不超过 128 字符从源头杜绝路径穿越server.py图片路径必须解析在GEMINI_REVIEW_WORKSPACE_ROOT之下打开文件时使用O_NOFOLLOW打开后还会通过/proc/self/fd复验实际路径无法复验的平台直接 fail closedopen_confined_read_fdCLI /agy回退后端不支持图片传入imagePaths会直接报错提示改用api后端调试日志会脱敏prompt、system、content、text、history、imagePaths等键在写日志前被替换为[redacted]redact_for_debug。五、访问说明与限流现实Google AI Studio / Gemini API 在符合条件的国家/地区提供免费层不需要 Gemini Advanced / Google One AI Premium 订阅免费层的模型可用性与速率限制会随时间变化任何单一配额数字或旧模型示例都不应被视为永久事实免费层下prompt 与响应可能被用于改进 Google 产品——不要把本路径定位为适合敏感数据的方案除非用户已核对当前官方条款。指南原文给出的官方入口AI Studio API key 与 Gemini API 定价页请以最新官方页面为准。六、可选 CLI 回退直连 API 是主路径。如果你明确需要 Gemini CLI 作为回退codex mcp remove gemini-review codex mcp add gemini-review --env GEMINI_REVIEW_BACKENDcli -- python3 ~/.codex/mcp-servers/gemini-review/server.py注意CLI 回退可用但不是本指南的主路径。从源码看CLI 后端以gemini -p prompt --output-format json形式调用server.py并解析 stdout 中最后一段 JSON 的response字段。另外还有更偏门的agyAntigravity CLI后端它通过agy --print路由评审且对 ARIS 的跨模型不变量采取fail-closed策略——桥无法按调用选择 Antigravity 模型因此每次调用后必须从本次调用的日志/transcript 中恢复出实际的 Gemini 家族模型 ID 作为model返回若请求携带了model参数则会附上requested_model与warning若 Antigravity 把请求路由到了非 Gemini 模型或日志中拿不到模型 ID调用直接失败而不是返回无法审计的占位符详见 mcp-servers/gemini-review/README.md。七、验证从注册到真实跑通7.1 三步验证清单# 1. 检查 MCP 注册 codex mcp list # 2. 检查 Gemini API key 文件存在 test -f ~/.gemini/.env echo Gemini env file found # 3. 在你的项目里启动 Codex codex -C /path/to/your/project7.2 故障排查免费层 429 限流如果默认 API 模型在当前窗口内返回临时的免费层429保持同一个桥不变仅覆盖评审模型即可codex mcp remove gemini-review codex mcp add gemini-review --env GEMINI_REVIEW_BACKENDapi --env GEMINI_REVIEW_MODELgemini-flash-latest -- python3 ~/.codex/mcp-servers/gemini-review/server.py这一步不改变 ARIS 评审契约或技能 overlay 的形状只是把同一本地桥背后的 Gemini API 模型换成gemini-flash-latest。7.3 两层验证总结指南原文覆盖层全覆盖检查skills/skills-codex-gemini-review/中全部 15 个预定义评审感知 Codex 技能都确认指向gemini-review不再依赖旧评审传输运行时桥检查用review、review_reply、review_start、review_reply_start、review_status以及imagePaths多模态本地图片评审实际跑通代表性 Codex 侧冒烟测试在私有、非公开的研究仓库上运行 overlay确认真实 Codex 执行能在研究评审、idea 生成、paper-planning 风格的工作流中进入 Gemini 评审路径。7.4 实测观察指南原文结论直连 API 评审返回了有效的评审文本异步评审任务可完成并能通过review_status恢复多轮续评follow-up依赖持久化线程状态正常工作本地图片评审经imagePaths正常工作Gemini 免费层对该评审路径可用但突发密集测试仍会触发临时429限流行为与模型相关应通过 AI Studio /ListModels查看当前 API 模型面而不是套用旧配额表同一套配置下用GEMINI_REVIEW_MODELgemini-flash-latest重试同步评审、异步review_start→review_status、带线程的review_reply_start→review_status均成功这些429表现为短窗口突发限流而非集成本身损坏长同步评审调用仍可能撞上宿主侧 MCP 工具超时实测约 120 秒因此异步review_start/review_reply_startreview_status流程是长 prompt 的推荐默认路径。这也正是桥同时提供同步与异步工具、而评审感知技能 overlay 对长评审优先走异步路径的原因。八、覆盖范围被替换的 15 个技能overlay 替换的预定义评审感知 Codex 技能完整列表如下目录见 skills/skills-codex-gemini-review/idea-creatoridea-discoveryidea-discovery-robotresearch-reviewnovelty-checkresearch-refineauto-review-loopgrant-proposalpaper-planpaper-figurepaper-poster-htmlpaper-slidespaper-writepaper-writingauto-paper-improvement-loop其余技能仍来自上游skills/skills-codex/包不做任何替换——这是薄覆盖层设计的核心。8.1 Core 8 与 Runtime 15描述本路径的覆盖范围有两种同样正确的口径Core 8与既有 Claude-review 路径一一对应的评审 overlay 核心集Runtime 15当前已安装技能集中被路由到 Gemini 的完整评审感知技能面。Core 8与 Claude-review overlay 结构、评审契约最直接对应的技能research-reviewnovelty-checkresearch-refineauto-review-looppaper-planpaper-figurepaper-writeauto-paper-improvement-loop额外 7 个被路由到 Gemini 的评审感知技能idea-creatoridea-discoveryidea-discovery-robotgrant-proposalpaper-writingpaper-slidespaper-poster-html实用结论核心机制仍与 Claude 路线保持相同的 8 技能 overlay 模式当前运行时评审面更宽总计 15 个技能这正是 diff 更大、但底层评审契约形状不变的原因。8.2 直接消费者与包装器12 3在这 15 个技能内部存在两类12 个直接消费者——自己调用mcp__gemini-review__review_start/review_reply_start/review_statusresearch-review、novelty-check、research-refine、auto-review-loop、paper-plan、paper-figure、paper-write、auto-paper-improvement-loop、idea-creator、grant-proposal、paper-slides、paper-poster-html3 个包装器——主要编排下游评审感知子技能并透传REVIEWER_MODELgemini-reviewidea-discovery、idea-discovery-robot、paper-writing这个分类直接影响验证策略你不需要完整跑完全部 15 个工作流来验证评审传输。结构检查 桥运行时检查 代表性直接消费者/包装器冒烟测试的组合足以验证 PR 级集成逻辑。以auto-review-loop为例见 skills/skills-codex-gemini-review/auto-review-loop/SKILL.mdREVIEWER_MODEL gemini-review即通过本地gemini-reviewMCP 桥调用 Gemini第 1 轮用review_start提交完整研究上下文保存返回的jobId用带waitSeconds的review_status轮询到donetrue并保存完成的threadId第 2 轮起改用review_reply_start 保存的threadId维持对话连续性停止条件为score 6/10且verdict ∈ {ready, almost}not ready 不通过达到 MAX_ROUNDS4也终止每轮结束把原始评审文本原样存档到review-stage/AUTO_REVIEW.md并把round、thread_id、last_score、pending_experiments等写入review-stage/REVIEW_STATE.json用于上下文压缩后的状态恢复。九、异步评审流程长评审的推荐操作路径对于长论文或长项目评审使用review_startreview_reply_startreview_status为什么即使在直连 API 路径上长同步评审调用仍可能撞上宿主侧 MCP 工具超时。异步review*流程让原始评审感知技能在不改变行为的前提下继续可用。9.1 同步 vs 异步的选择标准来自桥 README 的明确建议短 prompt能在宿主 MCP 工具超时内舒适完成用review/review_reply长论文或项目评审用review_start/review_reply_startreview_status避开约 120 秒的Codex - tools/call超时。9.2 异步实现机制源码级start_async_reviewserver.py的流程生成jobIduuid4().hex把请求prompt、threadId、model、system、backend、imagePaths写入jobs/jobId.json状态queued以python3 server.py --run-job jobId派生独立子进程start_new_sessionTrue父进程立即返回jobIdstatus: queuedrun_async_jobserver.py把状态置为running执行评审最终写回completed/failed及结果get_review_statusserver.py读落盘任务若 worker 进程已消失但状态仍非终态会修正为failedwaitSeconds内会以 0.5 秒粒度轮询。由于任务与线程都落盘在~/.codex/state/gemini-review/下即使 MCP server 重启review_status也能恢复未完成任务。十、项目配置与维护边界10.1 项目配置零侵入本路径不需要任何特殊项目配置文件继续使用你现有的CLAUDE.md保持当前项目布局不变只需切换已安装的 Codex 技能文件与 MCP 注册。10.2 维护原则刻意收窄保持这条路径刻意地窄原样复用skills/skills-codex/*不做修改只在skills/skills-codex-gemini-review/*中覆盖评审感知技能让mcp-servers/gemini-review/server.py聚焦于review*兼容契约不膨胀职责技能需要 poster PNG 评审时通过直连 Gemini API 后端透传本地imagePaths而不是另造第二个桥。关于最后一点桥的实现也印证了约束imagePaths仅由直连 API 后端支持CLI 与agy后端保持纯文本server.py多模态评审的职责被收敛在唯一受控的 API 路径上。十一、总结ARIS 的 Codex Gemini 评审路径用一套薄覆盖层 窄契约桥的架构把跨模型评审独立性落到了可安装、可验证、可恢复的工程实现上安装顺序三要素基础技能 → Gemini overlay → MCP 注册、五件套review*工具契约、12 个直接消费者与 3 个包装器的技能面以及同步短评、异步长评的操作纪律。对长期使用该路径的团队最有价值的三个实操要点是用~/.gemini/.env承载密钥并保持600权限、用GEMINI_REVIEW_MODELgemini-flash-latest应对免费层 429、长评审一律走review_start/review_reply_startreview_status异步链路。赞分享AI 技能/插件AI 评测科研人工智能MCP 服务dsh-plugin【免费下载链接】Auto-claude-code-research-in-sleepARIS ⚔️ (Auto-Research-In-Sleep) — Lightweight Markdown-only skills for autonomous ML research: cross-model review loops, idea discovery, and experiment automation. No framework, no lock-in — works with Claude Code, Codex, OpenClaw, or any LLM agent.项目地址https://gitcode.com/gh_mirrors/au/Auto-claude-code-research-in-sleep点击查看免费下载相关推荐ClickHouse 代码评审实战指南基于 review Skill 的 PR 审查方法论与严重度模型ClickHouse 代码评审实战指南基于 review Skill 的 PR 审查方法论与严重度模型 本文系统讲解 ClickHouse 仓库中内置的 re数据库OLAP列式数据库大数据实时分析数据分析Open Code Review Codex 插件使用指南在本地 Codex 中接入 ocr 代码审查 CLIOpen Code Review Codex 插件使用指南在本地 Codex 中接入 ocr 代码审查 CLI Open Code ReviewOCR是阿人工智能AI 应用代码评审开发工具代码质量SGLang Cookbook 的配置驱动架构与 PR 评审检查清单cookbook-review-pr 实战指南SGLang Cookbook 的配置驱动架构与 PR 评审检查清单cookbook review pr 实战指南 SGLang Cookbook仓库内即人工智能大模型模型推理服务推理引擎本地部署LLM 网关多模态强化学习上一篇GeoQ工作单元管理如何高效分配和追踪地理任务进度下一篇3分钟批量删除十万Redis键AnotherRedisDesktopManager自动化脚本实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考