Civitai 捐赠目标DonationGoal设计重构以众筹免费 30 天取代永久解锁的四条规则方案【免费下载链接】civitaiA repository of models, textual inversions, and more项目地址: https://gitcode.com/GitHub_Trending/ci/civitai导读本文基于仓库内 docs/creator-studio/monetization/donation-goals.md 的设计文档完整讲解 Civitai 捐赠目标DonationGoal从达标后永久免费转向众筹一个免费月的四条规则设计并结合 donation-goal.service.ts、paid-access.service.ts 等源码验证捐赠即时到账、无捐赠者退款、达标不锁定三个关键现状分析构建成本、决策记录、去留争议与开放问题。读完你将理解该方案的规则骨架、底层实现链路与决策边界可直接用于评审、实现或二次设计。该设计文档状态为proposed提案尚未实现并取代了此前探索托管escrow与退款的donation-goal-escrow.md。同时需注意整个 DonationGoal 功能本身也在考虑移除2026-09-03 Justin 提出等待社区反馈因此在动手构建之前必须先决定是否保留捐赠目标这一前置问题。四条规则整个设计的全部设计用四条规则完整定义了捐赠目标的行为刻意不引入转换矩阵、退款路径或任何永久状态捐赠目标必须建立在提供下载权限download的门控之上。不能把目标挂在仅生成generation-only的门控上。目标达成 → 模型对所有人免费 30 天。窗口期内禁止任何购买计时从目标达成的那一刻开始。30 天结束后创作者可以随意为模型定价。没有目标的门控自由定价。没有目标的早期访问日期只是预计日期estimate必须如实标注。窗口结束后模型只是解除门控——只有创作者再次设置付费访问它才会重新被门控。文档原话That is the whole design. There is no transition matrix, no refund path, and nothing is permanent.这就是整个设计。没有转换矩阵没有退款路径没有任何永久状态。每条规则在解决什么规则 1 无需显式规则即封堵了仅生成逃生通道。创作者无法把带目标的模型切换为仅生成模式因为那样目标将不再合法。早期设计需要逐一枚举所有降级路径——去掉下载、涨价、切换为永久——并且总是在漏掉的那条路径上出问题。此处由目标的前提条件完成这份工作。规则 1 还保证了达标目标交付的是持久的东西用户可以保留的文件。访问记录EntityAccess只由购买产生因此免费窗口在仅生成模型上交不出任何持久权益——30 天用完就什么都没有。规则 1 使这种情况不可能发生。规则 2 的购买拦截是规则 1 的安全保障。窗口期内没有购买就没有人在窗口中途获得永久访问权EntityAccess始终保留购买的含义。窗口在两个方向上都是惰性的不进钱也不出钱。规则 3 和 4 是创作者的灵活性也是整个设计不需要退款的原因。创作者永远不会被困住他们只是不能收回已经卖给社区的这一个月。创作者付出的代价达成目标意味着损失 30 天的销售额。因此目标金额至少应等于该模型一个月的收入否则捐赠者就是替所有人以低价买下了这个月。文档指出创作者今天没有任何理性方法设定目标金额这套设计给了他们一个——并且可以从他们自己的销售历史中给出估算值。现状核实代码验证的三个事实创作者线程在第二个事实上得出了相反结论因此文档用代码核实了三个事实事实一捐赠立即支付给创作者。donateToGoal通过createMultiAccountBuzzTransaction将 Buzz 直接转到goal.userId无持有期、无中介见 donation-goal.service.ts。其中toAccountType: buzzType保证捐赠者用什么颜色green/yellow的 Buzz 捐创作者就收到什么颜色——源码注释记录了此前的缺陷不指定目标账户类型时Buzz 服务会应用黄色默认值导致绿色捐赠到达创作者时变成黄色自绿色 Buzz 上线以来已产生 137 笔腿账 / 85,210 Buzz。事实二不存在捐赠者退款。30 天早期访问退款是存在的但它退款的是付费访问的购买者且仅在取消发布unpublish时触发见 model-early-access-refund.service.ts。捐赠者只有在自己的捐赠交易中途失败时才会被退款refundMultiAccountTransaction见 donation-goal.service.ts。创作者线程假设该保护存在实际上并不存在。在四条规则下也不需要——没有任何承诺可以被打破。事实三达标的模型目前并不会保持解锁。endPaidAccessNow的实现就是一条 SQLUPDATE PaidAccess SET endsAt NOW()仅此而已见 paid-access.service.ts下一次编辑器保存会执行writePaidAccessForModelVersion其permanent分支会写入一个新的门控endsAt NULL, timeframeDays NULL见 paid-access.service.ts。所以今天的现实是创作者可以收下全额资助的目标让模型解锁然后当天下午就重新门控它。规则 2 的 30 天窗口正是针对这种情况必须强制的最低保障。另外checkDonationGoalComplete目前只会结束限时timed门控源码中isTimedGateActive判断 endPaidAccessNow调用见 donation-goal.service.ts因此挂在永久付费访问上的目标是惰性的——捐赠者资助的东西按构造就解锁不了任何东西。规则 2 通过把解锁变成目标的属性而非门控的属性修复了这一点。从代码实现还可以看到捐赠链路的完整性约束对应 donation-goal.router.ts捐赠入口为 tRPC 的donationGoalRouter.donate需要TokenScope.SocialTip作用域并禁止 API Key。输入校验donation-goal.schema.ts只有amount: number与donationGoalId: number。业务规则Blue Buzz 禁止捐赠、目标必须 active、不能向自己的目标捐赠。目标达成的处理顺序是先提交捐赠donation.create再尽力而为地关闭目标并结束限时门控门控结束的缓存清理是 fail-open 的Redis 抖动只记录日志绝不回滚已提交的捐赠而目标关闭与门控结束的 DB 写入是 fail-closed 的真实写失败必须抛出。这一区分被 donation-goal.service.test.ts 的 7 个用例逐条验证未达标不关目标、ComicChapter 实体不触发 ModelVersion 缓存清理、fail-open 的缓存清理、fail-closed 的 DB 写入等。切换确实发生过的证据writePaidAccessForModelVersion把永久门控写为endsAt NULL, timeframeDays NULL。但仍有 63 条永久门控带着timeframeDays——这个残留与限时门控经某条未清理该字段的路径切换为永久一致。63 条之中数量带有捐赠目标31——收了钱15· 15,200 Buzz · 62 位捐赠者—— 目标全额达成1⚠️ 注意这是证据而非证明且是下限而非精确计数。另一条写路径也可能留下该字段而任何清除了该字段的切换都不可见。真实数字 ≥ 15。构建成本比任何早期方案都小因为什么都不持有、什么都不永久成本小于此前所有选项门控上的免费窗口——goalMetAt now goalMetAt 30 days解析为免费无论门控本身怎么说。只需要在解析路径上加一个区间判断。购买守卫—— 窗口开启期间拒绝购买。目标前提条件—— 目标只能在门控授予下载权限的地方创建。文案—— 预计日期要读起来像预计日期免费月要读起来像一个月。不需要托管escrow、不需要退款路径、不需要终态、不需要持有余额、不需要回填在途资金。已决事项事项决定未达成的目标对捐赠者什么都不发生。创作者保留捐赠。这正是当前的工作方式也是绝大多数情况——值得以后重新审视但不是现在。窗口期结束解除门控。不是终态。只有创作者再次设置付费访问才会重新门控。免费月何时开始目标达成的那一刻而非原来的免费日期。永久性30 天是唯一保证的免费。不存在永久免费承诺。托管escrow搁置2026-09-03。不追求持有捐赠并退款。四条规则下没有任何东西需要它。没有任何东西是终态的取代了此前的决定此前认为达标目标和窗口期结束都应让模型永久免费。以上规则是当前立场。是否保留捐赠目标一个必须先做的决定截至 2026-09-03 在考虑中等待社区反馈。两件事使这个决定不同寻常且都反对进行大规模投票。移除目标会消解本文档要解决的问题自创作者线程以来的一切都是在管理捐赠所创造的义务。没有捐赠就没有义务早期访问日期变成一个如实标注的预计日期规则 4 就是全部设计。这不是支持移除的论据——而是先解决移除的理由先建规则 1–3 再砍掉整个功能等于全部白做。收入高度集中截至 2026-09-03 的 90 天度量238 位创作者收到捐赠共19.7M Buzz。占全部捐赠收入比例前 10 名78.0%前 50 名95.0%长尾中位数创作者每季度5,015 Buzz75 分位16,693 Buzz低于 10k Buzz238 人中的 147 人低于 1k Buzz53 人高于 100k Buzz21 人(刻意省略单创作者数据——本仓库是公开的且人群足够小个人收入可被反推。)所以大规模投票会误导。它抽样到的绝大多数是每季度只有几千 Buzz 利益的创作者而承载 78% 收入的约 10 人只是频道里的十个声音。结果会是真诚的、无代表性的并且会被读作授权。收入对话应该与大约 20 个人直接进行——直接对话而不是投票。但旁边有一个真实的社区问题捐赠者面很广即使收入方不广。仅过去 30 天就有2,201 位不同捐赠者在门控目标上捐款。所以人们喜欢捐赠目标吗和移除它会在物质上伤害任何人吗有不同的答案一次线程会把两者模糊化。去问捐赠者他们会用什么替代去问头部创作者目标为他们赚到了什么别的东西赚不到的。并注意框架陷阱我们应该保留捐赠目标吗会诱发对现状的辩护。14.5% 的完成率暗示诚实的替代品可能是一个打赏罐tip jar而不是解锁机制。四条规则恰好落在同一小群体上前 10 名中有 6 位、前 50 名中有 40 位捐赠收入者使用带目标的限时门控143/238 总体。所以这不是一项广泛的政策变更——它改变的是约十来个头部创作者的操作方式而达成目标要付出 30 天销售额的代价恰好砸在钱最集中的地方。这是另一个应该去和他们谈而不是宣布的理由。开放问题D1 —— 折扣阶梯末端的免费是什么意思paid-access-decay.md 建立在PaidAccessGuarantee之上一个不可撤销的、永久的免费日期——freeAt只能提前、永不清除、是所有读取的上限。30 天是唯一保证的免费的决定与之直接矛盾。要么那个保证也变成 30 天窗口要么产品对免费一词有两种不同含义——阶梯的含义与目标的含义。在从任何一份文档开始构建之前这一点必须解决。D2 —— 周期可以重复吗门控 → 目标 → 免费月 → 重新门控 → 新目标。读起来没问题可能还不错——一个循环的社区解锁——但它应该被决定而不是被偶然发现。D3 —— 14 个活跃的仅生成目标。规则 1 会让它们失效。建议让它们在旧条款下运行到完成并阻止新的。追溯性地使目标失效改变了已经向其捐赠的人的约定而这正是本设计要阻止的行为。D4 —— 提前达成目标会让捐赠者损失免费时间吗免费月从目标达成算起所以一个 15 天窗口第 3 天达成的目标其免费期比第 15 天达成的更早结束。这是作为决定的一个属性被记录的而不是重新讨论快速资助的捐赠者得到的是更早的月份而不是更长的月份。度量数据2026-09-03 度量指标数值门控版本上的捐赠目标1,997—— 门控包含下载1,98199.2%—— 仅生成规则 1 将禁止16其中 14 个活跃 · 53,260 Buzz—— 限时门控上、已获资助764 · 4.5M Buzz使用中的早期访问窗口3–15 天提供了 30 天未被资助目标使用过去 30 天在限时门控上有捐赠的创作者119 · 2,514,562 Buzz · 2,201 位捐赠者捐赠目标历史累计22,841 ·86.9% 已获资助·14.5% 达成规则 1 编码了创作者已经在做的事99.2% 的目标挂在授予下载权限的门控上。86.9%/14.5% 的拆分是未达成目标什么都不做成为主流情况而非边缘情况的原因——大约16,500 个目标收了钱却从未解锁任何东西。这就是现状上述决定保持了它。考虑过并放弃的方案保留仅为避免从头重推推理。托管Escrow—— 把捐赠持有在系统账户中像赏金那样承诺被撤回时退款。2026-09-03 搁置而非仅仅被比下去除了 30 天窗口外没有承诺任何东西就没有什么可退的而且它会把每位诚实创作者的提现延迟约一周。完整的探索——赏金先例、约 1 周的持有、五步构建和实测的浮存——在donation-goal-escrow.md中本文档取代了它。如果未来重提托管从 git 历史中找回它不要重新推导。永久保证—— 达标目标或窗口结束让模型永久免费。被30 天是唯一保证的免费的决定放弃。转换矩阵—— 按配置允许或禁止每次门控转换目标收了钱的地方就退款。因组合爆炸而放弃规则 1–4 无需网格就覆盖了同样的情况。它唯一持久的思想——授权集与价格分开保护——以规则 1 的形式存活下来。实现侧补充与现行代码的对应关系对打算基于本文档实现的人来说以下几点对应关系值得留意均已在上面源码中引证捐赠入口与校验donationGoalRouter.donatedonation-goal.router.tsdonateToGoalInputdonation-goal.schema.ts。捐赠到账与目标关闭donateToGoal/checkDonationGoalCompletedonation-goal.service.ts其中目标是否达成由SUM(amount)聚合决定未达标不关闭目标、不触碰门控有对应单测。门控写入与结束writePaidAccessForModelVersion/endPaidAccessNowpaid-access.service.ts永久门控写为endsAt NULL, timeframeDays NULL这正是文档63 条残留证据的比对基准。退款边界仅付费购买者的 unpublish 退款model-early-access-refund.service.ts与捐赠者无退款的现状一致。目标显示过滤getDonationGoals仅展示存在活跃限时窗口且创作者未隐藏的目标donation-goal.service.ts——规则 1 若实现还需在此类读路径上同步增加目标只能挂在含下载门控上的约束。四条规则方案的价值在于用目标的前提条件替代对每种降级路径逐一枚举用30 天窗口替代永久承诺 托管 退款把一个组合爆炸的转换问题压缩成一次区间判断、一次购买拦截、一次前提校验和几句诚实的文案。在动手之前唯一真正需要回答的是捐赠目标这个功能本身是否还要存在。【免费下载链接】civitaiA repository of models, textual inversions, and more项目地址: https://gitcode.com/GitHub_Trending/ci/civitai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考