mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-09-20 08:58:03 +00:00
- 目录 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 正常
luademo
Lua 插件全功能示例,展示 v0.8.0 Lua SDK 的完整能力面:
- 工具注册:
no_memory+cleaner(记忆计算层过滤) - 阶段钩子:
register_stage(stage, handler, scope),own_tools与全局作用域 - 通道:
register_output_channel/register_input_channel(def 支持 no_memory/cleaner) - 数据类 API:
sdk.memory.*、sdk.doc.*、sdk.knowledge.*、sdk.text_memory.*、sdk.llm.*、sdk.settings.*、sdk.social.* - 其他:
register_api、set_auto_restart
本地独立测试
lua main.lua # 使用 sdk.lua mock,不依赖内核
构建
hmapdev build
安装
通过插件管理 HTTP API 上传 .hmap 包,或解压到 <data>/plugins/luademo/ 后重启内核。