Soodok/Deepseek-Harness-Local-Android

해결하는 문제

Android에서 AI 에이전트를 실행하려면 일반적으로 Termux를 설정하고, 종속성을 설치하거나, 전체 Linux 배포판이 포함된 proot 컨테이너를 사용해야 했습니다. 이 프로젝트는 공식 DeepSeek Harness 엔진, Node.js 런타임 및 19개의 환경 툴체인을 단일 APK에 번들하여 이러한 번거로움을 제거합니다. 설치하면 즉시 작동합니다. 루트, Termux, PC가 필요 없습니다. 세션, 자격 증명 및 작업 공간은 전적으로 앱 샌드박스 또는 앱의 비공개 외부 디렉터리에 저장되므로 원격 모델 API를 명시적으로 구성하지 않는 한 데이터는 휴대폰에 유지됩니다.

작동 방식

이 앱은 공식 dsh 엔진(0.2.1-rc.2로 고정)과 bionic(Android 네이티브) Node.js 런타임을 내장합니다. 엔진은 루프백 주소 127.0.0.1:3083에서만 수신하며 모든 상호 작용은 토큰으로 보호되는 기능 브리지를 통해 이루어집니다. 지수 백오프 모니터링이 있는 포그라운드 서비스가 엔진을 백그라운드에서 계속 실행합니다. Python, Go, Rust, Git, FFmpeg와 같은 명령줄 도구를 한 번의 탭으로 다운로드하고 제거할 수 있는 확장 센터가 포함되어 있습니다. 종속성은 해결되고 SHA-256으로 검증되며 원자적으로 릴리스됩니다. 또한 @tiphareth/dsh-hardssh 플러그인을 통한 SSH 원격 작업 공간이 포함되어 있어 원격 디렉터리를 바인딩하고 서버에서 읽기/쓰기/편집/bash 명령을 휴대폰에서 직접 실행할 수 있습니다. 화면 자동화는 접근성 서비스를 통해 21가지 작업 기본 요소(탭, 스와이프, 스크롤, 드래그, 입력 등)를 제공하며 선택 → 실행 → 검증 → 재시도의 로컬 폐쇄 루프와 OCR 및 아이콘 인식과 같은 시각적 폴백을 사용합니다. LAN WebUI 프록시를 사용하면 일회성 6자리 코드로 컴퓨터에서 기본 웹 인터페이스에 액세스할 수 있습니다. 음성 입력은 시스템 인식을 사용하며 선택적으로 OpenAI 호환 API를 폴백으로 사용합니다. 권한 모드는 일반(샌드박스), Shizuku(adb 수준), root(uid 0)의 3단계이며 su 게이트 및 이중 확인과 같은 안전 장치가 있습니다.

대상 사용자

이 제품은 Android 휴대폰에서 완전히 휴대 가능한 AI 에이전트 워크스테이션을 원하는 개발자와 기술 애호가를 대상으로 합니다. 데스크톱에서 멀리 떨어져 있을 때 원격 서버에서 코드를 편집하거나 테스트를 실행하거나 로그를 모니터링해야 하는 관리자에게도 유용합니다. 기본 일반 모드는 대부분의 일상적인 요구를 충족합니다. root 또는 Shizuku는 더 깊은 기기 제어가 필요한 사용자를 위한 선택적 고급 계층입니다.

주요 기능

• 원클릭 설치: 모든 것(엔진, 런타임, 툴체인)이 APK에 사전 빌드되어 있습니다. 초기 다운로드나 환경 설정이 필요 없습니다.
• 공식 dsh 엔진 완전 이식, 플러그인 시스템, WebUI 및 도구 호출 체인 유지.
• 19개의 환경 확장(Python, Go, Rust, Clang, OpenJDK, Git 등)을 필요에 따라 설치하거나 제거할 수 있습니다.
• 내장 SSH 원격 작업 공간: 웹 터미널, 파일 업로드/다운로드, 로컬 포트 포워딩 및 원격 명령 실행 지원.
• 21가지 작업 기본 요소와 로컬 검증 루프를 갖춘 화면 자동화(측정: 단계당 약 1.45초, 컴팩트 검증 약 5ms).
• 무작위 생성된 6자리 액세스 코드와 영구 알림이 있는 LAN WebUI 프록시로 원격 데스크톱 액세스가 용이합니다.
• 음성 입력: 편집 가능한 기록, 중복 제거 및 백그라운드 전송 지원.
• 세 가지 권한 모드(일반 / Shizuku / root)와 엄격한 안전 조치. 일반 모드가 기본이며 특별한 설정이 필요 없습니다.