mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-21 17:38:10 +00:00
chore(sdk): 同步 vendored SDK 镜像到 1.2.0
core 仓里跟踪的 SDK 镜像落后于 third_party/homeagent-sdk(那是个独立仓库): 已提交的 sdk/memory.go 仍带 MediaAttachment.Description,而 SDK 仓 b2eafdf 已把它 删掉(媒体不再以文本描述参与索引)。磁盘上的文件其实就是 SDK 仓当前的版本, 只是 core 的索引没有跟上——于是**干净检出 main 拿到的是一个与它构建所用 SDK 不一致的镜像**。 clean worktree 能编译(内核已不再引用 Description),所以这个不一致不会被构建 发现,只能靠比对发现——属于本项目一直在治的「静默不一致」。 同步内容:sdk/memory.go 与 SDK 仓 HEAD 逐字节一致。
This commit is contained in:
18
third_party/homeagent-sdk/sdk/memory.go
vendored
18
third_party/homeagent-sdk/sdk/memory.go
vendored
@ -49,15 +49,17 @@ type TextMemoryAPI interface {
|
||||
//
|
||||
// 两个方向共用一个类型:
|
||||
// - 写入(InsertWithMedia):给 Data + MIME 就是新内容;只给 Digest 则是引用已有内容。
|
||||
// - 读出(Query):内核只填 Digest/MIME/Description,**不回 Data**——
|
||||
// - 读出(Query):内核只填 Digest/MIME,**不回 Data**——
|
||||
// 一次检索可能命中几十张图,把字节全塞回插件会把 ABI 消息撑爆。
|
||||
// 需要字节时拿 Digest 单独取。
|
||||
//
|
||||
// 刻意没有 Description 字段:媒体不作为文本被索引,也不带任何生成的描述。
|
||||
// 它只按自己的原生向量被检索与召回;附加文字请写在文档 / 三元组的文本里。
|
||||
type MediaAttachment struct {
|
||||
Digest string `json:"digest,omitempty"`
|
||||
MIME string `json:"mime,omitempty"`
|
||||
Data []byte `json:"data,omitempty"`
|
||||
Name string `json:"name,omitempty"`
|
||||
Description string `json:"description,omitempty"`
|
||||
Digest string `json:"digest,omitempty"`
|
||||
MIME string `json:"mime,omitempty"`
|
||||
Data []byte `json:"data,omitempty"`
|
||||
Name string `json:"name,omitempty"`
|
||||
}
|
||||
|
||||
type TextEvent struct {
|
||||
@ -74,8 +76,8 @@ type DocMemoryAPI interface {
|
||||
Insert(doc *Doc) error
|
||||
// InsertWithMedia 写入文档并关联媒体。attachments 里带 Data 的会落进
|
||||
// 内容寻址存储(相同字节只存一份),只带 Digest 的直接引用已有内容。
|
||||
// 插件无需自己拼标记:内核会把 `[mime <短 digest>] <描述>` 补进 Content,
|
||||
// 让向量检索和后续蒸馏都能看到这份媒体。
|
||||
// 媒体成为文档直接持有的一等记忆块:文档向量会融合它们的原生向量,
|
||||
// 因此图片按自己的向量被召回,不依赖任何生成的描述文本。
|
||||
InsertWithMedia(doc *Doc, attachments []MediaAttachment) error
|
||||
Remove(id string)
|
||||
Stats() map[string]interface{}
|
||||
|
||||
Reference in New Issue
Block a user