GenarrativeAI/Genarrative
11
0
Fork 0
Code Issues 14 Pull Requests 3 Actions Packages Projects 3 Releases Wiki Activity

优化泥点流水的素材消耗原因展示 #302

Merged
kdletters merged 3 commits from fix/wallet-ledger-reason into master 2026-09-08 14:56:16 +08:00
Conversation 0 Commits 3 Files Changed 8
+173 -17
suzmii commented 2026-09-07 17:21:03 +08:00
Member
Copy Link
Copy Source

Close #296

问题

钱包流水目前只把素材类扣费暴露为 asset_operation_consume，共享账单组件统一显示“资产操作消耗”，无法说明本次泥点实际用于哪类素材生成。

落地方案

  • 在既有钱包流水 metadata 中记录服务端确定的 assetKind，不修改 SpacetimeDB schema。
  • api-server 只将内部素材类型白名单映射为用户可见 reason，不暴露原始 metadata、资源 ID 或任务 ID。
  • 共享钱包流水契约与组件优先展示具体原因；历史、未知或空 metadata 继续回退为“资产操作消耗”。
  • 主站、图片画布与 AGC 继续复用同一共享账单组件。

当前进度

  • 补充权威后端数据契约
  • 写入素材操作类型 metadata
  • 扩展钱包流水公开 DTO 与安全映射
  • 更新共享账单展示与回归测试
  • 完成定向验证与边界检查

用户可见映射

  • 图片、图标图集、美术规范、UI 设计、发布素材：生成美术素材
  • 图片修改：编辑美术素材
  • UI 素材提取：提取美术素材
  • 角色动画：生成角色动画
  • 视频：生成视频素材
  • 音效：生成音效素材
  • 背景音乐：生成背景音乐
  • 历史、未知、空 metadata：资产操作消耗

验证

  • cargo fmt --all -- --check
  • cargo test -p api-server profile_wallet_ledger_reason_only_exposes_known_asset_operations
  • cargo test -p api-server worker_billing_context_freezes_charge_and_preserves_job_metadata
  • cargo test -p shared-contracts profile_wallet_ledger_response_uses_camel_case_fields
  • npx vitest run packages/shared/src/components/PlatformProfileWalletLedgerModal/index.test.tsx
  • npm run typecheck
  • npx eslint packages/shared/src/components/PlatformProfileWalletLedgerModal/model.ts packages/shared/src/components/PlatformProfileWalletLedgerModal/index.test.tsx packages/shared/src/contracts/runtime.ts
  • npm run check:encoding
  • npm run check:spacetime-schema
  • git diff --check

以上均通过；Rust 仅输出仓库已有 dead-code warnings。

未验证边界

  • 未执行真实登录、生成并读取新钱包流水的端到端联调。本机 8082/3101 已由另一套本地栈占用，为避免当前分支挂接同一数据库并带起 worker 处理现有队列，本轮未启动 npm run dev:api-server。
  • 四项远端 CI 已全部通过，PR 已转为 Ready for review。

不变项

  • 不修改历史流水数据。
  • 不调整泥点价格、扣费顺序、幂等 ledger、失败退款或余额结算。
  • 不修改 SpacetimeDB schema。
Close #296 ## 问题 钱包流水目前只把素材类扣费暴露为 `asset_operation_consume`，共享账单组件统一显示“资产操作消耗”，无法说明本次泥点实际用于哪类素材生成。 ## 落地方案 - 在既有钱包流水 metadata 中记录服务端确定的 `assetKind`，不修改 SpacetimeDB schema。 - `api-server` 只将内部素材类型白名单映射为用户可见 `reason`，不暴露原始 metadata、资源 ID 或任务 ID。 - 共享钱包流水契约与组件优先展示具体原因；历史、未知或空 metadata 继续回退为“资产操作消耗”。 - 主站、图片画布与 AGC 继续复用同一共享账单组件。 ## 当前进度 - [x] 补充权威后端数据契约 - [x] 写入素材操作类型 metadata - [x] 扩展钱包流水公开 DTO 与安全映射 - [x] 更新共享账单展示与回归测试 - [x] 完成定向验证与边界检查 ## 用户可见映射 - 图片、图标图集、美术规范、UI 设计、发布素材：生成美术素材 - 图片修改：编辑美术素材 - UI 素材提取：提取美术素材 - 角色动画：生成角色动画 - 视频：生成视频素材 - 音效：生成音效素材 - 背景音乐：生成背景音乐 - 历史、未知、空 metadata：资产操作消耗 ## 验证 - `cargo fmt --all -- --check` - `cargo test -p api-server profile_wallet_ledger_reason_only_exposes_known_asset_operations` - `cargo test -p api-server worker_billing_context_freezes_charge_and_preserves_job_metadata` - `cargo test -p shared-contracts profile_wallet_ledger_response_uses_camel_case_fields` - `npx vitest run packages/shared/src/components/PlatformProfileWalletLedgerModal/index.test.tsx` - `npm run typecheck` - `npx eslint packages/shared/src/components/PlatformProfileWalletLedgerModal/model.ts packages/shared/src/components/PlatformProfileWalletLedgerModal/index.test.tsx packages/shared/src/contracts/runtime.ts` - `npm run check:encoding` - `npm run check:spacetime-schema` - `git diff --check` 以上均通过；Rust 仅输出仓库已有 dead-code warnings。 ## 未验证边界 - 未执行真实登录、生成并读取新钱包流水的端到端联调。本机 `8082/3101` 已由另一套本地栈占用，为避免当前分支挂接同一数据库并带起 worker 处理现有队列，本轮未启动 `npm run dev:api-server`。 - 四项远端 CI 已全部通过，PR 已转为 Ready for review。 ## 不变项 - 不修改历史流水数据。 - 不调整泥点价格、扣费顺序、幂等 ledger、失败退款或余额结算。 - 不修改 SpacetimeDB schema。
suzmii self-assigned this 2026-09-07 17:21:03 +08:00
suzmii added 1 commit 2026-09-07 17:21:03 +08:00
明确泥点流水原因展示契约
Project CI / Backend tests (pull_request) Successful in 7m12s
Details
Project CI / Repository checks (pull_request) Successful in 2m22s
Details
Project CI / Frontend tests (pull_request) Successful in 2m52s
Details
Project CI / Native shell tests (pull_request) Successful in 20m9s
Details
5d8f5731b2 
规定资产扣费 metadata 记录服务端素材类型

规定钱包接口只返回白名单映射的用户可见原因

规定历史及未知流水继续使用通用文案回退
suzmii added 1 commit 2026-09-07 19:34:22 +08:00
优化泥点流水素材原因展示
Project CI / Frontend tests (pull_request) Successful in 3m34s
Details
Project CI / Repository checks (pull_request) Successful in 6m1s
Details
Project CI / Native shell tests (pull_request) Successful in 22m59s
Details
Project CI / Backend tests (pull_request) Successful in 7m32s
Details
e40d41d608 
记录资产扣费类型并保留队列任务元数据

按白名单返回用户可见原因且未知历史流水继续回退

扩展共享契约与账单展示并补齐回归测试和团队决策记录
suzmii marked the pull request as ready for review 2026-09-07 20:05:10 +08:00
suzmii requested review from kdletters 2026-09-08 10:39:48 +08:00
kdletters added 1 commit 2026-09-08 14:34:14 +08:00
Merge branch 'master' into fix/wallet-ledger-reason
Project CI / Backend tests (pull_request) Successful in 5m26s
Details
Project CI / Repository checks (pull_request) Successful in 2m16s
Details
Project CI / Frontend tests (pull_request) Successful in 2m51s
Details
Project CI / Native shell tests (pull_request) Successful in 28m33s
Details
5b72580b0f
kdletters merged commit 456cc42dd3 into master 2026-09-08 14:56:16 +08:00
kdletters deleted branch fix/wallet-ledger-reason 2026-09-08 14:56:16 +08:00
Sign in to join this conversation.
Reviewers
No Reviewers
kdletters
Labels
Clear labels
Compat/Breaking
Breaking change that won't be backward compatible
 Kind/Bug
Something is not working
 Kind/Documentation
Documentation changes
 Kind/Enhancement
Improve existing functionality
 Kind/Feature
New functionality
 Kind/Security
This is security issue
 Kind/Testing
Issue or pull request related to testing
Priority
Critical
1
The priority is critical
Priority
High
2
The priority is high
Priority
Low
4
The priority is low
Priority
Medium
3
The priority is medium
Reviewed
Confirmed
1
Issue has been confirmed
Reviewed
Duplicate
2
This issue or pull request already exists
Reviewed
Invalid
3
Invalid issue
Reviewed
Won't Fix
3
This issue won't be fixed
Status
Abandoned
3
Somebody has started to work on this but abandoned work
Status
Blocked
1
Something is blocking this issue or pull request
Status
Need More Info
2
Feedback is required to reproduce issue or to continue work
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
HuangJiaJia JenkenB k88936 (王德宇) kdletters (段舒康) laura2008 (王乐) lhk229 (孔令弘) Loer (农洛儿) loong suzmii (董羽秦) taobaisu (叶东旭) wuxiangwanzi (王子民) YixuanLiu ziyu
No Assignees suzmii
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: GenarrativeAI/Genarrative#302
Delete Branch "fix/wallet-ledger-reason"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?