전체 아키텍처에서 현재 위치
⚙️코어 엔진
→🔧도구 시스템
→🛡️보안
→🧠컨텍스트
→🤝멀티 에이전트
→🌐생태계
→⚡인프라
1
플러그인 아키텍처
로더, 매니페스트, 설치, 검증
매니페스트설치검증스코프|
utils/plugins/pluginLoader.tsutils/plugins/validatePlugin.ts플러그인 시스템은 46개 모듈로 구성되며, 마켓플레이스 기반 배포, 매니페스트 검증, 보안 블랙리스트를 포함합니다.
src/utils/plugins/pluginLoader.ts
1// src/utils/plugins/pluginLoader.ts — 플러그인 디스커버리2 3// 플러그인 디렉토리 구조:4// my-plugin/5// ├── plugin.json # 매니페스트 (메타데이터)6// ├── commands/ # 슬래시 커맨드7// │ ├── build.md8// │ └── deploy.md9// ├── agents/ # AI 에이전트10// │ └── test-runner.md11// └── hooks/ # 훅 설정12// └── hooks.json13 14// 플러그인 로더가 처리하는 것:15// - 매니페스트 검증 (validatePlugin.ts, 28KB)16// - 훅 설정 로드 + 변수 해석17// - 중복 이름 감지18// - 활성/비활성 상태 관리19// - 에러 수집 및 리포트20 21// 플러그인 컴포넌트 4가지:22type PluginComponent =💡23 | { type: 'command', command: Command } // 슬래시 커맨드24 | { type: 'agent', agent: AgentDefinition } // AI 에이전트25 | { type: 'hook', hook: HookConfig } // 이벤트 훅26 | { type: 'outputStyle', style: OutputStyle } // 출력 스타일2
마켓플레이스와 보안
플러그인 검색, 배포, 블랙리스트
마켓플레이스블랙리스트화이트리스트정책|
utils/plugins/marketplaceManager.tsutils/plugins/pluginBlocklist.ts마켓플레이스 매니저(93KB)는 GCS 기반 공식 마켓플레이스와 커스텀 마켓플레이스를 지원합니다.
플러그인 설치 및 보안
1// 설치 관리 (installed_plugins.json V2 형식)2{3 "version": 2,4 "plugins": {5 "my-plugin": {6 "source": "marketplace",7 "version": "1.0.0",8 "scope": "global", // global | session9 "installedAt": "2026-01-01T00:00:00Z",10 "enabled": true11 }12 }13}14 15// 보안: 블랙리스트 + MDM 정책16// pluginBlocklist.ts → 악성 플러그인 차단17// pluginOnlyPolicy → MDM으로 비플러그인 도구 제한 가능