mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-21 17:38:10 +00:00
8c5b35a6b1
- Version: 0.9.0 -> 0.9.1 - SDKCompatibleVersion: 0.9.0 -> 0.9.1 - go.mod require homeagent-sdk: v0.8.0 -> v0.9.1 - SDK 版本独立提交（third_party/homeagent-sdk/meta/meta.go） CABINum 仍为 900（minor=9 不变），ABI 向前兼容。
108 lines
3.7 KiB
Go
108 lines
3.7 KiB
Go
// Package meta 收集 HomeAgent 内核的全部元数据。
|
||
// 版本号通过 `go build -ldflags` 注入，默认值为 dev 版本。
|
||
// 此文件是 ABI 版本号与 dispatch method ID 的唯一数据源。
|
||
// SDK 仓的 meta/meta.go 应与此保持同步。
|
||
package meta
|
||
|
||
var (
|
||
// Version 是 HomeAgent 内核版本号。
|
||
// 通过 `-ldflags="-X gitcode.com/JianFeeeee/HomeAgent/internal/meta.Version=vX.Y.Z"` 注入。
|
||
Version = "0.9.1"
|
||
|
||
// Commit 是构建时的 Git commit hash。
|
||
Commit = "unknown"
|
||
|
||
// BuildTime 是构建时间。
|
||
BuildTime = "unknown"
|
||
|
||
// KernelName 是内核名称。
|
||
KernelName = "HomeAgent"
|
||
|
||
// SDKCompatibleVersion 是此内核可兼容的最高 SDK 版本（semver）。
|
||
SDKCompatibleVersion = "0.9.1"
|
||
)
|
||
|
||
// FullVersion 返回完整的版本字符串。
|
||
func FullVersion() string {
|
||
return KernelName + " v" + Version + " (" + Commit + ")"
|
||
}
|
||
|
||
// ---- ABI 版本（C ABI 协议版本，插件与内核通信用） ----
|
||
// ABI 版本直接取内核版本号字符串（semver），与核心 Version 保持一致，不再使用独立数字编码。
|
||
// 协商层（C 结构体 int version 字段）使用 CABINum：由版本字符串派生的整数（major*100 + minor）。
|
||
// 映射：v0.8.x → CABINum=800；v0.9.x → CABINum=900（invoke_stage 写回）。
|
||
// 小版本（patch）演进不影响 ABI，CABINum 不变。version_min 保证旧 ABI 插件仍可加载。
|
||
|
||
var (
|
||
// ABIVersion 是 ABI 标识版本（字符串 semver，与核心 Version 对齐）。
|
||
ABIVersion = Version
|
||
// ABIVersionMin 是兼容的最低 ABI 标识版本。
|
||
ABIVersionMin = "0.8.0"
|
||
)
|
||
|
||
const (
|
||
// CABINum 是 C 层协商用的整数版本（major*100 + minor），随 ABIVersion 派生。
|
||
CABINum = 900
|
||
// CABINumMin 是 C 层兼容的最低整数版本。
|
||
// 旧工具链（v0.8 之前）写入的整数 version=1，无写回能力但与新内核结构兼容，
|
||
// 因此最小值保持 1 以兼容全部旧插件（新插件 900 匹配，旧插件 1/2 通过）；
|
||
// 仅当未来内核 ABI 破坏兼容时才提高该值。
|
||
CABINumMin = 1
|
||
)
|
||
|
||
// ---- Dispatch Method IDs ----
|
||
// 核心→插件：这些 ID 通过 CoreAPI.dispatch 传递，标识 SDK 调用。
|
||
// 插件端的 C enum 定义在 plugindev 的 C ABI header 模板中。
|
||
const (
|
||
CoreRegisterTool = 1
|
||
CoreRegisterStage = 2
|
||
CoreRegisterOutputCh = 3
|
||
CoreRegisterPluginAPI = 4
|
||
CoreInjectText = 5
|
||
CoreInjectInterruptText = 6
|
||
CoreInjectTextNoMemory = 7
|
||
CoreSetAutoRestart = 8
|
||
CoreMemoryRecall = 9
|
||
CoreMemoryCommit = 10
|
||
CoreMemoryIntrospect = 11
|
||
CoreMemoryMerge = 12
|
||
CoreMemoryPurge = 13
|
||
CoreDocQuery = 14
|
||
CoreKnowledgeSearch = 15
|
||
CoreSettingsGet = 16
|
||
CoreSettingsSet = 17
|
||
CoreSettingsRegisterDef = 18
|
||
CoreLLMListSources = 19
|
||
CoreLLMSetSource = 20
|
||
CoreSocialGetPerson = 21
|
||
CoreSocialGetNetwork = 22
|
||
CoreSubscribe = 23
|
||
CoreUnsubscribe = 24
|
||
CoreFreeString = 25
|
||
CoreSettingsGetCore = 26
|
||
CoreSettingsSetCore = 27
|
||
CoreSettingsListCore = 28
|
||
CoreSettingsGetPlugin = 29
|
||
CoreSettingsSetPlugin = 30
|
||
CoreSettingsListPlugin = 31
|
||
CoreDocInsert = 32
|
||
CoreDocRemove = 33
|
||
CoreDocStats = 34
|
||
CoreKnowledgeAdd = 35
|
||
CoreKnowledgeList = 36
|
||
CoreLLMCurrentSource = 37
|
||
CoreSocialGetTrait = 38
|
||
CoreSocialGetRelations = 39
|
||
CoreSocialListPersons = 40
|
||
CoreTextMemoryAppend = 41
|
||
CoreSettingsList = 42
|
||
CoreSettingsDefs = 43
|
||
CoreSettingsDump = 44
|
||
CoreSettingsPlugins = 45
|
||
CoreRegisterInputCh = 46
|
||
CoreInjectInputSync = 47
|
||
CorePluginReloadOne = 48
|
||
CorePluginListLoaded = 49
|
||
CorePluginIsDisabled = 50
|
||
)
|