Question 1

なぜ FileHelper.produce は StartOS で MaxListenersExceededWarning を引き起こすのですか？

Accepted Answer

これはStartOS SDKのバグであり、FileHelper.produceがfs.watchイベントごとに新しいアボートリスナーを登録し、以前のものを削除しないというものです。修正方法は、SDKバージョン1.4.3以降にアップグレードすることです。即時のアップグレードが不可能な場合は、no-op書き込みをスキップ（以前の値を読み取り、実際に内容が変更された場合のみ書き込みを行う）することでfs.watchイベントを減らします。修正では、各ウォッチイテレーションの後にtry/finallyブロックでアボートリスナーをデタッチします。

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` のバリデーターが必須でないフィールドに対して `.optional()` ではなく `.nullable()` を使用していたため、`null` は受け入れられるのに省略されたキーは拒否されていました。PR #4297 で修正されました — SDK/start-core を更新すれば、`required: false` のフィールドが欠落したキーを受け入れ、ハンドラーが `null` を受け取るようになります。

古いバージョンでの回避策:
1. フィールドを `Value.hidden(z.string().nullish())` として定義すると、省略されたキーと `null` の両方がバリデーションを通過します (immich-startos#28 で使用されています)。
2. 呼び出し側で宣言されたすべてのフィールドを明示的に `null` として送信します。例えば、`{}` の代わりに `sdk.action.run({ ..., input: () => ({ keyHash: null }) })` のようにします。

修正後の注意点: ハンドラーは省略されたフィールドを `null` として受け取りますが、呼び出し側が新しい仕様に対して再ビルドされるまでは、TypeScript の呼び出し側の型は依然としてそのキーを `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 に対して 2 つの 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 が 2 回生成される。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) ダウングレードせずにビルダーレベルで修正する: aarch64 と x86_64 の両方の macOS ターゲットに対して libobjc のロードコマンドを重複排除する、Start9Labs/start-technologies PR #4377 の更新された cargo-zigbuild ビルダーイメージ (rust-cross/cargo-zigbuild#464 をバックポートしたアップストリームの cargo-zigbuild 0.24.0) を使用し、その後 start-cli を再ビルドする。(3) 長期的には: r3bl_tui を軽量なプロンプトクレート (inquire/dialoguer) に置き換え、objc の競合に加えて copypasta、mimalloc、syntect、portable-pty、および重複する reqwest を排除する。(4) start-cli.yaml に CI チェックを追加し、macOS 成果物に対して `llvm-objdump --macho --dylibs-used` を実行して、重複する dylib エントリがあれば失敗させる。`otool -L` で検証すること — libobjc.A.dylib はちょうど 1 回だけ表示されるはずである。

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

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト