mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-21 17:38:10 +00:00
b15d0bd114
工具链在 SDK 1.2.0 更名为 hmapdev（原 plugindev）。核心侧三处功能耦合同步：
1. 用户可见报错：旧 C ABI 产物 / 协议版本不匹配 / 共享段版本不匹配
三处「请用配套 plugindev 重编」→ hmapdev（对应两条测试断言同步）
2. e2e_template_test 的模板路径改为 tools/hmapdev/templates，
并保留旧路径回退（旧 SDK 检出仍能跑测试）
3. 注释与文档同步
文档更新（用户可见面）：
- assets/docs/{zh,en}/PLUGIN_DEV.md：工具链章节整体改为 hmapdev，
补改名说明与 SDK 存储目录迁移；命令示例全部更新
- assets/docs/{zh,en}/ARCHITECTURE.md：**流程图与章节对齐 v1.2.0** ——
· 向量化章节改为三层降级：统一多模态空间（主）→ 词嵌入 → TF-IDF（回退），
写明「同指纹且同维度才参与融合」
· 媒体记忆章节重写：媒体是一等记忆块（无独立 GC / 无引用计数 / 无描述式索引 /
正文不再写 media marker），并写明 reembedStaleMedia 的跨空间迁移与写回
- README{,_EN}.md、docs/zh/plugin-interface-matrix.md：工具名与模板路径同步
（历史条目标注「当时名为 plugindev」）
验证：go test ./internal/plugin/ ./internal/plugin/proc/ ok，
含 4 条真实模板 E2E（模板路径切换后仍通过）。
45 lines
2.4 KiB
Go
45 lines
2.4 KiB
Go
//go:build windows
|
||
|
||
package main
|
||
|
||
import (
|
||
"fmt"
|
||
"os"
|
||
)
|
||
|
||
// requireSupportedPlatform 在原生 Windows 上直接拒绝启动 homed。
|
||
//
|
||
// 为什么不做原生支持（不是「还没来得及做」，是设计上不做）：
|
||
//
|
||
// homed 的插件体系建立在两个原语上——**继承的 fd**（Single memfd: 统一共享
|
||
// 内存区 + eventfd 通知）与**同段内相对偏移解引用**（各进程 mmap 到不同虚拟
|
||
// 基址，段内一律用偏移互相读写，这样插件回调才能就地改写内核看到的那份数据）。
|
||
//
|
||
// Windows 的等价物是命名内核对象（CreateFileMappingW / OpenEventW）＋句柄表，
|
||
// 没有 fd 继承语义（os/exec 的 ExtraFiles 在 Windows 上直接不被支持），
|
||
// 生命周期与权限模型也按句柄而非进程继承来组织。要在其上重建这套语义，
|
||
// 等于再维护一套平台专属 ABI 与安全边界——而 C ABI 时代正是「三套 ABI 并存
|
||
// 导致改写型插件在某个平台上静默失效」的教训（§9.2）。
|
||
//
|
||
// 所以选择：**原生 Windows 不提供 homed**。Windows 用户跑 WSL2——
|
||
// WSL2 里就是普通 linux/amd64，走与我们测试矩阵完全相同的那条路径。
|
||
//
|
||
// 注意范围：只有 homed 如此。hmapdev 工具链仍可在 Windows 上运行
|
||
// （在 Windows 上开发、为 WSL 构建 linux 插件是合理工作流）。
|
||
func requireSupportedPlatform() {
|
||
fmt.Fprintln(os.Stderr, "homed 不支持 Windows 原生运行。")
|
||
fmt.Fprintln(os.Stderr, "")
|
||
fmt.Fprintln(os.Stderr, "原因：子进程插件依赖 fd 继承 + 统一共享内存区的段内偏移解引用，")
|
||
fmt.Fprintln(os.Stderr, "而 Windows 的句柄模型无法表达这两者；强行适配等于再维护一套平台专属")
|
||
fmt.Fprintln(os.Stderr, "ABI——C ABI 时代三套 ABI 并存曾导致改写型插件在某个平台上静默失效。")
|
||
fmt.Fprintln(os.Stderr, "")
|
||
fmt.Fprintln(os.Stderr, "请改用 WSL2：")
|
||
fmt.Fprintln(os.Stderr, " 1. wsl --install -d Ubuntu # 安装 WSL2")
|
||
fmt.Fprintln(os.Stderr, " 2. 在 WSL 内下载 linux/amd64 的 homed 与插件（.hmap）")
|
||
fmt.Fprintln(os.Stderr, " 3. 在 WSL 内运行 homed：与 Linux 主机完全相同，无需额外配置")
|
||
fmt.Fprintln(os.Stderr, "")
|
||
fmt.Fprintln(os.Stderr, "数据目录可放在 /mnt/c/... 下以便与 Windows 侧共享，")
|
||
fmt.Fprintln(os.Stderr, "但不建议（跨文件系统 IO 慢、inotify 语义受限）；推荐放在 WSL 内部路径。")
|
||
os.Exit(2)
|
||
}
|