Question 1

StartOS에서 FileHelper.produce가 MaxListenersExceededWarning을 발생시키는 이유는 무엇인가요?

Accepted Answer

StartOS SDK의 버그로, FileHelper.produce가 fs.watch 이벤트가 발생할 때마다 이전 abort 리스너를 제거하지 않고 새 abort 리스너를 등록합니다. 수정 방법은 SDK 버전 1.4.3 이상으로 업그레이드하는 것입니다. 즉시 업그레이드가 불가능한 경우, 무의미한 쓰기(no-op writes)를 건너뛰어 fs.watch 이벤트를 줄이십시오(이전 값을 읽고 내용이 실제로 변경된 경우에만 쓰기). 수정 사항은 각 watch 반복 후 try/finally 블록에서 abort 리스너를 분리합니다.

Question 2

내 TCP 서비스가 StartOS URL 플러그인 타일에서 HTTP로 표시되는 이유는 무엇인가요?

Accepted Answer

알려진 프론트엔드 버그로, UI가 내부 SSL 플래그에 따라 항상 'HTTP' 또는 'HTTPS'를 표시하며 실제 TCP 또는 TLS 패스스루 서버를 무시합니다. 이 문제는 향후 릴리스에서 URL 스킴(예: tcp://)에서 올바르게 프로토콜 레이블을 도출하거나 'TCP/UDP' 또는 'SSL'로 폴백하도록 수정될 예정입니다. 현재로서는 레이블이 미용적인 문제이며 기능에 영향을 주지 않습니다. 개발자는 플러그인 패키지에서 이 문제를 무시할 수 있으며, 최종 사용자를 위한 해결 방법은 존재하지 않습니다.

Question 3

왜 `required: false`로 설정된 선택적 액션 입력이 필드를 생략하면 'expected string, received undefined' 오류로 유효성 검사에 실패하나요?

Accepted Answer

이것은 start-sdk/start-core의 버그입니다: `value.ts`의 validator가 필수 아닌 필드에 대해 `.optional()` 대신 `.nullable()`을 사용했기 때문에, `null`은 허용되면서도 생략된 키는 거부되었습니다. PR #4297에서 수정되었습니다 — SDK/start-core를 업데이트하면 `required: false` 필드가 누락된 키를 허용하고 handler가 `null`을 받게 됩니다.

이전 버전에서의 우회 방법:
1. 필드를 `Value.hidden(z.string().nullish())`로 정의하여 생략된 키와 `null`이 모두 유효성 검사를 통과하도록 합니다 (immich-startos#28에서 사용됨).
2. caller가 선언된 모든 필드를 명시적으로 `null`로 보내도록 합니다. 예: `{}` 대신 `sdk.action.run({ ..., input: () => ({ keyHash: null }) })`.

수정 후 참고 사항: handler는 생략된 필드를 `null`로 보지만, caller가 새 스펙에 맞게 다시 빌드될 때까지 TypeScript caller 타입은 여전히 해당 키를 `T | null`로 요구합니다.

Question 4

macOS에서 start-cli 2.5.0의 'dyld: duplicate linked dylib /usr/lib/libobjc.A.dylib' 오류(exit 134)를 해결하는 방법은?

Accepted Answer

start-cli 2.5.0 macOS 바이너리는 zig Mach-O 링커가 libobjc에 대한 LC_LOAD_DYLIB 명령을 두 개 생성했기 때문에 실행 시 중단됩니다. 근본 원인: Cargo.lock에서 r3bl_tui 0.7.6 → 0.7.8 업데이트(커밋 e4eec8cf9)가 notify-rust → mac-notification-sys → objc2를 추가하면서 기존 objc 0.2.7 크레이트(copypasta 경유)와 함께 포함되었습니다. 두 크레이트 모두 #[link(name = "objc")]를 선언하므로 -lobjc가 두 번 생성됩니다. Apple의 ld64는 이를 중복 제거하지만 zig 링커는 그렇지 않으며, macOS 26+ dyld는 중복을 거부합니다(이전 dyld는 허용했습니다). 수정 방법: (1) 의존성 다운그레이드 및 고정: `cargo update -p r3bl_tui --precise 0.7.6`을 실행하고 shared-libs/crates/start-core/Cargo.toml에 `r3bl_tui = "=0.7.6"`을 설정하여 향후 `cargo update`가 이를 되돌리지 않도록 한 후 릴리스 2.5.1을 태그합니다. (2) 다운그레이드 없이 빌더 수준에서 수정: Start9Labs/start-technologies PR #4377의 업데이트된 cargo-zigbuild 빌더 이미지(rust-cross/cargo-zigbuild#464를 백포트한 업스트림 cargo-zigbuild 0.24.0)를 사용합니다. 이는 aarch64 및 x86_64 macOS 타겟 모두에서 libobjc 로드 명령을 중복 제거합니다. 그런 다음 start-cli를 다시 빌드합니다. (3) 장기적: r3bl_tui를 경량 프롬프트 크레이트(inquire/dialoguer)로 교체하여 objc 충돌과 함께 copypasta, mimalloc, syntect, portable-pty 및 중복 reqwest를 제거합니다. (4) start-cli.yaml에 macOS 아티팩트에 대해 `llvm-objdump --macho --dylibs-used`를 실행하고 중복 dylib 항목이 있으면 실패하도록 하는 CI 검사를 추가합니다. `otool -L`로 확인하세요 — libobjc.A.dylib가 정확히 한 번만 표시되어야 합니다.

Question 5

드라이브에 3TB의 여유 공간이 있는데도 StartOS 마이그레이션 설치 프로그램에 "Unable to find enough space"라는 메시지가 표시되는 이유는 무엇인가요?

Accepted Answer

이는 StartOS 마이그레이션 설치 프로그램 버전 0.4.0-beta.8의 버그입니다. 드라이브에 수 테라바이트의 여유 공간이 있음에도 불구하고 여유 공간이 부족하다고 잘못 보고합니다. StartOS 0.4.0-beta.9 이상으로 업그레이드한 후 "Preserve existing data"를 선택한 상태로 마이그레이션을 다시 실행하십시오.

start-os

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트