企业官网建设流程全解析

OpenCode 安装渠道全对比：30 秒装好这个终端 AI 编程助手，看懂 build/plan/general 权限边界

【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode

在项目目录里敲一条opencode，随后进入的终端界面里，AI 会替你翻代码、改文件、跑命令，直到任务收尾。这就是 OpenCode（"The open source coding agent"）的工作方式：一个开源的终端 AI 编程助手，核心交互在 TUI 里完成，同时提供 BETA 阶段的桌面应用。下面这套内容覆盖你要的全部实操细节：从 OpenCode 安装的每一条渠道，到安装脚本背后的平台探测逻辑，再到 Agent 权限模型里 build / plan / general 各自的边界。

30 秒装好 OpenCode：渠道、平台与更新频率对比

先把结论说清：渠道很多，差别集中在「更新频率」和「能否锁版本」上。下面是全部官方渠道的完整对照：

日常只记两三条就够：macOS / Linux 上brew install anomalyco/tap/opencode是最省心的长期方案；Node 系工具链用户用 npm 那条；需要精确复现版本时走一键脚本加参数：

curl -fsSL https://opencode.ai/install | bash # 锁定某个 release curl -fsSL https://opencode.ai/install | bash -s -- --version 1.0.180 # 离线或本地已有构建产物 ./install --binary /path/to/opencode

一个升级提醒：安装前先卸载 0.1.x 之前的旧版本，避免新旧二进制在 PATH 里打架。

桌面版（BETA）走的是另一套分发，从 releases 页面或官网下载页拿安装包：macOS Apple Silicon 对应opencode-desktop-mac-arm64.dmg，Intel 对应opencode-desktop-mac-x64.dmg，Windows 是opencode-desktop-windows-x64.exe，Linux 提供.deb、.rpm、AppImage 三种格式。包管理器同样有渠道：

# macOS brew install --cask opencode-desktop # Windows scoop bucket add extras; scoop install extras/opencode-desktop

桌面端源码在 packages/desktop/，Electron 架构，main / preload / renderer 三层分离，打包行为由 electron-builder.config.ts 驱动，发布流水线脚本集中在 packages/desktop/scripts/；Linux 的构建环境另有专用容器 tauri-linux/Dockerfile。

安装脚本背后的三件事：选版本、选产物、选落盘位置

一键脚本对应仓库根目录的 install，它的逻辑可以拆成三步，正好是「选版本 → 选产物 → 选落盘位置」。

第一步：确定要装哪个版本

默认行为是调 GitHub API 读 latest release 的 tag；显式传--version时，脚本会先发一次 HTTP HEAD 请求确认该 release 存在，404 就直接报错退出，并把可用版本列表的提示打出来。走--binary则是另一条路：跳过下载、平台探测、版本查询的全部逻辑，直接把本地文件复制进安装目录并补执行权限。

第二步：为你的机器选对产物

产物名由os-arch组合加可选后缀拼出来，支持的五种组合是linux-x64、linux-arm64、darwin-x64、darwin-arm64、windows-x64，Linux 下载.tar.gz，其余下载.zip。两个后缀是关键：

• -musl：Alpine 这类 musl libc 系统专用。脚本靠/etc/alpine-release是否存在，或ldd --version输出里是否出现 musl 来判定；
• -baseline：CPU 不支持 AVX2 指令集的 x64 机器专用。探测手段按平台不同——Linux 读/proc/cpuinfo，macOS 读hw.optional.avx2_0，Windows 用 PowerShell 调IsProcessorFeaturePresent。

还有两个容易忽略的适配：macOS 上 darwin-x64 会再查一次sysctl.proc_translated，发现整机跑在 Rosetta 下就把架构改判成 arm64；aarch64/x86_64这类内核报告名也会先归一化成 arm64 / x64。下载环节本身也做了体验优化：TTY 环境下用curl --trace-ascii把流量导进命名管道，边收边画进度条；非 TTY 或 Windows 回退到curl -#。装之前脚本还会跑一次opencode --version对比，版本一致直接结束，不会重复下载。

第三步：二进制落到哪个目录

当前仓库里这份脚本的默认落盘位置写死为$HOME/.opencode/bin。而 README 面向所有安装渠道给出的完整优先级规范是四层：

1. $OPENCODE_INSTALL_DIR—— 自定义目录；
2. $XDG_BIN_DIR—— 符合 XDG Base Directory 规范的路径；
3. $HOME/bin—— 已存在或可创建时采用；
4. $HOME/.opencode/bin—— 默认后备。

两条用法示例：

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

装完后脚本会按当前 shell（fish / zsh / bash / ash / sh）挑对应的 rc 文件追加 PATH 导出语句，已存在则跳过，找不到可写文件就提示你手动 export；--no-modify-path参数可整体关掉这个行为。在 GitHub Actions 里运行时，安装目录还会追加进$GITHUB_PATH，后续 job 直接可用。

OpenCode Agent 权限模型：build / plan / general 各管什么

这是全文最值得花时间的部分。OpenCode 内建多个 Agent，TUI 底部状态栏就提示着tab agents——Tab/Shift+Tab在可用 Agent 间循环切换，键位定义在 keybind.ts 的agent_cycle项。先上对比表：

完整定义在 agent.ts，每个 Agent 由mode（primary / subagent）、description、prompt、permission几个字段拼成。

权限怎么生效：默认基线 + 覆盖项 + 用户配置三层合并

每个 Agent 的最终权限都是Permission.merge(defaults, 覆盖项, user)的产物：最底层是全局安全基线，中间层是这个 Agent 自己的声明，最上层是你在配置里写的permission——用户配置永远拥有最终话语权。

基线层定义了几条通用规则：doom_loop（疑似死循环）触发询问；读取*.env/*.env.*需询问（*.env.example放行）；访问项目外部目录默认询问，白名单内的临时目录、技能目录、引用目录直接放行。

plan 模式是这套机制最典型的应用。它的覆盖项长这样：

edit: { "*": "deny", [path.join(".opencode", "plans", "*.md")]: "allow", [path.relative(ctx.worktree, /* 全局数据目录 */ "plans", "*.md")]: "allow", }

翻译成白话：一切edit默认拒绝，唯独两类路径开门——项目内.opencode/plans/*.md和全局数据目录下的plans/*.md。再叠加plan_exit: "allow"（随时切回 build）与task.general: "deny"（plan 期间不派生 general 子任务），plan 就成了一个「带只读门禁的探索器」：查得到、问得出，就是落不了盘——除非你写的正是计划本身。

build 的定位则相反：基线默认question/plan_enter都是 deny，build 的覆盖项把它们翻成 allow，于是它能主动向你提问、也能建议进入 plan。Agent 列表的排序逻辑也以 build 为默认首项（除非配置了default_agent）。general 的覆盖项只有todowrite: "deny"一条，其余全部继承基线，官方描述是「研究复杂问题并执行多步任务，可并行跑多个工作单元」。

文档没提到的两个角色

源码里还有两位「编外人员」：explore是面向快速代码库探索的 subagent，权限几乎全关，只放行 grep / glob / list / bash / read / webfetch / websearch 七个工具，外部目录走只读白名单；compaction是隐藏的主 Agent，所有工具一律 deny，存在的唯一目的是做上下文压缩。@general、@explore这类@名称调用由 task 工具的提示文档支撑，参考 task.txt。

社区约定与贡献入口

两个轻量约定值得知道：其一，如果你自己的开源项目名里含 "opencode"（比如 opencode-dashboard），请在项目 README 里声明它与 OpenCode 团队无开发、无隶属关系；其二，提 PR 之前先读仓库根目录的 CONTRIBUTING.md，配置层面的细节则去官方文档站查。

三条可以直接照做的建议

• 装哪个：macOS / Linux 优先brew install anomalyco/tap/opencode（更新最勤），Node 系用户npm i -g opencode-ai@latest；要锁版本用--version，离线环境用--binary指本地文件；升级前清掉 0.1.x 之前的旧版。
• 陌生仓库怎么进：Tab切到 plan 先摸清结构、写计划文件，确认思路后plan_exit切回 build 再动手实施。
• 多步任务派给谁：跨模块的调研和批量修改直接@general派出去，让它并行执行多个工作单元，主会话保持干净。

【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode