docs: 修正全部文档使其与源码实现一致

- Plugin.Start(sdk *PluginSDK) 接口签名改为指针
- 方法表重写: 移除 CallLLM/QueryKnowledge/SetMemory 等不存在方法
- IOInjector 参数顺序修正为 (source, channel, text)
- 删除虚构 SDKConfig, 替换为实际 New() 构造函数签名
- .hmap 内容描述一致化 (plugin.so + plugin.dll + main.lua)
- 添加 meta/ 包元数据文件

sdk/plugin_test.go

@@ -0,0 +1,179 @@
+package sdk
+
+import (
+	"testing"
+)
+
+func TestRegisterStageGlobalDefault(t *testing.T) {
+	called := false
+	regStage := func(stage Stage, handler StageHandler) {
+		called = true
+	}
+	s := &PluginSDK{regStage: regStage, name: "test"}
+	s.RegisterStage(StageBeforeToolcall, func(ctx *StageContext) error { return nil })
+
+	if !called {
+		t.Error("global scope: handler not registered")
+	}
+}
+
+func TestRegisterStageGlobalExplicit(t *testing.T) {
+	called := false
+	regStage := func(stage Stage, handler StageHandler) {
+		called = true
+	}
+	s := &PluginSDK{regStage: regStage, name: "test"}
+	s.RegisterStage(StageBeforeToolcall, func(ctx *StageContext) error { return nil }, StageScopeGlobal)
+
+	if !called {
+		t.Error("global scope: handler not registered")
+	}
+}
+
+func TestRegisterStageOwnToolsMatch(t *testing.T) {
+	var registered StageHandler
+	regStage := func(stage Stage, handler StageHandler) {
+		registered = handler
+	}
+	s := &PluginSDK{regStage: regStage, name: "myplugin"}
+	s.RegisterStage(StageBeforeToolcall, func(ctx *StageContext) error { return nil }, StageScopeOwnTools)
+
+	if registered == nil {
+		t.Fatal("handler not registered")
+	}
+
+	ctx := &StageContext{}
+	ctx.ToolCalls = []ToolCall{{Plugin: "myplugin", Name: "my_tool"}}
+	ctx.ToolResults = nil
+
+	err := registered(ctx)
+	if err != nil {
+		t.Errorf("expected nil, got %v", err)
+	}
+}
+
+func TestRegisterStageOwnToolsSkipOtherPlugin(t *testing.T) {
+	var registered StageHandler
+	regStage := func(stage Stage, handler StageHandler) {
+		registered = handler
+	}
+	s := &PluginSDK{regStage: regStage, name: "myplugin"}
+
+	callCount := 0
+	s.RegisterStage(StageBeforeToolcall, func(ctx *StageContext) error {
+		callCount++
+		return nil
+	}, StageScopeOwnTools)
+
+	if registered == nil {
+		t.Fatal("handler not registered")
+	}
+
+	ctx := &StageContext{}
+	ctx.ToolCalls = []ToolCall{{Plugin: "other", Name: "other_tool"}}
+
+	err := registered(ctx)
+	if err != nil {
+		t.Errorf("expected nil, got %v", err)
+	}
+	if callCount != 0 {
+		t.Error("handler should not be called for other plugin's tool")
+	}
+}
+
+func TestRegisterStageOwnToolsNonToolcallDegrades(t *testing.T) {
+	regStage := func(stage Stage, handler StageHandler) {
+		if stage != StagePreAction {
+			t.Errorf("expected StagePreAction, got %s", stage)
+		}
+	}
+	s := &PluginSDK{regStage: regStage, name: "test"}
+	s.RegisterStage(StagePreAction, func(ctx *StageContext) error { return nil }, StageScopeOwnTools)
+}
+
+func TestRegisterStageOwnToolsStageBeforeToolcallNoToolCalls(t *testing.T) {
+	var registered StageHandler
+	regStage := func(stage Stage, handler StageHandler) {
+		registered = handler
+	}
+	s := &PluginSDK{regStage: regStage, name: "myplugin"}
+
+	callCount := 0
+	s.RegisterStage(StageBeforeToolcall, func(ctx *StageContext) error {
+		callCount++
+		return nil
+	}, StageScopeOwnTools)
+
+	if registered == nil {
+		t.Fatal("handler not registered")
+	}
+
+	ctx := &StageContext{}
+
+	err := registered(ctx)
+	if err != nil {
+		t.Errorf("expected nil, got %v", err)
+	}
+	if callCount != 0 {
+		t.Error("handler should not be called when ToolCalls is empty")
+	}
+}
+
+func TestRegisterStageOwnToolsStageAfterToolcallMatch(t *testing.T) {
+	var registered StageHandler
+	regStage := func(stage Stage, handler StageHandler) {
+		registered = handler
+	}
+	s := &PluginSDK{regStage: regStage, name: "myplugin"}
+
+	callCount := 0
+	s.RegisterStage(StageAfterToolcall, func(ctx *StageContext) error {
+		callCount++
+		return nil
+	}, StageScopeOwnTools)
+
+	if registered == nil {
+		t.Fatal("handler not registered")
+	}
+
+	ctx := &StageContext{}
+	ctx.ToolResults = []ToolResult{{Plugin: "myplugin", Name: "my_tool"}}
+
+	err := registered(ctx)
+	if err != nil {
+		t.Errorf("expected nil, got %v", err)
+	}
+	if callCount != 1 {
+		t.Error("handler should be called for own plugin's tool result")
+	}
+}
+
+func TestRegisterStageOwnToolsStageAfterToolcallSkip(t *testing.T) {
+	var registered StageHandler
+	regStage := func(stage Stage, handler StageHandler) {
+		registered = handler
+	}
+	s := &PluginSDK{regStage: regStage, name: "myplugin"}
+
+	callCount := 0
+	s.RegisterStage(StageAfterToolcall, func(ctx *StageContext) error {
+		callCount++
+		return nil
+	}, StageScopeOwnTools)
+
+	ctx := &StageContext{}
+	ctx.ToolResults = []ToolResult{{Plugin: "other", Name: "other_tool"}}
+
+	err := registered(ctx)
+	if err != nil {
+		t.Errorf("expected nil, got %v", err)
+	}
+	if callCount != 0 {
+		t.Error("handler should not be called for other plugin's tool result")
+	}
+}
+
+func TestRegisterStageOwnToolsNilRegStage(t *testing.T) {
+	s := &PluginSDK{name: "test"}
+	s.RegisterStage(StageBeforeToolcall, func(ctx *StageContext) error { return nil }, StageScopeOwnTools)
+}