mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-10-31 22:37:25 +00:00
fix(sdk): 协议通道纪律 + hmapdev 模板升级 + 示例插件 stdout 污染
## 核心缺陷:插件往 stdout 打日志 = 污染 JSON-RPC 协议通道
子进程插件与内核用 stdout 传 NDJSON 帧,stderr 才是日志通道。
脚手架模板(及 4 个示例插件)用 `fmt.Printf` 打日志 ⇒ 内核收到非 JSON 文本:
[proc] weather 收到非法 JSON 帧(21 字节): invalid character 'i'
**生产实测 1038 条**(huawei_smarthome 720 / weather 113 / rss 103 / calendar 102)。
后果不只是日志噪音:那一行日志被**丢弃**,插件看起来"没启动"。
修法:
- hmapdev 模板 `fmt.Printf` → `log.Printf`(9 处)
- 示例插件 4 个 14 处:ai_image(2) calendar(5) rss(4) weather(3)
+ 补 "log" import
- 内核侧(主仓)同步让报错可定位:内容摘要 + 可能原因 + 修法
判别法:`package main` = 子进程(协议通道,禁用 stdout 打日志);
普通库包 = 进程内插件(编译进内核,写真实终端,**不是**缺陷)——
`internal/plugins/cli` 的 `fmt.Println` 属后者。
## hmapdev
- `cmd_build.go` +136:平台产物精确匹配(`--target` 是**append** 语义,
原脚本 `ls dist/*.hmap | head -1` 会按字典序抓到 amd64,
**导致 arm64 包里装的是 x86-64 二进制**,且退出码 0、校验和通过)
- `cmd_init.go` +46:脚手架 stdio 纪律
- `templates/proc_main.go.tmpl`:补齐 mgrStop/mgrStart/mgrIsRuntimeStopped
三态能力(插件管理器运行态停启)
- `templates/plg.json.tmpl` 删除(合并进 cmd_init)
## 判据
- `scaffold_stdout_test.go`(3 条):扫模板生成的代码不得写 stdout。
★ 判据自身先假红过一次:**模板的注释里就写了 `fmt.Printf`** ⇒
必须 `stripTemplateComments()` 之后才判
- `example_stdout_test.go`(2 条):扫全部 20 个子进程示例插件,
报错给**文件:行号**;变异咬住并给出准确行号
- `package_examples_test.go`(2 条):**执行真实打包脚本**
(第一版测的是 hmapdev 而不是脚本 ⇒ 变异不咬)
- `cmd_build` / `cmd_init` 新判据
## 其他
- sdk/settings.go +15(三态能力透传)
- `docs/versions.md` +§示例插件协议通道纪律(含生产 1038 条实测表格)
- `skills/homeagent-plugin-dev/SKILL.md` +§协议通道纪律(正误代码对比)
This commit is contained in:
@ -99,7 +99,17 @@ fail=0
|
||||
failed_names=""
|
||||
|
||||
for dir in "$SDK_ROOT"/example/*/; do
|
||||
[ -f "$dir/plugin.go" ] || continue
|
||||
# ★ 入口判据:Go 插件是 plugin.go,**Lua 插件是 main.lua**。
|
||||
#
|
||||
# 原判据只有 `[ -f plugin.go ]` ⇒ **Lua 插件被静默跳过**
|
||||
# (实测:luademo 是 Lua 插件,entry=main.lua,不产 .hmap 也不报错,
|
||||
# 发版产物就少一个插件而没人发现)。改为认两种入口。
|
||||
#
|
||||
# 用 plg.json 的 entry 做最终判定更准,但**入口文件存在性**足以区分
|
||||
# "这是不是一个插件工程";真正的入口名由 hmapdev 从 plg.json 读。
|
||||
if [ ! -f "$dir/plugin.go" ] && [ ! -f "$dir/main.lua" ]; then
|
||||
continue
|
||||
fi
|
||||
name="$(basename "$dir")"
|
||||
|
||||
# 清掉旧产物:残留会让人(和本脚本)误判成功。
|
||||
@ -111,7 +121,28 @@ for dir in "$SDK_ROOT"/example/*/; do
|
||||
# 判据是**退出码 + 产物存在**,两者都要。
|
||||
# 只看退出码:hmapdev 曾经出错也退 0(已修,但脚本不该依赖它「现在」是对的)。
|
||||
# 只看产物:部分平台失败时会留下上一次的产物,看起来像成功。
|
||||
hmap="$(ls "$dir"/dist/*.hmap 2>/dev/null | head -1)"
|
||||
#
|
||||
# ★★ 必须挑**本次目标平台**的产物,不能取 `head -1`。
|
||||
#
|
||||
# ## 为什么(实测缺陷,2026-10-17)
|
||||
#
|
||||
# `--target` 的语义是**追加**(docs/guide/multi-platform.md 明确写「追加一个目标」),
|
||||
# 而示例的 plg.json 普遍声明 `targets: "linux/amd64"`。于是
|
||||
# `build --no-bundle --target linux/arm64` 会**同时**产出
|
||||
# `..._linux_amd64.hmap` 与 `..._linux_arm64.hmap`。
|
||||
#
|
||||
# 原代码取 `ls | head -1` ⇒ **按文件名字典序拿到 amd64 那份**
|
||||
# ⇒ 打 arm64 包时实际装进去的是 **x86-64 二进制**,
|
||||
# 而文件名却写着 `linux_arm64_...`(**文件名与内容不符**)。
|
||||
# 实测:arm64 产物 `plugin.bin` 的 ELF machine = 0x003e(x86-64,应为 0x00b7=aarch64)。
|
||||
# 这种包在 arm64 机器上只会以 "Exec format error" 失败,而排查方向会被文件名带偏。
|
||||
#
|
||||
# ⇒ 精确匹配 `<name>_<goos>_<goarch>.hmap`;匹配不到则视为失败(不静默退回任意产物)。
|
||||
hmap="$(ls "$dir"/dist/*_"${GOOS}_${GOARCH}".hmap 2>/dev/null | head -1)"
|
||||
if [ -z "$hmap" ]; then
|
||||
# Lua 插件的产物名是 <name>_lua.hmap(无平台后缀,Lua 不编译)。
|
||||
hmap="$(ls "$dir"/dist/*_lua.hmap 2>/dev/null | head -1)"
|
||||
fi
|
||||
if [ $rc -eq 0 ] && [ -n "$hmap" ]; then
|
||||
# 保留插件自己声明的产物名(它用的是 plg.json 的 name_en,是插件的身份),
|
||||
# 只在前面加平台前缀避免多平台互相覆盖。
|
||||
|
||||
Reference in New Issue
Block a user