DevilDev的Souls积分体系全解析:Credits如何按Token计费、免费额度与订阅档位清单
DevilDev的Souls积分体系全解析:Credits如何按Token计费、免费额度与订阅档位清单
DevilDev 是一款开源的 Spec Driven(规格驱动)AI 开发工具,它的灵魂是"从想法直接生成系统架构图"。而驱动这些 AI 能力的燃料,就是 Souls 积分体系:每次 Chat 发消息、生成架构、做项目分析,都会按真实 Token 用量自动扣除 Credits。本文将讲清 Credits 如何按 Token 计费、新用户免费额度是多少,以及 Free 与 Pro 订阅档位的完整差异清单。
一、Souls 和 Credits 是什么关系?
在 DevilDev 里,同一个东西有两个名字:
| 出现位置 | 叫法 | 说明 |
|---|---|---|
| 前端界面 | Souls(灵魂数) | 导航栏上的计数器,悬停可见余额与说明 |
| 数据库/服务端 | Credits | User 模型中的 credits 字段,实际扣减的就是它 |
这个积分系统于 v0.4.0 版本正式引入(见 CHANGELOG.md),目的是让所有用户的 AI 用量"可预测、公平、可持续"。
界面上的计数器由 src/components/core/SoulCount.tsx 实现:它通过 Server Action 拉取余额,并监听 credits-updated 自定义事件,所以每次 AI 操作完成后,导航栏上的数字会实时跳动,不需要刷新页面。事件分发逻辑在 src/lib/credits-events.ts。
二、Credits 如何按 Token 计费?核心公式在这
这是全文重点。计费链路分两步:
第 1 步:统计 Token 用量
common/TokenUsageHandler.ts 是一个 LangChain 回调处理器,它会挂在每一次 LLM 调用上,自动累加:
totalInputTokens:模型读进去的 Token(提示词、上下文)totalOutputTokens:模型吐出来的 Token(生成的架构、回复)
第 2 步:换算成 Credits 并扣减
核心函数是 actions/credits.ts 中的 deductCredits,公式非常简单:
标准模式:
⌈输入Token ÷ 500⌉ + ⌈输出Token ÷ 100⌉仅输出模式(
onlyOutput = true):⌈输出Token ÷ 100⌉
也就是说:每 500 个输入 Token ≈ 1 Credit,每 100 个输出 Token = 1 Credit(向上取整,不足部分按 1 计)。
不同功能用哪种计费模式?
| AI 功能 | 源码位置 | 计费模式 |
|---|---|---|
| 架构生成 / 架构更新 | actions/architecture.ts | 标准模式(输入 + 输出) |
| 技术栈方案推荐 | actions/archOptions.ts | 标准模式(输入 + 输出) |
| 反向架构分析(分析现有项目) | actions/reverse-architecture.ts | 标准模式(输入 + 输出) |
| Chat 智能体对话(Agent 流程) | actions/agentsFlow.ts | 仅输出模式 |
| 项目分析 / 聊天 | actions/project.ts | 两种模式都有(视具体操作而定) |
💡 为什么 Agent 对话只扣输出 Token?因为对话中模型"读"的是你自己的上下文,按输出计费对多轮轻量对话更友好。
算笔账:一次架构生成大概花多少 Souls?
假设生成一份中等复杂的架构,模型消耗 10,000 输入 Token + 2,000 输出 Token:
- 输入部分:10000 ÷ 500 = 20
- 输出部分:2000 ÷ 100 = 20
- 合计扣 40 Souls
DevilDev 生成的架构图长这样,一次生成可能包含多个组件与连线,Token 消耗也随复杂度上升:
三、免费额度清单:新用户能白嫖多少?
免费额度相关常量集中在 Limits.ts:
| 项目 | 数值 | 说明 |
|---|---|---|
| 注册赠送 Souls | 250 | signUpInitialSouls,注册后弹窗直接到账 |
| 数据库默认余额 | 200 | credits Int @default(200),见 prisma/schema.prisma 与迁移文件 |
| 发消息最低门槛 | 5 Souls | 余额低于 5 时 Chat 会报 INSUFFICIENT_CREDITS |
| 生成架构最低门槛 | 25 Souls | 余额低于 25 时架构类操作会被拦截 |
按第二节换算,250 Souls 大约可以支撑:
- 一次"输入 1 万 + 输出 2 千 Token"的完整架构生成(约 40 Souls)× 6 次左右;
- 或几十轮以输出为主的轻量 Agent 对话。
对于熟悉产品、跑通"需求 → 技术栈 → 架构图"完整流程来说,这个免费额度完全够用。
四、Free vs Pro 订阅档位全对比 📋
定价页面 src/app/pricing/page.tsx 定义了两大档位,结合 Limits.ts 的限制项,完整对比如下:
| 维度 | Free($0/月) | Pro($25/月) |
|---|---|---|
| 每月 Souls | 250 | 10,000 |
| 剩余 Souls 滚存 | ❌ 不滚存 | ✅ 每月滚存 |
| 项目数量上限 | 5 个 | 50 个 |
| 单项目规模上限 | 25,000 | 100,000 |
| 单次聊天字符上限 | 25,000 | 200,000 |
| 架构重新生成次数 | 最多 5 次 | 不限次数 |
| 重新生成改动范围 | ≤ 50 文件 / 5,000 行 | ≤ 300 文件 / 50,000 行 |
| 支持开源社区 | — | ✅ |
几个新手容易忽略的细节:
- Pro 的 10,000 Souls 怎么到账? 支付成功后,Dodo 支付网关会回调 Webhook(src/app/api/webhook/dodo/route.ts),src/lib/subscription-helpers.ts 中的
upsertSubscription会自动把 10,000 Souls 累加到当前余额——注意是"累加"不是"重置",这就是"滚存"机制的实现。 - 订阅状态由 Webhook 驱动:
active(激活)、renewed(续费)、on_hold(挂起降为 Free)、cancelled(取消)、failed(扣款失败降为 Free),全程无需手动操作。 - Pro 图标就是下面的 PRO 标识,在界面中代表付费增强档:
五、Souls 使用小贴士
- 🪙 先看余额再操作:导航栏 Soul 计数器悬停可看说明,低于 25 时架构生成会直接失败。
- ✂️ 上下文越短越省:输入 Token 按 500:1 计费,精简需求描述、少贴大段代码能明显省钱。
- 🔁 Free 档用完即止:250 每月、不滚存,重活留到 Pro 或下月。
- ⚙️ Agent 对话性价比最高:多轮对话走"仅输出"计费,轻聊远比反复重生成架构便宜。
六、总结
DevilDev 的 Souls 积分体系可以一句话概括:输入 Token 每 500 扣 1、输出 Token 每 100 扣 1,注册送 250,Free 档每月 250 不滚存,Pro 档 $25/月 送 10,000 且滚存。所有规则都开源透明——扣费函数、限额常量、订阅 Webhook 全在仓库里可查。理解了这套计费逻辑,你就能精确规划每一次 AI 操作的"成本",把有限的 Souls 花在真正有价值的架构生成上。


