[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-xindoo--agentic-design-patterns":3,"tool-xindoo--agentic-design-patterns":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 真正成长为懂上",152630,2,"2026-04-12T23:33: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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[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},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",[52,13,15,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":75,"owner_location":76,"owner_email":75,"owner_twitter":77,"owner_website":78,"owner_url":79,"languages":80,"stars":89,"forks":90,"last_commit_at":91,"license":75,"difficulty_score":92,"env_os":93,"env_gpu":94,"env_ram":94,"env_deps":95,"category_tags":98,"github_topics":75,"view_count":32,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":99,"updated_at":100,"faqs":101,"releases":142},7051,"xindoo\u002Fagentic-design-patterns","agentic-design-patterns","谷歌新书Agent设计模式(agentic design patterns)最佳中文版，持续优化。附：在线阅读、pdf和epub电子书下载。 ","agentic-design-patterns 是谷歌新书《Agentic Design Patterns》的开源中文翻译项目，旨在为中文开发者提供一套系统化的 AI 智能体（Agent）构建指南。随着大模型应用从简单对话转向复杂任务执行，如何设计稳定、高效且具备自主能力的智能体成为技术难点。本书通过拆解 21 个核心设计模式，从基础的提示链、路由、并行化，到进阶的反思、规划、工具使用，再到多智能体协作、记忆管理及安全防护等高级议题，全方位覆盖了智能体系统的关键架构要素。\n\n该项目不仅提供了高质量的中文译文，还附带在线阅读及多种电子书格式下载，极大降低了国内技术人员的学习门槛。无论是希望深入理解 Agent 底层逻辑的算法研究人员，还是需要落地复杂 AI 应用的软件工程师，亦或是关注人机协同与系统评估的产品设计师，都能从中获得极具价值的实践参考。其独特的亮点在于将抽象的理论转化为具体的工程模式，并补充了关于模型上下文协议（MCP）、异常恢复及资源优化等前沿实战内容，帮助开发者避开常见陷阱，构建更可靠的智能系统。","![封面图](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fxindoo_agentic-design-patterns_readme_c0ff78895c4e.png)\n\n# Agentic Design Patterns（中文翻译项目）\n\n## 👨‍💻 关于xindoo\n\n**xindoo** - 本翻译项目的发起者和主要维护者\n\n- **GitHub**: [xindoo](https:\u002F\u002Fgithub.com\u002Fxindoo)\n- **个人网站**: [zxs.io](https:\u002F\u002Fzxs.io)\n- **博客**：[xindoo](https:\u002F\u002Fblog.csdn.net\u002Fxindoo)\n- **个人简介**: 热衷于技术分享和开源贡献的开发者，专注于 AI 技术、系统架构、职业发展。 \n\n## 📚 项目简介\n\n本项目是《Agentic Design Patterns》一书的中文翻译项目。该书系统介绍了 AI Agent 系统的各种设计模式，涵盖从基础到高级的 21 个核心模式，以及多个附录章节。\n\n## 🎯 关于本书\n\n《Agentic Design Patterns》探讨了构建智能 AI Agent 系统的核心设计模式，包括：\n- 提示链、路由、并行化等基础模式\n- 反思、工具使用、规划等进阶模式\n- 多智能体协作、记忆管理、知识检索等高级模式\n- 安全防护、评估监控等实践模式\n\n## 📖 目录结构\n\n### 核心章节\n\n1. [第1章：提示链（Prompt Chaining）](chapters\u002FChapter%201_%20Prompt%20Chaining.md)\n2. [第2章：路由（Routing）](chapters\u002FChapter%202_%20Routing.md)\n3. [第3章：并行化（Parallelization）](chapters\u002FChapter%203_%20Parallelization.md)\n4. [第4章：反思（Reflection）](chapters\u002FChapter%204_%20Reflection.md)\n5. [第5章：工具使用（Tool Use）](chapters\u002FChapter%205_%20Tool%20Use.md)\n6. [第6章：规划（Planning）](chapters\u002FChapter%206_%20Planning.md)\n7. [第7章：多智能体协作（Multi-Agent Collaboration）](chapters\u002FChapter%207_%20Multi-Agent%20Collaboration.md)\n8. [第8章：记忆管理（Memory Management）](chapters\u002FChapter%208_%20Memory%20Management.md)\n9. [第9章：学习与适应（Learning and Adaptation）](chapters\u002FChapter%209_%20Learning%20and%20Adaptation.md)\n10. [第10章：模型上下文协议（Model Context Protocol）](chapters\u002FChapter%2010_%20Model%20Context%20Protocol%20(MCP).md)\n11. [第11章：目标设定与监控（Goal Setting and Monitoring）](chapters\u002FChapter%2011_%20Goal%20Setting%20and%20Monitoring.md)\n12. [第12章：异常处理与恢复（Exception Handling and Recovery）](chapters\u002FChapter%2012_%20Exception%20Handling%20and%20Recovery.md)\n13. [第13章：人机协同（Human-in-the-Loop）](chapters\u002FChapter%2013_%20Human-in-the-Loop.md)\n14. [第14章：知识检索（Knowledge Retrieval - RAG）](chapters\u002FChapter%2014_%20Knowledge%20Retrieval%20(RAG).md)\n15. [第15章：智能体间通信（Inter-Agent Communication - A2A）](chapters\u002FChapter%2015_%20Inter-Agent%20Communication%20(A2A).md)\n16. [第16章：资源感知优化（Resource-Aware Optimization）](chapters\u002FChapter%2016_%20Resource-Aware%20Optimization.md)\n17. [第17章：推理技术（Reasoning Techniques）](chapters\u002FChapter%2017_%20Reasoning%20Techniques.md)\n18. [第18章：安全防护模式（Guardrails\u002FSafety Patterns）](chapters\u002FChapter%2018_%20Guardrails_Safety%20Patterns.md)\n19. [第19章：评估与监控（Evaluation and Monitoring）](chapters\u002FChapter%2019_%20Evaluation%20and%20Monitoring.md)\n20. [第20章：优先级排序（Prioritization）](chapters\u002FChapter%2020_%20Prioritization.md)\n21. [第21章：探索与发现（Exploration and Discovery）](chapters\u002FChapter%2021_%20Exploration%20and%20Discovery.md)\n\n### 附录章节\n\n- [附录A：高级提示技术](chapters\u002FAppendix%20A_%20Advanced%20Prompting%20Techniques.md)\n- [附录B：AI 智能体交互：从 GUI 到真实世界环境](chapters\u002FAppendix%20B%20-%20AI%20Agentic%20Interactions_%20From%20GUI%20to%20Real%20world%20environment.md)\n- [附录C：智能体框架快速概览](chapters\u002FAppendix%20C%20-%20Quick%20overview%20of%20Agentic%20Frameworks.md)\n- [附录D：使用 AgentSpace 构建智能体（仅在线）](chapters\u002FAppendix%20D%20-%20Building%20an%20Agent%20with%20AgentSpace%20(on-line%20only).md)\n- [附录E：命令行上的 AI 智能体](chapters\u002FAppendix%20E%20-%20AI%20Agents%20on%20the%20CLI.md)\n- [附录F：深入探究：智能体推理引擎内部机制](chapters\u002FAppendix%20F%20%20-%20Under%20the%20Hood_%20An%20Inside%20Look%20at%20the%20Agents'%20Reasoning%20Engines.md)\n- [附录G：编程智能体](chapters\u002FAppendix%20G%20-%20%20Coding%20agents.md)\n\n### 其他内容\n\n- [常见问题解答](chapters\u002FFrequently%20Asked%20Questions_%20Agentic%20Design%20Patterns.md)\n- [术语表](chapters\u002FGlossary.md)\n- [术语索引](chapters\u002FIndex%20of%20Terms.md)\n- [总结](chapters\u002FConclusion.md)\n\n## 📁 项目结构\n\n```\nagentic-design-patterns\u002F\n├── README.md                    # 项目说明文档（本文件）\n├── SUMMARY.md                   # GitBook 目录文件\n├── CONTRIBUTING.md              # 贡献指南\n├── translation-guide.md         # 翻译规范指南\n├── progress.md                  # 翻译进度追踪\n├── glossary.md                  # 术语对照表\n├── PROJECT_STRUCTURE.md         # 项目结构说明\n├── _config.yml                  # Jekyll 配置文件\n├── Gemfile                      # Ruby 依赖管理\n├── CNAME                        # 自定义域名配置\n├── chapters\u002F                    # 翻译后的章节目录\n│   ├── README.md                # 章节说明\n│   ├── Agentic Design Patterns.md\n│   ├── Chapter 1_ Prompt Chaining.md\n│   ├── Chapter 2_ Routing.md\n│   └── ...                      # 其他章节和附录\n├── original\u002F                    # 原文备份目录\n│   ├── Agentic Design Patterns.md\n│   ├── Chapter 1_ Prompt Chaining.md\n│   ├── Chapter 2_ Routing.md\n│   └── ...                      # 其他原文章节\n├── images\u002F                      # 图片资源目录\n│   ├── README.md                # 图片目录说明\n│   ├── cover.png                # 封面图片\n│   ├── chapter-1\u002F               # 第1章图片\n│   ├── chapter-2\u002F               # 第2章图片\n│   └── ...                      # 其他章节图片\n├── _includes\u002F                   # Jekyll 包含文件\n│   ├── navigation.html          # 导航菜单\n│   └── navigation-en.html       # 英文导航菜单\n└── _layouts\u002F                    # Jekyll 布局文件\n    └── default.html             # 默认布局模板\n```\n\n## 🌐 在线访问\n\n本项目已部署到 GitHub Pages，可以在线阅读：\n\n**访问地址：** [https:\u002F\u002Fadp.xindoo.xyz\u002F](https:\u002F\u002Fadp.xindoo.xyz\u002F)\n\n\n## 📊 翻译进度\n\n根据 [progress.md](progress.md) 的统计，所有 32 个文件（21个核心章节 + 7个附录 + 4个其他内容）已经完成初步翻译，目前处于待审核状态。\n\n**当前状态：**\n- ✅ 已完成翻译：32\u002F32\n- 🔄 待审核：32\u002F32\n- 📝 已审核完成：0\u002F32\n\n查看详细翻译进度请参考 [progress.md](progress.md)\n\n## 🤝 如何贡献\n\n我们欢迎任何形式的贡献！参与方式：\n\n1. **Fork 本仓库**\n2. **创建特性分支** (`git checkout -b feature\u002Ftranslate-chapter-xx`)\n3. **提交更改** (`git commit -am '完成第XX章翻译'`)\n4. **推送分支** (`git push origin feature\u002Ftranslate-chapter-xx`)\n5. **创建 Pull Request**\n\n详细贡献指南请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## 📝 翻译规范\n\n在开始翻译前，请仔细阅读 [translation-guide.md](translation-guide.md)，主要规范包括：\n\n- **保持原文结构**：段落、标题层级保持一致\n- **术语统一**：参考 [glossary.md](glossary.md) 中的术语对照表\n- **代码保持原样**：代码示例、命令行等保持英文\n- **图片路径**：确保图片引用路径正确指向 `images\u002F` 目录\n- **格式规范**：遵循 Markdown 格式规范\n- **校对审核**：提交前进行自我校对\n\n**注意**：所有翻译文件已初步完成，当前主要任务是进行二次审核和质量检查。\n\n## 📚 相关资源\n\n- [术语对照表](glossary.md) - 统一的技术术语翻译\n- [翻译指南](translation-guide.md) - 详细的翻译规范和注意事项\n- [项目结构说明](PROJECT_STRUCTURE.md) - 项目文件组织说明\n- [GitBook 目录](SUMMARY.md) - 在线书籍的完整目录结构\n- [Jekyll 配置](_config.yml) - GitHub Pages 网站配置\n- [翻译进度追踪](progress.md) - 实时更新翻译状态\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fxindoo_agentic-design-patterns_readme_3a95edd2668b.png)](https:\u002F\u002Fgithub.com\u002Fxindoo\u002Fagentic-design-patterns)\n\n## 📄 许可证\n\n本翻译项目遵循原书的许可证条款。翻译内容仅供学习交流使用。\n\n## 联系我们\n邮箱: ixindoo@gmail.com  \n个人网站: [https:\u002F\u002Fzxs.io\u002F](https:\u002F\u002Fzxs.io\u002F)\n\n---\n\n**注意**：本项目为学习交流目的的翻译项目，如有版权问题请联系处理。","![封面图](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fxindoo_agentic-design-patterns_readme_c0ff78895c4e.png)\n\n# Agentic Design Patterns（中文翻译项目）\n\n## 👨‍💻 关于xindoo\n\n**xindoo** - 本翻译项目的发起者和主要维护者\n\n- **GitHub**: [xindoo](https:\u002F\u002Fgithub.com\u002Fxindoo)\n- **个人网站**: [zxs.io](https:\u002F\u002Fzxs.io)\n- **博客**：[xindoo](https:\u002F\u002Fblog.csdn.net\u002Fxindoo)\n- **个人简介**: 热衷于技术分享和开源贡献的开发者，专注于 AI 技术、系统架构、职业发展。 \n\n## 📚 项目简介\n\n本项目是《Agentic Design Patterns》一书的中文翻译项目。该书系统介绍了 AI Agent 系统的各种设计模式，涵盖从基础到高级的 21 个核心模式，以及多个附录章节。\n\n## 🎯 关于本书\n\n《Agentic Design Patterns》探讨了构建智能 AI Agent 系统的核心设计模式，包括：\n- 提示链、路由、并行化等基础模式\n- 反思、工具使用、规划等进阶模式\n- 多智能体协作、记忆管理、知识检索等高级模式\n- 安全防护、评估监控等实践模式\n\n## 📖 目录结构\n\n### 核心章节\n\n1. [第1章：提示链（Prompt Chaining）](chapters\u002FChapter%201_%20Prompt%20Chaining.md)\n2. [第2章：路由（Routing）](chapters\u002FChapter%202_%20Routing.md)\n3. [第3章：并行化（Parallelization）](chapters\u002FChapter%203_%20Parallelization.md)\n4. [第4章：反思（Reflection）](chapters\u002FChapter%204_%20Reflection.md)\n5. [第5章：工具使用（Tool Use）](chapters\u002FChapter%205_%20Tool%20Use.md)\n6. [第6章：规划（Planning）](chapters\u002FChapter%206_%20Planning.md)\n7. [第7章：多智能体协作（Multi-Agent Collaboration）](chapters\u002FChapter%207_%20Multi-Agent%20Collaboration.md)\n8. [第8章：记忆管理（Memory Management）](chapters\u002FChapter%208_%20Memory%20Management.md)\n9. [第9章：学习与适应（Learning and Adaptation）](chapters\u002FChapter%209_%20Learning%20and%20Adaptation.md)\n10. [第10章：模型上下文协议（Model Context Protocol）](chapters\u002FChapter%2010_%20Model%20Context%20Protocol%20(MCP).md)\n11. [第11章：目标设定与监控（Goal Setting and Monitoring）](chapters\u002FChapter%2011_%20Goal%20Setting%20and%20Monitoring.md)\n12. [第12章：异常处理与恢复（Exception Handling and Recovery）](chapters\u002FChapter%2012_%20Exception%20Handling%20and%20Recovery.md)\n13. [第13章：人机协同（Human-in-the-Loop）](chapters\u002FChapter%2013_%20Human-in-the-Loop.md)\n14. [第14章：知识检索（Knowledge Retrieval - RAG）](chapters\u002FChapter%2014_%20Knowledge%20Retrieval%20(RAG).md)\n15. [第15章：智能体间通信（Inter-Agent Communication - A2A）](chapters\u002FChapter%2015_%20Inter-Agent%20Communication%20(A2A).md)\n16. [第16章：资源感知优化（Resource-Aware Optimization）](chapters\u002FChapter%2016_%20Resource-Aware%20Optimization.md)\n17. [第17章：推理技术（Reasoning Techniques）](chapters\u002FChapter%2017_%20Reasoning%20Techniques.md)\n18. [第18章：安全防护模式（Guardrails\u002FSafety Patterns）](chapters\u002FChapter%2018_%20Guardrails_Safety%20Patterns.md)\n19. [第19章：评估与监控（Evaluation and Monitoring）](chapters\u002FChapter%2019_%20Evaluation%20and%20Monitoring.md)\n20. [第20章：优先级排序（Prioritization）](chapters\u002FChapter%2020_%20Prioritization.md)\n21. [第21章：探索与发现（Exploration and Discovery）](chapters\u002FChapter%2021_%20Exploration%20and%20Discovery.md)\n\n### 附录章节\n\n- [附录A：高级提示技术](chapters\u002FAppendix%20A_%20Advanced%20Prompting%20Techniques.md)\n- [附录B：AI 智能体交互：从 GUI 到真实世界环境](chapters\u002FAppendix%20B%20-%20AI%20Agentic%20Interactions_%20From%20GUI%20to%20Real%20world%20environment.md)\n- [附录C：智能体框架快速概览](chapters\u002FAppendix%20C%20-%20Quick%20overview%20of%20Agentic%20Frameworks.md)\n- [附录D：使用 AgentSpace 构建智能体（仅在线）](chapters\u002FAppendix%20D%20-%20Building%20an%20Agent%20with%20AgentSpace%20(on-line%20only).md)\n- [附录E：命令行上的 AI 智能体](chapters\u002FAppendix%20E%20-%20AI%20Agents%20on%20the%20CLI.md)\n- [附录F：深入探究：智能体推理引擎内部机制](chapters\u002FAppendix%20F%20%20-%20Under%20the%20Hood_%20An%20Inside%20Look%20at%20the%20Agents'%20Reasoning%20Engines.md)\n- [附录G：编程智能体](chapters\u002FAppendix%20G%20-%20%20Coding%20agents.md)\n\n### 其他内容\n\n- [常见问题解答](chapters\u002FFrequently%20Asked%20Questions_%20Agentic%20Design%20Patterns.md)\n- [术语表](chapters\u002FGlossary.md)\n- [术语索引](chapters\u002FIndex%20of%20Terms.md)\n- [总结](chapters\u002FConclusion.md)\n\n## 📁 项目结构\n\n```\nagentic-design-patterns\u002F\n├── README.md                    # 项目说明文档（本文件）\n├── SUMMARY.md                   # GitBook 目录文件\n├── CONTRIBUTING.md              # 贡献指南\n├── translation-guide.md         # 翻译规范指南\n├── progress.md                  # 翻译进度追踪\n├── glossary.md                  # 术语对照表\n├── PROJECT_STRUCTURE.md         # 项目结构说明\n├── _config.yml                  # Jekyll 配置文件\n├── Gemfile                      # Ruby 依赖管理\n├── CNAME                        # 自定义域名配置\n├── chapters\u002F                    # 翻译后的章节目录\n│   ├── README.md                # 章节说明\n│   ├── Agentic Design Patterns.md\n│   ├── Chapter 1_ Prompt Chaining.md\n│   ├── Chapter 2_ Routing.md\n│   └ой ...                      # 其他章节和附录\n├── original\u002F                    # 原文备份目录\n│   ├── Agentic Design Patterns.md\n│   ├── Chapter 1_ Prompt Chaining.md\n│   ├── Chapter 2_ Routing.md\n│   └ой ...                      # 其他原文章节\n├── images\u002F                      # 图片资源目录\n│   ├── README.md                # 图片目录说明\n│   ├── cover.png                # 封面图片\n│   ├── chapter-1\u002F               # 第1章图片\n│   ├── chapter-2\u002F               # 第2章图片\n│   └ой ...                      # 其他章节图片\n├── _includes\u002F                   # Jekyll 包含文件\n│   ├── navigation.html          # 导航菜单\n│   └oy navigation-en.html       # 英文导航菜单\n└oy _layouts\u002F                    # Jekyll 布局文件\n    └ой default.html             # 默认布局模板\n```\n\n## 🌐 在线访问\n\n本项目已部署到 GitHub Pages，可以在线阅读：\n\n**访问地址：** [https:\u002F\u002Fadp.xindoo.xyz\u002F](https:\u002F\u002Fadp.xindoo.xyz\u002F)\n\n\n## 📊 翻译进度\n\n根据 [progress.md](progress.md) 的统计，所有 32 个文件（21个核心章节 + 7个附录 + 4个其他内容）已经完成初步翻译，目前处于待审核状态。\n\n**当前状态：**\n- ✅ 已完成翻译：32\u002F32\n- 🔄 待审核：32\u002F32\n- 📝 已审核完成：0\u002F32\n\n查看详细翻译进度请参考 [progress.md](progress.md)\n\n## 🤝 如何贡献\n\n我们欢迎任何形式的贡献！参与方式：\n\n1. **Fork 本仓库**\n2. **创建特性分支** (`git checkout -b feature\u002Ftranslate-chapter-xx`)\n3. **提交更改** (`git commit -am '完成第XX章翻译'`)\n4. **推送分支** (`git push origin feature\u002Ftranslate-chapter-xx`)\n5. **创建 Pull Request**\n\n详细贡献指南请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## 📝 翻译规范\n\n在开始翻译前，请仔细阅读 [translation-guide.md](translation-guide.md)，主要规范包括：\n\n- **保持原文结构**：段落、标题层级保持一致\n- **术语统一**：参考 [glossary.md](glossary.md) 中的术语对照表\n- **代码保持原样**：代码示例、命令行等保持英文\n- **图片路径**：确保图片引用路径正确指向 `images\u002F` 目录\n- **格式规范**：遵循 Markdown 格式规范\n- **校对审核**：提交前进行自我校对\n\n**注意**：所有翻译文件已初步完成，当前主要任务是进行二次审核和质量检查。\n\n## 📚 相关资源\n\n- [术语对照表](glossary.md) - 统一的技术术语翻译\n- [翻译指南](translation-guide.md) - 详细的翻译规范和注意事项\n- [项目结构说明](PROJECT_STRUCTURE.md) - 项目文件组织说明\n- [GitBook 目录](SUMMARY.md) - 在线书籍的完整目录结构\n- [Jekyll 配置](_config.yml) - GitHub Pages 网站配置\n- [翻译进度追踪](progress.md) - 实时更新翻译状态\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fxindoo_agentic-design-patterns_readme_3a95edd2668b.png)](https:\u002F\u002Fgithub.com\u002Fxindoo\u002Fagentic-design-patterns)\n\n## 📄 许可证\n\n本翻译项目遵循原书的许可证条款。翻译内容仅供学习交流使用。\n\n## 联系我们\n邮箱: ixindoo@gmail.com  \n个人网站: [https:\u002F\u002Fzxs.io\u002F](https:\u002F\u002Fzxs.io\u002F)\n\n---\n\n**注意**：本项目为学习交流目的的翻译项目，如有版权问题请联系处理。","# Agentic Design Patterns 中文快速上手指南\n\n本指南旨在帮助开发者快速搭建本地阅读环境，浏览《Agentic Design Patterns》的中文翻译内容。本项目基于 Jekyll 构建，部署于 GitHub Pages。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：Linux, macOS 或 Windows (推荐 WSL2)\n*   **Git**：用于克隆代码仓库\n*   **Ruby**：版本建议 2.5.0 及以上 (Jekyll 运行依赖)\n*   **Bundler**：Ruby 包管理工具 (通常随 Ruby 安装，若未安装需手动执行 `gem install bundler`)\n\n> **国内加速建议**：\n> 若在国内网络环境下安装 Ruby 依赖较慢，建议切换至国内镜像源（如清华源或阿里源）：\n> ```bash\n> gem sources --add https:\u002F\u002Fmirrors.tuna.tsinghua.edu.cn\u002Frubygems\u002F --remove https:\u002F\u002Frubygems.org\u002F\n> gem sources -l # 确认列表只包含国内源\n> ```\n\n## 安装步骤\n\n1.  **克隆项目仓库**\n    将项目代码拉取到本地：\n    ```bash\n    git clone https:\u002F\u002Fgithub.com\u002Fxindoo\u002Fagentic-design-patterns.git\n    cd agentic-design-patterns\n    ```\n\n2.  **安装依赖**\n    使用 Bundler 安装项目所需的 Ruby  gems：\n    ```bash\n    bundle install\n    ```\n    *注：若遇到权限问题，可尝试 `bundle config set --local path 'vendor\u002Fbundle'` 后再执行安装。*\n\n3.  **启动本地服务**\n    运行 Jekyll 开发服务器：\n    ```bash\n    bundle exec jekyll serve\n    ```\n\n## 基本使用\n\n服务启动成功后，终端将显示类似以下信息：\n```text\nServer address: http:\u002F\u002F127.0.0.1:4000\u002F\nServer running... press ctrl-c to stop.\n```\n\n1.  **访问文档**\n    打开浏览器，访问 `http:\u002F\u002F127.0.0.1:4000\u002F` 即可在线阅读完整的中文目录和章节内容。\n\n2.  **浏览核心内容**\n    网站首页提供了完整的导航菜单，您可以直接点击阅读核心设计模式，例如：\n    *   **基础模式**：提示链 (Prompt Chaining)、路由 (Routing)\n    *   **进阶模式**：反思 (Reflection)、工具使用 (Tool Use)、规划 (Planning)\n    *   **高级模式**：多智能体协作、记忆管理、RAG 知识检索\n\n3.  **离线查阅**\n    若无需启动 Web 服务，也可直接在 `chapters\u002F` 目录下通过 Markdown 阅读器查看具体的 `.md` 文件，例如：\n    ```bash\n    cat chapters\u002FChapter\\ 1_\\ Prompt\\ Chaining.md\n    ```\n\n4.  **在线访问（免安装）**\n    如果仅需阅读无需本地修改，可直接访问已部署的站点：\n    [https:\u002F\u002Fadp.xindoo.xyz\u002F](https:\u002F\u002Fadp.xindoo.xyz\u002F)","某电商公司的技术团队正致力于构建一个能自动处理复杂客诉（如物流延误叠加商品破损）的智能客服系统。\n\n### 没有 agentic-design-patterns 时\n- **逻辑混乱且易出错**：开发人员仅靠简单的提示词堆砌，导致 AI 在面对多步骤问题时经常“幻觉”或遗漏关键信息，无法有效执行规划（Planning）和反思（Reflection）。\n- **协作能力缺失**：试图让单个模型同时承担查询订单、联系物流、判定赔偿等所有任务，结果因上下文过载导致响应缓慢且准确率极低，缺乏多智能体协作（Multi-Agent Collaboration）架构。\n- **维护成本高昂**：由于缺乏统一的设计模式参考，团队成员各自为战，代码风格迥异，且在遇到异常流程时不知道如何实现标准的异常处理与恢复（Exception Handling and Recovery）。\n- **安全隐患难控**：系统上线后频繁出现越权操作或输出不当内容，因为团队未系统性地应用安全防护模式（Guardrails\u002FSafety Patterns）。\n\n### 使用 agentic-design-patterns 后\n- **架构清晰稳健**：团队依据书中的“规划”与“反思”模式重构了核心逻辑，AI 能自主拆解复杂客诉为子任务并自我纠错，问题解决率提升了 40%。\n- **高效分工协作**：采用“多智能体协作”模式，将系统拆分为专门的“查询代理”、“谈判代理”和“审批代理”，各司其职并通过标准通信协议（A2A）高效配合，响应速度显著加快。\n- **开发标准化**：参照书中提供的 21 种核心模式，团队建立了统一的开发规范，特别是引入了标准的异常处理机制，使得新功能的迭代周期缩短了一半。\n- **安全可控**：通过落地“安全防护模式”和“评估监控”章节的方法，系统在源头拦截了 99% 的潜在风险指令，并具备了可量化的性能监控指标。\n\nagentic-design-patterns 将零散的 AI 开发经验转化为标准化的工程蓝图，帮助团队从“写提示词”进阶到“构建可靠的智能体系统”。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fxindoo_agentic-design-patterns_859e3839.png","xindoo","XINDOO","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fxindoo_69ef7b77.jpg",null,"China","ixindoo","https:\u002F\u002Fzxs.io","https:\u002F\u002Fgithub.com\u002Fxindoo",[81,85],{"name":82,"color":83,"percentage":84},"HTML","#e34c26",98.1,{"name":86,"color":87,"percentage":88},"Ruby","#701516",1.9,3462,477,"2026-04-13T02:27:14",1,"","未说明",{"notes":96,"python":94,"dependencies":97},"本项目为《Agentic Design Patterns》一书的中文翻译文档仓库，并非可执行的 AI 软件工具。项目内容主要为 Markdown 格式的文本文件，托管于 GitHub Pages 供在线阅读，无需安装任何运行环境、GPU、特定内存或 Python 依赖库。",[],[35,13],"2026-03-27T02:49:30.150509","2026-04-13T16:16:22.163177",[102,107,112,117,122,127,132,137],{"id":103,"question_zh":104,"answer_zh":105,"source_url":106},31746,"在线阅读时 Markdown 内容无法正确可视化渲染怎么办？","请尝试通过页面底部的“核心章节”入口进入，不要直接从侧边栏点击。侧边栏链接指向的是 README 文件，主要用于索引，暂时无法直接作为页面地址渲染。维护者正在研究兼容方案。","https:\u002F\u002Fgithub.com\u002Fxindoo\u002Fagentic-design-patterns\u002Fissues\u002F7",{"id":108,"question_zh":109,"answer_zh":110,"source_url":111},31747,"中文版 PDF 中代码块文字未自动换行导致显示不全如何解决？","该问题已在最新版本中修复。请下载项目 Releases 页面中最新的 PDF 版本查看，代码块格式已调整以支持自动换行。","https:\u002F\u002Fgithub.com\u002Fxindoo\u002Fagentic-design-patterns\u002Fissues\u002F33",{"id":113,"question_zh":114,"answer_zh":115,"source_url":116},31748,"如何获取项目的 EPUB 或 PDF 电子书文件？","无需自行制作，项目官方 Releases 页面已提供编译好的 EPUB 和 PDF 文件下载。访问地址：https:\u002F\u002Fgithub.com\u002Fxindoo\u002Fagentic-design-patterns\u002Freleases","https:\u002F\u002Fgithub.com\u002Fxindoo\u002Fagentic-design-patterns\u002Fissues\u002F28",{"id":118,"question_zh":119,"answer_zh":120,"source_url":121},31749,"官方网站 (adp.xindoo.xyz) 链接失效或无法访问怎么办？","该网站托管在 GitHub Pages 上，可能因网络原因在国内部分地区访问不稳定。如果测试链接失效，建议尝试使用网络代理工具（梯子）进行访问。","https:\u002F\u002Fgithub.com\u002Fxindoo\u002Fagentic-design-patterns\u002Fissues\u002F23",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},31750,"运行 Google ADK 示例代码时报 429 错误，提示 Gemini 2.0 Flash 被停用如何解决？","这通常是免费层级限额导致的误解。Gemini 2.0 Flash 在付费层级中仍可使用；如果使用的是免费层级，其限额较低且主要支持调用 Gemini 2.5 Flash。请检查您的 API 密钥层级，或切换使用 Gemini 2.5 Flash 等其他正常模型。","https:\u002F\u002Fgithub.com\u002Fxindoo\u002Fagentic-design-patterns\u002Fissues\u002F44",{"id":128,"question_zh":129,"answer_zh":130,"source_url":131},31751,"文档中每章的\"What\"和\"Why\"部分顺序是否弄反了？","顺序没有搞反。在此处直译\"What\"和\"Why\"不太准确：\"What\"主要用于交代背景（是什么），\"Why\"用来说明设计思路或决策依据（为什么）。维护者计划在后续版本中进行意译，用更贴切的中文表达其核心含义。","https:\u002F\u002Fgithub.com\u002Fxindoo\u002Fagentic-design-patterns\u002Fissues\u002F46",{"id":133,"question_zh":134,"answer_zh":135,"source_url":136},31752,"发现文档中存在翻译错误或语句不通顺的地方如何处理？","请直接提交 Issue 反馈具体章节和问题。维护者会核实并修正（例如之前修复的“智能体”后文字丢失、批处理误删等问题）。修正后请关注最新 Release 或在线文档更新。","https:\u002F\u002Fgithub.com\u002Fxindoo\u002Fagentic-design-patterns\u002Fissues\u002F35",{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},31753,"网站支持暗色模式（Dark Mode）吗？","支持。暗色模式功能已经上线，用户可以在网站上找到开关进行切换，以适应不同的阅读环境。","https:\u002F\u002Fgithub.com\u002Fxindoo\u002Fagentic-design-patterns\u002Fissues\u002F30",[143,147,151,155,159,163,167,172,176,180,184,188,192,196,200,204,208,212,216,220],{"id":144,"version":145,"summary_zh":75,"released_at":146},238962,"v72","2026-04-04T13:29:12",{"id":148,"version":149,"summary_zh":75,"released_at":150},238963,"v71","2026-03-23T13:35:29",{"id":152,"version":153,"summary_zh":75,"released_at":154},238964,"v70","2026-03-17T11:40:15",{"id":156,"version":157,"summary_zh":75,"released_at":158},238965,"v69","2026-03-17T07:31:32",{"id":160,"version":161,"summary_zh":75,"released_at":162},238966,"v68","2026-03-15T10:21:11",{"id":164,"version":165,"summary_zh":75,"released_at":166},238967,"v66","2026-03-11T04:30:38",{"id":168,"version":169,"summary_zh":170,"released_at":171},238968,"v65","增加双语版本","2026-03-10T08:53:42",{"id":173,"version":174,"summary_zh":75,"released_at":175},238969,"v63","2026-03-03T04:11:27",{"id":177,"version":178,"summary_zh":75,"released_at":179},238970,"v62","2026-03-01T15:52:08",{"id":181,"version":182,"summary_zh":75,"released_at":183},238971,"v61","2026-02-25T12:21:24",{"id":185,"version":186,"summary_zh":75,"released_at":187},238972,"v60","2026-02-24T09:23:53",{"id":189,"version":190,"summary_zh":75,"released_at":191},238973,"v59","2026-02-20T14:15:12",{"id":193,"version":194,"summary_zh":75,"released_at":195},238974,"v56","2026-02-19T14:02:21",{"id":197,"version":198,"summary_zh":75,"released_at":199},238975,"v54","2026-02-18T11:43:02",{"id":201,"version":202,"summary_zh":75,"released_at":203},238976,"v53","2026-02-06T08:45:02",{"id":205,"version":206,"summary_zh":75,"released_at":207},238977,"v52","2026-02-06T08:38:54",{"id":209,"version":210,"summary_zh":75,"released_at":211},238978,"v51","2026-02-06T08:25:21",{"id":213,"version":214,"summary_zh":75,"released_at":215},238979,"v50","2026-02-06T08:13:52",{"id":217,"version":218,"summary_zh":75,"released_at":219},238980,"v47","2025-12-22T07:59:20",{"id":221,"version":222,"summary_zh":75,"released_at":223},238981,"v45","2025-12-14T02:36:55"]