OpenCode 開源編碼代理安裝通道、目錄優(yōu)先級(jí)與 build / plan / general Agent 體系詳解【免費(fèi)下載鏈接】opencodeThe open source coding agent.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/openc/opencode本文基于 OpenCode 倉(cāng)庫(kù)根目錄的丹麥語(yǔ)版 READMEREADME.da.md及其對(duì)應(yīng)的真實(shí)實(shí)現(xiàn)展開覆蓋三條主線OpenCode 的完整安裝通道一鍵腳本與各包管理器、安裝腳本的目錄優(yōu)先級(jí)與 PATH 處理邏輯、以及內(nèi)置 build / plan 雙 Agent 加 general 子代理的權(quán)限模型。讀完后你可以獨(dú)立完成安裝與升級(jí)、理解二進(jìn)制落盤位置并能從源碼層面解釋每個(gè) Agent 的權(quán)限邊界。1. OpenCode 是什么OpenCode 自稱 “The open source AI-kodeagent”開源 AI 編碼代理。它的主入口是一個(gè)終端 TUI在項(xiàng)目目錄中運(yùn)行opencode命令即可進(jìn)入交互式編碼會(huì)話同時(shí)項(xiàng)目提供了一個(gè)處于 BETA 階段的桌面應(yīng)用。本倉(cāng)庫(kù)是多包 monorepo核心實(shí)現(xiàn)位于 packages/opencode 包中本文涉及的關(guān)鍵證據(jù)包括安裝腳本install倉(cāng)庫(kù)根目錄的 bash 腳本Agent 定義packages/opencode/src/agent/agent.tsAgent 行為測(cè)試packages/opencode/test/agent/agent.test.ts卸載命令packages/opencode/src/cli/cmd/uninstall.ts2. 安裝方式README 提供了“YOLO”式一鍵安裝與各包管理器安裝兩大類通道以下完整繼承原文檔內(nèi)容。2.1 一鍵安裝腳本# YOLO curl -fsSL https://opencode.ai/install | bash倉(cāng)庫(kù)根目錄的 install 腳本即該類安裝器的參考實(shí)現(xiàn)。從腳本的usage()幫助文本install#L10-L27可以看到它實(shí)際支持的參數(shù)參數(shù)說明-h, --help顯示幫助信息-v, --version version安裝指定版本例如1.0.180-b, --binary path從本地二進(jìn)制安裝跳過所有下載與檢測(cè)邏輯--no-modify-path不修改 shell 配置文件.zshrc、.bashrc 等對(duì)應(yīng)的調(diào)用形態(tài)為curl -fsSL https://opencode.ai/install | bash -s -- --version 1.0.180 ./install --binary /path/to/opencode腳本內(nèi)部還有幾個(gè)值得注意的健壯性設(shè)計(jì)均為源碼可確認(rèn)事實(shí)平臺(tái)矩陣僅接受linux-x64、linux-arm64、darwin-x64、darwin-arm64、windows-x64五種組合其余直接報(bào)錯(cuò)退出install#L103-L110。Rosetta 檢測(cè)在 Intel 轉(zhuǎn)譯運(yùn)行的 macOSsysctl.proc_translated 1上會(huì)自動(dòng)改用 arm64 二進(jìn)制。AVX2 baseline 檢測(cè)x64 平臺(tái)上若 CPU 不支持 AVX2Linux 查/proc/cpuinfo、macOS 查hw.optional.avx2_0、Windows 通過 PowerShell 調(diào)IsProcessorFeaturePresent(40)下載目標(biāo)會(huì)自動(dòng)追加-baseline后綴。musl 檢測(cè)Alpine 或ldd --version輸出含 musl 的 Linux 會(huì)下載-musl變體。版本校驗(yàn)check_version()會(huì)先執(zhí)行已安裝的opencode --version若目標(biāo)版本已安裝則直接退出install#L221-L235指定版本時(shí)還會(huì)先對(duì) release 做 HEAD 請(qǐng)求404 則報(bào) “Release vX not found”。PATH 自動(dòng)寫入腳本按當(dāng)前 shellfish / zsh / bash / ash / sh選擇對(duì)應(yīng)配置文件追加 PATH 語(yǔ)句已有相同內(nèi)容則跳過在 GitHub Actions 環(huán)境中會(huì)額外寫入$GITHUB_PATHinstall#L362-L444。2.2 包管理器安裝npm i -g opencode-ailatest # 或用 bun/pnpm/yarn scoop install opencode # Windows choco install opencode # Windows brew install anomalyco/tap/opencode # macOS 與 Linux推薦始終最新 brew install opencode # macOS 與 Linux官方 brew formula更新頻率較低 sudo pacman -S opencode # Arch Linux (Stable) paru -S opencode-bin # Arch Linux (AUR 最新版) mise use -g opencode # 所有操作系統(tǒng) nix run nixpkgs#opencode # 或 github:anomalyco/opencode 獲取最新 dev 分支提示原文檔 TIP安裝前先移除 0.1.x 之前的舊版本。倉(cāng)庫(kù)中的卸載命令 packages/opencode/src/cli/cmd/uninstall.ts 會(huì)清理.opencode/bin相關(guān)的 PATH 配置行包括 bash 的export PATH、fish 的fish_add_path以及# opencode標(biāo)記注釋可作為移除舊安裝的參考實(shí)現(xiàn)。2.3 桌面應(yīng)用BETAOpenCode 也以桌面應(yīng)用形式發(fā)布可從 releases 頁(yè)或官網(wǎng)下載頁(yè)獲取。各平臺(tái)安裝包命名如下原文檔表格平臺(tái)下載文件macOS (Apple Silicon)opencode-desktop-mac-arm64.dmgmacOS (Intel)opencode-desktop-mac-x64.dmgWindowsopencode-desktop-windows-x64.exeLinux.deb、.rpm或 AppImage包管理器渠道# macOS (Homebrew) brew install --cask opencode-desktop # Windows (Scoop) scoop bucket add extras; scoop install extras/opencode-desktop桌面端源碼位于 packages/desktop其主進(jìn)程在 WSL 場(chǎng)景下還會(huì)探測(cè)$HOME/.opencode/bin/opencode這一典型安裝路徑見 packages/desktop/src/main/wsl/runtime.ts與下文安裝目錄的默認(rèn) fallback 相互印證。3. 安裝目錄的優(yōu)先級(jí)README 指出安裝腳本按以下順序確定安裝路徑$OPENCODE_INSTALL_DIR—— 自定義安裝目錄$XDG_BIN_DIR—— 遵循 XDG Base Directory Specification 的目錄$HOME/bin—— 標(biāo)準(zhǔn)用戶 bin 目錄若存在或可創(chuàng)建$HOME/.opencode/bin—— 默認(rèn) fallback配合環(huán)境變量的用法示例原文檔OPENCODE_INSTALL_DIR/usr/local/bin curl -fsSL https://opencode.ai/install | bash XDG_BIN_DIR$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash需要說明的證據(jù)邊界倉(cāng)庫(kù)根目錄的 install 腳本當(dāng)前將安裝目錄硬編碼為$HOME/.opencode/binINSTALL_DIR$HOME/.opencode/bin并mkdir -p。因此上述四級(jí)優(yōu)先級(jí)描述的是官方https://opencode.ai/install托管安裝器的行為約定而本倉(cāng)庫(kù)腳本可確認(rèn)的是默認(rèn)落盤位置、PATH 寫入邏輯與 GITHUB_PATH 處理。若你在 CI 或受限環(huán)境中安裝以$HOME/.opencode/bin作為二進(jìn)制落盤位置做后續(xù)引用如桌面端 WSL 探測(cè)邏輯是最穩(wěn)妥的假設(shè)。4. Agent 體系build、plan 與 generalREADME 描述了 OpenCode 的兩個(gè)內(nèi)置 Agent——可在會(huì)話中用Tab鍵切換——以及一個(gè)內(nèi)部子代理build—— 默認(rèn) Agent擁有完整的開發(fā)工作權(quán)限plan—— 只讀 Agent用于分析與代碼探索默認(rèn)拒絕文件編輯執(zhí)行 bash 命令前會(huì)請(qǐng)求許可適合探索陌生代碼庫(kù)或規(guī)劃改動(dòng)general—— 面向復(fù)雜搜索與多步任務(wù)的子代理內(nèi)部使用可通過在消息中g(shù)eneral調(diào)用這段描述與源碼高度吻合。三個(gè)原生 Agent 在 packages/opencode/src/agent/agent.ts 中以mode: primarybuild、plan和mode: subagentgeneral的方式注冊(cè)其權(quán)限由Permission.merge分層合并4.1 build默認(rèn) Agentbuild 在默認(rèn)權(quán)限之上放開了兩個(gè)動(dòng)作agent.ts#L141-L155question: allow—— 允許 Agent 主動(dòng)向用戶提問plan_enter: allow—— 允許進(jìn)入 plan 模式默認(rèn)權(quán)限基線agent.ts#L119-L136本身已包含若干安全約束doom_loop: ask、外部目錄寫入ask、讀取*.env/*.env.*需要確認(rèn)*.env.example除外、question默認(rèn)deny、plan_enter/plan_exit默認(rèn)deny。build 之所以“全權(quán)限”是相對(duì)這些收緊項(xiàng)的放開而非無任何約束。用戶配置cfg.permission始終通過Permission.merge疊加在最上層可覆蓋上述默認(rèn)值。4.2 plan寫保護(hù) Agentplan Agent 的權(quán)限覆蓋agent.ts#L156-L181精確對(duì)應(yīng) README 的“拒絕文件編輯”描述edit: { *: deny }—— 拒絕一切編輯但允許寫兩個(gè)“計(jì)劃文件”例外路徑.opencode/plans/*.md與全局?jǐn)?shù)據(jù)目錄下的plans/*.md即 plan 模式可以落盤規(guī)劃文檔只是不能改代碼task: { general: deny }—— plan 模式下默認(rèn)禁止調(diào)用 general 子代理plan_exit: allow—— 允許退出 plan 模式返回 build。測(cè)試用例直接驗(yàn)證了這些行為packages/opencode/test/agent/agent.test.ts 斷言 “plan agent denies the general subagent by default”Permission.evaluate(task, general, plan.permission)返回deny并在特定規(guī)則集下返回allow。4.3 general多步子代理general 的定義agent.ts#L182-L195描述為 “General-purpose agent for researching complex questions and executing multi-step tasks”其唯一額外收緊項(xiàng)是todowrite: deny子代理不寫 TODO 清單。從源碼結(jié)構(gòu)看CLI 的 run 命令在執(zhí)行子任務(wù)時(shí)默認(rèn)subagent_type即general見 packages/opencode/src/cli/cmd/run/tool.ts這與 README “通過general在消息中調(diào)用” 的說明一致。此外源碼中還存在一個(gè)未在 README 展開的explore只讀搜索子代理agent.ts#L196-L218其權(quán)限僅開放 grep / glob / list / read / web 檢索等只讀工具可作為 plan 模式探索場(chǎng)景的補(bǔ)充參考。5. 貢獻(xiàn)與衍生項(xiàng)目命名約定README 最后給出兩條社區(qū)規(guī)范貢獻(xiàn)提交 pull request 前應(yīng)先閱讀 CONTRIBUTING.md。衍生項(xiàng)目聲明如果你的項(xiàng)目名包含 “opencode”例如 “opencode-dashboard”、“opencode-mobile”但并非 OpenCode 團(tuán)隊(duì)開發(fā)應(yīng)在你的 README 中明確注明該項(xiàng)目與 OpenCode 團(tuán)隊(duì)無隸屬關(guān)系。6. 延伸閱讀路徑主題倉(cāng)庫(kù)路徑安裝腳本含參數(shù)、平臺(tái)檢測(cè)、PATH 寫入installAgent 注冊(cè)與權(quán)限合并packages/opencode/src/agent/agent.tsAgent 權(quán)限測(cè)試packages/opencode/test/agent/agent.test.ts卸載 / PATH 清理packages/opencode/src/cli/cmd/uninstall.ts桌面端BETA含 WSL 集成packages/desktop貢獻(xiàn)規(guī)范CONTRIBUTING.md多語(yǔ)言 README 索引README.md【免費(fèi)下載鏈接】opencodeThe open source coding agent.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/openc/opencode創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考