从 OpenCode 分叉：增量全景

用 blob 比对找出上游基线 v1.14.19，再按目录清点 MiMo 新增、修改、删除了哪些文件，默认开启的统计上报，以及产品层面改了哪些名字。

MiMo Code 开源时只有一个整体提交，没有保留上游历史，git log 回答不了“它是从哪个 OpenCode 分出来的、改了什么”。本专栏的主线恰恰是这个增量，所以先把账算清楚：基线是哪个版本，增量落在哪些目录，哪些文件被删掉，以及改名改到了哪一层。

怎么确定上游基线

思路是比较文件内容的指纹。Git 的树对象里记着每个文件的 blob SHA，它只由文件内容决定，内容逐字相同的文件 SHA 必然相同。于是：

用 gh api 调 git/trees/<ref>?recursive=1 取回 MiMo 首个开源提交（8e5cc8a84b91）的完整文件树，只保留 packages/opencode/src/ 下的文件；
对上游 anomalyco/opencode 的一批候选 tag 做同样的事；
对每个 tag 统计两边都有的路径数，以及其中 SHA 相同的文件数。

逐字相同的文件越多，说明分叉点越近。结果是 v1.14.19（2026-04-20）最接近：509 个共同路径里有 280 个逐字相同。之后 MiMo 独立演进，没有再整体同步上游，旁证也不少：根 package.json 的 catalog 里 Effect 仍是 4.0.0-beta.48（package.json:56），TUI 仍在 packages/opencode/src/cli/cmd/tui/，服务端路由仍是 Hono，而《OpenCode 源码解读》对照的 v1.18.30 早已拆出 packages/tui 与 packages/core。

下文的“上游”一律指 v1.14.19 的 packages/opencode/src，数字口径是 git 跟踪的 .ts 与 .tsx 文件，排除 test/ 目录与 *.test.*、*.spec.*，行数为 wc -l 的物理行。

总账

图表加载中…

行数增加了约 76%，上游的 443 个文件里只有 182 个没被碰过。TS 之外还新增了不少非代码资产：30 个 .txt 提示词（2290 行）、5 个 .js（主要是内置 Workflow 脚本，1584 行）、405 个内置技能包文件（52900 行，在 packages/opencode/src/skill/builtin/.bundle 与 packages/opencode/src/skill/compose/.bundle），以及语音活动检测用的 1 个 .wasm。

增量落在哪些目录

把克隆与上游基线逐文件比较，就能按目录列出新增、修改、未动的文件。如果把所有文件类型都算进去，技能包会让 skill/ 显得格外庞大，所以下表只数 TS 文件，与上面的总账口径一致，大致按增长的行数排序：

目录	文件：新增 / 修改 / 未动	行数：上游 → MiMo	增量内容	本书篇目
`session/`	34 / 18 / 2	6894 → 20906	检查点与重建、修剪与请求前缀快照、Goal、Max 模式、步骤分类与复读检测、会话导入	第 1 部分、Goal、Max 模式、复读检测与重试
`cli/cmd/tui/`	49 / 73 / 36	19749 → 33526	七种界面语言、语音输入、登录对话框、目标与任务侧栏	终端体验
`tool/`	33 / 19 / 5，删 2	3976 → 13978	`actor`、`task`、`memory`、`history`、`exec`、`cron`、`session`、`workflow` 等新工具，命令行式调用与输出精简，Git 隔离护栏	第 4、5、6 部分
`workflow/`（新）	11 / 0 / 0	0 → 2929	Workflow 运行时与 QuickJS 沙箱，外加 4 个内置 `.js` 脚本	Workflow 运行时、四个内置 Workflow、exec 与 QuickJS 沙箱
`actor/`（新）	11 / 0 / 0	0 → 2445	子智能体的注册、生成、等待与回收	Actor
`provider/`	2 / 12 / 20	8004 → 10405	模型能力登记、图片处理，适配层扩充	模型、提供方与提示词路由
`llm-server/`（新）	5 / 0 / 0	0 → 2221	兼容 OpenAI Chat Completions 协议的内置模型服务	内置 LLM 服务
`server/`	7 / 21 / 17	5885 → 7519	内置 LLM 服务与 workflow、交互式 bash 的路由，认证与限流	同上
`mcp/`	3 / 4 / 0	1522 → 3118	客户端采样、stdio 传输、工具结果归一	MCP
`plugin/`	5 / 7 / 2	2685 → 4277	MiMo 与 xAI 的登录插件，检查点写手收尾校验与子智能体进度检查两个钩子	模型、提供方与提示词路由、收件箱、团队与进度检查
`cron/`（新）	8 / 0 / 0	0 → 1256	调度器、cron 表达式、自定节奏的循环	定时任务与循环
`skill/`	9 / 2 / 0	404 → 1400	内置技能与 compose 技能的构建期打包、技能检索	内置技能包与技能检索、Compose
`history/`（新）	8 / 0 / 0	0 → 712	会话轨迹的 FTS5 全文检索	历史轨迹与全文检索
`task/`（新）	6 / 0 / 0	0 → 596	树状任务与完成门	树状任务
`permission/`	2 / 1 / 3	520 → 1104	Orchestrator 子会话的授权转发与持久化	Orchestrator
`inbox/`（新）	5 / 0 / 0	0 → 574	智能体之间的收件箱	收件箱、团队与进度检查
`memory/`（新）	7 / 0 / 0	0 → 498	记忆文件路径、全文索引、写入开关	分层记忆
`metrics/`（新）	6 / 0 / 0	0 → 197	使用统计上报	见下文
`team/`（新）	3 / 0 / 0	0 → 166	团队成员登记	收件箱、团队与进度检查

config/、flag/、agent/ 的变化是新配置段、新开关和新智能体，见怎么读这份源码；其余目录（lsp/、acp/、snapshot/、format/ 等）改动很小，这些机制直接看 OpenCode 专栏即可。十个全新目录合计 70 个 TS 文件、11594 行。

内置工具列表的后半段集中了大部分新工具，末尾三个受开关控制（packages/opencode/src/tool/registry.ts:296）：

            tool.actor,
            tool.fetch,
            tool.search,
            tool.code,
            tool.mcptoolsearch,
            tool.skillsearch,
            tool.skill,
            tool.patch,
            ...(Flag.MIMOCODE_EXPERIMENTAL_LSP_TOOL ? [tool.lsp] : []),
            tool.planexit,
            tool.memory,
            tool.history,
            tool.task,
            tool.toolscript,
            ...(Flag.MIMOCODE_EXPERIMENTAL_CRON ? [tool.cron] : []),
            ...(Flag.MIMOCODE_EXPERIMENTAL_ORCHESTRATOR ? [tool.session] : []),
            ...(Flag.MIMOCODE_EXPERIMENTAL_WORKFLOW_TOOL ? [tool.workflow] : []),

其中 tool.toolscript 就是 exec 工具，注册后还要过一道筛选：只对 GPT 系列工具集或设了 MIMOCODE_ENABLE_EXEC_TOOL 时可用（registry.ts:374）。

被删掉的 7 个文件

上游文件	行数	去向
`tool/todo.ts`	47	`todowrite` 工具整个移除；MiMo 的 `task` 工具改成了持久化的树状任务，工具说明写明它是唯一的工作项工具。上游 `task` 工具原本的派发子智能体职责交给了新的 `actor` 工具
`tool/websearch.ts`	74	拆成目录 `tool/websearch/`，多了走 MiMo 平台接口的 `mimo.ts`
`util/opencode-process.ts`	24	改名为 `util/mimo-process.ts`，环境变量换成 `MIMOCODE_RUN_ID` 与 `MIMOCODE_PROCESS_ROLE`
`v2/session.ts`、`v2/session-entry.ts`、`v2/session-entry-stepper.ts`、`v2/session-event.ts`	69、219、261、458	上游当时的 V2 会话原型，整个 `v2/` 目录删除，对应的 `session_entry` 表由迁移 `20260423145421_remove_session_entry` 删掉

最后一行值得多说一句：上游此后继续推进 V2，到 v1.18.30 已经有了 packages/core 里的新内核（见 V2 会话内核）；MiMo 删掉了这条线，新功能大多直接挂在 V1 的 SessionPrompt 主循环上，session/prompt.ts 从 1844 行涨到了 5647 行，见一条消息的旅程。

产品层面的改名

面向用户的名字基本都换了：

项	上游	MiMo
命令名	`opencode`	`mimo`（`packages/opencode/src/index.ts:76`）
工作区包作用域	`@opencode-ai/`	`@mimo-ai/`，CLI 的 npm 包是 `@mimo-ai/cli`
环境变量前缀	`OPENCODE_`	`MIMOCODE_`
项目配置目录	`.opencode`	`.mimocode`（`packages/opencode/src/config/paths.ts:31`）
全局配置文件	`opencode.jsonc`、`opencode.json`	`mimocode.jsonc`、`mimocode.json`（`packages/opencode/src/config/config.ts:543`）
数据目录名	`opencode`	`mimocode`，解析逻辑移到 `packages/shared/src/global.ts:6`，并支持 `MIMOCODE_HOME`
系统提示词里的自称	`You are opencode`	`You are MiMoCode`（`packages/opencode/src/session/prompt/default.txt:1`）

开关文件 flag.ts 从 107 行涨到 441 行，Flag 对象里的键从 54 个增加到 111 个。上游的键除了 OPENCODE_EXPERIMENTAL_PLAN_MODE（MiMo 的 plan 相关工具不再受它控制）都换了前缀保留下来，不少新键附带说明默认值的注释，例如（packages/opencode/src/flag/flag.ts:353）：

  // Defaults to OFF (opt-in): the Orchestrator primary mode — a general
  // coordinator that delegates to child sessions via the `session` tool, with a
  // global singleton workspace and child permission-approval routing. Enable with
  // MIMOCODE_EXPERIMENTAL_ORCHESTRATOR=true (or the umbrella MIMOCODE_EXPERIMENTAL).
  MIMOCODE_EXPERIMENTAL_ORCHESTRATOR: MIMOCODE_EXPERIMENTAL || truthy("MIMOCODE_EXPERIMENTAL_ORCHESTRATOR"),
  // Defaults to OFF (opt-in): dynamic workflows and built-in workflows.
  // Enable with MIMOCODE_EXPERIMENTAL_WORKFLOW_TOOL=true (or the umbrella
  // MIMOCODE_EXPERIMENTAL flag).
  MIMOCODE_EXPERIMENTAL_WORKFLOW_TOOL:
    MIMOCODE_EXPERIMENTAL || truthy("MIMOCODE_EXPERIMENTAL_WORKFLOW_TOOL"),

数据库也有一处默认值变化：MIMOCODE_DISABLE_CHANNEL_DB 默认为真（flag.ts:390），所有发布渠道共用一个 mimocode.db，不再按渠道分库。

改名没有深入到内部标识：

源码目录仍叫 packages/opencode，根 package.json 的 name 仍是 opencode（package.json:3），repository 仍指向 anomalyco/opencode（package.json:107）；
packages/opencode/src 里 65 个 Effect 服务标签有 62 个仍以 @opencode/ 开头，连 @opencode/Inbox、@opencode/TaskRegistry 这样的新服务也不例外，只有 3 个用 @mimocode/；
构建期注入的常量仍叫 OPENCODE_MIGRATIONS、OPENCODE_WORKER_PATH、OPENCODE_LIBC（packages/opencode/script/build.ts:270），packages/opencode/src/ide/index.ts:46 仍读环境变量 OPENCODE_CALLER。

读源码时知道这一点，搜索时就不会漏：找服务用 @opencode/，找开关用 MIMOCODE_。

默认开启的使用统计

新目录里有一个与功能无关、但用户值得知道的：metrics/ 订阅模型调用、工具调用、单轮请求与 Try-Best 检测四类总线事件，把耗时、token 数、工具名等字段上报到 packages/opencode/src/metrics/client.ts 里写死的地址。开关 MIMOCODE_ENABLE_ANALYSIS 默认为真，设为 false 或 0 才关闭（flag.ts:108，判断在 packages/opencode/src/metrics/subscriber.ts:13）。

不再维护的界面

仓库根 AGENTS.md 的 Core Focus 一节写得很明确（AGENTS.md:15）：

Development focuses on the TUI (packages/opencode/src/cli/cmd/tui/) and the engine core it runs on. The Web, App and Desktop surfaces are not currently maintained.

代码里的对应是 web 命令被注释掉（packages/opencode/src/index.ts:201）。packages/app、packages/desktop、packages/web 与 packages/console/* 仍留在仓库里，但本书只读 packages/opencode：TUI 加引擎，外加它依赖的 packages/shared、packages/plugin 与 packages/sdk/js。

下一篇：怎么读这份源码——仓库布局、目录地图、代码约定、构建期宏、开关与新增的数据表，以及几条阅读路线。