jianf/HomeAgent
1
0
Fork 0
mirror of https://gitcode.com/JianFeeeee/HomeAgent.git synced 2026-10-15 12:15:16 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
9f7d91c21931df54e7b6ed58c097145b5b521f8b
HomeAgent/internal/memory
History
JianFeeeee 9f7d91c219 refactor(memory)!: 删除 CAS 包与第二套召回（块 union 化第四阶段：收尾） 
块 union 化前三阶段已让块自带负载、回填存量字节。本提交拆掉 CAS 本身：
`internal/memory/media/`（2100 行）+ `QueryMediaScored`（第二套召回）
+ `media_refs`/`ref_count` 引用账本 + `internal/sdk/media.go`（MediaAPI）
+ `SDKConfig.Media` / `SetMediaStore` 接线。删完 CAS 才真正不存在。

## 为何可删（不是"先删了再说"）

- **MediaAPI 在生产早已是死的**：`SDKConfig.Media` 自 86572d13 起从未被设置，
  `sdk.Media()` 恒为 nil，插件 digest 路径一直走"内容寻址库不可用"分支。
  删的是死代码，不是活路径。
- **第二套召回确无调用方**：`QueryMediaScored` 仅被 media 包自身的测试引用，
  跨包引用为 0（块召回走 `RecallBlocks`）。
- **heldMediaDigests 补丁**（crossmodal 靠它防召回"无处可归的媒体"）
  已在 86572d13 删除 —— 两套存储才需要的那种补丁，随存储一起没了。

## 替代路径：块引用取代 digest

插件取媒体从 `sdk.Media().Get(digest)` 改为 `sdk.Memory().MediaBytes(ref)`：

- **新增 `MemoryAPI.MediaBytes(ref) (data, mime, ok, err)`**（内置接口，非 pubsdk）：
  按块引用（完整块 ID 或唯一前缀）取字节；`ok=false` 而非 error ——
  "这个引用没有媒体"是调用方能处理的常态。
- **seemedia / multimodal**：`digest` 参数语义改为**媒体块引用**，工具描述同步。
  path/url 两条来源不变（生产实际只用这两条）。
- **webui 知识上传**：媒体字节不再 Put 进 CAS 再拿 digest，而是作为
  `KnowledgeMediaRef.Data` 随引用携带，由 knowledge.Write 落进条目目录
  （与 content.md 同生共灭，Remove 的 RemoveAll 天然清掉）。
- **回填命令去依赖**：cmd/homed-media-backfill 不再 import 待删的 media 包，
  改为直接读**冻结的历史布局** blobs/<d[:2]>/<d[2:]> 并自校验 sha256。
  依赖待删代码的迁移工具会在删包那刻失效 —— 迁移必须比被迁移的东西活得久。

## 判据（全部做过变异测试）

- `TestMemoryBytes_ByBlockRef`：完整 ID / 唯一前缀可取回且逐字节一致；
  不存在→ok=false；过短前缀（歧义）→ok=false；无负载块→ok=false；空引用不 panic。
  变异（不校验 ok，把不存在当有）当场被 3 条断言抓住。
- `TestE2EMediaBytesAgainstBackfilledDB`（-tags e2e，读真回填库）：
  10/10 块经 MediaBytes 取回的字节与块 data 的 sha256 完全一致。
- `TestKnowledgeUploadedMediaRetrievable` 重写为**条目目录自带字节**判据
  （不再是"向存储按 digest 读回"）；`TestKnowledgeUploadMediaNeedsNoStore`
  改为"上传无外部存储依赖也必须成功"（旧的 503 语义已随 CAS 消失）。

## 静态确认
`QueryMediaScored` / `internal/memory/media` import / `MediaAPI` /
`sdk.Media()` / `SetMediaStore` / `heldMediaDigests` 全仓均为 0 处
（仅剩 medialoop.go 一句历史注释）。

回归：memory / sdk / agent-core / knowledge / plugin / webui / seemedia /
multimodal 八包全绿；全仓生产编译 GREEN。
2026-10-12 16:52:43 +08:00
..
distill
chore(module): Go module 路径随托管地迁移 gitcode → github
2026-10-08 10:40:17 +08:00
document
chore(module): Go module 路径随托管地迁移 gitcode → github
2026-10-08 10:40:17 +08:00
jiebadict
feat(core): 注入行为的记忆/裁剪标志位落地 + jieba 词库内嵌 + Windows 改走 WSL
2026-09-11 20:31:50 +08:00
pipeline
chore(module): Go module 路径随托管地迁移 gitcode → github
2026-10-08 10:40:17 +08:00
social
perf(memory): Introspect 507ms→11ms、ListPersons 130ms→3ms
2026-10-08 16:41:03 +08:00
text
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
vector
chore(module): Go module 路径随托管地迁移 gitcode → github
2026-10-08 10:40:17 +08:00
abstain_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
abstain.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
access_hook_race_test.go
feat(memory): 图数据库自报真实读写事件，取代「按工具名猜节点」
2026-10-08 10:41:07 +08:00
access_hook_test.go
feat(memory): 图数据库自报真实读写事件，取代「按工具名猜节点」
2026-10-08 10:41:07 +08:00
alias_candidates_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
arbitration_sibling_guard_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
arbitration_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
arbitration.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
bilingual_test.go
refactor(memory): 拆除描述式媒体索引，媒体成为一等块并按原生向量融合
2026-09-11 11:45:24 +08:00
block_recall_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
block_recall.go
refactor(memory)!: 块 union 化，彻底淘汰 CAS 第一阶段（生产代码）
2026-10-12 10:13:36 +08:00
block.go
test(memory)!: 块 union 化判据重写（CAS 淘汰第二阶段：测试）
2026-10-12 14:26:13 +08:00
blocks_changed_test.go
perf(webui): pulse 端点不再全量扫描图库；修星图每帧全量开销
2026-10-08 12:35:28 +08:00
centroid_store_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
centroid_store.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
centroid_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
centroid.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
clean_stress_test.go
refactor(memory): 拆除描述式媒体索引，媒体成为一等块并按原生向量融合
2026-09-11 11:45:24 +08:00
clean_text_test.go
feat: NoMemory/Cleaner memory system + doc update
2026-07-25 11:17:31 +08:00
clean_text.go
chore(module): Go module 路径随托管地迁移 gitcode → github
2026-10-08 10:40:17 +08:00
commit_blocks_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
cut_test.go
sdk: embed non-toolchain SDK in third_party, add NoMemory/Cleaner support
2026-07-29 14:48:23 +08:00
cut.go
fix(memory): doc→graph 补回常用词闸门 + 存量噪音/孤立节点清理
2026-09-15 07:47:16 +08:00
delete_entity_blocks_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
e2e_backfill_test.go
feat(memory)!: 存量媒体字节回填（块 union 化第三阶段：数据迁移）
2026-10-12 16:23:23 +08:00
edge_entity_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
edge_entity.go
feat(memory): 图数据库自报真实读写事件，取代「按工具名猜节点」
2026-10-08 10:41:07 +08:00
entityname_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
fusion_bfs_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
fusion_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
fusion.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
graph_readonly_test.go
feat(memory): N2a 第一块砖 —— 主图记忆的受限句柄（query_only），子是"读得到写不进"
2026-09-13 09:32:29 +08:00
graph_test.go
test(memory)!: 块 union 化判据重写（CAS 淘汰第二阶段：测试）
2026-10-12 14:26:13 +08:00
graph.go
test(memory)!: 块 union 化判据重写（CAS 淘汰第二阶段：测试）
2026-10-12 14:26:13 +08:00
indexer_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
indexer.go
refactor(memory)!: 块 union 化，彻底淘汰 CAS 第一阶段（生产代码）
2026-10-12 10:13:36 +08:00
introspect_count_truth_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
introspect_perf_test.go
perf(memory): Introspect 507ms→11ms、ListPersons 130ms→3ms
2026-10-08 16:41:03 +08:00
jieba_embed_test.go
feat(core): 注入行为的记忆/裁剪标志位落地 + jieba 词库内嵌 + Windows 改走 WSL
2026-09-11 20:31:50 +08:00
jieba_embed.go
feat(core): 注入行为的记忆/裁剪标志位落地 + jieba 词库内嵌 + Windows 改走 WSL
2026-09-11 20:31:50 +08:00
legacy_retire_precondition_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
light_memory_test.go
feat(memory): N2a 第二块砖 + N2d 数据面 —— 轻量图记忆装配（temp 可写/主库只读/并集）与回收合入
2026-09-13 09:38:54 +08:00
light_memory.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
merge_blocks_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
migrate_blockdata_test.go
feat(memory)!: 存量媒体字节回填（块 union 化第三阶段：数据迁移）
2026-10-12 16:23:23 +08:00
migrate_blockdata.go
feat(memory)!: 存量媒体字节回填（块 union 化第三阶段：数据迁移）
2026-10-12 16:23:23 +08:00
migrate_entities_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
migrate_entities.go
refactor(memory)!: 块 union 化，彻底淘汰 CAS 第一阶段（生产代码）
2026-10-12 10:13:36 +08:00
migrate_testhelp_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
migrate.go
refactor(memory)!: 块 union 化，彻底淘汰 CAS 第一阶段（生产代码）
2026-10-12 10:13:36 +08:00
near_screen_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
noise_test.go
test(memory)!: 块 union 化判据重写（CAS 淘汰第二阶段：测试）
2026-10-12 14:26:13 +08:00
noise.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
probe_e2e_test.go
chore(module): Go module 路径随托管地迁移 gitcode → github
2026-10-08 10:40:17 +08:00
probe_prod_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
prod_copy_regression_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
read_side_wrappers_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
real_context_test.go
memory 测试自包含：合成 word2vec 模型替代 /tmp 大模型依赖，测试不再联网下载 fastText
2026-08-05 09:59:30 +08:00
recall_exact_symbol_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
recall_order_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
recall_score_distribution_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
recall_separability_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
recall_sorted_blocks_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
reclaim_test.go
feat(memory): N2a 第二块砖 + N2d 数据面 —— 轻量图记忆装配（temp 可写/主库只读/并集）与回收合入
2026-09-13 09:38:54 +08:00
scene_dedupe_test.go
fix(memory): 图整备覆盖 scenes + 证据桶按桶清（R3/R5）
2026-09-26 20:16:11 +08:00
scene_emerge_test.go
fix(memory): 打通场景/索引/召回残余矛盾点，清理死代码与冗余索引
2026-09-15 10:20:40 +08:00
scene_emerge.go
fix(memory): 图整备覆盖 scenes + 证据桶按桶清（R3/R5）
2026-09-26 20:16:11 +08:00
scene_evidence_test.go
fix(memory): 图整备覆盖 scenes + 证据桶按桶清（R3/R5）
2026-09-26 20:16:11 +08:00
scene_key_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
scene_migrate_test.go
feat(memory): 图数据库自报真实读写事件，取代「按工具名猜节点」
2026-10-08 10:41:07 +08:00
scene_migrate.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00
scene_test.go
refactor(memory)!: 块 union 化，彻底淘汰 CAS 第一阶段（生产代码）
2026-10-12 10:13:36 +08:00
scene.go
refactor(memory)!: 块 union 化，彻底淘汰 CAS 第一阶段（生产代码）
2026-10-12 10:13:36 +08:00
sentence_block.go
test(memory)!: 块 union 化判据重写（CAS 淘汰第二阶段：测试）
2026-10-12 14:26:13 +08:00
static_embedder_mem_test.go
perf(memory): 静态词向量改用 float32 存储（省 ~0.65GB 常驻）
2026-09-13 14:09:35 +08:00
static_embedder_test.go
chore(module): Go module 路径随托管地迁移 gitcode → github
2026-10-08 10:40:17 +08:00
static_embedder.go
chore(module): Go module 路径随托管地迁移 gitcode → github
2026-10-08 10:40:17 +08:00
synth_model_test.go
fix: LLM 工具循环 400、中断消息注入、ConPTY 终端支持
2026-08-14 00:48:40 +08:00
traverse_test.go
merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)
2026-10-05 11:25:20 +08:00