zenstory-ai/oh-story-dsh

Oh Story DSH – DeepSeek Harness를 위한 AI 기반 창의적 워크벤치

개요

• DeepSeek Harness (DSH)(웹 기반 AI 에이전트 플랫폼)용 커뮤니티 플러그인입니다.
• DSH UI에 네 가지 특화 워크벤치를 추가합니다:
  1. 소설 – 장편 픽션 쓰기.
  2. 숏드라마 – 대본, 스토리보드, 비주얼 및 비디오 프롬프트 생성.
  3. 게임 – 소설을 플레이 가능한 웹 게임으로 자동 변환(금병매 기반 데모 포함).
  4. 비디오 요약 – 비디오를 중국어 내레이션 요약으로 변환(선택적 자막 포함).
• 이 플러그인은 DSH의 핵심 에이전트 런타임, 채팅, 모델 처리 또는 권한 시스템을 대체하지 않습니다. 단지 작업공간의 파일에 작동하는 사전 패키징된 스킬, 역할 및 UI 구성 요소 묶음만 포함합니다.

주요 기능

워크벤치	번들 스킬 세트(고정 버전)	주요 진입 명령
소설	Oh Story 0.9.0 – 13개 스킬, 7개 역할	/story, /story-long-write, /story-review
숏드라마	Drama Skills 0.9.0 – 11개 스킬	/short-drama, /short-drama-write, /short-drama-storyboard, /short-drama-edit
게임	NovelToGame 0.6.0 – 7개 스킬(성인 콘텐츠 데모 포함)	/novel-to-game quick, /game-build, /game-qa
비디오	video-recap-skills 0.6.2 – 7개 스킬(UI 진입점 3개)	/video-recap, /video-script, /video-reference

작동 방식

• 모든 창작 산출물은 일반 파일(Markdown, 이미지, 비디오 자산)입니다. 워크벤치는 이러한 파일을 3-패널 UI(파일 트리, 편집기, 채팅)에 투영할 뿐입니다. 에이전트가 파일을 쓰거나 수정하면 편집기가 변경 사항을 추적합니다.
• 미디어 집약적 단계(이미지 생성, 비디오 합성, TTS, 음악)는 선택 사항이며, 적절한 API 키를 환경 변수(예: OPENAI_API_KEY, ARK_API_KEY, MINIMAX_API_KEY)로 노출해야 합니다. 플러그인은 키 존재 여부만 확인하며 자격 증명을 저장하지 않습니다.
• UI는 현재 작업공간에 해당 유형의 프로젝트가 실제로 포함된 경우에만 표시되며, 그렇지 않으면 DSH는 기본 채팅 보기로 대체됩니다.

설치 및 요구 사항

• **Node 24+**가 필요합니다. 한 줄 명령으로 임시 pnpm을 설치하고 플러그인을 DSH 프로필에 추가합니다:

npx -y --package pnpm@11.7.0 \
  --package @deepseek-ai/dsh@0.2.1-rc.2 \
  dsh plugin --profile web add @oh-story/dsh@0.1.18 &&
 npx -y @deepseek-ai/dsh@0.2.1-rc.2 web

• GitHub 릴리스에서 미리 빌드된 .tgz를 설치할 수도 있습니다.
• 비디오 워크벤치에는 호스트 머신에 Python 3.10+ 및 ffmpeg/ffprobe가 필요합니다. 일부 미디어 제공자(Seedance, MiniMax, GPT‑Image‑2)는 추가 환경 변수가 필요합니다.
• 플러그인은 DSH 0.2.1‑rc.2(또는 이전 0.2.0‑rc.2)에 버전 고정되어 있습니다. 버전이 일치하지 않으면 명확한 오류로 거부됩니다.

일반적인 워크플로우

1. DSH 시작 – 로컬 웹 서버가 http://127.0.0.1:3080에서 토큰 기반 로그인과 함께 열립니다.
2. 작업공간 생성 또는 열기 – 스토리, 드라마, 게임 또는 비디오 프로젝트가 포함된 폴더를 DSH에 지정합니다.
3. 명령 실행(예: /story 또는 /short-drama-write). 관련 에이전트가 첫 파일을 작성합니다.
4. 워크벤치 UI 표시 – 생성된 파일을 탐색, 편집하고 에이전트에 계속 프롬프트할 수 있습니다.
5. 미디어 제작 – "제작" 단계에 도달하면 UI가 생성된 프롬프트의 미리 보기를 표시하고 외부 API를 호출하기 전에 확인을 요청합니다.
6. 내보내기 – 완성된 게임은 자체 포함된 index.html로 제공됩니다. 비디오 요약은 outputs/에 저장됩니다.

사용 이유

• DeepSeek Harness의 에이전트 우선 접근 방식을 좋아하고 장편 또는 멀티모달 스토리텔링을 위한 더 풍부한 UI를 원하는 경우.
• 수동으로 각 스킬 저장소를 설치하지 않고 필요한 모든 스킬(소설 쓰기, 드라마 스토리보드, 게임 변환, 비디오 요약)을 번들한 단일 재현 가능한 환경이 필요한 경우.
• 파일 중심 워크플로우를 원하는 경우: 모든 것이 로컬 디렉토리에 있어 버전 관리와 백업이 간단합니다.

제한 사항

• 플러그인은 자체 모델 서빙을 제공하지 않습니다. DSH에서 모델 제공자(DeepSeek, OpenAI 등)를 구성해야 합니다.
• 미디어 생성은 타사 API에 의존합니다. 필요한 키가 없으면 텍스트 전용 산출물을 생성할 수 있지만 이미지, 비디오 또는 오디오는 생성할 수 없습니다.
• 데모 게임에는 성인 콘텐츠(18+)가 포함되어 있으며 연령 확인을 요청합니다.

라이선스

• MIT 라이선스에 따라 배포됩니다.

추가 리소스

• 프로젝트 홈페이지: https://zenstory.ai/zh/dsh
• 아키텍처 세부 사항: docs/ARCHITECTURE.md
• 검증 및 테스트 범위: docs/VALIDATION.md
• 기여 가이드: CONTRIBUTING.md