플러그인 공유하기
직접 만든 플러그인을 다른 클리닉과 공유하고 싶으신가요? Clinic-OS HQ 플러그인 스토어에 등록할 수 있습니다.
디자인 프리셋을 공유하는 경우는 플러그인이 아니라 스킨 팩 경로입니다. 스킨은 현재 스킨 라이브러리 와 스킨 공유하기 흐름을 사용합니다.
플러그인 공유 플로우
내가 만든 플러그인
│
▼
패키지화 (zip)
│
▼
HQ에 업로드
│
▼
리뷰 & 승인
│
▼
스토어 게시 → 다른 클리닉에서 설치 가능!
1단계: 플러그인 완성도 체크
공유하기 전에 확인하세요:
필수 체크리스트
- [ ]
manifest.json완성 (모든 필수 필드) - [ ] 테이블명
custom_접두사 사용 - [ ] 코어 테이블 직접 수정 없음
- [ ] 에러 처리 완료
- [ ] 로컬에서 테스트 완료
manifest.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가 자동으로:
plugin:create또는 기존 플러그인 구조 확인- manifest.json 검증
- 패키지(zip) 생성
- 개발자 인증 확인
- HQ에 업로드
참고: 개발자 등록이 안 되어 있다면 먼저 개발자 신청 페이지에서 등록하세요.
3단계: 리뷰 과정
HQ 팀에서 다음을 검토합니다:
| 검토 항목 | 체크 내용 |
|---|---|
| 보안 | 악성 코드, 취약점 스캔 |
| 규칙 준수 | custom_ 접두사, SDK 사용 |
| 품질 | 에러 처리, 코드 품질 |
| 문서화 | 설명, 사용 가이드 |
리뷰 결과:
- 승인: 스토어에 바로 게시
- 수정 요청: 피드백 반영 후 재제출
- 거부: 심각한 보안/품질 이슈
플러그인 업데이트
새 버전을 배포하려면:
- 버전 번호 올리기 (
manifest.json) - CHANGELOG 작성
- 새 패키지 업로드
- 리뷰 (간소화됨)
{
"version": "1.1.0" // 1.0.0 → 1.1.0
}
보안 규칙
다음은 절대 금지입니다:
- 동적 코드 실행 (eval, Function 생성자 등)
- 하드코딩된 시크릿 (API 키를 코드에 직접 입력)
- 코어 테이블 직접 수정 (DELETE, ALTER 등)
올바른 방법:
// 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. 게시 | 승인 시 자동 공개 |
관련 콘텐츠
- 🎯 직원 투어: 관리자 패널에서 플러그인 투어를 시작하세요