fix(plugindev): stage 回传改 diff，只回传变更字段，修复 lost update（plan 11.3）

根因：go_invoke_stage 无条件回传 stageContextWritable 全部字段（含插件从内核收到
的旧快照），sanitizer(改ToolResults)+weather(只读) 并发时，只读插件把自己收到的
旧快照覆盖回清洗结果（实验13 实测丢失率 1.6~4.3%，脏数据进LLM）。

改动：
- templates.go: 新增 snapshotWritable（handler 前的序列化快照）+ changedFieldsOnly（只回传差异字段）
  go_invoke_stage 改为 before 快照 → handler → diff 回传，无变更零回传
- ❗关键陷阱（第一版踩坑）：stageContextWritable 的切片字段与 sc 共享底层数组，
  handler 原地改元素时 before 快照跟着变，diff 失效——故 before 必须序列化成字符串
- stagediff_test.go: 6 用例（只读零回传/原地改切片/标量改/新response/清空切片/现网场景复刻）

⚠️ 需用新 plugindev 重编全部 17 个外部插件（bridge 模板变更）

tools/plugindev/stagediff_test.go

@@ -0,0 +1,247 @@
+package main
+
+import (
+	"encoding/json"
+	"testing"
+
+	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+)
+
+// 本测试验证 tmplLinuxBridge 中 snapshotWritable + changedFieldsOnly 的语义（plan.md 11.3）。
+// 模板字符串本身无法直接单测，这里以同一份逻辑复刻，防止回归。
+// ❗ 模板与本文件须同步修改。
+//
+// 关键陷阱（第一版实现踩过）：stageContextWritable 返回的切片字段与 sc 共享底层数组，
+// handler 原地改元素时"before 快照"会跟着变，diff 看不到变更 → 修复静默失效。
+// 故 before 必须是**序列化后的字符串快照**。
+
+func writable(sc *sdk.StageContext) map[string]interface{} {
+	m := map[string]interface{}{
+		"raw_message": sc.RawMessage,
+		"user_id":     sc.UserID,
+		"group_id":    sc.GroupID,
+		"phase":       string(sc.Phase),
+		"llm_text":    sc.LLMText,
+		"final_text":  sc.FinalText,
+		"no_memory":   sc.NoMemory,
+	}
+	if sc.Response != nil {
+		m["response"] = *sc.Response
+	}
+	if len(sc.ToolCalls) > 0 {
+		m["tool_calls"] = sc.ToolCalls
+	}
+	if len(sc.ToolResults) > 0 {
+		m["tool_results"] = sc.ToolResults
+	}
+	return m
+}
+
+// snapshot 对应模板里的 snapshotWritable：逐字段序列化为不可变快照。
+func snapshot(sc *sdk.StageContext) map[string]string {
+	snap := map[string]string{}
+	for k, v := range writable(sc) {
+		b, err := json.Marshal(v)
+		if err != nil {
+			continue
+		}
+		snap[k] = string(b)
+	}
+	return snap
+}
+
+// diffOnly 对应模板里的 changedFieldsOnly。
+func diffOnly(before map[string]string, after map[string]interface{}) map[string]interface{} {
+	diff := map[string]interface{}{}
+	keys := map[string]bool{}
+	for k := range before {
+		keys[k] = true
+	}
+	for k := range after {
+		keys[k] = true
+	}
+	for k := range keys {
+		bRaw, bHas := before[k]
+		a, aHas := after[k]
+		switch {
+		case aHas && !bHas:
+			diff[k] = a
+		case aHas && bHas:
+			ab, _ := json.Marshal(a)
+			if bRaw != string(ab) {
+				diff[k] = a
+			}
+		case bHas && !aHas:
+			switch k {
+			case "tool_calls":
+				diff[k] = []sdk.ToolCall{}
+			case "tool_results":
+				diff[k] = []sdk.ToolResult{}
+			}
+		}
+	}
+	return diff
+}
+
+// 只读插件（如 weather 的 AfterToolcall）不改任何字段 → 零回传。
+// 这是修复 lost update 的关键：旧实现会回传它收到的旧快照，覆盖 sanitizer 的清洗结果。
+func TestChangedFieldsOnly_ReadOnlyPluginReturnsNothing(t *testing.T) {
+	sc := &sdk.StageContext{
+		RawMessage: "hello",
+		LLMText:    "world",
+		ToolResults: []sdk.ToolResult{
+			{CallID: "c1", Name: "weather_query", Success: true, Result: "已清洗结果"},
+		},
+	}
+	before := snapshot(sc)
+	// 只读 handler：读了但没改
+	_ = sc.ToolResults[0].Result
+	diff := diffOnly(before, writable(sc))
+
+	if len(diff) != 0 {
+		t.Fatalf("只读插件应零回传，实际回传 %d 个字段: %v", len(diff), diff)
+	}
+}
+
+// 改写插件（如 sanitizer 改 ToolResults）→ 只回传被改的字段。
+// ⚠️ 这里是原地改切片元素，正是共享底层数组陷阱的触发场景。
+func TestChangedFieldsOnly_WriterReturnsOnlyChanged(t *testing.T) {
+	sc := &sdk.StageContext{
+		RawMessage: "hello",
+		LLMText:    "world",
+		ToolResults: []sdk.ToolResult{
+			{CallID: "c1", Name: "weather_query", Success: true, Result: "带\x1b[31mANSI\x1b[0m脏数据"},
+		},
+	}
+	before := snapshot(sc)
+	// sanitizer handler：原地清洗 ToolResults
+	sc.ToolResults[0].Result = "带ANSI脏数据"
+	diff := diffOnly(before, writable(sc))
+
+	if len(diff) != 1 {
+		t.Fatalf("应只回传 tool_results 一个字段，实际 %d 个: %v", len(diff), diff)
+	}
+	if _, ok := diff["tool_results"]; !ok {
+		t.Fatalf("回传字段应为 tool_results，实际 %v", diff)
+	}
+	// raw_message / llm_text 未改，不应出现（否则会覆盖其他插件的改写）
+	if _, ok := diff["raw_message"]; ok {
+		t.Error("raw_message 未改却被回传（会覆盖其他插件的改写）")
+	}
+	if _, ok := diff["llm_text"]; ok {
+		t.Error("llm_text 未改却被回传")
+	}
+}
+
+// 改写标量字段（如 before_output 改 FinalText）→ 只回传该字段。
+func TestChangedFieldsOnly_ScalarChange(t *testing.T) {
+	sc := &sdk.StageContext{
+		RawMessage: "hi",
+		FinalText:  "  带空白的回复  ",
+		LLMText:    "原始",
+	}
+	before := snapshot(sc)
+	sc.FinalText = "带空白的回复"
+	diff := diffOnly(before, writable(sc))
+
+	if len(diff) != 1 || diff["final_text"] != "带空白的回复" {
+		t.Fatalf("应只回传 final_text，实际 %v", diff)
+	}
+}
+
+// 首次设置 response（短路）→ 回传。
+func TestChangedFieldsOnly_NewResponseIsReturned(t *testing.T) {
+	sc := &sdk.StageContext{RawMessage: "hi"}
+	before := snapshot(sc)
+	resp := "被插件短路"
+	sc.Response = &resp
+	diff := diffOnly(before, writable(sc))
+
+	if v, ok := diff["response"]; !ok || v != "被插件短路" {
+		t.Fatalf("新设置的 response 应回传，实际 %v", diff)
+	}
+}
+
+// 清空切片字段 → 显式回传空值让内核跟随。
+func TestChangedFieldsOnly_ClearedSliceIsReturnedAsEmpty(t *testing.T) {
+	sc := &sdk.StageContext{
+		ToolCalls: []sdk.ToolCall{{ID: "t1", Name: "cmd_run"}},
+	}
+	before := snapshot(sc)
+	sc.ToolCalls = nil // 插件拒绝了全部工具调用
+	diff := diffOnly(before, writable(sc))
+
+	v, ok := diff["tool_calls"]
+	if !ok {
+		t.Fatalf("清空 tool_calls 应显式回传空值，实际 %v", diff)
+	}
+	if arr, _ := v.([]sdk.ToolCall); len(arr) != 0 {
+		t.Fatalf("应回传空切片，实际 %v", v)
+	}
+}
+
+// 复刻现网场景（实验 13）：sanitizer 清洗后 weather 只读回传，清洗结果不得被覆盖。
+// 旧实现下 weather 会回传自己收到的旧快照（含脏数据），覆盖 sanitizer 的清洗（丢失率 1.6~4.3%）。
+func TestChangedFieldsOnly_ProductionScenarioNoOverwrite(t *testing.T) {
+	dirty := "天气：晴 \x1b[31m28°C\x1b[0m"
+	clean := "天气：晴 28°C"
+
+	// 内核下发的原始快照（两插件各拿到一份副本）
+	kernelSnapshot := map[string]interface{}{
+		"raw_message":  "查天气",
+		"llm_text":     "",
+		"final_text":   "",
+		"user_id":      "u1",
+		"group_id":     "",
+		"phase":        "after_toolcall",
+		"no_memory":    false,
+		"tool_results": []sdk.ToolResult{{CallID: "c1", Name: "weather_query", Result: dirty}},
+	}
+
+	// sanitizer 副本：清洗
+	scSan := &sdk.StageContext{
+		RawMessage:  "查天气",
+		UserID:      "u1",
+		Phase:       sdk.StageAfterToolcall,
+		ToolResults: []sdk.ToolResult{{CallID: "c1", Name: "weather_query", Result: dirty}},
+	}
+	beforeSan := snapshot(scSan)
+	scSan.ToolResults[0].Result = clean
+	diffSan := diffOnly(beforeSan, writable(scSan))
+
+	// weather 副本：只读，不改
+	scWea := &sdk.StageContext{
+		RawMessage:  "查天气",
+		UserID:      "u1",
+		Phase:       sdk.StageAfterToolcall,
+		ToolResults: []sdk.ToolResult{{CallID: "c1", Name: "weather_query", Result: dirty}},
+	}
+	beforeWea := snapshot(scWea)
+	diffWea := diffOnly(beforeWea, writable(scWea))
+
+	// weather 必须零回传，否则它的旧快照会覆盖 sanitizer 的清洗
+	if len(diffWea) != 0 {
+		t.Fatalf("weather 只读却回传 %v —— 会覆盖 sanitizer 清洗结果", diffWea)
+	}
+	// sanitizer 必须回传 tool_results
+	if _, ok := diffSan["tool_results"]; !ok {
+		t.Fatalf("sanitizer 改写了 tool_results 却未回传：%v", diffSan)
+	}
+
+	// 内核按 sanitizer → weather 顺序应用 diff（weather 后到，是最坏情形）
+	kernel := map[string]interface{}{}
+	for k, v := range kernelSnapshot {
+		kernel[k] = v
+	}
+	for k, v := range diffSan {
+		kernel[k] = v
+	}
+	for k, v := range diffWea {
+		kernel[k] = v
+	}
+
+	res, _ := kernel["tool_results"].([]sdk.ToolResult)
+	if len(res) == 0 || res[0].Result != clean {
+		t.Fatalf("清洗结果被覆盖：期望 %q，实际 %v", clean, kernel["tool_results"])
+	}
+}

tools/plugindev/templates.go

@@ -765,6 +765,65 @@ func stageContextWritable(sc *sdk.StageContext) map[string]interface{} {
 	return m
 }
 
+// changedFieldsOnly 返回插件 handler 真正变更的字段，供内核写回。
+// 修复 plan.md 11.3：旧实现无条件回传 stageContextWritable 的全部字段（含插件
+// 从内核收到的旧快照），两个插件并发时，只读插件会把自己收到的旧值覆盖回
+// 改写插件已清洗的结果（实验 13 复刻现网 sanitizer + weather 场景，丢失率 1.6~4.3%）。
+// 只回传差异字段后，只读插件零回传，改写插件的清洗结果不再被覆盖。
+//
+// ❗ before 必须是 handler 运行前的**序列化快照**（snapshotWritable），不能直接存 Go 值：
+// stageContextWritable 返回的 tool_calls/tool_results 与 sc 共享切片底层数组，handler
+// 原地修改元素（如 sc.ToolResults[0].Result = clean）会让 before 同步变化，diff 将看不到变更。
+func changedFieldsOnly(before map[string]string, after map[string]interface{}) map[string]interface{} {
+	diff := map[string]interface{}{}
+	keys := map[string]bool{}
+	for k := range before {
+		keys[k] = true
+	}
+	for k := range after {
+		keys[k] = true
+	}
+	for k := range keys {
+		bRaw, bHas := before[k]
+		a, aHas := after[k]
+		switch {
+		case aHas && !bHas:
+			diff[k] = a
+		case aHas && bHas:
+			ab, _ := json.Marshal(a)
+			if bRaw != string(ab) {
+				diff[k] = a
+			}
+		case bHas && !aHas:
+			// 插件把切片类字段清空了（writable 对 len==0 不输出），显式回传空值
+			switch k {
+			case "tool_calls":
+				diff[k] = []sdk.ToolCall{}
+			case "tool_results":
+				diff[k] = []sdk.ToolResult{}
+			case "response":
+				// response 从非 nil 变 nil：内核侧 applyStageResult 无法表达「清空」，
+				// 且短路语义不应被插件撑销，故不回传。
+			}
+		}
+	}
+	return diff
+}
+
+// snapshotWritable 把 writable 字段逐个序列化成 JSON 字符串，作为 handler 前的不可变快照。
+// 必须序列化：否则切片字段与 sc 共享底层数组，handler 原地改元素时快照跟着变，diff 失效。
+func snapshotWritable(sc *sdk.StageContext) map[string]string {
+	snap := map[string]string{}
+	for k, v := range stageContextWritable(sc) {
+		b, err := json.Marshal(v)
+		if err != nil {
+			continue
+		}
+		snap[k] = string(b)
+	}
+	return snap
+}
+
 //export go_invoke_stage
 func go_invoke_stage(stage *C.char, ctxJSON *C.char, resultOut **C.char, errorOut **C.char) C.int {
 	goStage := C.GoString(stage)
@@ -776,10 +835,17 @@ func go_invoke_stage(stage *C.char, ctxJSON *C.char, resultOut **C.char, errorOu
 	if ctxJSON != nil {
 		fillStageContext(sc, C.GoString(ctxJSON))
 	}
+	// plan.md 11.3：记录 handler 前的**序列化**快照，回传时只带真正变更的字段，
+	// 避免只读插件把自己收到的旧快照覆盖其他插件的改写（lost update）。
+	before := snapshotWritable(sc)
 	if err := h(sc); err != nil { *errorOut = C.CString(err.Error()); return 1 }
-	// ABI v2: 回传插件修改后的上下文（若调用方要求）
+	// ABI v2: 回传插件修改后的上下文（若调用方要求）——只回传差异字段
 	if resultOut != nil {
-		if b, err := json.Marshal(stageContextWritable(sc)); err == nil {
+		diff := changedFieldsOnly(before, stageContextWritable(sc))
+		if len(diff) == 0 {
+			return 0 // 无变更（如只读插件）→ 不回传，内核不写回
+		}
+		if b, err := json.Marshal(diff); err == nil {
 			*resultOut = C.CString(string(b))
 		}
 	}