v2.0.0 — 从知识库编译器，到由人驾驶的研究状态机
MAGI v1（Wikify）把论文编译成知识库，回答「我们知道什么」。v2 同时管理
「我们还不确定什么」，并且把「agent 该怎么做」从写给 agent 看的散文，改成了
agent 绕不过去的机器。
这是一次破坏性重构。老工作区用 magi migrate 一次性转换，raw/ 与 wiki/
的字节不改写。先跑 magi migrate --dry-run：它说清会改什么，一个字节都
不写。
设计上的变化
不确定性是一等公民。 threads/ 里住着命题（有真值、有温度）、问题和研究
线，论坛式跟帖、只追加。没落定的东西不是「还没变成知识的草稿」，它本身就是
研究状态的主体。
能算出来的就不存。 magi next 不读待办列表——它从 note 里推导欠了什么。
没有第二份状态，也就没有「状态不同步」这回事。
确定性 CLI 是拘束具。 命令的存在目的是约束 agent，不是伺候它。凡是能写成
命令、闸门或测试的规则，就不留在 skill 里当散文。
记账靠近，评判远离。 状态由离它最近的人写下；质量由不共享你上下文的人
评判——magi review 刻意换一家厂商的模型，让它无法继承你的预设。
仪式性动作属于人。 关掉一条研究线（magi close）、发表（magi publish）
永远由人调用。判断一个问题已经结束，正是人存在的理由。
慢环提议，人批准。 magi reflect 读真实工作的痕迹、发现模式、提议规则——
但从不自己应用。一个能改写自己规则的 agent，它的规则等于不存在。
你会直接用到的
magi next—— 裸magi等价。派生出该做什么，只提议不动手。magi sync --close—— 收工闸门。有事发生却没人写下来时它拒绝通过。magi ui—— 本地看板，整个环路在浏览器里也能走完。三套主题，含
EVA「MAGI MODE」的红·战斗与蓝·静默两个警戒态。magi search—— 混合检索（BM25 + 向量 + RRF），默认只搜当前项目，
--scope all才跨项目。magi review—— 跨厂商复核。事前说要问谁、花多少，事后报本周用量；
周预算用完拒绝启动而不是安静地少做。--verbose/MAGI_DEBUG=1—— 任何命令都认，会传给子进程。命令失败
而说得不够时用它。
八个 skills 随包分发，magi install 装进机器上每一个探测到的 agent CLI
（Claude Code / Codex / Antigravity / opencode）。
词表
一个目录承载一个研究主题，只有一个名字：项目 / project。退役：工作区、
知识库、本库、课题、hub。
质量
2639 个测试；42 条变异用例（「把 bug 放回去」的清单，python -m tests.mutations），
全部会咬。三宿主冒烟于 2026-08-31 在 Windows 11 通过：复核者驳回了一个故意
过宽的命题并逐行点名矛盾，18.3 秒。
macOS：CI 全绿，但从未冒烟——没有 Mac 可跑。CI 矩阵是唯一能给的保证。
pipx upgrade --install magi-researchBrowser button — magi-browser-extension-v1.2.1.zip below.
Unzip it, open chrome://extensions, turn on Developer Mode, and use Load unpacked on the unzipped folder. It sends the page you are reading to a local MAGI queue and nothing else; nothing enters a library until you approve the batch.