[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-gmickel--gmickel-claude-marketplace":3,"tool-gmickel--gmickel-claude-marketplace":62},[4,18,26,36,46,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",159636,2,"2026-04-17T23:33:34",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":78,"owner_email":79,"owner_twitter":73,"owner_website":80,"owner_url":81,"languages":82,"stars":95,"forks":96,"last_commit_at":97,"license":98,"difficulty_score":32,"env_os":99,"env_gpu":100,"env_ram":101,"env_deps":102,"category_tags":112,"github_topics":113,"view_count":32,"oss_zip_url":79,"oss_zip_packed_at":79,"status":17,"created_at":131,"updated_at":132,"faqs":133,"releases":163},8693,"gmickel\u002Fgmickel-claude-marketplace","gmickel-claude-marketplace","Plan-first AI workflow plugin for Claude Code, OpenAI Codex, and Factory Droid. Zero-dep task tracking, worker subagents, Ralph autonomous mode, cross-model reviews.","flow-next 是一款专为 AI 编程助手（如 Claude Code、OpenAI Codex 和 Factory Droid）设计的“规划优先”工作流插件。它旨在解决大型代码任务中常见的上下文丢失、需求遗忘及模型幻觉等痛点，让 AI 代理能更稳健地执行复杂开发任务。\n\n传统 AI 编程常因上下文窗口限制而“记不住”前期设定，或在遇到阻碍时陷入无限重试。flow-next 通过引入零外部依赖的任务追踪系统，将任务依赖图、执行证据和状态管理完全本地化存储在代码仓库中。其核心亮点包括：在每项任务前自动“重新锚定”以刷新上下文；利用子代理（Worker Subagents）隔离执行环境；支持跨模型审查机制，让不同 AI 互相校验代码与计划；以及独特的\"Ralph\"自主模式，可夜间自动运行并在任务卡顿时智能跳过，确保持续推进。\n\n这款工具非常适合需要处理复杂功能开发、重构或长期维护项目的软件开发者。对于希望提升 AI 编码可靠性、减少人工干预并实现自动化闭环工作流的工程师而言，flow-next 提供了一个轻量级且强大的解决方案，无需配置全局环境，卸载只需删除文件夹即可。","\u003Cdiv align=\"center\">\n\n# Flow-Next\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](LICENSE)\n[![Flow-next](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FFlow--next-v0.29.4-green)](plugins\u002Fflow-next\u002F)\n[![Docs](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocs-📖-informational)](plugins\u002Fflow-next\u002FREADME.md)\n\n[![Author](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FAuthor-Gordon_Mickel-orange)](https:\u002F\u002Fmickel.tech)\n[![Twitter](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F@gmickel-black?logo=x)](https:\u002F\u002Ftwitter.com\u002Fgmickel)\n[![Sponsor](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSponsor-❤-ea4aaa)](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fgmickel)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join-5865F2?logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002Ff3DYq8AAm5)\n\n**Plan-first AI workflow. Zero external dependencies.**\n\n\u003C\u002Fdiv>\n\n> 💬 **[Join the Discord](https:\u002F\u002Fdiscord.gg\u002Ff3DYq8AAm5)** — discussions, updates, feature requests, bug reports\n\n---\n\n## What Is This?\n\nFlow-Next is an AI agent orchestration plugin. Bundled task tracking, dependency graphs, re-anchoring, and cross-model reviews. Everything lives in your repo — no external services, no global config. Uninstall: delete `.flow\u002F`.\n\nWorks on **Claude Code**, **OpenAI Codex** (CLI + Desktop), **Factory Droid**, and **OpenCode**.\n\n---\n\n## Install\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Claude Code\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>OpenAI Codex\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Factory Droid\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\n\n```bash\n\u002Fplugin marketplace add \\\n  https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\n\u002Fplugin install flow-next\n\u002Fflow-next:setup\n```\n\n\u003C\u002Ftd>\n\u003Ctd>\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next.git\ncd flow-next && codex\n# \u002Fplugins → install Flow-Next\n# then: $flow-next-setup\n```\n\n\u003C\u002Ftd>\n\u003Ctd>\n\n```bash\ndroid plugin marketplace add \\\n  https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\n# \u002Fplugins → install flow-next\n```\n\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n**Update Codex:** `cd flow-next && git pull`, then `\u002Fplugins` → uninstall → install.\n\n📖 **[Full docs](plugins\u002Fflow-next\u002FREADME.md)** · **[Codex install guide](plugins\u002Fflow-next\u002FREADME.md#openai-codex)** · **[OpenCode port](https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next-opencode)**\n\n---\n\n## Why It Works\n\n| Problem | Solution |\n|---------|----------|\n| Context drift | **Re-anchoring** before every task — re-reads specs + git state |\n| Context window limits | **Fresh context per task** — worker subagent starts clean |\n| Single-model blind spots | **Cross-model reviews** — RepoPrompt or Codex as second opinion |\n| Forgotten requirements | **Dependency graphs** — tasks declare blockers, run in order |\n| \"It worked on my machine\" | **Evidence recording** — commits, tests, PRs tracked per task |\n| Infinite retry loops | **Auto-block stuck tasks** — fails after N attempts, moves on |\n| Duplicate implementations | **Pre-implementation search** — worker checks for similar code before writing new |\n\n---\n\n## Commands\n\n| Command | What It Does |\n|---------|--------------|\n| `\u002Fflow-next:plan` | Research codebase, create epic + tasks |\n| `\u002Fflow-next:work` | Execute tasks with re-anchoring |\n| `\u002Fflow-next:interview` | Deep spec refinement (40+ questions) |\n| `\u002Fflow-next:impl-review` | Cross-model implementation review |\n| `\u002Fflow-next:plan-review` | Cross-model plan review |\n| `\u002Fflow-next:epic-review` | Epic-completion review gate |\n| `\u002Fflow-next:prime` | Assess codebase agent-readiness |\n| `\u002Fflow-next:ralph-init` | Scaffold autonomous loop |\n\n---\n\n## Ralph (Autonomous Mode)\n\nRun overnight. Fresh context per iteration + multi-model review gates + auto-block stuck tasks.\n\n```bash\n\u002Fflow-next:ralph-init           # One-time setup\nscripts\u002Fralph\u002Fralph.sh          # Run from terminal\n```\n\n📖 **[Ralph deep dive](plugins\u002Fflow-next\u002Fdocs\u002Fralph.md)** · **[Ralph TUI](flow-next-tui\u002F)** (`bun add -g @gmickel\u002Fflow-next-tui`)\n\n---\n\n## Ecosystem\n\n| Project | Platform |\n|---------|----------|\n| [flow-next-opencode](https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next-opencode) | OpenCode |\n| [FlowFactory](https:\u002F\u002Fgithub.com\u002FGitmaxd\u002Fflowfactory) | Factory.ai Droid |\n\n---\n\n## Also Check Out\n\n> **[GNO](https:\u002F\u002Fgno.sh)** — Local hybrid search for your notes, docs, and code. Give Claude Code long-term memory over your files via MCP.\n>\n> ```bash\n> bun install -g @gmickel\u002Fgno && gno mcp install --target claude-code\n> ```\n\n---\n\n\u003Cdiv align=\"center\">\n\nMade by [Gordon Mickel](https:\u002F\u002Fmickel.tech) · [@gmickel](https:\u002F\u002Ftwitter.com\u002Fgmickel) · [gordon@mickel.tech](mailto:gordon@mickel.tech)\n\n[![Sponsor](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSponsor_this_project-❤-ea4aaa?style=for-the-badge)](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fgmickel)\n\n\u003C\u002Fdiv>\n","\u003Cdiv align=\"center\">\n\n# Flow-Next\n\n[![许可证：MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](LICENSE)\n[![Flow-next](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FFlow--next-v0.29.4-green)](plugins\u002Fflow-next\u002F)\n[![文档](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocs-📖-informational)](plugins\u002Fflow-next\u002FREADME.md)\n\n[![作者](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FAuthor-Gordon_Mickel-orange)](https:\u002F\u002Fmickel.tech)\n[![Twitter](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F@gmickel-black?logo=x)](https:\u002F\u002Ftwitter.com\u002Fgmickel)\n[![赞助](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSponsor-❤-ea4aaa)](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fgmickel)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join-5865F2?logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002Ff3DYq8AAm5)\n\n**以规划为先的AI工作流。零外部依赖。**\n\n\u003C\u002Fdiv>\n\n> 💬 **[加入Discord](https:\u002F\u002Fdiscord.gg\u002Ff3DYq8AAm5)** — 讨论、更新、功能请求、错误报告\n\n---\n\n## 这是什么？\n\nFlow-Next 是一个 AI 代理编排插件。它集成了任务跟踪、依赖图、重新锚定以及跨模型评审等功能。所有内容都存储在您的代码库中——无需外部服务，也无需全局配置。卸载时只需删除 `.flow\u002F` 目录即可。\n\n适用于 **Claude Code**、**OpenAI Codex**（CLI + 桌面版）、**Factory Droid** 和 **OpenCode**。\n\n---\n\n## 安装\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Claude Code\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>OpenAI Codex\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Factory Droid\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\n\n```bash\n\u002Fplugin marketplace add \\\n  https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\n\u002Fplugin install flow-next\n\u002Fflow-next:setup\n```\n\n\u003C\u002Ftd>\n\u003Ctd>\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next.git\ncd flow-next && codex\n# \u002Fplugins → 安装 Flow-Next\n# 然后：$flow-next-setup\n```\n\n\u003C\u002Ftd>\n\u003Ctd>\n\n```bash\ndroid plugin marketplace add \\\n  https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\n# \u002Fplugins → 安装 flow-next\n```\n\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n**更新 Codex：** `cd flow-next && git pull`，然后通过 `\u002Fplugins` 卸载再重新安装。\n\n📖 **[完整文档](plugins\u002Fflow-next\u002FREADME.md)** · **[Codex 安装指南](plugins\u002Fflow-next\u002FREADME.md#openai-codex)** · **[OpenCode 移植版](https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next-opencode)**\n\n---\n\n## 为什么它有效？\n\n| 问题 | 解决方案 |\n|---------|----------|\n| 上下文漂移 | **重新锚定**——每次执行任务前都会重新读取需求文档和当前 Git 状态 |\n| 上下文窗口限制 | **每个任务独立上下文**——子代理从干净状态开始处理任务 |\n| 单一模型盲点 | **跨模型评审**——使用 RepoPrompt 或 Codex 提供第二意见 |\n| 遗忘需求 | **依赖图**——任务会声明阻塞项，并按顺序执行 |\n| “在我机器上能运行” | **证据记录**——为每个任务追踪提交、测试和 PR |\n| 无限重试循环 | **自动阻止卡住的任务**——尝试 N 次后失败并跳过该任务 |\n| 重复实现 | **实施前搜索**——在编写新代码之前，检查是否存在相似代码 |\n\n---\n\n## 命令\n\n| 命令 | 功能 |\n|---------|--------------|\n| `\u002Fflow-next:plan` | 研究代码库，创建史诗级任务和子任务 |\n| `\u002Fflow-next:work` | 执行任务，每次执行前进行重新锚定 |\n| `\u002Fflow-next:interview` | 深度细化需求文档（40+ 个问题） |\n| `\u002Fflow-next:impl-review` | 跨模型实现评审 |\n| `\u002Fflow-next:plan-review` | 跨模型计划评审 |\n| `\u002Fflow-next:epic-review` | 史诗级任务完成评审关口 |\n| `\u002Fflow-next:prime` | 评估代码库对 AI 代理的准备程度 |\n| `\u002Fflow-next:ralph-init` | 搭建自主循环框架 |\n\n---\n\n## Ralph（自主模式）\n\n可夜间运行。每次迭代都有全新上下文，配备多模型评审关卡，并能自动阻止卡住的任务。\n\n```bash\n\u002Fflow-next:ralph-init           # 一次性设置\nscripts\u002Fralph\u002Fralph.sh          # 从终端运行\n```\n\n📖 **[Ralph 深度解析](plugins\u002Fflow-next\u002Fdocs\u002Fralph.md)** · **[Ralph TUI](flow-next-tui\u002F)** (`bun add -g @gmickel\u002Fflow-next-tui`)\n\n---\n\n## 生态系统\n\n| 项目 | 平台 |\n|---------|----------|\n| [flow-next-opencode](https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next-opencode) | OpenCode |\n| [FlowFactory](https:\u002F\u002Fgithub.com\u002FGitmaxd\u002Fflowfactory) | Factory.ai Droid |\n\n---\n\n## 更多推荐\n\n> **[GNO](https:\u002F\u002Fgno.sh)** — 本地混合搜索工具，用于查找您的笔记、文档和代码。通过 MCP 为 Claude Code 提供针对您文件的长期记忆。\n>\n> ```bash\n> bun install -g @gmickel\u002Fgno && gno mcp install --target claude-code\n> ```\n\n---\n\n\u003Cdiv align=\"center\">\n\n由 [Gordon Mickel](https:\u002F\u002Fmickel.tech) 制作 · [@gmickel](https:\u002F\u002Ftwitter.com\u002Fgmickel) · [gordon@mickel.tech](mailto:gordon@mickel.tech)\n\n[![赞助](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSponsor_this_project-❤-ea4aaa?style=for-the-badge)](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fgmickel)\n\n\u003C\u002Fdiv>","# Flow-Next 快速上手指南\n\nFlow-Next 是一款“规划优先”的 AI 工作流编排插件，专为 Claude Code、OpenAI Codex、Factory Droid 等工具设计。它通过任务追踪、依赖图谱和跨模型审查机制，确保 AI 在本地仓库中高效运行，无需任何外部服务或全局配置。\n\n## 环境准备\n\n*   **操作系统**：Linux, macOS, 或 Windows (WSL)\n*   **核心依赖**：需已安装并配置好以下任一 AI 编程工具：\n    *   Claude Code\n    *   OpenAI Codex (CLI 或 Desktop 版)\n    *   Factory Droid\n*   **网络要求**：需能访问 GitHub 以拉取插件源码（如遇网络问题，请自行配置代理或使用国内镜像加速 Git 操作）。\n*   **存储**：插件数据将直接存储在项目根目录的 `.flow\u002F` 文件夹中，卸载只需删除该文件夹。\n\n## 安装步骤\n\n根据你的开发环境选择对应的安装方式：\n\n### 1. Claude Code 用户\n\n在终端中依次执行以下命令：\n\n```bash\n\u002Fplugin marketplace add \\\n  https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\n\u002Fplugin install flow-next\n\u002Fflow-next:setup\n```\n\n### 2. OpenAI Codex 用户\n\n先克隆仓库并进入目录，然后在 Codex 交互界面中安装：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next.git\ncd flow-next && codex\n# 进入交互界面后执行：\n# \u002Fplugins → 选择 install Flow-Next\n# 初始化时运行：$flow-next-setup\n```\n\n> **更新提示**：若需更新，请在目录下执行 `git pull`，然后在 `\u002Fplugins` 中先卸载再重新安装。\n\n### 3. Factory Droid 用户\n\n```bash\ndroid plugin marketplace add \\\n  https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\n# 进入插件菜单 (\u002Fplugins) 完成安装\n```\n\n## 基本使用\n\n安装完成后，即可在项目中使用以下核心命令启动工作流：\n\n### 1. 制定计划\n让 AI 研究代码库并生成史诗（Epic）及具体任务列表：\n```bash\n\u002Fflow-next:plan\n```\n\n### 2. 执行任务\n开始执行任务，系统会自动进行上下文重锚定（Re-anchoring），确保每次任务都基于最新的代码状态和规范：\n```bash\n\u002Fflow-next:work\n```\n\n### 3. 深度需求梳理（可选）\n如果需要更细致的规格说明，可启动访谈模式（包含 40+ 个引导问题）：\n```bash\n\u002Fflow-next:interview\n```\n\n### 4. 自动化运行（Ralph 模式）\n适合夜间无人值守运行，具备自动阻塞卡死任务和多重审查机制：\n\n**第一步：初始化**\n```bash\n\u002Fflow-next:ralph-init\n```\n\n**第二步：在终端运行脚本**\n```bash\nscripts\u002Fralph\u002Fralph.sh\n```\n\n> **提示**：所有生成的任务状态、依赖关系和证据记录均保存在本地 `.flow\u002F` 目录中，随时可查。","某全栈开发者正利用 Claude Code 重构一个遗留的电商订单系统，需在三天内完成从数据库迁移到 API 适配的复杂改造。\n\n### 没有 flow-next 时\n- **上下文频繁丢失**：随着任务增多，AI 逐渐遗忘早期的架构约束，导致新生成的代码与旧模块冲突，需人工反复纠正。\n- **任务依赖混乱**：数据库迁移未完成时，AI 就尝试编写依赖新表结构的 API 逻辑，引发大量无效报错和重试循环。\n- **单一模型盲区**：仅依赖单一模型生成代码，缺乏交叉验证，隐蔽的逻辑漏洞直到测试阶段才被发现。\n- **进度难以追踪**：缺乏自动化的任务状态记录，开发者需手动整理哪些功能已实现、哪些卡住，管理成本极高。\n\n### 使用 flow-next 后\n- **智能重新锚定**：flow-next 在执行每个子任务前自动重读规格说明和 Git 状态，确保 AI 始终基于最新上下文工作，杜绝“幻觉”代码。\n- **依赖图自动编排**：通过内置依赖图明确任务阻塞关系，强制先执行数据迁移脚本，待成功后再启动 API 开发，流程井然有序。\n- **跨模型审查机制**：调用 `cross-model reviews` 功能，让不同模型互相审查实现方案，在编码阶段即可拦截潜在逻辑缺陷。\n- **零配置任务追踪**：所有任务进度、证据（如提交记录、测试结果）自动留存于 `.flow\u002F` 目录，开发者可随时查看全景状态，无需额外工具。\n\nflow-next 通过将松散的 AI 对话转化为可控的工程化工作流，让复杂重构任务从“盲目试错”转变为“自动化精准交付”。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fgmickel_flow-next_4eeb938e.png","gmickel","Gordon Mickel","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fgmickel_e94566fc.png","Operating Principal (AI\u002FTech) @ GrowthFactors \u002F BU Bregal Unternehmerkapital. Ex Head of AI @ CISTEC. Ex-founder @ DocIQ. Builder–Operator–Advisor. Dad x2 🚀","Mickel Tech","Basel, Switzerland",null,"https:\u002F\u002Fmickel.tech","https:\u002F\u002Fgithub.com\u002Fgmickel",[83,87,91],{"name":84,"color":85,"percentage":86},"Python","#3572A5",49.4,{"name":88,"color":89,"percentage":90},"TypeScript","#3178c6",26.9,{"name":92,"color":93,"percentage":94},"Shell","#89e051",23.6,570,41,"2026-04-15T06:50:44","MIT","未说明 (作为 CLI 插件，通常支持 Linux, macOS, Windows)","未说明 (本工具为工作流编排插件，不直接运行本地模型，依赖外部 API)","未说明",{"notes":103,"python":104,"dependencies":105},"这是一个零外部依赖的 AI 工作流编排插件，所有数据存储在本地仓库的 .flow\u002F 目录中。它本身不运行大模型，而是作为插件安装在 Claude Code、OpenAI Codex 等宿主工具中，通过调用外部 API 来执行任务。安装方式取决于具体的宿主平台（如使用 \u002Fplugin 命令或 git clone）。可选的图形界面 (TUI) 需要安装 Bun 运行时。","未说明 (依赖宿主环境如 Claude Code, OpenAI Codex 等)",[106,107,108,109,110,111],"Claude Code","OpenAI Codex","Factory Droid","OpenCode","Git","Bun (可选，用于 TUI)",[13,45],[114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130],"claude-code","execution","marketplace","planning","plugin","workflow","ai-workflow","anthropic","claude-code-plugin","cli","code-review","ai-agent","autonomous-agent","ralph-mode","codex","factory-droid","openai-codex","2026-03-27T02:49:30.150509","2026-04-18T09:24:24.356065",[134,139,144,149,154,159],{"id":135,"question_zh":136,"answer_zh":137,"source_url":138},38932,"Codex 经常超时或运行失败怎么办？","这是已知问题，通常是因为任务过大或审查迭代次数过多。维护者已在 v0.14.4 版本中调整了默认设置：\n1. 将 WORKER_TIMEOUT 从 45 分钟增加到 1 小时（3600 秒），作为防止无限运行的安全保护。\n2. 核心控制应依赖 MAX_REVIEW_ITERATIONS。如果经常需要 3 次以上的修复循环，说明任务拆分过大或规范不明确。\n建议更新到最新版本，并确保单个 Ralph 迭代能在一个上下文窗口内完成“选择任务→实现→审查→通过”的流程。","https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\u002Fissues\u002F59",{"id":140,"question_zh":141,"answer_zh":142,"source_url":143},38933,"Ralph.sh 为什么会在处理中途超时并停止？","根本原因是默认的 30 分钟超时（WORKER_TIMEOUT=1800）不足以完成多次 Codex 审查循环。当超时时，进程被强制杀死，导致任务状态丢失或跳跃。\n解决方案：\n1. 增加超时时间：设置 WORKER_TIMEOUT=3600（60 分钟）。\n2. 限制审查迭代次数：设置 MAX_REVIEW_ITERATIONS=3，超过后自动升级或跳过，避免无限循环。\n3. 已实施的修复包括：在缺少收据时重置任务状态、验证失败时清除损坏的收据、超时不计入尝试次数等。","https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\u002Fissues\u002F57",{"id":145,"question_zh":146,"answer_zh":147,"source_url":148},38934,"如何阻止 Claude Code 反复请求愚蠢的权限确认？","需要在 Claude 的配置文件中明确允许 flowctl 命令。请在 .claude\u002Fsettings.local.json 中添加以下配置：\n{\n  \"permissions\": {\n    \"allow\": [\"Bash(*flowctl*)\"]\n  }\n}\n注意：如果命令涉及管道操作（pipe），Claude Code 的权限系统仍可能要求确认，这是预期行为。如果问题依旧，尝试清理 Claude Code 缓存或使用 yolo 模式运行。","https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\u002Fissues\u002F24",{"id":150,"question_zh":151,"answer_zh":152,"source_url":153},38935,"如何在 Windows 上解决 ralph.sh 的路径问题导致 Codex 无法运行？","Windows 用户需升级到 v0.7.2 或更高版本，该版本已包含以下修复：\n1. Codex 输入改为通过 stdin 传递，避免 Windows 命令行长度限制（~8191 字符）。\n2. 新增 pick_python() 函数，自动检测 python3 或 python，兼容 Windows 环境。\n3. 自动检测 Windows 系统并应用特定路径逻辑（混合模式路径 C:\u002FUsers\u002F...）。\n4. 自动生成 flowctl 的 bash 包装器，解决 NTFS 执行位问题。\n无需手动打补丁，直接更新即可。","https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\u002Fissues\u002F35",{"id":155,"question_zh":156,"answer_zh":157,"source_url":158},38936,"如何让 Ralph 在后台长期运行而不中断？","建议在 VPS 或服务器上使用 tmux 会话运行 Ralph 模式。具体步骤：\n1. 启动 tmux 会话：tmux new -s ralph\n2. 在会话中运行 Ralph 脚本。\n3. 使用 Ctrl+B 然后 D detach 会话，即使断开 SSH 连接，Ralph 也会继续运行。\n4. 随时可通过 tmux attach -t ralph 重新连接查看进度。\n维护者确认 TUI 和监控功能已就绪，适合长时间后台任务。","https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\u002Fissues\u002F51",{"id":160,"question_zh":161,"answer_zh":162,"source_url":143},38937,"为什么任务会被标记为完成但实际未审查就跳到下一个任务？","这是由于超时导致写入收据（receipt）失败，而任务状态已被标记为 done。后续迭代检测到 status: done 便跳过该任务。\n修复方案已在代码中实现：\n1. 如果检测到任务标记为 done 但缺少有效收据，自动执行 flowctl task reset 将其重置为 todo。\n2. 如果重置失败，直接致命错误中止，防止静默跳过。\n3. 验证失败时自动删除损坏的收据文件。\n4. 超时不再计入最大尝试次数，区分基础设施故障和代码错误。\n请确保使用最新版本的 flowctl 工具。",[164,169,174,179,184,189,194,198,203,208,213,218,222,227,232,236,241,246,251,256],{"id":165,"version":166,"summary_zh":167,"released_at":168},314861,"flow-next-v0.29.4","### 修复\n- **rp-cli 2.1.6：构建器输出缺少选项卡\u002F上下文 ID** — `cmd_rp_builder` 和 `cmd_rp_setup_review` 现在始终向构建器传递 `--raw-json` 参数（之前是根据 `--response-type` 条件决定的）。RP 2.1.6 移除了纯文本输出中的 `Tab:` 和 `Context:` 文本行；ID 仅在 JSON 模式下提供。优先尝试解析 JSON，对于较旧的 RP 版本则回退到正则表达式。关闭了 #109。感谢 @berhanbero。\n- **Python 3.12+ 中 `datetime.utcnow()` 已弃用** — 在 `now_iso()` 和 `cmd_memory_add` 中已替换为 `datetime.now(timezone.utc)`。这消除了在 Python 3.12+ 上出现的 `DeprecationWarning` 警告。\n\n### 变更\n- README 推荐使用 RepoPrompt v2.1.6 及以上版本，并记录了更新路径（`brew upgrade --cask repoprompt`）。","2026-04-12T12:34:01",{"id":170,"version":171,"summary_zh":172,"released_at":173},314862,"flow-next-v0.29.3","### 修复\n- **RepoPrompt 2.x `oracle_send` 支持** — `flowctl rp chat-send` 现在优先使用 RP 2.x 的 `oracle_send`，而非旧版的 `chat_send`，仅在出现工具缺失错误时才会回退。同时会移除 RP 2.1.x 拒绝的 `chat_name` 和 `selected_paths` 字段。真正的错误将立即传播，不再被回退机制掩盖。感谢 @clairernovotny — [#107](https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\u002Fpull\u002F107)\n- **Ralph 回执校验加强** — 审核回执现在必须包含 `type`、`id` 和 `verdict`（SHIP\u002FNEEDS_WORK\u002FMAJOR_RETHINK）。能够捕获之前绕过校验的基于变量的回执写入方式（如 `printf ... > \"$RECEIPT_PATH\"`）。纵深防御：在工具执行前检查命令文本，Stop 处理器会验证磁盘上的实际文件。\n- **Ralph 提示模板** — 三个模板（`prompt_plan.md`、`prompt_work.md`、`prompt_completion.md`）现在都在回执 JSON 中包含 `\"verdict\":\"SHIP\"`。审核工作流会捕获响应，并从 `\u003Cverdict>` 标签中提取 verdict。\n\n### 新增\n- `run_rp_cli_unchecked` — 用于检测 `oracle_send` 回退的优雅 rp-cli 运行器\n- `ralph-receipt-guard.sh` — 命令行级别的回执校验，包含 verdict 与 type\u002Fid 的交叉检查\n- CI 测试覆盖：`oracle_send` 的现代、旧版及错误路径，回执绕过模式，以及回执校验","2026-04-12T12:15:35",{"id":175,"version":176,"summary_zh":177,"released_at":178},314863,"flow-next-v0.29.2","### 修复\n- **RepoPrompt 2.1.4 `Context:` 构建器输出** — `flowctl rp builder` 和 `flowctl rp setup-review` 现在除了旧有的 `Tab:` \u002F `tab_id` 格式外，也支持新的 `Context: \u003Cuuid>` 文本格式以及 `context_id`、`context` 和 `contextId` JSON 键。下游的 `--tab` 标志保持不变；为保持向后兼容性，仍会优先尝试旧有路径。新增了 CI 回归测试覆盖。感谢 @clairernovotny — [#106](https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\u002Fpull\u002F106)","2026-04-09T19:42:13",{"id":180,"version":181,"summary_zh":182,"released_at":183},314864,"flow-next-v0.29.1","### 修复\n- **setup-review 中的 RepoPrompt 工作区泄漏** — 当窗口匹配未能成功，每次重试都会执行 `workspace create --new-window`，导致 `WORK_REVIEW=rp` 的 Ralph 会话为同一仓库累积数十个重复的工作区\u002F窗口。现在改为分三层回退：先尝试 `bind_context`（RP 原生的仓库路径匹配，最新 API），再查询工作区库存中是否已有对应仓库路径的工作区，最后才作为兜底方案创建新工作区。隐藏的工作区不再被复制，而是通过 `manage_workspaces switch` 重新打开。感谢 @clairernovotny — [#104](https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fflow-next\u002Fpull\u002F104)\n- **`parse_builder_tab` 能容忍 JSON 格式的响应** — 现在会先尝试正则模式匹配（如 `Tab:`、`T=`、`\"tab_id\"`、`\"tab\"`），若仍无法解析，则递归遍历 JSON 结构，直到失败为止。这样就不会再因 RP 新版响应格式而导致致命错误。\n- **`parse_manage_workspaces` 解包嵌套的结果对象** — 能处理类似 `{\"result\": {\"workspaces\": [...]}}` 的 JSON-RPC 样式负载，并采用有限递归的方式解包。字符串类型的工作区名称会被保留为 `{\"name\": item}` 字典形式，而不会被丢弃。\n- **Windows 平台下 ralph-guard 状态文件使用 `tempfile.gettempdir()`** — 原本硬编码的 `\u002Ftmp` 路径在 Windows 上会被解析为 `\\tmp\\`，从而导致失败。这一长期存在的问题因新增的回归测试而暴露出来。\n\n### 新增\n- `try_run_rp_cli` — `run_rp_cli` 的优雅失败版本，用于可选的功能探测（例如较新的 RepoPrompt 功能）\n- `bind_context_window` 辅助函数 — 在可用时优先使用 RepoPrompt 原生的仓库路径绑定功能，否则回退到旧有的窗口\u002F工作区匹配逻辑\n- 为 RepoPrompt setup-review 增加了回归测试覆盖：bind_context 快速路径、可见工作区复用、隐藏工作区重新打开、嵌套结果解包以及字符串类型的工作区名称处理","2026-04-08T18:34:59",{"id":185,"version":186,"summary_zh":187,"released_at":188},314865,"flow-next-v0.29.0","### 新增\n- **DESIGN.md 意识** — 当存在 Google Stitch 的 DESIGN.md 时，进行条件化的设计系统集成\n- repo-scout 能够检测并验证 DESIGN.md（包括章节标题和十六进制颜色启发式规则）\n- Plan skill 在前端任务规范中写入 `## Design context`，并包含相关设计 token\n- Worker 在阶段 1.5 中读取 DESIGN.md 的各章节，前提是存在设计上下文\n- Prime Pillar 4 DC7 准则：存在 DESIGN.md（仅供参考）\n- docs-gap-scout 会扫描是否存在 DESIGN.md 和 .stitch\u002FDESIGN.md\n- Quality-auditor 会检查前端代码变更中的设计 token 是否符合规范（建议性检查）\n- Flow-gap-analyst 会检查 UI 功能与设计系统的对齐情况（建议性检查）\n\n### 变更\n- 前端任务检测的启发式方法已记录在案（文件扩展名、目录、关键词等）","2026-04-06T11:47:25",{"id":190,"version":191,"summary_zh":192,"released_at":193},314874,"flow-next-v0.22.2","\n### Fixed\n\n- **Codex: ensure `multi_agent` at TOML root** — `generate_config_entries` appended `multi_agent = true` at end of config.toml, which landed inside a preceding table instead of at root scope. Now prepended before any `[table]` header.\n- **Codex: deduplicate `[agents]` table** — installer always emitted a fresh `[agents]` declaration; if user already had one, the resulting file was invalid TOML. Now checks before declaring.\n- **Codex: patch prime workflow for multi-agent** — `Task flow-next:\u003Cscout>` references in prime's workflow.md were not converted to Codex role names, causing \"Scout availability partial\" (only 4\u002F9 scouts resolved). All 9 scouts now patched.\n- **Codex: escape backslashes in TOML agent configs** — agent markdown containing regex patterns (`\\.env`, `\\[test\\]`) broke TOML `\"\"\"` strings. Backslashes now auto-escaped.\n\n### Added\n\n- **RP auto-create workspace** — all `setup-review` calls now pass `--create`, so RepoPrompt auto-opens a workspace + window if none matches the repo root (RP 1.5.68+).\n- **Codex multi-agent roles** — complete rewrite of `install-codex.sh` for Codex 0.102.0+: `.md` agents → `.toml` role configs, 3-tier model mapping (intelligent\u002Fsmart scouts\u002Ffast scouts), `agents-md-scout` rename, prime\u002Fplan\u002Fwork skill patching.\n- **Codex install docs** — clone instructions, 3-tier model mapping table, override examples.","2026-02-19T08:15:04",{"id":195,"version":196,"summary_zh":79,"released_at":197},314875,"flow-next-v0.22.1","2026-02-19T08:06:06",{"id":199,"version":200,"summary_zh":201,"released_at":202},314876,"flow-next-v0.22.0","\n### Fixed\n\n- **Fix receipt-reset false positive on codex reviews** — PostToolUse receipt-write detection matched codex commands containing `--receipt` path + `>` chars in stdout (from `\u003Cverdict>` tags), causing `chat_send_succeeded` and `codex_review_succeeded` to reset immediately after being set. Receipt-write detection now uses proper shell redirect pattern matching (same regexes as PreToolUse) instead of naive substring checks. (thanks @clairernovotny for reporting)\n\n### Added\n\n- **Block self-modification of workflow files** — Ralph can no longer Edit\u002FWrite to `ralph-guard.py`, `flowctl.py`, `flowctl`, or `hooks.json` during a run. Hooks config now registers `Edit|Write` matcher in addition to `Bash|Execute`. Prevents agents from bypassing guards by editing their own tooling. (ralph-guard v0.13.0)","2026-02-17T22:14:30",{"id":204,"version":205,"summary_zh":206,"released_at":207},314877,"flow-next-v0.21.0","\n### Changed\n\n- **Upgrade scout agents from Haiku to Sonnet 4.6** — All 11 lightweight scout agents (build, claude-md, docs-gap, env, epic, memory, observability, security, testing, tooling, workflow) now use `claude-sonnet-4-6` (pinned) instead of `haiku`. Sonnet 4.6 brings improved reasoning, instruction following, and a training data cutoff of Jan 2026. Requires Claude Code 2.1.45+.","2026-02-17T21:14:53",{"id":209,"version":210,"summary_zh":211,"released_at":212},314878,"flow-next-v0.20.21","\n### Changed\n\n- **github-scout now opt-in** — Disabled by default (`scouts.github: false`). Enable via `\u002Fflow-next:setup` or `flowctl config set scouts.github true`. Reduces planning cost and removes `gh` CLI requirement for users who don't need cross-repo search.","2026-02-10T20:34:27",{"id":214,"version":215,"summary_zh":216,"released_at":217},314879,"flow-next-v0.20.20","\n### Fixed\n\n- **Review skills: prevent double context build** — Reordered RP workflow in impl-review, plan-review, and epic-review to run context-gathering before setup-review. Builder now runs once with a real summary instead of a placeholder. Added guardrails against re-running setup-review.","2026-02-07T22:39:28",{"id":219,"version":220,"summary_zh":79,"released_at":221},314880,"flow-next-v0.20.19","2026-02-03T22:39:10",{"id":223,"version":224,"summary_zh":225,"released_at":226},314866,"flow-next-v0.28.0","### 新增\n- 任务规范中的**调查目标**——规划编写了工人在编码前必须阅读的文件路径（必读\u002F可选），以减少幻觉并确保符合模式要求。\n- 剧集规范中的**需求覆盖**可追溯性表格——将每个需求映射到覆盖它的任务，并附上缺口说明，由计划同步工具在出现偏差时维护。\n- 剧集规范中的**早期验证点**——明确哪项任务用于验证核心方案，以及如果该任务失败应重新考虑哪些内容。\n- **双向剧集评审**——新增代码→规范的反向覆盖检查，用于检测范围蔓延（分类为：未文档化新增、合法支持、无关变更）。\n- **实施前搜索**——工人在编码前会 grep 搜索类似功能，遵循“复用 > 扩展 > 新建”的决策树。\n- **类型化升级**——采用结构化的区块消息，分为6类（规范不清晰、依赖阻塞、设计冲突、超出范围、工具故障、外部阻塞）。\n- **置信度限定词**——仓库侦察员和上下文侦察员会将发现标记为`[已验证]`（工具确认）或`[推断]`（从命名\u002F结构推导得出）。\n- **测试预算意识**——质量审计员会标记不成比例的测试生成（超过2:1的比例）以及现有测试的修改，并作为建议提示。\n\n### 变更\n- **计划同步范围**扩大，当检测到偏差时，也会更新剧集规范中的`## 需求覆盖`表格。\n- **剧集评审流程**由两阶段升级为三阶段（提取需求 → 验证实现 → 反向覆盖）。\n- 记录了 Codex 插件更新说明（卸载 → 从仓库重新安装）。","2026-04-05T23:17:23",{"id":228,"version":229,"summary_zh":230,"released_at":231},314867,"flow-next-v0.27.0","### 新增\n- **原生 Codex 插件支持**（`.codex-plugin\u002Fplugin.json`）—— Flow-Next 现已成为一流 Codex 插件，可通过 `\u002Fplugins` 发现\n- **Codex 市场发现**（`.agents\u002Fplugins\u002Fmarketplace.json`）—— 该仓库可用作 Codex 市场源\n- **预构建的 Codex 代理**，以 `.toml` 文件形式提供，并包含子代理优化配置（`sandbox_mode`、`nickname_candidates`）\n- **预构建的 Codex 技能**，采用平台特定的调用模式（使用 `$flow-next-plan` 而不是 `\u002Fflow-next:plan`）\n- **兼容 Codex 的钩子**，用于 Ralph 模式——Bash 工具防护 + Stop 钩子（实验性）\n- **`openai.yaml` UI 元数据**，用于 Codex 应用展示（品牌颜色、描述、默认提示）\n- **`scripts\u002Fsync-codex.sh`** — 构建脚本会从官方 Claude Code 源生成 `codex\u002F` 目录\n- **SessionStart 钩子**，用于 Codex（加载流程上下文）\n\n### 变更\n- **`install-codex.sh` 简化** — 代码行数从 785 行减少至 257 行；改用预构建的 `codex\u002F` 文件，不再进行运行时转换\n- **模型映射更新** — 使用 `gpt-5.4-mini` 替代 `gpt-5.3-codex-spark` 来扫描侦察员\n- **flowctl 路径** — 安装到 `~\u002F.codex\u002Fscripts\u002F`（原为 `~\u002F.codex\u002Fbin\u002F`），以保持一致性\n- **`bump.sh`** 同时更新 `.claude-plugin\u002F` 和 `.codex-plugin\u002F` 清单文件\n- **设置技能** 可检测 Codex 平台，并配置项目范围内的代理和钩子\n- 更新插件 README，加入原生 Codex 安装说明及技能调用指南\n- **仓库重命名**：`gmickel-claude-marketplace` → `flow-next`（GitHub 自动重定向旧 URL）","2026-04-05T13:51:36",{"id":233,"version":234,"summary_zh":79,"released_at":235},314868,"flow-next-v0.26.1","2026-03-22T06:37:46",{"id":237,"version":238,"summary_zh":239,"released_at":240},314869,"flow-next-v0.26.0","### 变更\n\n- **Codex 模型默认设置：全面升级至 gpt-5.4** — review\u002Foracle 模型由 `gpt-5.2` 升级至 `gpt-5.4`（高推理能力）。Agent 智能等级由 `gpt-5.3-codex` 升级至 `gpt-5.4`（高推理能力）。快速侦察员仍保持在 `gpt-5.3-codex-spark`。\n\n### 修复\n\n- **Codex 文档：移除关于 Ralph 的错误支持声明** — “适用场景”部分曾错误地列出 Ralph 自主导航模式。实际上，Ralph 需要插件钩子（防护钩子、收据门控），而 Codex 并不支持这些功能。现已扩展注意事项以进一步澄清。","2026-03-06T08:54:59",{"id":242,"version":243,"summary_zh":244,"released_at":245},314870,"flow-next-v0.25.0","### 修复\n\n- **Codex 审查：在所有平台上嵌入文件** — 移除了 `os.name == \"nt\"` 的限制条件，该条件曾将文件嵌入功能仅限于 Windows 系统。在 Unix\u002FmacOS 系统上，Codex 会先使用 `sed` 或 `rg` 读取文件，耗尽整个轮次预算后才给出评审结果（观察到执行了 114 条 Shell 命令、处理了 368 万 Token，但对复杂史诗任务始终未能得出结论）。现在，Codex 会始终尝试嵌入变更文件，并在预算不足时采用资源敏感的回退机制：当嵌入预算超出限制时，允许进行磁盘读取操作。默认的 `FLOW_CODEX_EMBED_MAX_BYTES` 从 100 KB 提升至 500 KB。（感谢 @acebytes — [#93](https:\u002F\u002Fgithub.com\u002Fgmickel\u002Fgmickel-claude-marketplace\u002Fpull\u002F93)）","2026-03-01T13:23:02",{"id":247,"version":248,"summary_zh":249,"released_at":250},314871,"flow-next-v0.24.0","### 新增\n\n- **规范驱动的工作流** — 现在执行“为X创建规范”时，会在由`\u002Fflow-next:setup`安装的CLAUDE.md\u002FAGENTS.md片段中获得指导。该操作会创建一个包含结构化规范模板的史诗任务（目标与背景、架构与数据模型、API契约、边缘场景与约束、验收准则、边界、决策背景）。随后可以选择`\u002Fflow-next:plan`（任务拆分）或`\u002Fflow-next:interview`（细化规范）。\n- **README：规范驱动的入口** — 在“何时使用何种方式”部分新增“规范驱动”工作流章节，更新了概览表格，并明确了规范、访谈和计划之间的界限。\n\n> 请重新运行`\u002Fflow-next:setup`，以将新的规范指导更新到您项目的CLAUDE.md\u002FAGENTS.md中。","2026-02-21T14:09:37",{"id":252,"version":253,"summary_zh":254,"released_at":255},314872,"flow-next-v0.23.0","\n### Added\n\n- **Browser skill: comprehensive update from upstream agent-browser** — synced with latest `vercel-labs\u002Fagent-browser` skill. New features: version check on use, command chaining guidance, `snapshot -i -C` (cursor-interactive), `click --new-tab`, diff commands (snapshot\u002Fscreenshot\u002Furl comparison), annotated screenshots (`--annotate` vision mode), safe JS eval (`--stdin`\u002F`-b`), config file support, session persistence with encryption (`--session-name`), `--auto-connect` for existing Chrome, `--allow-file-access` for local files, iOS Simulator (`-p ios`), timeouts section, `get box`\u002F`get styles`, `drag`\u002F`upload`, video recording, Chrome DevTools profiling.\n- **Browser skill: new reference files** — `commands.md` (full command reference), `snapshot-refs.md` (ref lifecycle\u002Fnotation), `session-management.md` (auto-persistence\u002Fencryption\u002Fconcurrency), `proxy.md` (proxy config\u002Fgeo-testing\u002Frotating proxies).\n- **Browser skill: updated references** — `auth.md` (OAuth\u002FSSO, 2FA, token refresh, security best practices), `debugging.md` (video recording, profiling), `advanced.md` (auto-connect, extensions, env vars, eval stdin\u002Fbase64).","2026-02-20T09:42:01",{"id":257,"version":258,"summary_zh":259,"released_at":260},314873,"flow-next-v0.22.3","\n### Fixed\n\n- **RP `--create` fails on empty default window** — when only an empty RP window exists (no folder loaded), `setup-review --create` reused it instead of creating a workspace with the repo folder, causing \"No workspace open\" from the builder. Now falls through to workspace creation.","2026-02-19T08:43:35"]