mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-01 06:47:29 +00:00
3f834794c5
## 为什么必须做
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` 无差异
26 lines
1.0 KiB
Go
26 lines
1.0 KiB
Go
package sdk
|
|
|
|
import pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
|
|
|
|
// SettingsAPI 是内置插件使用的全量配置接口。
|
|
type SettingsAPI interface {
|
|
pubsdk.SettingsAPI
|
|
// DefsCore 返回核心配置表中匹配前缀的配置定义。
|
|
DefsCore(prefix string) []*ConfigDef
|
|
// DefsPlugin 返回另一个插件的配置定义。
|
|
DefsPlugin(plugin, prefix string) []*ConfigDef
|
|
// Remove 删除本插件配置中的单个键（插件删除时清理自身配置用）。
|
|
Remove(key string) error
|
|
// RemoveCore 删除核心配置表中的单个键。
|
|
RemoveCore(key string) error
|
|
// RemovePlugin 删除另一个插件配置表中的单个键。
|
|
RemovePlugin(plugin, key string) error
|
|
// IsSecret 报告某个（全局或 "plugin.<name>." 前缀的）键是否敏感。
|
|
//
|
|
// 用途：需要在**展示**环节屏蔽明文的地方（如 WebUI 设置面）。
|
|
// 它与落盘加密共用同一套判定，避免“已加密但界面照旧显示”的漏洞。
|
|
IsSecret(key string) bool
|
|
}
|
|
|
|
type ConfigDef = pubsdk.ConfigDef
|