✨ feat(larkmsg): 为手工管理卡添加统一操作记录折叠块

- 新增 CardActionHistoryOptions 和 CardActionHistoryRecord 结构体
- 实现 CardActionHistoryPanel 函数用于生成操作记录面板
- 在 StandardCardFooterOptions 中添加 ActionHistory 字段
- 新增 CollapsiblePanel 组件用于展示可折叠内容
- 实现操作记录加载、合并和渲染逻辑

♻️ refactor(config): 在配置卡片中集成操作记录

- 在 ConfigCardViewOptions 和 FeatureCardViewOptions 中添加 MessageID 和 PendingHistory 字段
- 修改 BuildConfigCardWithOptions 和 BuildFeatureCardWithOptions 以支持操作记录
- 添加测试验证操作记录面板是否正确显示

♻️ refactor(permission): 在权限卡片中集成操作记录

- 在 PermissionCardViewOptions 中添加 MessageID 和 PendingHistory 字段
- 修改 BuildPermissionCardJSONWithOptions 以支持操作记录
- 重构权限列表查询逻辑为可替换的变量
- 更新权限卡片测试用例

♻️ refactor(schedule): 在计划卡片中集成操作记录

- 在 TaskCardViewState 中添加 MessageID 和 PendingHistory 字段
- 修改 BuildTaskListCard 以支持操作记录
- 更新计划卡片测试用例

♻️ refactor(ratelimit): 在频控卡片中集成操作记录

- 新增 StatsCardOptions 结构体包含 MessageID 和 PendingHistory
- 添加 BuildStatsCardJSONWithOptions 方法
- 修改 buildStatsRawCard 以支持操作记录
- 更新频控卡片测试用例

♻️ refactor(cardaction): 在卡片回调中透传操作记录

- 在各类卡片回调处理中统一添加 MessageID 和 PendingHistory
- 修改 handleConfigView、handleFeatureView 等函数
- 确保操作记录在卡片重建时能够正确传递

📝 docs(architecture): 更新运行时重构进度文档

- 添加 2026-03-11 里程碑 Q 的详细方案说明
- 记录所有相关代码修改点
- 说明设计决策和验证方法

Author: kevinmatthe

docs/architecture/runtime-refactor-progress.md

@@ -634,3 +634,48 @@
 ### 验证
 
 - `GOCACHE=/tmp/gocache go test ./internal/infrastructure/lark_dal/larkmsg ./internal/application/permission ./internal/application/lark/schedule ./internal/application/lark/cardaction ./internal/application/config`
+
+## 2026-03-11 · Milestone Q · 手工管理卡统一补操作记录折叠块
+
+### 方案
+
+- 给手工 schema v2 管理卡统一增加一个通用 `collapsible_panel`，用于展示当前卡片消息维度下的操作历史。
+- 历史数据继续复用已有的 OpenSearch 卡片操作审计索引，不再引入新的 DB 表或第二套审计链路。
+- 卡片回调重建时显式透传当前 `open_message_id`，并把“本次正在处理的回调动作”先以内存记录合并进面板，避免 OpenSearch 异步写入尚未完成时用户看不到刚点下去的那次操作。
+
+### 修改
+
+- `internal/infrastructure/lark_dal/larkmsg/*`
+  - 新增 / 补全 `CardActionHistoryOptions`、`CardActionHistoryRecord`、`CardActionHistoryPanel(...)`
+  - `StandardCardFooterOptions` 增加 `ActionHistory`
+  - footer 在按钮区上方统一插入操作记录折叠块
+  - `collapsible_panel` helper 修正为符合 Feishu Card JSON 2.0 的合法结构
+  - 历史项渲染统一为：动作 + 参与人 + 时间
+- `internal/infrastructure/lark_dal/larkmsg/record.go`
+  - 卡片操作审计补齐 `open_message_id`、`open_chat_id`、`action_name`
+- `internal/application/config/*`
+  - `config / feature` 卡片 footer 接入统一操作记录
+  - view options 增加 `MessageID / PendingHistory`
+- `internal/application/permission/*`
+  - 权限卡 footer 接入统一操作记录
+  - 权限卡内部读取 bot identity / subject list 增加测试可替换 hook
+- `internal/application/lark/schedule/*`
+  - schedule 管理卡 footer 接入统一操作记录
+  - view state 增加 `MessageID / PendingHistory`
+- `internal/application/lark/ratelimit/*`
+  - ratelimit 手工卡接入统一操作记录
+- `internal/application/lark/cardaction/builtin.go`
+  - config / feature / permission / schedule / ratelimit 回调重建时统一透传：
+    - `MessageID`
+    - `PendingHistory: []CardActionHistoryRecord{NewCardActionHistoryRecord(actionCtx.Event)}`
+
+### 决策
+
+- 操作记录按“当前卡片消息”聚合，而不是按 chat / user / resource 聚合；这样语义最直观，也不会把不同卡片实例的操作串在一起。
+- 不等待 OpenSearch 写入完成再回包，而是把当前回调动作先以内存 `PendingHistory` 合并显示；用户看到的是即时结果，后续持久化仍走原异步审计路径。
+- 折叠块默认收起，避免压缩正文可视区域；无消息 ID 时显示占位提示，而不是静默隐藏。
+- `collapsible_panel` 结构按 Feishu 官方 JSON 2.0 文档修正，避免继续发送旧式非法 `header / border` 结构。
+
+### 验证
+
+- `GOCACHE=/tmp/gocache go test ./internal/infrastructure/lark_dal/larkmsg ./internal/application/config ./internal/application/permission ./internal/application/lark/schedule ./internal/application/lark/ratelimit ./internal/application/lark/cardaction`

internal/application/config/card.go

@@ -3,6 +3,8 @@ package config
 import (
 	"context"
 	"strconv"
+
+	"github.com/BetaGoRobot/BetaGo-Redefine/internal/infrastructure/lark_dal/larkmsg"
 )
 
 type configLookupCandidate struct {
@@ -15,10 +17,14 @@ type configLookupCandidate struct {
 type ConfigCardViewOptions struct {
 	BypassCache        bool
 	LastModifierOpenID string
+	MessageID          string
+	PendingHistory     []larkmsg.CardActionHistoryRecord
 }
 
 type FeatureCardViewOptions struct {
 	LastModifierOpenID string
+	MessageID          string
+	PendingHistory     []larkmsg.CardActionHistoryRecord
 }
 
 // ==========================================

internal/application/config/card_view.go

@@ -38,6 +38,11 @@ func BuildConfigCardWithOptions(ctx context.Context, scope, chatID, openID strin
 	return newRawCard(ctx, "配置面板", elements, larkmsg.StandardCardFooterOptions{
 		RefreshPayload:     larkmsg.StringMapToAnyMap(BuildConfigViewValueWithState(view)),
 		LastModifierOpenID: options.LastModifierOpenID,
+		ActionHistory: larkmsg.CardActionHistoryOptions{
+			Enabled:        true,
+			OpenMessageID:  options.MessageID,
+			PendingRecords: options.PendingHistory,
+		},
 	}), nil
 }
 
@@ -71,6 +76,11 @@ func BuildFeatureCardWithOptions(ctx context.Context, chatID, openID string, opt
 	return newRawCard(ctx, "功能开关", elements, larkmsg.StandardCardFooterOptions{
 		RefreshPayload:     larkmsg.StringMapToAnyMap(BuildFeatureViewValueWithState(view)),
 		LastModifierOpenID: options.LastModifierOpenID,
+		ActionHistory: larkmsg.CardActionHistoryOptions{
+			Enabled:        true,
+			OpenMessageID:  options.MessageID,
+			PendingRecords: options.PendingHistory,
+		},
 	}), nil
 }
 

internal/application/config/card_view_test.go

@@ -169,6 +169,38 @@ func TestBuildConfigScopeRowContainsViewActionPayload(t *testing.T) {
 	}
 }
 
+func TestBuildConfigCardAddsOperationHistoryPanel(t *testing.T) {
+	useWorkspaceConfigPath(t)
+	card, err := BuildConfigCardWithOptions(context.Background(), "chat", "chat-1", "user-1", ConfigCardViewOptions{})
+	if err != nil {
+		t.Fatalf("BuildConfigCardWithOptions() error = %v", err)
+	}
+	raw, err := json.Marshal(card)
+	if err != nil {
+		t.Fatalf("Marshal() error = %v", err)
+	}
+	jsonStr := string(raw)
+	if !strings.Contains(jsonStr, `"tag":"collapsible_panel"`) || !strings.Contains(jsonStr, `操作记录`) {
+		t.Fatalf("expected operation history panel in config card: %s", jsonStr)
+	}
+}
+
+func TestBuildFeatureCardAddsOperationHistoryPanel(t *testing.T) {
+	useWorkspaceConfigPath(t)
+	card, err := BuildFeatureCardWithOptions(context.Background(), "chat-1", "user-1", FeatureCardViewOptions{})
+	if err != nil {
+		t.Fatalf("BuildFeatureCardWithOptions() error = %v", err)
+	}
+	raw, err := json.Marshal(card)
+	if err != nil {
+		t.Fatalf("Marshal() error = %v", err)
+	}
+	jsonStr := string(raw)
+	if !strings.Contains(jsonStr, `"tag":"collapsible_panel"`) || !strings.Contains(jsonStr, `操作记录`) {
+		t.Fatalf("expected operation history panel in feature card: %s", jsonStr)
+	}
+}
+
 func TestBuildConfigCustomValueFormContainsInputAndSubmit(t *testing.T) {
 	element := buildConfigCustomValueForm(ConfigItem{
 		Key:       string(KeyReactionDefaultRate),

internal/application/lark/cardaction/builtin.go

@@ -11,6 +11,7 @@ import (
 	appratelimit "github.com/BetaGoRobot/BetaGo-Redefine/internal/application/lark/ratelimit"
 	scheduleapp "github.com/BetaGoRobot/BetaGo-Redefine/internal/application/lark/schedule"
 	apppermission "github.com/BetaGoRobot/BetaGo-Redefine/internal/application/permission"
+	"github.com/BetaGoRobot/BetaGo-Redefine/internal/infrastructure/lark_dal/larkmsg"
 	cardactionproto "github.com/BetaGoRobot/BetaGo-Redefine/pkg/cardaction"
 	"github.com/larksuite/oapi-sdk-go/v3/event/dispatcher/callback"
 )
@@ -117,6 +118,8 @@ func handleFeatureAction(ctx context.Context, actionCtx *Context) (*callback.Car
 	}
 	card, cardErr := appconfig.BuildFeatureCardWithOptions(ctx, actionCtx.ChatID(), actionCtx.OpenID(), appconfig.FeatureCardViewOptions{
 		LastModifierOpenID: actionCtx.OpenID(),
+		MessageID:          actionCtx.MessageID(),
+		PendingHistory:     []larkmsg.CardActionHistoryRecord{larkmsg.NewCardActionHistoryRecord(actionCtx.Event)},
 	})
 	if cardErr != nil {
 		return InfoToast(resp.Message), nil
@@ -139,6 +142,8 @@ func handleFeatureView(ctx context.Context, actionCtx *Context) (*callback.CardA
 	}
 	card, err := appconfig.BuildFeatureCardWithOptions(ctx, chatID, openID, appconfig.FeatureCardViewOptions{
 		LastModifierOpenID: req.LastModifierOpenID,
+		MessageID:          actionCtx.MessageID(),
+		PendingHistory:     []larkmsg.CardActionHistoryRecord{larkmsg.NewCardActionHistoryRecord(actionCtx.Event)},
 	})
 	if err != nil {
 		return ErrorToast(err.Error()), nil
@@ -160,6 +165,8 @@ func handleConfigAction(ctx context.Context, actionCtx *Context) (*callback.Card
 	card, cardErr := appconfig.BuildConfigCardJSONWithOptions(ctx, req.Scope, req.ChatID, req.OpenID, appconfig.ConfigCardViewOptions{
 		BypassCache:        true,
 		LastModifierOpenID: actionCtx.OpenID(),
+		MessageID:          actionCtx.MessageID(),
+		PendingHistory:     []larkmsg.CardActionHistoryRecord{larkmsg.NewCardActionHistoryRecord(actionCtx.Event)},
 	})
 	if cardErr != nil {
 		return InfoToast(resp.Message), nil
@@ -175,6 +182,8 @@ func handleConfigView(ctx context.Context, actionCtx *Context) (*callback.CardAc
 	card, err := appconfig.BuildConfigCardJSONWithOptions(ctx, req.Scope, req.ChatID, req.OpenID, appconfig.ConfigCardViewOptions{
 		BypassCache:        true,
 		LastModifierOpenID: req.LastModifierOpenID,
+		MessageID:          actionCtx.MessageID(),
+		PendingHistory:     []larkmsg.CardActionHistoryRecord{larkmsg.NewCardActionHistoryRecord(actionCtx.Event)},
 	})
 	if err != nil {
 		return ErrorToast(err.Error()), nil
@@ -195,6 +204,8 @@ func handlePermissionAction(ctx context.Context, actionCtx *Context) (*callback.
 	}
 	card, cardErr := apppermission.BuildPermissionCardJSONWithOptions(ctx, actionCtx.ChatID(), actionCtx.OpenID(), req.TargetOpenID, apppermission.PermissionCardViewOptions{
 		LastModifierOpenID: actionCtx.OpenID(),
+		MessageID:          actionCtx.MessageID(),
+		PendingHistory:     []larkmsg.CardActionHistoryRecord{larkmsg.NewCardActionHistoryRecord(actionCtx.Event)},
 	})
 	if cardErr != nil {
 		return InfoToast(resp.Message), nil
@@ -209,6 +220,8 @@ func handlePermissionView(ctx context.Context, actionCtx *Context) (*callback.Ca
 	}
 	card, err := apppermission.BuildPermissionCardJSONWithOptions(ctx, actionCtx.ChatID(), actionCtx.OpenID(), req.TargetOpenID, apppermission.PermissionCardViewOptions{
 		LastModifierOpenID: req.LastModifierOpenID,
+		MessageID:          actionCtx.MessageID(),
+		PendingHistory:     []larkmsg.CardActionHistoryRecord{larkmsg.NewCardActionHistoryRecord(actionCtx.Event)},
 	})
 	if err != nil {
 		return ErrorToast(err.Error()), nil
@@ -228,7 +241,10 @@ func handleRateLimitView(ctx context.Context, actionCtx *Context) (*callback.Car
 	if chatID == "" && actionCtx.MetaData != nil {
 		chatID = strings.TrimSpace(actionCtx.MetaData.ChatID)
 	}
-	card, err := appratelimit.BuildStatsCardJSON(ctx, chatID)
+	card, err := appratelimit.BuildStatsCardJSONWithOptions(ctx, chatID, appratelimit.StatsCardOptions{
+		MessageID:      actionCtx.MessageID(),
+		PendingHistory: []larkmsg.CardActionHistoryRecord{larkmsg.NewCardActionHistoryRecord(actionCtx.Event)},
+	})
 	if err != nil {
 		return ErrorToast(err.Error()), nil
 	}
@@ -245,6 +261,8 @@ func handleScheduleView(ctx context.Context, actionCtx *Context) (*callback.Card
 	if chatID == "" && actionCtx.MetaData != nil {
 		chatID = strings.TrimSpace(actionCtx.MetaData.ChatID)
 	}
+	req.View.MessageID = actionCtx.MessageID()
+	req.View.PendingHistory = []larkmsg.CardActionHistoryRecord{larkmsg.NewCardActionHistoryRecord(actionCtx.Event)}
 	card, err := scheduleapp.BuildTaskCardPayloadForView(ctx, chatID, req.View, true)
 	if err != nil {
 		return ErrorToast(err.Error()), nil
@@ -289,6 +307,8 @@ func handleScheduleAction(ctx context.Context, actionCtx *Context) (*callback.Ca
 	}
 
 	req.View.LastModifierOpenID = actorOpenID
+	req.View.MessageID = actionCtx.MessageID()
+	req.View.PendingHistory = []larkmsg.CardActionHistoryRecord{larkmsg.NewCardActionHistoryRecord(actionCtx.Event)}
 	card, cardErr := scheduleapp.BuildTaskCardPayloadForView(ctx, chatID, req.View, req.Action == scheduleapp.TaskActionDelete)
 	if cardErr != nil {
 		return InfoToast(message), nil

internal/application/lark/ratelimit/stats_card.go

@@ -38,8 +38,17 @@ type StatsCardRecentSend struct {
 }
 
 func BuildStatsCardJSON(ctx context.Context, chatID string) (map[string]any, error) {
+	return BuildStatsCardJSONWithOptions(ctx, chatID, StatsCardOptions{})
+}
+
+type StatsCardOptions struct {
+	MessageID      string
+	PendingHistory []larkmsg.CardActionHistoryRecord
+}
+
+func BuildStatsCardJSONWithOptions(ctx context.Context, chatID string, opts StatsCardOptions) (map[string]any, error) {
 	data := BuildStatsCardData(ctx, chatID)
-	card := buildStatsRawCard(ctx, data)
+	card := buildStatsRawCardWithOptions(ctx, data, opts)
 	return map[string]any(card), nil
 }
 
@@ -165,6 +174,10 @@ func buildStatsCardData(snapshot *StatsSnapshot) *StatsCardData {
 }
 
 func buildStatsRawCard(ctx context.Context, data *StatsCardData) larkmsg.RawCard {
+	return buildStatsRawCardWithOptions(ctx, data, StatsCardOptions{})
+}
+
+func buildStatsRawCardWithOptions(ctx context.Context, data *StatsCardData, opts StatsCardOptions) larkmsg.RawCard {
 	elements := []any{
 		buildStatsOverviewBlock(data),
 	}
@@ -189,6 +202,11 @@ func buildStatsRawCard(ctx context.Context, data *StatsCardData) larkmsg.RawCard
 
 	return larkmsg.NewStandardPanelCard(ctx, "频控详情", elements, larkmsg.StandardCardFooterOptions{
 		RefreshPayload: larkmsg.StringMapToAnyMap(BuildStatsViewValue(data.ChatID)),
+		ActionHistory: larkmsg.CardActionHistoryOptions{
+			Enabled:        true,
+			OpenMessageID:  opts.MessageID,
+			PendingRecords: opts.PendingHistory,
+		},
 	})
 }
 

internal/application/lark/ratelimit/stats_card_test.go

@@ -155,6 +155,9 @@ func TestBuildStatsRawCardUsesSchemaV2Structure(t *testing.T) {
 	if !strings.Contains(jsonStr, `"content":"刷新"`) || !strings.Contains(jsonStr, `"action":"ratelimit.view"`) {
 		t.Fatalf("expected refresh footer action in json: %s", jsonStr)
 	}
+	if !strings.Contains(jsonStr, `"tag":"collapsible_panel"`) || !strings.Contains(jsonStr, `操作记录`) {
+		t.Fatalf("expected operation history panel in json: %s", jsonStr)
+	}
 	if !strings.Contains(jsonStr, `"text_size":"heading-1"`) {
 		t.Fatalf("expected emphasized overview text in json: %s", jsonStr)
 	}

internal/application/lark/schedule/card_action.go

@@ -7,6 +7,7 @@ import (
 	"strings"
 
 	"github.com/BetaGoRobot/BetaGo-Redefine/internal/infrastructure/db/model"
+	"github.com/BetaGoRobot/BetaGo-Redefine/internal/infrastructure/lark_dal/larkmsg"
 	cardactionproto "github.com/BetaGoRobot/BetaGo-Redefine/pkg/cardaction"
 )
 
@@ -49,6 +50,8 @@ type TaskCardViewState struct {
 	ToolName           string
 	CreatorOpenID      string
 	LastModifierOpenID string
+	MessageID          string
+	PendingHistory     []larkmsg.CardActionHistoryRecord
 	Limit              int
 }
 
@@ -198,6 +201,7 @@ func normalizeTaskCardView(view TaskCardViewState) TaskCardViewState {
 	view.ToolName = strings.TrimSpace(view.ToolName)
 	view.CreatorOpenID = strings.TrimSpace(view.CreatorOpenID)
 	view.LastModifierOpenID = strings.TrimSpace(view.LastModifierOpenID)
+	view.MessageID = strings.TrimSpace(view.MessageID)
 
 	if view.Limit <= 0 {
 		if view.Mode == TaskCardViewModeList {

internal/application/lark/schedule/card_view.go

@@ -31,10 +31,14 @@ func BuildTaskListCard(ctx context.Context, title string, tasks []*model.Schedul
 		}
 		elements = larkmsg.AppendSectionsWithDividers(elements, taskSections...)
 	}
-
 	return larkmsg.NewStandardPanelCard(ctx, title, elements, larkmsg.StandardCardFooterOptions{
 		RefreshPayload:     larkmsg.StringMapToAnyMap(BuildTaskViewValue(view)),
 		LastModifierOpenID: view.LastModifierOpenID,
+		ActionHistory: larkmsg.CardActionHistoryOptions{
+			Enabled:        true,
+			OpenMessageID:  view.MessageID,
+			PendingRecords: view.PendingHistory,
+		},
 	})
 }
 
@@ -256,7 +260,7 @@ func buildTaskCreatorPicker(view TaskCardViewState) map[string]any {
 		Width:       "default",
 		Type:        "default",
 		Payload:     larkmsg.StringMapToAnyMap(BuildTaskCreatorPickerValue(view)),
-		ElementID:   "schedule_creator_filter",
+		ElementID:   "sched_creator_pick",
 	})
 }
 

internal/application/lark/schedule/card_view_test.go

@@ -74,6 +74,9 @@ func TestBuildTaskListCardUsesSchemaV2AndFooter(t *testing.T) {
 	if !strings.Contains(jsonStr, `"content":"刷新"`) || !strings.Contains(jsonStr, cardactionproto.ActionScheduleView) {
 		t.Fatalf("expected schedule refresh action in card json: %s", jsonStr)
 	}
+	if !strings.Contains(jsonStr, `"tag":"collapsible_panel"`) || !strings.Contains(jsonStr, `首次发送后可在此查看操作记录`) {
+		t.Fatalf("expected shared action history panel in card json: %s", jsonStr)
+	}
 	if !strings.Contains(jsonStr, cardactionproto.ActionSchedulePause) ||
 		!strings.Contains(jsonStr, cardactionproto.ActionScheduleResume) ||
 		!strings.Contains(jsonStr, cardactionproto.ActionScheduleDelete) {
@@ -85,10 +88,13 @@ func TestBuildTaskListCardUsesSchemaV2AndFooter(t *testing.T) {
 	if !strings.Contains(jsonStr, "创建者") || !strings.Contains(jsonStr, "ou_creator") {
 		t.Fatalf("expected creator info and filter row in card json: %s", jsonStr)
 	}
-	if !strings.Contains(jsonStr, `"tag":"select_person"`) || !strings.Contains(jsonStr, `"element_id":"schedule_creator_filter"`) {
+	if !strings.Contains(jsonStr, `"tag":"select_person"`) || !strings.Contains(jsonStr, `"element_id":"sched_creator_pick"`) {
 		t.Fatalf("expected select_person creator picker in card json: %s", jsonStr)
 	}
 	if strings.Contains(jsonStr, `"options":[`) {
 		t.Fatalf("expected creator picker to default to current chat members, not static options: %s", jsonStr)
 	}
+	if !strings.Contains(jsonStr, `"tag":"collapsible_panel"`) || !strings.Contains(jsonStr, `操作记录`) {
+		t.Fatalf("expected operation history panel in schedule card: %s", jsonStr)
+	}
 }