T-Auto/dsh-ops

dsh-ops – AI 기반 DSH 셸을 더 효율적으로 만드는 Windows 중심 플러그인

개요 – dsh-ops는 DeepSeek Harness (DSH) 플랫폼용 플러그인으로, 자체 포함된 bash 5.3.15, PowerShell 7.6.6, 몇 가지 작은 Rust 유틸리티를 번들합니다. 목적은 AI 에이전트(예: LLM 기반 코드 생성 또는 데이터 분석 봇)가 Windows x64에서 더 빠르고 낮은 토큰 비용으로 셸 명령을 실행할 수 있게 하여, Windows에 포함된 느리고 오류가 발생하기 쉬운 PowerShell 5를 피하는 것입니다.

AI에게 중요한 이유 – LLM을 사용하여 작업(파일 검색, 로그 파싱, 모델 훈련 스크립트 등)을 오케스트레이션할 때 모델과의 각 왕복은 토큰을 소비합니다. 더 짧고 결정적인 명령 출력은 토큰을 줄이고 모델이 큰 JSON 페이로드를 파싱하는 데 기다리는 시간을 줄입니다. 경량 bash 인터프리터와 Rust 기반 파일 검색/교체 도구를 제공함으로써 dsh-ops는 모델이 읽어야 하는 텍스트 양을 줄여 전체 워크플로우를 가속화합니다.

주요 기능(README에 설명됨)

기능	설명	AI 관련 이점
번들된 bash 5.3.15	DSH 명령의 기본 셸로 실행되며, 필요한 경우에만 PowerShell 7로 폴백합니다.	일관되고 빠른 명령 실행; PowerShell 관련 토큰 낭비 방지.
번들된 PowerShell 7.6.6	bash가 처리할 수 없는 경우 네이티브 Windows 작업을 제공합니다.	추가 설치 없이 모델이 전체 Windows API에 액세스할 수 있게 합니다.
Rust 파일 도구(ops_inspect_local_file, ops_grep, ops_glob, ops_replace)	고성능 텍스트 검색, 정규식 grep, 글로빙, 대량 교체.	간결한 출력(적은 토큰)을 생성하고 LLM이 요청할 수 있는 대용량 파일 작업을 가속화합니다.
백그라운드 작업 관리자(ops_run_background, ops_job_*)	장기 실행 작업(예: 모델 훈련, 시뮬레이션)을 시작, 나열, 종료합니다.	AI가 무거운 작업을 fire-and-forget으로 실행하면서 채팅 응답성을 유지할 수 있습니다.
세분화된 구성 요소 토글	세 가지 구성 요소(셸, 파일 도구, 백그라운드)는 DSH UI 또는 구성 파일에서 활성화/비활성화할 수 있습니다.	개발자가 LLM이 필요로 하는 정확한 기능에 맞게 플러그인을 조정하여 공격 표면과 토큰 노이즈를 줄입니다.
엄격한 JSON 스키마 및 토큰 절약 지침	ops_bash는 알 수 없는 키를 거부하고 짧은 command와 긴 script_path를 분리합니다.	모델 턴 전체를 낭비할 수 있는 잘못된 도구 호출을 방지합니다.

설치 및 수명 주기

• npm 패키지 dsh-ops로 배포됩니다. DSH 플러그인 마켓 또는 npx dsh-ops@latest install --profile <desktop|web|tui>로 설치합니다.
• 세 가지 DSH 프로필을 지원합니다: desktop, web, TUI 제품(dsh-tui).
• 업데이트는 동일한 설치 명령을 다시 실행하여 수행됩니다. 제거는 npx dsh-ops@latest uninstall --profile …로 합니다.
• 모든 바이너리는 번들되어 있으며, 설치 프로그램은 시스템 PATH를 수정하거나 전역적으로 아무것도 설치하지 않습니다.

구성(YAML 스니펫)

config:
  enableShellTools: true          # 백그라운드 구성 요소 활성화(전체 액세스 세션 필요)
  publishBashTool: true           # ops_bash를 모델에 노출
  promptPolicy: true              # 런타임 지침을 모델 프롬프트에 주입
  toolCallTimeoutMs: 300000       # FastCtx 호출에 대한 RPC 타임아웃
  shellPolicy: advise             # 호스트 셸을 차단하려면 deny-host-shell로 설정 가능
  allowSystemShellFallback: false # 번들된 bash를 강제하고 PATH로의 자동 폴백 없음

이러한 플래그를 통해 모델이 번들된 셸을 호출할 수 있는지, 백그라운드 작업을 허용할지, 호스트 시스템으로의 폴백에 대한 플러그인의 엄격함을 제어할 수 있습니다.

제한 사항

• 현재 Windows 전용(x64). Linux/macOS 지원은 계획되어 있지만 번들된 bash 구성 요소는 포함되지 않습니다.
• DSH 0.2.0-rc.2 런타임이 필요합니다. 이전 DSH 버전에서는 작동하지 않습니다.
• Rust 파일 도구는 DSH의 샌드박스 파일 시스템 외부에서 작동하므로 보안 샌드박스 솔루션이 아닙니다.

라이선스 – 핵심 플러그인 코드는 이중 라이선스 MIT + Apache-2.0(플러그인 자체는 MIT, 벤더링된 FastCtx 라이브러리는 Apache-2.0)입니다. 외부 바이너리(Git for Windows, PowerShell)는 원래 라이선스를 유지합니다.

결론 – dsh-ops는 AI 기반 에이전트가 Windows에서 셸 명령을 더 효율적으로 실행하여 토큰 사용량과 실행 시간을 줄이는 데 도움이 되는 진정하고 초점이 맞춰진 유틸리티입니다. 이는 일반적인 튜토리얼이나 목록이 아닌 AI 운영 분야의 실제 소프트웨어 프로젝트입니다.