mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-09-20 17:08:01 +00:00
5ed8d65479
## 为何是主版本号
公开 SDK 接口（sdk/ 目录）本轮**零改动**，插件业务代码一行不用改。
但产物形态变了：plugin.so → plugin.bin。0.9.x 内核只会 dlopen `.so`，
本版工具链产出的 `plugin.bin` 在旧内核上根本不会被识别——
这是不可互操作的破坏性变化，故 CoreVersion 也升 1.0.0 作为**硬下限**
而非建议值。
## 删掉的死代码
ABIVersion / ABIVersionMin / CABINum / CABINumMin / 51 个 Core<Method>
整数 ID，全部无使用者：
grep -rn "CABINum" --include=*.go --include=*.tmpl . → 只有定义处
grep -rn "meta.Core[A-Z]" ... → 无
它们随 Part 6.2 删除 internal/plugin/cabi/ 就已失效：
- 整数 method id 平移为 method 名字符串（proc/protocol.go 的 Method* 常量）
- 版本协商改为握手帧里的 protocol 字段
留着有实际危害——下一个读这个文件的人会以为 C 层协商还在生效，
或者以为加 method 时要同步维护那张整数表。
## 协议版本与语义版本解耦
新注释写明：子进程 RPC 的 protocol 是独立小整数（当前 1），
只在帧格式或握手语义变化时升；语义版本变动频繁（修 bug、加字段）
不应牵动 wire 协议。这两者以前被 ABIVersion = CoreVersion 绑在一起，
现在分开。
验证：go build ./... 通过；git diff sdk/ 为空（接口冻结不变量）。
50 lines
1.9 KiB
Go
50 lines
1.9 KiB
Go
// Package meta 收集 HomeAgent SDK 的全部元数据。
|
||
// 版本号应与核心 meta.Version 保持一致。
|
||
package meta
|
||
|
||
var (
|
||
// Version 是 HomeAgent SDK 版本号。
|
||
// 通过 `-ldflags="-X gitcode.com/JianFeeeee/homeagent-sdk/meta.Version=vX.Y.Z"` 注入。
|
||
//
|
||
// 1.0.0：插件运行模型从 C ABI 动态库改为子进程 + 共享内存。
|
||
// 公开 SDK 接口（sdk/ 目录）**零改动**——插件业务代码不需要改一行，
|
||
// 但产物形态变了（plugin.so → plugin.bin），必须用新版 plugindev 重编。
|
||
Version = "1.0.0"
|
||
|
||
// Commit 是构建时的 Git commit hash。
|
||
Commit = "unknown"
|
||
|
||
// BuildTime 是构建时间。
|
||
BuildTime = "unknown"
|
||
|
||
// SDKName 是 SDK 名称。
|
||
SDKName = "HomeAgent SDK"
|
||
|
||
// CoreModule 是核心仓的 Go module path，供 plugindev 生成 go.mod 时使用。
|
||
CoreModule = "gitcode.com/JianFeeeee/HomeAgent"
|
||
|
||
// CoreVersion 是此 SDK 所兼容的最低核心版本。
|
||
//
|
||
// 1.0.0 是硬下限而非建议值：0.9.x 内核只会 dlopen `.so`，
|
||
// 本版工具链产出的 `plugin.bin` 在旧内核上根本不会被识别。
|
||
CoreVersion = "1.0.0"
|
||
)
|
||
|
||
// FullVersion 返回完整的版本字符串。
|
||
func FullVersion() string {
|
||
return SDKName + " v" + Version + " (" + Commit + ")"
|
||
}
|
||
|
||
// ---- 协议版本 ----
|
||
//
|
||
// 子进程 RPC 的协议版本是一个独立的小整数，与 SDK/内核语义版本解耦：
|
||
// 语义版本变动频繁（修 bug、加字段），而 wire 协议只在**帧格式或握手语义**
|
||
// 变化时才升。当前值见核心仓 internal/plugin/proc/protocol.go 的 ProtocolVersion。
|
||
//
|
||
// C ABI 时代的 ABIVersion / CABINum / 51 个 Core<Method> 整数 ID 已随
|
||
// Part 6.2 删除 internal/plugin/cabi/ 一并退场：
|
||
// - 整数 method id 平移为 method 名字符串（proc/protocol.go 的 Method* 常量）
|
||
// - 版本协商改为握手帧里的 protocol 字段
|
||
//
|
||
// 保留那些常量只会让人以为它们还在生效。
|