OpenContext 上下文管理 (持久化记忆)

为您的 AI 助手提供持久化记忆。
告别重复的解释，构建更智能的工作流。

何时使用此技能

• 当您需要在不同会话之间保持上下文时
• 当您需要记录项目背景或决策时
• 当您需要搜索之前的结论或经验教训时
• 当您在多智能体工作流中需要知识共享时
• 当您想减少重复的背景解释时

1. 核心理念

问题

在与 AI 助手协作时，上下文信息容易丢失（跨会话、跨仓库、跨时间）。这导致您需要重复解释背景和决策，有时 AI 会基于错误的假设继续工作。

解决方案

OpenContext 是一个为 AI 助手设计的轻量级个人上下文/知识存储工具。

[加载上下文] → [执行工作] → [存储结论]

默认路径

2. 安装与初始化

安装 CLI

npm install -g @aicontextlab/cli
# 或者使用 npx
npx @aicontextlab/cli <命令>

初始化 (在项目仓库内运行)

cd 您的项目目录
oc init

oc init 会执行以下操作：

• 准备全局上下文存储（仅在首次运行时）
• 为所选工具生成用户级的命令/技能以及 mcp.json 配置文件
• 更新仓库中的 AGENTS.md 文件

3. 斜杠命令

新手友好命令

安装位置

# 斜杠命令存储位置
Cursor:      ~/.cursor/commands
Claude Code: ~/.claude/commands

# 技能存储位置
Cursor:      ~/.cursor/skills/opencontext-*/SKILL.md
Claude Code: ~/.claude/skills/opencontext-*/SKILL.md
Codex:       ~/.codex/skills/opencontext-*/SKILL.md

# MCP 配置文件位置
Cursor:      ~/.cursor/mcp.json
Claude Code: ~/.claude/mcp.json

4. 核心 CLI 命令

文件夹与文档管理

# 列出所有文件夹
oc folder ls --all

# 创建新文件夹
oc folder create project-a -d "我的项目"

# 创建新文档
oc doc create project-a design.md -d "设计文档"

# 列出文件夹内的文档
oc doc ls project-a

搜索与清单生成

# 搜索 (支持关键词/混合/向量模式)
oc search "您的搜索词" --mode keyword --format json

# 生成清单 (列出 AI 应该读取的文件列表)
oc context manifest project-a --limit 10

搜索模式

嵌入向量配置 (用于语义搜索)

# 设置 API 密钥
oc config set EMBEDDING_API_KEY "<<您的密钥>>"

# (可选) 设置 API 基础 URL
oc config set EMBEDDING_API_BASE "https://api.openai.com/v1"

# (可选) 设置模型
oc config set EMBEDDING_MODEL "text-embedding-3-small"

# 构建索引
oc index build

5. MCP 工具

OpenContext MCP 工具列表

oc_list_folders    # 列出所有文件夹
oc_list_docs       # 列出指定文件夹下的文档
oc_manifest        # 生成上下文清单
oc_search          # 搜索文档
oc_create_doc      # 创建新文档
oc_get_link        # 生成稳定链接

多智能体集成示例

# Gemini: 用于大规模分析
ask-gemini "分析整个代码库的结构"

# Codex: 用于执行命令
shell "docker-compose up -d"

# OpenContext: 用于存储结果
oc doc create project-a conclusions.md -d "分析结论"

6. 多智能体工作流集成

编排模式

[Claude] 规划
    ↓
[Gemini] 分析/研究 + OpenContext 搜索
    ↓
[Claude] 编写代码
    ↓
[Codex] 运行/测试
    ↓
[Claude] 整合结果并存储到 OpenContext

实践示例：API 设计 + 实现 + 测试

# 1. [Claude] 使用技能设计 API 规范
/opencontext-context   # 加载项目背景信息

# 2. [Gemini] 分析大型代码库
ask-gemini "@src/ 分析现有的 API 模式"

# 3. [Claude] 基于分析结果实现代码
# (使用从 OpenContext 加载的上下文)

# 4. [Codex] 测试和构建
shell "npm test && npm run build"

# 5. [Claude] 创建最终报告并存储结论
/opencontext-iterate   # 存储决策和经验教训

7. 推荐的日常工作流

工作开始前 (1 分钟)

/opencontext-context

• 加载项目背景和已知的常见问题

工作过程中

/opencontext-search

• 不确定时，搜索已有的结论

工作结束后 (2 分钟)

/opencontext-iterate

• 记录决策、遇到的问题和下一步计划

高价值文档类型

• 验收标准 – 功能完成的定义
• 常见陷阱 – 容易出错的地方
• API 契约 – 接口定义和约定
• 依赖版本 – 关键依赖的版本记录

8. 稳定链接

通过引用文档 ID，可以在重命名或移动文档后仍保持链接有效：

[链接标签](oc://doc/<稳定ID>)

通过 CLI 生成链接

oc doc link <文档路径>

通过 MCP 生成链接

oc_get_link doc_path="Product/api-spec"

9. 桌面应用和 Web UI

桌面应用 (推荐)

• 通过原生用户界面管理、搜索和编辑上下文
• 无需使用 CLI
• 后台自动构建索引

引用功能：

Web UI

oc ui
# 默认访问地址: http://127.0.0.1:4321

快速参考

核心工作流

开始前: /opencontext-context (加载背景)
过程中: /opencontext-search (搜索)
结束后: /opencontext-iterate (存储)

核心 CLI 命令

oc init              # 初始化项目
oc folder ls --all   # 列出所有文件夹
oc doc ls <文件夹名>   # 列出指定文件夹内的文档
oc search "查询词"    # 搜索文档
oc doc create ...    # 创建新文档

MCP 工具

oc_list_folders  列出文件夹
oc_list_docs     列出文档
oc_search        搜索
oc_manifest      生成清单
oc_create_doc    创建文档
oc_get_link      生成链接

重要路径

~/.opencontext/contexts      上下文存储目录
~/.opencontext/opencontext.db 数据库文件

参考链接

• OpenContext 官方网站
• 使用指南
• 下载桌面应用
• GitHub 仓库