opencontext

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

OpenContext 컨텍스트 관리 (Persistent Memory)

OpenContext 上下文管理（Persistent Memory）

AI 어시스턴트에게 영구 메모리를 부여하세요. 반복 설명을 멈추고, 더 스마트하게 빌드하세요.

为AI助手赋予持久化内存。停止重复说明，更高效地构建项目。

When to use this skill

何时使用该Skill

세션 간 컨텍스트 유지가 필요할 때
프로젝트 배경/결정사항을 기록해야 할 때
이전 결론/교훈을 검색해야 할 때
Multi-Agent 워크플로우에서 지식 공유가 필요할 때
반복적인 배경 설명을 줄이고 싶을 때

需要在会话间维持上下文时
需要记录项目背景/决策事项时
需要检索过往结论/经验教训时
在Multi-Agent工作流中需要知识共享时
想要减少重复的背景说明时

1. 핵심 개념

1. 核心概念

문제점

问题痛点

AI 어시스턴트로 작업할 때 컨텍스트가 손실됩니다 (세션, 레포, 날짜 간). 배경 설명을 반복하고, 결정을 다시 설명하며, 때때로 어시스턴트가 잘못된 가정으로 계속 진행합니다.

使用AI助手工作时，上下文会丢失（跨会话、仓库、日期）。需要重复说明背景、重新解释决策，有时助手还会基于错误假设继续推进工作。

해결책

解决方案

OpenContext는 AI 어시스턴트를 위한 경량 개인 컨텍스트/지식 저장소입니다.

[컨텍스트 로드] → [작업 수행] → [결론 저장]

OpenContext是为AI助手打造的轻量级个人上下文/知识存储库。

[上下文加载] → [执行任务] → [保存结论]

기본 경로

默认路径

항목	경로
Contexts	`~/.opencontext/contexts`
Database	`~/.opencontext/opencontext.db`

项目	路径
Contexts	`~/.opencontext/contexts`
Database	`~/.opencontext/opencontext.db`

2. 설치 및 초기화

2. 安装与初始化

CLI 설치

CLI安装

bash

npm install -g @aicontextlab/cli

bash

npm install -g @aicontextlab/cli

또는 npx 사용

或使用npx

npx @aicontextlab/cli <command>

undefined

npx @aicontextlab/cli <command>

undefined

초기화 (레포 내에서 실행)

初始化（在仓库内执行）

bash

cd your-project
oc init

oc init
수행 작업:

글로벌 컨텍스트 저장소 준비 (최초 실행 시)
선택한 도구에 대한 user-level commands/skills + mcp.json 생성
레포의 AGENTS.md 갱신

bash

cd your-project
oc init

执行
oc init
的操作：

准备全局上下文存储库（首次执行时）
生成所选工具对应的user-level commands/skills + mcp.json
更新仓库的AGENTS.md

3. Slash Commands

초보자 친화 명령어

新手友好命令

Command	용도
`/opencontext-help`	어디서 시작할지 모를 때
`/opencontext-context`	(기본 권장) 작업 전 배경 로드
`/opencontext-search`	기존 문서 검색
`/opencontext-create`	새 문서/아이디어 작성
`/opencontext-iterate`	결론 및 인용 저장

命令	用途
`/opencontext-help`	不知从何入手时使用
`/opencontext-context`	（推荐默认）任务执行前加载背景信息
`/opencontext-search`	检索现有文档
`/opencontext-create`	撰写新文档/创意
`/opencontext-iterate`	保存结论与引用

설치 위치

安装位置

undefined

undefined

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

---

Cursor: ~/.cursor/mcp.json Claude Code: ~/.claude/mcp.json

---

4. 핵심 CLI 명령어

4. 核心CLI命令

폴더/문서 관리

文件夹/文档管理

bash

undefined

bash

undefined

폴더 목록 조회

查看文件夹列表

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

undefined

oc doc ls project-a

undefined

검색 & 매니페스트

检索 & 清单

bash

undefined

bash

undefined

검색 (키워드/하이브리드/벡터)

检索（关键词/混合/向量）

oc search "your query" --mode keyword --format json

매니페스트 생성 (AI가 읽을 파일 목록)

生成清单（供AI读取的文件列表）

oc context manifest project-a --limit 10

undefined

oc context manifest project-a --limit 10

undefined

검색 모드

检索模式

모드	설명	요구사항
`--mode keyword`	키워드 기반 검색	임베딩 불필요
`--mode vector`	벡터 검색	임베딩 + 인덱스 필요
`--mode hybrid`	하이브리드 (기본값)	임베딩 + 인덱스 필요

模式	说明	要求
`--mode keyword`	基于关键词检索	无需嵌入
`--mode vector`	向量检索	需要嵌入 + 索引
`--mode hybrid`	混合模式（默认）	需要嵌入 + 索引

임베딩 설정 (시맨틱 검색용)

嵌入设置（用于语义检索）

bash

undefined

bash

undefined

API Key 설정

设置API Key

oc config set EMBEDDING_API_KEY "<<your_key>>"

(선택) Base URL 설정

（可选）设置Base URL

oc config set EMBEDDING_API_BASE "https://api.openai.com/v1"

(선택) 모델 설정

（可选）设置模型

oc config set EMBEDDING_MODEL "text-embedding-3-small"

인덱스 빌드

构建索引

oc index build

---

oc index build

---

5. MCP Tools

OpenContext MCP Tools

bash

oc_list_folders    # 폴더 목록 조회
oc_list_docs       # 문서 목록 조회
oc_manifest        # 매니페스트 생성
oc_search          # 문서 검색
oc_create_doc      # 문서 생성
oc_get_link        # 안정적 링크 생성

bash

oc_list_folders    # 查看文件夹列表
oc_list_docs       # 查看文档列表
oc_manifest        # 生成清单
oc_search          # 检索文档
oc_create_doc      # 创建文档
oc_get_link        # 生成稳定链接

Multi-Agent 통합

Multi-Agent集成

bash

undefined

bash

undefined

Gemini: 대용량 분석

Gemini：大容量分析

ask-gemini "전체 코드베이스 구조 분석해줘"

ask-gemini "帮我分析整个代码库的结构"

Codex: 명령 실행

Codex：执行命令

shell "docker-compose up -d"

OpenContext: 결과 저장

OpenContext：保存结果

oc doc create project-a conclusions.md -d "분석 결론"

---

oc doc create project-a conclusions.md -d "分析结论"

---

6. Multi-Agent 워크플로우 통합

6. Multi-Agent工作流集成

Orchestration Pattern

编排模式

[Claude] 계획 수립
    ↓
[Gemini] 분석/리서치 + OpenContext 검색
    ↓
[Claude] 코드 작성
    ↓
[Codex] 실행/테스트
    ↓
[Claude] 결과 종합 + OpenContext 저장

[Claude] 制定计划
    ↓
[Gemini] 分析/调研 + OpenContext检索
    ↓
[Claude] 编写代码
    ↓
[Codex] 执行/测试
    ↓
[Claude] 汇总结果 + OpenContext保存

실전 예시: API 설계 + 구현 + 테스트

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

bash

undefined

bash

undefined

1. [Claude] 스킬 기반 API 스펙 설계

1. [Claude] 基于Skill设计API规格

/opencontext-context # 프로젝트 배경 로드

/opencontext-context # 加载项目背景

2. [Gemini] 대용량 코드베이스 분석

2. [Gemini] 分析大容量代码库

ask-gemini "@src/ 기존 API 패턴 분석"

ask-gemini "分析@src/下的现有API模式"

3. [Claude] 분석 결과 기반 코드 구현

3. [Claude] 基于分析结果编写代码

(OpenContext에서 로드한 컨텍스트 활용)

（利用从OpenContext加载的上下文）

4. [Codex] 테스트 및 빌드

4. [Codex] 测试与构建

shell "npm test && npm run build"

5. [Claude] 최종 리포트 생성 + 결론 저장

5. [Claude] 生成最终报告 + 保存结论

/opencontext-iterate # 결정사항 및 교훈 저장

---

/opencontext-iterate # 保存决策事项与经验教训

---

7. 권장 일일 워크플로우

7. 推荐日常工作流

작업 전 (1분)

工作前（1分钟）

bash

/opencontext-context

프로젝트 배경 + 알려진 함정 로드

bash

/opencontext-context

加载项目背景 + 已知的陷阱

작업 중

工作中

bash

/opencontext-search

불확실할 때 기존 결론 검색

bash

/opencontext-search

不确定时检索过往结论

작업 후 (2분)

工作后（2分钟）

bash

/opencontext-iterate

결정사항, 함정, 다음 단계 기록

bash

/opencontext-iterate

记录决策事项、陷阱、下一步计划

고ROI 문서 유형

高ROI文档类型

Acceptance Criteria - 수락 기준
Common Pitfalls - 자주 발생하는 함정
API Contracts - API 계약
Dependency Versions - 의존성 버전

Acceptance Criteria - 验收标准
Common Pitfalls - 常见陷阱
API Contracts - API契约
Dependency Versions - 依赖版本

8. 안정적 링크 (Stable Links)

8. 稳定链接（Stable Links）

문서 ID 기반 참조로 이름/이동에도 링크 유지:

markdown

[label](oc://doc/<stable_id>)

基于文档ID的引用，即使重命名/移动也能保持链接有效：

markdown

[label](oc://doc/<stable_id>)

CLI로 링크 생성

通过CLI生成链接

bash

oc doc link <doc_path>

bash

oc doc link <doc_path>

MCP로 링크 생성

通过MCP生成链接

bash

oc_get_link doc_path="Product/api-spec"

bash

oc_get_link doc_path="Product/api-spec"

9. Desktop App & Web UI

9. 桌面应用 & Web UI

Desktop App (권장)

桌面应用（推荐）

네이티브 UI로 컨텍스트 관리/검색/편집
CLI 없이 사용 가능
자동 인덱스 빌드 (백그라운드)

인용 기능:

액션	방법	효과
텍스트 스니펫 인용	텍스트 선택 → 우클릭 → "Copy Citation"	Agent가 스니펫 + 출처 읽음
문서 인용	문서 제목 옆 인용 아이콘 클릭	Agent가 전체 문서 + stable_id 획득
폴더 인용	폴더 우클릭 → "Copy Folder Citation"	Agent가 폴더 내 모든 문서 일괄 읽음

通过原生UI管理/检索/编辑上下文
无需CLI即可使用
自动构建索引（后台运行）

引用功能：

操作	方法	效果
引用文本片段	选中文本 → 右键 → "Copy Citation"	Agent会读取片段 + 来源
引用文档	点击文档标题旁的引用图标	Agent会获取完整文档 + stable_id
引用文件夹	右键文件夹 → "Copy Folder Citation"	Agent会批量读取文件夹内所有文档

Web UI

bash

oc ui

bash

oc ui

기본 주소: http://127.0.0.1:4321

默认地址: http://127.0.0.1:4321

---

---

Quick Reference

快速参考

필수 워크플로우

必备工作流

작업 전: /opencontext-context (배경 로드)
작업 중: /opencontext-search (검색)
작업 후: /opencontext-iterate (저장)

工作前: /opencontext-context（加载背景）
工作中: /opencontext-search（检索）
工作后: /opencontext-iterate（保存）

핵심 CLI 명령어

核心CLI命令

bash

oc init              # 프로젝트 초기화
oc folder ls --all   # 폴더 목록
oc doc ls <folder>   # 문서 목록
oc search "query"    # 검색
oc doc create ...    # 문서 생성

bash

oc init              # 初始化项目
oc folder ls --all   # 查看文件夹列表
oc doc ls <folder>   # 查看文档列表
oc search "query"    # 检索
oc doc create ...    # 创建文档

MCP Tools

oc_list_folders  폴더 목록
oc_list_docs     문서 목록
oc_search        검색
oc_manifest      매니페스트
oc_create_doc    문서 생성
oc_get_link      링크 생성

oc_list_folders  查看文件夹列表
oc_list_docs     查看文档列表
oc_search        检索
oc_manifest      生成清单
oc_create_doc    创建文档
oc_get_link      生成链接

경로

路径

~/.opencontext/contexts      컨텍스트 저장소
~/.opencontext/opencontext.db  데이터베이스

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