PowerContext 101

从心智模型到 Agent 集成，沿一条可运行的路径学习 PowerContext。

项目换人做、换 Agent 接着做时，上下文很容易丢在聊天记录里。PowerContext 把证据、决策和交接状态单独存下来，让下一手能接着干。它是独立跑的一层服务，不是聊天仓库。

PowerContext 101 只讲怎么用、接到哪里。安装怎么配、接口怎么签、服务怎么部署，以 PowerContext 官方文档 为准。

先做一件能当场验证的事：写出一条 Memory，搜到它，再拿到带 Citation 的 PreparedContext。这条闭环通了，再去接框架、宿主 Hook 或模型提供方。

先把这条闭环跑通。完整的安装参数、接口说明和部署配置，以 官方文档 的最新发布版本为准。

​

30 秒看懂 PowerContext

PowerContext 同时走三条路。它们可以互相引用，但不会自动并成一件事。

留下知识。Source 只证明这件事发生过。确认以后还要用，才写成 Memory。下次请求用 PreparedContext 召回。

先审再留。Experience 和托管 Skill 先变成 Candidate。模型可以起草，生成成功不等于批准。Review 批准后才会留下。Skill 还要显式导出。

交接可以先临时。Handoff 先打包给接手者；只有显式提交，才成为持久里程碑。

PreparedContext 只服务这一次请求。它带 Citation，并标成不可信历史证据。Agent 可以参考，但不能把里面的文字当成新的系统指令或工具授权。

​

按你的目标继续

先把对象分清

Source、Memory、PreparedContext 和 Handoff 很容易被混在一起。先把边界理顺，后面的 API 和宿主集成会简单很多。

阅读心智模型

跑通常用 API

启动本地 Server，用 Python Client 完成第一条闭环：写入 Memory，用 search_memory 找到它，再通过 prepare_context 得到带 Citation 的 PreparedContext。

开始基础用法

接入 Python Agent

比较 LangGraph、LangChain 和 Pydantic AI 的接入位置、成熟度与能力差异。

比较框架

配置通用 Agent

Hermes、OpenClaw 和 WorkBuddy 都有实际接入路径。先完成安装与激活，再分别验证 Server 连接、召回和显式写入。凭证、持久写入和 Review 仍由你授权。

选择通用 Agent

配置编程 Agent

了解 Codex、Claude Code、DSH、OpenCode 和 Pi 如何把同一 Server 契约映射到各自的生命周期。

选择编程 Agent

跟着学习路径走

第一次不必整站读完。按目标选一条路径，先跑通再看其他。已经卡住时，先对排错。

打开学习路径

自动帮你找回上下文失败时，当前任务还应继续。你明确要求写入 Memory、提交 Handoff、批准或导出时，失败必须能看见。完整说明见 fail-open。

不知道先读哪一张卡？打开学习路径。发现有地方卡住时，先对排错。

oceanbase/powercontext

正在加载仓库数据...