项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1535
使用教程
环境要求
- Git
- uv（Python 包与工具管理器，可自动准备 Python）
- Python 3.11+（可由 uv 自动安装）
- 目标 Agent 的 CLI（如 Codex / Claude Code）
- macOS 或 Linux；Windows 支持为 experimental
安装与启动步骤
-
1安装 CLI 工具
用 uv 安装 1.0.0 稳定版，包含 cli 与 server 两组功能；如依赖下载慢可参考官方镜像重试说明。
uv tool install --force "powercontext[cli,server]==1.0.0" -
2创建配置目录
在一个专用目录中初始化配置，后续所有命令都在此目录下执行，避免污染其他工程。
mkdir -p powercontext-config cd powercontext-config -
3运行配置向导
交互式向导会询问存储、本地/远程访问、记忆能力、Dashboard、模型 API 与 Agent 连接，并生成 .env。
powercontext config init --language en --output .env -
4启动 Server
在当前终端启动服务并保持运行不要关闭；若需 seekdb，向导会提示一次并在后台安装依赖。
powercontext server run --env-file .env -
5验证客户端连接
另开一个终端回到配置目录，只加载客户端设置，然后检查连通性与可用能力。
set -a . ./.env set +a powercontext ready powercontext capabilities -
6接入 Agent 集成
按 .env.next-steps.md 创建并绑定 Scope、安装对应插件；以 Codex 为例执行安装与体检命令。
powercontext setup codex --ref powercontext-v1.0.0 powercontext doctor codex
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--env-file | 是 | 启动 Server 时指定向导生成的 .env 环境文件 | powercontext server run --env-file .env |
--language | 否 | 指定配置向导的交互语言 | en |
--output | 否 | 指定向导写入的环境文件名 | .env |
--ref | 否 | 安装 Agent 集成时指定版本引用 | powercontext-v1.0.0 |
--allow-insecure-http | 否 | 远程 HTTP 地址自动化安装时的显式同意开关 | --allow-insecure-http |
如何确认成功
在第二个终端执行 powercontext ready 与 powercontext capabilities 正常返回，且 powercontext doctor codex 通过集成检查。
常见问题
Q：Python 依赖下载慢或失败怎么办？
A：按官方提供的镜像重试说明操作：在 install-and-run 文档的 Retry dependency downloads with a mirror 一节中给出了镜像下载的配置方式。
Q：需要额外的模型 API 凭据吗？
A：向导中选 Full memory capabilities 需要单独的 Generation 与 Embedding API 凭据，Agent 订阅不提供这类 Server 凭据；选 Basic memory 则无需额外模型 API 即可显式存取记忆。
Q：可以连接另一台机器上的 Server 吗？
A：可以，但需使用 HTTPS，或按远程连接指南操作；安装程序会识别来自参数或环境变量的远程 HTTP 地址并请求明确同意，自动化安装需加 --allow-insecure-http。
Q：各 Agent 集成的支持程度如何？
A：Codex 标记为 official，其他宿主与 Python Agent 框架为 community，Bub 仅用于 evaluation，具体可用功能见官方能力矩阵。
注意事项
- Server 必须在原终端持续运行，验证连接与体检需另开终端。
- 向导会生成 .env 和 .env.next-steps.md 两个文件，后续 Scope 绑定与插件安装按 next-steps 文档继续。
- Windows 为实验性支持，建议在 macOS 或 Linux 上部署。
- 除 CLI 外还可用异步 Python 客户端、HTTP API、MCP 或进程内 Core SDK 接入。
核心亮点
- 提供精准的记忆检索，减少无关信息干扰
- 响应速度快，记忆读写延迟低
- 成本优化设计，降低长期记忆存储开销
不足之处
- 文档/社区待观察
- 早期项目，功能稳定性未经大规模验证
适用场景
- 构建具备长期用户记忆的聊天机器人
- 为 AI 助手提供跨会话的偏好和行为学习
- 在复杂多轮任务中保留关键上下文信息
替代项目
Mem0、MemGPT、LangMem
上一篇：okf-skills
下一篇：mcpls
同类项目推荐
MineEcho
开源
给 AI 装上永久记忆，本地运行省 token
Local-first Memory OS for personal AI assistants with L0-L3 memory, Wiki++ knowledge···
serena
开源
让 AI 像人翻书一样搜代码，改哪里一眼定位。
A powerful MCP toolkit for coding, providing semantic retrieval and editing capabili···
Interactive-LLM-Powered-NPCs
开源
让游戏NPC拥有大模型大脑，实现动态对话与自主行动
Interactive LLM Powered NPCs, is an open-source project that completely transforms y···
ouroboros
开源
告别反复提示，用规范文件直接驱动 AI 智能体干活
Agent OS: the agent gets smarter on its own. We just hold the line: Interview-gated,···
Linghun
开源
让 AI 写代码不再胡说，证据驱动抗幻觉
AGI-oriented, hallucination-resistant AI coding runtime grounded in evidence, tools,···
qbit
开源
在终端里用自然语言指挥 AI 干活，自动执行复杂命令。
agentic terminal application
aeon
开源
配置一次，让 AI 智能体全自主干活，彻底告别人工审批和盯梢。
The most autonomous AI agent framework: runs unattended on GitHub Actions, self-heal···
ai4s-skills
开源
让科研智能体自动完成文献调研到论文写作全流程
Open-source agent skills for AI for Science: topic exploration, literature survey, e···
mcd-1024-skill
开源
把麦当劳点餐能力封装成 AI 智能体可直接调用的 MCP 技能
McDonald's China MCP innovation skill - entry for MCD Developer Innovation Challenge···