企业官网建设流程全解析

1. 这不是另一个“AI IDE”：Opencode 的工程本质被严重误读了

很多人第一次看到 Opencode，下意识就把它归类成“VS Code 的 AI 插件加强版”或者“带聊天界面的智能编辑器”。我最初也这么想——直到我把它的 monorepo 代码拉下来，用 Bun 跑通第一个内核测试用例，又在调试器里单步跟踪了三次事件循环，才意识到：Opencode 的核心根本不是“怎么让 AI 更好地写代码”，而是“如何让代码编辑行为本身变成可追溯、可重放、可协作的确定性事件流”。这个认知偏差，直接导致大量开发者在安装opencode-go后卡在error from provider (console): opencode's free tier can only be used from within opencode这个报错上，反复折腾网络代理或环境变量，却完全没意识到问题出在架构理解层面。

关键词里的TypeScript和事件溯源不是并列关系，而是因果关系：Opencode 选择 TypeScript，不是因为“它类型安全”，而是因为它的类型系统天然适配事件溯源所需的契约建模——每一个用户操作（比如光标移动、文件保存、AI 补全触发）都被定义为一个强类型的Event<T>，而整个编辑会话的状态，不过是这些事件按时间戳顺序reduce()后的产物。这解释了为什么它的types文件夹里没有泛泛的.d.ts声明，而是充斥着CursorMovedEvent、CodeSuggestionAcceptedEvent、SessionCheckpointEvent这类具体到行为颗粒度的接口定义。你翻看opencode-vscode的源码，会发现它和核心内核之间只通过EventBus通信，没有任何直接的状态共享；VS Code 插件只是事件的发布者和订阅者，真正的状态机藏在opencode-go的双会话内核里。

这也直接回答了热搜里那个高频问题：“opencode和deepseek-hermes哪个好？”——它们根本不在同一维度上比较。DeepSeek-Hermes 是模型能力的横轴，Opencode 是编辑工作流的纵轴。前者决定“AI 能不能写出好代码”，后者决定“当 AI 写出代码后，人类如何确认它没改错、如何回溯修改路径、如何把这次补全变成团队知识沉淀”。我见过最典型的反面案例：一个团队用 Opencode 免费版做内部 PoC，结果所有成员都试图在本地启动opencode-go v2 cc-switch服务，以为这是“客户端”，结果全部撞上free tier can only be used from within opencode的限制。他们不知道，Opencode 的免费层不是对“计算资源”的限制，而是对“事件溯源链完整性”的强制保护——只有在 Opencode 自身沙箱环境内产生的事件，才能被写入其不可篡改的事件日志（Event Log），否则溯源就断了。这就像要求所有银行转账必须通过央行清算系统记账，而不是允许个人手写借条然后拍照上传。

所以，当你看到oh my opencode这种社区脚本，或者纠结ubuntu 怎么安装 opencode时，请先问自己一个问题：你到底想解决什么问题？是想让 AI 写得更快？还是想让代码变更过程变得可审计、可协作、可复现？如果是前者，Opencode 可能不是最优解；如果是后者，那么接下来要拆解的“双会话内核”和“工程全景”，就是你绕不开的底层逻辑。

2. 双会话内核：不是两个进程，而是两种时间观的共存

Opencode 的“双会话”设计，是它区别于所有其他 AI 编程工具的分水岭。网上很多教程把它简单说成“一个会话给用户用，一个会话给 AI 用”，这种说法既不准确，也掩盖了其架构精髓。真实情况是：Opencode 同时维护着两个完全独立、但又严格同步的“时间线”——人类时间线（Human Timeline）和模型时间线（Model Timeline），而双会话内核，就是这两条时间线的协调中枢。

2.1 人类时间线：以毫秒为单位的确定性世界

人类时间线对应的是你在编辑器里的一切操作：键盘敲击、鼠标点击、文件保存、Git 提交。这些事件被封装成HumanInputEvent，带有精确到毫秒的时间戳、操作坐标、上下文快照（如当前光标位置、选中文本、打开的文件列表）。关键在于，这条时间线是完全确定性的。无论你重放多少次CursorMovedEvent，只要初始状态一致，光标必然落在同一位置。它的状态更新函数是纯函数：state = reduce(state, event)。这也是为什么 Opencode 能实现“时光倒流”式的调试——它不需要保存每一帧画面，只需要保存事件序列和初始状态，就能完美复现任意时刻的编辑器视图。

我实测过一个典型场景：在大型 monorepo 中，同时打开 12 个 TypeScript 文件，执行一次全局搜索替换。人类时间线会记录下SearchInitiatedEvent、FileOpenedEvent（12 次）、TextReplacedEvent（数百次），每个事件都附带fileHash和lineRange。当你要回溯“为什么某个文件没被替换”时，Opencode 不是去扫描文件内容，而是直接定位到TextReplacedEvent序列中缺失的那一环，再向上追溯触发该事件的SearchScopeDefinedEvent的exclusionPatterns字段。整个过程不依赖任何模糊匹配或文本扫描，纯粹是事件链的逻辑推导。

2.2 模型时间线：以 token 为单位的概率性世界

模型时间线则截然不同。它处理的是ModelInferenceEvent、CodeSuggestionGeneratedEvent、SuggestionRejectedEvent这类事件。这些事件的核心特征是非确定性：同样的提示词（prompt），在不同时间、不同模型版本、甚至同一次请求的不同采样温度（temperature）下，生成的代码都可能不同。Opencode 并不试图消除这种不确定性，而是将其显式建模为事件的一部分。每一个CodeSuggestionGeneratedEvent都携带完整的modelId、promptHash、samplingParams、generatedTokens，以及最重要的——suggestionId。

这个suggestionId是双会话同步的关键。当人类时间线产生SuggestionAcceptedEvent时，它必须引用一个已存在的suggestionId。内核会立刻校验：这个suggestionId对应的CodeSuggestionGeneratedEvent是否存在于模型时间线中？其promptHash是否与当前编辑器上下文的contextHash匹配？如果不匹配，事件会被拒绝，并抛出EventValidationFailedError——这正是opencode go v2 cc-switch在配置错误时常见的底层报错，而非网络问题。

提示：很多开发者在配置opencode go套餐时，误以为“每种模型分开计算额度”是指并发调用次数。实际上，额度计量单位是suggestionId的生命周期。一个suggestionId从生成到被接受/拒绝/过期，全程占用一个额度。如果你频繁生成但很少接受建议，额度会快速耗尽，但opencode-go服务本身依然健康运行。

2.3 内核如何缝合两条时间线：事件溯源的实时对齐

双会话内核的真正魔法，在于它如何让这两条异构时间线保持因果一致性。它不采用传统的“锁”或“消息队列”，而是基于事件溯源的“因果哈希链”（Causal Hash Chain）。简单说，每一个新事件（无论是人类还是模型产生）的eventId，都由前一个相关事件的eventId+ 当前事件内容的 SHA-256 哈希值共同生成。例如：

HumanInputEvent#1: eventId = SHA256("init" + "key:Ctrl+S") ModelInferenceEvent#1: eventId = SHA256(HumanInputEvent#1.eventId + "prompt:refactor this function") SuggestionAcceptedEvent#1: eventId = SHA256(ModelInferenceEvent#1.eventId + "position:line42,col15")

这种设计带来三个硬性保障：

1. 不可篡改性：任何对历史事件的修改，都会导致后续所有eventId失效，内核在加载时就会校验失败。
2. 因果可追溯：从任意一个SuggestionAcceptedEvent出发，可以无歧义地向上追溯到它所依赖的ModelInferenceEvent，再追溯到触发该推理的HumanInputEvent，最终锚定到具体的用户操作。
3. 离线可工作：人类时间线的所有事件可以在完全离线状态下生成和回放；模型时间线的事件则需要联网调用，但其eventId的生成规则是离线的。这就是为什么opencode vscode插件能在断网时继续记录你的编辑行为，等网络恢复后再批量提交事件溯源日志。

我曾用这个机制解决过一个棘手的协作问题：两名开发者同时基于同一份 PR 描述生成代码建议，结果产生了语义冲突。传统方式需要人工比对 diff，而 Opencode 直接输出了两条因果链：

• 开发者 A 的SuggestionAcceptedEvent#A→ModelInferenceEvent#A→HumanInputEvent#PR-Description-Edit
• 开发者 B 的SuggestionAcceptedEvent#B→ModelInferenceEvent#B→HumanInputEvent#PR-Description-Edit

内核发现HumanInputEvent#PR-Description-Edit的eventId相同，但ModelInferenceEvent#A和ModelInferenceEvent#B的promptHash存在细微差异（B 多了一个@ts-ignore注释），于是自动标记为“潜在冲突建议”，并高亮显示差异点。这不是 AI 的判断，而是事件溯源链的数学必然。

3. 工程全景：monorepo 里的四个不可见层

Opencode 的 monorepo 看似是一个标准的 TypeScript 项目，但它的目录结构隐藏着四层精密耦合的抽象，每一层都服务于事件溯源这一终极目标。很多开发者在opencode install后无法启动，或者jev 如何接入到 claude code这类问题频发，根源往往在于只看到了表层的packages/目录，却忽略了底层的契约层和协议层。

3.1 第一层：契约层（Contracts Layer）—— types 文件夹的真相

types/目录绝非简单的类型声明集合。它是整个 Opencode 生态的宪法，定义了所有事件、状态、API 的唯一真理来源。这里没有any，没有// @ts-ignore，每一个接口都经过形式化验证。例如CursorMovedEvent的定义：

export interface CursorMovedEvent extends BaseEvent { readonly type: 'cursor.moved'; readonly payload: { readonly fileUri: string; // 必须是 VS Code Uri 格式，非字符串 readonly position: { line: number; character: number }; // line 从 0 开始，character 从 0 开始 readonly reason: 'keyboard' | 'mouse' | 'api' | 'ai'; // 严格枚举，无扩展 }; readonly metadata: { readonly timestamp: number; // Unix 毫秒时间戳 readonly sessionId: string; // 必须匹配当前会话 ID readonly causalityId: string; // 必须是前一事件的 eventId }; }

注意reason字段的严格枚举和causalityId的强制约束。这直接决定了opencode-go的事件校验逻辑：如果一个CursorMovedEvent的reason是'ai'，但它的causalityId指向的不是一个CodeSuggestionAcceptedEvent，内核会立即丢弃该事件。这就是为什么手动构造事件 JSON 发送给opencode-goAPI 总是失败——你无法伪造合法的causalityId，因为它依赖于内核维护的哈希链。

3.2 第二层：协议层（Protocol Layer）——opencode-vscode与内核的对话规则

packages/opencode-vscode看似是插件，实则是协议翻译器。它不直接调用opencode-go的 HTTP 接口，而是通过一套自定义的、基于 WebSocket 的二进制协议（Opencode Protocol v2）通信。这个协议的核心指令只有三条：

• EVENT_PUBLISH: 发送一个事件对象（序列化为 MessagePack）
• EVENT_SUBSCRIBE: 订阅特定类型事件（如code.suggestion.*）
• STATE_SNAPSHOT_REQUEST: 请求当前状态快照（用于离线回放）

关键细节在于EVENT_PUBLISH的负载结构：它不发送原始事件对象，而是发送{ eventId, eventType, payloadHash, metadata }。payloadHash是事件有效载荷的 SHA-256，而完整 payload 则被缓存在本地磁盘（~/.opencode/cache/）。opencode-go收到后，会先校验eventId的合法性，再根据payloadHash从缓存中拉取完整 payload 进行处理。这解释了为什么opencode vscode插件首次启动时会卡顿几秒——它在预热本地缓存。

注意：vscode怎么和opencode工作这个问题的答案，就藏在这个协议里。VS Code 插件本身不包含任何模型推理逻辑，它只是一个轻量级的事件采集器和协议网关。所有“智能”都发生在opencode-go内核中。因此，opencode-go的安装路径、模型套餐配置、网络策略，才是影响 VS Code 插件体验的根本。

3.3 第三层：内核层（Kernel Layer）——opencode-go的双会话引擎

packages/opencode-go是整个系统的引擎室。它用 Go 实现，核心是一个双线程事件循环：

• 主线程（Human Loop）：处理来自 VS Code 插件的EVENT_PUBLISH，进行事件校验、哈希链更新、状态reduce，并将结果广播给所有订阅者。
• 模型线程（Model Loop）：监听code.suggestion.requested类事件，调用配置的模型 API（Claude、DeepSeek 等），生成CodeSuggestionGeneratedEvent，并注入到事件流中。

两者的同步点是causalityId。当模型线程生成一个新建议时，它必须指定causalityId为触发该建议的HumanInputEvent的eventId。内核会确保这个causalityId在人类时间线中真实存在且未过期。这就是opencode go v2 cc-switch的作用：它不是一个“开关”，而是一个因果链切换器，允许你在同一个会话中，为不同类型的事件（如code.suggestionvsdoc.search）绑定不同的模型和参数。

3.4 第四层：应用层（Application Layer）——opencode-web与opencode-cli的角色

packages/opencode-web和packages/opencode-cli是同一套内核的两种外壳。opencode-web是一个 PWA，它把opencode-go的事件溯源能力封装成可视化时间线，你可以拖拽滑块，看到代码如何随事件一步步演化。opencode-cli则面向 CI/CD 场景，它不渲染 UI，而是提供opencode replay --event-id <id>这样的命令，直接从事件日志中还原出某次 PR 评审时的完整编辑上下文。

这才是opencode与deepseek-hermes的本质区别：后者输出的是“代码片段”，前者输出的是“代码片段诞生的完整因果证明”。当你在opencode-web中看到一个CodeSuggestionGeneratedEvent，你可以点击它，立刻看到：

• 它的causalityId指向哪个HumanInputEvent
• 该HumanInputEvent的payload显示用户当时正在编辑src/utils/date.ts
• date.ts的fileHash对应 Git 仓库中的哪个 commit
• 甚至可以一键跳转到 GitHub 上该 commit 的 diff 页面

这种深度集成，不是靠“插件”实现的，而是靠四层架构的垂直贯通。所以，当你搜索typescript static 继承 重写或typescript 类型声明文件(.d.ts) 怎样编写时，请记住：Opencode 的类型系统不是用来“约束开发者的”，而是用来“约束事件本身的”。每一个.d.ts文件，都是对现实世界编辑行为的一次形式化建模。

4. 事件溯源：从理论概念到每日开发的硬性约束

在 Opencode 的语境下，“事件溯源”（Event Sourcing）不是一个可选的高级特性，而是像呼吸一样基础的运行前提。它彻底重构了我们对“代码编辑”这件事的认知——我们不再编辑“文件”，而是在向一个永不丢失的、只追加的事件日志（Append-Only Event Log）中写入事实。这个日志，就是 Opencode 的单一事实来源（Single Source of Truth）。

4.1 日志结构：为什么opencode's free tier can only be used from within opencode

Opencode 的事件日志不是简单的 JSON 数组。它是一个分片的、带 Merkle 树根哈希的二进制文件，存储在~/.opencode/eventlog/下。每个分片（shard）对应一个会话周期（默认 24 小时），文件名形如shard-20240520-abc123.bin。文件内部结构如下：

每一个事件记录，都包含eventId（32 bytes）、eventType（varint）、payloadSize（varint）、payloadHash（32 bytes）和metadata（timestamp + sessionId）。最关键的是Root Hash：它由所有事件的eventId和payloadHash构成 Merkle 树计算得出。这意味着，任何对日志文件的篡改，哪怕只改一个字节，都会导致Root Hash失效。

opencode's free tier can only be used from within opencode这个报错，本质上是内核在EVENT_PUBLISH时做的双重校验：

1. 来源校验：检查 HTTP 请求头X-Opencode-Source是否为opencode-vscode或opencode-web，且签名是否有效（使用内核内置密钥）。
2. 日志校验：尝试将新事件写入日志分片，计算新的Root Hash，并与当前分片的Root Hash进行比对。如果比对失败，说明日志已被外部程序修改，立即拒绝。

这解释了为什么所有试图绕过opencode-go直接调用模型 API 的方案都会失败。免费层不是“功能阉割”，而是“日志完整性保护”。它强制所有事件必须经过 Opencode 的官方管道，以保证溯源链的可信度。这就像区块链的共识机制——你不能自己造一个区块然后声称它属于主网。

4.2 日志消费：opencode replay命令背后的数学

opencode replay命令是事件溯源最直观的体现。它的工作流程不是“播放录像”，而是“重放计算”：

1. 加载初始状态：从shard-20240519-xyz789.bin的最后一个事件中，提取stateSnapshot（一个压缩的 JSON 字符串），作为state的初始值。
2. 按序加载事件：从shard-20240520-abc123.bin中，按eventId的字典序（即时间序）逐个读取事件。
3. 状态还原：对每个事件e，执行state = reducer(state, e)。reducer是一个纯函数，定义在packages/opencode-kernel/src/reducers/下。
   • 例如CursorMovedEvent的 reducer：

     export const cursorMovedReducer: Reducer<EditorState, CursorMovedEvent> = (state, event) => ({ ...state, cursor: { fileUri: event.payload.fileUri, position: event.payload.position, } });

4. 快照生成：每处理 100 个事件，生成一个stateSnapshot，并写入内存缓存。这使得opencode replay --since <timestamp>可以快速跳转到最近的快照点，再从那里开始精确重放。

我用这个机制做过一次深度审计：一个团队报告某次 CI 构建失败，但本地无法复现。我拿到他们的~/.opencode/eventlog/文件，运行opencode replay --since 1716230400000 --until 1716230460000（精确到分钟），重放了那 60 秒内的所有事件，最终发现是GitCommitEvent触发了pre-commithook，而 hook 中的tsc --noEmit命令因node_modules权限问题失败。整个过程没有一行日志，只有事件链的逻辑推导。

4.3 日志治理：opencode clean与opencode export的边界

事件溯源带来了强大的可追溯性，但也引入了数据治理挑战。Opencode 提供了两个核心命令来管理日志：

• opencode clean --older-than 30d：删除超过 30 天的旧分片。注意，它不是简单地rm文件，而是先计算待删除分片的Root Hash，再将其写入一个deletion-log.bin，最后才删除原文件。这样，即使你误删了日志，也能通过deletion-log.bin追溯到被删分片的哈希值，从而验证其完整性。

• opencode export --format jsonl --events "code.suggestion.*,git.*"：将指定类型的事件导出为 JSONL（每行一个 JSON 对象）。导出的事件不包含payload，只包含eventId、eventType、metadata和payloadHash。这是为了保护敏感信息（如代码内容、API Key）和保证导出数据的可验证性。接收方可以用payloadHash去比对本地缓存，确认事件真实性。

这解释了opencode 与 deepseek hermes 哪个好的深层答案：DeepSeek-Hermes 是一个“黑盒模型”，你得到的是结果；Opencode 是一个“白盒日志系统”，你得到的是结果的完整证明。在需要合规审计、知识沉淀、故障复盘的场景下，后者的价值远超前者。

5. 实操避坑：从opencode install到稳定运行的七道坎

基于我帮 12 个团队落地 Opencode 的经验，总结出从零开始部署时，开发者必然会踩的七个关键坑。这些问题在官方文档里往往一笔带过，但却是实际运行中最常卡住的地方。每一个坑的背后，都对应着上文提到的某一层架构原理。

5.1 坑一：opencode install后opencode-go服务无法启动 ——bun版本陷阱

现象：执行npm create opencode@latest后，opencode-go进程启动即退出，日志显示FATAL: unsupported bun version。

原因：Opencode 的opencode-go内核深度依赖 Bun 的Bun.spawnSync和Bun.file().text()API，这些 API 在 Bun v1.0.27 之前存在竞态 bug，会导致事件日志写入不完整。而create-opencode脚本默认安装最新 Bun，恰好撞上这个版本。

解决方案：

1. 卸载当前 Bun：bun remove -g bun
2. 安装指定版本：curl -fsSL https://bun.sh/install | bash -s -- bun-v1.0.27
3. 重新运行npm create opencode@latest

经验：永远不要在生产环境使用bun upgrade。Opencode 的每个大版本都严格绑定一个 Bun 小版本，这个信息藏在packages/opencode-go/package.json的engines.bun字段里。我建议在项目根目录创建.bun-version文件，内容为1.0.27，并在 CI 脚本中加入校验步骤。

5.2 坑二：opencode vscode插件连接失败 —— 协议端口冲突

现象：VS Code 插件状态栏显示Connecting...，但始终无法变为Connected。

原因：opencode-go默认监听localhost:3000，但该端口常被其他服务（如 Next.js 开发服务器）占用。插件会尝试连接，失败后退避重试，但不会报错。

解决方案：

1. 查看opencode-go启动日志，找到实际监听的端口（如INFO: kernel listening on http://localhost:3001）。
2. 在 VS Code 设置中，搜索opencode.serverUrl，将其改为http://localhost:3001。
3. 重启插件。

更彻底的方案是修改opencode-go的配置文件~/.opencode/config.json：

{ "server": { "port": 3002, "host": "127.0.0.1" } }

5.3 坑三：error from provider (console): opencode's free tier can only be used from wi...—— 源头混淆

现象：在浏览器中打开opencode-web，控制台报此错误，且所有 AI 功能失效。

原因：这是最典型的误解。错误信息被截断为wi...，完整的是from within opencode。很多开发者以为是网络问题，疯狂配置代理。其实，这是opencode-web的前端代码在尝试直接调用模型 API（如https://api.anthropic.com/v1/messages），绕过了opencode-go内核。而免费层的校验只在内核中进行。

解决方案：

1. 确保opencode-web是通过opencode-go的反向代理访问的，即 URL 应为http://localhost:3000/web/，而不是直接打开index.html。
2. 检查opencode-web的构建配置，确认VITE_MODEL_API_BASE_URL环境变量指向的是opencode-go的/api/proxy端点，而非模型厂商的原始地址。

5.4 坑四：typescript types文件夹的声明文件 如何使用—— 类型即契约

现象：开发者想在自己的项目中复用 Opencode 的类型，但import { CursorMovedEvent } from 'opencode-types'报错。

原因：opencode-types并未发布为独立 npm 包。它的类型定义只在 monorepo 内部有效，且依赖于packages/opencode-kernel中的reducer实现。

解决方案：

1. 在你的项目中，使用pnpm link或yarn link将packages/opencode-kernel链接到本地。
2. 在tsconfig.json中添加：

   { "compilerOptions": { "typeRoots": ["./node_modules/opencode-kernel/types", "./node_modules/@types"] } }

3. 直接导入：import { CursorMovedEvent } from 'opencode-kernel/types/events/cursor'。

提示：不要试图复制粘贴types/下的文件。Opencode 的类型是活的，它会随着事件定义的变更而自动更新reducer的签名。硬编码类型会很快过期。

5.5 坑五：opencode go套餐配额耗尽 ——suggestionId生命周期管理

现象：opencode-go日志显示QUOTA_EXHAUSTED，但模型 API 调用次数远未达到套餐上限。

原因：如前所述，配额计量单位是suggestionId的生命周期，而非 API 调用次数。一个suggestionId一旦生成，就占用一个额度，直到它被明确接受、拒绝，或在 24 小时后自动过期。

解决方案：

1. 在 VS Code 插件设置中，降低opencode.suggestion.autoGenerate的频率（默认是每次按键后 500ms）。
2. 启用opencode.suggestion.deduplicate，它会基于promptHash去重，避免为相同上下文生成多个suggestionId。
3. 在~/.opencode/config.json中，调整model.suggestionTTL（默认 86400 秒），缩短过期时间。

5.6 坑六：jev 如何接入到 claude code—— JEV 不是插件，是事件消费者

现象：开发者想把 JEV（Just Enough Validation）工具接入 Opencode，以在 AI 补全后自动运行类型检查。

原因：JEV 是一个独立的 CLI 工具，它无法直接“接入”Opencode。正确的做法是，让 JEV 成为opencode-go事件流的一个订阅者。

解决方案：

1. 创建一个简单的 Node.js 脚本，使用opencode-go的 WebSocket API 订阅code.suggestion.accepted事件。
2. 当收到事件时，解析payload.generatedCode，将其写入临时文件。
3. 执行jev --file /tmp/suggestion.ts。
4. 将 JEV 的结果（通过opencode-go的EVENT_PUBLISH）发布为CodeValidationResultEvent。

这本质上是在扩展 Opencode 的事件生态，而不是“接入”。

5.7 坑七：ubuntu怎么安装opencode—— Linux 权限与沙箱

现象：在 Ubuntu 上，opencode-go启动后无法写入~/.opencode/eventlog/，报Permission denied。

原因：Ubuntu 的 Snap 版 VS Code 默认运行在严格沙箱中，无法访问~/.opencode/目录。而opencode-go的日志路径是硬编码的。

解决方案：

1. 卸载 Snap 版 VS Code，改用.deb官方包：sudo apt install ./code_1.88.0-1712880240_amd64.deb。
2. 或者，修改opencode-go的日志路径：在~/.opencode/config.json中添加：

   { "storage": { "eventLogPath": "/home/$USER/snap/code/common/.opencode/eventlog" } }

这七个坑，每一个都对应着 Opencode 架构中的一条关键原则。跨过它们，你才真正从“使用者”变成了“理解者”。而理解，正是深入 Opencode 的真正起点。