[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-Doriandarko--o1-engineer":3,"tool-Doriandarko--o1-engineer":61},[4,18,26,36,44,53],{"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 真正成长为懂上",144730,2,"2026-04-07T23:26:32",[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":32,"last_commit_at":50,"category_tags":51,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"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":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":77,"owner_email":78,"owner_twitter":79,"owner_website":80,"owner_url":81,"languages":82,"stars":87,"forks":88,"last_commit_at":89,"license":77,"difficulty_score":32,"env_os":90,"env_gpu":91,"env_ram":90,"env_deps":92,"category_tags":97,"github_topics":77,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":98,"updated_at":99,"faqs":100,"releases":130},5289,"Doriandarko\u002Fo1-engineer","o1-engineer","o1-engineer is a command-line tool designed to assist developers in managing and interacting with their projects efficiently. Leveraging the power of OpenAI's API, this tool provides functionalities such as code generation, file editing, and project planning to streamline your development workflow.","o1-engineer 是一款专为开发者打造的命令行助手，旨在通过人工智能技术简化项目管理与代码开发流程。它深度集成 OpenAI API（并新增支持 Grok 模型），能够理解自然语言指令，自动完成代码生成、文件编辑、项目规划及代码审查等复杂任务，有效解决了传统开发中重复性操作繁琐、项目结构梳理耗时等痛点。\n\n该工具特别适合希望提升编码效率的软件工程师、全栈开发者及技术团队使用。其核心亮点在于强大的上下文管理能力与交互式工作流：不仅支持对文件和文件夹进行灵活的增删改操作，还独创了\"\u002Fplanning\"命令，允许用户先制定宏观项目计划，再系统性地将规划转化为具体的目录结构与代码文件。此外，o1-engineer 具备流式输出、对话历史保存及丰富的文本交互界面，让开发者能在终端内获得连贯、清晰的智能辅助体验。只需简单配置 API 密钥，即可将 AI 能力无缝融入日常开发环节，让项目构建与维护变得更加直观高效。","# 🛠️ o1-engineer\n\n![Updated Features](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FFeatures-Updated-brightgreen)\n\nA command-line tool designed to assist developers in managing and interacting with their projects efficiently. Leveraging the power of OpenAI's API, o1-engineer provides functionalities such as code generation, file editing, project planning, and code review to streamline your development workflow.\n\n## NEW\n\nAdded Grok Engineer to the repo. Make sure you add your XAI_API_KEY in your .env file.\nAdded Streaming.\n\n## 🛠️ Updated Features\n\n- **Enhanced File and Folder Management**: The `\u002Fadd` and `\u002Fedit` commands now support adding and modifying both files and folders, providing greater flexibility in managing your project structure.\n- **Project Planning**: Introducing the `\u002Fplanning` command, which allows users to create comprehensive project plans that can be used to generate files and directories systematically.\n- **Advanced Workflows**: New examples demonstrate how to integrate planning and creation commands for efficient project setup.\n\n## ✨ Features\n\n- **Automated Code Generation**: Generate code for your projects effortlessly.\n\n- **File Management**: Add, edit, and manage project files directly from the command line.\n\n- **Interactive Console**: User-friendly interface with rich text support for enhanced readability.\n\n- **Conversation History**: Save and reset conversation histories as needed.\n\n- **Code Review**: Analyze and review code files for quality and suggestions.\n\n- **Enhanced File and Folder Management**: The `\u002Fadd` and `\u002Fedit` commands now support adding and modifying both files and folders, providing greater flexibility in managing your project structure.\n\n- **Project Planning**: Introducing the `\u002Fplanning` command, which allows users to create comprehensive project plans that can be used to generate files and directories systematically.\n\n## 💡 How the Script Works\n\n1. **Initialization**: The script initializes global variables and sets up the OpenAI client using the provided API key.\n\n2. **Handling User Commands**: It listens for user commands such as `\u002Fedit`, `\u002Fcreate`, `\u002Fadd`, `\u002Freview`, and the new `\u002Fplanning` command, processing them accordingly.\n\n3. **Processing File and Folder Modifications**: Based on the user's instructions, the script modifies files and folders, adds new content, or creates new files and folders as needed. The `\u002Fadd` and `\u002Fedit` commands have been enhanced to support both files and folders, providing greater flexibility in project management.\n\n4. **Project Planning**: The newly introduced `\u002Fplanning` command allows users to create comprehensive project plans, which the script can use to generate files and directories systematically using the `\u002Fcreate` command.\n\n5. **AI-Generated Instructions**: The tool interacts with OpenAI's API to generate instructions and suggestions for code generation, editing, project planning, and reviewing.\n\n6. **Applying Changes**: Changes are applied to the project files and folders based on the AI-generated instructions, ensuring that the project stays up-to-date and well-maintained.\n\n7. **Managing Conversation History and Added Files**: The script manages the conversation history and keeps track of files and folders added to the context, allowing users to reset or modify the history as needed.\n\n## 📥 Installation\n\n### Prerequisites\n\n- **Python**: Ensure you have Python 3.7 or higher installed. [Download Python](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)\n\n- **OpenAI API Key**: Obtain an API key from [OpenAI](https:\u002F\u002Fplatform.openai.com\u002F).\n\n### 🔧 Steps\n\n1. **Clone the Repository**:\n\n   ```bash\n   git clone https:\u002F\u002Fgithub.com\u002Fdoriandarko\u002Fo1-engineer.git\n   ```\n\n2. **Navigate to the Project Directory**:\n\n   ```bash\n   cd o1-engineer\n   ```\n\n3. **Install Dependencies**:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Configure APIs**:\n\n   Add your API key at the top of the script\n\n   ```\n   client = OpenAI(api_key=\"YOUR API\")\n   ```\n\n## 📚 Usage\n\nLaunch the application using the following command:\n\n```bash\npython o1-eng.py\n```\n\n### 🎮 Available Commands\n\n- `\u002Fedit`: Edit files or folders (followed by file or folder paths)\n\n- `\u002Fcreate`: Create files or folders (followed by instructions)\n\n- `\u002Fadd`: Add files or folders to context (followed by file or folder paths)\n\n- `\u002Fplanning`: Plan project structure and tasks (followed by instructions)\n\n- `\u002Fdebug`: Print the last AI response\n\n- `\u002Freset`: Reset chat context and clear added files\n\n- `\u002Freview`: Review and analyze code files for quality and potential improvements (followed by file or folder paths)\n\n- `\u002Fquit`: Exit the program\n\n### 🚀 Advanced Workflows\n\nHere's an example workflow that demonstrates using `\u002Fplanning` followed by `\u002Fcreate` to generate files based on the created plan:\n\n1. **Planning the Project**:\n\n   ```bash\n   You: \u002Fplanning Create a basic web application with the following structure:\n   \n   - A frontend folder containing HTML, CSS, and JavaScript files.\n   \n   - A backend folder with server-side scripts.\n   \n   - A README.md file with project documentation.\n   ```\n\n2. **Creating the Project Structure based on the Plan**:\n\n   ```bash\n   You: \u002Fcreate Generate the project structure based on the above plan.\n   ```\n\nThis demonstrates how to use the new `\u002Fplanning` command to define a project structure, and then `\u002Fcreate` to generate the files and folders accordingly.\n\n### 📝 Examples\n\n```bash\nYou: \u002Fadd src\u002Fmain.py src\u002Futils\u002Fhelper.py src\u002Fmodels\u002F\n\nYou: \u002Fplanning Outline a RESTful API project with separate folders for models, views, and controllers.\n\nYou: \u002Fcreate Set up the basic structure for a RESTful API project with models, views, and controllers folders, including initial files.\n\nYou: \u002Fedit src\u002Fmain.py src\u002Fmodels\u002Fuser.py src\u002Fviews\u002Fuser_view.py\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please follow these steps:\n\n1. Fork the repository.\n\n2. Create a new branch (`git checkout -b feature\u002FYourFeature`).\n\n3. Commit your changes (`git commit -m 'Add some feature'`).\n\n4. Push to the branch (`git push origin feature\u002FYourFeature`).\n\n5. Open a pull request.\n\n## 🙏 Acknowledgments\n\n- OpenAI for providing the powerful API.\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDoriandarko_o1-engineer_readme_a612c43f97bc.png)](https:\u002F\u002Fstar-history.com\u002F#Doriandarko\u002Fo1-engineer&Date)\n","# 🛠️ o1-engineer\n\n![更新的功能](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FFeatures-Updated-brightgreen)\n\n一款命令行工具，旨在帮助开发者高效地管理和交互他们的项目。o1-engineer 利用 OpenAI 的 API 功能，提供代码生成、文件编辑、项目规划和代码审查等功能，以简化您的开发工作流程。\n\n## 新增\n\n已在仓库中添加 Grok Engineer。请确保在您的 `.env` 文件中添加 `XAI_API_KEY`。\n新增了流式传输功能。\n\n## 🛠️ 更新的功能\n\n- **增强的文件和文件夹管理**：`\u002Fadd` 和 `\u002Fedit` 命令现在支持添加和修改文件及文件夹，从而在管理项目结构时提供更大的灵活性。\n- **项目规划**：引入了 `\u002Fplanning` 命令，允许用户创建全面的项目计划，这些计划可用于系统地生成文件和目录。\n- **高级工作流**：新的示例展示了如何集成规划和创建命令，以实现高效的项目设置。\n\n## ✨ 功能\n\n- **自动化代码生成**：轻松为您的项目生成代码。\n- **文件管理**：直接从命令行添加、编辑和管理项目文件。\n- **交互式控制台**：用户友好的界面，支持富文本，提升可读性。\n- **对话历史**：根据需要保存和重置对话历史。\n- **代码审查**：分析和审查代码文件的质量及改进建议。\n- **增强的文件和文件夹管理**：`\u002Fadd` 和 `\u002Fedit` 命令现在支持添加和修改文件及文件夹，从而在管理项目结构时提供更大的灵活性。\n- **项目规划**：引入了 `\u002Fplanning` 命令，允许用户创建全面的项目计划，这些计划可用于系统地使用 `\u002Fcreate` 命令生成文件和目录。\n\n## 💡 脚本的工作原理\n\n1. **初始化**：脚本初始化全局变量，并使用提供的 API 密钥设置 OpenAI 客户端。\n2. **处理用户命令**：它监听用户的命令，如 `\u002Fedit`、`\u002Fcreate`、`\u002Fadd`、`\u002Freview` 以及新的 `\u002Fplanning` 命令，并相应地进行处理。\n3. **处理文件和文件夹的修改**：根据用户的指示，脚本会修改文件和文件夹，添加新内容，或根据需要创建新的文件和文件夹。`\u002Fadd` 和 `\u002Fedit` 命令已增强，支持文件和文件夹的操作，从而在项目管理中提供更大的灵活性。\n4. **项目规划**：新引入的 `\u002Fplanning` 命令允许用户创建全面的项目计划，脚本可以使用该计划通过 `\u002Fcreate` 命令系统地生成文件和目录。\n5. **AI 生成的指令**：该工具与 OpenAI 的 API 交互，以生成代码生成、编辑、项目规划和审查的指令和建议。\n6. **应用更改**：根据 AI 生成的指令，将更改应用到项目文件和文件夹中，确保项目保持最新并得到良好维护。\n7. **管理对话历史和已添加的文件**：脚本管理对话历史，并跟踪已添加到上下文中的文件和文件夹，允许用户根据需要重置或修改历史。\n\n## 📥 安装\n\n### 先决条件\n\n- **Python**：确保已安装 Python 3.7 或更高版本。[下载 Python](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)\n- **OpenAI API 密钥**：从 [OpenAI](https:\u002F\u002Fplatform.openai.com\u002F) 获取 API 密钥。\n\n### 🔧 步骤\n\n1. **克隆仓库**：\n\n   ```bash\n   git clone https:\u002F\u002Fgithub.com\u002Fdoriandarko\u002Fo1-engineer.git\n   ```\n\n2. **进入项目目录**：\n\n   ```bash\n   cd o1-engineer\n   ```\n\n3. **安装依赖**：\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **配置 API**：\n\n   在脚本顶部添加您的 API 密钥\n\n   ```\n   client = OpenAI(api_key=\"YOUR API\")\n   ```\n\n## 📚 使用方法\n\n使用以下命令启动应用程序：\n\n```bash\npython o1-eng.py\n```\n\n### 🎮 可用命令\n\n- `\u002Fedit`：编辑文件或文件夹（后接文件或文件夹路径）\n- `\u002Fcreate`：创建文件或文件夹（后接指令）\n- `\u002Fadd`：将文件或文件夹添加到上下文中（后接文件或文件夹路径）\n- `\u002Fplanning`：规划项目结构和任务（后接指令）\n- `\u002Fdebug`：打印最近一次的 AI 响应\n- `\u002Freset`：重置聊天上下文并清除已添加的文件\n- `\u002Freview`：审查和分析代码文件的质量及潜在改进（后接文件或文件夹路径）\n- `\u002Fquit`：退出程序\n\n### 🚀 高级工作流\n\n以下是一个演示如何使用 `\u002Fplanning` 后接 `\u002Fcreate` 来根据所创建的计划生成文件的工作流程示例：\n\n1. **规划项目**：\n\n   ```bash\n   您：\u002Fplanning 创建一个基本的 Web 应用程序，其结构如下：\n   \n   - 前端文件夹，包含 HTML、CSS 和 JavaScript 文件。\n   \n   - 后端文件夹，包含服务器端脚本。\n   \n   - 一个 README.md 文件，用于项目文档。\n   ```\n\n2. **根据计划创建项目结构**：\n\n   ```bash\n   您：\u002Fcreate 根据上述计划生成项目结构。\n   ```\n\n这展示了如何使用新的 `\u002Fplanning` 命令定义项目结构，然后使用 `\u002Fcreate` 命令相应地生成文件和文件夹。\n\n### 📝 示例\n\n```bash\n您：\u002Fadd src\u002Fmain.py src\u002Futils\u002Fhelper.py src\u002Fmodels\u002F\n\n您：\u002Fplanning 概述一个 RESTful API 项目，其中模型、视图和控制器分别位于不同的文件夹中。\n\n您：\u002Fcreate 设置一个 RESTful API 项目的初步结构，包括模型、视图和控制器文件夹以及初始文件。\n\n您：\u002Fedit src\u002Fmain.py src\u002Fmodels\u002Fuser.py src\u002Fviews\u002Fuser_view.py\n```\n\n## 🤝 贡献\n\n我们欢迎贡献！请按照以下步骤操作：\n\n1. 分支仓库。\n2. 创建新分支 (`git checkout -b feature\u002FYourFeature`)。\n3. 提交更改 (`git commit -m '添加某项功能'`)。\n4. 推送到分支 (`git push origin feature\u002FYourFeature`)。\n5. 打开拉取请求。\n\n## 🙏 致谢\n\n- OpenAI 提供的强大 API。\n\n## 星标历史\n\n[![星标历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDoriandarko_o1-engineer_readme_a612c43f97bc.png)](https:\u002F\u002Fstar-history.com\u002F#Doriandarko\u002Fo1-engineer&Date)","# o1-engineer 快速上手指南\n\no1-engineer 是一款基于命令行的 AI 开发助手，利用 OpenAI API（及新增的 Grok\u002FXAI API）帮助开发者高效管理项目。它支持代码生成、文件编辑、项目规划、代码审查等功能，并能通过流式输出提供实时反馈。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：Windows \u002F macOS \u002F Linux\n*   **Python 版本**：Python 3.7 或更高版本\n    *   下载地址：[https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)\n    *   *国内用户建议*：安装时勾选 \"Add Python to PATH\"，或使用国内镜像源加速 pip 安装。\n*   **API 密钥**：\n    *   **OpenAI API Key**：用于核心功能（[获取地址](https:\u002F\u002Fplatform.openai.com\u002F)）\n    *   **XAI API Key**（可选）：如需使用新增的 Grok Engineer 功能，需准备 XAI 密钥。\n\n## 安装步骤\n\n### 1. 克隆仓库\n打开终端（Terminal 或 CMD），执行以下命令下载项目：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fdoriandarko\u002Fo1-engineer.git\n```\n\n> **提示**：如果下载速度慢，可使用国内镜像加速：\n> `git clone https:\u002F\u002Fgitee.com\u002Fmirror\u002Fgithub-doriandarko-o1-engineer.git` (需确认是否有对应镜像) 或使用代理。\n\n### 2. 进入项目目录\n\n```bash\ncd o1-engineer\n```\n\n### 3. 安装依赖\n使用 pip 安装所需库。**国内用户强烈建议使用清华或阿里镜像源**以加快下载速度：\n\n```bash\npip install -r requirements.txt -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n```\n\n### 4. 配置 API 密钥\n使用文本编辑器打开主脚本文件 `o1-eng.py`，找到初始化 client 的部分，将 `\"YOUR API\"` 替换为您的实际密钥。\n\n**对于 OpenAI：**\n```python\nclient = OpenAI(api_key=\"sk-你的 OpenAI API Key\")\n```\n\n**对于 Grok (如需使用)：**\n请确保在项目根目录创建 `.env` 文件，并添加：\n```text\nXAI_API_KEY=你的 XAI API Key\n```\n\n## 基本使用\n\n### 启动工具\n在终端中运行以下命令启动交互式控制台：\n\n```bash\npython o1-eng.py\n```\n\n启动后，您将进入一个支持富文本显示的交互界面。\n\n### 常用命令示例\n\n以下是几个最核心的操作示例，帮助您快速上手：\n\n#### 1. 项目规划 (`\u002Fplanning`)\n让 AI 为您生成详细的项目结构和任务计划。\n\n```text\nYou: \u002Fplanning 创建一个基础的 Web 应用，包含前端文件夹（HTML\u002FCSS\u002FJS）、后端文件夹和 README 文档。\n```\n\n#### 2. 基于计划生成文件 (`\u002Fcreate`)\n根据上一步生成的计划，自动创建对应的文件和目录结构。\n\n```text\nYou: \u002Fcreate 根据上述计划生成项目结构。\n```\n\n#### 3. 添加文件到上下文 (`\u002Fadd`)\n将现有文件加入对话上下文，以便 AI 了解当前项目状态。\n\n```text\nYou: \u002Fadd src\u002Fmain.py src\u002Futils\u002F\n```\n\n#### 4. 编辑文件或文件夹 (`\u002Fedit`)\n指示 AI 修改指定文件或文件夹的内容。\n\n```text\nYou: \u002Fedit src\u002Fmain.py 添加用户登录功能的代码逻辑。\n```\n\n#### 5. 代码审查 (`\u002Freview`)\n分析代码质量并提供改进建议。\n\n```text\nYou: \u002Freview src\u002Fmodels\u002Fuser.py\n```\n\n#### 6. 其他控制命令\n*   `\u002Freset`：重置聊天上下文并清除已添加的文件记录。\n*   `\u002Fdebug`：打印最后一次 AI 的原始响应内容。\n*   `\u002Fquit`：退出程序。\n\n### 进阶工作流示例\n结合规划与生成命令，实现自动化项目搭建：\n\n1.  **定义需求**：\n    ```text\n    You: \u002Fplanning 设计一个 RESTful API 项目，分离 models, views, controllers 文件夹。\n    ```\n2.  **执行生成**：\n    ```text\n    You: \u002Fcreate 基于上述规划，初始化包含基础文件的目录结构。\n    ```\n\n现在您可以开始使用 o1-engineer 提升您的开发效率了！","资深后端工程师李明正负责从零搭建一个高并发的微服务订单系统，需要在两天内完成基础架构搭建与核心代码编写。\n\n### 没有 o1-engineer 时\n- **手动规划耗时**：需花费数小时在白板或文档中梳理目录结构、模块依赖及接口定义，容易遗漏细节。\n- **重复样板代码**：必须逐个创建数十个空文件和文件夹，并手动编写大量重复的 CRUD 样板代码，效率低下。\n- **上下文切换频繁**：在 IDE、终端和浏览器之间反复跳转以查阅文档或执行命令，打断开发心流。\n- **代码审查滞后**：只能在功能完成后统一进行代码走查，难以在编写过程中实时发现潜在逻辑漏洞或规范问题。\n\n### 使用 o1-engineer 后\n- **一键生成规划**：通过 `\u002Fplanning` 命令，o1-engineer 瞬间输出完整的项目蓝图，自动定义好所有目录层级与文件清单。\n- **自动化构建骨架**：利用 `\u002Fcreate` 和增强的 `\u002Fadd` 命令，o1-engineer 直接生成整个项目文件夹结构及包含业务逻辑的初始代码文件。\n- **终端沉浸式开发**：李明只需在命令行中与 o1-engineer 对话，即可实时完成文件编辑、代码生成与指令执行，无需离开终端。\n- **实时智能评审**：随时调用 `\u002Freview` 命令，o1-engineer 即时分析当前代码质量并提供优化建议，将缺陷拦截在编码阶段。\n\no1-engineer 将原本繁琐的项目初始化与编码流程转化为自然的语言交互，让开发者从机械劳动中解放，专注于核心业务逻辑的创新。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDoriandarko_o1-engineer_d3321ce1.png","Doriandarko","Pietro Schirano","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FDoriandarko_7146aa01.jpg","Passionate AI engineer on a mission to democratize AI tools.\r\n\r\nFounder at MagicPath 🎨✨\r\n\r\nmagicpath.ai","MagicPath",null,"pietro.schirano@gmail.com","skirano","magicpath.ai","https:\u002F\u002Fgithub.com\u002FDoriandarko",[83],{"name":84,"color":85,"percentage":86},"Python","#3572A5",100,2855,283,"2026-04-07T10:37:00","未说明","不需要",{"notes":93,"python":94,"dependencies":95},"该工具是基于命令行的辅助开发工具，通过调用 OpenAI API（或新增的 XAI API）运行，无需本地部署大模型，因此无 GPU 和特殊内存需求。用户需在 .env 文件或脚本中配置有效的 API Key 方可使用。","3.7+",[96],"openai",[35,13,52],"2026-03-27T02:49:30.150509","2026-04-08T09:17:53.876212",[101,106,111,116,121,125],{"id":102,"question_zh":103,"answer_zh":104,"source_url":105},23976,"运行程序时出现 'Completions.create() got an unexpected keyword argument max_completion_tokens' 错误怎么办？","这是因为您的 OpenAI Python 包版本过旧，不支持当前的参数。请运行以下命令升级包：\npip install --upgrade openai\n升级后问题通常即可解决。","https:\u002F\u002Fgithub.com\u002FDoriandarko\u002Fo1-engineer\u002Fissues\u002F12",{"id":107,"question_zh":108,"answer_zh":109,"source_url":110},23977,"遇到 'The model o1-mini does not exist or you do not have access to it' (404 错误) 是什么原因？","这通常是因为您的 OpenAI API 账户层级（Tier）不够。目前 o1 系列模型仅对 Tier 3 及以上的用户开放。如果您使用的是 Tier 1 账户，需要升级账户层级才能访问该模型。","https:\u002F\u002Fgithub.com\u002FDoriandarko\u002Fo1-engineer\u002Fissues\u002F14",{"id":112,"question_zh":113,"answer_zh":114,"source_url":115},23978,"处理大型项目时提示 'context_length_exceeded' 或令牌数超出限制怎么办？","模型的上下文长度限制为 128,000 个令牌。当输入内容超过此限制时会报错。解决方法包括：\n1. 减少发送的消息内容长度；\n2. 将大型代码库或数据集拆分为较小的块分批处理；\n3. 总结或过滤掉输入中不必要的细节以降低令牌数量。","https:\u002F\u002Fgithub.com\u002FDoriandarko\u002Fo1-engineer\u002Fissues\u002F15",{"id":117,"question_zh":118,"answer_zh":119,"source_url":120},23979,"OpenAI o1 模型对 API 用户有什么层级要求？","OpenAI 目前仅允许 Tier 3 及以上的重度用户（付费用户）通过 API 访问 o1 系列模型。普通用户（如 Tier 1）无法直接使用，会收到模型不存在或无权访问的错误。","https:\u002F\u002Fgithub.com\u002FDoriandarko\u002Fo1-engineer\u002Fissues\u002F8",{"id":122,"question_zh":123,"answer_zh":124,"source_url":105},23980,"在 Mac M1 芯片上运行程序是否有特殊注意事项？","在 Mac M1 上运行时遇到的大部分错误（如参数错误）通常与 OpenAI 包版本有关，而非架构问题。请确保执行 'pip install --upgrade openai' 更新依赖。此外，有用户反馈代码在常规 Mac 终端中可能运行不佳，建议使用 Visual Studio Code 来运行该项目。",{"id":126,"question_zh":127,"answer_zh":128,"source_url":129},23981,"为什么我已经更新了包，但仍然收到模型访问相关的错误？","如果更新包后仍报错，请检查错误具体信息。如果是 'max_completion_tokens' 相关错误，请再次确认包已最新；如果是 'model_not_found' (404)，则说明是账户权限问题（需 Tier 3+），与包版本无关。另外，确保您使用的模型名称正确，且您的 API Key 拥有对应模型的访问权限。","https:\u002F\u002Fgithub.com\u002FDoriandarko\u002Fo1-engineer\u002Fissues\u002F18",[]]