[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-SixHq--Overture":3,"tool-SixHq--Overture":61},[4,18,26,36,44,52],{"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 真正成长为懂上",141543,2,"2026-04-06T11:32:54",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107888,"2026-04-06T11:32:50",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":53,"name":54,"github_repo":55,"description_zh":56,"stars":57,"difficulty_score":10,"last_commit_at":58,"category_tags":59,"status":17},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[14,15,13,60],"视频",{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":76,"owner_email":76,"owner_twitter":77,"owner_website":78,"owner_url":79,"languages":80,"stars":101,"forks":102,"last_commit_at":103,"license":104,"difficulty_score":32,"env_os":105,"env_gpu":106,"env_ram":106,"env_deps":107,"category_tags":112,"github_topics":114,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":134,"updated_at":135,"faqs":136,"releases":168},4418,"SixHq\u002FOverture","Overture","Overture is an open-source, locally running web interface delivered as an MCP (Model Context Protocol) server that visually maps out the execution plan of any AI coding agent as an interactive flowchart\u002Fgraph before the agent begins writing code. ","Overture 是一款开源的本地运行工具，专为提升 AI 编程代理的工作透明度而设计。它作为一个基于模型上下文协议（MCP）的服务器，能在 AI 正式编写代码之前，将其执行计划转化为一张可交互的可视化流程图。\n\n当前主流的 AI 编程助手（如 Cursor、Cline 等）往往在接收指令后立即开始生成代码，用户难以预判其思路，常因理解偏差导致大量代码需重写，浪费时间与算力。即便部分工具提供文字版计划，也難以清晰展示任务依赖、分支选择及潜在风险。Overture 正是为了解决这一痛点：它拦截代理的规划阶段，让用户先通过直观的图表审视、修改并批准执行方案，确认无误后才会启动编码。\n\n该工具特别适合开发者和技术团队使用，尤其是那些希望更精细地控制 AI 输出、避免无效生成的资深工程师。其独特亮点在于将抽象的逻辑计划具象化为支持缩放、点击导航的动态图表，并允许用户在每个步骤附加文件、API 密钥或具体指令。此外，用户还能在运行时实时观察节点状态，清晰掌握进度。通过“先看计划，再写代码”的模式，Overture 有效降低了试错成本，让人机协作更加高效可控。","\u003Cp align=\"center\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fraw.githubusercontent.com\u002FSixHq\u002FOverture\u002Fmain\u002Fassets\u002Foverture-logo-dark.png\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_ad06dd3b7f6d.png\" alt=\"Overture\" width=\"400\">\n  \u003C\u002Fpicture>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cstrong>See the plan before the code. Approve it. Then watch it execute.\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Foverture-mcp\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Foverture-mcp?style=for-the-badge&color=blue\" alt=\"npm version\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Factions\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002FSixHq\u002FOverture\u002Fci.yml?branch=main&style=for-the-badge\" alt=\"CI status\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Foverture-mcp\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Foverture-mcp?style=for-the-badge&color=orange\" alt=\"npm downloads\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fdiscussions\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdiscussions\u002FSixHq\u002FOverture?style=for-the-badge&color=purple\" alt=\"Discussions\">\u003C\u002Fa>\n  \u003Ca href=\"LICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green.svg?style=for-the-badge\" alt=\"MIT License\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"#-the-problem\">Problem\u003C\u002Fa> •\n  \u003Ca href=\"#-the-solution\">Solution\u003C\u002Fa> •\n  \u003Ca href=\"#-installation\">Install\u003C\u002Fa> •\n  \u003Ca href=\"#-features\">Features\u003C\u002Fa> •\n  \u003Ca href=\"#-mcp-marketplace\">Marketplace\u003C\u002Fa> •\n  \u003Ca href=\"#-configuration\">Config\u003C\u002Fa> •\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fdiscussions\">Discussions\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cbr>\n\n\u003Cp align=\"center\">\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Feeb9c4cb-c80d-42da-bf63-c0c4ecb1e5d6\n\n\u003C\u002Fp>\n\n---\n\n## 🔥 The Problem\n\nEvery AI coding agent today — **Cursor**, **Claude Code**, **Cline**, **Copilot** — works the same way:\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd width=\"50%\">\n\n### What Happens Now\n\n1. You type a prompt\n2. Agent **immediately starts writing code**\n3. You have **zero visibility** into what it's doing\n4. You realize it misunderstood your request\n5. **Hundreds of lines of code** need to be discarded\n6. You've wasted tokens, time, and patience\n\n\u003C\u002Ftd>\n\u003Ctd width=\"50%\">\n\n### Text Plans Don't Help\n\nSome agents show plans as text in chat. But text fails to show:\n\n- **Dependencies** — which tasks depend on what?\n- **Branch points** — what alternative approaches exist?\n- **Context requirements** — which files, APIs, or secrets are needed?\n- **Complexity** — which steps are risky?\n- **Progress** — what's done, what's next?\n\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_3f92c1231331.png\" alt=\"The Problem\" width=\"700\">\n\u003C\u002Fp>\n\n---\n\n## ✨ The Solution\n\n**Overture** intercepts your AI agent's planning phase and renders it as an **interactive visual flowchart** — before any code is written.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_a49be8e195f0.png\" alt=\"Overture Solution\" width=\"900\">\n\u003C\u002Fp>\n\n### The agent doesn't write a single line of code until you approve the plan.\n\n\u003Cbr>\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd align=\"center\" width=\"20%\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_fb76aca535e7.png\" width=\"64\">\u003Cbr>\n\u003Cstrong>Visual Plans\u003C\u002Fstrong>\u003Cbr>\n\u003Csub>Interactive flowchart with pan, zoom, and click-through navigation\u003C\u002Fsub>\n\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"20%\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_798729ac8ab2.png\" width=\"64\">\u003Cbr>\n\u003Cstrong>Attach Context\u003C\u002Fstrong>\u003Cbr>\n\u003Csub>Files, API keys, instructions per step\u003C\u002Fsub>\n\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"20%\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_b313be80db44.png\" width=\"64\">\u003Cbr>\n\u003Cstrong>Choose Approaches\u003C\u002Fstrong>\u003Cbr>\n\u003Csub>Compare pros\u002Fcons of different paths\u003C\u002Fsub>\n\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"20%\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_395d6847f8e1.png\" width=\"64\">\u003Cbr>\n\u003Cstrong>Real-time Execution\u003C\u002Fstrong>\u003Cbr>\n\u003Csub>Watch nodes light up with progress\u003C\u002Fsub>\n\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"20%\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_00a3e79a089c.png\" width=\"64\">\u003Cbr>\n\u003Cstrong>MCP Marketplace\u003C\u002Fstrong>\u003Cbr>\n\u003Csub>Browse & attach tools per node\u003C\u002Fsub>\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n## 🚀 Installation\n\nOverture is an MCP server that works with **any MCP-compatible AI coding agent**. One command to install.\n\n### Claude Code\n\n```bash\nclaude mcp add overture-mcp -- npx overture-mcp\n```\n\n### Cursor\n\nAdd to `~\u002F.cursor\u002Fmcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"]\n    }\n  }\n}\n```\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>More Agents (Cline, Copilot, Sixth AI)\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n### Cline (VS Code Extension)\n\nOpen VS Code settings → search \"Cline MCP\" → add:\n\n```json\n{\n  \"mcpServers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"]\n    }\n  }\n}\n```\n\n### GitHub Copilot\n\nCreate `.vscode\u002Fmcp.json` in your project root:\n\n```json\n{\n  \"servers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"]\n    }\n  }\n}\n```\n\n> **Note:** GitHub Copilot MCP requires VS Code 1.99+ and uses `servers` instead of `mcpServers`.\n\n### Sixth AI (VS Code Extension)\n\nAdd to your Sixth AI MCP settings file:\n\n| Platform | Path |\n|----------|------|\n| macOS | `~\u002FLibrary\u002FApplication Support\u002FCode\u002FUser\u002FglobalStorage\u002Fsixth.sixth-ai\u002Fsettings\u002Fsixth-mcp-settings.json` |\n| Windows | `%APPDATA%\\Code\\User\\globalStorage\\sixth.sixth-ai\\settings\\sixth-mcp-settings.json` |\n| Linux | `~\u002F.config\u002FCode\u002FUser\u002FglobalStorage\u002Fsixth.sixth-ai\u002Fsettings\u002Fsixth-mcp-settings.json` |\n\n```json\n{\n  \"mcpServers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"],\n      \"disabled\": false\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n### Global Installation (Optional)\n\n```bash\nnpm install -g overture-mcp\n```\n\n### Verify It Works\n\nGive your agent any task. Overture automatically opens at `http:\u002F\u002Flocalhost:3031` with your plan ready for approval.\n\n---\n\n## 🎯 How It Works\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_3a2549fb435d.png\" alt=\"How Overture Works\" width=\"800\">\n\u003C\u002Fp>\n\n**The Flow:**\n\n| Step | What Happens |\n|------|--------------|\n| **1. Prompt** | You give your agent a task: \"Build a REST API with auth\" |\n| **2. Plan** | Agent generates a detailed plan with steps, branches, and requirements |\n| **3. Visualize** | Overture renders the plan as an interactive graph |\n| **4. Enrich** | You click nodes, attach files, select branches, fill in API keys |\n| **5. Approve** | You click \"Approve & Execute\" (or press Enter) |\n| **6. Execute** | Watch real-time as nodes pulse, complete, or fail |\n| **7. Control** | Pause (Spacebar), resume, re-run nodes, or modify the plan mid-flight |\n\n---\n\n## 🛠 Features\n\n### Interactive Plan Canvas\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_2eefc25bcd7f.png\" alt=\"Interactive Canvas\" width=\"800\">\n\u003C\u002Fp>\n\n| Feature | Description |\n|---------|-------------|\n| **React Flow Canvas** | Full pan, zoom, drag with smooth animations |\n| **Streaming Parser** | Plan nodes appear in real-time as the agent generates them |\n| **Dagre Auto-Layout** | Intelligent automatic positioning of nodes |\n| **Visual Status** | Pending (gray) → Active (pulsing yellow) → Completed (green) \u002F Failed (red) |\n| **Next Node Indicator** | Blue pulse shows which node executes next |\n| **Complexity Badges** | Low (green), Medium (yellow), High (red) at a glance |\n| **Glow Effects** | Shadow glows highlight active and upcoming nodes |\n| **Insertable Edges** | Hover over edges to insert new nodes mid-plan |\n\n---\n\n### Node Details Panel\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_43c14dfd9df7.png\" alt=\"Node Details Panel\" width=\"700\">\n\u003C\u002Fp>\n\nClick any node to reveal its full details:\n\n| Info | What You See |\n|------|--------------|\n| **Title & Description** | Full context for what this step does |\n| **Complexity Level** | Low \u002F Medium \u002F High with visual indicator |\n| **Expected Output** | What the step should produce |\n| **Risks & Edge Cases** | Potential issues to watch for |\n| **Pros & Cons** | For branch options, compare trade-offs |\n\n---\n\n### Dynamic Fields (User Inputs)\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_dbc04ddaf6bc.png\" alt=\"Dynamic Fields\" width=\"600\">\n\u003C\u002Fp>\n\nNodes can request input from you before execution:\n\n| Field Type | Use Case |\n|------------|----------|\n| **String** | Project names, URLs, custom values |\n| **Number** | Port numbers, limits, counts |\n| **Boolean** | Yes\u002FNo toggles for options |\n| **Select** | Dropdown with predefined choices |\n| **Secret** | API keys, tokens (masked input) |\n| **File** | File paths to attach context |\n\nEach field includes:\n- Required\u002Foptional indicator\n- Default values\n- Help text & descriptions\n- Setup instructions (\"How to get an API key\")\n\n---\n\n### File Attachments\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_53d87e89e265.png\" alt=\"File Attachments\" width=\"600\">\n\u003C\u002Fp>\n\nAttach context files to specific nodes:\n\n- **Automatic type detection** — Image, code, document, or other\n- **Visual icons** per file type\n- **Descriptions** — add notes about why this file matters\n- **Delete** — remove unwanted attachments\n\n---\n\n### Meta Instructions\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_8e1d8a5e33be.png\" alt=\"Meta Instructions\" width=\"600\">\n\u003C\u002Fp>\n\nAdd custom LLM instructions to any node:\n\n> \"Pay special attention to error handling here\"\n> \"Use the existing auth pattern from src\u002Fauth.ts\"\n> \"Make sure to add tests for edge cases\"\n\nInstructions are sent to the agent right before that node executes.\n\n---\n\n### Branch Detection & Selection\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002FSixHq\u002FOverture\u002Fmain\u002Fassets\u002Ffeature-branching.png\" alt=\"Branch Selection\" width=\"800\">\n\u003C\u002Fp>\n\nWhen the agent proposes multiple approaches:\n\n| Feature | Description |\n|---------|-------------|\n| **Auto-Detection** | Branches detected from graph structure (no special markup) |\n| **Branch Points** | Nodes with multiple outgoing edges become decision points |\n| **Selection Modal** | Side-by-side comparison with pros\u002Fcons |\n| **Complexity Comparison** | See difficulty level for each option |\n| **Visual Indicator** | Selected branch highlighted on canvas |\n| **Skip Unselected** | Only your chosen path executes |\n\n---\n\n### Requirements Checklist\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_1d5b8d40374a.png\" alt=\"Requirements Checklist\" width=\"400\">\n\u003C\u002Fp>\n\nBefore you can approve, Overture shows what's needed:\n\n- **Empty required fields** — counted per node\n- **Branch selections** — which decisions are pending\n- **Progress indicator** — visual completion tracking\n- **Expandable items** — click to see details\n- **Color coding** — Green (done) \u002F Orange (pending)\n\nThe Approve button stays disabled until all requirements are met.\n\n---\n\n### Execution Controls\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_6172161afc44.png\" alt=\"Execution Controls\" width=\"700\">\n\u003C\u002Fp>\n\n| Control | How |\n|---------|-----|\n| **Approve** | Click button or press `Enter` |\n| **Pause** | Press `Spacebar` mid-execution |\n| **Resume** | Press `Spacebar` again |\n| **Re-run Node** | Click failed node → \"Re-run\" |\n| **Re-run From Here** | Re-execute from any node to the end |\n\nThe approval button is smart:\n- 🟢 **\"Approve & Execute\"** — plan ready, requirements met\n- 🟠 **\"Complete Requirements\"** — conditions unmet\n- 🔵 **\"Executing...\"** — running with spinner\n- 🟢 **\"Completed\"** — all done\n- 🔴 **\"Failed\"** — error occurred\n\n---\n\n### Structured Output\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_b8108c465cae.png\" alt=\"Structured Output\" width=\"700\">\n\u003C\u002Fp>\n\nAfter each node executes, see rich structured output:\n\n| Category | What It Shows |\n|----------|---------------|\n| **Overview** | Summary of what was accomplished |\n| **Files Changed** | Paths, lines added\u002Fremoved, diffs |\n| **Files Created** | New files with line counts |\n| **Files Deleted** | Removed files |\n| **Packages Installed** | npm packages with versions |\n| **MCP Servers Setup** | Installation status (installed\u002Fconfigured\u002Ffailed) |\n| **Web Searches** | Queries performed, results used |\n| **Tool Calls** | Which tools were used and how often |\n| **Preview URLs** | Links to deployed sites or previews |\n| **Notes** | Info, warnings, errors |\n\nEach category is **expandable** — drill in without visual overload.\n\n---\n\n### Output Modal\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_55f99e403cd5.png\" alt=\"Output Modal\" width=\"700\">\n\u003C\u002Fp>\n\nClick any completed node to see full output:\n\n- **Scrollable** for long outputs\n- **Syntax highlighted** code snippets\n- **Close with Escape** or click outside\n\n---\n\n## 🏪 MCP Marketplace\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_7d9af78399a4.png\" alt=\"MCP Marketplace\" width=\"800\">\n\u003C\u002Fp>\n\n**Browse and attach MCP servers directly from the Overture UI.**\n\n| Feature | Description |\n|---------|-------------|\n| **Built-in Marketplace** | Search and discover MCP servers |\n| **Server Details** | Descriptions, authors, GitHub links, stars |\n| **Category Browsing** | Filter by use case |\n| **Per-Node Attachment** | Attach specific tools to specific steps |\n| **Setup Instructions** | See how to configure each server |\n| **Recommended Servers** | Curated list for common tasks |\n\nWhen you attach an MCP server to a node, the agent gains access to those tools **only for that step**.\n\n---\n\n## 📂 Multi-Project Support\n\nWork on multiple projects simultaneously:\n\n| Feature | Description |\n|---------|-------------|\n| **Tab Navigation** | Switch between projects instantly |\n| **Auto Registration** | Projects register on first agent contact |\n| **Isolated State** | Each project has separate plans, nodes, configs |\n| **Unread Badges** | Know when other projects have updates |\n| **Project Context** | See project name, path, and agent type |\n\nSingle project? Tab bar hides automatically for a cleaner UI.\n\n---\n\n## 📜 Plan History & Persistence\n\nNever lose your work:\n\n| Feature | Description |\n|---------|-------------|\n| **Auto-Save** | Plans saved every 3 seconds |\n| **Local Storage** | Stored in `~\u002F.overture\u002Fhistory.json` |\n| **History Browser** | Slide-in panel with all past plans |\n| **Status Icons** | Completed, failed, executing, paused |\n| **Progress Bars** | Visual completion percentage |\n| **One-Click Resume** | Load and continue any past plan |\n| **Full Context** | All field values, branch selections, attachments preserved |\n\n### Resume Information\n\nWhen resuming, you get complete context:\n\n- **Current node** — where execution stopped\n- **Completed nodes** — with their outputs\n- **Pending nodes** — what's left to do\n- **Failed nodes** — with error messages\n- **All configurations** — field values, branches, attachments\n- **Timestamps** — when created, when paused\n\n---\n\n## ✏️ Dynamic Plan Modification\n\nModify plans even during execution:\n\n| Operation | Description |\n|-----------|-------------|\n| **Insert Nodes** | Add new steps mid-execution |\n| **Remove Nodes** | Delete steps (edges auto-reconnect) |\n| **Replace Content** | Update node title\u002Fdescription in-place |\n| **Batch Operations** | Multiple changes in one request |\n\n### Plan Diff View\n\nWhen a plan changes, see exactly what's different:\n\n- **Added nodes** — highlighted green\n- **Removed nodes** — highlighted red\n- **Modified nodes** — yellow with before\u002Fafter comparison\n- **Edge changes** — added\u002Fremoved connections\n\n---\n\n## 🔌 MCP Tools (For Agent Developers)\n\nOverture exposes 11 MCP tools for agents to interact with:\n\n| Tool | Purpose |\n|------|---------|\n| `submit_plan` | Submit complete plan as XML |\n| `get_approval` | Wait for user approval (blocks until approved) |\n| `update_node_status` | Update node status + output during execution |\n| `plan_completed` | Mark plan as successfully completed |\n| `plan_failed` | Mark plan as failed with error message |\n| `check_rerun` | Check if user requested a node re-run |\n| `check_pause` | Check if user paused execution |\n| `get_resume_info` | Get full context for resuming a paused plan |\n| `request_plan_update` | Request incremental plan modifications |\n| `create_new_plan` | Signal creation of a new plan |\n| `get_usage_instructions` | Get agent-specific instructions |\n\n---\n\n## 🔄 Real-time WebSocket Communication\n\n**19 server-to-client message types:**\n\n`connected` • `plan_started` • `node_added` • `edge_added` • `plan_ready` • `plan_approved` • `node_status_updated` • `plan_completed` • `plan_failed` • `plan_paused` • `plan_resumed` • `nodes_inserted` • `node_removed` • `project_registered` • `projects_list` • `history_entries` • `plan_loaded` • `resume_plan_info` • `plan_updated`\n\n**16 client-to-server message types:**\n\n`approve_plan` • `cancel_plan` • `rerun_request` • `pause_execution` • `resume_execution` • `insert_nodes` • `remove_node` • `register_project` • `subscribe_project` • `unsubscribe_project` • `get_history` • `load_plan` • `get_resume_info` • `save_plan` • `request_plan_update` • `create_new_plan`\n\n### Relay Mode\n\nWhen the WebSocket port is already in use, Overture automatically operates as a **relay client**, forwarding messages through the existing server. Multiple agent instances can share a single UI.\n\n---\n\n## ⚙️ Configuration\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `OVERTURE_HTTP_PORT` | `3031` | Port for the web UI |\n| `OVERTURE_WS_PORT` | `3030` | Port for WebSocket |\n| `OVERTURE_AUTO_OPEN` | `true` | Auto-open browser on start |\n\n### Setting Environment Variables\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Claude Code\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```bash\nclaude mcp add overture-mcp -e OVERTURE_HTTP_PORT=4000 -e OVERTURE_AUTO_OPEN=false -- npx overture-mcp\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Cursor \u002F Cline \u002F Sixth AI\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```json\n{\n  \"mcpServers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"],\n      \"env\": {\n        \"OVERTURE_HTTP_PORT\": \"4000\",\n        \"OVERTURE_WS_PORT\": \"4001\",\n        \"OVERTURE_AUTO_OPEN\": \"false\"\n      }\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>GitHub Copilot\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```json\n{\n  \"servers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"],\n      \"env\": {\n        \"OVERTURE_HTTP_PORT\": \"4000\",\n        \"OVERTURE_WS_PORT\": \"4001\",\n        \"OVERTURE_AUTO_OPEN\": \"false\"\n      }\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## ⌨️ Keyboard Shortcuts\n\n| Key | Action |\n|-----|--------|\n| `Enter` | Approve plan (when ready) |\n| `Space` | Pause \u002F Resume execution |\n| `Escape` | Deselect current node \u002F Close modal |\n\n---\n\n## 🤝 Supported Agents\n\n| Agent | Status | Notes |\n|-------|--------|-------|\n| **Claude Code** | ✅ Full | Native MCP support |\n| **Cursor** | ✅ Full | Via mcp.json config |\n| **Cline** | ✅ Full | Via VS Code settings |\n| **GitHub Copilot** | ✅ Full | VS Code 1.99+ required |\n| **Sixth AI** | ✅ Full | Built-in, zero config |\n\nEach agent has **custom-tailored prompts** for optimal plan generation.\n\n---\n\n## 💪 Why Overture?\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd width=\"50%\">\n\n### For Users\n\n- **Transparency** — See exactly what happens before code is written\n- **Control** — Approve, reject, or modify any plan\n- **Context** — Attach files and instructions to the right steps\n- **Choice** — Compare approaches and pick your path\n- **Visibility** — Real-time progress with rich output\n- **Safety** — Pause, resume, or re-run at any time\n- **History** — Resume any past plan instantly\n- **Efficiency** — No wasted tokens on rejected approaches\n\n\u003C\u002Ftd>\n\u003Ctd width=\"50%\">\n\n### For AI Coding\n\n- **Trust** — Makes agents predictable and controllable\n- **Interpretability** — See AI reasoning before execution\n- **Universal** — Works with any MCP-compatible agent\n- **Extensible** — MCP Marketplace for tool discovery\n- **Open Source** — MIT licensed, community-driven\n- **Self-Contained** — No cloud dependencies\n- **Works Offline** — Fully local execution\n- **Multi-Project** — Manage multiple workspaces\n\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n## 🧑‍💻 Development\n\n```bash\n# Clone the repo\ngit clone https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture.git\ncd Overture\n\n# Install dependencies\nnpm install\n\n# Build all packages\nnpm run build\n\n# Start MCP server (in one terminal)\ncd packages\u002Fmcp-server && npm start\n\n# Start UI dev server (in another terminal)\ncd packages\u002Fui && npm run dev\n```\n\n### Tech Stack\n\n| Layer | Technologies |\n|-------|--------------|\n| **MCP Server** | Node.js, TypeScript, Express, WebSocket (ws), SAX XML Parser |\n| **UI** | React 18, React Flow, Zustand, Framer Motion, Tailwind CSS, Vite |\n| **Layout** | Dagre (automatic graph positioning) |\n\n---\n\n## 🤝 Contributing\n\nOverture is open source and we welcome contributions!\n\n- 🐛 **Report bugs** at [GitHub Issues](https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fissues)\n- 💡 **Suggest features** at [GitHub Discussions](https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fdiscussions)\n- 📖 **Improve docs** — PRs welcome\n- 🔧 **Contribute code** — see [CONTRIBUTING.md](CONTRIBUTING.md)\n\nAll contributions are appreciated, no matter how small.\n\n---\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\n\u003Cp align=\"center\">\n  \u003Cbr>\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_82e938e6dee5.png\" alt=\"Sixth\" width=\"120\">\n  \u003Cbr>\u003Cbr>\n  Built by \u003Ca href=\"https:\u002F\u002Ftrysixth.com\">\u003Cstrong>Sixth\u003C\u002Fstrong>\u003C\u002Fa>\n  \u003Cbr>\u003Cbr>\n  For the best experience, try \u003Ca href=\"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=Sixth.sixth-ai\">\u003Cstrong>Sixth for VS Code\u003C\u002Fstrong>\u003C\u002Fa>\u003Cbr>\n  Overture is built-in with zero configuration required.\n  \u003Cbr>\u003Cbr>\n  \u003Csub>Stop flying blind. See the plan. Approve it. Execute with confidence.\u003C\u002Fsub>\n\u003C\u002Fp>\n\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_f57759ee922b.png)](https:\u002F\u002Fwww.star-history.com\u002F#SixHq\u002FOverture&type=date&legend=top-left)","\u003Cp align=\"center\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fraw.githubusercontent.com\u002FSixHq\u002FOverture\u002Fmain\u002Fassets\u002Foverture-logo-dark.png\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_ad06dd3b7f6d.png\" alt=\"Overture\" width=\"400\">\n  \u003C\u002Fpicture>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cstrong>先看方案再写代码。批准后，即可见证其执行。\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Foverture-mcp\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Foverture-mcp?style=for-the-badge&color=blue\" alt=\"npm版本\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Factions\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002FSixHq\u002FOverture\u002Fci.yml?branch=main&style=for-the-badge\" alt=\"CI状态\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Foverture-mcp\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Foverture-mcp?style=for-the-badge&color=orange\" alt=\"npm下载量\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fdiscussions\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdiscussions\u002FSixHq\u002FOverture?style=for-the-badge&color=purple\" alt=\"讨论区\">\u003C\u002Fa>\n  \u003Ca href=\"LICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green.svg?style=for-the-badge\" alt=\"MIT许可证\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"#-the-problem\">问题\u003C\u002Fa> •\n  \u003Ca href=\"#-the-solution\"> 解决方案\u003C\u002Fa> •\n  \u003Ca href=\"#-installation\"> 安装\u003C\u002Fa> •\n  \u003Ca href=\"#-features\"> 特性\u003C\u002Fa> •\n  \u003Ca href=\"#-mcp-marketplace\"> 市场\u003C\u002Fa> •\n  \u003Ca href=\"#-configuration\"> 配置\u003C\u002Fa> •\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fdiscussions\"> 讨论\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cbr>\n\n\u003Cp align=\"center\">\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Feeb9c4cb-c80d-42da-bf63-c0c4ecb1e5d6\n\n\u003C\u002Fp>\n\n---\n\n## 🔥 问题\n\n如今的每款 AI 编程助手——**Cursor**、**Claude Code**、**Cline**、**Copilot**——都采用相同的运作方式：\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd width=\"50%\">\n\n### 目前的情况\n\n1. 您输入一个提示\n2. 助手会 **立即开始编写代码**\n3. 您对它的操作 **完全不可见**\n4. 您发现它误解了您的请求\n5. 必须丢弃 **数百行代码**\n6. 您浪费了计算资源、时间和耐心\n\n\u003C\u002Ftd>\n\u003Ctd width=\"50%\">\n\n### 文本计划无济于事\n\n有些助手会在聊天中以文本形式展示计划。然而，文本无法清晰地呈现以下内容：\n\n- **依赖关系**——哪些任务依赖于其他任务？\n- **分支点**——存在哪些备选方案？\n- **上下文需求**——需要哪些文件、API 或密钥？\n- **复杂性**——哪些步骤风险较高？\n- **进度**——已完成哪些部分，接下来要做什么？\n\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_3f92c1231331.png\" alt=\"问题\" width=\"700\">\n\u003C\u002Fp>\n\n---\n\n## ✨ 解决方案\n\n**Overture** 会在您的 AI 助手进入规划阶段时进行拦截，并将其渲染为一张 **交互式的可视化流程图**——在任何代码被编写之前。\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_a49be8e195f0.png\" alt=\"Overture解决方案\" width=\"900\">\n\u003C\u002Fp>\n\n### 在您批准该计划之前，助手不会写出任何一行代码。\n\n\u003Cbr>\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd align=\"center\" width=\"20%\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_fb76aca535e7.png\" width=\"64\">\u003Cbr>\n\u003Cstrong>可视化计划\u003C\u002Fstrong>\u003Cbr>\n\u003Csub>可平移、缩放并支持点击导航的交互式流程图\u003C\u002Fsub>\n\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"20%\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_798729ac8ab2.png\" width=\"64\">\u003Cbr>\n\u003Cstrong>附加上下文\u003C\u002Fstrong>\u003Cbr>\n\u003Csub>每个步骤可关联文件、API 密钥或指令\u003C\u002Fsub>\n\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"20%\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_b313be80db44.png\" width=\"64\">\u003Cbr>\n\u003Cstrong>选择方案\u003C\u002Fstrong>\u003Cbr>\n\u003Csub>比较不同路径的优缺点\u003C\u002Fsub>\n\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"20%\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_395d6847f8e1.png\" width=\"64\">\u003Cbr>\n\u003Cstrong>实时执行\u003C\u002Fstrong>\u003Cbr>\n\u003Csub>观察节点随着进度逐渐点亮\u003C\u002Fsub>\n\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"20%\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_00a3e79a089c.png\" width=\"64\">\u003Cbr>\n\u003Cstrong>MCP市场\u003C\u002Fstrong>\u003Cbr>\n\u003Csub>浏览并为每个节点添加工具\u003C\u002Fsub>\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n## 🚀 安装\n\nOverture 是一个 MCP 服务器，可与 **任何兼容 MCP 的 AI 编程助手** 配合使用。只需一条命令即可完成安装。\n\n### Claude Code\n\n```bash\nclaude mcp add overture-mcp -- npx overture-mcp\n```\n\n### Cursor\n\n将以下内容添加到 `~\u002F.cursor\u002Fmcp.json` 文件中：\n\n```json\n{\n  \"mcpServers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"]\n    }\n  }\n}\n```\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>更多助手（Cline、Copilot、Sixth AI）\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n### Cline（VS Code扩展）\n\n打开 VS Code 设置 → 搜索“Cline MCP”→ 添加：\n\n```json\n{\n  \"mcpServers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"]\n    }\n  }\n}\n```\n\n### GitHub Copilot\n\n在项目根目录下创建 `.vscode\u002Fmcp.json` 文件：\n\n```json\n{\n  \"servers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"]\n    }\n  }\n}\n```\n\n> **注意：** GitHub Copilot 的 MCP 需要 VS Code 1.99 或更高版本，并且使用的是 `servers` 而不是 `mcpServers`。\n\n### Sixth AI（VS Code扩展）\n\n将以下内容添加到 Sixth AI 的 MCP 设置文件中：\n\n| 平台 | 路径 |\n|----------|------|\n| macOS | `~\u002FLibrary\u002FApplication Support\u002FCode\u002FUser\u002FglobalStorage\u002Fsixth.sixth-ai\u002Fsettings\u002Fsixth-mcp-settings.json` |\n| Windows | `%APPDATA%\\Code\\User\\globalStorage\\sixth.sixth-ai\\settings\\sixth-mcp-settings.json` |\n| Linux | `~\u002F.config\u002FCode\u002FUser\u002FglobalStorage\u002Fsixth.sixth-ai\u002Fsettings\u002Fsixth-mcp-settings.json` |\n\n```json\n{\n  \"mcpServers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"],\n      \"disabled\": false\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n### 全局安装（可选）\n\n```bash\nnpm install -g overture-mcp\n```\n\n### 验证是否正常工作\n\n给您的助手布置一项任务。Overture 会自动在 `http:\u002F\u002Flocalhost:3031` 打开界面，显示待您批准的计划。\n\n---\n\n## 🎯 工作原理\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_3a2549fb435d.png\" alt=\"Overture工作原理\" width=\"800\">\n\u003C\u002Fp>\n\n**流程：**\n\n| 步骤 | 发生什么 |\n|------|--------------|\n| **1. 提示** | 您向助手下达任务：“构建一个带有认证功能的 REST API” |\n| **2. 计划** | 助手生成一份包含步骤、分支和需求的详细计划 |\n| **3. 可视化** | Overture 将该计划渲染成一张交互式图表 |\n| **4. 丰富** | 您可以点击各个节点，附加文件，选择分支，填写 API 密钥 |\n| **5. 批准** | 点击“批准并执行”（或按 Enter 键） |\n| **6. 执行** | 实时观察节点如何亮起、完成或失败 |\n| **7. 控制** | 暂停（空格键）、继续、重新运行节点，或在执行过程中修改计划 |\n\n---\n\n## 🛠 特性\n\n### 交互式计划画布\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_2eefc25bcd7f.png\" alt=\"交互式画布\" width=\"800\">\n\u003C\u002Fp>\n\n| 功能 | 描述 |\n|---------|-------------|\n| **React Flow 画布** | 支持全屏平移、缩放和拖拽，动画流畅 |\n| **流式解析器** | 计划节点会随着智能体生成实时显示 |\n| **Dagre 自动布局** | 智能自动定位节点 |\n| **可视化状态** | 待处理（灰色）→ 运行中（黄色脉冲）→ 完成（绿色）\u002F 失败（红色）|\n| **下一个节点指示器** | 蓝色脉冲显示即将执行的节点 |\n| **复杂度徽章** | 一目了然地标识低（绿色）、中（黄色）、高（红色）复杂度 |\n| **光效** | 阴影光晕突出显示当前及即将执行的节点 |\n| **可插入边** | 将鼠标悬停在边上即可在计划中间插入新节点 |\n\n---\n\n### 节点详情面板\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_43c14dfd9df7.png\" alt=\"节点详情面板\" width=\"700\">\n\u003C\u002Fp>\n\n点击任意节点即可展开其完整详情：\n\n| 信息 | 显示内容 |\n|------|--------------|\n| **标题与描述** | 该步骤的具体作用及其完整背景 |\n| **复杂度等级** | 低\u002F中\u002F高，并配有可视化标识 |\n| **预期输出** | 步骤应产生的结果 |\n| **风险与边界情况** | 需要关注的潜在问题 |\n| **优缺点** | 对于分支选项，可比较各方案的利弊 |\n\n---\n\n### 动态字段（用户输入）\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_dbc04ddaf6bc.png\" alt=\"动态字段\" width=\"600\">\n\u003C\u002Fp>\n\n节点在执行前可以请求您提供输入：\n\n| 字段类型 | 使用场景 |\n|------------|----------|\n| **字符串** | 项目名称、URL、自定义值 |\n| **数字** | 端口号、限制值、计数 |\n| **布尔值** | 开关类的“是\u002F否”选项 |\n| **下拉选择** | 预设选项的下拉菜单 |\n| **密钥** | API 密钥、令牌（输入时隐藏） |\n| **文件** | 用于附加上下文的文件路径 |\n\n每个字段均包含：\n- 必填\u002F选填标识\n- 默认值\n- 帮助文本及说明\n- 设置指南（例如“如何获取 API 密钥”）\n\n---\n\n### 文件附件\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_53d87e89e265.png\" alt=\"文件附件\" width=\"600\">\n\u003C\u002Fp>\n\n您可以将上下文文件附加到特定节点：\n\n- **自动类型检测** — 图片、代码、文档或其他类型\n- **按文件类型显示图标** |\n- **描述** — 添加关于该文件重要性的备注 |\n- **删除** — 移除不需要的附件 |\n\n---\n\n### 元指令\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_8e1d8a5e33be.png\" alt=\"元指令\" width=\"600\">\n\u003C\u002Fp>\n\n您可以在任意节点添加自定义的 LLM 指令：\n\n> “在此处特别注意错误处理”\n> “使用 src\u002Fauth.ts 中现有的认证模式”\n> “务必为边界情况添加测试”\n\n这些指令将在该节点执行前发送给智能体。\n\n---\n\n### 分支检测与选择\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002FSixHq\u002FOverture\u002Fmain\u002Fassets\u002Ffeature-branching.png\" alt=\"分支选择\" width=\"800\">\n\u003C\u002Fp>\n\n当智能体提出多种方案时：\n\n| 特性 | 描述 |\n|---------|-------------|\n| **自动检测** | 根据图结构自动识别分支，无需特殊标记 |\n| **分支节点** | 具有多条出边的节点成为决策点 |\n| **选择模态框** | 并排对比各方案的优缺点 |\n| **复杂度比较** | 查看每个选项的难易程度 |\n| **可视化指示** | 已选择的分支会在画布上高亮显示 |\n| **跳过未选分支** | 只有您选择的路径会被执行 |\n\n---\n\n### 要求检查清单\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_1d5b8d40374a.png\" alt=\"要求检查清单\" width=\"400\">\n\u003C\u002Fp>\n\n在您批准之前，Overture 会显示所需内容：\n\n- **必填字段是否为空** — 按节点统计 |\n- **分支选择是否完成** — 哪些决策尚未做出 |\n- **进度指示器** — 可视化的完成度跟踪 |\n- **可展开项** — 点击查看详情 |\n- **颜色编码** — 绿色（已完成）\u002F 橙色（待处理）\n\n只有当所有要求都满足时，“批准”按钮才会启用。\n\n---\n\n### 执行控制\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_6172161afc44.png\" alt=\"执行控制\" width=\"700\">\n\u003C\u002Fp>\n\n| 控制 | 如何操作 |\n|---------|-----|\n| **批准** | 点击按钮或按下 `Enter` 键 |\n| **暂停** | 在执行过程中按下 `空格键` |\n| **继续** | 再次按下 `空格键` |\n| **重试节点** | 点击失败节点 → “重试” |\n| **从这里重新执行** | 从任意节点开始重新执行至结束 |\n\n批准按钮具有智能逻辑：\n- 🟢 **“批准并执行”** — 计划已就绪，要求已满足 |\n- 🟠 **“完成要求”** — 条件未达成 |\n- 🔵 **“正在执行…”** — 显示加载动画 |\n- 🟢 **“已完成”** — 全部完成 |\n- 🔴 **“失败”** — 出现错误 |\n\n---\n\n### 结构化输出\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_b8108c465cae.png\" alt=\"结构化输出\" width=\"700\">\n\u003C\u002Fp>\n\n每个节点执行完毕后，您可以看到丰富的结构化输出：\n\n| 类别 | 显示内容 |\n|----------|---------------|\n| **概览** | 总结已完成的工作 |\n| **更改的文件** | 路径、新增\u002F删除的行以及差异对比 |\n| **创建的文件** | 新文件及其行数统计 |\n| **删除的文件** | 已移除的文件列表 |\n| **安装的包** | npm 包及其版本号 |\n| **MCP 服务器设置** | 安装状态（已安装\u002F已配置\u002F失败）|\n| **网络搜索** | 执行的查询及使用的搜索结果 |\n| **工具调用** | 使用了哪些工具以及调用频率 |\n| **预览链接** | 部署站点或预览页面的链接 |\n| **备注** | 信息、警告和错误 |\n\n每个类别均可展开——深入查看而不造成视觉负担。\n\n---\n\n### 输出模态框\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_55f99e403cd5.png\" alt=\"输出模态框\" width=\"700\">\n\u003C\u002Fp>\n\n点击任意已完成的节点即可查看完整输出：\n\n- **可滚动**，方便查看长篇输出 |\n- **语法高亮** 的代码片段 |\n- **通过 Esc 键或点击外部关闭** |\n\n---\n\n## 🏪 MCP 市场\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_7d9af78399a4.png\" alt=\"MCP 市场\" width=\"800\">\n\u003C\u002Fp>\n\n**直接从 Overture UI 浏览并附加 MCP 服务器。**\n\n| 功能 | 描述 |\n|---------|-------------|\n| **内置市场** | 搜索和发现 MCP 服务器 |\n| **服务器详情** | 描述、作者、GitHub 链接、星标数 |\n| **分类浏览** | 按使用场景筛选 |\n| **按节点附加** | 将特定工具附加到特定步骤 |\n| **设置说明** | 查看如何配置每台服务器 |\n| **推荐服务器** | 针对常见任务的精选列表 |\n\n当您将 MCP 服务器附加到某个节点时，代理仅在该步骤中才能访问这些工具。\n\n---\n\n## 📂 多项目支持\n\n同时处理多个项目：\n\n| 功能 | 描述 |\n|---------|-------------|\n| **标签页导航** | 瞬间切换项目 |\n| **自动注册** | 项目在首次与代理交互时自动注册 |\n| **隔离状态** | 每个项目拥有独立的计划、节点和配置 |\n| **未读徽章** | 知道其他项目是否有更新 |\n| **项目上下文** | 显示项目名称、路径和代理类型 |\n\n只有一个项目？标签栏会自动隐藏，以获得更简洁的界面。\n\n---\n\n## 📜 计划历史与持久化\n\n再也不用担心丢失工作：\n\n| 功能 | 描述 |\n|---------|-------------|\n| **自动保存** | 每 3 秒保存一次计划 |\n| **本地存储** | 存储在 `~\u002F.overture\u002Fhistory.json` 中 |\n| **历史浏览器** | 滑出式面板显示所有过往计划 |\n| **状态图标** | 已完成、失败、执行中、暂停 |\n| **进度条** | 可视化的完成百分比 |\n| **一键恢复** | 加载并继续任何过去的计划 |\n| **完整上下文** | 所有字段值、分支选择、附件均被保留 |\n\n### 恢复信息\n\n恢复时，您将获得完整的上下文：\n\n- **当前节点** — 执行停止的位置\n- **已完成节点** — 包含其输出\n- **待处理节点** — 还需完成的部分\n- **失败节点** — 包含错误信息\n- **所有配置** — 字段值、分支、附件\n- **时间戳** — 创建时间和暂停时间\n\n---\n\n## ✏️ 动态计划修改\n\n即使在执行过程中也可以修改计划：\n\n| 操作 | 描述 |\n|-----------|-------------|\n| **插入节点** | 在执行中途添加新步骤 |\n| **删除节点** | 删除步骤（边会自动重新连接） |\n| **替换内容** | 就地更新节点标题\u002F描述 |\n| **批量操作** | 一次请求即可进行多项更改 |\n\n### 计划差异视图\n\n当计划发生变化时，您可以清楚地看到具体的不同之处：\n\n- **新增节点** — 以绿色高亮显示\n- **删除节点** — 以红色高亮显示\n- **修改节点** — 黄色显示，并对比前后变化\n- **边的变化** — 添加或移除的连接线\n\n---\n\n## 🔌 MCP 工具（面向代理开发者）\n\nOverture 向代理公开了 11 种 MCP 工具，供其交互使用：\n\n| 工具 | 用途 |\n|------|---------|\n| `submit_plan` | 提交完整的 XML 格式计划 |\n| `get_approval` | 等待用户批准（阻塞直至批准） |\n| `update_node_status` | 在执行过程中更新节点状态及输出 |\n| `plan_completed` | 标记计划成功完成 |\n| `plan_failed` | 标记计划失败，并附带错误信息 |\n| `check_rerun` | 检查用户是否请求重新运行某个节点 |\n| `check_pause` | 检查用户是否暂停了执行 |\n| `get_resume_info` | 获取恢复暂停计划的完整上下文 |\n| `request_plan_update` | 请求增量式的计划修改 |\n| `create_new_plan` | 表示创建了一个新计划 |\n| `get_usage_instructions` | 获取针对特定代理的使用说明 |\n\n---\n\n## 🔄 实时 WebSocket 通信\n\n**19 种服务器到客户端的消息类型：**\n\n`connected` • `plan_started` • `node_added` • `edge_added` • `plan_ready` • `plan_approved` • `node_status_updated` • `plan_completed` • `plan_failed` • `plan_paused` • `plan_resumed` • `nodes_inserted` • `node_removed` • `project_registered` • `projects_list` • `history_entries` • `plan_loaded` • `resume_plan_info` • `plan_updated`\n\n**16 种客户端到服务器的消息类型：**\n\n`approve_plan` • `cancel_plan` • `rerun_request` • `pause_execution` • `resume_execution` • `insert_nodes` • `remove_node` • `register_project` • `subscribe_project` • `unsubscribe_project` • `get_history` • `load_plan` • `get_resume_info` • `save_plan` • `request_plan_update` • `create_new_plan`\n\n### 中继模式\n\n当 WebSocket 端口已被占用时，Overture 会自动作为 **中继客户端**，通过现有服务器转发消息。多个代理实例可以共享同一个 UI。\n\n---\n\n## ⚙️ 配置\n\n| 变量 | 默认值 | 描述 |\n|----------|---------|-------------|\n| `OVERTURE_HTTP_PORT` | `3031` | Web UI 的端口 |\n| `OVERTURE_WS_PORT` | `3030` | WebSocket 的端口 |\n| `OVERTURE_AUTO_OPEN` | `true` | 启动时自动打开浏览器 |\n\n### 设置环境变量\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Claude Code\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```bash\nclaude mcp add overture-mcp -e OVERTURE_HTTP_PORT=4000 -e OVERTURE_AUTO_OPEN=false -- npx overture-mcp\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Cursor \u002F Cline \u002F Sixth AI\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```json\n{\n  \"mcpServers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"],\n      \"env\": {\n        \"OVERTURE_HTTP_PORT\": \"4000\",\n        \"OVERTURE_WS_PORT\": \"4001\",\n        \"OVERTURE_AUTO_OPEN\": \"false\"\n      }\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>GitHub Copilot\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```json\n{\n  \"servers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"],\n      \"env\": {\n        \"OVERTURE_HTTP_PORT\": \"4000\",\n        \"OVERTURE_WS_PORT\": \"4001\",\n        \"OVERTURE_AUTO_OPEN\": \"false\"\n      }\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## ⌨️ 键盘快捷键\n\n| 键 | 操作 |\n|-----|--------|\n| `Enter` | 批准计划（就绪时） |\n| `Space` | 暂停\u002F恢复执行 |\n| `Escape` | 取消选中当前节点 \u002F 关闭模态窗口 |\n\n---\n\n## 🤝 支持的代理\n\n| 代理 | 状态 | 备注 |\n|-------|--------|-------|\n| **Claude Code** | ✅ 完整 | 原生支持 MCP |\n| **Cursor** | ✅ 完整 | 通过 mcp.json 配置 |\n| **Cline** | ✅ 完整 | 通过 VS Code 设置 |\n| **GitHub Copilot** | ✅ 完整 | 需要 VS Code 1.99 或更高版本 |\n| **Sixth AI** | ✅ 完整 | 内置，无需配置 |\n\n每个代理都配备了 **定制化的提示词**，以实现最佳的计划生成效果。\n\n---\n\n## 💪 为什么选择 Overture？\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd width=\"50%\">\n\n### 对于用户而言\n\n- **透明度** — 在代码编写之前就能清楚地了解整个过程\n- **控制权** — 可以批准、拒绝或修改任何计划\n- **上下文** — 将文件和说明附加到正确的步骤上\n- **选择性** — 比较不同方案并选择最适合自己的路径\n- **可见性** — 实时进度展示，输出丰富\n- **安全性** — 随时可以暂停、恢复或重新运行\n- **历史记录** — 可以立即恢复任何过去的计划\n- **效率** — 不会因拒绝的方案而浪费计算资源\n\n\u003C\u002Ftd>\n\u003Ctd width=\"50%\">\n\n### 针对 AI 编码\n\n- **信任** — 使代理行为可预测且可控\n- **可解释性** — 在执行前查看 AI 的推理过程\n- **通用性** — 适用于任何兼容 MCP 的代理\n- **可扩展性** — MCP 市场用于工具发现\n- **开源** — MIT 许可，社区驱动\n- **自包含** — 无云依赖\n- **离线可用** — 完全本地执行\n- **多项目支持** — 管理多个工作空间\n\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n## 🧑‍💻 开发\n\n```bash\n# 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture.git\ncd Overture\n\n# 安装依赖\nnpm install\n\n# 构建所有包\nnpm run build\n\n# 启动 MCP 服务器（在一个终端中）\ncd packages\u002Fmcp-server && npm start\n\n# 启动 UI 开发服务器（在另一个终端中）\ncd packages\u002Fui && npm run dev\n```\n\n### 技术栈\n\n| 层 | 技术 |\n|-------|--------------|\n| **MCP 服务器** | Node.js、TypeScript、Express、WebSocket (ws)、SAX XML 解析器 |\n| **UI** | React 18、React Flow、Zustand、Framer Motion、Tailwind CSS、Vite |\n| **布局** | Dagre（自动图布局） |\n\n---\n\n## 🤝 贡献\n\nOverture 是开源项目，我们欢迎各方贡献！\n\n- 🐛 **报告问题** 请至 [GitHub Issues](https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fissues)\n- 💡 **提出功能建议** 请至 [GitHub Discussions](https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fdiscussions)\n- 📖 **改进文档** — 欢迎提交 PR\n- 🔧 **参与代码贡献** — 请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)\n\n无论贡献大小，我们都深表感谢。\n\n---\n\n## 📄 许可证\n\nMIT 许可证 — 详情请参阅 [LICENSE](LICENSE)。\n\n---\n\n\u003Cp align=\"center\">\n  \u003Cbr>\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_82e938e6dee5.png\" alt=\"Sixth\" width=\"120\">\n  \u003Cbr>\u003Cbr>\n  由 \u003Ca href=\"https:\u002F\u002Ftrysixth.com\">\u003Cstrong>Sixth\u003C\u002Fstrong>\u003C\u002Fa> 打造\n  \u003Cbr>\u003Cbr>\n  为获得最佳体验，请尝试 \u003Ca href=\"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=Sixth.sixth-ai\">\u003Cstrong>Sixth for VS Code\u003C\u002Fstrong>\u003C\u002Fa>\u003Cbr>\n  Overture 内置其中，无需任何配置。\n  \u003Cbr>\u003Cbr>\n  \u003Csub>不再盲目行动。看清计划，批准并自信执行。\u003C\u002Fsub>\n\u003C\u002Fp>\n\n\n## 星标历史\n\n[![星标历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_readme_f57759ee922b.png)](https:\u002F\u002Fwww.star-history.com\u002F#SixHq\u002FOverture?type=date&legend=top-left)","# Overture 快速上手指南\n\nOverture 是一个 MCP 服务器工具，旨在解决 AI 编程助手（如 Cursor、Claude Code）“盲目写代码”的问题。它能在代码生成前，将 AI 的规划步骤渲染为**交互式可视化流程图**，允许用户在执行前审查、补充上下文并批准计划。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：macOS, Windows, 或 Linux\n*   **Node.js**：建议安装 LTS 版本（用于运行 `npx` 命令）\n*   **AI 编程助手**：需支持 MCP (Model Context Protocol)，例如：\n    *   Claude Code\n    *   Cursor\n    *   Cline (VS Code 插件)\n    *   GitHub Copilot (VS Code 1.99+)\n    *   Sixth AI\n*   **浏览器**：现代浏览器（Chrome, Edge, Firefox 等），用于访问可视化界面\n\n## 安装步骤\n\nOverture 无需复杂的全局配置，通常通过 `npx` 直接在支持的 AI 助手配置中调用即可。根据您的主力工具选择以下一种方式：\n\n### 1. Claude Code 用户\n在终端运行以下命令添加 MCP 服务：\n```bash\nclaude mcp add overture-mcp -- npx overture-mcp\n```\n\n### 2. Cursor 用户\n打开 Cursor 设置，找到 MCP 配置部分，编辑 `~\u002F.cursor\u002Fmcp.json` 文件，添加以下内容：\n```json\n{\n  \"mcpServers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"]\n    }\n  }\n}\n```\n\n### 3. Cline (VS Code 插件) 用户\n1. 打开 VS Code 设置，搜索 \"Cline MCP\"。\n2. 在 MCP 配置 JSON 中添加：\n```json\n{\n  \"mcpServers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"]\n    }\n  }\n}\n```\n\n### 4. GitHub Copilot 用户\n在项目根目录创建 `.vscode\u002Fmcp.json` 文件（注意键名为 `servers`）：\n```json\n{\n  \"servers\": {\n    \"overture\": {\n      \"command\": \"npx\",\n      \"args\": [\"overture-mcp\"]\n    }\n  }\n}\n```\n\n> **可选：全局安装**\n> 如果您希望预安装工具以避免每次运行时下载，可执行：\n> ```bash\n> npm install -g overture-mcp\n> ```\n\n## 基本使用\n\n安装完成后，Overture 会自动拦截 AI 助手的规划阶段。以下是标准工作流程：\n\n### 第一步：发起任务\n在您的 AI 助手对话框中输入任何开发任务，例如：\n> \"帮我构建一个带有身份验证功能的 REST API\"\n\n### 第二步：审查可视化计划\n此时，AI **不会**立即编写代码。Overture 会自动在浏览器中打开界面（默认地址：`http:\u002F\u002Flocalhost:3031`）。\n您将看到一个交互式的流程图，包含：\n*   **任务节点**：详细的执行步骤。\n*   **分支选项**：不同的实现路径及其优缺点对比。\n*   **依赖关系**：任务之间的先后顺序。\n\n### 第三步：补充上下文与批准\n在网页界面中，您可以：\n1.  **点击节点**：查看详细信息、风险预估和预期输出。\n2.  **填写动态字段**：输入必要的 API Key、端口号或上传参考文件。\n3.  **选择路径**：如果有多个方案，选择您倾向的一个。\n4.  **添加指令**：在特定节点附加给 AI 的额外提示（如“注意错误处理”）。\n\n当所有必填项完成后，点击 **\"Approve & Execute\"** 按钮（或按 `Enter` 键）。\n\n### 第四步：实时监控执行\n批准后，AI 开始工作。您可以在 Overture 界面上实时看到：\n*   当前执行节点的脉冲高亮。\n*   完成状态（绿色）或失败状态（红色）。\n*   **控制执行**：随时按 `Spacebar` 暂停\u002F恢复，或对失败节点点击 \"Re-run\" 重试。\n\n现在，您可以一边看着流程图逐步点亮，一边等待代码自动生成完毕。","某全栈开发者正委托 AI 编程助手重构一个遗留的电商订单系统，任务涉及数据库迁移、API 接口更新及前端组件适配，逻辑复杂且环环相扣。\n\n### 没有 Overture 时\n- **盲目执行导致返工**：AI 接到指令后立即开始编写代码，直到生成数百行后才被发现误解了“先迁移数据再修改接口”的关键顺序，导致大量代码需废弃重写。\n- **依赖关系不透明**：纯文本计划无法直观展示哪些步骤依赖于特定的数据库锁或外部 API 密钥，开发者难以预判潜在的阻塞点。\n- **试错成本高昂**：由于缺乏事前确认机制，开发者只能被动等待代码生成完毕才能发现问题，浪费了大量 Token 配额和调试时间。\n- **分支方案难对比**：当存在多种技术选型（如直接修改 vs 适配器模式）时，文字描述难以清晰呈现各路径的优劣与风险。\n\n### 使用 Overture 后\n- **可视化的事前审批**：Overture 在代码生成前将执行计划渲染为交互式流程图，开发者一眼看出顺序错误并即时修正，确保 AI“想对了再动手”。\n- **清晰的上下文挂载**：流程图中每个节点都明确标记了所需的文件、API 密钥及前置条件，复杂依赖关系一目了然，消除了隐性风险。\n- **可控的执行过程**：只有开发者点击批准后，AI 才开始工作；运行时节点会实时高亮显示进度，让整个过程完全可控且透明。\n- **多路径直观决策**：面对不同技术方案，Overture 以分支结构展示各路径的优缺点，帮助开发者快速选择最优解而非盲目尝试。\n\nOverture 通过将隐性的思维链转化为显性的可视化蓝图，彻底终结了 AI 编程中“盲目生成、事后补救”的低效循环。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSixHq_Overture_ad06dd3b.png","SixHq","Sixth","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FSixHq_c7237447.png","Sixth is an AI powered platform for protecting applications and codebase from malicious exploitations by hackers.",null,"sixth_hq","https:\u002F\u002Ftrysixth.com","https:\u002F\u002Fgithub.com\u002FSixHq",[81,85,89,93,97],{"name":82,"color":83,"percentage":84},"TypeScript","#3178c6",90.2,{"name":86,"color":87,"percentage":88},"JavaScript","#f1e05a",5.1,{"name":90,"color":91,"percentage":92},"Shell","#89e051",4.2,{"name":94,"color":95,"percentage":96},"CSS","#663399",0.4,{"name":98,"color":99,"percentage":100},"HTML","#e34c26",0.2,606,59,"2026-04-06T04:03:07","MIT","Linux, macOS, Windows","未说明",{"notes":108,"python":106,"dependencies":109},"该工具是一个 MCP (Model Context Protocol) 服务器，需通过 npx 运行。它不直接依赖 Python 或 GPU，而是作为中间件配合支持 MCP 的 AI 编程助手（如 Claude Code, Cursor, Cline, GitHub Copilot 等）使用。安装后会在本地启动一个 Web 界面（默认端口 3031）用于可视化审批执行计划。",[110,111],"Node.js (隐含，因使用 npx)","overture-mcp",[113,35,14,13],"插件",[115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,6,133],"ai-agent","ai-coding","claude","claude-code","copilot","cursor","developer-tools","gemini","gpt","llm","mcp","mcp-server","typescript","vscode","automation","deepseek","generative-ai","codex","planning","2026-03-27T02:49:30.150509","2026-04-06T22:01:20.871579",[137,142,147,151,156,160,164],{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},20091,"Overture 是否支持 GitHub Copilot 或 Cursor 等其他 AI 代理？","是的，新版本已增加对 GitHub Copilot 的支持。如果您在使用中遇到问题，请单独提交 Bug 报告。关于 Cursor 的支持，目前用户反馈在 Cursor 上可能仅显示初始化界面而无法正常工作，建议关注后续更新或提交具体问题反馈。","https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fissues\u002F1",{"id":143,"question_zh":144,"answer_zh":145,"source_url":146},20092,"调用 submit_plan 成功后，为什么 Web UI 显示空白且看不到计划？","这是一个已知问题，通常表现为 MCP 返回成功但 UI 未渲染计划，日志中可能出现 'No plan found' 错误。维护者已确认该问题并正在修复中。临时解决方法是检查是否有多个实例冲突（见下一题），并确保只有一个 Overture 实例在运行。","https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fissues\u002F4",{"id":148,"question_zh":149,"answer_zh":150,"source_url":146},20093,"为什么启动时会提示端口被占用，且计划数据在不同实例间不共享？","当运行 `npx overture-mcp` 时，如果已有实例占用端口（如 3040），新实例可能会尝试使用其他端口（如 3030\u002F3031）启动，导致多实例竞争且状态不共享。计划数据存储在 `~\u002F.overture\u002Fhistory.json` 中，但不同实例间未同步。解决方案是确保每次只运行一个 Overture 实例，或在启动前手动关闭旧进程。",{"id":152,"question_zh":153,"answer_zh":154,"source_url":155},20094,"Overture 与 Claude Code 的标准工作流程是什么？","标准流程如下：\n1. **计划提交**：当给 Claude Code 复杂任务时，它会调用 `submit_plan` 将计划 XML 发送给 Overture，此时会自动打开 Web UI 并显示交互式流程图。\n2. **审查与执行**：用户应在 Overture Web UI 中审查、细化计划并点击执行。执行后，Overture 会协调后续步骤，而不是让 Claude Code 会话继续独立运行。\n注意：不要在 Claude Code 会话和 Web UI 中同时接受计划，以免产生冲突。","https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fissues\u002F2",{"id":157,"question_zh":158,"answer_zh":159,"source_url":155},20095,"在 Web UI 点击执行后状态一直卡在 'Executing' 怎么办？","这通常是因为工作流理解有误或多实例冲突导致的。首先确认您没有在 Claude Code 终端中同时进行操作，所有细化和管理应在 Overture UI 中进行。其次，检查后台是否有多个 Overture 实例运行（查看端口占用情况），如果有，请终止多余实例并重启服务。如果问题依旧，可能是当前版本的边缘案例，建议查看最新修复版本。",{"id":161,"question_zh":162,"answer_zh":163,"source_url":146},20096,"终端日志被大量的 'History requested' 消息刷屏怎么办？","这是当前版本的一个已知问题，日志级别设置过高导致重复消息泛滥。这些消息实际上属于调试信息（debug-level）。目前官方已收到反馈并计划修复。在修复发布前，您可能需要通过重定向输出或过滤日志来查看关键错误信息。",{"id":165,"question_zh":166,"answer_zh":167,"source_url":155},20097,"Overture 是否支持实验性的 Agent Teams（代理团队）功能？","目前主要设计是通过子代理（subagents）机制来处理并行任务，并在 UI 中展示。对于特定的实验性 'Agent Teams' 功能，支持程度取决于底层代理模型的能力。当前版本侧重于通过 Overture UI 进行统一的计划编排和细化，而非直接在外部代理中管理复杂的团队并行 breakout。",[169,174],{"id":170,"version":171,"summary_zh":172,"released_at":173},118136,"0.1.7","# 开幕 MCP – 发布说明 (v0.1.7)\n\n本次发布重点提升了计划的可靠性、分支执行的正确性、结构化执行输出、附件用户体验，以及所有支持代理之间更一致的提示词风格。\n\n## ✅ 修复内容\n\n### 1) submit_plan 的成功判定标准现以渲染结果为准（不再严格要求 XML 格式有效）\n\n调用 submit_plan 时，在解析过程中仍可能出现无效的 XML 字符。此前，即使计划在画布上正确渲染，也可能返回失败响应，从而导致代理重复生成不必要的计划。\n\n现已修复：只要节点能够成功渲染，无论是否存在非阻塞性的 XML 解析问题，都将视为成功（优先渲染原则）。\n\n———\n\n### 2) 结构化的节点执行输出 + 更丰富的 UI 渲染\n\n执行输出的处理方式已从纯文本展示升级为结构化 XML 解析，以便提供更为详尽的节点后总结信息。\n\n具体改进包括：\n\n- 对已完成操作的概览性总结；\n- 按类别进行结构化整理，涵盖：\n  - 文件变更（含增删行信息）\n  - 新创建的文件\n  - 已删除的文件\n  - 安装的软件包\n  - MCP 设置相关操作\n  - 网络搜索\n  - 工具调用\n  - 预览 URL\n  - 备注\n- 每个类别均可展开查看详细内容；\n- 更新了提示词模板，使代理能够按照预期的结构化 XML 格式输出执行结果。\n\n———\n\n### 3) 分支条件现会自动排除未选分支特有的必填字段\n\n若某必填字段属于用户未选择的分支路径，则不应阻止审批流程。\n\n现已修复：必填项校验与检查清单仅针对当前激活或选定的路径强制执行。\n\n———\n\n### 4) 分支流程中的 Bug 已修复（移除了不必要的空分支选择节点行为）\n\n分支的渲染与执行流程已得到修正，避免出现不必要的“空决策步骤”中断。\n\n正确的流程应为：\n\n- node_1 → (node_2_a 或 node_2_b) → node_3\n\n而非：\n\n- node_1 → 空的分支选择节点 → (node_2_a 或 node_2_b) → node_3\n\n相关改进还包括：\n\n- 分支处理逻辑现与直接图结构保持一致；\n- 未选中的分支路径将被禁用；\n- 选择过程仍通过需求和侧边栏工作流来驱动。\n\n———\n\n### 5) 手动跳过审批流程时，UI 执行状态现可自动同步\n\n过去，当用户在终端或聊天界面中手动批准，并且代理直接调用 update_node_status 而未先获取审批时，UI 界面的状态会与实际不一致。\n\n现已修复：检测到此类模式时，UI 会自动完成审批，检查清单将隐藏，执行状态也将正确过渡。\n\n———\n\n### 6) 节点侧边栏中的文件附件 UX 已修复\n\n此前，附件功能依赖于手动输入文件路径。\n\n现已修复：\n\n- 改用文件选择器流程（单文件选择）；\n- 选定的文件将保存至服务器端；\n- 返回并附加文件的绝对存储路径；\n- 提升了附件的使用体验。","2026-03-02T19:22:07",{"id":175,"version":176,"summary_zh":177,"released_at":178},118137,"0.1.6","## 变更内容\n* 功能\u002FGitHub Copilot 集成，由 @SixHq 在 https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fpull\u002F3 中实现\n\n## 新贡献者\n* @SixHq 在 https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fpull\u002F3 中完成了首次贡献\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FSixHq\u002FOverture\u002Fcommits\u002F0.1.6\n\u003Cimg width=\"1440\" height=\"777\" alt=\"截图 2026-02-23 下午11:30:08\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F8c84dda5-2dd5-4582-871d-01792a0498a8\" \u002F>\n","2026-02-24T12:35:07"]