Q: 자율 에이전트가 진행 상황 업데이트 텍스트를 게시한 후 작업 도중에 멈추는 이유는 무엇인가요?

이것은 알려진 버그입니다 (v0.13.6): agent-runtime의 `runLoop`는 도구 호출이 0개인 어시스턴트 메시지를 모두 최종 답변으로 처리하고 `agent_end`를 발생시킵니다. 모델이 시스템 프롬프트의 지시에 따라 다음 도구 배치 전에 짧은 진행 문장을 작성하지만, 그 텍스트를 `finish_reason: "stop"`으로 스트리밍하고 `tool_call`을 함께 포함하지 않으면, 루프는 `toolCalls.length === 0`을 감지하고 실행을 조기에 중단합니다. 우회 방법: 수동으로 후속 프롬프트(예: "continue")를 보내 작업을 재개합니다. 근본적인 수정 방법 (둘 중 하나 선택): 1) 자율 모드에서 텍스트는 포함하지만 도구 호출이 없고 명시적인 작업 완료 마커도 없는 어시스턴트 메시지가 종료 대신 한 번의 자동 계속/넛지를 트리거하도록 `runLoop`를 패치합니다 (sidecar.js의 기존 `pendingSilentTurnRerun`/`SILENT_TURN_NUDGE` 복구와 유사). 2) 협업 시스템 프롬프트를 수정하여 다음을 요구합니다: "항상 텍스트 업데이트와 동일한 메시지에서 도구 호출을보내세요. 동일한 턴에서 해당 도구 호출 없이 작업을 알리지 마세요. 그렇지 않으면 실행이 종료됩니다."

Question 1

부모 메뉴에 backdrop-filter (blur)를 사용할 때 position: fixed 하위 메뉴의 위치가 어긋나는 이유는 무엇인가요?

Accepted Answer

근본 원인: `backdrop-filter`가(`none`이 아닌 값으로) 적용된 요소는 모든 `position: fixed` 하위 요소의 컨테이닝 블록이 되므로, 서브메뉴가 뷰포트가 아닌 메뉴를 기준으로 배치됩니다 — 이로 인해 플라이아웃 위치가 어긋나고, 가로 스크롤바와 오버플로 빈 영역이 발생합니다. 수정: 서브메뉴를 React Portal을 통해 `document.body`에 렌더링하여 메뉴의 박스 트리에서 벗어나게 하고, `fixed`가 다시 뷰포트를 기준으로 고정되도록 합니다: ```tsx {openSubmenuItem ? createPortal(

, document.body, ) : null} ``` 서브메뉴가 더 이상 루트 메뉴의 DOM 자식이 아니므로 두 가지 후속 조정이 필요합니다: (1) 루트 메뉴의 `onPointerLeave`에서는 Portal로 렌더링된 서브메뉴 내부에 있는 `relatedTarget`도 여전히 메뉴 내부에 있는 것으로 처리합니다. 그렇지 않으면 마우스가 서브메뉴로 이동할 때 서브메뉴가 닫힙니다; (2) 포인터가 둘 모두를 벗어났을 때 닫히도록 서브메뉴 패널 자체에도 `onPointerLeave`를 추가합니다. 키보드 탐색은 변경할 필요가 없습니다 — React 이벤트는 React 트리를 통해 버블링되므로 루트 메뉴의 `onKeyDown`과 `closest('[role="menu"]')`가 여전히 정상 동작합니다. 또한 루트 메뉴의 리사이즈/스크롤 시 서브메뉴 위치를 다시 계산하여 트리거 행을 따라가도록 합니다. 조상 요소의 `transform`이나 `zoom`에서도 동일한 문제가 발생하며, Portal 수정으로 이 모든 경우가 해결됩니다.

Question 2

Windows 개발 체크아웃에서 vitest를 실행할 때 발생하는 'EPERM: operation not permitted, symlink' 오류와 경로 어설션 테스트 실패를 해결하는 방법

Accepted Answer

이것들은 테스트 픽스처 버그(제품 버그가 아님)였으며, PR #1803에서 수정되어 커밋 d1df8bba0으로 main에 머지되었습니다. 최신 main(0.21.0-beta.4 이후)을 pull한 후 다시 실행하세요: `cd packages/host-runtime && pnpm exec vitest run src/launch-resolver.test.ts` 및 `cd packages/agent-runtime && pnpm exec vitest run src/native-pi-session.test.ts -t sessionDir`. 수정 내용: (1) launch-resolver 테스트는 더 이상 POSIX 경로 `/data/scratch/s1`을 하드코딩하지 않고, 호스트 플랫폼의 `join()`으로 예상 경로를 생성하여 Windows의 `\data\scratch\s1`과 일치시킵니다. (2) sessionDir 심볼릭 링크 픽스처는 이제 `EPERM`을 catch하여 기존 `createSymlinkOrSkip` 규칙에 따라 정상적으로 degrade/skip하며, 심볼릭 링크가 동작하는 환경에서는 전체 심볼릭 링크 커버리지를 유지합니다. 업데이트할 수 없는 경우의 임시 해결 방법: Windows 개발자 모드(설정 → 개인 정보 및 보안 → 개발자용)를 활성화하여 파일 심볼릭 링크 권한을 부여하거나, WSL/Linux에서 테스트 스위트를 실행하세요.

Question 3

PI-Desktop에서 세션을 전환한 후 저장되지 않은 AskTool 체크박스 선택 항목이 사라지는 이유는 무엇인가요?

Accepted Answer

PI-Desktop 0.20.1의 알려진 버그(v0.21.0-beta.4에서도 여전히 존재). AskTool 카드는 임시 답변(draft)을 `AskToolCard.tsx` 내부의 컴포넌트 로컬 `useState`에만 보관합니다. 세션을 전환하면 카드가 언마운트되고(`pendingAsk`가 `activeSessionId`로 필터링되기 때문), 선택된 모든 옵션이 초기화되며 카드가 질문 1로 돌아갑니다. 보류 중인 ask 자체는 스토어에 남아 있지만, 임시 답변은 어디에도 저장되지 않으므로 복원할 수 있는 것이 없습니다. 해결 방법: 세션을 전환하기 전에 AskTool 카드를 제출하세요. 전환한 후에는 손실된 선택 항목을 복구할 방법이 없습니다. 영구 수정 방법(소스에서 빌드하는 개발자용): 임시 답변을 컴포넌트 상태에서 끌어올려 `requestId`별 캐시로 이동하세요. 예를 들어 모듈 스코프의 `Map` 또는 ask 큐 옆에 있는 `apps/desktop/src/lib/pending-asks.ts`의 `AskDrafts = Record` 슬라이스를 사용할 수 있습니다. 마운트 시 캐시된 임시 답변으로 `useState`를 초기화하고, `[drafts, index, request.requestId]`에 대해 `useEffect`로 다시 기록하며, 오래된 임시 답변이 남지 않도록 카드가 해결될 때(`ASKTOOL_NOT_FOUND` 경로 포함) 해당 항목을 삭제하세요.

Question 4

턴이 끝날 때 활동 그룹이 자동으로 접히고 도구 출력이 숨겨지는 이유는 무엇인가요?

Accepted Answer

근본 원인: `apps/desktop/src/features/chat/transcript/ActivityGroup.tsx`에서 그룹의 열림 상태가 `live`(`isActive || topologyLive`)에 바인딩되어 있어 턴이 끝나는 순간 `false`로 전환됩니다. `useAutomaticDisclosure`가 open 값을 `open = choice?.open ?? automaticOpen`으로 결정하므로, 사용자가 한 번도 클릭하지 않은 그룹은 자동으로 접힙니다(여러 도구가 포함된 그룹만 해당하며, 단일 항목 그룹은 `visibleItems.length <= 1`이 계속 true이므로 접히지 않습니다). 수정: 그룹 프레임을 `live`에서 분리합니다 — disclosure 호출을 `useAutomaticDisclosure(hasSubagentTopology ? true : visibleItems.length <= AUTOMATIC_OPEN_MAX_ITEMS, revealRequest, disclosureKey(...))`로 교체합니다. 내부의 도구 행은 여전히 접힌 상태로 시작하며(`ToolRow`는 `useAutomaticDisclosure(false, …)`를 사용), `DisclosureCollapseRail`을 통해 사용자가 여전히 수동으로 접을 수 있습니다. 더 일반적인 수정 방법은 단일 boolean을 `defaultOpen`(상호작용 전 초기 상태)과 `collapseWhenIdle`(유휴 상태일 때 자동으로 접을지 여부)로 분리하는 것입니다. 최종 사용자 우회 방법: 접힌 그룹 줄을 클릭하여 도구 출력을 다시 펼칩니다.

Question 5

자율 에이전트가 진행 상황 업데이트 텍스트를 게시한 후 작업 도중에 멈추는 이유는 무엇인가요?

Accepted Answer

이것은 알려진 버그입니다 (v0.13.6): agent-runtime의 `runLoop`는 도구 호출이 0개인 어시스턴트 메시지를 모두 최종 답변으로 처리하고 `agent_end`를 발생시킵니다. 모델이 시스템 프롬프트의 지시에 따라 다음 도구 배치 전에 짧은 진행 문장을 작성하지만, 그 텍스트를 `finish_reason: "stop"`으로 스트리밍하고 `tool_call`을 함께 포함하지 않으면, 루프는 `toolCalls.length === 0`을 감지하고 실행을 조기에 중단합니다. 우회 방법: 수동으로 후속 프롬프트(예: "continue")를 보내 작업을 재개합니다. 근본적인 수정 방법 (둘 중 하나 선택): 1) 자율 모드에서 텍스트는 포함하지만 도구 호출이 없고 명시적인 작업 완료 마커도 없는 어시스턴트 메시지가 종료 대신 한 번의 자동 계속/넛지를 트리거하도록 `runLoop`를 패치합니다 (sidecar.js의 기존 `pendingSilentTurnRerun`/`SILENT_TURN_NUDGE` 복구와 유사). 2) 협업 시스템 프롬프트를 수정하여 다음을 요구합니다: "항상 텍스트 업데이트와 동일한 메시지에서 도구 호출을보내세요. 동일한 턴에서 해당 도구 호출 없이 작업을 알리지 마세요. 그렇지 않으면 실행이 종료됩니다."

PI-Desktop

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트