Question 1

Windows에서 Ouroboros 'WinError 123' 체크포인트 오류를 수정하는 방법?

Accepted Answer

Ouroboros를 버전 0.40.0 이상으로 업그레이드하세요. 이 릴리스는 체크포인트 파일 이름에서 콜론 및 기타 Windows 예약 문자(< > : " / \ | ? *)를 정리하여 잘못된 NTFS 문자로 인한 'WinError 123'을 방지합니다. 업그레이드 후 수동 해결 방법은 필요하지 않습니다. 업그레이드가 불가능할 경우, 콜론이 포함된 seed_ids를 일시적으로 피하십시오. 그러나 이는 신뢰할 수 있는 해결책이 아닙니다.

Question 2

Codex CLI 0.134+에서 'ooo interview'를 실행할 때 'legacy profile' 오류를 해결하는 방법?

Accepted Answer

이 오류는 Codex CLI ≥0.134.0이 profile-v2 파일(예: ~/.codex/ouroboros‑frontier.config.toml)을 사용하고, ~/.codex/config.toml에서 레거시 [profiles.*] 테이블을 거부하기 때문에 발생합니다. PR #1268에서 수정이 진행 중입니다. 해당 PR이 병합될 때까지 수동으로 마이그레이션하세요: 1) ~/.codex/config.toml에서 각 [profiles.ouroboros‑*] 블록을 자체 파일 ~/.codex/ouroboros‑*.config.toml로 옮깁니다. 2) config.toml에서 레거시 섹션을 제거합니다. 또는 PR이 적용된 후 ouroboros setup을 다시 실행하세요.

Question 3

Windows에서 ouroboros uninstall을 실행할 때 발생하는 UnicodeDecodeError 'gbk codec can't decode byte' 오류를 해결하는 방법은 무엇인가요?

Accepted Answer

이 문제는 프로젝트의 `CLAUDE.md`가 UTF-8로 인코딩되어 있을 때 UTF-8이 아닌 ANSI 코드 페이지(예: 중국어 간체 시스템의 cp936/GBK)를 사용하는 Windows에서 발생합니다. Python이 UTF-8 대신 시스템 기본 인코딩으로 파일을 읽기 때문에 아무것도 제거되기 전에 충돌이 발생합니다.

**임시 해결 방법:** 명령을 실행하기 전에 환경 변수를 설정하여 Python UTF-8 모드를 활성화하세요:

```cmd
set PYTHONUTF8=1
python -m ouroboros uninstall --dry-run
```

또는 PowerShell에서는:

```powershell
$env:PYTHONUTF8=1
python -m ouroboros uninstall --dry-run
```

영구적으로 적용하려면 시스템 환경 변수에 `PYTHONUTF8=1`을 추가하거나, `-X utf8` 플래그로 Python을 실행하세요: `python -X utf8 -m ouroboros uninstall`.

**근본적인 해결 방법:** 패치가 적용되면 Ouroboros를 업그레이드하세요. 이 수정은 `CLAUDE.md`를 명시적으로 UTF-8로 읽고 쓰며 디코딩할 수 없는 파일은 건너뛰므로, 시스템 코드 페이지와 관계없이 명령이 완료됩니다.

Question 4

ouroboros auto가 plain Codex가 해결하는 작업을 왜 실패시키며, 답변되지 않은 인터뷰 질문이 worker prompt로 유출되는 것을 어떻게 막을 수 있습니까?

Accepted Answer

근본 원인 (v0.59.3): requester 없이 `ouroboros auto`를 실행하면, 아무도 답변하지 않은 모든 인터뷰 질문이 `Open question:` 라인으로 `Seed.assumptions`에 주입되고(시드당 중앙값 약 15개), `render_assumptions_section`(`orchestrator/runner.py`의 `SeedContract.from_seed` -> `render_seed_contract_for_execution`)을 통해 워커의 시스템 프롬프트로 렌더링됩니다. 워커는 각 미해결 질문을 스펙의 일부로 읽고, 질문에 언급된 후보 답변 중 하나를 임의로 선택하여 그에 맞춰 수정을 작성합니다 — 이로 인해 Ambig-SWE 연구에서 requester 없이 auto를 실행한 경우 25/50점을 기록한 반면 requester가 있는 경우 32/50점을 기록했습니다. 수정: 활성 상태의 비구속적 `LedgerEntry.question` 값을 전용 `Seed.unanswered_questions` 필드로 분리합니다. 이 값들은 Seed 파일, auto 결과, CLI 및 MCP 출력, 인터뷰 이벤트에서는 계속 완전히 표시되도록 유지하되, 모든 워커 핸드오프에서는 (확인되지 않은 가정과 함께) 제외합니다. 분리는 라인 텍스트가 아니라 ledger-entry 출처, 즉 구조화된 `LedgerEntry.question` 필드를 따라야 하며, requester가 질문을 건너뛴 경우에도 동일한 규칙이 적용됩니다. 프롬프트 문구를 다듬는 것은 해결책이 아닙니다: 'assumptions may be overridden' 고지 문구는 검사한 시드 10개 중 8개에 존재했지만 실패를 방지하지 못했습니다. 수정이 적용될 때까지의 임시 해결 방법: 인터뷰 질문이 미해결 질문으로 유출되는 대신 `Seed.requester_answers`에 저장된 실제 답변을 받도록 requester와 함께 `ouroboros auto`를 실행하세요.

Question 5

ouroboros가 CLI 워커를 자동으로 취소한 후 '.git/index.lock': File exists 오류를 해결하는 방법

Accepted Answer

원인: v0.59.4에서 `terminate_runtime_process`는 워커의 프로세스 그룹에만 SIGTERM을 보내지만, codex-cli 0.160.0과 같은 프로바이더는 각 도구 명령(예: `git`)을 자체 세션/프로세스 그룹에서 생성합니다. 이러한 명령들은 시그널을 받지 못하고 계속 실행되며(pid 1로 리페어런트됨), `ouroboros auto`가 반환된 후에도 `.git/index.lock`을 계속 보유하므로, 호출자의 `git add -A`가 실패하고 패치가 손실됩니다. 수정이 적용될 때까지의 우회 방법: 1) 고아 도구 프로세스 찾기: `ps -eo pid,ppid,pgid,cmd | grep ` (ppid 1을 확인). 2) 단계적으로 종료: `kill -TERM `를 실행하고, 여전히 살아 있으면 `kill -KILL ` 실행. 3) 살아 있는 프로세스가 잠금을 보유하지 않는지 확인: `fuser /testbed/.git/index.lock` 또는 `lsof /testbed/.git/index.lock`. 4) 아무것도 잠금을 보유하지 않을 때만 제거: `rm /testbed/.git/index.lock`, 그런 다음 `git add -A`를 다시 실행. 프로세스가 잠금을 소유하고 있는 동안에는 절대 삭제하지 마세요. 계획된 정식 수정은 auto가 제한된 SIGTERM→SIGKILL 에스컬레이션과 소유권 인식 잠금 정리를 통해 워커의 전체 프로세스 트리를 기다리도록 하며, Codex 제품군(Codex, Copilot, Gemini, Grok, Goose, Zcode), Hermes, OMP, Pi, OpenCode 및 Kiro 런타임에 영향을 미칩니다.

ouroboros

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트