mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-21 01:18:08 +00:00
dc80855540
选了 AGPL-3.0-only 之后，§13（Remote Network Interaction）就不只是声明问题： 把修改过的版本作为网络服务提供出去时，必须给使用者取得 Corresponding Source 的机会。 只在仓库里放 LICENSE 并不自动满足这一条——**使用者拿到的是服务，不是仓库**。 所以把它做进产品里，而不是写进文档就算完： - `internal/meta.SourceURL`：本次构建对应的源码地址，默认指向本仓库。 注释里写明「修改后对外部署的分支必须改指向自己的仓库」，并给出 -ldflags 覆盖方式 （`-X .../internal/meta.SourceURL=<你的仓库>`），不需要改源码。 - `BuildStatus.SourceURL`（`json:"source_url,omitempty"`）+ 内核状态填充： 走已有的 `/api/v1/kernel` 构建身份链路，不新增端点。 - WebUI 状态页在「版本」行下渲染「源码 / Source」链接（URL 经 escHtml 转义后进属性； `target="_blank" rel="noopener noreferrer"`）。 - 用 `omitempty`：未注入该值的旧构建不会在 JSON 里多出一个空字段。 验证： - `internal/plugins/webui/dashboard.html` 的两个内联 script 块 `node --check` 均通过； - 全仓库 `go build ./...` 通过，`internal/meta/meta.go` gofmt 干净 （`internal/agent/core/status.go` 有**既有**的 gofmt 差异，与本改动无关，按纪律未整体重排）； - 端到端：本地构建 homed → 冷启动 → `GET /api/v1/kernel` 的 `build.source_url` 实测为 `https://gitcode.com/JianFeeeee/HomeAgent`。
78 lines
3.9 KiB
Go
78 lines
3.9 KiB
Go
// Package meta 收集 HomeAgent 内核的全部元数据。
|
||
// 版本号通过 `go build -ldflags` 注入，默认值为 dev 版本。
|
||
// SDK 仓的 meta/meta.go 应与此保持同步。
|
||
package meta
|
||
|
||
var (
|
||
// Version 是 HomeAgent 内核版本号。
|
||
// 通过 `-ldflags="-X gitcode.com/JianFeeeee/HomeAgent/internal/meta.Version=vX.Y.Z"` 注入。
|
||
//
|
||
// 1.0.0：外部插件从 C ABI 动态库迁到子进程 + 共享内存。
|
||
// 这是首个不再加载 `.so`/`.dll` 的版本，与 0.9.x 不兼容（存量插件必须
|
||
// 用新版 plugindev 重编），故跃到主版本号。
|
||
// 1.1.0：记忆系统支持二进制多媒体节点——CAS 媒体存储 + L0/L2/L3 贯通。
|
||
// 1.1.1：多模态贯通**插件边界**。内核实现公开 SDK 1.1.0 新增的媒体接口
|
||
// （doc.insertWithMedia、io.injectMedia / injectMediaSync /
|
||
// injectInterruptMedia），并把 text/image/audio 三条输入路径归一成
|
||
// 一条 processInput 主干。
|
||
// 1.2.0：模型中立的多模态 provider SPI（pkg/embedding）——内核不再适配任何
|
||
// 具体模型，Qwen 实现移到 providers/qwen3vl；插件运行协议升到 2
|
||
// （统一共享内存区，fd3 布局改变，不支持滚动升级）；并实现 SDK 1.2.0
|
||
// 新增的注入行为标志位（InjectOptions：no_memory / context_policy）
|
||
// 与 ChannelDef.ContextPolicy，使输入/排队注入/中断注入/同步注入都能
|
||
// 声明「是否记入记忆」与「是否据此裁剪上下文」（默认都是否）。
|
||
//
|
||
// ❗main 上此值始终是**下一个未发布中版本**，不随 patch 发布变动
|
||
//（见 docs/git-branching.md §2.1）；已发布的版本号看对应的 release/vX.Y.x 与 tag。
|
||
Version = "1.3.0"
|
||
|
||
// Commit 是构建时的 Git commit hash。
|
||
Commit = "unknown"
|
||
|
||
// BuildTime 是构建时间。
|
||
BuildTime = "unknown"
|
||
|
||
// KernelName 是内核名称。
|
||
KernelName = "HomeAgent"
|
||
|
||
// SDKCompatibleVersion 是此内核可兼容的最高 SDK 版本（semver）。
|
||
//
|
||
// 1.1.0：本内核实现了 SDK 1.1.0 的全部新增方法。
|
||
// 1.2.0：本内核实现了 SDK 1.2.0 的全部新增方法（IOInjector 的六个 *Opts
|
||
// 注入变体、InjectOptions、ChannelDef.ContextPolicy），因此声明为
|
||
// 1.2.0。用 SDK 1.0.0/1.1.0 编的存量插件照旧可用——新增方法由
|
||
// **插件调用、内核实现**，不调就不受影响，无需重编。
|
||
SDKCompatibleVersion = "1.2.0"
|
||
|
||
// SourceURL 是本内核构建所对应的源码地址。
|
||
//
|
||
// AGPL-3.0 §13（Remote Network Interaction）要求：当你把修改过的版本
|
||
// 作为网络服务提供出去时，必须给使用者提供取得 Corresponding Source 的机会。
|
||
// WebUI 的状态页会把这个值渲染成可见链接，所以：
|
||
//
|
||
// ❗**修改后对外部署的分支必须把它改指向自己的源码仓库**，否则链接指向的
|
||
// 不是你实际运行的那份代码，§13 的提供义务并未履行。
|
||
//
|
||
// 构建时可用 -ldflags 覆盖，无需改源码：
|
||
// -X gitcode.com/JianFeeeee/HomeAgent/internal/meta.SourceURL=<你的仓库>
|
||
SourceURL = "https://gitcode.com/JianFeeeee/HomeAgent"
|
||
)
|
||
|
||
// FullVersion 返回完整的版本字符串。
|
||
func FullVersion() string {
|
||
return KernelName + " v" + Version + " (" + Commit + ")"
|
||
}
|
||
|
||
// ---- 协议版本 ----
|
||
//
|
||
// 子进程 RPC 的协议版本是一个独立的小整数，与内核语义版本解耦：
|
||
// 语义版本变动频繁（修 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 字段
|
||
//
|
||
// 保留那些常量只会让人以为它们还在生效。
|