# 플러그인 공유하기
직접 만든 플러그인을 다른 클리닉과 공유하고 싶으신가요? Clinic-OS HQ 플러그인 스토어에 등록할 수 있습니다.
> 디자인 프리셋을 공유하는 경우는 플러그인이 아니라 **스킨 팩** 경로입니다. 스킨은 현재 [스킨 라이브러리](/skins) 와 [스킨 공유하기](/guide#skin-sharing) 흐름을 사용합니다.
---
## 플러그인 공유 플로우
```
내가 만든 플러그인
│
▼
패키지화 (zip)
│
▼
HQ에 업로드
│
▼
리뷰 & 승인
│
▼
스토어 게시 → 다른 클리닉에서 설치 가능!
```
---
## 1단계: 플러그인 완성도 체크
공유하기 전에 확인하세요:
### 필수 체크리스트
- [ ] `manifest.json` 완성 (모든 필수 필드)
- [ ] 테이블명 `custom_` 접두사 사용
- [ ] 코어 테이블 직접 수정 없음
- [ ] 에러 처리 완료
- [ ] 로컬에서 테스트 완료
### manifest.json 예시
```json
{
"id": "vip-management",
"name": "VIP 회원 관리",
"description": "VIP 회원 등급제 및 포인트 적립 시스템",
"version": "1.0.0",
"author": "My Clinic",
"permissions": [
"read:patients",
"database:read",
"database:write"
],
"tables": [
"custom_vip_members",
"custom_vip_point_history"
]
}
```
---
## 2단계: HQ에 제출
AI에게 요청하면 패키지화와 제출을 한 번에 처리합니다:
```
vip-management 플러그인을 HQ 스토어에 제출해줘
```
AI가 자동으로:
1. `plugin:create` 또는 기존 플러그인 구조 확인
2. manifest.json 검증
3. 패키지(zip) 생성
4. 개발자 인증 확인
5. HQ에 업로드
> **참고:** 개발자 등록이 안 되어 있다면 먼저 [개발자 신청](/plugins/developer-apply) 페이지에서 등록하세요.
---
## 3단계: 리뷰 과정
HQ 팀에서 다음을 검토합니다:
| 검토 항목 | 체크 내용 |
|----------|----------|
| 보안 | 악성 코드, 취약점 스캔 |
| 규칙 준수 | custom_ 접두사, SDK 사용 |
| 품질 | 에러 처리, 코드 품질 |
| 문서화 | 설명, 사용 가이드 |
**리뷰 결과:**
- 승인: 스토어에 바로 게시
- 수정 요청: 피드백 반영 후 재제출
- 거부: 심각한 보안/품질 이슈
---
## 플러그인 업데이트
새 버전을 배포하려면:
1. 버전 번호 올리기 (`manifest.json`)
2. CHANGELOG 작성
3. 새 패키지 업로드
4. 리뷰 (간소화됨)
```json
{
"version": "1.1.0" // 1.0.0 → 1.1.0
}
```
---
## 보안 규칙
다음은 **절대 금지**입니다:
- 동적 코드 실행 (eval, Function 생성자 등)
- 하드코딩된 시크릿 (API 키를 코드에 직접 입력)
- 코어 테이블 직접 수정 (DELETE, ALTER 등)
**올바른 방법:**
```javascript
// SDK를 통한 데이터 접근
const patient = await sdk.patients.get(patientId);
// 설정에서 시크릿 로드
const apiKey = await sdk.settings.get("api_key");
// 커스텀 테이블만 직접 접근
await sdk.database.query(
"SELECT * FROM custom_vip_members WHERE tier = ?",
["gold"]
);
```
---
## 요약
| 단계 | 에이전트 요청 |
|------|--------------|
| 1. 체크 | "manifest.json 검증해줘" |
| 2. 제출 | "이 플러그인 HQ에 제출해줘" |
| 3. 리뷰 | (HQ 팀에서 검토) |
| 4. 게시 | 승인 시 자동 공개 |
---
## 관련 콘텐츠
- 🎯 **직원 투어**: 관리자 패널에서 **플러그인** 투어를 시작하세요
- [플러그인 확장하기](/guide#agent-plugins)
- [에이전트 스킬 카탈로그](/guide#skill-catalog)