Flare 的巧思：让 agent 改代码时，人先看见影响面而不是聊天记录

Flare 是一款面向 agentic coding 的开源 IDE：主界面是代码库的实时依赖图，文件是节点，import 是边；底部是可直接运行 claude、codex 或 opencode 的真实终端。agent 改文件时，图会跟着更新；变更会按批次进入本地 shadow history，支持按文件或整棵树 diff 与回退。Flare 也能作为桌面应用，或在 agent 所在机器上以浏览器方式打开。1

产品解决的是长任务之后的监督问题。开发者让 coding agent 跑一段时间，回来时常看到几十个被改过的文件：diff 能列出改了什么，却很难立刻回答「哪些改动牵一发而动全身」「测试是在改完之后跑的，还是改完又接着改了」「agent 当时想完成什么」。Flare 把回答这些问题的界面，从聊天记录挪到了代码结构图和按批次组织的审查台。12

多数 agentic 工具把对话时间线当作默认工作面。Flare 反过来：主表面是实时依赖图。Canvas 视图把文件卡按依赖深度从左到右排开，基础模块在左，入口在右；悬停某个文件时，它 import 的文件亮蓝，import 它的文件亮琥珀，blast radius 不用靠 grep 重建。Wheel 视图把所有节点放在一圈上，依赖以弦线穿过圆心，便于一眼看出哪些文件跨目录牵动全仓。1

图不只是可视化装饰。Flare 会监视终端进程树，把 claude / codex / opencode 等 agent 的写入归因到对应作者；被改过、尚未审查的节点用警告橙色标记，并带热度衰减。更关键的一层是：高风险改动会主动找人。Review 标签页本身要用户点进去，而承载型文件在用户盯着图时被改写，容易被漏掉。这类变更会以角落 alert 排队，每张卡片对应一个文件，按最新优先排列，直到用户选择 Review 或 Dismiss。Dismiss 只关掉卡片，并不等于批准改动；文件仍保持未读、仍停在 agent 留下的状态。触发门槛是 careful 层级，再叠加真实下游依赖、环、复杂度或完全没有测试等硬条件，避免仓库里没有真正关键文件时还不停弹窗。1

这里的设计判断很清楚：人离开屏幕后最需要的，往往不是完整聊天回放，而是「结构上哪里被碰到了」。把监督主对象设为依赖关系与 blast radius，移动注意力的成本会低于在长对话里逐条翻。代价同样明确：图的信息密度高，首次打开大仓时需要靠文件夹逐级展开、镜头切换和搜索过滤；而且 Flare 的审查舱依赖自己终端下的进程树，后端必须跑在 agent 所在机器上——远程开发时要用 npm run serve 在那台机器提供浏览器入口，而不是只在本地镜像界面。1

第二个巧思在 Review cockpit。Flare 把变更按 burst 分组：同一作者、同一批写入。每个 burst 不只列文件列表，还回答三件 diff 通常答不好的事。1

第一件是实际检查过没有。Flare 同时观察文件写入和终端命令，因此能区分 verified、failed、「检查过之后又改了」、never checked，并引用给出判定的输出行。第二件是这批改动想干什么。agent 可在编辑前调用 record_intent；若没调用，burst 会明文写上缺失意图，避免人第一次看到代码时还要倒推动机。第三件是哪些文件值得细看。每个文件按 blast radius、覆盖率、环和复杂度分成 read carefully / read / skim，并写出理由，例如「9 个文件会在这里出错时一起坏」「没有测试覆盖」。三十个文件的变更，因此不会被平均分配成三十次同等扫视。1

burst 还附带一组 agent smells：与被测代码同批改测试、删除断言、加入 .skip / .only、引入 lint 或类型压制、降低覆盖率阈值、复杂度陡增、留下没有 importer 的文件、为单一调用方抽出抽象等。这些规则针对的是 agent 容易走、人类较少走的捷径。配合 shadow history——独立 GIT_DIR 的隐藏本地仓库，按 burst 自动快照——用户可以回退单文件、整批，或跳回「检查仍通过时的最后状态」，而不碰真实 git 仓库。1

任务面板把同一套结构信息送回 agent 侧。看板卡片的主操作是 Copy for agent：复制任务说明、点名的文件，以及图已知的上下文，例如「下游 29 个文件、覆盖率 0%、处于 import 环」。agent 也可通过 MCP 查询 graph_overview、impact_of、verification_status 和看板工具，从地图起步而不是用半段上下文重新摸仓。架构决策则走另一条通道：decision_record 在假设成立的代码之前写入，状态为 proposed，须由人同意或拒绝并写理由；agent 不能批准自己的提案。1

Flare 给 AI 编程工具的监督层提供了一条可迁移路径：把主界面从对话时间线换成代码结构图，让人先看见依赖与影响面；再把审查单位改成带验证状态、意图和阅读优先级的 burst，让人按风险分配注意力，而不是按文件列表平均扫一遍。

这套设计也把边界写进了交互本身。agent 直接写磁盘，审查决定的是保留什么，而不是拦截写入；Unread 镜头只在人真正打开文件后才清除，批准不会假装已经读过；危险命令会触发告警与快照。产品本地运行、无需账号、MIT 许可，MCP 默认挂在本机端口；浏览器模式靠 token 保护文件与 shell，扩大监听地址时风险由部署者承担。13

对 AI 产品来说，可迁移的原则是：当 agent 的产出速度超过人的阅读速度时，优先设计「下一眼该看哪里」的监督对象——结构、影响面、验证状态和意图——再考虑把聊天记录做得更长。