{"id":31128909,"url":"https://github.com/wakeup-jin/practical-guide-to-context-engineering","last_synced_at":"2026-02-14T13:01:35.454Z","repository":{"id":314421093,"uuid":"1055446651","full_name":"WakeUp-Jin/Practical-Guide-to-Context-Engineering","owner":"WakeUp-Jin","description":"介绍和描述上下文工程的仓库，上下文工程的定义：是在有限的上下文窗口中，选择、组织并注入与用户输入或任务高度相关的信息，从而让大语言模型（LLM）能够在合理的边界内做出最佳推理和执行。  上下文工程中最关键的是：用最相关的信息填充 LLM 的上下文窗口 - 在线阅读","archived":false,"fork":false,"pushed_at":"2026-02-10T10:34:47.000Z","size":24107,"stargazers_count":338,"open_issues_count":0,"forks_count":32,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-10T15:51:41.347Z","etag":null,"topics":["javascript","typescript"],"latest_commit_sha":null,"homepage":"https://wakeup-jin.github.io/Practical-Guide-to-Context-Engineering/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WakeUp-Jin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE.txt","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-12T09:24:44.000Z","updated_at":"2026-02-10T10:34:51.000Z","dependencies_parsed_at":"2025-09-15T05:00:45.734Z","dependency_job_id":"68dfd827-d05a-4d58-a8d8-f89657495dbf","html_url":"https://github.com/WakeUp-Jin/Practical-Guide-to-Context-Engineering","commit_stats":null,"previous_names":["wakeup-jin/practical-guide-to-context-engineering"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/WakeUp-Jin/Practical-Guide-to-Context-Engineering","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WakeUp-Jin%2FPractical-Guide-to-Context-Engineering","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WakeUp-Jin%2FPractical-Guide-to-Context-Engineering/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WakeUp-Jin%2FPractical-Guide-to-Context-Engineering/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WakeUp-Jin%2FPractical-Guide-to-Context-Engineering/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WakeUp-Jin","download_url":"https://codeload.github.com/WakeUp-Jin/Practical-Guide-to-Context-Engineering/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WakeUp-Jin%2FPractical-Guide-to-Context-Engineering/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29444028,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T12:43:28.304Z","status":"ssl_error","status_checked_at":"2026-02-14T12:43:14.160Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["javascript","typescript"],"created_at":"2025-09-18T01:18:43.616Z","updated_at":"2026-02-14T13:01:35.448Z","avatar_url":"https://github.com/WakeUp-Jin.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# 大模型应用开发 - 上下文工程实践指南\n\n\u003cdiv align='center'\u003e\n  \u003cimg src=\"./docs/image/logo3.jpg\" alt=\"Practical-guide-to-context-engineering Logo\" width=\"100%\"\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch2\u003e📚 上下文工程实践指南\u003c/h2\u003e\n  \u003cp\u003e\u003cem\u003e从理论到实践，从基础到进阶，构建你的上下文工程体系\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/WakeUp-Jin/Practical-Guide-to-Context-Engineering?style=for-the-badge\u0026logo=github\u0026color=ff6b6b\" alt=\"GitHub stars\"/\u003e\n  \u003cimg src=\"https://img.shields.io/github/forks/WakeUp-Jin/Practical-Guide-to-Context-Engineering?style=for-the-badge\u0026logo=github\u0026color=4ecdc4\" alt=\"GitHub forks\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Node-20-blue?style=for-the-badge\u0026logo=typescript\u0026logoColor=white\" alt=\"Node\"/\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/📖_在线阅读-立即开始-success?style=for-the-badge\u0026logoColor=white\" alt=\"在线阅读\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"README_en.md\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/🌍_English-Version-blue?style=for-the-badge\u0026logoColor=white\" alt=\"English Version\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/💬_讨论交流-加入我们-purple?style=for-the-badge\u0026logoColor=white\" alt=\"讨论交流\"/\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\n## 项目介绍\n\u0026emsp;\u0026emsp; 随着大语言模型（LLM）的快速发展，越来越多的开发者和企业尝试将其应用到实际业务场景中。然而，在真实落地的过程中，大家很快发现：模型本身并不是一切，决定模型表现的关键在于它所拥有的上下文。\n\n\u0026emsp;\u0026emsp;上下文工程（Context Engineering）正是在这样的背景下提出的一种系统化方法论。它关注如何在有限的上下文窗口中，选择、组织并注入与用户任务高度相关的信息，从而让大模型在合理的边界内做出最佳推理与执行。\n\n本项目的目标，是为开发者和研究者提供一份大模型应用开发的骨架思路，以上下文组成作为大模型应用开发的核心，有关大模型应用开发的技术都可以借助上下文工程这个概念互相联系起来\n\n## ✏️什么是上下文工程\n**上下文工程的定义：是在有限的上下文窗口中，选择、组织并注入与用户输入或任务高度相关的信息，从而让大语言模型（LLM）能够在合理的边界内做出最佳推理和执行。**\n\n\n上下文工程中最关键的是：**用最相关的信息填充 LLM 的上下文窗口**\n\n如何为“用户输入”找到最相关的信息，是这个上下文工程系统的入口，也是衡量整个系统价值的核心指标，但这种“相关性”的实现并不会自然而然发生，它依赖开发者去设计、构建与优化整个系统\n\n\n\n与 RAG 的区别是：RAG 是上下文工程中的一个子集\n\n与提示词工程的区别是：提示词工程是专注于 LLM 最前置的正确指令艺术，其主要是：\u003cfont style=\"color:rgb(55, 65, 81);\"\u003e在单个文本字符串中设计完美的指令集\u003c/font\u003e\n\n\u003e \u003cfont style=\"color:rgba(0, 0, 0, 0.75);\"\u003e \u003c/font\u003e\u003cfont style=\"color:rgb(28, 59, 59);\"\u003eKarpathy\u003c/font\u003e\u003cfont style=\"color:rgb(15, 20, 25);\"\u003e的总结：人们通常将提示与日常使用中向 LLM 提供的简短任务描述联系起来。但在每个工业级 LLM 应用中，上下文工程是一门微妙的艺术和科学，它通过为下一步提供恰到好处的信息来填充上下文窗口。这是科学，因为正确地做到这一点涉及任务描述和解释、少量示例、RAG、相关（可能是多模态的）数据、工具、状态和历史记录、压缩等。太少或形式不正确，LLM 就没有正确的上下文来优化性能。太多或太不相关，LLM 的成本可能会上升，性能可能会下降。做好这一点非常不简单。而且，这也是艺术，因为围绕 LLM 心理和人们精神的指导直觉。\u003c/font\u003e\n\u003e\n\n\u003cfont style=\"color:rgb(28, 59, 59);\"\u003eKarpathy\u003c/font\u003e\u003cfont style=\"color:rgb(15, 20, 25);\"\u003e的总结的链接：\u003c/font\u003e[https://x.com/karpathy/status/1937902205765607626?ref=blog.langchain.com](https://x.com/karpathy/status/1937902205765607626?ref=blog.langchain.com)\n\n## ✏️为什么上下文工程重要\n🌟🌟 **\u003cfont style=\"color:rgb(55, 65, 81);\"\u003e因为它可以帮助开发者构建真正有效的 AI 代理，为构建 Agent 提供开发方向\u003c/font\u003e**\n\n\n## 上下文工程\n![](./docs/image/image%20(6).png)\n上下文工程的核心由七种上下文组成，同时根据七种上下文可以延伸出来系统或者 Agent 中真正需要构建的模块是哪些，这些模块都是围绕上下文工程来构建的，这个时候我们可以知道构建 Agent 或者大模型应用时，需要哪些基础的技术\n\n\n\n其中最关键的，也是最特别的部分是：**相关上下文**这个对于开发者来说是最有挑战性的，这个变动性是最大的，每一个 Agent 或许都有属于自己独特的相关上下文模块设计的架构\n\n相关上下文是围绕用户输入的**背景知识**，是帮助大模型更好的回答用户输入的问题，例如\n\n1. 在一个编码 Agent 中：一段代码问题是用户的输入，那么根据代码库检索到的这段用户输入相关的代码片段，代码文件，代码关系就是相关上下文\n2. 在一个客服 Agent 中：客服手册，常见问题集合，回复规范这些都可以是用户输入的相关上下文\n3. 在一个医疗问诊 Agent 中：用户输入“描述自己最近的症状”，那么用户病例、药物使用史，体检报告解释相关上下文\n4. 在一个项目管理 Agent 中：用户输入“我们项目 X 的进度怎么样”，那么项目文档，任务进度，周报等就是相关上下文\n\nRAG 只是相关上下文实现的其中一种技术手段，其实还有更多的实现方式，例如：组合记录、标签检索，日期检索等\n\n相关上下文和用户记忆的获取都使用了 RAG（增强检索技术），但是它们的侧重点不同\n\n+ 相关上下文的侧重点是“用户输入”的相关背景知识\n+ 用户记忆的侧重点是“用户”的相关数据\n\n\n\n然而，**一个 Agent 并不需要同时使用全部七种上下文**。不同的场景、不同的目标，往往只需要其中的若干种组合就能发挥很好的效果。这需要开发者们进行选择\n\n\n## 上下文组成\n![](./docs/image/image%20(7).png)\n上下文由以下几种类型组成\n\n1. 系统提示词：遵守一些提示词工程的要求定义的提示词，例如：期望输出，结果限制，任务要求\n2. 问题相关上下文：解决和回答这个问题想要的背景知识\n3. 用户记忆：和用户相关的知识，例如：用户年龄，用户的习惯，用户的偏好等\n4. 工具定义和输出：提供相应的工具或者 MCP 给模型调用\n5. 会话历史记录：一个会话窗口的历史聊天记录\n6. 结构化输出：对于大模型输出的结果有格式的要求：例如：JSON，XML，CSV ，TSV 等\n7. 用户输入：用户在当前对话中输入的原始问题或指令，是整个上下文工程的起点。\n\n## 其他\n- [更新日记](./docs/更新日记/更新日记.md): 记录着项目更新的内容进度\n\n## 📖 内容导航\n### 前言\n- [前言-从零到一：基于上下文工程的 Agent 后端设计](./docs/前言/从零到一：基于上下文工程的%20Agent%20后端设计.md): 从零到一：基于上下文工程的 Agent 后端设计 ✅\n\n### 第一部分：上下文工程基础技术\n\u003c!-- - [第一章 数据持久化](./docs/)：介绍传统数据库（MySQL、MongoDB、Redis 等）在大模型应用中的作用：状态存储、用户数据、日志记录  --\u003e\n- [第一章 向量存储和嵌入模型](./docs)：语义检索的底层原理、嵌入模型的选择与评测、主流向量数据库的特性 \n- [第二章 知识图谱](./docs)：知识的结构化表达、实体关系抽取、知识图谱与向量检索的互补 \n- [第三章 RAG技术](./docs/RAG技术)：从检索增强生成（RAG）的流程拆解到优化方法，涵盖索引构建、检索策略、融合方式 \n  - [RAG策略](./docs/RAG技术/RAG策略-index.md) ✅\n  - [编码器和LLM微调](./docs/RAG技术) \n- [第四章 搜索代理](./docs/搜索代理/搜索代理.md)：搜索代理的原理、实现方式、优化方法 ✅\n\n\n\n### 第二部分：上下文组成工程实践\n- [第五章 系统提示词模块](./docs)：系统提示词的设计方法：输出规范、边界约束、多角色指令，如何平衡稳定性与灵活性 \n- [第六章 工具管理模块](./docs/工具管理模块/)：工具（API、函数、MCP）的注册与调度，调用结果的解析与注入，常见框架中的实现方式\n  - [工具管理](./docs/工具管理模块/工具管理.md) ✅\n  - [ClaudeCode逆向工程（Kode）的工具定义和管理](./docs/工具管理模块/ClaudeCode逆向工程（Kode）的工具定义和管理%20-TS版本.md) ✅\n  - [模型调用工具能力评估](./docs/工具管理模块/模型调用工具能力评估.md) \n  - [MCP与MCP的安全](./docs/工具管理模块/MCP与MCP的安全.md) \n- [第七章 用户记忆模块](./docs)：长期/短期记忆管理，用户画像构建，记忆存储与检索策略，隐私与安全考量 \n- [第八章 会话存储模块](./docs/会话存储模块/)：会话历史的截断、压缩与检索；如何在有限上下文窗口内保留对话连贯性\n  - [Redis缓存后端存储设计-读穿｜写穿](./docs/会话存储模块/Redis缓存后端存储设计-读穿｜写穿.md) ✅\n  - [多后端存储设计-备份降级策略](./docs/会话存储模块/多后端存储设计-备份降级策略.md) ✅\n- [第九章 结构化输出模块](./docs/结构化输出模块/)：JSON/XML/CSV 等结构化输出的约束与解析，如何让 LLM 严格遵循格式要求\n  - [JSON结构化输出的方法](./docs/结构化输出模块/JSON结构化输出的方法.md) ✅\n  - [LLM输出格式成本：为什么JSON比TSC成本更高](./docs/结构化输出模块/LLM%20输出格式成本：为什么%20JSON%20比%20TSV%20成本更高.md) ✅\n- [第十章 相关上下文模块](./docs)：如何动态选择与任务最相关的上下文（检索、排序、过滤、融合） \n- [第十一章 LLM模块](./docs/LLM模块/)：上下文工程中LLM的设计架构\n  - [LLM服务层的实现设计](./docs/LLM模块/LLM服务层的实现设计.md) ✅\n  - [Cipher的LLM 服务架构分析文档](./docs/LLM模块/Cipher的LLM%20服务架构分析文档%20-TS版本.md) ✅\n  - [三大LLM提供商实现策略细节](./docs/LLM模块/)\n  \n\n### 第三部分：上下文管理\n- [第十二章 上下文管理](./docs/上下文管理/上下文管理.md)：上下文裁剪、压缩、去重、隔离（quarantine）等策略，性能指标与评估方法 ✅\n- [第十三章 Token压缩策略](./docs/上下文管理/Token压缩策略.md)：各类压缩方法对比：摘要、向量聚合、句子窗口检索，结合真实应用案例 ✅\n- [第十四章 上下文压缩：ClaudeCode、Gemini 与工具消息裁剪](./docs/上下文管理/上下文压缩：ClaudeCode、Gemini与工具消息裁剪.md)：上下文压缩的原理、实现方式、优化方法 ✅\n\n### 第四部分：Agent架构设计\n- [第十五章 两种世界的交互形态：协同Agent与自主Agent](./docs/Agent形态/两种世界的交互形态：协同Agent与自主Agent.md)：Agent的两种形态：协同Agent与自主Agent以及开发策略 ✅\n- [第十六章 智能体系统构建策略：单智能体和多智能体](./docs/Agent形态/智能体系统构建策略-单智能体和多智能体.md)：智能体系统构建策略：单智能体和多智能体以及开发策略 ✅\n\n### 第五部分：Agent评估\n- [第十七章 Agent的评估](./docs/Agent评估/Agent的评估.md)：Agent的评估方案和方法 ✅\n- [第十八章 实现Agent的评估器-TS版本](./docs/Agent评估/实现Agent的评估器-TS版本.md)：Agent的评估器TS版本实现 ✅\n- [第十九章 揭秘 AI 代理的评估 - 多种Agent的评估方法](./docs/Agent评估/评估多种类型Agent的方法.md)：多种Agent的评估方法 ✅\n\n### 第六部分：AI协作编码与上下文工程\n- [第二十章 Anthropic 黑客马拉松冠军- ClaudeCode配置整理和补充](./docs/AI协作编码与上下文工程/Anthropic%20黑客马拉松冠军-%20ClaudeCode配置整理和补充.md)：Anthropic 黑客马拉松冠军- ClaudeCode配置整理和补充 ✅\n\n\n### 第七部分：上下文工程实践项目\n- [ReasonCode项目设计文档](./docs/ReasonCode开发设计文档/)：ReasonCode项目设计文档\n  - [首页：ReasonCode项目介绍](./docs/ReasonCode开发设计文档/首页：ReasonCode项目介绍.md)✅\n  - [第一篇：文件搜索工具](./docs/ReasonCode开发设计文档/第一篇：文件搜索工具.md) ✅\n  - [第二篇：Reason-cli 工具权限模块的开发](./docs/ReasonCode开发设计文档/第二篇：Reason-cli%20工具权限模块的开发.md) ✅\n  - [第三篇：Reason-cli的上下文压缩机制的设计](./docs/ReasonCode开发设计文档/第三篇：Reason-cli的上下文压缩机制的设计.md) ✅\n\n\n\n## 🤝 如何贡献\n\n我希望「上下文工程实践」不仅是一个仓库，而是一个大家共同探索、共同建设的开放空间。\n欢迎以你喜欢的方式加入进来：\n\n- 🐛 \u003cstrong\u003e报告 Bug\u003c/strong\u003e - 发现内容或代码问题，请提交 Issue\n- 💡 \u003cstrong\u003e提出建议\u003c/strong\u003e - 对项目有好想法，欢迎发起讨论\n- 📝 \u003cstrong\u003e完善内容\u003c/strong\u003e - 帮助改进教程，提交你的 Pull Request\n- ✍️ \u003cstrong\u003e分享实践\u003c/strong\u003e - 在\"上下文工程实践项目\"中分享你的学习笔记和项目\n\n开始贡献前，请阅读 [详细贡献指南](./贡献指南.md)，了解具体的提交规范和流程。\n\n每一份贡献，无论大小，都是推动这个项目前进的重要力量。期待看到你的身影！🎉\n\n## 🙏 致谢\n\n### 核心贡献者\n- [WakeUpJin-项目负责人](https://github.com/WakeUp-Jin) (一位享受阅读和积累知识的开发者)\n\n## Star History\n\u003cdiv align='center'\u003e\n    \u003cimg src=\"./docs/image/star-history-2026210.png\" alt=\"Datawhale\" width=\"90%\"\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e⭐ 如果这个项目对你有帮助，请给我们一个 Star！\u003c/p\u003e\n\u003c/div\u003e\n\n## 关于WakeUp-Jin\n\n文章合集也会同步更新到微信公众号，方便手机端阅读。公众号上除了项目内容外，还会分享我平时关于学习的记录和生活的思考\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./docs/image/wx.jpg\" alt=\"微信公众号二维码\" width=\"200\"\u003e\n  \u003cp\u003e扫描二维码关注WakeUp-Jin\u003c/p\u003e\n\u003c/div\u003e\n\n## 📜 开源协议\n\u003ca rel=\"license\" href=\"http://creativecommons.org/licenses/by-nc-sa/4.0/\"\u003e\u003cimg alt=\"知识共享许可协议\" style=\"border-width:0\" src=\"https://img.shields.io/badge/license-CC%20BY--NC--SA%204.0-lightgrey\" /\u003e\u003c/a\u003e\n\n本作品采用[知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-sa/4.0/)进行许可。","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwakeup-jin%2Fpractical-guide-to-context-engineering","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwakeup-jin%2Fpractical-guide-to-context-engineering","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwakeup-jin%2Fpractical-guide-to-context-engineering/lists"}