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。

backend/services/runtime/eventsvc/chat_history_persist.go

@@ -9,10 +9,8 @@ import (
 
 	"github.com/LoveLosita/smartflow/backend/services/runtime/dao"
 	"github.com/LoveLosita/smartflow/backend/services/runtime/model"
-	contracts "github.com/LoveLosita/smartflow/backend/shared/contracts/userauth"
 	kafkabus "github.com/LoveLosita/smartflow/backend/shared/infra/kafka"
 	outboxinfra "github.com/LoveLosita/smartflow/backend/shared/infra/outbox"
-	"github.com/LoveLosita/smartflow/backend/shared/ports"
 	"gorm.io/gorm"
 )
 
@@ -25,13 +23,12 @@ const (
 // 职责边界：
 // 1. 只处理聊天历史事件，不处理其它业务事件；
 // 2. 只负责注册，不负责总线启动；
-// 3. 先写本地 chat 相关表，再调用 userauth 调整 token 额度；
+// 3. 先写本地 chat 相关表，不再把聊天 token 消耗同步到旧 userauth 额度账本；
 // 4. 当前版本仅注册新路由键，不再注册旧兼容键。
 func RegisterChatHistoryPersistHandler(
 	bus OutboxBus,
 	outboxRepo *outboxinfra.Repository,
 	repoManager *dao.RepoManager,
-	adjuster ports.TokenUsageAdjuster,
 ) error {
 	if bus == nil {
 		return errors.New("event bus is nil")
@@ -77,19 +74,6 @@ func RegisterChatHistoryPersistHandler(
 			return err
 		}
 
-		if payload.TokensConsumed > 0 {
-			if adjuster == nil {
-				return errors.New("userauth token adjuster is nil")
-			}
-			if _, err := adjuster.AdjustTokenUsage(ctx, contracts.AdjustTokenUsageRequest{
-				EventID:    eventID,
-				UserID:     payload.UserID,
-				TokenDelta: payload.TokensConsumed,
-			}); err != nil {
-				return err
-			}
-		}
-
 		return eventOutboxRepo.MarkConsumed(ctx, envelope.OutboxID)
 	}
 

backend/services/runtime/eventsvc/chat_token_usage_adjust.go

@@ -1,126 +0,0 @@
-package eventsvc
-
-import (
-	"context"
-	"encoding/json"
-	"errors"
-	"strconv"
-	"strings"
-	"time"
-
-	"github.com/LoveLosita/smartflow/backend/services/runtime/dao"
-	"github.com/LoveLosita/smartflow/backend/services/runtime/model"
-	contracts "github.com/LoveLosita/smartflow/backend/shared/contracts/userauth"
-	kafkabus "github.com/LoveLosita/smartflow/backend/shared/infra/kafka"
-	outboxinfra "github.com/LoveLosita/smartflow/backend/shared/infra/outbox"
-	"github.com/LoveLosita/smartflow/backend/shared/ports"
-	"gorm.io/gorm"
-)
-
-const (
-	// EventTypeChatTokenUsageAdjustRequested 是“会话 token 额度调整”事件类型。
-	// 命名约束：
-	// 1. 只表达业务语义，不泄露 outbox/kafka 实现细节；
-	// 2. 作为稳定路由键长期保留，后续演进优先通过 event_version。
-	EventTypeChatTokenUsageAdjustRequested = "chat.token.usage.adjust.requested"
-)
-
-// RegisterChatTokenUsageAdjustHandler 注册“会话 token 额度调整”消费者。
-// 职责边界：
-// 1. 只处理 token 调整事件，不处理聊天正文落库；
-// 2. 先写本地账本，再调用 userauth 侧做额度同步；
-// 3. 非法载荷直接标记 dead，避免无意义重试。
-func RegisterChatTokenUsageAdjustHandler(
-	bus OutboxBus,
-	outboxRepo *outboxinfra.Repository,
-	repoManager *dao.RepoManager,
-	adjuster ports.TokenUsageAdjuster,
-) error {
-	if bus == nil {
-		return errors.New("event bus is nil")
-	}
-	if outboxRepo == nil {
-		return errors.New("outbox repository is nil")
-	}
-	if repoManager == nil {
-		return errors.New("repo manager is nil")
-	}
-
-	eventOutboxRepo, err := scopedOutboxRepoForEvent(outboxRepo, EventTypeChatTokenUsageAdjustRequested)
-	if err != nil {
-		return err
-	}
-
-	handler := func(ctx context.Context, envelope kafkabus.Envelope) error {
-		var payload model.ChatTokenUsageAdjustPayload
-		if unmarshalErr := json.Unmarshal(envelope.Payload, &payload); unmarshalErr != nil {
-			_ = eventOutboxRepo.MarkDead(ctx, envelope.OutboxID, "解析会话 token 调整载荷失败: "+unmarshalErr.Error())
-			return nil
-		}
-
-		if payload.UserID <= 0 || payload.TokensDelta <= 0 || payload.ConversationID == "" {
-			_ = eventOutboxRepo.MarkDead(ctx, envelope.OutboxID, "会话 token 调整载荷无效: user_id/conversation_id/tokens_delta 非法")
-			return nil
-		}
-
-		eventID := strings.TrimSpace(envelope.EventID)
-		if eventID == "" {
-			eventID = strconv.FormatInt(envelope.OutboxID, 10)
-		}
-
-		if err := eventOutboxRepo.ConsumeInTx(ctx, envelope.OutboxID, func(tx *gorm.DB) error {
-			txM := repoManager.WithTx(tx)
-			return txM.Agent.AdjustTokenUsageInTx(ctx, payload.UserID, payload.ConversationID, payload.TokensDelta, eventID)
-		}); err != nil {
-			return err
-		}
-
-		if adjuster == nil {
-			return errors.New("userauth token adjuster is nil")
-		}
-		if _, err := adjuster.AdjustTokenUsage(ctx, contracts.AdjustTokenUsageRequest{
-			EventID:    eventID,
-			UserID:     payload.UserID,
-			TokenDelta: payload.TokensDelta,
-		}); err != nil {
-			return err
-		}
-
-		return eventOutboxRepo.MarkConsumed(ctx, envelope.OutboxID)
-	}
-
-	return bus.RegisterEventHandler(EventTypeChatTokenUsageAdjustRequested, handler)
-}
-
-// PublishChatTokenUsageAdjustRequested 发布“会话 token 额度调整”事件。
-// 1. 这里只保证 outbox 写入成功，不等待消费结果；
-// 2. 业务层只关心 DTO，不关心 outbox/Kafka 细节。
-func PublishChatTokenUsageAdjustRequested(
-	ctx context.Context,
-	publisher outboxinfra.EventPublisher,
-	payload model.ChatTokenUsageAdjustPayload,
-) error {
-	if publisher == nil {
-		return errors.New("event publisher is nil")
-	}
-	if payload.UserID <= 0 {
-		return errors.New("invalid user_id")
-	}
-	if payload.TokensDelta <= 0 {
-		return errors.New("invalid tokens_delta")
-	}
-	if payload.ConversationID == "" {
-		return errors.New("invalid conversation_id")
-	}
-	if payload.TriggeredAt.IsZero() {
-		payload.TriggeredAt = time.Now()
-	}
-
-	return publisher.Publish(ctx, outboxinfra.PublishRequest{
-		EventType:    EventTypeChatTokenUsageAdjustRequested,
-		EventVersion: outboxinfra.DefaultEventVersion,
-		MessageKey:   payload.ConversationID,
-		AggregateID:  strconv.Itoa(payload.UserID) + ":" + payload.ConversationID,
-		Payload:      payload,
-	})
-}

backend/services/runtime/eventsvc/core_outbox_handlers.go

@@ -7,7 +7,6 @@ import (
 	"github.com/LoveLosita/smartflow/backend/services/runtime/dao"
 	sharedevents "github.com/LoveLosita/smartflow/backend/shared/events"
 	outboxinfra "github.com/LoveLosita/smartflow/backend/shared/infra/outbox"
-	"github.com/LoveLosita/smartflow/backend/shared/ports"
 )
 
 // RegisterCoreOutboxHandlers 注册单体残留内仍由 agent 边界消费的 outbox handler。
@@ -24,7 +23,6 @@ func RegisterCoreOutboxHandlers(
 	agentRepo *dao.AgentDAO,
 	cacheRepo *dao.CacheDAO,
 	memoryModule *memory.Module,
-	adjuster ports.TokenUsageAdjuster,
 ) error {
 	if err := validateCoreOutboxHandlerDeps(eventBus, outboxRepo, repoManager, agentRepo, cacheRepo); err != nil {
 		return err
@@ -33,7 +31,7 @@ func RegisterCoreOutboxHandlers(
 		return err
 	}
 
-	return registerOutboxHandlerRoutes(coreOutboxHandlerRoutes(eventBus, outboxRepo, repoManager, agentRepo, cacheRepo, memoryModule, adjuster))
+	return registerOutboxHandlerRoutes(coreOutboxHandlerRoutes(eventBus, outboxRepo, repoManager, agentRepo, cacheRepo, memoryModule))
 }
 
 // RegisterAllOutboxHandlers 注册当前阶段所有 outbox handler。
@@ -51,7 +49,6 @@ func RegisterAllOutboxHandlers(
 	cacheRepo *dao.CacheDAO,
 	memoryModule *memory.Module,
 	activeTriggerWorkflow ActiveScheduleTriggeredProcessor,
-	adjuster ports.TokenUsageAdjuster,
 ) error {
 	if err := validateAllOutboxHandlerDeps(eventBus, outboxRepo, repoManager, agentRepo, cacheRepo, memoryModule, activeTriggerWorkflow); err != nil {
 		return err
@@ -65,7 +62,6 @@ func RegisterAllOutboxHandlers(
 		cacheRepo,
 		memoryModule,
 		activeTriggerWorkflow,
-		adjuster,
 	))
 }
 
@@ -126,21 +122,13 @@ func coreOutboxHandlerRoutes(
 	agentRepo *dao.AgentDAO,
 	cacheRepo *dao.CacheDAO,
 	memoryModule *memory.Module,
-	adjuster ports.TokenUsageAdjuster,
 ) []outboxHandlerRoute {
 	return []outboxHandlerRoute{
 		{
 			EventType: EventTypeChatHistoryPersistRequested,
 			Service:   outboxHandlerServiceAgent,
 			Register: func() error {
-				return RegisterChatHistoryPersistHandler(eventBus, outboxRepo, repoManager, adjuster)
-			},
-		},
-		{
-			EventType: EventTypeChatTokenUsageAdjustRequested,
-			Service:   outboxHandlerServiceAgent,
-			Register: func() error {
-				return RegisterChatTokenUsageAdjustHandler(eventBus, outboxRepo, repoManager, adjuster)
+				return RegisterChatHistoryPersistHandler(eventBus, outboxRepo, repoManager)
 			},
 		},
 		{
@@ -169,9 +157,8 @@ func allOutboxHandlerRoutes(
 	cacheRepo *dao.CacheDAO,
 	memoryModule *memory.Module,
 	activeTriggerWorkflow ActiveScheduleTriggeredProcessor,
-	adjuster ports.TokenUsageAdjuster,
 ) []outboxHandlerRoute {
-	routes := coreOutboxHandlerRoutes(eventBus, outboxRepo, repoManager, agentRepo, cacheRepo, memoryModule, adjuster)
+	routes := coreOutboxHandlerRoutes(eventBus, outboxRepo, repoManager, agentRepo, cacheRepo, memoryModule)
 	routes = append(routes,
 		outboxHandlerRoute{
 			EventType: sharedevents.ActiveScheduleTriggeredEventType,

backend/services/runtime/model/course_parse.go

@@ -32,6 +32,7 @@ type CourseImageParseResponse struct {
 }
 
 type CourseImageParseRequest struct {
+	UserID     int
 	Filename   string
 	MIMEType   string
 	ImageBytes []byte