homeagent-sdk

jianf/homeagent-sdk

Fork 0

mirror of https://gitcode.com/JianFeeeee/homeagent-sdk.git synced 2026-10-01 14:53:12 +00:00

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	1d7c330cfc	fix(hmapdev): mocksdk 补齐 ToolDef 声明项，并加字段/类型一致性判据 ## 问题 mocksdk（yaegi 解释执行时的替身 SDK）的 ToolDef 只有 6 个字段，公共 SDK 已有 10 个 —— 缺 RecallPolicy / ParallelSafe / Serial。 ★ 危害不在编译期，而在调试期：插件作者用 hmapdev 在本地解释执行时，写了 ParallelSafe:true 照常跑、不报错；直到编译安装后才发现声明根本没被内核读到。这类不一致不会让任何现有测试失败。这正是"黑名单不会自动跟上新执行能力"的又一次复现：主 SDK 每加一个声明项，替身不会自动跟上。 ## 修复 ① mocksdk/plugin.go 补齐 RecallPolicy / ParallelSafe / Serial 三个字段，注释写明"主 SDK 先加、mocksdk 没跟上"这段历史，避免后人再漂移。 ② 新增 yaegi/mocksdk/parity_test.go： - TestMockSDKToolDefMatchesSDK 比对字段名集合，双向都查（少字段 = 声明静默失效；多字段 = 替身比本体还多，必有一方理解错了） - TestMockSDKToolDefTypesMatch 比对字段类型，逐个断言 ★ 归一化必须抹掉所有空白：gofmt 打印 "interface{}" 而反射给 "interface {}"，这是打印格式差异。我第一版没抹空白，结果每个复合类型都被误报成"类型不符" —— 判据自己制造假警报。判据放在 tools/hmapdev 模块内（它是独立 module，主模块不包含它），跑法：cd tools/hmapdev && go test ./yaegi/mocksdk/	2026-09-27 16:17:04 +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

1d7c330cfc

fix(hmapdev): mocksdk 补齐 ToolDef 声明项，并加字段/类型一致性判据

## 问题

mocksdk（yaegi 解释执行时的替身 SDK）的 ToolDef 只有 6 个字段，
公共 SDK 已有 10 个 —— 缺 RecallPolicy / ParallelSafe / Serial。

★ 危害不在编译期，而在**调试期**：插件作者用 hmapdev 在本地解释执行时，
写了 ParallelSafe:true 照常跑、不报错；直到编译安装后才发现声明根本没
被内核读到。这类不一致不会让任何现有测试失败。

这正是"黑名单不会自动跟上新执行能力"的又一次复现：主 SDK 每加一个声明项，
替身不会自动跟上。

## 修复

① mocksdk/plugin.go 补齐 RecallPolicy / ParallelSafe / Serial 三个字段，
   注释写明"主 SDK 先加、mocksdk 没跟上"这段历史，避免后人再漂移。

② 新增 yaegi/mocksdk/parity_test.go：
   - TestMockSDKToolDefMatchesSDK  比对**字段名**集合，双向都查
     （少字段 = 声明静默失效；多字段 = 替身比本体还多，必有一方理解错了）
   - TestMockSDKToolDefTypesMatch 比对**字段类型**，逐个断言
     ★ 归一化必须抹掉所有空白：gofmt 打印 "interface{}" 而反射给
       "interface {}"，这是打印格式差异。我第一版没抹空白，
       结果每个复合类型都被误报成"类型不符" —— 判据自己制造假警报。

判据放在 tools/hmapdev 模块内（它是独立 module，主模块不包含它），
跑法：cd tools/hmapdev && go test ./yaegi/mocksdk/

2026-09-27 16:17:04 +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