esengine/DeepSeek-Reasonix
요약
DeepSeek의 프리픽스 캐시를 최적화하여 토큰 비용을 절감하도록 설계된 Go 기반의 에이전트 하네스 프레임워크입니다. 설정 기반의 멀티 모델 지원, MCP 호환 플러그인 시스템, 캐시 인식 컨텍스트 유지 기능을 제공합니다.
핵심 포인트
- DeepSeek 프리픽스 캐시 최적화로 토큰 비용 절감
- TOML 설정을 통한 멀티 모델 및 도구 조합 가능
- MCP 호환 stdio JSON-RPC 기반 플러그인 시스템
- 단일 Go 바이너리로 제공되는 간편한 배포 및 설치
English
·
简体中文
·
가이드 (Guide)
·
ACP
·
사양 (Spec)
·
웹사이트 (Website)
·
Discord
설정(config) 및 플러그인(plugin) 기반의 하네스(harness) — 단일 정적 Go 바이너리(binary)로 구성되며, 긴 세션 동안 토큰 비용을 낮게 유지할 수 있도록 DeepSeek의 프리픽스 캐시(prefix cache)에 맞춰 최적화되었습니다.
중요 사항
커뮤니티 (Community) · 加入社区 — 설정 도움(#help / #求助), 워크플로(workflow) 시연 및 기능 아이디어를 위한 이중 언어 Discord. → https://discord.gg/XF78rEME2D
설정 기반 (Config-driven). 프로바이더(Providers), 에이전트(agent), 활성화된 도구(tools) 및 플러그인(plugins)은 모두 reasonix.toml에 선언됩니다. 모델이 하드코딩되어 있지 않습니다.
멀티 모델 및 조합 가능 (Multi-model & composable). DeepSeek는 프리셋(preset)으로 제공되며, 모든 OpenAI 호환 엔드포인트(endpoint)는 새로운 코드가 아닌 설정 항목(config entry)으로 추가됩니다. 선택적으로 두 개의 모델(실행기(executor) + 계획기(planner))을 별도의 캐시 안정적(cache-stable) 세션에서 함께 실행할 수 있습니다.
플러그인 기반 (Plugin-driven). 외부 도구는 stdio JSON-RPC(MCP 호환)를 통해 서브프로세스(subprocesses)로 실행됩니다. 내장된 도구는 컴파일 시점에 자체 등록됩니다.
캐시 인식 컨텍스트 유지 (Cache-aware context maintenance). 시작 시 작은 안정적 환경 요약을 주입하며, 오래된 도구 출력은 요약 압축(summary compaction) 전에 잘라내거나 정리(pruned)됩니다. 또한 내장된 도구 스키마 계약(schema contract)은 회귀 검토(regression review)를 위해 문서화되어 있습니다.
마찰 없는 배포 (Zero-friction distribution). C<code>_ENABLED=0</code> 단일 바이너리; 한 번의 명령으로 6개의 타겟으로 교차 컴파일(cross-compile)이 가능합니다. 유일한 의존성은 TOML 파서(parser)뿐입니다.
Reasonix를 사용하려는 방식에 맞는 경로를 선택하세요. CLI/TUI, 데스크톱 앱, VS Code 확장 프로그램은 모두 동일한 로컬 Reasonix 엔진을 사용합니다.
지원되는 모든 플랫폼에서 npm을 통해 네이티브 바이너리(native binary)를 설치하거나, macOS에서는 Homebrew를 사용하세요:
npm i -g reasonix # 모든 OS; 사전 빌드된 네이티브 바이너리를 가져옵니다
brew install esengine/reasonix/reasonix # macOS
사전 빌드된 아카이브(darwin|linux|windows × amd64|arm64) 및 SHA256SUMS는 모든 GitHub 릴리스(release)에 포함되어 있습니다.
최신 데스크톱 빌드는 공식 다운로드 페이지를 사용하세요.
| 플랫폼 (Platform) | 패키지 (Package) | 아키텍처 (Architecture) |
|---|---|---|
| macOS | Universal .dmg 또는 .zip | Apple Silicon / Intel |
| Windows | 설치 프로그램 .exe 또는 포터블 .zip | x64 / ARM64 |
| Linux | .deb 또는 .tar.gz | x64 |
Windows 설치 프로그램은 SignPath Foundation에서 제공하는 무료 인증서를 통해 SignPath.io를 거쳐 코드 서명(code-signed)되었습니다.
먼저 경로 A(Path A)를 완료하십시오. 이 확장 프로그램은 CLI를 포함하지 않으며, 사용자의 로컬 reasonix acp 백엔드를 시작하고 네이티브 채팅(chat), 에디터 컨텍스트(editor context), 도구 호출 승인(tool-call approvals), 모델 선택(model selection) 및 워크스페이스 세션(workspace sessions) 기능을 추가합니다.
VS Code: Visual Studio Marketplace에서 설치
VSCodium / Eclipse Theia: Open VSX Registry에서 설치
확장 프로그램 ID (Extension ID): SivanLiu.reasonix-agent
· 소스 및 사용 가이드
git clone https://github.com/esengine/DeepSeek-Reasonix.git
cd DeepSeek-Reasonix
make build # -> bin/reasonix(.exe)
...
이 명령어들은 경로 A를 통해 설치된 CLI/TUI용입니다:
reasonix setup # 프로바이더(provider) 및 모델(model) 설정
reasonix # 대화형 세션(interactive session) 시작
reasonix run "implement the TODOs in main.go"
대화형 세션에서 Reasonix가 프로젝트 지침(project instructions)을 생성하도록 하려면 /init을 실행하십시오.
공식 다운로드 페이지에서 사용 중인 플랫폼에 맞는 설치 프로그램을 다운로드하여 Reasonix를 설치 및 실행한 다음, 앱에서 프로바이더와 모델을 설정하십시오. 데스크톱 앱의 경우 위의 CLI 명령어는 필요하지 않습니다.
고급 CLI 사용법 및 구성은 CLI 참조(CLI reference), 가이드(Guide), 그리고 **구성 경로(configuration paths)**를 참조하십시오.
시작하기 (Getting started): 가이드(Guide) · CLI 참조(CLI reference) · 구성 경로(Configuration paths) · ACP 에디터 통합(ACP editor integration)
기능 및 문제 해결 (Features & troubleshooting): 서브 에이전트 프로필(Subagent profiles) · 컨텍스트 엔진 v2 (Context Engine v2) · 기능 진단(Capability diagnostics) · 복구 및 안전 모드(Recovery and Safe Mode) · 봇 가이드(Bot guide) · 체크포인트 및 되감기(Checkpoints & rewind)
엔지니어링 및 마이그레이션 (Engineering & migration): 사양(Spec) · 작업 계약 및 일시 중지 정책(Task contracts & pause policy) · 도구 계약(Tool contract) · 0.x 버전에서 마이그레이션(Migrating from 0.x)
Reasonix를 형성하는 데 가장 큰 기여를 한 소수의 인원 목록 — 커밋 횟수 기준 현재 상위 20명의 기여자입니다. 전체 기여자 그래프는 GitHub에서 확인할 수 있습니다.
| 기여자 | 기여자 | 기여자 | 기여자 |
|---|---|---|---|
| SivanCola | |||
| esengine | |||
| ttmouse | |||
| lifu963 | |||
| reasonix (anonymous) | |||
| HUQIANTAO | |||
| GTC2080 | |||
| light-front-theory | |||
| merge-order-check (anonymous) | |||
| Li-Charles-One | |||
| eghrhegpe | |||
| wufengfan (anonymous) | |||
| CVEngineer66 | |||
| dependabot[bot] | |||
| lanshi17 | |||
| SuMuxi66 | |||
| CnsMaple | |||
| cyq1017 | |||
| JesonChou | |||
| XTLine |
또한 프로젝트 로고를 디자인해 준 Bernardxu123과
XiaoHongShu에서 프로젝트를 홍보해 준
AIGC Link에 별도의 감사를 전합니다.
MIT — LICENSE를 참조하세요
esengine/DeepSeek-Reasonix 커뮤니티에 의해 구축되었습니다.
이 프로젝트를 후원해 주세요
Reasonix가 유용했고 감사를 표하고 싶다면, 그렇게 하실 수 있습니다. 이는 계약이 아닌 커피 한 잔의 마음입니다 — 기부가 기능 우선순위를 구매하거나 이슈가 분류(triage)되는 방식을 변경하지는 않습니다.
해외— PayPal: paypal.me/yuhuahui
중국 국내— WeChat Pay (QR 코드 스캔)
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Trending All (daily)의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기