[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-MiniMax-AI--Mini-Agent":3,"tool-MiniMax-AI--Mini-Agent":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":77,"owner_email":78,"owner_twitter":79,"owner_website":80,"owner_url":81,"languages":82,"stars":103,"forks":104,"last_commit_at":105,"license":106,"difficulty_score":32,"env_os":107,"env_gpu":108,"env_ram":108,"env_deps":109,"category_tags":120,"github_topics":121,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":125,"updated_at":126,"faqs":127,"releases":158},8790,"MiniMax-AI\u002FMini-Agent","Mini-Agent","A minimal yet professional single agent demo project that showcases the core execution pipeline and production-grade features of agents.","Mini-Agent 是一个精简而专业的智能体（Agent）演示项目，旨在展示构建生产级 AI 智能体的核心执行流程与最佳实践。它基于 MiniMax M2.5 模型打造，通过兼容 Anthropic 的 API 接口，充分利用该模型强大的“交错思维”能力，以高效处理长周期、高复杂度的任务。\n\n该项目主要解决了开发者在从零构建智能体时面临的架构繁琐、上下文管理困难及记忆缺失等痛点。Mini-Agent 内置了完整的智能体执行闭环，支持文件与 shell 操作；具备持久化记忆功能，能通过“会话笔记工具”在多轮对话中保留关键信息；同时拥有智能上下文管理机制，可自动总结历史对话以突破令牌限制，实现无限长度的任务处理。此外，它还集成了 15 种专业技能（涵盖文档、设计、测试等）及原生 MCP 工具支持（如知识图谱与网络搜索），并提供了详尽的日志记录以便调试。\n\nMini-Agent 代码结构清晰简洁，配有友好的命令行界面，非常适合希望快速上手智能体开发的程序员、研究人员以及需要参考生产级架构的技术团队使用。无论是作为学习样板还是二次开发的基础，它都能帮助用户轻松构建强大且可靠的 AI 应用。","# Mini Agent\n\nEnglish | [中文](.\u002FREADME_CN.md)\n\n**Mini Agent** is a minimal yet professional demo project that showcases the best practices for building agents with the MiniMax M2.5 model. Leveraging an Anthropic-compatible API, it fully supports interleaved thinking to unlock M2's powerful reasoning capabilities for long, complex tasks.\n\nThis project comes packed with features designed for a robust and intelligent agent development experience:\n\n*   ✅ **Full Agent Execution Loop**: A complete and reliable foundation with a basic toolset for file system and shell operations.\n*   ✅ **Persistent Memory**: An active **Session Note Tool** ensures the agent retains key information across multiple sessions.\n*   ✅ **Intelligent Context Management**: Automatically summarizes conversation history to handle contexts up to a configurable token limit, enabling infinitely long tasks.\n*   ✅ **Claude Skills Integration**: Comes with 15 professional skills for documents, design, testing, and development.\n*   ✅ **MCP Tool Integration**: Natively supports MCP for tools like knowledge graph access and web search.\n*   ✅ **Comprehensive Logging**: Detailed logs for every request, response, and tool execution for easy debugging.\n*   ✅ **Clean & Simple Design**: A beautiful CLI and a codebase that is easy to understand, making it the perfect starting point for building advanced agents.\n\n## Table of Contents\n\n- [Mini Agent](#mini-agent)\n  - [Table of Contents](#table-of-contents)\n  - [Quick Start](#quick-start)\n    - [1. Get API Key](#1-get-api-key)\n    - [2. Choose Your Usage Mode](#2-choose-your-usage-mode)\n      - [🚀 Quick Start Mode (Recommended for Beginners)](#-quick-start-mode-recommended-for-beginners)\n      - [🔧 Development Mode](#-development-mode)\n  - [ACP \\& Zed Editor Integration(optional)](#acp--zed-editor-integrationoptional)\n  - [Usage Examples](#usage-examples)\n    - [Task Execution](#task-execution)\n    - [Using a Claude Skill (e.g., PDF Generation)](#using-a-claude-skill-eg-pdf-generation)\n    - [Web Search \\& Summarization (MCP Tool)](#web-search--summarization-mcp-tool)\n  - [Testing](#testing)\n    - [Quick Run](#quick-run)\n    - [Test Coverage](#test-coverage)\n  - [Troubleshooting](#troubleshooting)\n    - [SSL Certificate Error](#ssl-certificate-error)\n    - [Module Not Found Error](#module-not-found-error)\n  - [Related Documentation](#related-documentation)\n  - [Community](#community)\n  - [Contributing](#contributing)\n  - [License](#license)\n  - [References](#references)\n\n## Quick Start\n\n### 1. Get API Key\n\nMiniMax provides both global and China platforms. Choose based on your network environment:\n\n| Version    | Platform                                                       | API Base                   |\n| ---------- | -------------------------------------------------------------- | -------------------------- |\n| **Global** | [https:\u002F\u002Fplatform.minimax.io](https:\u002F\u002Fplatform.minimax.io)     | `https:\u002F\u002Fapi.minimax.io`   |\n| **China**  | [https:\u002F\u002Fplatform.minimaxi.com](https:\u002F\u002Fplatform.minimaxi.com) | `https:\u002F\u002Fapi.minimaxi.com` |\n\n**Steps to get API Key:**\n1. Visit the corresponding platform to register and login\n2. Go to **Account Management > API Keys**\n3. Click **\"Create New Key\"**\n4. Copy and save it securely (key is only shown once)\n\n> 💡 **Tip**: Remember the API Base address corresponding to your chosen platform, you'll need it for configuration\n\n### 2. Choose Your Usage Mode\n\n**Prerequisites: Install uv**\n\nBoth usage modes require uv. If you don't have it installed:\n\n```bash\n# macOS\u002FLinux\u002FWSL\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# Windows (PowerShell)\npython -m pip install --user pipx\npython -m pipx ensurepath\n# Restart PowerShell after installation\n\n# After installation, restart your terminal or run:\nsource ~\u002F.bashrc  # or ~\u002F.zshrc (macOS\u002FLinux)\n```\n\nWe offer two usage modes - choose based on your needs:\n\n#### 🚀 Quick Start Mode (Recommended for Beginners)\n\nPerfect for users who want to quickly try Mini Agent without cloning the repository or modifying code.\n\n**Installation:**\n\n```bash\n# 1. Install directly from GitHub\nuv tool install git+https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent.git\n\n# 2. Run setup script (automatically creates config files)\n# macOS\u002FLinux:\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FMiniMax-AI\u002FMini-Agent\u002Fmain\u002Fscripts\u002Fsetup-config.sh | bash\n\n# Windows (PowerShell):\nInvoke-WebRequest -Uri \"https:\u002F\u002Fraw.githubusercontent.com\u002FMiniMax-AI\u002FMini-Agent\u002Fmain\u002Fscripts\u002Fsetup-config.ps1\" -OutFile \"$env:TEMP\\setup-config.ps1\"\npowershell -ExecutionPolicy Bypass -File \"$env:TEMP\\setup-config.ps1\"\n```\n\n> 💡 **Tip**: If you want to develop locally or modify code, use \"Development Mode\" below\n\n**Configuration:**\n\nThe setup script creates config files in `~\u002F.mini-agent\u002Fconfig\u002F`. Edit the config file:\n\n```bash\n# Edit config file\nnano ~\u002F.mini-agent\u002Fconfig\u002Fconfig.yaml\n```\n\nFill in your API Key and corresponding API Base:\n\n```yaml\napi_key: \"YOUR_API_KEY_HERE\"          # API Key from step 1\napi_base: \"https:\u002F\u002Fapi.minimax.io\"  # Global\n# api_base: \"https:\u002F\u002Fapi.minimaxi.com\"  # China\nmodel: \"MiniMax-M2.5\"\n```\n\n**Start Using:**\n\n```bash\nmini-agent                                    # Use current directory as workspace\nmini-agent --workspace \u002Fpath\u002Fto\u002Fyour\u002Fproject  # Specify workspace directory\nmini-agent --version                          # Check version\n\n# Management commands\nuv tool upgrade mini-agent                    # Upgrade to latest version\nuv tool uninstall mini-agent                  # Uninstall if needed\nuv tool list                                  # View all installed tools\n```\n\n#### 🔧 Development Mode\n\nFor developers who need to modify code, add features, or debug.\n\n**Installation & Configuration:**\n\n```bash\n# 1. Clone the repository\ngit clone https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent.git\ncd Mini-Agent\n\n# 2. Install uv (if you haven't)\n# macOS\u002FLinux:\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n# Windows (PowerShell):\nirm https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.ps1 | iex\n# Restart terminal after installation\n\n# 3. Sync dependencies\nuv sync\n\n# Alternative: Install dependencies manually (if not using uv)\n# pip install -r requirements.txt\n# Or install required packages:\n# pip install tiktoken pyyaml httpx pydantic requests prompt-toolkit mcp\n\n# 4. Initialize Claude Skills (Optional)\ngit submodule update --init --recursive\n\n# 5. Copy config template\n```\n\n**macOS\u002FLinux:**\n```bash\ncp mini_agent\u002Fconfig\u002Fconfig-example.yaml mini_agent\u002Fconfig\u002Fconfig.yaml\n```\n\n**Windows:**\n```powershell\nCopy-Item mini_agent\\config\\config-example.yaml mini_agent\\config\\config.yaml\n\n# 6. Edit config file\nvim mini_agent\u002Fconfig\u002Fconfig.yaml  # Or use your preferred editor\n```\n\nFill in your API Key and corresponding API Base:\n\n```yaml\napi_key: \"YOUR_API_KEY_HERE\"          # API Key from step 1\napi_base: \"https:\u002F\u002Fapi.minimax.io\"  # Global\n# api_base: \"https:\u002F\u002Fapi.minimaxi.com\"  # China\nmodel: \"MiniMax-M2.5\"\nmax_steps: 100\nworkspace_dir: \".\u002Fworkspace\"\n```\n\n> 📖 Full configuration guide: See [config-example.yaml](mini_agent\u002Fconfig\u002Fconfig-example.yaml)\n\n**Run Methods:**\n\nChoose your preferred run method:\n\n```bash\n# Method 1: Run as module directly (good for debugging)\nuv run python -m mini_agent.cli\n\n# Method 2: Install in editable mode (recommended)\nuv tool install -e .\n# After installation, run from anywhere and code changes take effect immediately\nmini-agent\nmini-agent --workspace \u002Fpath\u002Fto\u002Fyour\u002Fproject\n```\n\n> 📖 For more development guidance, see [Development Guide](docs\u002FDEVELOPMENT_GUIDE.md)\n\n> 📖 For more production deployment guidance, see [Production Guide](docs\u002FPRODUCTION_GUIDE.md)\n\n## ACP & Zed Editor Integration(optional)\n\nMini Agent supports the [Agent Communication Protocol (ACP)](https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Fprotocol) for integration with code editors like Zed.\n\n**Setup in Zed Editor:**\n\n1. Install Mini Agent in development mode or as a tool\n2. Add to your Zed `settings.json`:\n\n```json\n{\n  \"agent_servers\": {\n    \"mini-agent\": {\n      \"command\": \"\u002Fpath\u002Fto\u002Fmini-agent-acp\"\n    }\n  }\n}\n```\n\nThe command path should be:\n- If installed via `uv tool install`: Use the output of `which mini-agent-acp`\n- If in development mode: `.\u002Fmini_agent\u002Facp\u002Fserver.py`\n\n**Usage:**\n- Open Zed's agent panel with `Ctrl+Shift+P` → \"Agent: Toggle Panel\"\n- Select \"mini-agent\" from the agent dropdown\n- Start conversations with Mini Agent directly in your editor\n\n## Usage Examples\n\nHere are a few examples of what Mini Agent can do.\n\n### Task Execution\n\n*In this demo, the agent is asked to create a simple, beautiful webpage and display it in the browser, showcasing the basic tool-use loop.*\n\n![Demo GIF 1: Basic Task Execution](docs\u002Fassets\u002Fdemo1-task-execution.gif \"Basic Task Execution Demo\")\n\n### Using a Claude Skill (e.g., PDF Generation)\n\n*Here, the agent leverages a Claude Skill to create a professional document (like a PDF or DOCX) based on the user's request, demonstrating its advanced capabilities.*\n\n![Demo GIF 2: Claude Skill Usage](docs\u002Fassets\u002Fdemo2-claude-skill.gif \"Claude Skill Usage Demo\")\n\n### Web Search & Summarization (MCP Tool)\n\n*This demo shows the agent using its web search tool to find up-to-date information online and summarize it for the user.*\n\n![Demo GIF 3: Web Search](docs\u002Fassets\u002Fdemo3-web-search.gif \"Web Search Demo\")\n\n## Testing\n\nThe project includes comprehensive test cases covering unit tests, functional tests, and integration tests.\n\n### Quick Run\n\n```bash\n# Run all tests\npytest tests\u002F -v\n\n# Run core functionality tests\npytest tests\u002Ftest_agent.py tests\u002Ftest_note_tool.py -v\n```\n\n### Test Coverage\n\n- ✅ **Unit Tests** - Tool classes, LLM client\n- ✅ **Functional Tests** - Session Note Tool, MCP loading\n- ✅ **Integration Tests** - Agent end-to-end execution\n- ✅ **External Services** - Git MCP Server loading\n\n\n## Troubleshooting\n\n### SSL Certificate Error\n\nIf you encounter `[SSL: CERTIFICATE_VERIFY_FAILED]` error:\n\n**Quick fix for testing** (modify `mini_agent\u002Fllm.py`):\n```python\n# Line 50: Add verify=False to AsyncClient\nasync with httpx.AsyncClient(timeout=120.0, verify=False) as client:\n```\n\n**Production solution**:\n```bash\n# Update certificates\npip install --upgrade certifi\n\n# Or configure system proxy\u002Fcertificates\n```\n\n### Module Not Found Error\n\nMake sure you're running from the project directory:\n```bash\ncd Mini-Agent\npython -m mini_agent.cli\n```\n\n## Related Documentation\n\n- [Development Guide](docs\u002FDEVELOPMENT_GUIDE.md) - Detailed development and configuration guidance\n- [Production Guide](docs\u002FPRODUCTION_GUIDE.md) - Best practices for production deployment\n\n## Community\n\nJoin the MiniMax official community to get help, share ideas, and stay updated:\n\n- **WeChat Group**: Scan the QR code on [Contact Us](https:\u002F\u002Fplatform.minimaxi.com\u002Fdocs\u002Ffaq\u002Fcontact-us) page to join\n\n## Contributing\n\nIssues and Pull Requests are welcome!\n\n- [Contributing Guide](CONTRIBUTING.md) - How to contribute\n- [Code of Conduct](CODE_OF_CONDUCT.md) - Community guidelines\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n## References\n\n- MiniMax API: https:\u002F\u002Fplatform.minimax.io\u002Fdocs\n- MiniMax-M2: https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-M2\n- Anthropic API: https:\u002F\u002Fdocs.anthropic.com\u002Fclaude\u002Freference\n- Claude Skills: https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fskills\n- MCP Servers: https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Fservers\n\n---\n\n**⭐ If this project helps you, please give it a Star!**\n","# Mini Agent\n\n英语 | [中文](.\u002FREADME_CN.md)\n\n**Mini Agent** 是一个极简但专业的演示项目，展示了使用 MiniMax M2.5 模型构建智能体的最佳实践。它基于与 Anthropic 兼容的 API，完全支持交错式思维，从而为长而复杂的任务释放 M2 的强大推理能力。\n\n该项目包含丰富的功能，旨在提供健壮且智能的智能体开发体验：\n\n*   ✅ **完整的智能体执行循环**：具备基础文件系统和 Shell 操作工具集的完整可靠框架。\n*   ✅ **持久化记忆**：通过活跃的 **会话笔记工具**，确保智能体在多次会话中保留关键信息。\n*   ✅ **智能上下文管理**：自动总结对话历史，以处理最多可配置的 token 数量的上下文，从而实现无限长度的任务。\n*   ✅ **Claude 技能集成**：内置 15 种专业技能，适用于文档、设计、测试和开发等领域。\n*   ✅ **MCP 工具集成**：原生支持 MCP，可用于知识图谱访问和网页搜索等工具。\n*   ✅ **全面的日志记录**：对每次请求、响应和工具执行进行详细记录，便于调试。\n*   ✅ **简洁明了的设计**：美观的命令行界面和易于理解的代码库，使其成为构建高级智能体的理想起点。\n\n## 目录\n\n- [Mini Agent](#mini-agent)\n  - [目录](#table-of-contents)\n  - [快速入门](#quick-start)\n    - [1. 获取 API 密钥](#1-get-api-key)\n    - [2. 选择使用模式](#2-choose-your-usage-mode)\n      - [🚀 快速入门模式（推荐初学者）](#-quick-start-mode-recommended-for-beginners)\n      - [🔧 开发模式](#-development-mode)\n  - [ACP & Zed 编辑器集成（可选）](#acp--zed-editor-integrationoptional)\n  - [使用示例](#usage-examples)\n    - [任务执行](#task-execution)\n    - [使用 Claude 技能（例如 PDF 生成）](#using-a-claude-skill-eg-pdf-generation)\n    - [网页搜索与摘要（MCP 工具）](#web-search--summarization-mcp-tool)\n  - [测试](#testing)\n    - [快速运行](#quick-run)\n    - [测试覆盖率](#test-coverage)\n  - [故障排除](#troubleshooting)\n    - [SSL 证书错误](#ssl-certificate-error)\n    - [模块未找到错误](#module-not-found-error)\n  - [相关文档](#related-documentation)\n  - [社区](#community)\n  - [贡献](#contributing)\n  - [许可证](#license)\n  - [参考文献](#references)\n\n## 快速入门\n\n### 1. 获取 API 密钥\n\nMiniMax 提供全球版和中国版平台，请根据您的网络环境选择：\n\n| 版本    | 平台                                                       | API 基础地址                   |\n| ---------- | -------------------------------------------------------------- | -------------------------- |\n| **全球** | [https:\u002F\u002Fplatform.minimax.io](https:\u002F\u002Fplatform.minimax.io)     | `https:\u002F\u002Fapi.minimax.io`   |\n| **中国**  | [https:\u002F\u002Fplatform.minimaxi.com](https:\u002F\u002Fplatform.minimaxi.com) | `https:\u002F\u002Fapi.minimaxi.com` |\n\n**获取 API 密钥的步骤：**\n1. 访问相应平台进行注册并登录\n2. 进入 **账户管理 > API 密钥**\n3. 点击 **“创建新密钥”**\n4. 复制并妥善保存（密钥仅显示一次）\n\n> 💡 **提示**：请记住您所选平台对应的 API 基础地址，配置时需要用到。\n\n### 2. 选择使用模式\n\n**先决条件：安装 uv**\n\n两种使用模式均需使用 uv。如果您尚未安装：\n\n```bash\n# macOS\u002FLinux\u002FWSL\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# Windows (PowerShell)\npython -m pip install --user pipx\npython -m pipx ensurepath\n# 安装后重启 PowerShell\n\n# 安装完成后，重启终端或运行：\nsource ~\u002F.bashrc  # 或 ~\u002F.zshrc (macOS\u002FLinux)\n```\n\n我们提供两种使用模式，您可以根据需求选择：\n\n#### 🚀 快速入门模式（推荐初学者）\n\n非常适合希望快速试用 Mini Agent 而无需克隆仓库或修改代码的用户。\n\n**安装：**\n\n```bash\n# 1. 直接从 GitHub 安装\nuv tool install git+https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent.git\n\n# 2. 运行设置脚本（自动创建配置文件）\n# macOS\u002FLinux:\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FMiniMax-AI\u002FMini-Agent\u002Fmain\u002Fscripts\u002Fsetup-config.sh | bash\n\n# Windows (PowerShell):\nInvoke-WebRequest -Uri \"https:\u002F\u002Fraw.githubusercontent.com\u002FMiniMax-AI\u002FMini-Agent\u002Fmain\u002Fscripts\u002Fsetup-config.ps1\" -OutFile \"$env:TEMP\\setup-config.ps1\"\npowershell -ExecutionPolicy Bypass -File \"$env:TEMP\\setup-config.ps1\"\n```\n\n> 💡 **提示**：如果您想在本地开发或修改代码，请使用下方的“开发模式”。\n\n**配置：**\n\n设置脚本会在 `~\u002F.mini-agent\u002Fconfig\u002F` 中创建配置文件。编辑配置文件：\n\n```bash\n# 编辑配置文件\nnano ~\u002F.mini-agent\u002Fconfig\u002Fconfig.yaml\n```\n\n填写您的 API 密钥和对应的 API 基础地址：\n\n```yaml\napi_key: \"YOUR_API_KEY_HERE\"          # 第一步获取的 API 密钥\napi_base: \"https:\u002F\u002Fapi.minimax.io\"  # 全球\n# api_base: \"https:\u002F\u002Fapi.minimaxi.com\"  # 中国\nmodel: \"MiniMax-M2.5\"\n```\n\n**开始使用：**\n\n```bash\nmini-agent                                    # 使用当前目录作为工作空间\nmini-agent --workspace \u002Fpath\u002Fto\u002Fyour\u002Fproject  # 指定工作空间目录\nmini-agent --version                          # 查看版本\n\n# 管理命令\nuv tool upgrade mini-agent                    # 升级到最新版本\nuv tool uninstall mini-agent                  # 如有需要可卸载\nuv tool list                                  # 查看所有已安装工具\n```\n\n#### 🔧 开发模式\n\n适用于需要修改代码、添加功能或进行调试的开发者。\n\n**安装与配置：**\n\n```bash\n# 1. 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent.git\ncd Mini-Agent\n\n# 2. 安装 uv（如果尚未安装）\n# macOS\u002FLinux:\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n# Windows (PowerShell):\nirm https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.ps1 | iex\n# 安装后重启终端\n\n# 3. 同步依赖项\nuv sync\n\n# 替代方案：手动安装依赖项（如果不使用 uv）\n# pip install -r requirements.txt\n# 或者单独安装所需包：\n# pip install tiktoken pyyaml httpx pydantic requests prompt-toolkit mcp\n\n# 4. 初始化 Claude 技能（可选）\ngit submodule update --init --recursive\n\n# 5. 复制配置模板\n```\n\n**macOS\u002FLinux：**\n```bash\ncp mini_agent\u002Fconfig\u002Fconfig-example.yaml mini_agent\u002Fconfig\u002Fconfig.yaml\n```\n\n**Windows：**\n```powershell\nCopy-Item mini_agent\\config\\config-example.yaml mini_agent\\config\\config.yaml\n\n# 6. 编辑配置文件\nvim mini_agent\u002Fconfig\u002Fconfig.yaml  # 或使用您喜欢的编辑器\n```\n\n填写您的 API 密钥和对应的 API 基础地址：\n\n```yaml\napi_key: \"YOUR_API_KEY_HERE\"          # 第一步获取的 API 密钥\napi_base: \"https:\u002F\u002Fapi.minimax.io\"  # 全球\n\n# api_base: \"https:\u002F\u002Fapi.minimaxi.com\"  # 中国\nmodel: \"MiniMax-M2.5\"\nmax_steps: 100\nworkspace_dir: \".\u002Fworkspace\"\n```\n\n> 📖 完整配置指南：请参阅 [config-example.yaml](mini_agent\u002Fconfig\u002Fconfig-example.yaml)\n\n**运行方式：**\n\n请选择您偏好的运行方式：\n\n```bash\n# 方法一：直接以模块形式运行（适合调试）\nuv run python -m mini_agent.cli\n\n# 方法二：以可编辑模式安装（推荐）\nuv tool install -e .\n# 安装完成后，可在任何位置运行，代码更改会立即生效\nmini-agent\nmini-agent --workspace \u002Fpath\u002Fto\u002Fyour\u002Fproject\n```\n\n> 📖 更多开发指导，请参阅 [开发指南](docs\u002FDEVELOPMENT_GUIDE.md)\n\n> 📖 更多生产部署指导，请参阅 [生产指南](docs\u002FPRODUCTION_GUIDE.md)\n\n## ACP 与 Zed 编辑器集成（可选）\n\nMini Agent 支持 [Agent Communication Protocol (ACP)](https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Fprotocol)，以便与 Zed 等代码编辑器集成。\n\n**在 Zed 编辑器中设置：**\n\n1. 以开发模式或工具形式安装 Mini Agent\n2. 在 Zed 的 `settings.json` 中添加以下内容：\n\n```json\n{\n  \"agent_servers\": {\n    \"mini-agent\": {\n      \"command\": \"\u002Fpath\u002Fto\u002Fmini-agent-acp\"\n    }\n  }\n}\n```\n\n命令路径应为：\n- 如果通过 `uv tool install` 安装：使用 `which mini-agent-acp` 的输出\n- 如果处于开发模式：`.\u002Fmini_agent\u002Facp\u002Fserver.py`\n\n**使用方法：**\n- 使用 `Ctrl+Shift+P` 打开 Zed 的代理面板 → “Agent: Toggle Panel”\n- 从代理下拉菜单中选择“mini-agent”\n- 直接在编辑器中与 Mini Agent 展开对话\n\n## 使用示例\n\n以下是 Mini Agent 可以完成的一些示例。\n\n### 任务执行\n\n*在此演示中，要求代理创建一个简单美观的网页并在浏览器中显示，展示了基本的工具使用循环。*\n\n![演示 GIF 1：基本任务执行](docs\u002Fassets\u002Fdemo1-task-execution.gif \"基本任务执行演示\")\n\n### 使用 Claude 技能（例如生成 PDF）\n\n*在这里，代理利用 Claude 技能根据用户请求创建一份专业文档（如 PDF 或 DOCX），展示了其高级功能。*\n\n![演示 GIF 2：Claude 技能使用](docs\u002Fassets\u002Fdemo2-claude-skill.gif \"Claude 技能使用演示\")\n\n### 网络搜索与摘要（MCP 工具）\n\n*此演示展示了代理如何使用网络搜索工具获取最新在线信息，并将其摘要呈现给用户。*\n\n![演示 GIF 3：网络搜索](docs\u002Fassets\u002Fdemo3-web-search.gif \"网络搜索演示\")\n\n## 测试\n\n该项目包含全面的测试用例，涵盖单元测试、功能测试和集成测试。\n\n### 快速运行\n\n```bash\n# 运行所有测试\npytest tests\u002F -v\n\n# 运行核心功能测试\npytest tests\u002Ftest_agent.py tests\u002Ftest_note_tool.py -v\n```\n\n### 测试覆盖率\n\n- ✅ **单元测试** - 工具类、LLM 客户端\n- ✅ **功能测试** - 会话笔记工具、MCP 加载\n- ✅ **集成测试** - 代理端到端执行\n- ✅ **外部服务** - Git MCP 服务器加载\n\n\n## 故障排除\n\n### SSL 证书错误\n\n如果您遇到 `[SSL: CERTIFICATE_VERIFY_FAILED]` 错误：\n\n**测试时的快速修复**（修改 `mini_agent\u002Fllm.py`）：\n```python\n# 第 50 行：在 AsyncClient 中添加 verify=False\nasync with httpx.AsyncClient(timeout=120.0, verify=False) as client:\n```\n\n**生产环境解决方案**：\n```bash\n# 更新证书\npip install --upgrade certifi\n\n# 或者配置系统代理\u002F证书\n```\n\n### 模块未找到错误\n\n请确保您在项目目录下运行：\n```bash\ncd Mini-Agent\npython -m mini_agent.cli\n```\n\n## 相关文档\n\n- [开发指南](docs\u002FDEVELOPMENT_GUIDE.md) - 详细的开发和配置指导\n- [生产指南](docs\u002FPRODUCTION_GUIDE.md) - 生产部署的最佳实践\n\n## 社区\n\n加入 MiniMax 官方社区，获取帮助、分享想法并及时了解最新动态：\n\n- **微信群**：扫描 [联系我们](https:\u002F\u002Fplatform.minimaxi.com\u002Fdocs\u002Ffaq\u002Fcontact-us) 页面上的二维码加入\n\n## 贡献\n\n欢迎提交问题和拉取请求！\n\n- [贡献指南](CONTRIBUTING.md) - 如何参与贡献\n- [行为准则](CODE_OF_CONDUCT.md) - 社区规范\n\n## 许可证\n\n本项目采用 [MIT 许可证](LICENSE)。\n\n## 参考资料\n\n- MiniMax API：https:\u002F\u002Fplatform.minimax.io\u002Fdocs\n- MiniMax-M2：https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-M2\n- Anthropic API：https:\u002F\u002Fdocs.anthropic.com\u002Fclaude\u002Freference\n- Claude 技能：https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fskills\n- MCP 服务器：https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Fservers\n\n---\n\n**⭐ 如果这个项目对您有帮助，请为它点亮星标！**","# Mini-Agent 快速上手指南\n\nMini-Agent 是一个基于 MiniMax M2.5 模型的专业智能体（Agent）演示项目。它支持交错思维链（Interleaved Thinking），具备强大的长任务推理能力，并集成了文件操作、持久化记忆、上下文自动总结、Claude Skills 以及 MCP 工具等核心功能。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：macOS, Linux, 或 Windows (WSL\u002FPowerShell)\n*   **Python 版本**：推荐 Python 3.10+\n*   **前置依赖**：本项目推荐使用 `uv` 进行包管理和环境构建。\n\n**安装 uv：**\n\n```bash\n# macOS\u002FLinux\u002FWSL\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# Windows (PowerShell)\npython -m pip install --user pipx\npython -m pipx ensurepath\n# 安装完成后请重启 PowerShell 终端\n```\n\n## 安装步骤\n\n您可以根据需求选择**快速启动模式**（适合直接体验）或**开发模式**（适合二次开发）。\n\n### 模式一：快速启动模式（推荐新手）\n\n无需克隆代码库，直接通过 `uv` 安装并使用。\n\n1.  **安装工具**\n    ```bash\n    uv tool install git+https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent.git\n    ```\n\n2.  **初始化配置**\n    运行官方脚本自动生成配置文件目录。\n    ```bash\n    # macOS\u002FLinux\n    curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FMiniMax-AI\u002FMini-Agent\u002Fmain\u002Fscripts\u002Fsetup-config.sh | bash\n\n    # Windows (PowerShell)\n    Invoke-WebRequest -Uri \"https:\u002F\u002Fraw.githubusercontent.com\u002FMiniMax-AI\u002FMini-Agent\u002Fmain\u002Fscripts\u002Fsetup-config.ps1\" -OutFile \"$env:TEMP\\setup-config.ps1\"\n    powershell -ExecutionPolicy Bypass -File \"$env:TEMP\\setup-config.ps1\"\n    ```\n\n3.  **配置 API Key**\n    编辑生成的配置文件 `~\u002F.mini-agent\u002Fconfig\u002Fconfig.yaml`：\n    ```bash\n    nano ~\u002F.mini-agent\u002Fconfig\u002Fconfig.yaml\n    ```\n    填入您的 MiniMax API Key 和对应的接口地址（国内用户请使用中国平台）：\n    ```yaml\n    api_key: \"YOUR_API_KEY_HERE\"          \n    # 国内平台地址\n    api_base: \"https:\u002F\u002Fapi.minimaxi.com\"  \n    # 全球平台地址 (如需使用请取消下方注释)\n    # api_base: \"https:\u002F\u002Fapi.minimax.io\"  \n    model: \"MiniMax-M2.5\"\n    ```\n    > **获取 Key 指引**：访问 [MiniMax 中国平台](https:\u002F\u002Fplatform.minimaxi.com) 或 [全球平台](https:\u002F\u002Fplatform.minimax.io)，在“账户管理 > API Keys”中创建新密钥。\n\n### 模式二：开发模式\n\n适合需要修改源码、添加功能或调试的开发者。\n\n1.  **克隆仓库**\n    ```bash\n    git clone https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent.git\n    cd Mini-Agent\n    ```\n\n2.  **同步依赖**\n    ```bash\n    uv sync\n    ```\n\n3.  **初始化子模块（可选）**\n    如需使用 Claude Skills 功能，请执行：\n    ```bash\n    git submodule update --init --recursive\n    ```\n\n4.  **配置项目**\n    复制配置模板并编辑：\n    ```bash\n    # macOS\u002FLinux\n    cp mini_agent\u002Fconfig\u002Fconfig-example.yaml mini_agent\u002Fconfig\u002Fconfig.yaml\n    \n    # Windows\n    Copy-Item mini_agent\\config\\config-example.yaml mini_agent\\config\\config.yaml\n    ```\n    同样在 `mini_agent\u002Fconfig\u002Fconfig.yaml` 中填入 `api_key` 和 `api_base`。\n\n5.  **本地安装（可选）**\n    为了方便在任何目录运行且实时生效：\n    ```bash\n    uv tool install -e .\n    ```\n\n## 基本使用\n\n配置完成后，即可通过命令行启动 Mini-Agent。\n\n### 1. 启动智能体\n\n在当前目录启动（将当前文件夹作为工作空间）：\n```bash\nmini-agent\n```\n\n指定特定项目目录作为工作空间：\n```bash\nmini-agent --workspace \u002Fpath\u002Fto\u002Fyour\u002Fproject\n```\n\n### 2. 交互示例\n\n启动后，您将进入 CLI 交互界面。您可以直接输入自然语言指令，例如：\n\n*   **执行任务**：\n    > \"创建一个简单的 HTML 网页，包含标题和我的简介，并在浏览器中打开它。\"\n    *(Agent 将自动调用文件系统工具创建文件并执行 shell 命令)*\n\n*   **使用技能（如生成 PDF）**：\n    > \"使用文档技能将当前的 README 文件转换为 PDF 格式。\"\n\n*   **联网搜索（需配置 MCP）**：\n    > \"搜索今天关于 AI 领域的最新新闻，并总结成三点。\"\n\n### 3. 常用管理命令\n\n```bash\n# 查看版本\nmini-agent --version\n\n# 升级到最新版本 (仅限快速启动模式)\nuv tool upgrade mini-agent\n\n# 卸载\nuv tool uninstall mini-agent\n```","一位全栈开发者需要在有限时间内完成一个复杂的市场调研任务，包括搜索最新行业数据、分析竞品报告并生成包含图表的 PDF 文档。\n\n### 没有 Mini-Agent 时\n- **上下文断裂**：在处理长周期任务时，模型容易遗忘早期的关键指令或已获取的数据，导致反复询问相同信息。\n- **工具链割裂**：开发者需手动切换搜索引擎、代码解释器和文档生成工具，无法形成自动化的执行闭环。\n- **调试困难**：当自动化脚本出错时，缺乏详细的执行日志，难以定位是网络问题、工具调用失败还是逻辑错误。\n- **技能复用性差**：每次生成专业报告都要重新编写提示词来规范格式，无法直接调用成熟的文档处理技能。\n\n### 使用 Mini-Agent 后\n- **记忆持久化**：借助 Session Note Tool，Mini-Agent 能跨会话保留关键调研数据，确保长任务中逻辑连贯不丢失。\n- **全流程自动化**：通过原生 MCP 集成，Mini-Agent 自动串联网页搜索、数据分析与文件操作，一键完成从采集到输出的闭环。\n- **透明化调试**：详尽的请求与工具执行日志让开发者能迅速定位问题根源，大幅降低排查成本。\n- **专业技能即插即用**：直接调用内置的 15 种 Claude Skills（如 PDF 生成），无需重复编写提示词即可输出高质量专业报告。\n\nMini-Agent 通过将碎片化的工具与记忆机制整合为统一的生产级代理，让开发者从繁琐的流程拼接中解放，专注于核心业务逻辑的创新。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FMiniMax-AI_Mini-Agent_7a859cc0.png","MiniMax-AI","MiniMax","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FMiniMax-AI_89eac755.jpg","Intelligence with Everyone",null,"model@minimax.io","MiniMax_AI","https:\u002F\u002Fwww.minimax.io","https:\u002F\u002Fgithub.com\u002FMiniMax-AI",[83,87,91,95,99],{"name":84,"color":85,"percentage":86},"Python","#3572A5",90.8,{"name":88,"color":89,"percentage":90},"JavaScript","#f1e05a",4.8,{"name":92,"color":93,"percentage":94},"HTML","#e34c26",2.2,{"name":96,"color":97,"percentage":98},"Shell","#89e051",1.6,{"name":100,"color":101,"percentage":102},"PowerShell","#012456",0.5,2439,354,"2026-04-17T15:11:57","MIT","Linux, macOS, Windows","未说明",{"notes":110,"python":111,"dependencies":112},"本项目为调用 MiniMax M2.5 API 的客户端工具，非本地运行大模型，因此无特定 GPU 或显存需求。必须安装 'uv' 作为包管理和运行环境工具。支持全球和中国两个 API 平台，需根据网络环境配置对应的 API Base 地址。可选集成 MCP 工具和 Claude Skills。","未说明 (需安装 uv 包管理器)",[113,114,115,116,117,118,119],"tiktoken","pyyaml","httpx","pydantic","requests","prompt-toolkit","mcp",[13,14,35],[122,123,124],"agent","llm","minimax","2026-03-27T02:49:30.150509","2026-04-18T09:19:38.705624",[128,133,138,143,148,153],{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},39434,"Agent 误删文件后去废纸篓查找是正常行为吗？遇到此类操作问题如何反馈？","此类具体操作行为或 Badcase 不属于 GitHub 代码库的直接 Issue 范畴。维护者建议将此类问题反馈至官方微信反馈群，会有专门同事跟进处理。GitHub Issue 主要用于代码缺陷和功能讨论，用户体验和具体 Agent 行为反馈请通过官方社群渠道进行。","https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent\u002Fissues\u002F50",{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},39429,"初始化 Anthropic 客户端时应该使用 api_key 还是 auth_token？遇到 401 错误怎么办？","应该使用 `auth_token` 而不是 `api_key`。如果遇到 401 错误，请修改 `mini_agent\u002Fllm\u002Fanthropic_client.py` 文件，将代码中的 \"api_key\" 替换为 \"auth_token\"。这是一个单行修改，保存后即可恢复正常。","https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent\u002Fissues\u002F28",{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},39430,"如何在运行中中断 mini-agent 而不丢失工作进度？","目前项目已支持通过按下 `Esc` 键来中断 mini-agent，而不再仅依赖 `Ctrl+C`（后者可能导致工作丢失）。请确保您使用的是最新版本的代码以享受此功能。","https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent\u002Fissues\u002F13",{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},39431,"Mini-Agent 支持 Windows 系统吗？如何在 Windows 上安装？","是的，最新版本已支持 Windows。安装步骤如下：\n1. 克隆仓库：`git clone https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent.git` 并进入目录。\n2. 安装 pipx（如未安装）：使用 `scoop install pipx` 然后运行 `pipx ensurepath`。\n3. （可选）初始化子模块：`git submodule update --init --recursive`。\n4. 复制配置文件：`cp mini_agent\u002Fconfig\u002Fconfig-example.yaml mini_agent\u002Fconfig\u002Fconfig.yaml`。\n5. 编辑配置文件填入相关信息。\n6. 以可编辑模式安装：`pipx install -e .`。\n7. 安装完成后即可在任何位置运行 `mini-agent` 或指定工作区 `mini-agent --workspace \u002Fpath\u002Fto\u002Fyour\u002Fproject`。","https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent\u002Fissues\u002F5",{"id":149,"question_zh":150,"answer_zh":151,"source_url":152},39432,"在哪里可以找到官方交流群以反馈问题或获取帮助？","官方提供了微信群用于交流和支持。您可以在项目的 README 文件中找到微信群的二维码，扫描加入后即可在群内反馈问题或提出建议。","https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent\u002Fissues\u002F47",{"id":154,"question_zh":155,"answer_zh":156,"source_url":157},39433,"为什么所有技能（skills）都会加载到系统提示中导致消耗大量 Token？有优化方案吗？","当前实现为了便于学习和理解核心概念，采用了启动时注入所有技能的方式。虽然“即时加载”（Just-in-Time）策略能有效减少 Token 消耗并支持更大规模的技能库，但本项目主要定位为教育演示 Demo，因此保持了当前的简单实现。如果您需要该优化，欢迎提交 Pull Request 贡献代码。","https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent\u002Fissues\u002F46",[]]