2026-10-09 校注：文中部署目录、服务、版本和验收计数为各段标注日期的历史记录；当前可验证状态见 current-status-2026-10-09，本次未复跑历史测试或读取私有健康/对话数据。
Humon 显式真值与低摩擦反馈 v1
目的
Humon 不能靠设备行为“猜中人”。内在状态的最可靠校准来源，是用户在对应时间点主动给出的明确自报，以及对 shadow 候选的明确评价。本层把这些信号统一成可审计、可去重、可计算预测误差的真值账本，同时坚持不保存原始句子、不主动弹窗、不因缺少反馈而惩罚用户。
数据边界
ground_truth_reports 只保存结构化字段：
- user、dimension、reported/numeric/label/confidence；
- source、source_ref、observed/ingested time；
- 最近一个更早的 natural v3 预测及其置信度、年龄；
- signed/absolute error、calibration eligibility；
- 不含原始对话、prompt、reasoning、tool output 或自由文本正文。
唯一键为 (user, source, source_ref, dimension)，同一自报即使被多个状态样本引用也只计一次。
预测误差匹配
只有满足全部条件才进入校准：
- energy/focus/stress 的 1–10 数值自报；
- 对应预测来自更早的 source=auto、model=Humon-fusion-v3 自然样本；
- 预测维度当时已知；
- 预测置信度 ≥0.55；
- 预测没有穿越自报时间，且年龄未超过 TTL：energy 3h、focus 1h、stress 2h。
低置信预测仍可作为审计上下文，但不得改变个人校准。
低摩擦入口
- WebUI 的 Optional check-in 提供 energy/focus/stress 滑杆和 mood 标签。
- 只有用户主动点击 Save 才写入；页面明确显示 never prompted proactively。
POST /api/feedback/state进行维度与 1–10 边界验证，并原子写入 feedback 与 ground truth。POST /api/feedback/shadow只记录明确 shadow 标签，仍不投递干预。GET /api/ground-truth返回结构化统计。GET /api/feedback/opportunities只返回“当前回复内可顺带询问”的机会，不产生弹窗或后台消息。
被动机会只有在用户活跃、最近 15 分钟存在交互且 24 小时内无真值时才可能出现；shadow 机会必须是实际候选而非“沉默”。所有 delivery 标志保持 false。
质量门槛
纵向质量现在要求：
- observation_span_7d；
- v3_samples_200；
- direct_reports_10；
- distinct_report_days_3；
- inner_dimension_coverage_10pct。
ground truth 自身 readiness 至少需要 10 条直接报告、跨 3 个不同日期。达标仍不等于允许主动投递；还要同时通过 shadow 帮助率、打扰率、隐私、个人基线与 kill-switch 设计。
状态转折不是新真值
明确状态转折只证明旧值不再成立，因此会 supersede 当前直接状态并回到 unknown；它保留历史报告，但不创建新的 ground truth、feedback、预测误差或校准值。直接报告与转折的时效均以原始观察时间为绝对起点。详见 humon-explicit-state-transition-v1。
正式部署证据
- 开发镜像与正式运行目录 18 项单元测试全部通过，compileall 通过；本轮修改文件的 Ruff 定向检查通过。
- 在正式数据库副本上验证：合法数值可落入两张账本；越界值返回 400 且计数不变；低置信/unknown 预测不会进入 calibration；shadow 标签不会开启 delivery。
- 正式库未写入测试反馈：ground_truth=0、feedback=0、shadow_labels=0、delivered=0、privacy_events=0。
- 22:20 自然 cron 正常生成第 22 条 natural v3 样本，五分钟槽重复数为 0。
/health为 operational-collecting、operational_ready=true、longitudinal_ready=false、delivery_ready=false。- 当前用户 away，因此 feedback opportunities 为空，抑制原因为 shadow-only:no-delivery 与 no-active-reply-window。
- WebUI 已在默认桌面视口及 390px 窄屏实机验证；修复后 clientWidth=375、scrollWidth=375，四个反馈控件完整可见，页面控制台无 error/warning。
- 数据库
PRAGMA integrity_check=ok。
回滚点
- 真值层前：
${HOME}/.hermes/backups/humon-v3-pre-ground-truth-20260716-221207 - 响应式修复前：
${HOME}/.hermes/backups/humon-v3-pre-responsive-20260716-221858
下一步
让真实使用自然积累直接报告与预测误差，不为追求门槛而主动催促或制造样本。下一条主要证据通道是逐源授权、只保留派生特征的手机/可穿戴输入。
关联
2026-07-17 Ground truth v4 精度语义
ground truth 现在保存 value_kind。ordinal 仍是直接人类证据，但 numeric_value=NULL 且永不 calibration eligible；只有显式 1–10 numeric 才能进入误差校准、数值个人基线、均值和趋势。质量 v3 审计状态精度一致性，公开投影不显示内部代表值。正式库仍 ground_truth=0，没有为验收制造报告。详见 humon-direct-evidence-precision-v1。