DeepSeek Harness Creator 로 소형 플러그인 구축하기

유용한 첫 번째 Harness 플러그인은 역할이 좁고 결과가 눈에 띄어야 합니다. 파일을 편집하거나 외부 서비스를 호출하거나 자격 증명을 동시에 관리하는 확장 프로그램보다 고정된 프로젝트 체크리스트를 표시하는 패널이 학습 연습으로 더 적합합니다. 소규모 버전이 작동하면 추가 변경을 위한 기준점이 생깁니다.

Harness dsh-v0.2.1-alpha.1(2026 년 10 월 3 일 출시) 은 준비된 초안으로 Creator 모드를 여는 플러그인 관리자 항목을 추가합니다. 이 튜토리얼은 해당 워크플로우를 사용하여 로컬 플러그인을 설계하고 검사합니다. 단계는 버전 고정 문서를 따르며, 예시는 검증 테스트 연습이지 생성된 패키지가 이미 실제 Harness 테스트를 통과했다는 주장이 아닙니다.

검사할 수 있는 작업 공간 준비

버전을 확인한 설치본, 구성된 모델 제공자, 그리고 이 연습을 위한 빈 디렉토리를 사용하십시오. Harness 가 처음이라면 먼저 로컬 빠른 시작 을 완료하십시오. 중요한 프로젝트의 유일한 복사본과는 분리하여 연습하십시오.

출력 결과는 플러그인 소스 디렉토리와 해당 버전의 Harness 가 이를 로드하는 방법에 대한 짧은 설명이어야 합니다. 단일 TypeScript 파일이 플러그인 관리자를 통해 설치 가능하다고 가정하지 말고, 에이전트에게 패키지 진입점, 종속성 및 번들 구성을 식별하도록 요청하십시오.

구체적인 검증 목표를 선택하십시오: 세 개의 고정 행이 있는 Project checklist 라는 제목의 패널입니다. 첫 번째 버전은 파일을 자동으로 검색하거나 상태를 저장해서는 안 됩니다. 이는 추후 합리적인 기능이지만, 각각 검토하고 테스트해야 하는 동작을 추가합니다.

Creator 열기 및 초안 검사

사이드바에서 Plugins 을 엽니다. Add plugin 옆의 화살표를 사용한 후 Let the agent create a plugin 을 선택하십시오. 관련 사전 설정 UI 가 이를 제공할 때 플러그인 관리자 참조 가 이 동작을 문서화합니다.

이 동작은 Creator 모드를 엽니다. 요청을 보낼 때까지 생성을 시작하지 않습니다. 선택된 작업 공간과 유지된 파일, 폴더 또는 세션 참조를 확인하십시오. 오래된 참조는 에이전트가 수정해야 한다고 생각하는 프로젝트를 알지 못하는 사이에 변경할 수 있습니다.

개수를 세고 확인할 수 있는 결과가 있는 요청을 사용하십시오:

이 빈 작업 공간에 대한 로컬 Harness 플러그인을 생성하십시오. 여기에 설치된 Harness 버전을 대상으로 삼고 API 를 선택하기 전에 사용 가능한 문서를 검사하십시오. 정확히 세 개의 정적 행이 있는 Project checklist 패널을 추가하십시오: Review inputs, Inspect output, Record result. 네트워크 요청, 자격 증명, 자동 파일 쓰기 또는 백그라운드 타이머를 사용하지 마십시오. 편집하기 전에 생성할 파일을 식별하십시오. 이후에 로컬 번들을 로드하는 방법과 비활성화하는 방법을 설명하십시오. 실행하지 못한 검증 사항을 보고하십시오.

제약 조건은 연습을 소규모로 유지합니다. 또한 예상치 못한 종속성을 쉽게 발견하게 합니다. 정적 패널용 패키지는 HTTP 클라이언트나 스케줄링 서비스를 도입할 이유가 거의 없습니다.

Start using deepseek harness

설치 전 생성된 구조 읽기

공식 첫 번째 플러그인 튜토리얼 은 기본 Cordis 모델을 설명합니다: 플러그인은 apply 함수를 내보내며, 전달된 컨텍스트에서 기능을 등록합니다. 따라서 컨텍스트는 생성된 코드가 무엇을 할지 추적할 때 유용한 시작점입니다.

해당 입문 예제는 배포 가능한 UI 번들에 대한 완전한 레시피가 아닙니다. 생성된 패널의 경우, 에이전트에게 실제 진입점부터 등록 및 렌더링 코드까지 추적하도록 요청하십시오. 관련 없는 애플리케이션 프레임워크 튜토리얼을 읽지 않고도 모든 소스 파일이 존재하는 이유를 설명할 수 있어야 합니다.

패키지 매니페스트와 설치 스크립트도 검사하십시오. 종속성이 의도된 구현에 속하는지, 참조된 파일이 존재하는지, 명령이 실제 프로젝트 디렉토리를 사용하는지 확인하십시오. 에이전트가 빌드가 통과했다고 말하면 명령과 그 종료 결과를 유지하십시오. 빌드에 대한 그럴듯한 설명은 빌드 출력물이 아닙니다.

검사 항목	찾을 증거
진입점	매니페스트 또는 번들 구성이 실제 파일을 가리킴
패널 등록	특정 호출이 플러그인을 가시적 UI 에 연결함
종속성	추가된 각 패키지에 설명된 목적이 있음
라이프사이클	플러그인 비활성화 시 기여 기능이 깔끔하게 제거됨
검증	명령, 결과 및 잔여 미테스트 동작이 명시됨

로컬 번들 설치 및 로드된 버전 확인

Plugins → Add plugin 으로 돌아가십시오. 관리자는 레지스트리 패키지 및 Git 소스뿐만 아니라 절대 로컬 디렉토리도 허용합니다. 소스 파일이 포함된 중첩 폴더가 아니라 생성된 설치 지침에서 번들 루트로 식별된 디렉토리를 사용하십시오.

설치 미리 보기 및 신뢰 알림을 읽은 후 관련 번들 또는 플러그인 행을 설치하고 활성화하십시오. 관리자는 설치된 번들과 설정에 표시된 내장 인벤토리를 구분합니다. 패널이 없으면 소스 코드를 변경하기 전에 의도된 행이 활성화되었는지 확인하십시오.

패키지 ID 와 표시된 버전을 테스트 노트와 함께 유지하십시오. 10 월 릴리스는 버전 보고 및 코드 소스 가시성을 개선합니다. 그렇지 않으면 오래된 설치 패키지가 올바른 편집이 효과 없어 보이게 할 수 있습니다. 개발 디렉토리 감시와 설치된 패키지 버전 교체는 다른 경로이며, 후자는 여전히 재시작이 필요합니다.

전체 활성화 및 비활성화 사이클 테스트

먼저 플러그인을 활성화하고 패널을 검사하십시오. 행의 수를 세고, 순서를 확인하며, 텍스트가 요청과 일치하는지 확인하십시오. 그런 다음 플러그인을 비활성화하고 패널이 사라지는지 확인하십시오. 다시 활성화하여 중복 항목이나 남은 요소 없이 한 번 나타나는지 확인하십시오.

다음으로 생성된 번들에 대한 문서화된 개발 워크플로우를 사용하여 소스에서 한 행의 텍스트를 변경하십시오. 가시적 패널이 편집을 반영하는지 확인하십시오. 그렇지 않다면 에이전트에게 구성 요소 재작성을 요청하기 전에 로드된 소스 경로와 재시작 요구 사항을 확인하십시오.

마지막으로 애플리케이션을 다시 열고 가시적 검사를 반복하십시오. 어떤 단계가 통과했고 어떤 단계가 재시작이 필요했는지 기록하십시오. 이러한 관찰은 단일 성공 스크린샷보다 플러그인의 실제 라이프사이클에 대해 더 많이 알려줍니다.

올바른 계층에서 장애 진단

패널이 없으면 여러 가지 의미일 수 있습니다: 패키지 경로를 찾지 못함, 번들이 활성화되지 않음, 등록 실패 또는 렌더링 실패. 해당 순서대로 단계를 확인하십시오. 입문 Cordis 문서는 구체적으로 경로 확인 실패가 초기 부팅 동안 덜 뚜렷할 수 있음을 언급하므로, 새 진입점이 아무것도 하지 않는 것처럼 보일 때 경로 철자를 확인하십시오.

오래된 예제의 경우, 제거된 invariant 내보내기 와 메시지 입력 상자의 stats 행에서 activity 및 usage 로의 변경을 주시하십시오. 이들은 0.2.1 릴리스 노트 에 설명된 버전별 마이그레이션 문제입니다. 이들이 호환성 검사를 광범위하게 비활성화하는 이유는 아닙니다.

정적 패널이 통과하면 한 번에 하나의 기능을 추가하십시오. 경로와 실패 동작이 명시적이라면 선택한 로컬 파일 읽기는 관리 가능한 다음 단계입니다. 데이터 영속성과 외부 요청은 별도의 반복으로 남겨두십시오. 나중에 실패를 실제로 작동하는 것으로 관찰한 것과 비교할 수 있도록 작동하는 최소 버전을 유지하십시오.

광범위한 업그레이드 컨텍스트는 Harness 0.2.1 리뷰 를 참조하십시오. 의도한 플러그인이 알림을 트리거하기만 위한 것이라면 먼저 내장 자동화 워크플로우 를 확인하십시오; 호스트 애플리케이션이 이미 필요한 스케줄링 동작을 제공할 수 있습니다.