프로젝트 소개
dsh-jailbreak-workflow는 플러그인 패키지 @xiaoso/dsh-workflow-lite에 해당하는 DeepSeek Harness용 소프트 워크플로 플러그인입니다. 캔버스에서 작업 단계를 배치한 다음 전체 프로세스를 하나의 계획 프롬프트로 컴파일하여 현재 세션의 모델이 계획에 따라 실행하도록 합니다.
순차 실행, 병렬 실행, 병합, 조건 분기, 반복 및 되돌리기를 지원합니다. 연결선에는 임의의 조건을 지정할 수 있으므로 단순한 선형 작업뿐 아니라 “검토를 통과하지 못하면 수정으로 돌아가기”, “조건을 충족하면 종료하기”와 같은 복잡한 로직도 표현할 수 있습니다.
플러그인 자체에는 실행 엔진이 없으며 별도의 스케줄링 서비스도 필요하지 않습니다. 단계 스케줄링, 조건 판단 및 작업 실행은 모두 현재 세션의 모델이 수행합니다.
핵심 작동 원리
완전한 워크플로 실행은 세 단계로 나뉩니다.
- 설계: 캔버스에 단계를 추가하고 각 단계의 프롬프트를 작성한 뒤, 연결선으로 실행 순서, 분기 및 반복을 설명합니다.
- 컴파일: 플러그인이 캔버스 내용을 계획 프롬프트로 정리하여 단계 순서, 반복 조건, 입력 리소스 및 예상 결과를 설명합니다.
- 실행: 모델이 계획을 읽고 직접 완료할지, 하위 에이전트에 위임할지 또는 팀을 구성할지 스스로 결정하며 진행 상황을 캔버스에 동기화합니다.
이 설계의 핵심은 프로세스 표현과 모델 실행을 분리하는 것입니다. 캔버스는 계획을 명확하게 설명하고, 모델은 계획을 이해하고 실행합니다.
주요 기능
- 캔버스 편집: 단계와 연결선을 드래그하여 배치하고 통과 또는 실패 분기와 반복을 만들 수 있으며, 한 번의 클릭으로 레이아웃을 정리할 수 있습니다.
- 리소스 구성: 단계별로 읽거나 쓸 파일, 폴더, URL 및 Skill을 지정할 수 있습니다.
- 실행 전 질문: 실행 전에 사용자에게 필요한 정보를 수집한 뒤 답변을 계획과 함께 모델에 제출합니다.
- 모델 협업 편집: 대화에서 모델에게 직접 워크플로를 만들거나 수정하도록 요청할 수 있으며, 수정 결과는 캔버스에 동기화됩니다.
- 실행 상태: 캔버스에서 실시간 진행 상황, 단계별 요약 및 상태를 확인하고 상태를 조정한 뒤 모델에 알릴 수 있습니다.
- 버전 관리: 버전을 저장하고 설명을 추가하며 차이를 비교하고 이전 버전으로 전환할 수 있습니다.
- 가져오기 및 내보내기: 워크플로, 선택한 버전, 파일 및 Skill을
.wflite.zip으로 패키징합니다. - Skill로 내보내기: 버전을
SKILL.md, 작업 설명 및 관련 리소스를 포함하는 Skill로 컴파일하여 다운로드하거나~/.agents/skills에 설치할 수 있습니다. - 워크플로 센터: 여러 세션의 실행 기록, 워크플로, 버전, 메모리 및 플러그인 설정을 한곳에서 관리합니다.
- 다국어 및 테마: 중국어, 영어와 여러 밝은 테마 및 어두운 테마를 지원합니다.
설치 전 준비
이 플러그인은 DeepSeek Harness 0.2.0 및 0.2.1과 해당 프리뷰 버전(예: 0.2.1-rc.2)에 맞게 설계되었습니다. 웹 버전을 사용하는 경우 Node.js 22 이상도 설치해야 합니다.
프로젝트는 아직 실험 단계이므로 이후 버전에서 기능과 데이터 형식이 호환되지 않게 변경될 수 있습니다. 중요한 워크플로는 제때 내보내고 버전을 보관하는 것이 좋습니다.
웹 버전 플러그인 설치
터미널을 열고 플러그인을 DeepSeek Harness의 Web profile에 추가한 다음 웹 버전을 시작합니다.
dsh plugin --profile web add @xiaoso/dsh-workflow-lite
dsh web시작이 완료되면 세션 페이지로 이동합니다. 설치가 성공하면 페이지 상단에 “워크플로” 탭이 표시됩니다.
데스크톱 버전 플러그인 설치
- DeepSeek Harness 사이드바에서 “플러그인”을 엽니다.
- “플러그인 추가”를 선택한 다음 “타사 플러그인 설치”를 클릭합니다.
@xiaoso/dsh-workflow-lite를 입력하고 설치를 확인합니다.- DeepSeek Harness를 다시 시작합니다.
- 세션 페이지로 이동하여 상단에 “워크플로” 탭이 표시되는지 확인합니다.
기본 사용법 1: 모델에게 워크플로 만들기 요청
가장 직접적인 방법은 대화에서 자연어로 작업 단계와 판단 조건을 설명하는 것입니다. 예를 들면 다음과 같습니다.
워크플로를 만들어 줘. 먼저 코드를 작성하고 검토한 다음, 검토를 통과하지 못하면 수정으로 돌아가도록 해. 최대 세 라운드로 진행해.모델은 이를 바탕으로 단계를 만들고 검토 분기를 연결하며 반복을 설정합니다. 캔버스에는 생성 결과가 동기화되어 표시됩니다. 실행 전에 다음 항목을 확인해야 합니다.
- 각 단계의 프롬프트가 명확한가.
- “통과”와 “실패” 분기가 올바른 노드에 연결되어 있는가.
- 반복에 명확한 종료 조건 또는 최대 횟수가 설정되어 있는가.
- 입력 파일과 출력 위치가 올바르게 구성되어 있는가.
확인 후 오른쪽 상단의 “실행”을 클릭하거나, 대화에서 모델에게 해당 워크플로를 직접 실행하도록 계속 요청할 수 있습니다.
기본 사용법 2: 워크플로 수동 구성
- “워크플로” 탭을 열고 새 워크플로를 만듭니다.
- 왼쪽 단계 라이브러리에서 필요한 단계를 드래그합니다.
- 각 단계에 모델에게 전달할 프롬프트를 입력합니다.
- 연결선으로 실행 순서를 정하고 필요에 따라 조건, 분기 또는 반복을 추가합니다.
- 단계에 읽거나 쓸 파일, 폴더, URL 또는 Skill을 연결합니다.
- “실행”을 클릭하거나 대화에서 모델에게 현재 워크플로를 실행하도록 요청합니다.
예시: 재작업 반복이 포함된 콘텐츠 프로세스
콘텐츠 작업을 “자료 수집”, “초안 작성”, “품질 검사”, “초안 수정”의 네 단계로 나눌 수 있습니다. 품질 검사를 통과하면 종료하고, 통과하지 못하면 수정 단계로 이동한 뒤 품질 검사로 돌아갑니다. 실제 판단은 모델이 수행하므로 검사 단계의 프롬프트에 통과 기준을 명확하게 작성해야 합니다.
초안이 다음 조건을 충족하는지 확인해 줘:
1. 결론이 자료로 뒷받침되는가;
2. 구조가 완전한가;
3. 명백한 중복이 없는가;
4. “통과” 또는 “실패”를 출력하고 이유를 설명할 것.모든 반복 프로세스에서는 모델이 계속 재작업하는 것을 방지하기 위해 프롬프트나 프로세스 조건에 최대 라운드 수를 추가하는 것이 좋습니다.
실행 진행 상황 추적
“워크플로 설정”을 열고 “실행 상태 기록”을 활성화합니다. 이후 실행할 때마다 독립적인 기록이 생성되고, 캔버스가 실행 진행 상황에 따라 업데이트됩니다. 각 단계의 요약을 확인할 수 있으며 단계 상태를 조정한 뒤 모델에 알릴 수도 있습니다.
워크플로, 버전 및 각 세션의 실행 기록은 캔버스 왼쪽 상단의 “워크플로 센터”에 통합되어 있습니다. 이전 실행을 검토하거나 버전을 전환해야 할 때는 먼저 이곳에서 작업하는 것이 좋습니다.
경로 변수 올바르게 사용하기
리소스 경로와 결과 루트 디렉터리는 {workflow} 및 {instance} 두 변수를 지원합니다. 이를 적절히 사용하면 컴퓨터에 종속된 절대 경로를 워크플로에 기록하는 일을 피할 수 있습니다.
{workflow}: 워크플로 공유 리소스 디렉터리
이 변수는 다음과 같이 리소스의 파일 또는 폴더 경로에 사용할 수 있습니다.
{workflow}/refs/notes.md실행 시 현재 워크플로의 전용 디렉터리로 대체되며 기본 위치는 다음과 유사합니다.
~/.dsh/workflow-lite/assets/<워크플로 이름>/이 디렉터리는 실행 작업 공간에 따라 변경되지 않으며 워크플로 이름을 변경하거나 내보낼 때 함께 처리됩니다. 따라서 참고 자료, 템플릿 및 워크플로에서 장기간 사용하는 파일을 저장하기에 적합합니다. 이전 버전의 {assets}/…도 계속 사용할 수 있으며, 워크플로를 열면 자동으로 {workflow}/…로 변환됩니다.
{instance}: 단일 실행 인스턴스 디렉터리
이 변수는 “워크플로 설정”의 결과 루트 디렉터리에 사용됩니다. 기본 구성 예시는 다음과 같습니다.
.workflow-lite/runs/{instance}/out실행 시 {instance}는 이번 실행의 인스턴스 ID로 대체되므로 각 실행의 결과가 별도로 저장됩니다. 여러 라운드의 결과를 보존하고 비교해야 하는 작업에 적합합니다.
기존 워크플로 가져오기
프로젝트 유지 관리자는 독립적인 dsh-workflows 워크플로 모음을 제공합니다. 그 안의 .wflite.zip 파일을 다운로드한 후 “워크플로 센터”에서 가져올 수 있습니다.
가져오기 패키지에는 워크플로, 지정 버전, 관련 파일 및 Skill이 포함될 수 있습니다. 플러그인은 가져오기 전에 각 항목의 설치 위치를 표시하므로 경로를 확인한 뒤 계속하는 것이 좋습니다.
README에 제공된 “방어구 제작”은 15단계 연구 파이프라인 예시로, 프로브 테스트, 거부 패턴 분석, 맞춤 콘텐츠 생성, API 검증 및 파일 출력을 포함합니다. 이와 같은 연구 워크플로를 사용할 때는 목표, 데이터 출처 및 테스트 동작이 관련 법률, 플랫폼 규정 및 승인 범위에 부합하는지 확인해야 합니다.
캔버스 표시 및 파일 미리 보기
실험적인 캔버스 표시 기능을 사용하면 보드, 이미지, 문서, 로그, 표 및 폴더를 캔버스에 직접 표시하고 실행 중 자동으로 업데이트할 수 있습니다. 반복 작업에서 각 라운드마다 생성된 결과도 다시 확인하고 비교할 수 있습니다.
인스턴스 리소스는 Markdown, HTML 페이지, 이미지 및 폴더 미리 보기를 지원합니다. HTML 페이지는 지속적으로 업데이트되는 보드로 사용할 수도 있으며, 폴더는 좌우 두 열로 탐색합니다. 이 기능은 아직 실험 단계이므로 현재 데이터 형식에 의존한 장기 호환 설계를 해서는 안 됩니다.
워크플로 메모리
“메모리”는 성공적인 방법과 발생한 문제를 Skill로 정리하여 이후 실행에 참고하도록 하는 실험적인 기능입니다. 특정 단계에만 메모리를 활성화할 수도 있고, 단계 라이브러리의 “기본” 그룹에서 “메모리” 노드를 드래그하여 전체 워크플로가 하나를 공유하도록 할 수도 있습니다.
메모리 하나는 하나의 Skill 폴더에 해당하며, 그 안의 “빠른 경로”는 다음 실행을 더 간편하게 수행하는 방법을 기록하는 데 사용됩니다. 실행 중 각 단계가 경험을 응답에 기록하고, 워크플로가 종료된 후 모델이 이를 통합하여 정리합니다.
메모리 기능의 제한
- 여러 인스턴스가 동시에 같은 메모리를 수정할 때 잠금이 적용되지 않으므로 나중에 기록된 내용이 먼저 기록된 내용을 덮어씁니다.
- Skill을 다시 내보내고 덮어써서 설치하면 설치된 Skill에 누적된 메모리가 덮어써집니다.
- 초기의 반복 실행 실험에서는 안정적인 속도 향상이 아직 관찰되지 않았으며, “빠른 경로”를 추가한 실제 효과는 더 많은 워크플로 검증이 필요합니다.
더 복잡하고 제어 가능한 장기 경험 관리가 필요하다면 README에서는 “리소스”와 프롬프트를 함께 사용해 직접 구현할 것을 권장합니다.
고급 활용 권장 사항
검증 가능한 단계 프롬프트 작성
단순히 “결과를 확인해”라고만 작성하지 마세요. 판단 기준, 읽어야 할 입력, 출력 형식, 통과 및 실패 시 수행할 작업을 나열해야 합니다. 모델은 이러한 정보를 바탕으로 조건을 판단합니다.
반복에 경계 설정
반복 연결선으로 재작업 로직을 표현할 수 있지만, 최대 라운드 수, 중지 조건 및 실패 후 처리 방법도 함께 설정하는 것이 좋습니다. 이렇게 하면 무한 반복이나 반복적인 수정의 위험을 줄일 수 있습니다.
공유 리소스와 실행 결과 구분
템플릿, 참고 자료 및 장기 보관 파일은 {workflow} 아래에 저장하고, 각 실행에서 생성되는 보고서, 로그 및 중간 결과는 {instance}가 포함된 디렉터리에 저장합니다. 이렇게 하면 내보내기가 편리하고 여러 실행 결과를 비교하기도 쉽습니다.
중요한 변경 전 버전 저장
프롬프트, 연결선 조건 또는 리소스 경로를 수정하기 전에 버전을 저장하고 설명을 추가하세요. 문제가 발생하면 버전 차이를 비교하거나 이전 버전으로 직접 전환할 수 있습니다.
이식성 향상을 위해 Skill로 내보내기
대상 환경에 플러그인을 설치하지 않는다면 안정적인 버전을 Skill로 컴파일할 수 있습니다. 내보낸 콘텐츠에는 SKILL.md, 각 단계의 작업 설명 및 패키징된 파일과 Skill이 포함되며 독립적인 리소스로 사용할 수 있습니다.
실험적 기능은 신중하게 사용
캔버스 표시와 워크플로 메모리의 동작 및 데이터 형식은 변경될 수 있습니다. 중요한 프로젝트에서는 내보내기 패키지, 핵심 파일 및 버전 설명을 보관하고 유일한 사본을 실험적인 저장 구조에만 두지 마세요.
요약
dsh-jailbreak-workflow는 복잡한 작업을 시각적 캔버스로 변환한 다음, 이를 계획 프롬프트로 컴파일하여 DeepSeek Harness의 현재 세션에 있는 모델이 실행하도록 전달합니다. 간단한 “생성—검사—재작업” 흐름에서 시작해 리소스, 경로 변수, 실행 기록, 버전 관리 및 Skill 내보내기를 단계적으로 추가할 수 있습니다. “플러그인은 계획을 컴파일하고 모델은 실제 조정을 담당한다”는 원칙을 이해하는 것이 안정적인 워크플로를 설계하는 핵심입니다.