跳到主要内容

FinClaw V1 Sub-Packet: Feedback / Human Review UI 与 Queue

状态：Pending 日期：2026-05-16 Lane：Engineering / Frontend Owner：Engineering Agent A + Frontend Agent D Parent Packet：v1-engineering-implementation-task-packet.md 对齐 Action Item：AL-7

1. 目标​

在工程仓库落地 trial 期间所需的反馈与人工复核闭环：

2. 允许读取​

见 frontmatter must_read / reference_only。

3. 禁止范围​

  • 反馈入口不承诺生产 SLA / 实时客服 / 交易支持；
  • 不收集账户 / 私钥 / API key（依赖 sub-2 SensitiveInputHandling 拒禁）；
  • 不让 review queue 触发自动决策（所有 grade 必须由复核员 explicit 提交）；
  • 不在 V1 引入第三方反馈 SaaS。

4. Acceptance Criteria​

AC ID验收项
AC-1FeedbackForm 覆盖 11 类反馈类型；form 输出符合 review queue schema
AC-2ReviewRequestButton 在 Snapshot / Thread / Checkpoint 三视图都可触发
AC-3Review queue 视图（仅复核员可见）显示：pending / in_review / done 三状态；支持 grade（A/B/C/D）+ reviewer_notes
AC-4反馈写入路径：evaluation/finclaw/runs/human-experience/<batch>/<session_id>.yaml（与 trial sub-2 / human-experience-trial-script §7 对齐）
AC-5复核员可演示完整闭环：用户反馈 → queue 接收 → 复核 → grade 写入 evaluation runs
AC-6RBAC：trial cohort 用户不能看到 review queue；仅 trial owner / Controller 可访问
AC-7单测：feedback POST + queue list + reviewer claim + grade submit 共 ≥ 10 case
AC-8与 trial 启动同步：M-B8 中此 sub-packet 必须先 done 才能进入 trial-start

5. 回写位置​

  • 代码 → 工程仓库 fin-claw；
  • v1-governance-engineering-alignment.md §4 / §5 / §9.AL-7 状态由 partial / missing → aligned-initial；
  • Hand-off anchor → handoff-anchors/v1-eng-impl-sub-6-feedback-review-queue.yaml；
  • 解除依赖：trial sub-1 / trial sub-2、cs sub-2（部分事件复用反馈 sink）。

6. 风险与裁决项​

  • 风险 R-1：Review queue 在 trial 后期堆积导致 review backlog → 限制 batch ≤ 5 user，trial owner 必须 24h 内复核 ≥ 80%；
  • 风险 R-2：复核员将自身偏见写入 grade → 由 v1-human-experience-trial-script.md §6 double reviewer spot-check 缓解；
  • 裁决项 J-1：复核员身份在 D-01 已限定为项目发起人 + Mark.T + Aven，是否需要专职复核员由 trial 第 1 周后裁决。

7. 与其他 Sub-Packet 的关系​

  • 弱依赖：sub-1（用户身份与 ProfileConsent）、sub-2（凭证拒禁）；
  • 解除：trial 系列；
  • 共享文件需协调：server/api/（新增 feedback / review routes，与其他 routes 协调）。