# PowerContext 101

> PowerContext 使用与开发实战：心智模型、常用 API、框架集成、通用 Agent 与编程 Agent。

## 开始

### 本站

- [PowerContext 101](https://powercontext.mintlify.app/zh/start/index.md)
- [学习路径](https://powercontext.mintlify.app/zh/start/learning-path.md): 先分清几个对象，再按你的目标跑通一条路径。
- [排错](https://powercontext.mintlify.app/zh/start/troubleshooting.md): 搜不到、页面是空的，或诊断过了还是不行？先对照下面几条。

## 心智模型

### 核心理念

- [心智模型总览](https://powercontext.mintlify.app/zh/mental-model/overview.md): 先分清三条路，再往下读对象页。
- [Source](https://powercontext.mintlify.app/zh/mental-model/source.md): 采集成功不等于留下知识。Source 只证明这件事发生过。
- [Memory](https://powercontext.mintlify.app/zh/mental-model/memory.md): Memory 保存以后还会用的结论，不是完整聊天。
- [Handoff](https://powercontext.mintlify.app/zh/mental-model/handoff.md): Handoff 把当前工作交给接手者。不提交就还是临时包。
- [Experience 与 Skill](https://powercontext.mintlify.app/zh/mental-model/experience-and-skill.md): 模型写得好，不等于已经上线。先过 Review，再谈导出和执行。
- [Scope](https://powercontext.mintlify.app/zh/mental-model/scope.md): 设错 Scope 通常不报错，只是搜不到。
- [fail-open 与 PreparedContext](https://powercontext.mintlify.app/zh/mental-model/fail-open.md): 自动找回失败时，手头工作还应继续。你明确要求写入时，失败必须看得见。

## 基础用法

### 入门闭环

- [安装并运行 Server](https://powercontext.mintlify.app/zh/basic-usage/install-and-run.md): 先把最小 Server 跑起来。第一次不要接模型。
- [常用 API 串讲](https://powercontext.mintlify.app/zh/basic-usage/api-tour.md): 写出一条 Memory，搜到它，再拿到带 Citation 的 PreparedContext。
- [用 MCP 连接 Server](https://powercontext.mintlify.app/zh/basic-usage/mcp.md): 用 Agent 的工具连上刚才那套数据。MCP 不是完整 HTTP API。
- [用 Dashboard 核对 Scope 统计](https://powercontext.mintlify.app/zh/basic-usage/dashboard.md): Dashboard 不显示 Memory 正文。配上同一个 Scope，核对数字。
- [Source 与 Memory 实操](https://powercontext.mintlify.app/zh/basic-usage/source-and-memory.md): 先采集 Source，再抽取 Memory。采集成功不等于留下知识。
- [Handoff 闭环](https://powercontext.mintlify.app/zh/basic-usage/handoff-loop.md): 做一次真正的交接。准备就会写 Source。提交才留下里程碑。
- [Experience、Skill 与 Review](https://powercontext.mintlify.app/zh/basic-usage/experience-skill-review.md): 先审再留。Skill 批准后还要显式导出。

## 框架集成

### 第一次接入

- [框架集成总览](https://powercontext.mintlify.app/zh/frameworks/overview.md): 第一次接入先选 LangGraph 或 LangChain。Server 推理和 Pydantic AI 预览适配器需要时再读。
- [LangGraph](https://powercontext.mintlify.app/zh/frameworks/langgraph.md): 为异步 LangGraph 加入三个 Memory 工具和按轮次临时召回，不污染检查点。
- [LangChain](https://powercontext.mintlify.app/zh/frameworks/langchain.md): 每次模型请求前召回，并按需捕获一次成功完成的轮次，不修改 agent 状态。
- [框架进阶技巧](https://powercontext.mintlify.app/zh/frameworks/tricks.md): 用可修复的失败案例测试 Scope、临时召回、UTF-8 预算和 capture-to-Memory 边界。

### 需要时再读

- [Pydantic AI Server 推理](https://powercontext.mintlify.app/zh/frameworks/pydantic-ai-server-inference.md): 配置 Server 相互独立的生成与嵌入模型提供方，并理解其生命周期和失败边界。
- [Pydantic AI Agent 适配器（预览）](https://powercontext.mintlify.app/zh/frameworks/pydantic-ai.md): 查看 future-facing 能力与 工具集 API；当前 PyPI 和 Git 子目录安装都不可用。

## 通用 Agent

### 接入与进阶

- [通用 Agent 总览](https://powercontext.mintlify.app/zh/common-agents/overview.md): 在 Hermes、OpenClaw、WorkBuddy 与 Agent Plugin 之间选路，并把安装、激活、Server 启动和诊断分开处理。
- [Hermes](https://powercontext.mintlify.app/zh/common-agents/hermes.md): 安装模型提供方与命令配套插件，激活 PowerContext，再验证召回、写入、Scope 和 fail-open。
- [OpenClaw](https://powercontext.mintlify.app/zh/common-agents/openclaw.md): 把 PowerContext 装进 OpenClaw Memory 插槽，再验证五个工具、私有会话准入规则、Scope 与 Server 边界。
- [WorkBuddy](https://powercontext.mintlify.app/zh/common-agents/workbuddy.md): 安装 UserPromptSubmit Hook、MCP 与 project-context Skill，验证 additionalContext 召回，并确认显式写入失败可见。
- [Agent Plugin](https://powercontext.mintlify.app/zh/common-agents/agent-plugin.md): 加载便携的 project-context Skill 与 MCP 配置，用显式 Memory 验证 Citation，不假装存在自动召回。
- [让 Agent 自己扩展能力](https://powercontext.mintlify.app/zh/common-agents/agent-self-extension.md): 把精确证据变成经过 Review 的 Skill Revision，再在宿主许可下显式导出。

## 编程 Agent

### 契约

- [编程 Agent 总览](https://powercontext.mintlify.app/zh/coding-agents/overview.md): 比较五种编程 Agent 宿主的成熟度、安装配置、事件、注入、采集、刷新、权限和验证边界。
- [Hooks 与插件](https://powercontext.mintlify.app/zh/coding-agents/hooks-and-plugins.md): 把五种宿主事件模型映射到一份已验证的领域契约，同时不虚构统一 HostAdapter SDK。
- [用 Hooks 扩展](https://powercontext.mintlify.app/zh/coding-agents/extend-hooks.md): 先发现宿主能力，再定义可验证的适配器契约，并在发布前取得真实宿主证据。

### 宿主

- [Codex](https://powercontext.mintlify.app/zh/coding-agents/codex.md): 组合 UserPromptSubmit Hook、HTTP MCP 与 project-context Skill，实现自动召回和显式 Handoff。
- [Claude Code](https://powercontext.mintlify.app/zh/coding-agents/claude-code.md): 安装 UserPromptSubmit + MCP + Skill 插件，并守住 v1 的采集与权限边界。
- [DeepSeek Harness](https://powercontext.mintlify.app/zh/coding-agents/dsh.md): 通过 agent/pre-step 中间件和原生 pc_* HTTP 工具接入 PowerContext。
- [OpenCode](https://powercontext.mintlify.app/zh/coding-agents/opencode.md): 安装原生 Hook，在精确轮次注入召回内容，并通过宿主确认控制持久修改。
- [Pi](https://powercontext.mintlify.app/zh/coding-agents/pi.md): 安装原生软件包，在 before_agent_start 注入上下文，并在生命周期边界刷新已采集的 Source。

## Optional

- [Official Docs](https://oceanbase.github.io/powercontext/)
- [GitHub](https://github.com/oceanbase/powercontext)

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [English (37 pages)](https://powercontext.mintlify.app/_llms/en.txt): Documentation for English.


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