Version: 0.9.80.dev.260506

后端:
1. LLM 独立服务与统一计费出口落地:新增 `cmd/llm`、`client/llm` 与 `services/llm/rpc`,补齐 BillingContext、CreditBalanceGuard、价格规则解析、stream usage 归集与 `credit.charge.requested` outbox 发布,active-scheduler / agent / course / memory / gateway fallback 全部改走 llm zrpc,不再各自本地初始化模型。
2. TokenStore 收口为 Credit 权威账本:新增 credit account / ledger / product / order / price-rule / reward-rule 能力与 Redis 快照缓存,扩展 tokenstore rpc/client 支撑余额快照、消耗看板、商品、订单、流水、价格规则和奖励规则,并接入 LLM charge 事件消费完成 Credit 扣费落账。
3. 计费旧链路下线与网关切口切换:`/token-store` 语义整体切到 `/credit-store`,agent chat 移除旧 TokenQuotaGuard,userauth 的 CheckTokenQuota / AdjustTokenUsage 改为废弃,聊天历史落库不再同步旧 token 额度账本,course 图片解析请求补 user_id 进入新计费口径。

前端:
4. 计划广场从 mock 数据切到真实接口:新增 forum api/types,首页支持真实列表、标签、搜索、防抖、点赞、导入和发布计划,详情页补齐帖子详情、评论树、回复和删除评论链路,同时补上“至少一个标签”的前后端约束与默认标签兜底。
5. 商店页切到 Credit 体系并重做展示:顶部改为余额 + Credit/Token 消耗看板,支持 24h/7d/30d/all 周期切换;套餐区展示原价与当前价;历史区改为当前用户 Credit 流水并支持查看更多,整体视觉和交互同步收口。

仓库:
6. 配置与本地启动体系补齐 llm / outbox 编排:`config.example.yaml` 增加 llm rpc 和统一 outbox service 配置,`dev-common.ps1` 把 llm 纳入多服务依赖并自动建 Kafka topic,`docker-compose.yml` 同步初始化 agent/task/memory/active-scheduler/notification/taskclass-forum/llm/token-store 全量 outbox topic。
This commit is contained in:
Losita
2026-05-06 20:16:53 +08:00
parent 7d324b77aa
commit 61db646805
104 changed files with 9527 additions and 3925 deletions

View File

@@ -0,0 +1,91 @@
package events
import (
"errors"
"fmt"
"strings"
"time"
)
const (
// CreditChargeRequestedEventType 表示 LLM 服务已经拿到最终 usage等待 TokenStore 异步结算。
CreditChargeRequestedEventType = "credit.charge.requested"
// CreditChargeEventVersion 是当前 Credit 扣费事件版本。
CreditChargeEventVersion = "v1"
)
// CreditChargeRequestedPayload 是 LLM -> TokenStore 的统一扣费事件。
//
// 职责边界:
// 1. 只表达“一次已经完成的模型调用需要如何结算”,不承载准入决策;
// 2. event_id 是最终幂等键LLM outbox 重试和 TokenStore 记账都依赖它去重;
// 3. credit_cost / rmb_cost_micros 在 LLM 侧就要算好TokenStore 只负责权威落账。
type CreditChargeRequestedPayload struct {
EventID string `json:"event_id"`
UserID uint64 `json:"user_id"`
Scene string `json:"scene"`
RequestID string `json:"request_id"`
ConversationID string `json:"conversation_id"`
ModelAlias string `json:"model_alias"`
ProviderName string `json:"provider_name"`
ModelName string `json:"model_name"`
InputTokens int64 `json:"input_tokens"`
OutputTokens int64 `json:"output_tokens"`
CachedTokens int64 `json:"cached_tokens"`
ReasoningTokens int64 `json:"reasoning_tokens"`
TotalTokens int64 `json:"total_tokens"`
RMBCostMicros int64 `json:"rmb_cost_micros"`
CreditCost int64 `json:"credit_cost"`
TriggeredAt time.Time `json:"triggered_at"`
SkipCharge bool `json:"skip_charge,omitempty"`
}
// EventType 返回当前 payload 对应的标准事件类型。
func (p CreditChargeRequestedPayload) EventType() string {
return CreditChargeRequestedEventType
}
// MessageKey 返回 Kafka / outbox 统一消息键。
func (p CreditChargeRequestedPayload) MessageKey() string {
return strings.TrimSpace(p.EventID)
}
// AggregateID 返回扣费事件聚合键。
func (p CreditChargeRequestedPayload) AggregateID() string {
if p.UserID <= 0 {
return ""
}
return fmt.Sprintf("user:%d", p.UserID)
}
// Validate 校验扣费事件最小字段集。
func (p CreditChargeRequestedPayload) Validate() error {
if strings.TrimSpace(p.EventID) == "" {
return errors.New("credit charge event_id 不能为空")
}
if p.UserID == 0 {
return errors.New("credit charge user_id 不能为空")
}
if strings.TrimSpace(p.Scene) == "" {
return errors.New("credit charge scene 不能为空")
}
if strings.TrimSpace(p.ProviderName) == "" {
return errors.New("credit charge provider_name 不能为空")
}
if strings.TrimSpace(p.ModelName) == "" {
return errors.New("credit charge model_name 不能为空")
}
if p.TriggeredAt.IsZero() {
return errors.New("credit charge triggered_at 不能为空")
}
if p.SkipCharge {
return nil
}
if p.CreditCost < 0 {
return errors.New("credit charge credit_cost 不能为负数")
}
if p.RMBCostMicros < 0 {
return errors.New("credit charge rmb_cost_micros 不能为负数")
}
return nil
}