#3683 [开源自荐] Birdview：先看清 AI 改什么，再让它动手

项目地址

https://github.com/Qiuner/birdview

类别

人工智能 / 开发者工具

项目标题

Birdview：先看清 AI 改什么，再让它动手

项目描述

编程的第三个时代来了

编程已经经历了两次范式切换，现在该进入第三个时代：

古法编程：人写每一行代码，人理解每一个细节。
Vibe Coding：人描述需求，AI 承包代码。
Architecture-first Coding：人掌控架构，AI 对着地图干活。

Vibe Coding 解放了双手，却把工程塞进了黑盒。AI 在仓库里横冲直撞，你看不见它理解了什么，也不知道它准备碰哪些模块。等它说“完成了”，留给你的往往只有几百行 diff，以及一句无法验证的保证。

Vibe Coding 不是终点。只关注需求、不关注架构的 AI 编程，规模越大，失控越快。

Birdview 要带来第三个时代。

在 AI 动手之前，先让它把项目架构画成地图：模块是什么、职责在哪里、文件归谁、关系如何连接、证据来自哪里。然后让 AI 在地图上声明范围、亮出目标，再开始修改。

从这一刻起，AI 不再闭着眼睛写代码，而是对着地图干活。

开发者也不必再埋进每一行代码里追赶 AI。你真正需要盯住的是更高一层的问题：它有没有正确理解架构，它准备改哪里，它有没有越界，它声称完成的事情到底验证过没有。

Birdview 最终输出一个独立、可交互的 HTML：架构全图、计划范围、当前目标、变更历史和前后对比，打开就能看。不需要服务器，不需要网络。

亮点

把 AI 编程从“需求驱动代码”推进到“架构驱动执行”
AI 修改前先建立有源码证据支撑的项目架构地图
用稳定模块、文件归属和关系明确改动会落在哪里
在同一布局上查看完整架构、变更范围和前后对照
区分 Agent 声明的动作与真正记录的验证结果
生成无需服务器和网络资源的自包含 HTML

示例代码

git clone https://github.com/Qiuner/birdview.git
cd birdview
npm ci
npm run build:demo

然后在浏览器打开 examples/harness-activity.html。也可以用自己的 architecture.json 和 activity.jsonl 运行：

node scripts/validate.mjs .birdview/architecture.json .birdview/activity.jsonl
node scripts/render.mjs .birdview/architecture.json .birdview/activity.html .birdview/activity.jsonl

截图或演示视频

项目介绍页：https://qiuner.github.io/birdview/

README：https://github.com/Qiuner/birdview#readme

说明：团队自荐。项目当前为 v0.2.0，持续维护中。活动记录由 Agent 声明，Birdview 不会自动观测真实编码操作。