1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | langgraph-persistence-langchain-ai-langchain-skills（SKILL.md 内部名称 langgraph-persistence） |
GitHub |
| 作者/维护者 | LangChain（langchain-ai 官方组织，LangGraph、LangChain、Deep Agents 框架的开发方） |
GitHub API + plugin.json |
| 来源链接 | https://github.com/langchain-ai/langchain-skills/tree/main/config/skills/langgraph-persistence | — |
| 许可证 | MIT（声明于仓库 .claude-plugin/plugin.json 的 license 字段；仓库根目录未附独立 LICENSE 文件，故 GitHub API 的 license 字段显示为空） |
GitHub API + 仓库文件 |
| GitHub Stars/Forks | 所属合集仓库 langchain-ai/langchain-skills 整体 1,108★/85 forks（覆盖约 20 个不同子技能，不代表本技能自身热度） |
GitHub API |
| 最新版本 | 0.1.0（plugin.json 声明；README 注明项目处于早期阶段，API 与技能内容可能变化） | GitHub |
| 安装方式 | npx skills add langchain-ai/langchain-skills --skill langgraph-persistence --yes |
GitHub README |
2. 功能介绍与亮点
LangGraph 应用一旦涉及多轮对话、长时间运行的任务或需要中途暂停等待人工确认，就绕不开“状态怎么存、存多久、怎么恢复”这套持久化机制。这个技能把 LangGraph 官方的持久化层——Checkpointer（短期记忆）与 Store（跨线程长期记忆）——整理成一份可随查随用的参考手册。
主要亮点：
- Checkpointer 选型表：
InMemorySaver（仅测试）/SqliteSaver（本地开发，部分可用于生产）/PostgresSaver（生产级）三者的适用场景与生产就绪程度一目了然，并给出 PostgreSQL 后端的正确初始化方式（setup()应在部署时单独运行一次，而非放进应用启动流程）。 - 状态时间旅行：演示如何用
get_state_history浏览某个对话线程的历史检查点、如何从过去某一步重放（replay）或分叉（fork）执行——这是调试“Agent 为什么在某一步做出了错误决策”的关键手段。 - 子图检查点作用域（本技能覆盖面上最独特的部分）：用一张表格讲清
checkpointer=False/None（默认）/True三种取值分别决定子图是否支持中断、是否具备多轮记忆、能否被并行调用——这是 LangGraph 生态里公认容易踩坑的细节，并附并行子图命名空间隔离写法与“同一有状态子图不可在同一节点内并行调用多次”的警告。 - 跨线程长期记忆（Store）：演示如何用 Store 让不同会话共享用户偏好等长期信息，区分它与 Checkpointer 管理的线程内短期记忆。
- “常见错误写法 vs 正确写法”对照：忘记传
thread_id导致状态不持久、生产环境误用InMemorySaver、误以为update_state会跳过 reducer（需要用Overwrite才能真正替换而非累加）、忘记通过runtime.store访问 Store 等高频踩坑点均给出直接对照代码。 - Python 与 TypeScript 双语言：几乎每个知识点都配两种语言的可直接复制代码示例。
3. 适用场景
所属分类：元技能与 Agent 增强
适合正在用 LangGraph 构建需要多轮对话记忆、生产级容错持久化、或需要人工审批中断环节的 Agent 应用的开发者——典型场景是决定该用哪种 Checkpointer 后端、排查“Agent 忘了上一轮说了什么”这类持久化配置遗漏问题、给包含并行子 Agent 的复杂图正确设计检查点作用域，或是要实现“记住某个用户偏好、且这个偏好要跨多次对话生效”的长期记忆功能。目标用户是已经在用 LangGraph 搭建 Agent、但还没摸透持久化层设计细节的中级开发者。
4. 跨 Agent 兼容性
- Claude Code：原生支持。README 明确列出 Claude Code，并提供专用的 Claude Code Plugin 安装方式（
/plugin marketplace add+/plugin install）。 - Codex：⚠️ 需适配。README 未点名 Codex，但技能本体是纯 SKILL.md 标准格式、不依赖任何 Claude Code 专有工具调用或脚本，按 Agent Skills 规范的跨工具兼容性推断可用；未直接验证。
- OpenClaw / Hermes Agent：❓ 未验证。抓取到的材料（README、SKILL.md）未提及这两个 agent。
5. 推荐理由
LangGraph 的持久化配置是一个“能跑但容易跑错”的领域——忘记 thread_id、生产环境误用内存态 Checkpointer、子图检查点作用域选错导致并行调用冲突，这些问题往往要等应用上线后才暴露。这个技能把官方对这套机制的正确用法与高频踩坑点整理成一份写代码时可随时查阅的结构化参考，且由 LangGraph 官方自己维护、随框架版本同步更新。对正打算给 LangGraph Agent 加上多轮记忆或推上生产环境的开发者，能显著降低“状态莫名其妙丢失”“并行子图互相冲突”这类结构性问题的试错成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 由 LangGraph/LangChain 官方开发方 LangChain 发布并维护；所属合集仓库整体 1,108 stars，但该数字由约 20 个子技能共享、不代表本技能自身热度；尚未检索到针对本技能自身的独立第三方报道或评测数据 |
| 可用性 | 9 | SKILL.md 单文件约 18KB，覆盖 Checkpointer 选型、线程管理、时间旅行、子图检查点作用域、长期记忆 Store 等场景，每个知识点均配 Python 与 TypeScript 双语言可直接复制代码示例，并附“常见错误 vs 正确写法”对照与“不应该做的事”边界清单；一条命令即可安装，不依赖外部付费服务（PostgresSaver 仅在选择生产级持久化时才需要用户自备数据库）；仓库最近一次提交为 2026-08-07，维护活跃 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：①技能本体只是一份 Markdown 参考文档，不含任何脚本或可执行代码，不涉及 shell 命令执行 ②技能本身运行时不联网、不外发任何数据（文中示例代码中 PostgresSaver 连接的数据库是用户自己的部署，与本技能无关）③不要求用户向本技能提供任何 API Key 或凭据 ④通读 SKILL.md 全文，全部内容为 LangGraph 持久化 API 用法说明与代码示例，未发现可疑指令、混淆代码或隐藏外发行为 ⑤LangChain 官方组织出品，langchain-ai 为 LangChain/LangGraph/Deep Agents 框架的官方开发方，无造假迹象 ⑥License 为 MIT，声明于仓库 plugin.json，含义明确 ⑦仓库最近一次提交为 2026-08-07，持续维护中
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
langgraph-fundamentals（同仓库姊妹技能） |
LangGraph 图结构基础——StateGraph、节点、边、Command、Send API | 覆盖的是“怎么画出一张图”，本技能覆盖的是“图跑起来之后状态怎么存、怎么恢复”，两者是同一开发流程里的前后环节 |
deep-agents-memory（同仓库姊妹技能） |
面向 Deep Agents 高层框架的记忆与文件系统抽象（StateBackend/StoreBackend/FilesystemMiddleware） | Deep Agents 是构建在 LangGraph 之上的一层更省心但控制粒度更粗的封装；本技能教的是 LangGraph 原始的 Checkpointer/Store 机制本身，适合需要精细控制持久化行为、或还未引入 Deep Agents 封装的场景 |
| LangGraph 官方文档网站 | 分散在多个页面的持久化概念说明与 API 参考 | 官方文档面向人类阅读，需要自己检索与整理；本技能是为编码 Agent 场景重新组织的结构化速查手册，随 Claude Code 等工具在写代码的当下按需调用，无需切换到浏览器查阅 |
8. 用户评价
该技能目前在第三方平台尚无经核实的具名用户评价。
9. 其他补充
同仓库还包含 langgraph-fundamentals（图结构基础）、langgraph-human-in-the-loop（中断与人工审批工作流）、deep-agents-core（Deep Agents 高层框架）等围绕 LangGraph/LangChain 生态不同环节的姊妹技能，可按需单独安装，不必整包引入。
10. 安装使用方式
- 单独安装本技能（推荐）：
npx skills add langchain-ai/langchain-skills --skill langgraph-persistence --yes；全局安装加--global - 指定安装到 Claude Code：
npx skills add langchain-ai/langchain-skills --agent claude-code --skill langgraph-persistence --yes --global - 作为 Claude Code 插件整包安装：
/plugin marketplace add langchain-ai/langchain-skills后/plugin install langchain-skills@langchain-skills（会装入该仓库全部子技能，而非仅此一个） - 安装后注意事项：无需配置 API Key 或环境变量即可使用本技能本身；若要按文中示例接入 PostgresSaver 做生产级持久化，需自备 PostgreSQL 连接字符串；直接向 Claude Code 描述“给这个 LangGraph 应用加上多轮对话记忆”之类的需求即可触发调用
11. 注意事项
- README 明确标注项目处于早期阶段，API 与技能内容可能变化，长期跟踪建议关注仓库更新
- 内容聚焦 Checkpointer/Store 持久化层本身，不覆盖 LangGraph 图结构基础（需另装同仓库的
langgraph-fundamentals）或 Deep Agents 高层封装的记忆机制（需另装deep-agents-memory） - 仓库未附独立 LICENSE 文件，MIT 许可仅声明于
.claude-plugin/plugin.json，比对时需留意这一细节 - 文中提醒
PostgresSaver.setup()应在部署时单独运行一次而非放进应用启动流程，遗漏这条建议可能导致每次启动都重复尝试建表