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

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

tools/plugindev/testplugin/README.md

@@ -0,0 +1,13 @@
+# testplugin
+
+testplugin plugin
+
+## Build
+
+```bash
+plugindev build
+```
+
+## Install
+
+Upload the .hmap file through the Plugin Manager API.

tools/plugindev/testplugin/go.mod

@@ -0,0 +1,7 @@
+module testplugin
+
+go 1.21
+
+require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+
+replace gitcode.com/JianFeeeee/homeagent-sdk => E:/program/homeagent/homeagentsdk

tools/plugindev/testplugin/main.go

@@ -0,0 +1,11 @@
+//go:build !windows || !cgo
+
+package main
+
+import (
+	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+)
+
+func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {
+	return NewPluginFactory(name, config)
+}

tools/plugindev/testplugin/plg.json

@@ -0,0 +1,11 @@
+{
+  "name": "testplugin",
+  "name_zh": "中文名",
+  "name_en": "Testplugin",
+  "version": "0.1.0",
+  "description": "testplugin plugin",
+  "author": "HomeAgent",
+  "entry": "plugin.so",
+  "tags": ["testplugin"],
+  "targets": "linux/amd64,windows/amd64"
+}

tools/plugindev/testplugin/plugin.go

@@ -0,0 +1,57 @@
+package main
+
+import (
+	"fmt"
+
+	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+)
+
+type Plugin struct {
+	name string
+	sdk  *sdk.PluginSDK
+}
+
+func (p *Plugin) Name() string { return p.name }
+
+func (p *Plugin) Start(s *sdk.PluginSDK) error {
+	p.sdk = s
+
+	s.Settings().RegisterDef(sdk.ConfigDef{
+		Key:         "plugin.testplugin.example",
+		Default:     "hello",
+		Type:        "string",
+		DisplayName: "示例配置",
+		Description: "An example configuration key",
+		Category:    "testplugin",
+	})
+
+	tp := p.name + "_"
+	s.RegisterTool(tp+"hello", sdk.ToolDef{
+		Name:        tp + "hello",
+		Description: "A hello world tool",
+		Parameters: map[string]interface{}{
+			"type":       "object",
+			"properties": map[string]interface{}{},
+		},
+	}, p.handleHello)
+
+	fmt.Printf("[%s] started\n", p.name)
+	return nil
+}
+
+func (p *Plugin) Stop() error {
+	fmt.Printf("[%s] stopped\n", p.name)
+	return nil
+}
+
+func (p *Plugin) handleHello(args map[string]interface{}) (interface{}, error) {
+	return map[string]interface{}{
+		"content": "Hello from testplugin plugin!",
+	}, nil
+}
+
+// NewPluginFactory creates a Plugin instance. Called by both Linux entry (main.go)
+// and Windows bridge (z_bridge_gen.go) to avoid naming conflict with C export.
+func NewPluginFactory(name string, config map[string]interface{}) (sdk.Plugin, error) {
+	return &Plugin{name: name}, nil
+}