DDS 플러그인 SDK#

현재 플러그인 개발 상태, 공개 소스 예제와 SDK 공개 범위 설계를 확인합니다.

현재 상태#

2026년 10월 3일 검토 기준입니다. DDS에는 개별 데스크톱 통합과 Verilator 공개 소스 미리보기가 있습니다. 지원되는 독립 플러그인 SDK와 일반적인 외부 플러그인 로더는 아직 출시되지 않았습니다. 아래 공개 방향은 개발 계획이며 안정 API나 설치 명령을 뜻하지 않습니다.

개발 안내는 이 문서에서, 버전별 소스와 기여는 GitHub에서 확인합니다. 설치 가능한 SDK가 출시되면 해당 패키지나 아카이브를 사용합니다. 마켓플레이스 통합은 항목마다 지원 호스트와 실행 제한이 다릅니다.

현재 소스 미리보기 실행#

Verilator 어댑터 소스에는 독자적으로 작성한 실행 인자 계획 코드와 테스트가 있습니다. README는 Node 22를 명시합니다. 소스를 검토한 뒤 테스트를 실행할 수 있습니다.

git clone https://github.com/Altifigence/dds-verilator-plugin.git
cd dds-verilator-plugin
npm test

0.1.0은 제한된 저장 소스 묶음을 검증하고 lint 명령 계획을 만듭니다. 워크스페이스 파일을 읽거나 Verilator를 다운로드·실행하거나 DDS에 설치하지 않습니다. 매니페스트는 DDS 호스트가 소비하지 않는 초안입니다. 저장소 소스는 공개되어 있고 npm 패키지 발행은 비활성화되어 있습니다.

공개 SDK에 포함할 내용#

제안하는 SDK는 독립적으로 이해하고 테스트할 수 있는 작은 개발 패키지입니다. API 설명과 함께 실제 사용할 코드와 예제를 제공합니다. 공개 파일마다 명확한 라이선스와 검토된 출처가 필요합니다.

공개 자료	목적
버전이 있는 매니페스트·권한·메시지·결과 스키마	플러그인 식별, 호환성, 선언한 접근 범위와 입출력을 검증
작은 타입 정의·검증 코드·호스트 호출 인터페이스	엔진 전체를 가져오지 않고 편집기 지원과 일관된 오류 제공
모의 호스트에서 작동하는 예제와 계약 테스트	운영 자격 증명 없이 첫 예제와 취소·실패 사례 실행
API 레퍼런스·호환성 표·릴리스 노트	호스트 지원, 변경 사항, 이전 방법과 정확한 배포 패키지 설명

공개 패키지에 DDS 비공개 UI, 엔진 구현, 계정·결제 서비스, 호스트 서명 키, 자격 증명, 고객 데이터나 실행 정책 내부 코드를 넣을 필요는 없습니다. API 선언을 공개해도 파일·네트워크·프로세스·Cloud 접근 권한이 부여되지는 않습니다. 실제 권한 판단은 호스트가 담당합니다.

언어 플러그인과 호스트 지원#

설계 대상은 자동 완성, 호버, 시그니처, 정의·참조 이동, 문서 심볼과 진단입니다. 등록·해제, 문서 버전, 취소, 결과 크기 제한과 지원하지 않는 호스트의 오류를 정의해야 합니다. 아직 제안 단계의 계약이며 지금 호출할 수 있는 공개 등록 API는 없습니다.

Windows 데스크톱, Linux 데스크톱과 브라우저 Cloud는 지원 기능을 따로 선언해야 합니다. 모의 호스트 테스트는 예제 계약의 동작을 보여줍니다. 실제 호환성은 명시한 DDS 버전과 운영체제에서 따로 검증합니다.

성능과 개발 편의성#

처음 사용하는 SDK를 작게 유지합니다. 필요한 API 계열만 불러오고 해당 기능을 사용할 때 플러그인을 활성화합니다.
무거운 분석과 외부 도구는 편집기 스레드 밖에서 실행합니다. 비동기 요청, 입력·출력 한도, 취소와 호스트 자원 제한을 적용합니다.
소스 식별값, 도구 버전과 관련 옵션으로 결과를 캐시하고 이 입력 중 하나라도 바뀌면 무효화합니다.
패키지 크기, 최초 활성화 시간, 메모리, 요청 p50·p95, 취소 응답과 큰 프로젝트 동작을 측정합니다. 같은 예제와 하드웨어에서 비교한 뒤 개선을 주장합니다.
작은 시작 예제 하나, 모의 호스트, 타입이 있는 오류와 업그레이드 안내를 제공합니다. 운영 실행이 출시되기 전에도 예제 소스를 활용할 수 있습니다.

저장소·버전·외부 기여#

SDK는 Altifigence GitHub 조직의 독립 저장소에서 관리할 계획입니다. 처음에는 SDK 코드·예제·계약 테스트를 묶어 한 버전과 일치시킵니다. 도구 어댑터는 유지보수자나 출시 주기가 달라지면 별도 저장소로 나눌 수 있습니다. 카탈로그 항목마다 저장소를 만드는 것 자체가 라이선스상 의무는 아닙니다.

검토한 파일 목록만 공개합니다. 소스·스키마·패키지 내용·라이선스 고지·문서를 같은 버전에 연결하고, 발행 전 DDS 모노레포 밖에서 실제 패키지 아카이브를 테스트합니다. 미리보기는 제한을 명시해야 하며 버전 태그만으로 호스트 호환성이 검증되지는 않습니다.

현재 Verilator 어댑터는 GitHub 저장소에서 소스를 검토할 수 있습니다. 원본 작성 파일에는 Apache-2.0이 적용되고 상위 도구 자료에는 별도 조건이 유지됩니다. 향후 SDK 라이선스는 해당 SDK 저장소와 릴리스에 명시합니다.

업데이트와 보안#

제안하는 유지보수 흐름은 상위 도구의 새 릴리스를 감지하고, 버전을 고정한 업데이트를 준비하고, 격리된 환경에서 라이선스 변경과 호환성을 검사한 뒤 검토 가능한 PR을 만드는 방식입니다. 지원 배포 채널에는 검토한 패키지만 반영해야 합니다. 이 문서가 자동 업데이트나 악성코드 인증 서비스의 출시를 뜻하지는 않습니다.

패키지 서명과 해시는 발행자와 예상한 파일을 확인하는 수단이며 코드의 무해함을 증명하지 않습니다. 선언한 접근 범위와 현재 외부 도구의 경계를 확인하세요. 일반 커뮤니티 플러그인 실행 서비스는 격리·사용량 제한·배포 철회·사고 대응을 갖춘 뒤 제공해야 합니다.