Codebase Brain

你的架构,是一张活的图谱。

仓库、模块、依赖关系、谁负责什么 —— 全部直接取自代码本身,不是某人在 2023 年画的一张图。它会在每次推送后自动重建,正在真实活跃的模块会发光 —— 所以这张图永远不会是维基里那张过时的老图。而这一切都落在与你的客户和收入相同的主线上,于是「这个功能到底影响了什么?」终于有了答案。

展示的是:AIOProductOS 真实的代码库 —— 我们自己的公司就跑在这上面。

代码库大脑

它懂你的产品 —— 连代码都懂

你的架构以一张活的图谱呈现,接入与客户、收入相同的主线。点一下,看看它能给你什么。

活地图

你的架构,就是一张图

  • 模块按功能分簇,依赖关系以弦线呈现
  • 每次推送后自动重建 —— 再也不是过时的维基图

自动文档

自己写自己的文档

  • 从代码图谱生成,并保持同步
  • 没人需要再维护一个维基

活跃度

它会告诉你哪里是活的

  • 有真实活跃度的模块会发光
  • 看清工作到底发生在哪里

端到端

客户记录上的代码

  • 从一个功能追溯到交付它的代码
  • ……以及依赖它的收入

展示的是:AIOProductOS 真实的代码库 —— 我们自己就跑在这上面。

这张图

每个模块,都按它真实的样子连接。

整个代码库的一张交互式图谱:模块按功能簇分组,依赖关系以弦线交织呈现,大小按每块代码的承重程度缩放。点一个模块即可展开它的连接关系 —— 代码变了,图也会自动重建。

    从代码本身构建

    节点、连线和模块边界都来自代码实际导入的内容 —— 路由、函数、组件、表 —— 不是一张会慢慢过时的手绘图。

    节点上的归属信息

    每个模块都标明了归属人和文件数量。新工程师拿到的是一张地图,而不是一场部落知识的口述之旅。

    带权重的依赖关系

    模块间的连线显示彼此依赖的强弱 —— 在动手之前就先看清会牵动什么。

它会自己保持最新:这张图每次推送后都会重建,另外每天还会自动重建两次,数据直接来自 GitHub 连接器 —— 不用配 CI,不用手动维护图。想立刻看到最新的?随时可以手动刷新。

活文档

自己写自己的文档。

按模块生成的文档,直接从图谱生成:这个模块是做什么的、由什么组成、它连接最多的部分、它拥有的表和 RPC,以及它依赖什么。从你的仓库里提取的 README 就在旁边。

  • 确定性生成 —— 直接从图谱计算得出,不调用模型,不产生 token 费用。
  • 始终最新:图谱每次重新发布,文档就已经跟着对齐了。
  • 每个模块都有「依赖 / 被依赖」——用文字把连接关系说清楚,不只是画出来。
codebase / docs / connectors

connectors — 546 个部件

routes 38 · functions 412 · mappings 51 · tables 9

关键部件

  • · stripe/route.ts — 回填客户和 MRR 数据
  • · github/mapping.ts — 仓库、语言、活跃度
  • · sentry/mapping.ts — 错误 → 工作项

依赖

db · webhooks

被依赖

pm · analytics · modules

从代码图谱生成 · 示例数据

codebase / inventory
  • route api/connectors/stripe connectors 64
  • table analytics_event db 58
  • function stitchIdentity db 41
  • component BoardView pm 37
  • route api/codebase/brain/refresh codebase 22

语言 · 所有已同步仓库

TypeScript 68% · SQL 22% · 其他 10%

按连接数排序 —— 承重程度优先 · 示例数据

资产清单

每一个代码资产,都在一个可搜索的目录里。

图谱里的每个节点,都变成一份扁平、可筛选的列表:类型、名称、模块、文件,以及有多少东西与它相连 —— 按承重程度排序。它是这张图的表格版孿生兄弟,来自同一份数据源,永远不会跟图脱节。

  • 按类型、模块或名称搜索和筛选 —— 先找到部件,再找到它的文件。
  • 跨所有已同步仓库汇总的语言占比。
  • 按代码托管平台列出仓库,包含活跃度、可见性、star 数和未解决的 issue。

数据来源

接入三个代码托管平台,部署、错误和数据库结构也一并接入。

接入你已经在用的工程技术栈。架构图谱由 GitHub 构建而来 —— 接入它,图谱就会出现,你这边不用任何 CI 或 devops 工作 —— 而部署、错误和数据库结构则会落到同一条主线上,与它并列。

    代码托管平台

    GitHub · GitLab · Bitbucket

    目前架构图谱由 GitHub 构建 —— 对 TypeScript/JavaScript + Supabase 支持最深入。GitLab 和 Bitbucket 会把仓库元数据同步到主线上,与收入并列。

    部署

    Vercel · Netlify · Cloudflare

    一条部署时间线,包含项目、环境、状态、分支和 commit。清楚知道一个功能到底是什么时候真正上线的。

    错误

    Sentry

    生产环境的错误会作为带堆栈信息的工作项落地 —— 一个可以关联到账户和功能的实时错误流。

    数据库结构

    Supabase · Firebase

    数据库结构和访问态势 —— 表、策略、鉴权配置。我们绝不读取你客户的具体数据行。

    后台任务

    Inngest

    异步任务、失败和重试都会变成可见的工作项 —— 你系统里那看不见的另一半,也上了记录。

    再往外走

    Zapier · webhook

    主线上的事件会触发外发 webhook,让你其余的工具能实时响应,而不用不停轮询。

每个数据源都按连接器逐个落地 —— 接入一个,数据就开始流动;接入更多,画面就更完整。

同一条主线

代码在一边,客户在另一边。同一条记录。

大多数团队把架构放在一个工具里,把收入放在另一个工具里,中间什么都没有。在这里,仓库、部署和错误都落在早已承载着你的账户、订阅和反馈的那条主线上。于是,功能、背后的代码,以及正在等待它的客户,就不再是三个互相割裂的问题。

观看:架构图,实时运行在主线上 · 示例数据

老实说的边界:代码数据是按连接器逐个接入主线的。Sentry 的错误目前会以工作项的形式到达;更丰富的按客户细分的代码视图,会随着每一个 join 的接入而逐步点亮。

1,734 个节点 · 4,217 条连接 · 36 个模块

这页顶部的这张图,就是我们自己的架构图。这些是 AIOProductOS 架构图上真实的数字 —— 和我们团队用来带新工程师入门、判断一次改动会牵动什么的,是同一个屏幕。我们展示的不是一个概念演示,而是我们自己真实的代码库。

开始使用

在主线上看看你自己的架构。

一键接入 GitHub —— 不用配 CI,不用写 YAML,没有任何东西需要手动接线。仓库和语言几分钟内就能同步完成,图谱由此开始构建,并且会自己保持最新。

FAQ

常见问题

Codebase Brain 展示的是什么?

你的架构以交互式图谱呈现 —— 仓库、模块、依赖关系和归属人 —— 再加上完整的代码资产清单和自动提取的文档,让你能直接看清整个系统,而不用一行行代码去读。

哪些工具在为它提供数据?

架构图谱由你的 GitHub 仓库构建而来 —— 接入 GitHub,它就会出现,你这边不需要任何 CI 或 devops 工作。与之并列、落在同一条主线上的,还有:GitLab 和 Bitbucket 的仓库元数据,来自 Vercel、Netlify 和 Cloudflare 的部署数据,以及来自 Sentry 的错误数据 —— 都紧挨着你的客户和收入。

文档是从哪里来的?

它们是从已映射的代码库里自动提取出来的,所以文档反映的是真实的模块和它们之间的关系,而不会像维基那样慢慢过时。

为什么要在一个产品操作系统里映射代码?

因为它落在与收入和产品工作相同的主线上 —— 所以一个模块不只是代码,它还关联着它所服务的功能和客户。这就是那个「为什么」,用收入和代码给出的答案。

我需要自己保持它更新吗?

不需要。接入 GitHub,这张图就会自己重建 —— 每次推送后重建一次,另外每天还会自动重建两次 —— 完全不用配置 CI 或 devops。正在真实活跃的模块会发光,反映出工作实际发生在哪里。如果你想随时手动刷新,这个入口也一直都在。