Loading...
Loading...
利用OpenContext实现AI Agent持久化内存与上下文管理。支持在会话/仓库/日期间维持上下文、保存结论、提供文档检索工作流。
npx skill4agent add supercent-io/skills-template opencontext为AI助手赋予持久化内存。 停止重复说明,更高效地构建项目。
[上下文加载] → [执行任务] → [保存结论]| 项目 | 路径 |
|---|---|
| Contexts | |
| Database | |
npm install -g @aicontextlab/cli
# 或使用npx
npx @aicontextlab/cli <command>cd your-project
oc initoc init| 命令 | 用途 |
|---|---|
| 不知从何入手时使用 |
| (推荐默认) 任务执行前加载背景信息 |
| 检索现有文档 |
| 撰写新文档/创意 |
| 保存结论与引用 |
# Slash Commands
Cursor: ~/.cursor/commands
Claude Code: ~/.claude/commands
# Skills
Cursor: ~/.cursor/skills/opencontext-*/SKILL.md
Claude Code: ~/.claude/skills/opencontext-*/SKILL.md
Codex: ~/.codex/skills/opencontext-*/SKILL.md
# MCP Config
Cursor: ~/.cursor/mcp.json
Claude Code: ~/.claude/mcp.json# 查看文件夹列表
oc folder ls --all
# 创建文件夹
oc folder create project-a -d "My project"
# 创建文档
oc doc create project-a design.md -d "Design doc"
# 查看文档列表
oc doc ls project-a# 检索(关键词/混合/向量)
oc search "your query" --mode keyword --format json
# 生成清单(供AI读取的文件列表)
oc context manifest project-a --limit 10| 模式 | 说明 | 要求 |
|---|---|---|
| 基于关键词检索 | 无需嵌入 |
| 向量检索 | 需要嵌入 + 索引 |
| 混合模式(默认) | 需要嵌入 + 索引 |
# 设置API Key
oc config set EMBEDDING_API_KEY "<<your_key>>"
# (可选)设置Base URL
oc config set EMBEDDING_API_BASE "https://api.openai.com/v1"
# (可选)设置模型
oc config set EMBEDDING_MODEL "text-embedding-3-small"
# 构建索引
oc index buildoc_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 "分析结论"[Claude] 制定计划
↓
[Gemini] 分析/调研 + OpenContext检索
↓
[Claude] 编写代码
↓
[Codex] 执行/测试
↓
[Claude] 汇总结果 + OpenContext保存# 1. [Claude] 基于Skill设计API规格
/opencontext-context # 加载项目背景
# 2. [Gemini] 分析大容量代码库
ask-gemini "分析@src/下的现有API模式"
# 3. [Claude] 基于分析结果编写代码
# (利用从OpenContext加载的上下文)
# 4. [Codex] 测试与构建
shell "npm test && npm run build"
# 5. [Claude] 生成最终报告 + 保存结论
/opencontext-iterate # 保存决策事项与经验教训/opencontext-context/opencontext-search/opencontext-iterate[label](oc://doc/<stable_id>)oc doc link <doc_path>oc_get_link doc_path="Product/api-spec"| 操作 | 方法 | 效果 |
|---|---|---|
| 引用文本片段 | 选中文本 → 右键 → "Copy Citation" | Agent会读取片段 + 来源 |
| 引用文档 | 点击文档标题旁的引用图标 | Agent会获取完整文档 + stable_id |
| 引用文件夹 | 右键文件夹 → "Copy Folder Citation" | Agent会批量读取文件夹内所有文档 |
oc ui
# 默认地址: http://127.0.0.1:4321工作前: /opencontext-context(加载背景)
工作中: /opencontext-search(检索)
工作后: /opencontext-iterate(保存)oc init # 初始化项目
oc folder ls --all # 查看文件夹列表
oc doc ls <folder> # 查看文档列表
oc search "query" # 检索
oc doc create ... # 创建文档oc_list_folders 查看文件夹列表
oc_list_docs 查看文档列表
oc_search 检索
oc_manifest 生成清单
oc_create_doc 创建文档
oc_get_link 生成链接~/.opencontext/contexts 上下文存储库
~/.opencontext/opencontext.db 数据库