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` +§协议通道纪律（正误代码对比）

example/qq/plugin_test.go

@@ -725,6 +725,7 @@ func TestNapcatConvertsOneBotFailureToError(t *testing.T) {
 // 与我修过的 HTTP 客户端超时是**两条不同路径**：
 //   - HTTP 超时：client.Post 返回 err（已有告警）
 //   - NapCat 超时：HTTP 200 + 响应体里带 NTEvent 字样（本次才补）
+//
 // 只报警「失败」而不说「可能已送出」，模型必重发。
 //
 // 判据必须穿过 napcat() 真实调用链（单测 isNapcatSendUnconfirmed 测不出
@@ -816,3 +817,151 @@ func TestNapcatSendActionTimeoutRegardlessOfServiceName(t *testing.T) {
 		t.Errorf("服务名不是 sendMsg 的 NTEvent 超时也要套用发送超时语义，实为 %v", err)
 	}
 }
+
+// ===========================================================================
+// 「来源标识」（comefrom）与用户权限门的关系（2026-10-16）
+//
+// 现场故障：驻留子 `dev-br-jianf-NextAgent-fix_abs-path` 自报 running 但
+// **零产出** —— 它那一轮 8 个工具（cmd_run / files_ls / notify_parent /
+// output_send__commondev_* / inputch_note …）**全部**被本插件的
+// before_toolcall 拦下。它自己的处理表原文：
+//
+//	本轮所有需要的工具都被权限策略挡下了，实测被拒的有：
+//	- cmd_run —— 无法进入工作目录、无法看 git 状态
+//
+// 日志实证（09:21:25~09:21:40，每个工具调用前都紧跟）：
+//
+//	[agent] executing tool: cmd_run (plugin=cmd)
+//	[proc] qq stage before_toolcall 改写了 1 个字段   ← 写入了拒绝响应
+//
+// 而同一时段父 main 的工具调用**有 result**、驻留子的**零 result**。
+//
+// 根因：驻留子的输入继承自父（转投刻意保留原事件），`input_source` 仍是
+// "qq"，于是本门把“父的内部委派”误当成“那位 QQ 用户新提的请求”，
+// 按用户白名单判定 ⇒ 开发工具一条都不在白名单里 ⇒ 全拒。
+// ===========================================================================
+
+// ★★★ **核心回归判据**：内部委派的工具调用**不得**被用户权限门拦。
+//
+// 这条直接覆盖现场故障：用同一份身份（非 owner）、同一个被拒工具（cmd_run），
+// 只改 comefrom 一个键 —— internal 必须放行、user 必须拦。
+func TestInternalToolCallBypassesUserPermissionGate(t *testing.T) {
+	// 基准：非 owner 私聊 ⇒ cmd_run 不在白名单 ⇒ 必须被拦
+	base := func() *sdk.StageContext {
+		ctx := toolCallContext("cmd_run", nil)
+		ctx.Extra = map[string]interface{}{}
+		return ctx
+	}
+	p := newPermissionTestPlugin(t)
+	p.auth = qqAuthContext{Active: true, UserID: 2198972886}
+	ctxUser := base()
+	if err := p.beforeToolcall(ctxUser); err != nil {
+		t.Fatal(err)
+	}
+	if ctxUser.Response == nil {
+		t.Fatal("前置条件错：非 owner 调 cmd_run 本应被拦（判据基线不成立）")
+	}
+
+	// ① comefrom=internal（驻留子）⇒ 必须放行
+	p2 := newPermissionTestPlugin(t)
+	p2.auth = qqAuthContext{Active: true, UserID: 2198972886}
+	ctxInternal := base()
+	ctxInternal.Extra[extraKeyComeFrom] = "internal"
+	if err := p2.beforeToolcall(ctxInternal); err != nil {
+		t.Fatal(err)
+	}
+	if ctxInternal.Response != nil {
+		t.Fatalf("★ 内部委派的 cmd_run 仍被用户权限门拦住（缺陷回归）: %s", *ctxInternal.Response)
+	}
+
+	// ② 硬私有工具同样放行（驻留子是父的内部执行体，父本就有完整权限）
+	p3 := newPermissionTestPlugin(t)
+	p3.auth = qqAuthContext{Active: true, UserID: 2198972886}
+	ctxHard := toolCallContext("memory_recall", nil)
+	ctxHard.Extra = map[string]interface{}{extraKeyComeFrom: "internal"}
+	if err := p3.beforeToolcall(ctxHard); err != nil {
+		t.Fatal(err)
+	}
+	if ctxHard.Response != nil {
+		t.Fatalf("★ 内部委派的硬私有工具被拦: %s", *ctxHard.Response)
+	}
+}
+
+// ★★★ 判据：**只有**明确 "internal" 才放行 —— 其余一律按用户处理。
+//
+// 这个方向绝不能反：把用户请求误判成 internal = 权限门整体失效，
+// 比"多拦一次内部调用"严重得多。
+func TestComeFromOnlyInternalIsTrusted(t *testing.T) {
+	for _, tc := range []struct {
+		name    string
+		setup   func(m map[string]interface{})
+		trusted bool
+	}{
+		{"internal", func(m map[string]interface{}) { m[extraKeyComeFrom] = "internal" }, true},
+		{"user", func(m map[string]interface{}) { m[extraKeyComeFrom] = "user" }, false},
+		{"缺失（旧内核）", func(m map[string]interface{}) {}, false},
+		{"空串", func(m map[string]interface{}) { m[extraKeyComeFrom] = "" }, false},
+		{"未知取值", func(m map[string]interface{}) { m[extraKeyComeFrom] = "internal-ish" }, false},
+		{"大小写不同", func(m map[string]interface{}) { m[extraKeyComeFrom] = "INTERNAL" }, false},
+		{"类型错（bool）", func(m map[string]interface{}) { m[extraKeyComeFrom] = true }, false},
+		{"类型错（数字）", func(m map[string]interface{}) { m[extraKeyComeFrom] = 1.0 }, false},
+	} {
+		t.Run(tc.name, func(t *testing.T) {
+			p := newPermissionTestPlugin(t)
+			p.auth = qqAuthContext{Active: true, UserID: 2198972886}
+			ctx := toolCallContext("cmd_run", nil)
+			ctx.Extra = map[string]interface{}{}
+			tc.setup(ctx.Extra)
+			if err := p.beforeToolcall(ctx); err != nil {
+				t.Fatal(err)
+			}
+			blocked := ctx.Response != nil
+			if tc.trusted && blocked {
+				t.Errorf("★ 应放行却拦了: %s", *ctx.Response)
+			}
+			if !tc.trusted && !blocked {
+				t.Error("★ 应拦却放行了（权限门失效）")
+			}
+		})
+	}
+}
+
+// ★★★ 判据：**owner 的请求行为不变**（comefrom=user 时不得因为改动而放宽）。
+//
+// 防的是"为了让驻留子通过，把门整体放松"这类错误修法。
+func TestComeFromUserKeepsOwnerAndNonOwnerSemantics(t *testing.T) {
+	// owner + comefrom=user ⇒ 完整放行（含硬私有）
+	p := newPermissionTestPlugin(t)
+	p.auth = qqAuthContext{Active: true, Owner: true, UserID: 2198972886}
+	ctx := toolCallContext("calendar_list", nil)
+	ctx.Extra = map[string]interface{}{extraKeyComeFrom: "user"}
+	if err := p.beforeToolcall(ctx); err != nil {
+		t.Fatal(err)
+	}
+	if ctx.Response != nil {
+		t.Fatalf("★ owner 的请求被拦（权限门被收紧了）: %s", *ctx.Response)
+	}
+
+	// 非 owner + comefrom=user + 硬私有 ⇒ 仍必须拒
+	p2 := newPermissionTestPlugin(t)
+	p2.auth = qqAuthContext{Active: true, UserID: 10001}
+	ctx2 := toolCallContext("calendar_list", nil)
+	ctx2.Extra = map[string]interface{}{extraKeyComeFrom: "user"}
+	if err := p2.beforeToolcall(ctx2); err != nil {
+		t.Fatal(err)
+	}
+	if ctx2.Response == nil {
+		t.Fatal("★ 非 owner 的硬私有调用应仍被拒（改动把门放松了）")
+	}
+
+	// 无身份（auth.Active=false）+ 有 comefrom=user ⇒ 本门不介入（旧行为）
+	p3 := newPermissionTestPlugin(t)
+	ctx3 := toolCallContext("cmd_run", nil)
+	ctx3.Extra = map[string]interface{}{extraKeyComeFrom: "user"}
+	if err := p3.beforeToolcall(ctx3); err != nil {
+		t.Fatal(err)
+	}
+	if ctx3.Response != nil {
+		t.Fatalf("非本插件来源不该被本门拦: %s", *ctx3.Response)
+	}
+}