오픈 코덱스: 자연어를 셸 명령어로 변환하는 오픈 소스 AI 도구

일반 소개

오픈 코덱스는 개발자가 자연어 명령을 정확한 셸 명령으로 변환할 수 있도록 설계된 오픈 소스 명령줄 AI 도구입니다. 이 도구는 네이티브 언어 모델(예: phi-4-mini)을 사용하며 네트워킹이나 API 키가 필요하지 않고 모든 작업이 로컬에서 실행됩니다. 사용자는 간단한 설명만으로 셸 명령어 또는 코드를 생성할 수 있어 빠른 프로그래밍 작업에 적합합니다. 오픈 코덱스는 보안을 강조하며 시스템을 보호하기 위해 명령어를 실행하기 전에 사용자 확인을 요구하고, 설치가 간편하며 macOS, Linux 및 Windows를 지원합니다.

기능 목록

• 자연어를 셸 명령으로 변환: 사용자의 자연어 입력을 실행 가능한 셸 명령으로 변환합니다.
• 로컬 모델 실행인터넷 연결이 필요 없고 개인 정보 보호 기능이 있는 phi-4-mini와 같은 로컬 모델을 지원합니다.
• 코드 생성설명을 기반으로 여러 프로그래밍 언어로 코드 스니펫을 생성합니다.
• 주문 확인 메커니즘오용을 방지하기 위해 명령 생성 후 사용자 확인이 필요합니다.
• 작업 내역명령 기록 저장, 보기 및 부분 실행 취소 기능을 지원합니다.
• 플러그인 확장 기능개발자가 플러그인을 사용자 지정하여 도구의 기능을 확장할 수 있도록 지원합니다.
• 크로스 플랫폼 지원macOS, Linux 및 Windows와 호환되며 여러 단말기에 적합합니다.

도움말 사용

설치 프로세스

오픈 코덱스는 다양한 운영 체제와 사용자 습관에 맞게 여러 가지 설치 방법을 지원합니다. 다음은 빠른 시작을 위한 자세한 단계입니다.

홈브루를 통한 설치(macOS/Linux)

1. 오픈 코덱스용 홈브루 소스를 추가합니다:

   brew tap codingmoh/open-codex
   

2. 설치 도구:

   brew install open-codex
   

3. 설치를 확인하고 버전을 확인합니다:

   open-codex --version
   

pipx(크로스 플랫폼)를 통한 설치

1. Python(3.8 이상)과 pipx가 설치되어 있는지 확인합니다.
2. 오픈 코덱스를 전 세계에 설치합니다:

   pipx install open-codex
   

3. 설치를 확인합니다:

   open-codex --version
   

소스 코드를 통한 설치

1. GitHub 리포지토리를 복제합니다:

   git clone https://github.com/codingmoh/open-codex.git
   

2. 프로젝트 카탈로그로 이동합니다:

   cd open-codex
   

3. 종속성을 설치합니다:

   pip install .
   

4. 설치를 확인합니다:

   open-codex --version
   

기본 사용

설치 후 명령줄에서 코덱스 열기 기능을 호출할 수 있습니다. 다음은 핵심 기능을 작동하기 위한 지침입니다.

자연어를 셸 명령으로 변환

Open Codex의 핵심 기능은 자연어를 셸 명령어로 변환하는 것입니다. 절차는 다음과 같습니다:

1. 예를 들어 터미널에서 자연어 명령을 입력합니다:

   open-codex "列出当前目录下所有Python文件"
   

2. 도구를 사용하여 해당 셸 명령을 생성할 수 있습니다:

   ls *.py
   

3. 시스템에서 사용자에게 선택하라는 메시지를 표시합니다:
   • y명령을 실행합니다.
   • c: 복사 명령을 클립보드에 복사합니다.
   • n: 작업을 취소합니다.
4. 옵션 y이 명령은 로컬에서 실행되고 결과를 표시합니다(예: 모두 나열). .py 문서화.

복잡한 셸 명령 생성

복잡한 작업의 경우 Open Codex는 다단계 명령을 생성할 수도 있습니다. 예를 들어

1. 입력:

   open-codex "查找所有txt文件并统计行数"
   

2. 도구가 생성될 수 있습니다:

   find . -name "*.txt" -exec wc -l {} \;
   

3. 사용자가 확인하면 명령이 실행되어 각 txt 파일의 줄 수와 총 개수를 표시합니다.

코드 생성

셸 명령 외에도 Open Codex는 코드 생성을 지원합니다:

1. 입력:

   open-codex "用 Bash 写一个备份文件夹的脚本"
   

2. 이 도구는 다음과 같은 코드를 반환합니다:

   #!/bin/bash
   tar -czf backup_$(date +%F).tar.gz /path/to/folder
   

3. 사용자 선택 가능:
   • 파일에 저장: 입력 open-codex --save backup.sh.
   • 클립보드에 복사: 다음을 선택합니다. c.
   • 직접 실행: 다음을 선택합니다. y(스크립트가 실행 가능한지 확인해야 합니다).

기록 보기

1. 생성 및 실행된 명령의 기록을 확인합니다:

   open-codex --history
   

2. 기록은 시간별로 정렬되어 명령과 실행 상태를 보여줍니다.
3. 작업 실행 취소(지원되는 경우):

   open-codex --undo
   

사용자 지정 모델

Open Codex는 기본적으로 phi-4-mini 모델을 사용합니다. 단계적으로 모델을 전환합니다:

1. 구성 파일( ~/.open-codex/config.yaml):

   model: phi-4-mini
   

2. 수정 model 필드는 지원되는 다른 로컬 모델입니다.
3. 전환을 적용하려면 터미널을 저장하고 다시 시작하세요.

주요 기능 작동

보안 확인 메커니즘

오용을 방지하기 위해 모든 명령은 실행 전에 사용자 확인이 필요합니다:

1. 자연어 명령을 입력하면 도구에서 추천 명령을 표시합니다.
2. 사용자에게는 다음이 제공됩니다. y(구현),c(복제) 또는 n(취소됨) 선택.
3. 옵션 y 샌드박스 환경에서 이 명령을 실행하면 시스템 보안이 보장됩니다.

로컬 운영으로 개인 정보 보호 보장

오픈 코덱스는 로컬에서 작동하며 인터넷 연결이 필요하지 않습니다. 사용자 데이터와 생성된 콘텐츠는 클라우드에 업로드되지 않으므로 개인정보 보호 요구 사항이 높은 시나리오에 적합합니다. 예를 들어

• 오프라인 환경에서 명령 또는 코드를 생성합니다.
• 민감한 프로젝트를 처리할 때는 데이터 유출을 방지하세요.

플러그인 확장 기능

개발자는 플러그인 개선 사항을 만들 수 있습니다:

1. 프로젝트 루트 디렉터리에서 plugins 폴더.
2. 설명서에 따라 플러그인을 작성합니다(GitHub 리포지토리에 대한 자세한 내용은 CONTRIBUTING.md).
3. 오픈 코덱스를 다시 시작하면 플러그인이 자동으로 로드됩니다.

주의

• Python 3.8 이상이 설치되어 있는지 확인합니다.
• 홈브루 또는 pipx 설치에는 안정적인 네트워크가 필요합니다.
• 소스 코드 설치는 수동으로 업데이트해야 하며 정기적으로 실행하는 것이 좋습니다. git pull.
• 이 도구는 개발 단계에 있으며 미완성된 기능이 있을 수 있으므로 GitHub 이슈를 계속 주시하는 것이 좋습니다.
• 복잡한 명령어 생성은 모델 기능에 따라 제한될 수 있으므로 사용자는 명령어의 정확성을 확인해야 합니다.

애플리케이션 시나리오

1. 빠른 명령 생성
   개발자가 특정 셸 명령(예: unzip tar.gz)을 잊어버리고 다음과 같이 입력합니다. open-codex "解压 tar.gz 文件"Get tar -xzf file.tar.gz 및 구현.
2. 오프라인 개발
   개발자는 Open Codex를 사용하여 네트워크가 없는 환경에서 셸 스크립트 또는 Python 코드를 생성하여 프로젝트 개인 정보를 보호할 수 있습니다.
3. 시스템 관리
   관리자 입력 open-codex "查找占用磁盘空间最大的文件"Get du -ah | sort -rh | head를 클릭하여 문제를 빠르게 찾아보세요.
4. 셸 스크립팅 배우기
   초보자 입력 open-codex "用 Bash 写一个监控CPU的脚本"를 클릭하고 샘플 코드를 얻고 스크립팅을 배우세요.
5. 커뮤니티 개발
   개발자는 새로운 모델 지원을 추가하거나 명령 생성 로직을 최적화하는 등 새로운 기능을 GitHub를 통해 기여합니다.

QA

1. 셸 명령어에 대한 자연어의 정확도는 어느 정도인가요?
   정확도는 모델 기능에 따라 다릅니다. phi-4-mini는 일반적인 작업을 처리할 수 있으며, 복잡한 명령은 사용자가 생성된 결과를 확인하도록 제안합니다.
2. 다른 터미널 명령도 지원되나요?
   주요 지원 대상은 셸 명령(bash/zsh)이며, 향후 PowerShell 등으로 확장될 수 있습니다. 자세한 내용은 GitHub 로드맵을 참조하세요.
3. 오류 생성 명령은 어떻게 처리하나요?
   명령을 확인한 후 n 실행 취소, 또는 open-codex --history 기록을 확인하고 필요한 경우 취소하세요.
4. 다국어 입력을 지원하나요?
   현재 중국어와 영어 입력에 최적화되어 있으며, 다른 언어에는 더 정확한 설명이 필요할 수 있습니다.
5. 문제에 대한 피드백은 어떻게 제공하나요?
   이슈 또는 풀 리퀘스트를 제출하려면 GitHub 리포지토리(https://github.com/codingmoh/open-codex)를 방문하세요.