프로젝트 소개
푸장 파괴는 DeepSeek Harness를 위한 사용자 지정 프롬프트 및 보안 평가 지원 플러그인입니다. 현재 README에 표시된 버전은 0.20.12입니다. 이 프로젝트는 @deepseek-ai/dsh-prompt-custom을 Harness 설정 디렉터리에 설치하고, 플러그인 프로그램과 prompt-custom.json 프롬프트 설정을 별도로 저장합니다.
플러그인은 사용자 지정 프롬프트, 스킬 라이브러리, 내장 CVE/PoC 지식 베이스, 취약점 보고서 및 침투 테스트 작업 흐름 등의 기능을 제공합니다. 명확한 권한을 획득한 환경에서 자산을 정리하고, 후보 취약점을 매칭하고, 검증 단계를 기록하고, 보고서를 생성하는 데 적합합니다. 지식 베이스의 후보 항목이나 자동화 진행 상태를 이미 확인된 취약점으로 간주해서는 안 됩니다.
프로젝트 이름과 DeepSeek에 대한 언급은 공식적인 보증을 의미하지 않습니다. 사용을 시작하기 전에 저장소의 면책 조항을 읽고, 테스트 대상, 범위 및 작업 방식에 대한 권한을 모두 획득했는지 확인하세요.
주요 기능
- 프롬프트 주입: 입력 상자 근처에서 “푸장 파괴” 상태 전환 및 설정 진입점을 제공합니다. 주입을 끄면 공식 시작 부분으로 복원되며, 사용자가 작성한 프롬프트 본문은 유지됩니다.
- 취약점 보고서: 인공지능이 작성한 취약점 기록을 지속적으로 저장하며, 심각, 높음, 중간, 낮음 및 정보 등급별로 확인할 수 있습니다.
- 스킬 라이브러리: 필요에 따라 REA와 AboutSecurity를 다운로드하고 활성화하거나 비활성화하며, 인공지능이 등록된 스킬 콘텐츠를 검색할 수 있도록 합니다.
- 내장 지식 베이스: 플러그인에 9개 유형의 CVE/PoC 지식이 포함되어 있으며, 활성화 자체에는 추가 다운로드가 필요하지 않습니다.
- 침투 테스트 작업 흐름: 작업, 자산, 검증 단계, 시도 기록, 단계 및 후속 권장 사항을 관리합니다.
- 로컬 지문 매칭: 포트, 서비스 식별자 또는 제품 이름을 기준으로 지식 베이스의 후보 항목을 정렬하고 매칭 이유를 제시합니다.
사용자 지정 프롬프트 인터페이스
사용자 지정 프롬프트 설정은 prompt-custom.json에 별도로 저장되며 개인 설정이 포함될 수 있습니다. 재설치, 백업 또는 배포하기 전에 파일 내용을 공유해도 적절한지 확인해야 합니다.
스킬 라이브러리 및 지식 베이스
스킬 라이브러리는 두 개의 upstream 프로젝트를 지원합니다. REA 리버스 엔지니어링 도구와 AboutSecurity 보안 평가 스킬 라이브러리입니다. 각 서드파티 프로젝트에는 자체 라이선스 조건이 적용됩니다.
내장 지식 베이스는 Java 역직렬화, Java Web, 경계 장비, Exchange 및 도메인 환경, Web 및 CMS, Linux 권한 상승, 클라우드 및 컨테이너, 비즈니스 인터페이스 위험, 취약점 분류 등의 범주를 다룹니다. 각 항목에는 제품, 버전, 포트, 키워드, 심각도, 사전 조건, 수정 권장 사항 및 참고 출처가 기록됩니다.
설치 전 준비
- 지원되는 DeepSeek Harness 버전을 사용하고 있는지 확인합니다. 플러그인은 DeepSeek Harness 및
dsh-system-prompt의>=0.2.1-rc.5 <0.3.0버전과의 호환성을 명시합니다. - Cordis 버전이
>=4.0.5 <5범위인지 확인합니다. - 공식 DeepSeek Harness Desktop을 최소 한 번 시작하여 프로그램이
desktop설정 초기화를 완료하도록 합니다. - 설치 전에 Windows 오른쪽 아래 시스템 트레이 아이콘에서 “종료”를 선택하는 것까지 포함하여 Harness를 완전히 종료합니다.
- 신뢰할 수 있는 출처에서 저장소를 다운로드하고 스크립트를 실행하기 전에 파일 내용을 확인합니다.
설치 스크립트 사용
저장소 페이지에서 Code → Download ZIP을 선택하고 압축을 풀거나 Git으로 저장소를 복제할 수 있습니다. Harness를 완전히 종료한 후 압축을 푼 디렉터리의 点我执行脚本.cmd를 두 번 클릭합니다.
# Harness를 완전히 종료한 후 설치 실행
.\点我执行脚本.cmd
# 설치 계획만 확인하고 파일은 수정하지 않음
.\install.ps1 -DryRun-DryRun은 정식 설치 전에 스크립트가 실행할 작업을 확인하는 데 적합합니다. 설치 프로그램은 기본적으로 desktop 설정을 사용하며 Desktop에 포함된 DSH 명령줄 도구를 우선 호출합니다. 환경을 사용자 지정해야 하는 경우 -Profile, -DshCommand 및 -DshHome을 사용하여 설정 이름, 명령줄 도구 및 데이터 디렉터리를 지정할 수 있습니다.
DSH_HOME이 설정되지 않은 경우 기본 데이터 디렉터리는 $env:USERPROFILE\.dsh입니다. 설치 스크립트는 플러그인을 $DSH_HOME\local-plugins\dsh-prompt-custom에 복사하고, DSH 플러그인 관리자를 사용하여 등록한 다음 함께 제공된 prompt-custom.json을 복사합니다.
기존 프롬프트 설정과 새 설정이 다르면 설치 프로그램은 먼저 기존 파일 옆에 백업을 생성합니다. 등록에 실패하고 백업이 존재하면 스크립트가 기존 프롬프트 설정을 복원합니다. 설치가 성공하면 스크립트는 인접한 위치에 install.log를 기록하려고 시도하지만, 이 파일은 전체 실행 로그가 아닙니다.
설치 프로그램이 Harness가 아직 실행 중임을 감지하면 종료하라는 메시지를 표시하고 중지하며, 이번 실행에서는 파일을 수정하지 않습니다. 설치 프로그램은 Harness를 자동으로 종료하거나 다시 시작하지 않으며
-NoRestart매개 변수를 지원하지 않습니다.
Windows에서 스크립트가 차단될 때
설치 프로그램은 읽을 수 있는 PowerShell 스크립트이며, 주로 파일 복사와 DSH 명령 호출을 수행합니다. README에는 숨겨진 창 실행, 프로세스 강제 종료, 예약 작업 생성 또는 WMI를 통한 프로세스 생성 동작이 포함되어 있지 않다고 설명되어 있지만, 이는 어떤 보안 소프트웨어의 탐지 결과도 의미하지 않습니다.
Windows가 다운로드 출처 표시로 인해 스크립트를 차단하는 경우 먼저 다운로드 출처를 확인하고 스크립트 내용을 검토해야 합니다. 또한 SHA256 체크섬을 계산하여 배포자가 제공한 값과 대조할 수 있습니다.
Get-FileHash .\install.ps1 -Algorithm SHA256파일을 신뢰할 수 있다고 확인한 후에는 Windows 파일 “속성”의 “차단 해제”를 통해 다운로드 출처 표시를 처리할 수 있습니다.
수동 설치 방법
자동 설치 스크립트를 실행하지 않으려면 Harness를 완전히 종료한 후 플러그인을 수동으로 복사하고 등록할 수 있습니다. 다음 명령은 기본 데이터 디렉터리와 Desktop에 포함된 DSH 명령줄 도구를 사용합니다.
$pluginTarget = Join-Path $env:USERPROFILE '.dsh\local-plugins\dsh-prompt-custom'
New-Item -ItemType Directory -Force -Path $pluginTarget | Out-Null
Get-ChildItem -LiteralPath .\plugin -Force | ForEach-Object {
Copy-Item -LiteralPath $_.FullName -Destination $pluginTarget -Recurse -Force
}
& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add $pluginTarget저장소에 포함된 프롬프트 설정도 사용하려면 먼저 기존 $env:USERPROFILE\.dsh\prompt-custom.json을 백업한 다음 새 파일을 복사합니다. 설치를 완료한 후 Harness를 직접 다시 시작해야 합니다.
기본 사용 절차
1단계: 프롬프트 주입 활성화
Harness를 다시 시작한 후 입력 상자 근처에서 “푸장 파괴” 상태 진입점을 찾습니다. 활성화하면 플러그인이 공식 harness:identity 시작 부분을 빈 단락으로 대체합니다. 비활성화하면 공식 시작 부분으로 복원됩니다. 사용자 지정 프롬프트 본문은 삭제되지 않습니다.
2단계: 스킬 라이브러리 설정
설정 패널에서 “스킬 라이브러리”를 열고 필요에 따라 REA 또는 AboutSecurity를 다운로드하여 활성화합니다. AboutSecurity는 GitHub에서 현재 master 브랜치의 압축 파일을 다운로드하고 그 안의 skills/ 디렉터리만 추출합니다. 다운로드 과정에서는 진행률을 표시하고 취소할 수 있습니다.
REA가 요구하는 호환 Node.js 버전은 ^22.23.4 || ^24.22.1 || >=26.12.1입니다. 플러그인이 npm을 통해 REA를 설치할 때 수명 주기 스크립트를 비활성화하므로, 이 설치 방식으로는 Frida의 선택적 네이티브 바인딩이 빌드되지 않습니다. 특정 도구를 실행할 수 있는지는 여전히 로컬 실행 환경과 분석 엔진에 따라 달라집니다.
AboutSecurity는 주로 Markdown 스킬 문서로 구성되며 추가 네이티브 실행 구성 요소가 필요하지 않습니다. 스킬 다운로드가 성공했다는 것은 파일을 가져와 등록했다는 의미일 뿐, 각 도구의 실행 검증이 완료되었다는 의미는 아닙니다.
3단계: 지식 베이스를 사용한 매칭 지원
지식 베이스는 기본적으로 활성화되어 있으며 상태는 $DSH_HOME/fujiang-skills/knowledge-state.json에 저장됩니다. 비활성화하면 플러그인이 더 이상 관련 지식 콘텐츠를 인공지능에 제공하지 않지만 원본 파일은 로컬에 유지됩니다.
권한을 획득한 테스트에서는 먼저 인공지능에 대상 제품, 버전, 포트, 서비스 식별자 및 테스트 범위를 설명한 다음 관련 지식 항목을 검색하도록 요청할 수 있습니다. 예를 들면 다음과 같습니다.
这是一个已获得授权的测试环境。请根据已确认的产品名称、版本和开放端口检索知识库候选项，列出匹配原因、适用前置条件、仍需验证的证据以及修复建议。不要把候选项表述为已确认漏洞。지식 항목은 공개 자료를 정리한 것이며, 일반적으로 verified: false 및 sources: 등의 메타데이터를 통해 검증 상태와 출처를 표시합니다. 실제 사용 시에는 대상 버전, 설정 및 사전 조건을 함께 검토해야 합니다.
4단계: 침투 테스트 작업 흐름 생성
현재 구현에서는 사용자가 먼저 플러그인 패널에서 작업을 생성해야 인공지능이 기존 작업 기록의 자산, 단계 및 결과를 사용할 수 있습니다. 작업 흐름은 다음 단계로 구성됩니다.
- 정보 수집
- 지문 식별
- 취약점 매칭
- 실행 가능성 검증
- 취약점 악용
- 수평 이동
- 보고서 출력
각 작업은 하나의 세션에 연결할 수 있으며, 하나의 세션에는 최대 하나의 작업만 연결할 수 있습니다. 플러그인은 campaign:context를 통해 연결된 인공지능에 작업, 단계, 자산 수 및 후속 권장 사항을 제공합니다.
작업을 생성할 때 권한이 부여된 대상, 허용된 작업 범위, 금지된 작업, 테스트 시간대 및 중지 조건을 명확하게 작성하는 것이 좋습니다. 작업 진행률과 단계는 정보를 정리하기 위한 것이며 취약점 검증 증거를 대신할 수 없습니다.
5단계: 취약점 보고서 기록
검증 결과가 결론을 뒷받침하기에 충분한 경우에만 인공지능에 취약점 기록을 작성하도록 요청합니다. 보고서에는 영향을 받는 자산, 재현 조건, 증거, 영향 판단, 심각도, 수정 권장 사항 및 참고 출처가 포함되어야 합니다. 검증되지 않은 후보 항목은 “검증 대기” 상태로 유지해야 하며, 바로 취약점으로 표시해서는 안 됩니다.
로컬 인터페이스 및 네이티브 도구
플러그인은 로컬 지문 매칭 및 작업 대장 인터페이스를 제공합니다. 매칭 계산과 대장 기록은 로컬에서 수행되지만, 스킬 다운로드, 네트워크 모델 호출 및 실제 대상 검증에서는 네트워크 요청이 발생할 수 있습니다.
POST /api/dsh-prompt-custom/match: 포트, 서비스 식별자 또는 제품 이름을 기준으로 정렬된 지식 베이스 후보 항목과 매칭 이유를 반환합니다. 가중치는 포트 40, 제품 30, CVE 20, 키워드 20, 심각도 5입니다./api/dsh-prompt-custom/campaigns: 테스트 범위, 자산 지문, 실행 단계, 시도 기록 및 작업 단계를 관리합니다. 대장은$DSH_HOME/vuln-report/campaigns.json에 저장됩니다.GET ?id=: 지정된 작업과 다음 단계 권장 사항을 읽습니다.
작업 인터페이스는 bind, unbind, kick 등의 작업도 제공합니다. 기본 도구에는 kb_match, campaign_upsert, finding_upsert, pipeline_next가 있으며, 스킬 검색 진입점에는 skill_search와 skill_read가 포함됩니다. 기본 도구 등록에는 해석 가능한 DSH 도구 서비스가 필요합니다.
고급 사용 권장 사항
먼저 DryRun으로 설치 계획 확인
처음 설치하거나 구성 디렉터리를 변경할 때는 먼저 .\install.ps1 -DryRun을 실행하세요. 이를 통해 대상 경로, 구성 이름 및 예상 작업을 확인하면서 파일이 즉시 수정되는 것을 방지할 수 있습니다.
플러그인과 개인 프롬프트를 별도로 백업
prompt-custom.json은 플러그인 프로그램과 별개이며 개인 설정을 포함할 수 있습니다. 업그레이드하거나 재배포하기 전에 이 파일을 별도로 백업하고 검토하여 사용자 지정 내용이 덮어쓰이거나 민감한 정보가 실수로 공유되지 않도록 해야 합니다.
후보 매칭과 실제 취약점 구분
핑거프린트 매칭은 포트, 제품, CVE, 키워드 및 심각도를 기준으로 후보 항목의 순위를 정할 뿐입니다. 순위가 높다고 해서 대상이 반드시 영향을 받는 것은 아닙니다. 버전, 배포 방식, 패치 상태, 사전 조건 및 실제 증거를 계속 확인해야 합니다.
자동 재실행은 신중하게 사용
자동 재실행은 기본적으로 최대 8라운드까지 수행하며, 정체 판단과 다음 단계 제안을 포함합니다. 사용할 때는 명확한 권한 범위와 중지 조건을 설정하고 지속적으로 사람이 검토하여, 모델이 컨텍스트 부족으로 부적절한 후속 작업을 실행하지 않도록 해야 합니다.
지식 베이스 업데이트 방식 이해
지식 항목은 plugin/knowledge/에 있으며, 항목을 로드할 때마다 파일을 다시 읽으므로 내용 업데이트가 이후 호출에 반영될 수 있습니다. 분류 정의는 lib/knowledge.js에 있습니다. 분류를 수정한 경우 플러그인을 다시 로드해야 합니다.
입력 단축키 문제 점검
README에는 알려진 상황이 기록되어 있습니다. 면책 조항 팝업을 닫은 후에도 Enter 또는 Esc의 리스너가 입력과 단축키에 계속 영향을 줄 수 있습니다. 문제가 발생하면 먼저 이 알려진 문제와 관련이 있는지 확인한 다음 플러그인을 다시 로드하거나 Harness를 재시작할 수 있습니다.
호환성 및 검증 범위
플러그인은 공개된 systemPrompt, skills, tools, 에이전트 수명 주기 및 webServer 서비스를 통해 작동하며, Harness 프로그램 파일을 수정하여 설치하지 않습니다. 설치 후에는 Harness를 완전히 종료한 다음 다시 시작해야 합니다.
README에 따르면 현재 버전은 파일 구조와 설치 로직을 확인했지만, 모든 기능의 실제 실행 검증을 다시 완료한 것은 아닙니다. 따라서 이를 근거로 모든 스킬, CVE 항목 또는 자동화 흐름이 작동한다고 보장할 수 없습니다. 정식 환경에 배포하기 전에 격리되고 권한이 부여된 테스트 환경에서 항목별로 검증해야 합니다.
맺음말
후지에 갑주 파괴는 프롬프트 관리, 보안 스킬, 내장 지식 베이스, 취약점 보고 및 작업 대장을 DeepSeek Harness에 통합합니다. 올바른 사용 방법은 먼저 호환성과 설치 계획을 확인하고, 그다음 스킬과 지식 베이스를 구성한 후, 명확한 권한 범위 안에서 작업을 생성하고 후보를 검증하며 증거를 저장하는 것입니다. 항상 자동화 흐름보다 사람의 검토, 최소 권한 및 신뢰할 수 있는 증거를 우선해야 합니다.