프로젝트 소개
echocat-skill-panel 3.0은 DSH Desktop Beta용 cordis 플러그인입니다. 모델의 자발적인 보고에 의존하지 않고 세션 이벤트 스트림을 바탕으로 각 대화 라운드에서 실제로 사용된 skill을 추론합니다.
skill이 모델에 의해 자동으로 호출되었는지, 사용자가 /name을 통해 수동으로 호출했는지, 아니면 해당 라운드에서 전혀 호출되지 않았는지와 관계없이 플러그인이 결과를 제공합니다.
세 인터페이스의 역할
플러그인의 세 진입점은 동일한 데이터를 공유하지만 서로 다른 작업 상황에 적합합니다.
- 입력창 위 가로 막대: 한 줄 요약을 상시 표시하며, 클릭하면 전체 보고서를 바로 펼칠 수 있습니다. skill 원클릭 참조를 지원하는 유일한 인터페이스입니다.
- 왼쪽 막대 아이콘: 상시 진입점으로, 클릭하면 중앙 영역에 패널이 열립니다.
- 중앙 패널: 전체 보고서와 skill 목록을 확인할 때 사용합니다.
플러그인 설치
방법 1: GitHub 소스에서 설치
완전한 패키지를 받을 수 있으므로 소스 설치를 권장합니다. PowerShell에서 다음을 실행합니다.
git clone https://github.com/VDERR/echocat-skill-panel-3.0.git
cd echocat-skill-panel-3.0
& ".\安装-3.0.ps1"설치 스크립트는 profile 목록 백업, 미러 처리, 기존 패키지명 정리, 링크 생성, manifest 수정, pnpm install 실행을 차례로 수행합니다.
방법 2: npm 또는 DSH로 설치
플러그인은 npm에 게시되어 있으며 패키지명은 echocat-skill-panel-3.0입니다. DSH에서 설치하도록 할 수 있습니다.
dsh plugin --profile web add echocat-skill-panel-3.0profile 디렉터리에 직접 설치할 수도 있습니다.
npm install echocat-skill-panel-3.0@deepseek-ai/dsh-llm과 @deepseek-ai/schemastery는 선택적 peer dependencies로 선언되어 있습니다. 이들은 DSH 런타임에서 제공되므로 npm은 호스트 버전을 대체할 사본을 추가로 다운로드하지 않습니다.
설치가 완료되면 반드시 DSH Desktop Beta를 다시 시작해야 합니다. host 측 코드는 시작 시 메모리에 로드되므로 host를 수정한 경우에도 다시 시작해야 합니다. 클라이언트 코드만 수정한 경우에는 페이지를 새로 고치면 클라이언트 bundle을 다시 가져올 수 있습니다.
롤백 및 설치 안전성
소스 설치 스크립트는 작업 전에 profile 목록을 백업합니다. 복원이 필요하면 스크립트에서 제공하는 -Rollback 매개변수를 사용할 수 있습니다. 수동 설치, 제거 롤백 및 애플리케이션을 시작할 수 없게 만들 수 있는 강제 제약 사항은 저장소의 설치 안내를 기준으로 확인하세요.
skill 설치
플러그인의 설치 화면을 열면 저장소, 브랜치, 하위 디렉터리를 따로 입력할 필요 없이 작성자가 제공한 전체 주소를 그대로 붙여 넣을 수 있습니다.
예를 들어 다음과 같은 GitHub 하위 디렉터리 주소를 붙여 넣습니다.
https://github.com/owner/repo/tree/main/skills/my-skillhost는 주소 유형을 식별하고 복제할지 다운로드할지 판단한 뒤 링크에서 브랜치와 하위 디렉터리를 분석합니다. 플러그인이 지원하는 입력 형식은 다음과 같습니다.
- GitHub 저장소 홈 주소
- 저장소 내 폴더 링크
SKILL.md파일 링크- ZIP 직접 링크
owner/repo형식- SSH 주소
- 로컬
.md또는.zip파일 업로드 - 완전한
SKILL.md내용 직접 붙여 넣기
대상 위치에 같은 이름의 skill이 이미 있으면 플러그인은 조용히 덮어쓰지 않고 먼저 백업을 만든 후 교체합니다. skill을 삭제할 때도 파일은 백업 디렉터리로 이동하며 영구적으로 강제 삭제되지 않습니다.
각 대화 라운드에서 사용된 skill 확인
평소처럼 DSH에서 대화를 시작하면 됩니다. 각 라운드가 끝나면 플러그인이 세션 이벤트 스트림을 바탕으로 보고서를 생성하고 시스템 기본 알림을 한 번 표시합니다.
- 대화 라운드를 완료합니다.
- 입력창 위 가로 막대의 요약 결과를 확인합니다.
- 가로 막대를 클릭해 해당 라운드의 전체 보고서를 펼칩니다.
- 왼쪽 막대 아이콘을 통해 중앙 패널로 들어가 보고서와 skill 목록을 확인할 수도 있습니다.
이 감지 방식은 모델이 답변에서 무엇을 호출했는지 선언하도록 요구하지 않습니다. 따라서 모델이 설명을 빠뜨리더라도 패널은 이벤트 기록을 바탕으로 결과를 표시합니다.
skill 원클릭 참조 및 호출
입력창 위 가로 막대는 원클릭 참조 기능을 제공하는 유일한 인터페이스입니다. 가로 막대를 펼친 후 대상 skill 카드에서 참조를 클릭하면 플러그인이 해당 호출어를 현재 초안에 추가합니다.
/名字 그런 다음 Enter 키를 눌러 전송하면 수동 호출어로 해당 skill을 호출할 수 있습니다. skill 설치가 완료된 후 표시되는 안내에도 동일한 버튼이 있으므로 설치 직후 참조하여 사용할 수 있습니다.
중국어 표시 이름 설정
플러그인은 skill 자체의 meta.yaml에 있는 display-name-zh 필드로 중국어 이름을 표시합니다. 설치할 때 입력하거나 설치 완료 후 skill 카드에서 수정할 수 있습니다.
- 중국어 이름을 입력하면 패널에서 중국어 이름을 우선 표시합니다.
- 필드를 비워 두면 중국어 표시 이름을 삭제할 수 있습니다.
/名字호출어는 여전히 ASCII 식별자를 사용하며 중국어 표시 이름의 영향을 받지 않습니다.
중국어 이름이 없는 skill의 경우 플러그인이 표시 이름을 자동으로 번역하고 결과를 캐시할 수도 있습니다.
고급 사용 권장 사항
읽기 전용 모드 이해
호스트 환경에서 쓰기를 허용하지 않으면 플러그인이 자동으로 읽기 전용 상태로 전환하고 원인을 설명합니다. 이때도 보고서와 목록은 확인할 수 있지만 설치, 수정 또는 삭제 작업은 호스트 권한의 제한을 받습니다.
백업으로 오작동 방지
같은 이름의 skill을 교체하기 전에 자동으로 백업하며, 삭제 작업도 파일을 강제로 삭제하지 않습니다. 출처가 확실하지 않은 skill을 업그레이드하거나 시험 설치하기 전에는 필요할 때 되돌릴 수 있도록 백업 디렉터리와 profile 목록 백업을 사용할 수 있는지 확인하는 것이 좋습니다.
클라이언트와 host 수정 구분
클라이언트 bundle은 페이지를 열 때 다시 가져오므로 클라이언트만 수정한 경우에는 일반적으로 페이지를 새로 고치면 됩니다. host 측 내용은 DSH 시작 시 메모리에 로드되므로 host를 수정했거나 플러그인 설치를 완료한 경우에는 DSH Desktop Beta를 다시 시작해야 합니다.
다크 테마 및 기타 설정 활성화
플러그인은 다크 테마, 각 라운드 종료 후 시스템 알림, 자동 번역 캐시 및 전체 설정을 지원합니다. 구체적인 옵션과 설치 제한은 설치 안내에서 확인할 수 있습니다.
개발 및 빌드
src/client/를 수정한 경우 클라이언트 빌드 산출물을 다시 생성해야 합니다.
node tools/build-client.mjslib/client.js는 저장소에 반드시 커밋해야 하는 빌드 산출물입니다. 대상 컴퓨터에 도구 체인이 없을 수 있기 때문입니다. src/client/ 수정 사항은 재생성한 파일과 함께 하나의 커밋에 포함해야 합니다. 그렇지 않으면 verify-install.mjs의 bundle 및 패키지 일치성 검사가 실패합니다.
프로젝트 실행 시 추가 의존성은 필요하지 않으며, 두 peer dependencies 모두 host에서 제공합니다. 아키텍처 설계, 설치 엔진의 보안 규칙, 구현상의 함정 및 테스트 세부 사항은 설계 요점에서 확인할 수 있습니다.
요약
echocat-skill-panel 3.0은 skill 호출 추적, 목록 탐색, 설치, 참조, 중국어 표시 및 안전한 제거 기능을 DSH Desktop Beta 안에 통합합니다. 플러그인을 설치하고 애플리케이션을 다시 시작하면 입력창 위 가로 막대에서 각 라운드의 보고서를 빠르게 확인하고, 참조 버튼으로 대상 skill을 초안에 추가할 수 있습니다. 이 프로젝트는 MIT 라이선스를 따릅니다.