Files
memoryweave/go/internal/models/memory.go
T
小唯 13ced12ce9 feat(memoryweave): GA-P0-4 落 hits+/hits− 双计数器——独立语义的 outcome 信号(禁部署)
新增 append-only 事件表 hit_events(sqlite/Rust-LanceDB/memvector 三后端同步),
带 created_at 时间戳可按周窗口聚合,只由真实 outcome 写入(人工反馈/矛盾/取代/
下游引用);dedup 降权/单纯召回出现**不算**(P0-1/P0-2 拆出的假信号,见 hit_event.go
排除项 + docs/hit-outcome-signal.md y 判据)。修正 已办.md:16623 的 hits+=useful_count
错误等同并标注更正依据。

写入点接线 feedback.go(/feedback/useful→pos, /not-useful→neg)。单测 5 例 PASS(含
dedup 降权不计入 hits− 反例 + sqlite 关库重开 read-back);Rust cargo build 通过;
LanceDB 真实 sidecar IPC append/count/get read-back 取证(count 时区归一修掉跨时区错位)。
禁部署:未动运行中二进制、未碰 live 库。
2026-10-12 19:50:58 +08:00

185 lines
10 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// Package models 定义织忆 MemoryWeave 的核心数据模型。
package models
import "time"
// Time 是 time.Time 的安全版本,支持空字符串解析
type Time struct{ time.Time }
// UnmarshalJSON 实现 json.Unmarshaler:空字符串解析为当前时间(而非报错)
func (t *Time) UnmarshalJSON(data []byte) error {
s := string(data)
if s == `""` || s == `"0001-01-01T00:00:00Z"` {
t.Time = time.Time{}
return nil
}
// 去掉前后引号
if len(s) >= 2 && s[0] == '"' && s[len(s)-1] == '"' {
s = s[1 : len(s)-1]
}
if s == "" || s == "null" {
t.Time = time.Time{}
return nil
}
return t.Time.UnmarshalJSON(data)
}
// VersionRecord 记忆版本记录(溯源链中的单次修改)
type VersionRecord struct {
Version int `json:"version"`
Content string `json:"content"`
UpdatedBy string `json:"updated_by"`
Source string `json:"source"`
Trigger string `json:"trigger"`
Reason string `json:"reason"`
Timestamp time.Time `json:"timestamp"`
}
// MemoryRecord 织忆中的单条记忆(存储在 LanceDB memories 表中)。
// v3.8 完整 Schema — 23 字段,与设计文档一致。
type MemoryRecord struct {
ID string `json:"id"`
AgentID string `json:"agent_id"`
Namespace string `json:"namespace"`
Content string `json:"content"`
ContentMD5 string `json:"content_md5"` // content 的 MD5 前 12 字符,用于精确去重
Category string `json:"category"` // system_fact, user_pref, proj_context, tool_usage, code_snippet
Vector []float32 `json:"vector"` // bge-m3 1024维,L2归一化
Tier string `json:"tier"` // normal, core(core永不衰减)
Importance float64 `json:"importance"` // 重要性得分 = recency_factor × (1+log(1+recall_count))
QualityScore float64 `json:"quality_score"`
UsefulCount int `json:"useful_count"` // 被标记 useful 的次数
// GA-P0-1 (t_718d8707):not_useful_count 曾把两种语义混写——
// 用户人工点「没用」(feedback.go MarkNotUseful) 与 dedup/合并流程自动降权
// (core.go Dedup demote) 都写同一个字段。现拆分为 human_not_useful_count
// 与 dedup_downweight_count,两个写入点各写各的。not_useful_count 保留为
// 历史列(deprecated),新代码不再读它(见 AC#3)。
HumanNotUsefulCount int `json:"human_not_useful_count"` // 用户人工点「没用」的次数
DedupDownweightCount int `json:"dedup_downweight_count"` // dedup/合并流程自动降权的次数
NotUsefulCount int `json:"not_useful_count"` // [DEPRECATED] 历史混写列,勿再读
Version int `json:"version"` // 当前版本号
VersionHistory []VersionRecord `json:"version_history,omitempty"` // 完整修改链
Source string `json:"source"` // 来源:牧尘口头 / 配置解析 / Agent推断 / LLM蒸馏
VolatileFlag bool `json:"volatile_flag"` // 频繁变更标记(≥3次修正自动设置)
RecallCount int `json:"recall_count"`
// GA-P0-2 (t_c6d41ac6):拆分 recall_count 的两种语义(「出现在结果里」/「被验证使用」)。
// recall_count 曾把两种语义混写 —— 每次召回命中都 ++,被当成 V 值喂给衰减/遗忘逻辑,
// 造成「被召回 500+ 次所以永不遗忘」的虚高保命。现拆分为:
// RecallSeenCount 出现即 ++(只用于观测/排序去偏,不参与 V 值/衰减权重)
// RecallVerifiedCount有正反馈(IncrementUseful)或下游引用才 ++(唯一参与 V 值/衰减)
// RecallCount 保留为历史列(deprecated),冻结不再增长,仅向后兼容读取历史值(AC#3)。
RecallSeenCount int `json:"recall_seen_count"` // 出现在召回结果里即 ++(观测/排序去偏用)
RecallVerifiedCount int `json:"recall_verified_count"` // 有正反馈或下游引用才 ++(V 值/衰减唯一来源)
Freshness string `json:"freshness"` // fresh, stale, verified
// 2026-10-08 (t_7e3577c5):血缘字段。embedding_model=实际嵌入模型(bge-m3);
// script_version=写入脚本版本标识。写入方经 metadata 携带,server 蒸馏落库。
EmbeddingModel string `json:"embedding_model"`
ScriptVersion string `json:"script_version"`
// 2026-10-08 (Gap#2 来源加权):confidence=写入方显式声明的信任等级(0.4~1.0),
// 不从 source 反推(source 是「哪条管道进来」,confidence 是「内容可不可信」,两者正交)。
// 指针类型:nil ⇒ JSON null ⇒ Rust 写 NULL ⇒ 读路径 COALESCE→1.0(加权首日 no-op)。
// ConfidenceSource=authoritative(写入时声明) | estimated(事后回填猜测),用于日后定向纠偏。
Confidence *float64 `json:"confidence,omitempty"`
ConfidenceSource string `json:"confidence_source,omitempty"`
// 2026-10-11 (t_631ab13d):DB 原值直通通道。json:"-" 不参与任何 JSON 传输:
// Rust IPC Search 会把 QualityScore 融合成 0.4*importance+0.6*raw(排序用),
// 但 recall 响应需要展示 LanceDB 原始列值("响应值==库值"判据)。
// 只在进程内携带,不落库、不序列化。
RawQualityScore *float64 `json:"-"`
LastRecalledAt time.Time `json:"last_recalled_at"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
IsDeleted bool `json:"is_deleted"`
// GA-P0-3 (t_f785d7f2):删除原因枚举(merge_dup|contradiction|manual|retention|unknown)。
// is_deleted=true 不再「不可分辨」—— 坏记忆被删 与 合并/整理被删 现可分列。additive 列。
DeleteReason string `json:"delete_reason,omitempty"`
DependsOn []string `json:"depends_on,omitempty"` // 依赖的记忆 ID 列表
DerivedFrom string `json:"derived_from,omitempty"` // 蒸馏来源 episode ID
}
// HitEvent 真实 outcome 的 append-only 事件(GA-P0-4 t_bb10e8bc)。
// 与计数列(useful_count / human_not_useful_count 等)不同:这是「按时间戳追加」
// 的事件日志,**不覆盖式累加** —— 每次真实 outcome 追加一行,带 created_at 时间戳,
// 便于 P2 自适应阈值按周窗口聚合(WHERE created_at > 本周起点)。语义定义见
// internal/storage/hit_event.go(什么算 hits+ / hits− / 什么不算)。
type HitEvent struct {
ID int64 `json:"id"`
MemoryID string `json:"memory_id"`
Outcome string `json:"outcome"` // pos | neg(HitOutcome 枚举)
Reason string `json:"reason"` // HitReason 枚举:human_feedback|contradiction|replacement|downstream_use
Source string `json:"source,omitempty"` // 记录方标识(如端点名)
CreatedAt time.Time `json:"created_at"`
}
// EpisodeRecord 原始对话/任务日志(存储在 LanceDB episodes 表中)。
type EpisodeRecord struct {
ID string `json:"id"`
AgentID string `json:"agent_id"`
Namespace string `json:"namespace"`
Content string `json:"content"`
Category string `json:"category"`
CreatedAt time.Time `json:"created_at"`
}
// TombstoneRecord 已删除/废弃记忆的墓碑记录。
type TombstoneRecord struct {
ID string `json:"id"`
OriginalID string `json:"original_id"`
Reason string `json:"reason"` // deprecated, merged, corrected, evicted
CreatedAt time.Time `json:"created_at"`
}
// RecallResult recall 接口返回的单条结果。
type RecallResult struct {
ID string `json:"id"`
Content string `json:"content"`
Category string `json:"category"`
Score float64 `json:"score"`
Timestamp string `json:"timestamp"`
// 2026-09-22 新增:全库召回(namespace="" 时)调用方无法分辨记忆来源域,
// 会把分身的私有记忆当成自己的用。带上来源便于调用方按需过滤/标注。
// omitempty:旧调用方无感;图谱扩展路径(graph_*.go)无 ns 概念,留空。
Namespace string `json:"namespace,omitempty"`
AgentID string `json:"agent_id,omitempty"`
Source string `json:"source,omitempty"`
// 2026-10-08 (Gap#2):把信任等级直通给调用方。此前加列但不动本结构 ⇒
// confidence 对排序/调用方零影响(「字段加了没接线」的经典静默 no-op)。
// Confidence=nil 表示该条未声明(存量),调用方按 1.0 处理。
Confidence *float64 `json:"confidence,omitempty"`
ConfidenceSource string `json:"confidence_source,omitempty"`
// 2026-10-11 (t_631ab13d):把库里的 quality_score / v_value 直通给调用方。
// 此前 RecallResult 缺这两个字段 ⇒ JSON 序列化不带出 ⇒ 插件 `r.get("quality_score", 0)`
// 恒得默认 0("显示 0"),与库里 74.88% 记忆有真实值矛盾。排序不受影响(排序用内存
// candidates[i].QualityScore=库值,见 recall.go),本字段仅补"响应值==库值"的显示缺口。
// quality_score 恒输出(含 0);v_value 为 VValueProvider 提供,未注入时 0。
QualityScore float64 `json:"quality_score"`
// QualityScoreReliable:上面的 quality_score 是否可信。
// 2026-10-12:存量 54.2% 的 quality_score 不可信(0=未打分 / 0.755=历史常量 bug),
// 该值原样返回供审计,但**不应被当作真实质量判断**。调用方须看本字段。
QualityScoreReliable bool `json:"quality_score_reliable"`
VValue float64 `json:"v_value"`
}
// RerankResult rerank 重排后的单条结果。
type RerankResult struct {
Index int `json:"index"`
Score float64 `json:"score"`
Text string `json:"text"`
}
// GraphBFSResult BFS 图谱扩展结果(含汇总语句)
type GraphBFSResult struct {
ExpandedRelations []ExpandedRelation `json:"expanded_relations"`
Summary string `json:"summary"`
}
// ExpandedRelation 单条扩展关系
type ExpandedRelation struct {
From string `json:"from"`
To string `json:"to"`
Relation string `json:"relation"`
Hops int `json:"hops"`
Weight float64 `json:"weight"`
Score float64 `json:"score"`
}