refactor: SDK module 路径统一改为 hologramagentsdk(59 文件 + go.mod)

## 为什么必须做

SDK 仓(独立仓库)已把 module 从 `github.com/JianFeeeee/homeagentsdk`
改名为 `hologramagentsdk`。主仓通过 `replace` 直接引用它的**物理目录**:

    replace github.com/JianFeeeee/homeagentsdk => ./third_party/homeagent-sdk

一旦 SDK 侧改成新 module 名,主仓立刻炸:

    go: ./third_party/homeagent-sdk@ used for two different module paths
        (github.com/JianFeeeee/hologramagentsdk and github.com/JianFeeeee/homeagentsdk)

Go **不允许**同一目录被两个 module 路径 replace。所以不能"新旧并存",
只能把主仓 59 个文件的 import 全部改到新名,并删掉旧 replace。

## 一个被证伪的前提

我最初按"third_party/homeagent-sdk 是独立仓库,不能在此仓修改其源码"
来处理,并因此判断两个仓的改动可以隔离。实际上主仓是靠 `replace` 指向
该目录的物理副本 —— **两个仓的改动不可能真正隔离**:SDK 侧改 module 名,
主仓必然跟着改 import。

这个前提应该在做任何改动之前用 `go list -m` 验证,而不是假设。

## 连带修掉两处

| 缺陷 | 性质 |
|---|---|
| `TestLuaSDKMockSingleSource` 失败 | SDK 的 `sdk/lua/sdk.lua` 变了,主仓内嵌副本未同步(跑 `scripts/sync-lua-sdk.sh` 修复) |
| `sdkModuleNames` 分散两处 | 已在 SDK 仓合并为单一数据源(见 SDK 仓 725732b) |

第一条是**副本一致性判据抓到的**,不是我自己发现的 —— 这类判据的价值在此:
两个仓必然有副本,靠人记住"改了 A 要同步 B"是做不到的。

## 验证

- `go build ./...` / `go vet ./...` 干净
- `go test ./... -count=1`:**58 包 0 失败**
- `internal/plugin`(Lua SDK 副本一致性)+ `internal/sdk` 全绿
- 主仓 `third_party/homeagent-sdk/` 与 SDK 仓 `main` 无差异
This commit is contained in:
JianFeeeee
2026-10-22 23:28:23 +08:00
parent 6327578693
commit 3f834794c5
61 changed files with 77 additions and 70 deletions

View File

@ -7,7 +7,7 @@ import (
"strings"
"testing"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// 子进程架构的性能基准(Part 6.6 验收项)。

View File

@ -5,7 +5,7 @@ import (
"encoding/json"
"fmt"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// coreHandler 把插件发来的 RPC 调用路由到内核 PluginSDK。

View File

@ -5,7 +5,7 @@ import (
"fmt"
"github.com/JianFeeeee/HologramAgent/internal/knowledge"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// handleGraphMemory 处理图记忆(实体/关系):recall / commit / introspect / merge / purge。

View File

@ -4,7 +4,7 @@ import (
"encoding/json"
"fmt"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// handleRegister 处理注册面:工具 / stage / 输出通道 / 插件 API / 入站通道。

View File

@ -4,7 +4,7 @@ import (
"encoding/json"
"fmt"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// handlePluginMgr 处理插件管理:reloadOne / listLoaded / isDisabled。

View File

@ -22,7 +22,7 @@ import (
"encoding/json"
"fmt"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
func (h *coreHandler) secrets(method string, params json.RawMessage) (interface{}, error) {

View File

@ -4,7 +4,7 @@ import (
"encoding/json"
"fmt"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// handleSettings 处理全部设置项读写(14 个 method 共用一条实现)。

View File

@ -24,7 +24,7 @@ import (
internalConfig "github.com/JianFeeeee/HologramAgent/internal/config"
internalSDK "github.com/JianFeeeee/HologramAgent/internal/sdk"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// secretE2EPlugin 是一个**用真实模板**编译的插件:它只做两件事 ——
@ -32,7 +32,7 @@ import (
const secretE2EPlugin = `package main
import (
sdk "github.com/JianFeeeee/homeagentsdk/sdk"
sdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
type secretPlugin struct{ name string }

View File

@ -29,14 +29,14 @@ import (
internalConfig "github.com/JianFeeeee/HologramAgent/internal/config"
internalSDK "github.com/JianFeeeee/HologramAgent/internal/sdk"
internalSecurity "github.com/JianFeeeee/HologramAgent/internal/security"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// secretsE2EPlugin 用真实模板编译:只做变量库往返。
const secretsE2EPlugin = `package main
import (
sdk "github.com/JianFeeeee/homeagentsdk/sdk"
sdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
type secPlugin struct{ name string }

View File

@ -7,7 +7,7 @@ import (
"strings"
"testing"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// 端到端:用**真实 hmapdev 模板**编译的插件,经内核 proc 通道加载运行。
@ -25,7 +25,7 @@ const e2ePluginSource = `package main
import (
"strings"
sdk "github.com/JianFeeeee/homeagentsdk/sdk"
sdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
type e2ePlugin struct{ name string }
@ -148,8 +148,8 @@ func buildPluginWithRealTemplate(t *testing.T, businessCode string) string {
}
mustWriteFile(t, filepath.Join(dir, "go.mod"),
"module e2eplugin\n\ngo 1.25\n\n"+
"require github.com/JianFeeeee/homeagentsdk v0.9.2\n\n"+
"replace github.com/JianFeeeee/homeagentsdk => "+sdkPath+"\n")
"require github.com/JianFeeeee/hologramagentsdk v0.9.2\n\n"+
"replace github.com/JianFeeeee/hologramagentsdk => "+sdkPath+"\n")
bin := filepath.Join(dir, "plugin.bin")
cmd := exec.Command("go", "build", "-o", bin, ".")
@ -241,7 +241,7 @@ func TestE2E_RealTemplatePluginFullLifecycle(t *testing.T) {
func TestE2E_RealTemplateReadOnlyPluginDoesNotOverwrite(t *testing.T) {
const readerSource = `package main
import sdk "github.com/JianFeeeee/homeagentsdk/sdk"
import sdk "github.com/JianFeeeee/hologramagentsdk/sdk"
type readerPlugin struct{ name string }

View File

@ -9,7 +9,7 @@ import (
"time"
safeclose "github.com/JianFeeeee/HologramAgent/internal/safeclose"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// ---- 事件类型编码(编译时确定,与 pubsdk.EventType 一一对应)----

View File

@ -21,7 +21,7 @@ import (
"encoding/json"
"testing"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
func newTestSeg(t *testing.T) *Segment {

View File

@ -45,7 +45,7 @@ import (
"os/exec"
"time"
sdk "github.com/JianFeeeee/homeagentsdk/sdk"
sdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
type gcPlugin struct{ name string }
@ -378,7 +378,7 @@ import (
"syscall"
"time"
sdk "github.com/JianFeeeee/homeagentsdk/sdk"
sdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
type gcPlugin struct{ name string }

View File

@ -8,7 +8,7 @@ import (
"sync"
"sync/atomic"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// Host 持有**被全部子进程插件共享的统一内存区域**,是共享数据面的

View File

@ -5,7 +5,7 @@ import (
"testing"
"time"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// TestHost_CloseWaitsForInflightStage 钉死不变量:

View File

@ -4,7 +4,7 @@ import (
"sync/atomic"
"testing"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// stubSubscriber 是最小 EvtRingSubscriber 实现,用于验证「关停时统一退订」。

View File

@ -5,7 +5,7 @@ import (
"sync/atomic"
"testing"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// 本文件是 2026-09-04 06:56:18 线上 crash 的回归测试。

View File

@ -10,7 +10,7 @@ import (
"sync/atomic"
"time"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// Plugin 是 registry 可加载的子进程插件,与内置插件同构的启停接口。

View File

@ -8,7 +8,7 @@ import (
"sync"
"testing"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// 端到端验证:内核 RunStage 并发扇出 → 真实子进程插件经共享内存读改写 → 结果回读。

View File

@ -9,7 +9,7 @@ package proc
import (
"testing"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
func TestClampExternalPriority_RejectsL4(t *testing.T) {

View File

@ -22,7 +22,7 @@ import (
"strings"
"testing"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// profileCtx 构造一组「接近真实」的 StageContext。

View File

@ -6,7 +6,7 @@ import (
"sync"
"testing"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// 本文件验证共享内存 stage 并发的正确性——**整个迁移最关键的一环**(§4.4 风险 3.4)。

View File

@ -4,7 +4,7 @@ import (
"encoding/json"
"fmt"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// StageContext 的跨进程编解码(§3.3 数据面 / §3.4 SDK 封装全部复杂度)。

View File

@ -7,7 +7,7 @@ import (
"sync"
"time"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// stage 执行:把内核的 RunStage 并发扇出接到共享段(§3.4,风险 3.4 的落点)。

View File

@ -6,7 +6,7 @@ import (
"testing"
"time"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// qq 插件「重复申请 stage 锁」的生产诊断与修复(2026-10-07)

View File

@ -6,7 +6,7 @@ import (
"testing"
"time"
pubsdk "github.com/JianFeeeee/homeagentsdk/sdk"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
// 流式输出压测(§4.3 标记「风险高」的那一项)。