docs(plugin-arch): 归档插件架构迁移评估 + plan 第11节整改计划

- docs/zh/架构迁移评估.md: C ABI→子进程+共享内存完整迁移论证(1621行)
- docs/zh/experiments/: 18项可复跑可行性实验(架构评估的所有数字来源)
- plan.md §11: 11.1~11.9 插件架构缺陷修复清单(唯一权威编号)
- main 保持干净,本批次为 update 特性分支的整改起点

docs/zh/experiments/plugin-arch/01-dlclose-nodelete/exp01a/main.go

@@ -0,0 +1,72 @@
+//go:build ignore
+
+package main
+
+/*
+#cgo LDFLAGS: -ldl
+#include <dlfcn.h>
+#include <stdlib.h>
+typedef const char* (*verfn)(void);
+static const char* call_ver(void* f){ return ((verfn)f)(); }
+*/
+import "C"
+import (
+	"fmt"
+	"os"
+	"unsafe"
+)
+
+func main() {
+	// Go 用 dlopen 加载纯 C shim（shim 本身常驻，无所谓）
+	sp := C.CString("./shim.so")
+	shim := C.dlopen(sp, C.RTLD_NOW|C.RTLD_LOCAL)
+	C.free(unsafe.Pointer(sp))
+	if shim == nil {
+		fmt.Println("shim 加载失败:", C.GoString(C.dlerror()))
+		os.Exit(1)
+	}
+	openName := C.CString("shim_open")
+	closeName := C.CString("shim_close")
+	symName := C.CString("shim_sym")
+	shimOpen := C.dlsym(shim, openName)
+	shimClose := C.dlsym(shim, closeName)
+	shimSym := C.dlsym(shim, symName)
+	C.free(unsafe.Pointer(openName))
+	C.free(unsafe.Pointer(closeName))
+	C.free(unsafe.Pointer(symName))
+	fmt.Printf("shim 就绪: open=%p close=%p sym=%p\n\n", shimOpen, shimClose, shimSym)
+
+	// 直接用 dlopen/dlsym 调 shim 的三个函数（避免再写一层 C 包装）
+	load := func(path string) unsafe.Pointer {
+		cp := C.CString(path)
+		defer C.free(unsafe.Pointer(cp))
+		return C.dlopen(cp, C.RTLD_NOW|C.RTLD_LOCAL)
+	}
+	ver := func(h unsafe.Pointer) string {
+		n := C.CString("probe_version")
+		defer C.free(unsafe.Pointer(n))
+		f := C.dlsym(h, n)
+		if f == nil { return "<no sym>" }
+		return C.GoString(C.call_ver(f))
+	}
+
+	fmt.Println("--- 场景: Go(带 NODELETE runtime) 加载/卸载纯 C 的第三层 so ---")
+	h1 := load("./probe.so")
+	fmt.Printf("1) dlopen probe.so       handle=%p  version=%s\n", h1, ver(h1))
+
+	rc := C.dlclose(h1)
+	fmt.Printf("2) dlclose               rc=%d\n", int(rc))
+
+	// 换内容（V1 -> V2），同路径
+	in, _ := os.ReadFile("probe_v2.so")
+	os.WriteFile("probe.so", in, 0755)
+	fmt.Println("3) 磁盘 probe.so 内容替换为 V2（同路径）")
+
+	h2 := load("./probe.so")
+	fmt.Printf("4) 再 dlopen 同路径       handle=%p  version=%s\n", h2, ver(h2))
+	if h1 == h2 {
+		fmt.Println("   => 句柄相同：未卸载，仍是旧代码")
+	} else {
+		fmt.Println("   => 句柄不同：真正卸载并重新装载了新代码 ✅")
+	}
+}

docs/zh/experiments/plugin-arch/01-dlclose-nodelete/exp01b/main.go

@@ -0,0 +1,49 @@
+//go:build ignore
+
+package main
+
+/*
+#cgo LDFLAGS: -ldl
+#include <dlfcn.h>
+#include <stdlib.h>
+typedef void* (*openfn)(const char*);
+typedef int (*closefn)(void*);
+static void* c_open(void* f, const char* p){ return ((openfn)f)(p); }
+static int   c_close(void* f, void* h){ return ((closefn)f)(h); }
+*/
+import "C"
+import (
+	"fmt"
+	"os"
+	"strings"
+	"unsafe"
+)
+
+func cnt(s string) int {
+	b, _ := os.ReadFile("/proc/self/maps")
+	n := 0
+	for _, l := range strings.Split(string(b), "\n") { if strings.Contains(l, s) { n++ } }
+	return n
+}
+
+func main() {
+	sp := C.CString("./shim.so")
+	shim := C.dlopen(sp, C.RTLD_NOW|C.RTLD_LOCAL)
+	C.free(unsafe.Pointer(sp))
+	no := C.CString("shim_open"); nc := C.CString("shim_close")
+	fo := C.dlsym(shim, no); fc := C.dlsym(shim, nc)
+	C.free(unsafe.Pointer(no)); C.free(unsafe.Pointer(nc))
+
+	// 经【纯 C shim】去 dlopen/dlclose Go c-shared 插件
+	qp := C.CString("/home/newqqagent/plugins/qq/plugin.so")
+	h := C.c_open(fo, qp)
+	C.free(unsafe.Pointer(qp))
+	fmt.Printf("经 C shim dlopen Go 插件  handle=%p 映射段=%d\n", h, cnt("qq/plugin.so"))
+	rc := C.c_close(fc, h)
+	fmt.Printf("经 C shim dlclose        rc=%d 映射段=%d\n", int(rc), cnt("qq/plugin.so"))
+	if cnt("qq/plugin.so") > 0 {
+		fmt.Println("\n❌ 仍未卸载 —— NODELETE 属于目标 .so 本身，与谁调 dlopen 无关")
+	} else {
+		fmt.Println("\n✅ 卸载成功")
+	}
+}

docs/zh/experiments/plugin-arch/01-dlclose-nodelete/exp01c/main.go

@@ -0,0 +1,58 @@
+//go:build ignore
+
+package main
+
+/*
+#cgo LDFLAGS: -ldl
+#include <dlfcn.h>
+#include <stdlib.h>
+typedef char* (*verfn)(void);
+static char* call_ver(void* f){ return ((verfn)f)(); }
+*/
+import "C"
+import (
+	"fmt"
+	"os"
+	"strings"
+	"unsafe"
+)
+
+func threads() int {
+	e, _ := os.ReadDir("/proc/self/task")
+	return len(e)
+}
+func rss() int {
+	b, _ := os.ReadFile("/proc/self/status")
+	for _, l := range strings.Split(string(b), "\n") {
+		if strings.HasPrefix(l, "VmRSS:") {
+			var k int
+			fmt.Sscanf(l, "VmRSS: %d kB", &k)
+			return k
+		}
+	}
+	return 0
+}
+func main() {
+	base, baseT := rss(), threads()
+	fmt.Printf("基线: RSS=%dKB threads=%d\n\n", base, baseT)
+	src, _ := os.ReadFile("glv1.so")
+	os.MkdirAll("stress", 0755)
+	var hs []unsafe.Pointer
+	for i := 1; i <= 30; i++ {
+		p := fmt.Sprintf("stress/%010d-qq.so", 1700000000+i)
+		os.WriteFile(p, src, 0755)
+		cp := C.CString("./" + p)
+		h := C.dlopen(cp, C.RTLD_NOW|C.RTLD_LOCAL)
+		C.free(unsafe.Pointer(cp))
+		if h == nil { fmt.Printf("第 %d 次失败\n", i); break }
+		hs = append(hs, h)
+		C.dlclose(h) // 模拟每次都尝试卸载（no-op）
+		if i%10 == 0 {
+			fmt.Printf("第 %2d 次重载: RSS=%dKB (+%dKB) threads=%d (+%d)\n",
+				i, rss(), rss()-base, threads(), threads()-baseT)
+		}
+	}
+	fmt.Printf("\n30 次重载后: RSS 增长 %dKB, 线程增长 %d\n", rss()-base, threads()-baseT)
+	fmt.Printf("每次重载均摊: RSS +%.1fKB, 线程 +%.2f\n",
+		float64(rss()-base)/30, float64(threads()-baseT)/30)
+}

docs/zh/experiments/plugin-arch/01-dlclose-nodelete/probe_v1.c

@@ -0,0 +1,2 @@
+#include <stdio.h>
+const char* probe_version(void){ return "V1"; }

docs/zh/experiments/plugin-arch/01-dlclose-nodelete/probe_v2.c

@@ -0,0 +1,2 @@
+#include <stdio.h>
+const char* probe_version(void){ return "V2"; }

docs/zh/experiments/plugin-arch/01-dlclose-nodelete/shim.c

@@ -0,0 +1,9 @@
+#include <dlfcn.h>
+#include <stdio.h>
+void* shim_open(const char* p){
+    void* h = dlopen(p, RTLD_NOW|RTLD_LOCAL);
+    if(!h) printf("    [shim] open FAIL: %s\n", dlerror());
+    return h;
+}
+int shim_close(void* h){ return dlclose(h); }
+void* shim_sym(void* h, const char* n){ return dlsym(h, n); }