docs: add Linux build-time deps to cargo install guides (#3270)

Author: zlh124

README.ja-JP.md

@@ -27,6 +27,10 @@ cargo install codewhale-cli --locked
 cargo install codewhale-tui --locked
 ```
 
+> **Linux ユーザーへ:** ビルド依存パッケージを先にインストールしてください:
+> `sudo apt-get install -y build-essential pkg-config libdbus-1-dev`。
+> 詳細は [INSTALL.md](docs/INSTALL.md#4-install-via-cargo-any-tier-1-rust-target) を参照。
+
 その他の経路:
 
 ```bash

README.md

@@ -32,6 +32,10 @@ cargo install codewhale-cli --locked
 cargo install codewhale-tui --locked
 ```
 
+> **Linux users:** install system build dependencies first:
+> `sudo apt-get install -y build-essential pkg-config libdbus-1-dev`.
+> See [INSTALL.md](docs/INSTALL.md#4-install-via-cargo-any-tier-1-rust-target).
+
 Every other path:
 
 ```bash

README.vi.md

@@ -33,6 +33,10 @@ cargo install codewhale-cli --locked
 cargo install codewhale-tui --locked
 ```
 
+> **Người dùng Linux:** cài đặt các gói build trước:
+> `sudo apt-get install -y build-essential pkg-config libdbus-1-dev`.
+> Xem [INSTALL.md](docs/INSTALL.md#4-install-via-cargo-any-tier-1-rust-target).
+
 Mọi đường cài đặt khác:
 
 ```bash

README.zh-CN.md

@@ -32,6 +32,10 @@ cargo install codewhale-cli --locked
 cargo install codewhale-tui --locked
 ```
 
+> **Linux 用户注意：** 请先安装系统构建依赖：
+> `sudo apt-get install -y build-essential pkg-config libdbus-1-dev`。
+> 详见 [INSTALL.md](docs/INSTALL.md#4-install-via-cargo-any-tier-1-rust-target)。
+
 如果访问 GitHub 不稳定，推荐直接走下面的 CNB 镜像。其他安装路径：
 
 ```bash

docs/CNB_MIRROR.md

@@ -169,6 +169,9 @@ behind GitHub-blocking networks should use one of these paths:
   ```
   (Both binaries are required — the dispatcher and the TUI ship
   separately; see `AGENTS.md` for the two-binary install rationale.)
+  Linux build-time dependencies (`build-essential`, `pkg-config`,
+  `libdbus-1-dev` on Debian/Ubuntu) are required — see
+  [INSTALL.md](INSTALL.md#4-install-via-cargo-any-tier-1-rust-target).
 
 - **CNB release assets** for Linux x64, when the matching CNB tag pipeline has
   completed successfully. Download `codewhale-linux-x64`,

docs/INSTALL.md

@@ -158,6 +158,24 @@ cargo install codewhale-tui     --locked   # provides `codewhale-tui`
 codewhale --version
 ```
 
+> **Linux: install build-time dependencies first.** `cargo install` compiles
+> from source, and on Linux the `codewhale-tui` crate links against
+> `libdbus-1` (used by the D-Bus secret-service backend for credential
+> storage). Install the required system packages before running `cargo install`:
+>
+> ```bash
+> # Debian / Ubuntu
+> sudo apt-get install -y build-essential pkg-config libdbus-1-dev
+>
+> # Fedora / RHEL
+> sudo dnf install -y gcc make pkgconf-pkg-config dbus-devel
+> ```
+>
+> If you use the npm wrapper or download GitHub Release binaries, these
+> build-time packages are **not** required — the prebuilt binary only
+> needs the runtime library (`libdbus-1`), which is already present on
+> most desktop Linux installs.
+
 ### China / mirror-friendly install
 
 When installing from mainland China, configure mirrors for both **rustup**

scripts/tencent-lighthouse/bootstrap-ubuntu.sh

@@ -25,6 +25,7 @@ apt-get install -y \
   openssh-client \
   build-essential \
   pkg-config \
+  libdbus-1-dev \
   libssl-dev \
   nodejs \
   npm \