homeagent-sdk

jianf/homeagent-sdk

Fork 0

mirror of https://gitcode.com/JianFeeeee/homeagent-sdk.git synced 2026-10-31 14:27:30 +00:00

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	b2872f3702	refactor(sdk)!: 废除自定协议号，版本身份只由版本号本身承载兼容性判据原有三处自造版本号，全部删除： - procProtocolVersion（模板侧握手常量） - shmVersion / shmOffVersion（共享段 header） - unifiedVersion（SuperBlock）为什么废除：语义版本变动频繁（修 bug、加字段），再要求人去升一个额外的号，那个号必然漏升而腐烂。实证：ProtocolVersion 常量在多次布局变更里只升过一次，而对应的守卫测试（TestProcTemplate_ShmLayoutMatchesKernel）长期处于失败状态无人察觉 —— 它当时期望 shmStageFieldCount=18/shmVersion=1，实际已是 19/2。取而代之的两个判据都是结构的派生事实，不需要谁记得去同步： 1. 主版本号：内核 meta.Version ↔ 插件 sdk.SDKVersion 的主版本段比对。主版本跃迁正是破坏性变更的定义（1.0.0 从 C ABI 改子进程即属此列），所以它天然是正确分界。 2. field_count：StageContext 描述符个数，决定标志位基址。顺带修正了 shmFlagsOff：原实现用本插件的编译期常量推算标志位基址，内核加字段时会静默错位。现改为从 header 读取内核下发的描述符个数。 SuperBlock 的 version 槽位保留（不动其余偏移），值不再写入也不再校验。判据：TestProcTemplate_RejectsIncompatiblePeer（含 banned 列表，防这些号被重新引入）。	2026-10-13 09:39:15 +08:00
JianFeeeee	b237787c90	refactor(toolchain)!: 工具链 plugindev 更名为 hmapdev，module path 改回 gitcode - 目录 tools/plugindev → tools/hmapdev，可执行文件名/平台产物名同步（hmapdev_linux_amd64 等；包格式仍叫 .hmap） - module path github.com/JianFeeeee/homeagent-sdk/tools/... → gitcode.com/... （与仓库实际托管一致；核心仓不依赖该 path，改动无外部影响） - SDK 存储目录 ~/.homeagent/plugindev/sdk → ~/.homeagent/hmapdev/sdk 新目录不存在而旧目录存在时沿用旧目录 → 已装 SDK 版本不会丢失 - 命令表/usage/--help/生成项目 README/示例 README/NSIS 安装器/ package/build.sh/build-examples.sh 全部同步；PLUGINDEV 环境变量保留兼容 - sdk/ 目录零改动（公开接口不变）验证： - go build ./... ok；go test ./tools/hmapdev/ ok（含模板接线守卫 TestProcTemplate_CoversAllCoreMethods） - bash -n package/{build,build-examples}.sh ok - 端到端：hmapdev init demo && hmapdev build → dist/demo_bundle.hmap（linux+darwin） - 本机安装 /usr/local/bin/hmapdev，旧名以软链保留；sdk list/current 正常	2026-09-12 12:30:20 +08:00

Author

SHA1

Message

Date

JianFeeeee

b2872f3702

refactor(sdk)!: 废除自定协议号，版本身份只由版本号本身承载

兼容性判据原有三处自造版本号，全部删除：
  - procProtocolVersion（模板侧握手常量）
  - shmVersion / shmOffVersion（共享段 header）
  - unifiedVersion（SuperBlock）

为什么废除：语义版本变动频繁（修 bug、加字段），再要求人去升一个额外的号，
那个号必然漏升而腐烂。实证：ProtocolVersion 常量在多次布局变更里只升过一次，
而对应的守卫测试（TestProcTemplate_ShmLayoutMatchesKernel）长期处于失败状态
无人察觉 —— 它当时期望 shmStageFieldCount=18/shmVersion=1，实际已是 19/2。

取而代之的两个判据都是**结构的派生事实**，不需要谁记得去同步：
  1. 主版本号：内核 meta.Version ↔ 插件 sdk.SDKVersion 的主版本段比对。
     主版本跃迁正是破坏性变更的定义（1.0.0 从 C ABI 改子进程即属此列），
     所以它天然是正确分界。
  2. field_count：StageContext 描述符个数，决定标志位基址。

顺带修正了 shmFlagsOff：原实现用本插件的编译期常量推算标志位基址，
内核加字段时会静默错位。现改为从 header 读取内核下发的描述符个数。
SuperBlock 的 version 槽位保留（不动其余偏移），值不再写入也不再校验。

判据：TestProcTemplate_RejectsIncompatiblePeer（含 banned 列表，
防这些号被重新引入）。

2026-10-13 09:39:15 +08:00

JianFeeeee

b237787c90

refactor(toolchain)!: 工具链 plugindev 更名为 hmapdev，module path 改回 gitcode

- 目录 tools/plugindev → tools/hmapdev，可执行文件名/平台产物名同步
  （hmapdev_linux_amd64 等；包格式仍叫 .hmap）
- module path github.com/JianFeeeee/homeagent-sdk/tools/... → gitcode.com/...
  （与仓库实际托管一致；核心仓不依赖该 path，改动无外部影响）
- SDK 存储目录 ~/.homeagent/plugindev/sdk → ~/.homeagent/hmapdev/sdk
  新目录不存在而旧目录存在时沿用旧目录 → 已装 SDK 版本不会丢失
- 命令表/usage/--help/生成项目 README/示例 README/NSIS 安装器/
  package/build.sh/build-examples.sh 全部同步；PLUGINDEV 环境变量保留兼容
- sdk/ 目录零改动（公开接口不变）

验证：
- go build ./... ok；go test ./tools/hmapdev/ ok（含模板接线守卫 TestProcTemplate_CoversAllCoreMethods）
- bash -n package/{build,build-examples}.sh ok
- 端到端：hmapdev init demo && hmapdev build → dist/demo_bundle.hmap（linux+darwin）
- 本机安装 /usr/local/bin/hmapdev，旧名以软链保留；sdk list/current 正常

2026-09-12 12:30:20 +08:00

2 Commits