從這裡，建立第一份 Context。

01 /

Windows

從開始功能表開啟 PowerShell。Windows 預編譯執行檔的目標架構為 x86_64；請在有網路連線時執行以下指令。

irm https://raw.githubusercontent.com/TW-RF54732/onesource/main/install.ps1 | iex

安裝程式會將最新 GitHub release 下載到 %LOCALAPPDATA%\Programs\onesource，並將資料夾加入使用者 PATH。完成後關閉並重新開啟終端機，再依下方「確認安裝成功」進行驗證。

02 /

macOS

開啟「終端機」，確認可使用 curl 且有網路連線，執行下方指令。安裝程式會自動選擇 Intel 或 Apple Silicon 執行檔。

curl -sSL https://raw.githubusercontent.com/TW-RF54732/onesource/main/install.sh | bash

安裝程式會將 onesource 放到 /usr/local/bin；移動執行檔時可能要求輸入 sudo 密碼。完成後依下方步驟驗證安裝。

03 /

Linux

開啟終端機，確認可使用 Bash 和 curl。目前 Linux release 的目標為使用 GNU libc 的 x86_64；其他架構請使用 Cargo 在本機編譯，不要執行網路安裝指令。

curl -sSL https://raw.githubusercontent.com/TW-RF54732/onesource/main/install.sh | bash

安裝程式會將 onesource 放到 /usr/local/bin；移動執行檔時可能要求輸入 sudo 密碼。完成後依下方步驟驗證安裝。

04 /

使用 Cargo 安裝

若已安裝 Rust 和 Cargo，可在本機編譯並安裝 OneSource。此方式也需要該平台的原生 linker 與編譯環境。

cargo --version
cargo install onesource

Cargo 一般將指令安裝到 ~/.cargo/bin（Windows：%USERPROFILE%\.cargo\bin）；若自訂 CARGO_HOME，請使用該目錄下的 bin 資料夾。確認此路徑已加入 PATH，安裝 Rust 後請重新開啟終端機。

05 /

手動下載免安裝執行檔

開啟 GitHub Releases，下載符合平台的檔案。下載內容是執行檔，不是壓縮檔。macOS／Linux 請將下載的檔案重新命名為 onesource；Windows 保留 onesource.exe。

在下載執行檔所在的資料夾中，執行對應指令。手動下載不會修改 PATH；後續指令請使用 ./onesource 或 .\onesource.exe，或自行將該資料夾加入 PATH。

chmod +x onesource
./onesource --version

.\onesource.exe --version

06 /

確認安裝成功

在新的終端機中檢查版本和可用指令。若看到以 onesource 開頭的版本資訊及指令說明，表示已能執行。版本號會依實際安裝的 release 而不同。

onesource --version
onesource --help

07 /

第一次使用

將 my-project 換成你的專案資料夾。先預覽選取的檔案與 token 估算，再建立輸出檔。

cd my-project
onesource --dry-run
onesource

OneSource 會在掃描的專案資料夾中建立 <專案名稱>.onesource，包含目錄樹與選取檔案的內容。若要直接複製 Context 而不建立檔案，執行以下指令。

onesource --copy

打包在本機執行，不會上傳程式碼。分享給 AI 前請確認輸出內容。Token 數僅為估算。

08 /

更新 OneSource

若使用相容的預編譯執行檔，可透過內建更新指令下載最新 GitHub release 並替換目前執行檔。Windows 會在程序結束後完成替換，請在新的終端機驗證版本。

onesource update
onesource --version

Cargo 安裝者，尤其是沒有對應 release 執行檔的架構，請透過 Cargo 重新編譯更新，以保留適合本機平台的版本。

cargo install onesource --force
onesource --version

若更新因安裝目錄無寫入權限而失敗，可重新執行原安裝程式，或在有寫入權限的資料夾中替換手動下載的執行檔。

09 /

常見問題