DevilDev的Souls积分体系全解析:Credits如何按Token计费、免费额度与订阅档位清单

原创2026-11-15 09:10:261,890 阅读

DevilDev的Souls积分体系全解析:Credits如何按Token计费、免费额度与订阅档位清单

DevilDev 是一款开源的 Spec Driven(规格驱动)AI 开发工具,它的灵魂是"从想法直接生成系统架构图"。而驱动这些 AI 能力的燃料,就是 Souls 积分体系:每次 Chat 发消息、生成架构、做项目分析,都会按真实 Token 用量自动扣除 Credits。本文将讲清 Credits 如何按 Token 计费、新用户免费额度是多少,以及 Free 与 Pro 订阅档位的完整差异清单。

DevilDev AI 开发工具首页,输入需求即可生成系统架构

一、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 消耗也随复杂度上升:

DevilDev 生成的系统架构图示例,组件节点与连线清晰展示

三、免费额度清单:新用户能白嫖多少?

免费额度相关常量集中在 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 行
支持开源社区 — ✅

几个新手容易忽略的细节:

  1. Pro 的 10,000 Souls 怎么到账? 支付成功后,Dodo 支付网关会回调 Webhook(src/app/api/webhook/dodo/route.ts),src/lib/subscription-helpers.ts 中的 upsertSubscription 会自动把 10,000 Souls 累加到当前余额——注意是"累加"不是"重置",这就是"滚存"机制的实现。
  2. 订阅状态由 Webhook 驱动:active(激活)、renewed(续费)、on_hold(挂起降为 Free)、cancelled(取消)、failed(扣款失败降为 Free),全程无需手动操作。
  3. Pro 图标就是下面的 PRO 标识,在界面中代表付费增强档:

DevilDev 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 花在真正有价值的架构生成上。

登录后查看全文
devildev