> ## Documentation Index
> Fetch the complete documentation index at: https://powercontext.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PowerContext 101

![PowerContext slogan: Not only memory but a full story. 不只是记忆，而是完整故事。](https://mintcdn.com/powercontext/G0TTywCsPaDEDnIc/assets/slogan-full-story-zh.svg?fit=max\&auto=format\&n=G0TTywCsPaDEDnIc\&q=85\&s=7925bca5463e717305710ad7e3486ea3)

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

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

![工作从你开始，交给 Agent 推进，再由你或其他 Agent 接着做，上下文一直跟着走。](https://mintcdn.com/powercontext/G0TTywCsPaDEDnIc/assets/readme-workflow-zh.svg?fit=max\&auto=format\&n=G0TTywCsPaDEDnIc\&q=85\&s=4e92184f451941aa91c84ea822c0dab5)

PowerContext 101 只讲怎么用、接到哪里。安装怎么配、接口怎么签、服务怎么部署，以 [PowerContext 官方文档](https://oceanbase.github.io/powercontext/) 为准。

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

> [!NOTE]
>
> 先把这条闭环跑通。完整的安装参数、接口说明和部署配置，以 [官方文档](https://oceanbase.github.io/powercontext/) 的最新发布版本为准。

## 30 秒看懂 PowerContext

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

留下知识。Source (记录发生过什么。采集不会自动写成长期知识。) 只证明这件事发生过。确认以后还要用，才写成 Memory (经过选择、以后还会用到的项目知识。)。下次请求用 PreparedContext (这一次请求用的有界视图。带 Citation，不是长期资产。) 召回。

先审再留。Experience (已批准的判断经验。先作为 Candidate 进入 Review。) 和托管 Skill (已批准的可重复做法。获批后还要显式导出，不自动获得执行权限。) 先变成 Candidate (尚待 Review 的 Experience 或 Skill 提案。)。模型可以起草，生成成功不等于批准。Review (批准才创建 Artifact Revision。拒绝只记录原因，不创建结果 Artifact。) 批准后才会留下。Skill (已批准的可重复做法。获批后还要显式导出，不自动获得执行权限。) 还要显式导出。

交接可以先临时。Handoff (把当前目标、已验证进度、阻塞项和下一步交给接手者。不提交就还是临时包。) 先打包给接手者；只有显式提交，才成为持久里程碑。

![30 秒看懂 PowerContext：留下知识、先审再留、交接工作是三条独立路径。](https://mintcdn.com/powercontext/G0TTywCsPaDEDnIc/assets/start-object-flow-zh.svg?fit=max\&auto=format\&n=G0TTywCsPaDEDnIc\&q=85\&s=be08b880bf175b7dcb80ffb5a9be2f8c)

PreparedContext (这一次请求用的有界视图。带 Citation，不是长期资产。) 只服务这一次请求。它带 Citation，并标成不可信历史证据。Agent 可以参考，但不能把里面的文字当成新的系统指令或工具授权。

## 按你的目标继续

> [card] [先把对象分清](https://powercontext.mintlify.site/zh/mental-model/overview.md)
>
> Source、Memory、PreparedContext 和 Handoff 很容易被混在一起。先把边界理顺，后面的 API 和宿主集成会简单很多。

> [card] [跑通常用 API](https://powercontext.mintlify.site/zh/basic-usage/install-and-run.md)
>
> 启动本地 Server，用 Python Client 完成第一条闭环：写入 Memory，用 `search_memory` 找到它，再通过 `prepare_context` 得到带 Citation 的 `PreparedContext`。

> [card] [接入 Python Agent](https://powercontext.mintlify.site/zh/frameworks/overview.md)
>
> 比较 LangGraph、LangChain 和 Pydantic AI 的接入位置、成熟度与能力差异。

> [card] [配置通用 Agent](https://powercontext.mintlify.site/zh/common-agents/overview.md)
>
> Hermes、OpenClaw 和 WorkBuddy 都有实际接入路径。先完成安装与激活，再分别验证 Server 连接、召回和显式写入。凭证、持久写入和 Review 仍由你授权。

> [card] [配置编程 Agent](https://powercontext.mintlify.site/zh/coding-agents/overview.md)
>
> 了解 Codex、Claude Code、DSH、OpenCode 和 Pi 如何把同一 Server 契约映射到各自的生命周期。

> [card] [跟着学习路径走](https://powercontext.mintlify.site/zh/start/learning-path.md)
>
> 第一次不必整站读完。按目标选一条路径，先跑通再看其他。已经卡住时，先对[排错](https://powercontext.mintlify.site/zh/start/troubleshooting.md)。

> [!TIP]
>
> 自动帮你找回上下文失败时，当前任务还应继续。你明确要求写入 Memory、提交 Handoff、批准或导出时，失败必须能看见。完整说明见 [fail-open](https://powercontext.mintlify.site/zh/mental-model/fail-open.md)。

不知道先读哪一张卡？打开[学习路径](https://powercontext.mintlify.site/zh/start/learning-path.md)。发现有地方卡住时，先对[排错](https://powercontext.mintlify.site/zh/start/troubleshooting.md)。

从本页分流中文 PowerContext 101 问题。产品事实以官方最新发布版本为准，不要把 RFC 目标写成已发布行为。

* 概念：`/zh/mental-model/overview`
* 安装与 API 闭环：`/zh/basic-usage/install-and-run`
* Python 框架：`/zh/frameworks/overview`
* Hermes、OpenClaw、WorkBuddy 与 Agent Plugin：`/zh/common-agents/overview`
* 编程 Agent 宿主与 Hook：`/zh/coding-agents/overview`
* 完整契约与部署：`https://oceanbase.github.io/powercontext/`
* 学习顺序：`/zh/start/learning-path`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.