Understand Anything trial hero
Understand Anything 试跑
样本: nextjs/saas-starter 文件: 51 批次: 4
trial report

它能把一个 SaaS 模板
读到什么程度

这次试跑用官方 GitHub 的 Next.js SaaS starter 作为样本,重点验证三件事: 它能否把 auth / billing / db / dashboard / middleware 这些结构分开, 是否能给出可用的架构理解,以及一轮全量分析大约要消耗多少 token。

代码行数 3,601 原始内容 token 33,943 预计 full run 40k-50k

试跑结论先说

它不是只会“读 README”。对这种典型 SaaS 模板,它能稳定识别出前台营销页、登录流、订阅页、团队管理页、Stripe 结算、JWT session、数据库 schema、middleware 保护路由。

可做的事结构图、导览、影响分析、问答
样本类型Next.js + Drizzle + Stripe
结论形式可量化,能落到批次和 token
Understand Anything 试跑
2 / 8
capabilities

它能做什么

对这类模板项目,它的价值不是“背源码”,而是把代码分层后形成可浏览的认知图谱: 什么是入口,什么是保护层,哪里是业务层,哪里是持久化和支付集成。

structure

文件级图谱

能把 app、lib、components、migrations、docs、config 分开,不会把一个 SaaS 模板揉成一坨。

relations

导入与依赖

能读出 middleware -> session -> auth,checkout -> stripe -> db 这类实际关系。

workflow

导览和 onboarding

可以生成按顺序的学习路径,适合新成员从 landing 看到 dashboard 再进 payments。

impact

改动影响分析

能把单文件修改扩散到哪些页面、服务、数据层列出来,适合评审和改动前检查。

这次样本里它看到了什么

README 只告诉你这是一个 SaaS starter;实际试跑后,结构会落到登录、订阅、团队、活动日志、数据库迁移、session 刷新、Stripe checkout、customer portal、以及中间件守护这些具体层。

// 典型会被分出来的模块
app/(login)/actions.ts
app/(dashboard)/dashboard/page.tsx
lib/auth/session.ts
lib/payments/stripe.ts
lib/db/schema.ts
middleware.ts
Understand Anything 试跑
3 / 8
sample baseline

样本仓库的硬数据

这个样本是一个 51 文件的 SaaS starter,文件分布很标准,适合测试结构识别。关键不是“文件很多”,而是它有清晰的业务分层:营销页、登录、Dashboard、支付、数据库、样式和配置都在。

total files

51

文件层可见度足够高,适合做模块图。
code files

42

绝大多数是 TypeScript,说明它的代码理解能力会真正被用到。
code lines

3,601

这是我们用于 token 估算的主要基线。
batch count

4

compute-batches 把 51 个文件分成 4 批。

文件类型分布

按 fileCategory 统计
code
42 files
config
6 files
markup
1 file
data
1 file
docs
1 file
// 最大的文件很有代表性
app/(login)/actions.ts - 459 lines
lib/db/migrations/meta/0000_snapshot.json - 388 lines
app/(dashboard)/dashboard/page.tsx - 287 lines
app/globals.css - 275 lines
components/ui/dropdown-menu.tsx - 257 lines
Understand Anything 试跑
4 / 8
architecture reading

它怎么读懂这个 SaaS 模板

这个项目不是随机堆页,而是典型的业务分层 SaaS:前台营销页、登录与注册、Dashboard、Stripe 支付、JWT session、Drizzle ORM、数据库 schema、middleware 路由保护。理解这些分层,就是它真正有用的地方。

auth

session / middleware

middleware.ts 会读取 session cookie,GET 请求时刷新 1 天过期时间。
billing

stripe checkout / portal

checkout 和 customer portal 都能从代码里直接定位出来。
database

schema / queries

users、teams、team_members、activity_logs、invitations 都是显式表。
ui

landing / dashboard

首页是 marketing pitch,dashboard 才是核心操作面板。
module map

从入口到业务层

图里不是“漂亮线条”,而是这次试跑真正能抽出来的结构:页面入口、守护层、支付层、数据库层和中间件。

core auth / billing / db landing app/(dashboard)/page.tsx dashboard dashboard/page.tsx login app/(login)/actions.ts middleware protect routes db schema / queries billing Stripe checkout
Understand Anything 试跑
5 / 8
token estimation

代码行数 - token - 开销

这次不是拍脑袋。先用扫描脚本拿到文件规模,再用 batch 划分和原始字节数估算 token。这里的数字是“原始内容估算 + 管线开销”,不是猜测。

33.9k

原始文件内容按 bytes / 4 估算的 token 基线。
代码行数
3,601 / 4,592 total lines
原始内容
135,772 bytes ≈ 33,943 tokens
批次开销
4 batches, prompt overhead roughly 4k-6k tokens
输出开销
graph summaries + edges roughly 5k-8k tokens
全量试跑
roughly 40k-50k tokens end to end

四个 batch 的体量

按文件数与 lines
B1
1 file
88 lines / 834 tok
B2
5 files
228 lines / 1.6k tok
B3
25 files
2,533 lines / 19.5k tok
B4
20 files
1,743 lines / 12.1k tok
// 量化口径
raw content tokens = files bytes / 4
prompt overhead = scan + batch context + import map
output overhead = node/edge summaries + layer/tour text
Understand Anything 试跑
6 / 8
strengths / limits

它擅长什么,不擅长什么

对这类模板,它能把结构、业务流、入口页面和数据库关系讲清楚。但它不是“自动结算 token 的计费器”,也不是脱离上下文就能把所有业务规则猜准的东西。

擅长:定位入口、登录流、支付流、DB schema、middleware、页面层和服务层的关系。
擅长:把一个 SaaS starter 的信息架构拆成可学习、可巡检、可回看的一张图。
擅长:在这种中等规模代码库里给出可执行的 onboarding 和 diff 影响视图。
边界:token 数值在这个试跑里是基于 bytes / 4 和批次结构的估算,不是 provider 账单回执。
边界:如果仓库里有大量动态生成代码或超长文档,token 预算会明显上浮。
边界:它能理解结构,但最终语义判断还是要和源码、README、运行时行为交叉验证。

一句话结论

对典型 SaaS 模板,Understand Anything 的价值很明确:它能把“看不懂的仓库”变成“可浏览的结构图”,而且规模与 token 开销是可以提前估算的。

如果是你自己的项目

真正有用的不是总 token,而是“你愿意为多少项目上下文买单”。像这次 51 文件的 starter,full rebuild 大约 4 万到 5 万 token;如果是增量更新,成本会低很多。

适合的场景

新人 onboarding、代码评审前的结构熟悉、变更影响范围预估、以及给技术栈相似的模板仓库做横向比较。

Understand Anything 试跑
7 / 8
real run

把实际运行效果放进 Pages

这不是示意图。右侧这张图是 Understand Anything 跑完后的真实界面:左边是知识图,中间是节点关系,右边是摘要和操作区。Pages 里直接能看到它跑起来的样子。

// 页面里展示的是实际输出
knowledge graph overview
node summaries and layer legend
guided tour entry + search interface
如果你在浏览器里打开这页,看到的就是分析后的 Dashboard 截图,不是单纯的介绍文案。
3w 目标样本orion-kit · 40,177 lines,最接近这次要找的段位
更大的备选skateshop · 53,622 lines;nextbase · 69,195 lines
dashboard screenshot

运行结果

Understand Anything actual dashboard screenshot
图谱视图文件、函数、类和依赖都能点开
右侧面板摘要、节点数、层级和入口按钮
这页的作用把“项目跑出来之后长什么样”直接摆出来
Understand Anything 试跑
8 / 8
closing verdict

结论很简单

对典型 SaaS starter,Understand Anything 的能力边界已经很清楚了:它能把仓库结构、依赖关系、主要业务流和学习路径读出来,并把这件事控制在可量化的 token 预算里。

能做到的程度

把一个中等规模 SaaS 项目拆成可理解的图谱,而不是只给你一份“长 README 摘要”。

这次的成本

51 files,3,601 code lines,33,943 raw tokens,整轮约 40k-50k tokens。运行效果也已经放进 Pages,补测样本选的是 40k 行左右的 orion-kit。

最有价值的输出

新成员 onboarding、改动影响分析、架构层划分、以及对业务流的快速定位。

下一步

把这页 deck 部署上线,再看它在真实协作里能不能持续产出增量价值。

Understand Anything hero
输出路径建议:ppt.waterme7on333xxxx.com/understand-anything-try