yjh051108/dsh-router-standard

dsh‑router‑standard

무엇인가요 – DeepSeek Harness (DSH) 에이전트 프레임워크를 위한 연구 수준의 라우터 설정. 세션 내 첫 번째 실제 사용자 메시지를 검사하고, 작업을 분류한 후 DeepSeek V4 모델에 적합한 퍼소나 및 도구 세트(spec / react / weak)를 자동으로 삽입합니다. 라우터는 외부 종속성이 없는 Cord‑is 플러그인으로 작동하며, dsh‑routing‑suite 및 dsh‑super‑injector와 함께 작동합니다.

왜 존재하는가 – DeepSeek V4 Pro/Flash 실험 결과, 모델의 퍼소나 축 행동이 세 가지 안정적인 "밴드"(spec / mixed / react)로 수렴하는 것으로 나타났습니다. 모델은 첫 번째 요청 이후 모드를 자동으로 전환할 수 없으므로, 외부 라우터가 사전에 밴드를 결정해야 합니다. 이 설정은 이러한 결정 로직을 코딩하여, 모델이 주어진 작업에 대해 최적의 영역에 머무르도록 합니다.

주요 기능

• 첫 번째 턴 분류 – agent/inbox/claimed 이벤트를 읽고, classifyTask를 실행하여 올바른 밴드(spec / react / weak)를 선택합니다. 더 이상 weak으로의 백업 없음.
• 밴드별 도구 표면 – 각 밴드는 커스터마이징된 핵심 도구 세트(읽기/쓰기/편집, grep, 쉘 등)를 갖으며, weak 세션에서는 사용자 메시지와 동일한 요청 내에 근접 영역 안내 메시지가 삽입됩니다.
• 엄격한 워크플로우 – 0→1→2→3의 단계적 개발 워크플로우로, 모호하거나 복잡한 작업에 대해 명시적인 처리(ask_user_question, todo_write)를 강제합니다.
• 제로 종속성 런타임 – 라우터 핵심(router-core.mjs)은 순수한 ESM JavaScript이며, 부트스트랩 플러그인(router-bootstrap.mjs)은 외부 Node 모듈을 추가하지 않습니다.
• 핫리로드 지원 – dsh‑super‑injector와 함께 사용하면 DSH 런타임을 재시작하지 않고도 설정을 업데이트 가능(dev_reload_preset router‑standard).
• 내장 검증 – dev_page_check는 스크린샷, DOM 스모크, 콘솔/에러/타이틀 검사를 자동으로 실행합니다.
• 개발자 진단 – dev_router_status, dev_router_mode, dev_mode_subagent와 같은 명령어를 통해 현재 밴드, 퍼소나를 확인하고, 다른 추론 모드에서 격리된 서브에이전트를 생성할 수 있습니다.

현재 상태 – 개발 브랜치, 버전 v1.19.1 (2026-08-24). 코드는 "엄격한 워크플로우" 단계에 있으며, 완전한 유닛 테스트 커버리지(router.test.mjs), 진화 기록 문서, 변경 로그를 보유하고 있습니다. 아직 안정된 패키지로 출시되지 않았습니다.

사용 방법

1. 원하는 설정 폴더(router‑standard 또는 router‑spec)를 ~/.dsh/.agent-presets/에 복사합니다.
2. 핫리로드를 활성화하기 위해 dsh‑super‑injector 세트를 설치합니다(해당 리포지토리 참조).
3. 새로운 DSH 세션을 시작하고, 설정을 선택(예: Router Standard (experimental))한 후 세션을 실행합니다.
4. 선택적 CLI 헬퍼:

   dev_router_status                     # 현재 밴드/퍼소나 표시
   dev_router_mode spec|react|weak ...   # 모드 강제 지정
   dev_mode_subagent spec|react task      # 격리된 모드에서 단일 작업 실행
   

5. 설치를 검증하기 위해 테스트 스위트 실행:

   node --test router.test.mjs
   

문서 – 리포지토리는 다음을 포함합니다:

• docs/statement.md 및 docs/apology.md (연구 자료 공지)
• docs/STANDARD-PLAN.md (라우터 개발 로드맵)
• docs/paper.md 및 docs/experiments.md (이론적 배경 및 원시 데이터)
• 변경 로그와 README에 상세한 사용 가이드.

라이선스 – MIT (DeepSeek Harness Standard preset에 기여를 명시해야 함).

---

위 정보는 리포지토리의 README에서 직접 가져왔으며, 외부 가정은 전혀 추가하지 않았습니다.