diff --git a/docs/api/channels.md b/docs/api/channels.md
index 878ee53..ea308df 100644
--- a/docs/api/channels.md
+++ b/docs/api/channels.md
@@ -268,18 +268,6 @@ const ContextPolicyPrune
`plugin.go:45`
-### `IOInjector`
-
-```go
-type IOInjector interface { InjectInterruptText(source, channel, text string) InjectText(source, channel, text string) InjectTextNoMemory(source, channel, text string) // I …
-```
-
-IOInjector provides methods for injecting input and interrupts into the agent pipeline.
-All methods accept (source, channel) where channel is the target output channel
-for routing the agent's response.
-
-`plugin.go:220`
-
### `PluginSDK.InjectInputMedia`
```go
diff --git a/docs/api/events.md b/docs/api/events.md
index 462b669..8dead3c 100644
--- a/docs/api/events.md
+++ b/docs/api/events.md
@@ -44,18 +44,6 @@ EventHandler processes a system event.
`plugin.go:273`
-### `EventSubscriber`
-
-```go
-type EventSubscriber interface { Subscribe(eventType EventType, handler EventHandler) func() }
-```
-
-EventSubscriber allows plugins to subscribe to kernel events.
-This is a restricted interface: plugins can subscribe but the kernel
-controls which events are delivered.
-
-`plugin.go:278`
-
### `EventType`
```go
diff --git a/docs/api/lifecycle.md b/docs/api/lifecycle.md
index 30530f6..310d945 100644
--- a/docs/api/lifecycle.md
+++ b/docs/api/lifecycle.md
@@ -89,16 +89,6 @@ AutoRestart 返回插件是否允许自动重启。
`plugin.go:791`
-### `Plugin`
-
-```go
-type Plugin interface { Name() string Start(sdk *PluginSDK) error Stop() error }
-```
-
-Plugin is the interface every plugin must implement.
-
-`plugin.go:13`
-
### `PluginSDK.PluginMgr`
```go
@@ -110,17 +100,6 @@ May be nil if the host did not wire it.
`plugin.go:653`
-### `PluginMgrAPI`
-
-```go
-type PluginMgrAPI interface { // ReloadOne 重载单个插件（停止后重新加载）。 ReloadOne(name string) error // ListLoadedPlugins 列出已加载插件。 ListLoa …
-```
-
-PluginMgrAPI 提供插件管理能力（外部插件可调用）。
-由 bridge 注入 dispatch 实现，走 C ABI CORE_PLUGIN_RELOAD_ONE 等。
-
-`plugin.go:284`
-
### `PluginSDK.PluginName`
```go
diff --git a/docs/api/llm.md b/docs/api/llm.md
index ac91d83..b1f29a2 100644
--- a/docs/api/llm.md
+++ b/docs/api/llm.md
@@ -48,13 +48,3 @@ LLM returns the LLM provider API (may be nil if not available).
`plugin.go:432`
-### `LLMAPI`
-
-```go
-type LLMAPI interface { ListSources() []string SetSource(name string) error CurrentSource() string }
-```
-
-LLMAPI provides access to the LLM provider manager.
-
-`llm.go:4`
-
diff --git a/docs/api/memory.md b/docs/api/memory.md
index ca351c9..5b0f8fd 100644
--- a/docs/api/memory.md
+++ b/docs/api/memory.md
@@ -238,16 +238,6 @@ DocMemory returns the document memory API (may be nil if not available).
`plugin.go:418`
-### `DocMemoryAPI`
-
-```go
-type DocMemoryAPI interface { Query(text string, topK int) []*Doc Insert(doc *Doc) error // InsertWithMedia 写入文档并关联媒体。attachments 里带 Data 的会落进 …
-```
-
-DocMemoryAPI provides access to the document vector store.
-
-`memory.go:74`
-
### `Entity`
```go
@@ -258,22 +248,6 @@ Entity represents a named entity in the knowledge graph.
`memory.go:13`
-### `PluginSDK.Knowledge`
-
-```go
-func (s *PluginSDK) Knowledge() KnowledgeAPI
-```
-
-Knowledge returns the knowledge store API (may be nil if not available).
-
-**示例插件里的真实用法**
-
-| 插件 | 位置 | 代码 |
-|---|---|---|
-| [`recoverydiag`](../examples/index.md#recoverydiag) | `example/recoverydiag/plugin.go:978` | `if p.sdk != nil && p.sdk.Knowledge() != nil {` |
-
-`plugin.go:425`
-
### `Knowledge`
```go
@@ -290,15 +264,21 @@ Knowledge represents a knowledge entry.
`knowledge.go:11`
-### `KnowledgeAPI`
+### `PluginSDK.Knowledge`
```go
-type KnowledgeAPI interface { Search(query string, topK int) ([]*Knowledge, error) Add(name, content string) error List() ([]string, error) }
+func (s *PluginSDK) Knowledge() KnowledgeAPI
```
-KnowledgeAPI provides access to the knowledge store.
+Knowledge returns the knowledge store API (may be nil if not available).
-`knowledge.go:4`
+**示例插件里的真实用法**
+
+| 插件 | 位置 | 代码 |
+|---|---|---|
+| [`recoverydiag`](../examples/index.md#recoverydiag) | `example/recoverydiag/plugin.go:978` | `if p.sdk != nil && p.sdk.Knowledge() != nil {` |
+
+`plugin.go:425`
### `MediaAttachment`
@@ -330,16 +310,6 @@ Memory returns the graph memory API (may be nil if not available).
`plugin.go:404`
-### `MemoryAPI`
-
-```go
-type MemoryAPI interface { Recall(query []string, depth int) ([]Entity, []Relation, error) Commit(triples []Triple) error Introspect() (map[string]interface{}, error) Merg …
-```
-
-MemoryAPI provides access to the graph memory (entity-relation store).
-
-`memory.go:4`
-
### `PersonProfile`
```go
@@ -370,17 +340,6 @@ Social returns the social graph API (may be nil if not available).
`plugin.go:439`
-### `SocialAPI`
-
-```go
-type SocialAPI interface { GetPerson(name string) (*PersonProfile, error) GetTrait(name, trait string) (string, bool) GetRelations(name string) ([]SocialRelation, error) G …
-```
-
-SocialAPI provides read-only access to the social graph (person profiles and relationships).
-External plugins can query person traits and social networks but cannot modify them.
-
-`memory.go:100`
-
### `SocialRelation`
```go
@@ -409,16 +368,6 @@ TextMemory returns the text memory API (may be nil if not available).
`plugin.go:411`
-### `TextMemoryAPI`
-
-```go
-type TextMemoryAPI interface { Append(evt TextEvent) error }
-```
-
-TextMemoryAPI provides access to chronological text event storage.
-
-`memory.go:43`
-
### `Triple`
```go
diff --git a/docs/api/settings.md b/docs/api/settings.md
index b3c031d..0364f05 100644
--- a/docs/api/settings.md
+++ b/docs/api/settings.md
@@ -195,11 +195,3 @@ sett 在 New 时一次性写入且无 setter，故不需要加锁。
`plugin.go:401`
-### `SettingsAPI`
-
-```go
-type SettingsAPI interface { // Get reads the plugin's own config value (config_ table). Get(key string) (interface{}, error) // Set writes a config value to the plugi …
-```
-
-`settings.go:3`
-
diff --git a/docs/assets/api-index.json b/docs/assets/api-index.json
index 70f2232..bc060eb 100644
--- a/docs/assets/api-index.json
+++ b/docs/assets/api-index.json
@@ -19,7 +19,10 @@
"p": "memory",
"b": false,
"f": "knowledge.go",
- "l": 6
+ "l": 6,
+ "g": [
+ "添加知识"
+ ]
},
{
"n": "Append",
@@ -30,7 +33,10 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 44
+ "l": 44,
+ "g": [
+ "追加文本"
+ ]
},
{
"n": "AudioURL",
@@ -52,7 +58,13 @@
"p": "lifecycle",
"b": false,
"f": "plugin.go",
- "l": 791
+ "l": 791,
+ "g": [
+ "自动重启",
+ "崩溃自愈",
+ "故障恢复",
+ "查询是否自动重启"
+ ]
},
{
"n": "CapAudio",
@@ -63,7 +75,10 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 331
+ "l": 331,
+ "g": [
+ "音频能力"
+ ]
},
{
"n": "CapFile",
@@ -74,7 +89,10 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 329
+ "l": 329,
+ "g": [
+ "文件能力"
+ ]
},
{
"n": "CapImage",
@@ -85,7 +103,10 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 330
+ "l": 330,
+ "g": [
+ "图片能力"
+ ]
},
{
"n": "CapStructured",
@@ -96,7 +117,10 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 332
+ "l": 332,
+ "g": [
+ "结构化能力"
+ ]
},
{
"n": "CapText",
@@ -107,7 +131,10 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 328
+ "l": 328,
+ "g": [
+ "文本能力"
+ ]
},
{
"n": "ChannelDef",
@@ -118,7 +145,12 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 139
+ "l": 139,
+ "g": [
+ "通道",
+ "频道",
+ "通道定义"
+ ]
},
{
"n": "Commit",
@@ -129,7 +161,11 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 6
+ "l": 6,
+ "g": [
+ "写入记忆",
+ "提交三元组"
+ ]
},
{
"n": "ConfigDef",
@@ -140,7 +176,10 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 50
+ "l": 50,
+ "g": [
+ "配置项定义"
+ ]
},
{
"n": "ContentBlock",
@@ -151,7 +190,12 @@
"p": "tools",
"b": false,
"f": "plugin.go",
- "l": 850
+ "l": 850,
+ "g": [
+ "多模态内容块",
+ "图片块",
+ "音频块"
+ ]
},
{
"n": "ContextPolicyNone",
@@ -162,7 +206,12 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 44
+ "l": 44,
+ "g": [
+ "策略",
+ "不裁剪上下文",
+ "默认裁剪策略"
+ ]
},
{
"n": "ContextPolicyPrune",
@@ -173,7 +222,12 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 45
+ "l": 45,
+ "g": [
+ "策略",
+ "裁剪上下文",
+ "归档丢弃"
+ ]
},
{
"n": "CurrentSource",
@@ -184,7 +238,10 @@
"p": "llm",
"b": false,
"f": "llm.go",
- "l": 7
+ "l": 7,
+ "g": [
+ "当前模型来源"
+ ]
},
{
"n": "DataDir",
@@ -195,7 +252,10 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 25
+ "l": 25,
+ "g": [
+ "数据目录"
+ ]
},
{
"n": "Defs",
@@ -206,7 +266,10 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 40
+ "l": 40,
+ "g": [
+ "配置定义列表"
+ ]
},
{
"n": "Doc",
@@ -217,7 +280,11 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 89
+ "l": 89,
+ "g": [
+ "文档",
+ "文档对象"
+ ]
},
{
"n": "DocMemory",
@@ -228,7 +295,12 @@
"p": "memory",
"b": false,
"f": "plugin.go",
- "l": 418
+ "l": 418,
+ "g": [
+ "记忆",
+ "内存",
+ "文档"
+ ]
},
{
"n": "DocMemoryAPI",
@@ -241,17 +313,6 @@
"f": "",
"l": 0
},
- {
- "n": "DocMemoryAPI",
- "s": "type DocMemoryAPI interface { Query(text string, topK int) []*Doc Insert(doc *Doc) error // InsertWithMedia 写入文档并关联媒体。attachments 里带 Data 的会落进 …",
- "d": "DocMemoryAPI provides access to the document vector store.",
- "k": "type",
- "r": "",
- "p": "memory",
- "b": false,
- "f": "memory.go",
- "l": 74
- },
{
"n": "Dump",
"s": "Dump() map[string]interface{}",
@@ -261,7 +322,10 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 43
+ "l": 43,
+ "g": [
+ "导出配置"
+ ]
},
{
"n": "Entity",
@@ -272,7 +336,11 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 13
+ "l": 13,
+ "g": [
+ "实体",
+ "记忆主体"
+ ]
},
{
"n": "Event",
@@ -283,7 +351,11 @@
"p": "events",
"b": false,
"f": "plugin.go",
- "l": 265
+ "l": 265,
+ "g": [
+ "事件",
+ "订阅"
+ ]
},
{
"n": "EventAgentLLMChain",
@@ -294,7 +366,11 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 252
+ "l": 252,
+ "g": [
+ "事件",
+ "订阅"
+ ]
},
{
"n": "EventAgentOutput",
@@ -305,7 +381,11 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 251
+ "l": 251,
+ "g": [
+ "事件",
+ "订阅"
+ ]
},
{
"n": "EventContentDelta",
@@ -316,7 +396,11 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 261
+ "l": 261,
+ "g": [
+ "事件",
+ "订阅"
+ ]
},
{
"n": "EventHandler",
@@ -327,7 +411,11 @@
"p": "events",
"b": false,
"f": "plugin.go",
- "l": 273
+ "l": 273,
+ "g": [
+ "事件",
+ "订阅"
+ ]
},
{
"n": "EventRawInput",
@@ -338,7 +426,11 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 250
+ "l": 250,
+ "g": [
+ "事件",
+ "订阅"
+ ]
},
{
"n": "EventReasoning",
@@ -349,7 +441,11 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 254
+ "l": 254,
+ "g": [
+ "事件",
+ "订阅"
+ ]
},
{
"n": "EventReasoningDelta",
@@ -360,7 +456,11 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 260
+ "l": 260,
+ "g": [
+ "事件",
+ "订阅"
+ ]
},
{
"n": "EventStage",
@@ -371,18 +471,13 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 255
- },
- {
- "n": "EventSubscriber",
- "s": "type EventSubscriber interface { Subscribe(eventType EventType, handler EventHandler) func() }",
- "d": "EventSubscriber allows plugins to subscribe to kernel events.",
- "k": "type",
- "r": "",
- "p": "events",
- "b": false,
- "f": "plugin.go",
- "l": 278
+ "l": 255,
+ "g": [
+ "事件",
+ "订阅",
+ "阶段",
+ "钩子"
+ ]
},
{
"n": "EventSubscriber",
@@ -404,7 +499,11 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 256
+ "l": 256,
+ "g": [
+ "事件",
+ "订阅"
+ ]
},
{
"n": "EventToolCall",
@@ -415,7 +514,12 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 253
+ "l": 253,
+ "g": [
+ "事件",
+ "订阅",
+ "工具"
+ ]
},
{
"n": "EventType",
@@ -426,7 +530,11 @@
"p": "events",
"b": false,
"f": "plugin.go",
- "l": 247
+ "l": 247,
+ "g": [
+ "事件",
+ "订阅"
+ ]
},
{
"n": "Events",
@@ -437,7 +545,13 @@
"p": "events",
"b": true,
"f": "plugin.go",
- "l": 446
+ "l": 446,
+ "g": [
+ "事件",
+ "订阅",
+ "事件订阅",
+ "监听事件"
+ ]
},
{
"n": "Get",
@@ -448,7 +562,10 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 5
+ "l": 5,
+ "g": [
+ "读取配置"
+ ]
},
{
"n": "GetCore",
@@ -459,7 +576,10 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 14
+ "l": 14,
+ "g": [
+ "读核心配置"
+ ]
},
{
"n": "GetNetwork",
@@ -470,7 +590,10 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 104
+ "l": 104,
+ "g": [
+ "查关系网"
+ ]
},
{
"n": "GetPerson",
@@ -481,7 +604,10 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 101
+ "l": 101,
+ "g": [
+ "查人物"
+ ]
},
{
"n": "GetPlugin",
@@ -492,7 +618,10 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 28
+ "l": 28,
+ "g": [
+ "读插件配置"
+ ]
},
{
"n": "GetRelations",
@@ -503,7 +632,10 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 103
+ "l": 103,
+ "g": [
+ "查关系"
+ ]
},
{
"n": "GetTrait",
@@ -514,18 +646,10 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 102
- },
- {
- "n": "IOInjector",
- "s": "type IOInjector interface { InjectInterruptText(source, channel, text string) InjectText(source, channel, text string) InjectTextNoMemory(source, channel, text string) // I …",
- "d": "IOInjector provides methods for injecting input and interrupts into the agent pipeline.",
- "k": "type",
- "r": "",
- "p": "channels",
- "b": false,
- "f": "plugin.go",
- "l": 220
+ "l": 102,
+ "g": [
+ "查特征"
+ ]
},
{
"n": "IOInjector",
@@ -558,7 +682,15 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 701
+ "l": 701,
+ "g": [
+ "注入输入",
+ "投喂输入",
+ "模拟用户输入",
+ "媒体",
+ "图片",
+ "音频"
+ ]
},
{
"n": "InjectInputMedia",
@@ -569,7 +701,15 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 230
+ "l": 230,
+ "g": [
+ "注入输入",
+ "投喂输入",
+ "模拟用户输入",
+ "媒体",
+ "图片",
+ "音频"
+ ]
},
{
"n": "InjectInputMediaOpts",
@@ -580,7 +720,15 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 740
+ "l": 740,
+ "g": [
+ "注入输入",
+ "投喂输入",
+ "模拟用户输入",
+ "媒体",
+ "图片",
+ "音频"
+ ]
},
{
"n": "InjectInputMediaOpts",
@@ -591,7 +739,15 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 241
+ "l": 241,
+ "g": [
+ "注入输入",
+ "投喂输入",
+ "模拟用户输入",
+ "媒体",
+ "图片",
+ "音频"
+ ]
},
{
"n": "InjectInputMediaSync",
@@ -602,7 +758,15 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 231
+ "l": 231,
+ "g": [
+ "注入输入",
+ "投喂输入",
+ "模拟用户输入",
+ "媒体",
+ "图片",
+ "音频"
+ ]
},
{
"n": "InjectInputMediaSync",
@@ -613,18 +777,15 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 707
- },
- {
- "n": "InjectInputMediaSyncOpts",
- "s": "InjectInputMediaSyncOpts(source, channel, text string, blocks []ContentBlock, opts InjectOptions) string",
- "d": "",
- "k": "method",
- "r": "IOInjector",
- "p": "channels",
- "b": false,
- "f": "plugin.go",
- "l": 242
+ "l": 707,
+ "g": [
+ "注入输入",
+ "投喂输入",
+ "模拟用户输入",
+ "媒体",
+ "图片",
+ "音频"
+ ]
},
{
"n": "InjectInputMediaSyncOpts",
@@ -635,7 +796,34 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 747
+ "l": 747,
+ "g": [
+ "注入输入",
+ "投喂输入",
+ "模拟用户输入",
+ "媒体",
+ "图片",
+ "音频"
+ ]
+ },
+ {
+ "n": "InjectInputMediaSyncOpts",
+ "s": "InjectInputMediaSyncOpts(source, channel, text string, blocks []ContentBlock, opts InjectOptions) string",
+ "d": "",
+ "k": "method",
+ "r": "IOInjector",
+ "p": "channels",
+ "b": false,
+ "f": "plugin.go",
+ "l": 242,
+ "g": [
+ "注入输入",
+ "投喂输入",
+ "模拟用户输入",
+ "媒体",
+ "图片",
+ "音频"
+ ]
},
{
"n": "InjectInputSync",
@@ -646,7 +834,12 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 226
+ "l": 226,
+ "g": [
+ "注入输入",
+ "投喂输入",
+ "模拟用户输入"
+ ]
},
{
"n": "InjectInputSync",
@@ -657,7 +850,12 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 692
+ "l": 692,
+ "g": [
+ "注入输入",
+ "投喂输入",
+ "模拟用户输入"
+ ]
},
{
"n": "InjectInputSyncOpts",
@@ -668,7 +866,12 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 240
+ "l": 240,
+ "g": [
+ "注入输入",
+ "投喂输入",
+ "模拟用户输入"
+ ]
},
{
"n": "InjectInputSyncOpts",
@@ -679,18 +882,12 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 731
- },
- {
- "n": "InjectInterruptMedia",
- "s": "func (s *PluginSDK) InjectInterruptMedia(source, channel, text string, blocks []ContentBlock)",
- "d": "InjectInterruptMedia 注入带媒体内容块的中断，可抢占当前 LLM 处理。",
- "k": "method",
- "r": "PluginSDK",
- "p": "channels",
- "b": false,
- "f": "plugin.go",
- "l": 764
+ "l": 731,
+ "g": [
+ "注入输入",
+ "投喂输入",
+ "模拟用户输入"
+ ]
},
{
"n": "InjectInterruptMedia",
@@ -701,7 +898,36 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 232
+ "l": 232,
+ "g": [
+ "中断注入",
+ "插话",
+ "打断",
+ "抢占",
+ "媒体",
+ "图片",
+ "音频"
+ ]
+ },
+ {
+ "n": "InjectInterruptMedia",
+ "s": "func (s *PluginSDK) InjectInterruptMedia(source, channel, text string, blocks []ContentBlock)",
+ "d": "InjectInterruptMedia 注入带媒体内容块的中断，可抢占当前 LLM 处理。",
+ "k": "method",
+ "r": "PluginSDK",
+ "p": "channels",
+ "b": false,
+ "f": "plugin.go",
+ "l": 764,
+ "g": [
+ "中断注入",
+ "插话",
+ "打断",
+ "抢占",
+ "媒体",
+ "图片",
+ "音频"
+ ]
},
{
"n": "InjectInterruptMediaOpts",
@@ -712,7 +938,16 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 756
+ "l": 756,
+ "g": [
+ "中断注入",
+ "插话",
+ "打断",
+ "抢占",
+ "媒体",
+ "图片",
+ "音频"
+ ]
},
{
"n": "InjectInterruptMediaOpts",
@@ -723,18 +958,16 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 243
- },
- {
- "n": "InjectInterruptText",
- "s": "InjectInterruptText(source, channel, text string)",
- "d": "",
- "k": "method",
- "r": "IOInjector",
- "p": "channels",
- "b": false,
- "f": "plugin.go",
- "l": 221
+ "l": 243,
+ "g": [
+ "中断注入",
+ "插话",
+ "打断",
+ "抢占",
+ "媒体",
+ "图片",
+ "音频"
+ ]
},
{
"n": "InjectInterruptText",
@@ -745,18 +978,30 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 673
+ "l": 673,
+ "g": [
+ "中断注入",
+ "插话",
+ "打断",
+ "抢占"
+ ]
},
{
- "n": "InjectInterruptTextOpts",
- "s": "func (s *PluginSDK) InjectInterruptTextOpts(source, channel, text string, opts InjectOptions)",
- "d": "InjectInterruptTextOpts 注入可抢占当前处理的中断文本。",
+ "n": "InjectInterruptText",
+ "s": "InjectInterruptText(source, channel, text string)",
+ "d": "",
"k": "method",
- "r": "PluginSDK",
+ "r": "IOInjector",
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 724
+ "l": 221,
+ "g": [
+ "中断注入",
+ "插话",
+ "打断",
+ "抢占"
+ ]
},
{
"n": "InjectInterruptTextOpts",
@@ -767,7 +1012,30 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 239
+ "l": 239,
+ "g": [
+ "中断注入",
+ "插话",
+ "打断",
+ "抢占"
+ ]
+ },
+ {
+ "n": "InjectInterruptTextOpts",
+ "s": "func (s *PluginSDK) InjectInterruptTextOpts(source, channel, text string, opts InjectOptions)",
+ "d": "InjectInterruptTextOpts 注入可抢占当前处理的中断文本。",
+ "k": "method",
+ "r": "PluginSDK",
+ "p": "channels",
+ "b": false,
+ "f": "plugin.go",
+ "l": 724,
+ "g": [
+ "中断注入",
+ "插话",
+ "打断",
+ "抢占"
+ ]
},
{
"n": "InjectOptions",
@@ -778,18 +1046,12 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 98
- },
- {
- "n": "InjectText",
- "s": "func (s *PluginSDK) InjectText(source, channel, text string)",
- "d": "InjectText injects a text message into the agent pipeline.",
- "k": "method",
- "r": "PluginSDK",
- "p": "channels",
- "b": false,
- "f": "plugin.go",
- "l": 679
+ "l": 98,
+ "g": [
+ "注入选项",
+ "是否记入记忆",
+ "是否裁剪上下文"
+ ]
},
{
"n": "InjectText",
@@ -800,18 +1062,30 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 222
+ "l": 222,
+ "g": [
+ "注入文本",
+ "注入消息",
+ "投喂输入",
+ "灌入内容"
+ ]
},
{
- "n": "InjectTextNoMemory",
- "s": "func (s *PluginSDK) InjectTextNoMemory(source, channel, text string)",
- "d": "InjectTextNoMemory injects a text message without generating memory.",
+ "n": "InjectText",
+ "s": "func (s *PluginSDK) InjectText(source, channel, text string)",
+ "d": "InjectText injects a text message into the agent pipeline.",
"k": "method",
"r": "PluginSDK",
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 685
+ "l": 679,
+ "g": [
+ "注入文本",
+ "注入消息",
+ "投喂输入",
+ "灌入内容"
+ ]
},
{
"n": "InjectTextNoMemory",
@@ -822,18 +1096,34 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 223
+ "l": 223,
+ "g": [
+ "注入文本",
+ "注入消息",
+ "投喂输入",
+ "灌入内容",
+ "记忆",
+ "内存"
+ ]
},
{
- "n": "InjectTextOpts",
- "s": "func (s *PluginSDK) InjectTextOpts(source, channel, text string, opts InjectOptions)",
- "d": "InjectTextOpts 注入文本到 agent，并在这一次注入上声明记忆与裁剪行为。",
+ "n": "InjectTextNoMemory",
+ "s": "func (s *PluginSDK) InjectTextNoMemory(source, channel, text string)",
+ "d": "InjectTextNoMemory injects a text message without generating memory.",
"k": "method",
"r": "PluginSDK",
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 714
+ "l": 685,
+ "g": [
+ "注入文本",
+ "注入消息",
+ "投喂输入",
+ "灌入内容",
+ "记忆",
+ "内存"
+ ]
},
{
"n": "InjectTextOpts",
@@ -844,7 +1134,30 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 238
+ "l": 238,
+ "g": [
+ "注入文本",
+ "注入消息",
+ "投喂输入",
+ "灌入内容"
+ ]
+ },
+ {
+ "n": "InjectTextOpts",
+ "s": "func (s *PluginSDK) InjectTextOpts(source, channel, text string, opts InjectOptions)",
+ "d": "InjectTextOpts 注入文本到 agent，并在这一次注入上声明记忆与裁剪行为。",
+ "k": "method",
+ "r": "PluginSDK",
+ "p": "channels",
+ "b": false,
+ "f": "plugin.go",
+ "l": 714,
+ "g": [
+ "注入文本",
+ "注入消息",
+ "投喂输入",
+ "灌入内容"
+ ]
},
{
"n": "InputChannelRegistrar",
@@ -855,7 +1168,11 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 314
+ "l": 314,
+ "g": [
+ "通道",
+ "频道"
+ ]
},
{
"n": "Insert",
@@ -866,7 +1183,10 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 76
+ "l": 76,
+ "g": [
+ "插入文档"
+ ]
},
{
"n": "InsertWithMedia",
@@ -877,7 +1197,13 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 81
+ "l": 81,
+ "g": [
+ "媒体",
+ "图片",
+ "音频",
+ "插入带媒体文档"
+ ]
},
{
"n": "Introspect",
@@ -888,7 +1214,11 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 7
+ "l": 7,
+ "g": [
+ "查看记忆",
+ "记忆概览"
+ ]
},
{
"n": "IsPluginDisabled",
@@ -899,7 +1229,10 @@
"p": "lifecycle",
"b": false,
"f": "plugin.go",
- "l": 290
+ "l": 290,
+ "g": [
+ "查插件是否被禁用"
+ ]
},
{
"n": "IsResponded",
@@ -921,7 +1254,11 @@
"p": "memory",
"b": false,
"f": "knowledge.go",
- "l": 11
+ "l": 11,
+ "g": [
+ "知识库",
+ "知识"
+ ]
},
{
"n": "Knowledge",
@@ -932,7 +1269,11 @@
"p": "memory",
"b": false,
"f": "plugin.go",
- "l": 425
+ "l": 425,
+ "g": [
+ "知识库",
+ "知识"
+ ]
},
{
"n": "KnowledgeAPI",
@@ -945,17 +1286,6 @@
"f": "",
"l": 0
},
- {
- "n": "KnowledgeAPI",
- "s": "type KnowledgeAPI interface { Search(query string, topK int) ([]*Knowledge, error) Add(name, content string) error List() ([]string, error) }",
- "d": "KnowledgeAPI provides access to the knowledge store.",
- "k": "type",
- "r": "",
- "p": "memory",
- "b": false,
- "f": "knowledge.go",
- "l": 4
- },
{
"n": "LLM",
"s": "func (s *PluginSDK) LLM() LLMAPI",
@@ -967,17 +1297,6 @@
"f": "plugin.go",
"l": 432
},
- {
- "n": "LLMAPI",
- "s": "type LLMAPI interface { ListSources() []string SetSource(name string) error CurrentSource() string }",
- "d": "LLMAPI provides access to the LLM provider manager.",
- "k": "type",
- "r": "",
- "p": "llm",
- "b": false,
- "f": "llm.go",
- "l": 4
- },
{
"n": "LLMAPI",
"s": "type LLMAPI interface",
@@ -998,7 +1317,10 @@
"p": "memory",
"b": false,
"f": "knowledge.go",
- "l": 7
+ "l": 7,
+ "g": [
+ "列出"
+ ]
},
{
"n": "List",
@@ -1009,7 +1331,10 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 11
+ "l": 11,
+ "g": [
+ "列出"
+ ]
},
{
"n": "ListCore",
@@ -1020,7 +1345,10 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 20
+ "l": 20,
+ "g": [
+ "列出核心配置"
+ ]
},
{
"n": "ListLoadedPlugins",
@@ -1031,7 +1359,10 @@
"p": "lifecycle",
"b": false,
"f": "plugin.go",
- "l": 288
+ "l": 288,
+ "g": [
+ "已加载插件列表"
+ ]
},
{
"n": "ListPersons",
@@ -1042,7 +1373,10 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 105
+ "l": 105,
+ "g": [
+ "列出人物"
+ ]
},
{
"n": "ListPlugin",
@@ -1053,7 +1387,10 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 34
+ "l": 34,
+ "g": [
+ "列出插件配置"
+ ]
},
{
"n": "ListSources",
@@ -1064,7 +1401,10 @@
"p": "llm",
"b": false,
"f": "llm.go",
- "l": 5
+ "l": 5,
+ "g": [
+ "列出模型来源"
+ ]
},
{
"n": "Lock",
@@ -1086,7 +1426,13 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 58
+ "l": 58,
+ "g": [
+ "媒体",
+ "图片",
+ "音频",
+ "媒体附件"
+ ]
},
{
"n": "MemItem",
@@ -1108,7 +1454,11 @@
"p": "memory",
"b": false,
"f": "plugin.go",
- "l": 404
+ "l": 404,
+ "g": [
+ "记忆",
+ "内存"
+ ]
},
{
"n": "MemoryAPI",
@@ -1121,17 +1471,6 @@
"f": "",
"l": 0
},
- {
- "n": "MemoryAPI",
- "s": "type MemoryAPI interface { Recall(query []string, depth int) ([]Entity, []Relation, error) Commit(triples []Triple) error Introspect() (map[string]interface{}, error) Merg …",
- "d": "MemoryAPI provides access to the graph memory (entity-relation store).",
- "k": "type",
- "r": "",
- "p": "memory",
- "b": false,
- "f": "memory.go",
- "l": 4
- },
{
"n": "MergeEntities",
"s": "MergeEntities(source, target string) (int, error)",
@@ -1141,7 +1480,10 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 8
+ "l": 8,
+ "g": [
+ "合并实体"
+ ]
},
{
"n": "Name",
@@ -1152,7 +1494,10 @@
"p": "lifecycle",
"b": false,
"f": "plugin.go",
- "l": 14
+ "l": 14,
+ "g": [
+ "名称"
+ ]
},
{
"n": "OutputChannelRegistrar",
@@ -1163,7 +1508,11 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 317
+ "l": 317,
+ "g": [
+ "通道",
+ "频道"
+ ]
},
{
"n": "OutputChannelUnregistrar",
@@ -1174,7 +1523,11 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 324
+ "l": 324,
+ "g": [
+ "通道",
+ "频道"
+ ]
},
{
"n": "PersonProfile",
@@ -1185,18 +1538,10 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 109
- },
- {
- "n": "Plugin",
- "s": "type Plugin interface { Name() string Start(sdk *PluginSDK) error Stop() error }",
- "d": "Plugin is the interface every plugin must implement.",
- "k": "type",
- "r": "",
- "p": "lifecycle",
- "b": false,
- "f": "plugin.go",
- "l": 13
+ "l": 109,
+ "g": [
+ "人物画像"
+ ]
},
{
"n": "Plugin",
@@ -1218,18 +1563,13 @@
"p": "lifecycle",
"b": false,
"f": "plugin.go",
- "l": 653
- },
- {
- "n": "PluginMgrAPI",
- "s": "type PluginMgrAPI interface { // ReloadOne 重载单个插件（停止后重新加载）。 ReloadOne(name string) error // ListLoadedPlugins 列出已加载插件。 ListLoa …",
- "d": "PluginMgrAPI 提供插件管理能力（外部插件可调用）。",
- "k": "type",
- "r": "",
- "p": "lifecycle",
- "b": false,
- "f": "plugin.go",
- "l": 284
+ "l": 653,
+ "g": [
+ "插件管理",
+ "重载插件",
+ "禁用插件",
+ "插件管理器"
+ ]
},
{
"n": "PluginMgrAPI",
@@ -1251,7 +1591,10 @@
"p": "lifecycle",
"b": false,
"f": "plugin.go",
- "l": 397
+ "l": 397,
+ "g": [
+ "插件名"
+ ]
},
{
"n": "PluginSDK",
@@ -1273,7 +1616,10 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 46
+ "l": 46,
+ "g": [
+ "插件配置"
+ ]
},
{
"n": "PriorityL1",
@@ -1284,7 +1630,11 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 123
+ "l": 123,
+ "g": [
+ "优先级",
+ "中断级别"
+ ]
},
{
"n": "PriorityL2",
@@ -1295,7 +1645,11 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 124
+ "l": 124,
+ "g": [
+ "优先级",
+ "中断级别"
+ ]
},
{
"n": "PriorityL3",
@@ -1306,7 +1660,11 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 125
+ "l": 125,
+ "g": [
+ "优先级",
+ "中断级别"
+ ]
},
{
"n": "PriorityL4",
@@ -1317,7 +1675,11 @@
"p": "channels",
"b": true,
"f": "plugin.go",
- "l": 127
+ "l": 127,
+ "g": [
+ "优先级",
+ "中断级别"
+ ]
},
{
"n": "Purge",
@@ -1328,7 +1690,12 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 9
+ "l": 9,
+ "g": [
+ "清除",
+ "删除记忆",
+ "清除记忆"
+ ]
},
{
"n": "Query",
@@ -1339,7 +1706,10 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 75
+ "l": 75,
+ "g": [
+ "查询文档"
+ ]
},
{
"n": "RLock",
@@ -1372,7 +1742,13 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 5
+ "l": 5,
+ "g": [
+ "召回",
+ "检索记忆",
+ "召回记忆",
+ "查记忆"
+ ]
},
{
"n": "RecallPolicyAuto",
@@ -1383,7 +1759,14 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 65
+ "l": 65,
+ "g": [
+ "策略",
+ "召回",
+ "检索记忆",
+ "自动召回",
+ "默认召回"
+ ]
},
{
"n": "RecallPolicyNone",
@@ -1394,7 +1777,14 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 64
+ "l": 64,
+ "g": [
+ "策略",
+ "召回",
+ "检索记忆",
+ "不召回",
+ "关闭召回"
+ ]
},
{
"n": "RegisterDef",
@@ -1405,7 +1795,12 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 37
+ "l": 37,
+ "g": [
+ "注册配置项",
+ "声明配置",
+ "配置定义"
+ ]
},
{
"n": "RegisterInputChannel",
@@ -1416,7 +1811,15 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 561
+ "l": 561,
+ "g": [
+ "注册输入通道",
+ "收消息",
+ "接收消息",
+ "外部消息源",
+ "通道",
+ "频道"
+ ]
},
{
"n": "RegisterOnRemoveHandler",
@@ -1427,7 +1830,13 @@
"p": "lifecycle",
"b": false,
"f": "plugin.go",
- "l": 826
+ "l": 826,
+ "g": [
+ "卸载回调",
+ "删除清理",
+ "插件卸载",
+ "onRemove"
+ ]
},
{
"n": "RegisterOutputChannel",
@@ -1438,7 +1847,15 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 528
+ "l": 528,
+ "g": [
+ "注册输出通道",
+ "发消息",
+ "投递消息",
+ "输出目的地",
+ "通道",
+ "频道"
+ ]
},
{
"n": "RegisterPluginAPI",
@@ -1449,7 +1866,11 @@
"p": "lifecycle",
"b": false,
"f": "plugin.go",
- "l": 502
+ "l": 502,
+ "g": [
+ "注册插件接口",
+ "暴露接口"
+ ]
},
{
"n": "RegisterStage",
@@ -1460,7 +1881,16 @@
"p": "stages",
"b": false,
"f": "plugin.go",
- "l": 467
+ "l": 467,
+ "g": [
+ "注册阶段",
+ "阶段钩子",
+ "挂钩子",
+ "干预流程",
+ "管道钩子",
+ "阶段",
+ "钩子"
+ ]
},
{
"n": "RegisterStopHandler",
@@ -1471,7 +1901,12 @@
"p": "lifecycle",
"b": false,
"f": "plugin.go",
- "l": 801
+ "l": 801,
+ "g": [
+ "停止回调",
+ "关闭清理",
+ "插件停止"
+ ]
},
{
"n": "RegisterTool",
@@ -1482,7 +1917,18 @@
"p": "tools",
"b": false,
"f": "plugin.go",
- "l": 453
+ "l": 453,
+ "g": [
+ "注册工具",
+ "添加工具",
+ "暴露工具",
+ "工具定义",
+ "让模型调用",
+ "工具",
+ "怎么注册工具",
+ "工具怎么加",
+ "自定义工具"
+ ]
},
{
"n": "Relation",
@@ -1493,7 +1939,11 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 20
+ "l": 20,
+ "g": [
+ "关系",
+ "三元组关系"
+ ]
},
{
"n": "ReloadOne",
@@ -1504,7 +1954,10 @@
"p": "lifecycle",
"b": false,
"f": "plugin.go",
- "l": 286
+ "l": 286,
+ "g": [
+ "重载单个插件"
+ ]
},
{
"n": "Remove",
@@ -1515,7 +1968,10 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 82
+ "l": 82,
+ "g": [
+ "删除文档"
+ ]
},
{
"n": "RunOnRemoveHandlers",
@@ -1548,7 +2004,10 @@
"p": "misc",
"b": false,
"f": "plugin.go",
- "l": 10
+ "l": 10,
+ "g": [
+ "SDK 版本"
+ ]
},
{
"n": "Search",
@@ -1559,7 +2018,10 @@
"p": "memory",
"b": false,
"f": "knowledge.go",
- "l": 5
+ "l": 5,
+ "g": [
+ "搜索知识"
+ ]
},
{
"n": "Set",
@@ -1570,7 +2032,12 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 8
+ "l": 8,
+ "g": [
+ "设置",
+ "装配",
+ "写入配置"
+ ]
},
{
"n": "SetAutoRestart",
@@ -1581,7 +2048,16 @@
"p": "lifecycle",
"b": false,
"f": "plugin.go",
- "l": 784
+ "l": 784,
+ "g": [
+ "设置",
+ "装配",
+ "自动重启",
+ "崩溃自愈",
+ "故障恢复",
+ "崩溃后重启",
+ "是否自动重启"
+ ]
},
{
"n": "SetCore",
@@ -1592,7 +2068,12 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 17
+ "l": 17,
+ "g": [
+ "设置",
+ "装配",
+ "写核心配置"
+ ]
},
{
"n": "SetDocMemoryAPI",
@@ -1603,7 +2084,14 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 614
+ "l": 614,
+ "g": [
+ "设置",
+ "装配",
+ "记忆",
+ "内存",
+ "文档"
+ ]
},
{
"n": "SetEventSubscriber",
@@ -1614,7 +2102,13 @@
"p": "bridge",
"b": true,
"f": "plugin.go",
- "l": 638
+ "l": 638,
+ "g": [
+ "设置",
+ "装配",
+ "事件",
+ "订阅"
+ ]
},
{
"n": "SetIOInjector",
@@ -1625,7 +2119,11 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 595
+ "l": 595,
+ "g": [
+ "设置",
+ "装配"
+ ]
},
{
"n": "SetInputChannelRegistrar",
@@ -1636,7 +2134,13 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 588
+ "l": 588,
+ "g": [
+ "设置",
+ "装配",
+ "通道",
+ "频道"
+ ]
},
{
"n": "SetKnowledgeAPI",
@@ -1647,7 +2151,13 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 620
+ "l": 620,
+ "g": [
+ "设置",
+ "装配",
+ "知识库",
+ "知识"
+ ]
},
{
"n": "SetLLMAPI",
@@ -1658,7 +2168,11 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 626
+ "l": 626,
+ "g": [
+ "设置",
+ "装配"
+ ]
},
{
"n": "SetMemoryAPI",
@@ -1669,7 +2183,13 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 602
+ "l": 602,
+ "g": [
+ "设置",
+ "装配",
+ "记忆",
+ "内存"
+ ]
},
{
"n": "SetOutputChannelRegistrar",
@@ -1680,7 +2200,13 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 574
+ "l": 574,
+ "g": [
+ "设置",
+ "装配",
+ "通道",
+ "频道"
+ ]
},
{
"n": "SetOutputChannelUnregistrar",
@@ -1691,7 +2217,13 @@
"p": "bridge",
"b": true,
"f": "plugin.go",
- "l": 581
+ "l": 581,
+ "g": [
+ "设置",
+ "装配",
+ "通道",
+ "频道"
+ ]
},
{
"n": "SetPlugin",
@@ -1702,7 +2234,12 @@
"p": "settings",
"b": false,
"f": "settings.go",
- "l": 31
+ "l": 31,
+ "g": [
+ "设置",
+ "装配",
+ "写插件配置"
+ ]
},
{
"n": "SetPluginMgrAPI",
@@ -1713,7 +2250,14 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 645
+ "l": 645,
+ "g": [
+ "设置",
+ "装配",
+ "插件管理",
+ "重载插件",
+ "禁用插件"
+ ]
},
{
"n": "SetSocialAPI",
@@ -1724,7 +2268,14 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 632
+ "l": 632,
+ "g": [
+ "设置",
+ "装配",
+ "社交",
+ "关系",
+ "联系人"
+ ]
},
{
"n": "SetSource",
@@ -1735,7 +2286,12 @@
"p": "llm",
"b": false,
"f": "llm.go",
- "l": 6
+ "l": 6,
+ "g": [
+ "设置",
+ "装配",
+ "切换模型"
+ ]
},
{
"n": "SetTextMemoryAPI",
@@ -1746,18 +2302,13 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 608
- },
- {
- "n": "SetToolBlocks",
- "s": "SetToolBlocks(blocks []ContentBlock)",
- "d": "SetToolBlocks 插件工具注入多模态内容块（image_url/audio_url），内核在下一条",
- "k": "method",
- "r": "IOInjector",
- "p": "channels",
- "b": false,
- "f": "plugin.go",
- "l": 229
+ "l": 608,
+ "g": [
+ "设置",
+ "装配",
+ "记忆",
+ "内存"
+ ]
},
{
"n": "SetToolBlocks",
@@ -1768,7 +2319,34 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 772
+ "l": 772,
+ "g": [
+ "设置",
+ "装配",
+ "工具",
+ "工具返回图片",
+ "多模态返回",
+ "让模型看图"
+ ]
+ },
+ {
+ "n": "SetToolBlocks",
+ "s": "SetToolBlocks(blocks []ContentBlock)",
+ "d": "SetToolBlocks 插件工具注入多模态内容块（image_url/audio_url），内核在下一条",
+ "k": "method",
+ "r": "IOInjector",
+ "p": "channels",
+ "b": false,
+ "f": "plugin.go",
+ "l": 229,
+ "g": [
+ "设置",
+ "装配",
+ "工具",
+ "工具返回图片",
+ "多模态返回",
+ "让模型看图"
+ ]
},
{
"n": "Settings",
@@ -1779,7 +2357,11 @@
"p": "settings",
"b": false,
"f": "plugin.go",
- "l": 401
+ "l": 401,
+ "g": [
+ "设置",
+ "装配"
+ ]
},
{
"n": "SettingsAPI",
@@ -1792,17 +2374,6 @@
"f": "",
"l": 0
},
- {
- "n": "SettingsAPI",
- "s": "type SettingsAPI interface { // Get reads the plugin's own config value (config_\u003cname\u003e table). Get(key string) (interface{}, error) // Set writes a config value to the plugi …",
- "d": "",
- "k": "type",
- "r": "",
- "p": "settings",
- "b": false,
- "f": "settings.go",
- "l": 3
- },
{
"n": "Social",
"s": "func (s *PluginSDK) Social() SocialAPI",
@@ -1812,18 +2383,12 @@
"p": "memory",
"b": false,
"f": "plugin.go",
- "l": 439
- },
- {
- "n": "SocialAPI",
- "s": "type SocialAPI interface { GetPerson(name string) (*PersonProfile, error) GetTrait(name, trait string) (string, bool) GetRelations(name string) ([]SocialRelation, error) G …",
- "d": "SocialAPI provides read-only access to the social graph (person profiles and relationships).",
- "k": "type",
- "r": "",
- "p": "memory",
- "b": false,
- "f": "memory.go",
- "l": 100
+ "l": 439,
+ "g": [
+ "社交",
+ "关系",
+ "联系人"
+ ]
},
{
"n": "SocialAPI",
@@ -1845,7 +2410,13 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 116
+ "l": 116,
+ "g": [
+ "社交",
+ "关系",
+ "联系人",
+ "社交关系"
+ ]
},
{
"n": "Stage",
@@ -1856,7 +2427,13 @@
"p": "stages",
"b": false,
"f": "plugin.go",
- "l": 26
+ "l": 26,
+ "g": [
+ "阶段",
+ "钩子",
+ "阶段名",
+ "管线阶段"
+ ]
},
{
"n": "StageAfterOutput",
@@ -1867,7 +2444,11 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 35
+ "l": 35,
+ "g": [
+ "阶段",
+ "钩子"
+ ]
},
{
"n": "StageAfterToolcall",
@@ -1878,7 +2459,12 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 33
+ "l": 33,
+ "g": [
+ "阶段",
+ "钩子",
+ "工具"
+ ]
},
{
"n": "StageBeforeOutput",
@@ -1889,7 +2475,11 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 34
+ "l": 34,
+ "g": [
+ "阶段",
+ "钩子"
+ ]
},
{
"n": "StageBeforeToolcall",
@@ -1900,7 +2490,12 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 32
+ "l": 32,
+ "g": [
+ "阶段",
+ "钩子",
+ "工具"
+ ]
},
{
"n": "StageContext",
@@ -1911,7 +2506,13 @@
"p": "stages",
"b": false,
"f": "plugin.go",
- "l": 148
+ "l": 148,
+ "g": [
+ "阶段",
+ "钩子",
+ "阶段上下文",
+ "读写消息"
+ ]
},
{
"n": "StageHandler",
@@ -1922,7 +2523,12 @@
"p": "stages",
"b": false,
"f": "plugin.go",
- "l": 23
+ "l": 23,
+ "g": [
+ "阶段",
+ "钩子",
+ "阶段处理函数"
+ ]
},
{
"n": "StageOnInput",
@@ -1933,7 +2539,11 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 29
+ "l": 29,
+ "g": [
+ "阶段",
+ "钩子"
+ ]
},
{
"n": "StagePostAction",
@@ -1944,7 +2554,11 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 31
+ "l": 31,
+ "g": [
+ "阶段",
+ "钩子"
+ ]
},
{
"n": "StagePreAction",
@@ -1955,7 +2569,11 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 30
+ "l": 30,
+ "g": [
+ "阶段",
+ "钩子"
+ ]
},
{
"n": "StageRegistrar",
@@ -1966,7 +2584,11 @@
"p": "stages",
"b": false,
"f": "plugin.go",
- "l": 308
+ "l": 308,
+ "g": [
+ "阶段",
+ "钩子"
+ ]
},
{
"n": "StageScope",
@@ -1977,7 +2599,13 @@
"p": "stages",
"b": false,
"f": "plugin.go",
- "l": 294
+ "l": 294,
+ "g": [
+ "阶段",
+ "钩子",
+ "阶段作用域",
+ "只看自己的调用"
+ ]
},
{
"n": "StageScopeGlobal",
@@ -1988,7 +2616,11 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 298
+ "l": 298,
+ "g": [
+ "阶段",
+ "钩子"
+ ]
},
{
"n": "StageScopeOwnTools",
@@ -1999,7 +2631,12 @@
"p": "constants",
"b": false,
"f": "plugin.go",
- "l": 301
+ "l": 301,
+ "g": [
+ "阶段",
+ "钩子",
+ "工具"
+ ]
},
{
"n": "Start",
@@ -2010,7 +2647,10 @@
"p": "lifecycle",
"b": false,
"f": "plugin.go",
- "l": 15
+ "l": 15,
+ "g": [
+ "启动"
+ ]
},
{
"n": "Stats",
@@ -2021,7 +2661,10 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 83
+ "l": 83,
+ "g": [
+ "统计"
+ ]
},
{
"n": "Stop",
@@ -2032,7 +2675,11 @@
"p": "lifecycle",
"b": false,
"f": "plugin.go",
- "l": 16
+ "l": 16,
+ "g": [
+ "停止",
+ "关闭"
+ ]
},
{
"n": "Subscribe",
@@ -2054,7 +2701,11 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 65
+ "l": 65,
+ "g": [
+ "事件",
+ "订阅"
+ ]
},
{
"n": "TextMemory",
@@ -2065,18 +2716,11 @@
"p": "memory",
"b": false,
"f": "plugin.go",
- "l": 411
- },
- {
- "n": "TextMemoryAPI",
- "s": "type TextMemoryAPI interface { Append(evt TextEvent) error }",
- "d": "TextMemoryAPI provides access to chronological text event storage.",
- "k": "type",
- "r": "",
- "p": "memory",
- "b": false,
- "f": "memory.go",
- "l": 43
+ "l": 411,
+ "g": [
+ "记忆",
+ "内存"
+ ]
},
{
"n": "TextMemoryAPI",
@@ -2098,7 +2742,11 @@
"p": "tools",
"b": false,
"f": "plugin.go",
- "l": 186
+ "l": 186,
+ "g": [
+ "工具",
+ "工具调用"
+ ]
},
{
"n": "ToolDef",
@@ -2109,7 +2757,13 @@
"p": "tools",
"b": false,
"f": "plugin.go",
- "l": 203
+ "l": 203,
+ "g": [
+ "工具",
+ "工具定义",
+ "工具描述",
+ "参数表"
+ ]
},
{
"n": "ToolHandler",
@@ -2120,7 +2774,12 @@
"p": "tools",
"b": false,
"f": "plugin.go",
- "l": 20
+ "l": 20,
+ "g": [
+ "工具",
+ "工具实现",
+ "处理函数"
+ ]
},
{
"n": "ToolRegistrar",
@@ -2131,7 +2790,10 @@
"p": "bridge",
"b": false,
"f": "plugin.go",
- "l": 305
+ "l": 305,
+ "g": [
+ "工具"
+ ]
},
{
"n": "ToolResult",
@@ -2142,7 +2804,12 @@
"p": "tools",
"b": false,
"f": "plugin.go",
- "l": 194
+ "l": 194,
+ "g": [
+ "工具",
+ "工具结果",
+ "返回值"
+ ]
},
{
"n": "Triple",
@@ -2153,7 +2820,10 @@
"p": "memory",
"b": false,
"f": "memory.go",
- "l": 31
+ "l": 31,
+ "g": [
+ "三元组"
+ ]
},
{
"n": "Unlock",
@@ -2175,7 +2845,13 @@
"p": "misc",
"b": true,
"f": "plugin.go",
- "l": 539
+ "l": 539,
+ "g": [
+ "通道",
+ "频道",
+ "注销输出通道",
+ "删除通道"
+ ]
},
{
"n": "ValidContextPolicy",
@@ -2186,7 +2862,11 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 49
+ "l": 49,
+ "g": [
+ "策略",
+ "校验裁剪策略"
+ ]
},
{
"n": "ValidRecallPolicy",
@@ -2197,6 +2877,12 @@
"p": "channels",
"b": false,
"f": "plugin.go",
- "l": 69
+ "l": 69,
+ "g": [
+ "策略",
+ "召回",
+ "检索记忆",
+ "校验召回策略"
+ ]
}
]
diff --git a/docs/javascripts/api-search.js b/docs/javascripts/api-search.js
index 0df45a2..489f146 100644
--- a/docs/javascripts/api-search.js
+++ b/docs/javascripts/api-search.js
@@ -65,6 +65,17 @@
else if (name.indexOf(ql) === 0) s += 600;
else if (name.indexOf(ql) > 0) s += 350;
+ // 中文检索关键词（keywords.json 产出，字段 g）。
+ // 为什么需要：SDK 里 66/100 个符号是英文注释（`RegisterTool registers a
+ // tool that the LLM can call.`），懂中文的人搜「注册工具」会一条都找不到。
+ // 关键词命中给较高权重（仅次于名称精确命中），因为它就是为「按功能找」准备的。
+ var kws = item.g || [];
+ for (var ki = 0; ki < kws.length; ki++) {
+ var kw = String(kws[ki]).toLowerCase();
+ if (kw === ql) { s += 480; break; }
+ if (kw.indexOf(ql) >= 0) { s += 300; break; }
+ }
+
// 限定符：PluginSDK.RegisterTool / IOInjector.InjectText。
// 额外支持「去掉 API/SDK 后缀」与「去掉点号」两种写法，
// 因为读者习惯写 `memory.recall`（RPC 名），而 Go 名是 `MemoryAPI.Recall`。
@@ -94,13 +105,17 @@
}
// 中文按字匹配：中文没有词边界，逐字命中比整串更实用。
+ // 注意只把它当作**弱信号**：光靠逐字会把「注册工具」匹到凡是含「工具」
+ // 字样的任何东西（实测 ContextPolicyNone 的说明里有「工具调用」也会命中）。
+ // 所以阈值卡在 60% 以上才算有效命中。
if (/[\u4e00-\u9fa5]/.test(q)) {
var hit = 0;
+ var hay = desc + " " + kws.join(" ");
for (var i = 0; i < q.length; i++) {
- if (desc.indexOf(q[i]) >= 0) hit++;
+ if (hay.indexOf(q[i]) >= 0) hit++;
}
- if (hit === q.length) s += 100; // 全部字都出现
- else s += hit * 8;
+ var ratio = hit / q.length;
+ if (ratio >= 0.6) s += Math.round(hit * 6);
}
// 公开 API 略优先于「仅内置」——后者通常是噪声。
@@ -173,6 +188,10 @@
var d = el("span", "api-desc", it.d);
li.appendChild(d);
}
+ // 关键词是给检索用的；显示出来能让读者明白“为什么这条被匹配到”。
+ if (it.g && it.g.length) {
+ li.appendChild(el("span", "api-kw", it.g.slice(0, 6).join(" · ")));
+ }
if (it.f) {
li.appendChild(el("span", "api-loc", it.f + (it.l ? ":" + it.l : "")));
}
diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css
index c2864a1..e923d74 100644
--- a/docs/stylesheets/extra.css
+++ b/docs/stylesheets/extra.css
@@ -71,6 +71,14 @@
color: var(--md-default-fg-color--light);
}
+/* 「为何命中」的中文关键词（keywords.json 产出）。 */
+.api-kw {
+ flex-basis: 100%;
+ font-size: 0.7rem;
+ color: var(--md-accent-fg-color);
+ opacity: 0.9;
+}
+
.api-loc {
flex-basis: 100%;
font-size: 0.68rem;
diff --git a/tools/apidoc/gensite/keywords.go b/tools/apidoc/gensite/keywords.go
new file mode 100644
index 0000000..a549317
--- /dev/null
+++ b/tools/apidoc/gensite/keywords.go
@@ -0,0 +1,94 @@
+package main
+
+import (
+ "encoding/json"
+ "fmt"
+ "os"
+ "path/filepath"
+ "strings"
+)
+
+// 中文检索关键词。
+//
+// 问题：SDK 里 100 个有摘要的符号中 **66 个是英文注释**
+// （`RegisterTool registers a tool that the LLM can call.`），
+// 于是搜「注册工具」找不到 RegisterTool —— 而受众主要是中文。
+//
+// 解法不是翻译源码注释（那会让代码与文档脱节），而是给检索索引补一层
+// **人工标注的功能词**：不影响页面展示，只让中文能搜到。
+//
+// 词表在 tools/apidoc/keywords.json。规则用「前缀 → 词」批量覆盖
+// （Register* 全带「注册」），少数重点符号再逐条补充。
+type keywordTable struct {
+ Rules []keywordRule `json:"rules"`
+ Symbols map[string][]string `json:"symbols"`
+}
+
+type keywordRule struct {
+ // Prefix 匹配符号名前缀；Contains 匹配名字里是否含该子串。二选一。
+ Prefix string `json:"prefix,omitempty"`
+ Contains string `json:"contains,omitempty"`
+ Words []string `json:"words"`
+}
+
+// loadKeywords 读词表。找不到就返回空表（不报错中断）——
+// 检索关键词是**增强**，缺失时退化为原行为，不该让构建失败。
+func loadKeywords() (*keywordTable, error) {
+ path := keywordPath()
+ data, err := os.ReadFile(path)
+ if err != nil {
+ return &keywordTable{}, err
+ }
+ var t keywordTable
+ if err := json.Unmarshal(data, &t); err != nil {
+ return &keywordTable{}, fmt.Errorf("解析 %s: %w", path, err)
+ }
+ return &t, nil
+}
+
+// lookup 返回某符号的中文检索词（可能为空）。
+func (t *keywordTable) lookup(name, docBrief string) []string {
+ if t == nil {
+ return nil
+ }
+ seen := map[string]bool{}
+ var out []string
+ add := func(ws []string) {
+ for _, w := range ws {
+ w = strings.TrimSpace(w)
+ if w == "" || seen[w] {
+ continue
+ }
+ seen[w] = true
+ out = append(out, w)
+ }
+ }
+ for _, r := range t.Rules {
+ if r.Prefix != "" && strings.HasPrefix(name, r.Prefix) {
+ add(r.Words)
+ }
+ if r.Contains != "" && strings.Contains(name, r.Contains) {
+ add(r.Words)
+ }
+ }
+ add(t.Symbols[name])
+ return out
+}
+
+// keywordPath 找 keywords.json：可执行文件旁 → 源码目录 → 工作目录。
+func keywordPath() string {
+ candidates := []string{}
+ if exe, err := os.Executable(); err == nil {
+ candidates = append(candidates, filepath.Join(filepath.Dir(exe), "keywords.json"))
+ }
+ candidates = append(candidates,
+ filepath.Join("tools", "apidoc", "keywords.json"),
+ "keywords.json",
+ )
+ for _, c := range candidates {
+ if _, err := os.Stat(c); err == nil {
+ return c
+ }
+ }
+ return candidates[0]
+}
diff --git a/tools/apidoc/gensite/main.go b/tools/apidoc/gensite/main.go
index 7ea6159..78d64d1 100644
--- a/tools/apidoc/gensite/main.go
+++ b/tools/apidoc/gensite/main.go
@@ -180,7 +180,7 @@ func main() {
log.Fatal(err)
}
- // 先收集所有待渲染的符号名，再扫 example/ 取真实用法。
+ // 收集所有待渲染的符号名，再扫 example/ 取真实用法。
want := map[string]bool{}
for _, s := range pkg.Symbols {
if s.Exported {
@@ -192,25 +192,41 @@ func main() {
}
usages := scanUsages(*exDir, want)
+ // 中文检索关键词（弥补英文注释搜不到中文的问题）。
+ kw, err := loadKeywords()
+ if err != nil {
+ log.Printf("警告：未加载中文检索关键词（%v），中文检索将只能命中中文注释", err)
+ }
+
used := map[string]bool{}
var index []indexEntry
for _, sec := range sections {
+ // 本节的接口（先算出来，下面要用它排除重复的 type 符号）。
+ var ifaces []Interface
+ ifaceNames := map[string]bool{}
+ for _, it := range pkg.Interfaces {
+ if sec.Match(Symbol{Kind: "type", Name: it.Name}) {
+ ifaces = append(ifaces, it)
+ ifaceNames[it.Name] = true
+ }
+ }
+
var picked []Symbol
for _, s := range pkg.Symbols {
if !s.Exported || !sec.Match(s) || used[key(s)] {
continue
}
+ // 接口已作为 ifaces 单独渲染（带方法表），这里跳过它的 `type`
+ // 符号，否则同一个接口会既出现在符号区、又出现在接口区，
+ // 检索索引里也会出现两条。
+ if s.Kind == "type" && ifaceNames[s.Name] {
+ used[key(s)] = true
+ continue
+ }
picked = append(picked, s)
used[key(s)] = true
}
- // 该章节涉及的接口（其方法单独列在接口下，避免重复）。
- var ifaces []Interface
- for _, it := range pkg.Interfaces {
- if sec.Match(Symbol{Kind: "type", Name: it.Name}) {
- ifaces = append(ifaces, it)
- }
- }
if len(picked) == 0 && len(ifaces) == 0 {
continue
}
@@ -224,6 +240,7 @@ func main() {
N: s.Name, S: s.Signature, D: s.DocBrief,
K: s.Kind, R: s.Recv, P: sec.File,
B: s.BuiltinOnly, F: s.File, L: s.Line,
+ G: kw.lookup(s.Name, s.DocBrief),
})
}
// 接口本身与其方法也要进索引。此前只加了顶层符号，导致
@@ -238,6 +255,7 @@ func main() {
N: m.Name, S: m.Signature, D: m.DocBrief,
K: "method", R: it.Name, P: sec.File,
B: m.BuiltinOnly, F: m.File, L: m.Line,
+ G: kw.lookup(m.Name, m.DocBrief),
})
}
}
@@ -253,6 +271,7 @@ func main() {
index = append(index, indexEntry{
N: c.Name, S: "const " + c.Name, D: c.DocBrief,
K: "const", P: "constants", F: c.File, L: c.Line,
+ G: kw.lookup(c.Name, c.DocBrief),
})
}
}
@@ -300,6 +319,14 @@ type indexEntry struct {
B bool `json:"b"` // 仅内置
F string `json:"f"` // 源文件
L int `json:"l"` // 行号
+ // G 是中文检索关键词（同义词/功能词）。
+ //
+ // 为什么需要：SDK 里 100 个有摘要的符号中 **66 个是英文注释**
+ // （`RegisterTool registers a tool that the LLM can call.`），
+ // 于是搜「注册工具」根本找不到 RegisterTool —— 而中文是主要受众。
+ // 这些词由 tools/apidoc/keywords.json 维护，不改源码注释，
+ // 也不依赖机器翻译。
+ G []string `json:"g,omitempty"`
}
func key(s Symbol) string {
@@ -522,16 +549,19 @@ func renderExamples(usages map[string][]Usage) string {
return b.String()
}
-// dedupeIndex 按「接收者.名称」去重。无接收者的用「类别.名称」。
-// 同名但不同接收者（如 MemoryAPI.Recall 与 IOInjector.InjectText）都保留。
+// dedupeIndex 按「接收者.名称.类别」去重。
+//
+// 为什么带类别：接口会被两条路径加进索引——一次作为 `type` 符号（来自
+// pkg.Symbols），一次作为接口本身（来自 pkg.Interfaces）。两者名字相同、
+// 接收者都为空，只用「名称」做键漏不掉；带上类别才能区分（并且保留两条
+// 也不算错，但会让结果重复，所以统一按 kind 去重）。
+//
+// 同名但不同接收者的（如 MemoryAPI.Recall 与 IOInjector.InjectText）都保留。
func dedupeIndex(in []indexEntry) []indexEntry {
seen := map[string]bool{}
out := in[:0]
for _, e := range in {
- k := e.R + "." + e.N
- if e.R == "" {
- k = e.K + "." + e.N
- }
+ k := e.K + "|" + e.R + "." + e.N
if seen[k] {
continue
}
diff --git a/tools/apidoc/keywords.json b/tools/apidoc/keywords.json
new file mode 100644
index 0000000..ac0c6f8
--- /dev/null
+++ b/tools/apidoc/keywords.json
@@ -0,0 +1,159 @@
+{
+ "_doc": [
+ "中文检索关键词：只影响**检索**，不影响页面展示。",
+ "",
+ "背景：SDK 里 100 个有摘要的符号中 66 个是英文注释，中文搜不到。",
+ "例如 `RegisterTool registers a tool that the LLM can call.` —— 搜「注册工具」命中 0。",
+ "",
+ "规则：",
+ " rules[].prefix 符号名前缀匹配（如 Register 开头的都带「注册」）",
+ " rules[].contains 符号名含该子串即匹配",
+ " symbols[名] 逐符号补充（用于重点 API 或规则覆盖不到的）",
+ "",
+ "写法要求：词要贴近读者会敲的字，宁多勿少；不必去重，代码会去。",
+ "注意别把词撒太宽（如给所有 Get* 都加「查询」会让结果变噪）。"
+ ],
+
+ "rules": [
+ { "prefix": "RegisterTool", "words": ["注册工具", "添加工具", "暴露工具", "工具定义", "让模型调用"] },
+ { "prefix": "RegisterStage", "words": ["注册阶段", "阶段钩子", "挂钩子", "干预流程", "管道钩子"] },
+ { "prefix": "RegisterInputChannel", "words": ["注册输入通道", "收消息", "接收消息", "外部消息源"] },
+ { "prefix": "RegisterOutputChannel", "words": ["注册输出通道", "发消息", "投递消息", "输出目的地"] },
+ { "prefix": "RegisterPluginAPI", "words": ["注册插件接口", "暴露接口"] },
+ { "prefix": "RegisterStopHandler", "words": ["停止回调", "关闭清理", "插件停止"] },
+ { "prefix": "RegisterOnRemoveHandler", "words": ["卸载回调", "删除清理", "插件卸载", "onRemove"] },
+ { "prefix": "RegisterDef", "words": ["注册配置项", "声明配置", "配置定义"] },
+
+ { "prefix": "InjectText", "words": ["注入文本", "注入消息", "投喂输入", "灌入内容"] },
+ { "prefix": "InjectInterrupt", "words": ["中断注入", "插话", "打断", "抢占"] },
+ { "prefix": "InjectInput", "words": ["注入输入", "投喂输入", "模拟用户输入"] },
+ { "prefix": "InjectMedia", "words": ["注入媒体", "发图片", "发音频"] },
+
+ { "prefix": "Set", "words": ["设置", "装配"] },
+
+ { "contains": "AutoRestart", "words": ["自动重启", "崩溃自愈", "故障恢复"] },
+ { "contains": "Priority", "words": ["优先级", "中断级别"] },
+ { "contains": "Policy", "words": ["策略"] },
+ { "contains": "Memory", "words": ["记忆", "内存"] },
+ { "contains": "Knowledge", "words": ["知识库", "知识"] },
+ { "contains": "Recall", "words": ["召回", "检索记忆"] },
+ { "contains": "Media", "words": ["媒体", "图片", "音频"] },
+ { "contains": "Channel", "words": ["通道", "频道"] },
+ { "contains": "Event", "words": ["事件", "订阅"] },
+ { "contains": "Stage", "words": ["阶段", "钩子"] },
+ { "contains": "Tool", "words": ["工具"] },
+ { "contains": "Doc", "words": ["文档"] },
+ { "contains": "Social", "words": ["社交", "关系", "联系人"] },
+ { "contains": "Purge", "words": ["清除", "删除记忆"] },
+ { "contains": "PluginMgr", "words": ["插件管理", "重载插件", "禁用插件"] }
+ ],
+
+ "symbols": {
+ "RegisterTool": ["怎么注册工具", "工具怎么加", "自定义工具"],
+ "UnregisterOutputChannel": ["注销输出通道", "删除通道"],
+ "SetToolBlocks": ["工具返回图片", "多模态返回", "让模型看图"],
+ "ContentBlock": ["多模态内容块", "图片块", "音频块"],
+ "SetAutoRestart": ["崩溃后重启", "是否自动重启"],
+ "AutoRestart": ["查询是否自动重启"],
+
+ "ToolDef": ["工具定义", "工具描述", "参数表"],
+ "ToolHandler": ["工具实现", "处理函数"],
+ "ToolCall": ["工具调用"],
+ "ToolResult": ["工具结果", "返回值"],
+
+ "Stage": ["阶段名", "管线阶段"],
+ "StageHandler": ["阶段处理函数"],
+ "StageContext": ["阶段上下文", "读写消息"],
+ "StageScope": ["阶段作用域", "只看自己的调用"],
+
+ "InjectOptions": ["注入选项", "是否记入记忆", "是否裁剪上下文"],
+ "ContextPolicyNone": ["不裁剪上下文", "默认裁剪策略"],
+ "ContextPolicyPrune": ["裁剪上下文", "归档丢弃"],
+ "RecallPolicyNone": ["不召回", "关闭召回"],
+ "RecallPolicyAuto": ["自动召回", "默认召回"],
+
+ "MemoryAPI": ["图记忆接口", "三元组记忆"],
+ "TextMemoryAPI": ["文本记忆接口", "事件流水"],
+ "DocMemoryAPI": ["文档记忆接口", "文档向量"],
+ "KnowledgeAPI": ["知识库接口"],
+ "LLMAPI": ["调用模型接口", "LLM 接口"],
+ "SocialAPI": ["社交接口", "人物画像"],
+ "SettingsAPI": ["配置接口"],
+ "IOInjector": ["注入器接口", "投喂输入"],
+ "PluginMgrAPI": ["插件管理接口"],
+ "EventSubscriber": ["事件订阅接口"],
+ "Plugin": ["插件接口", "插件契约"],
+
+ "Entity": ["实体", "记忆主体"],
+ "Relation": ["关系", "三元组关系"],
+ "Triple": ["三元组"],
+ "Doc": ["文档对象"],
+ "MediaAttachment": ["媒体附件"],
+ "ConfigDef": ["配置项定义"],
+ "ChannelDef": ["通道定义"],
+ "PersonProfile": ["人物画像"],
+ "SocialRelation": ["社交关系"],
+
+ "Recall": ["召回记忆", "查记忆"],
+ "Commit": ["写入记忆", "提交三元组"],
+ "Introspect": ["查看记忆", "记忆概览"],
+ "MergeEntities": ["合并实体"],
+ "Purge": ["清除记忆", "删除记忆"],
+ "Insert": ["插入文档"],
+ "InsertWithMedia": ["插入带媒体文档"],
+ "Query": ["查询文档"],
+ "Remove": ["删除文档"],
+ "Stats": ["统计"],
+ "Append": ["追加文本"],
+ "Add": ["添加知识"],
+ "Search": ["搜索知识"],
+ "List": ["列出"],
+ "Get": ["读取配置"],
+ "Set": ["写入配置"],
+ "Defs": ["配置定义列表"],
+ "Dump": ["导出配置"],
+ "Plugins": ["插件配置"],
+
+ "PluginName": ["插件名"],
+ "PluginStop": ["停止插件"],
+ "PluginStart": ["启动插件"],
+ "Start": ["启动"],
+ "Stop": ["停止", "关闭"],
+ "Name": ["名称"],
+ "Events": ["事件订阅", "监听事件"],
+ "PluginMgr": ["插件管理器", "重载插件"],
+ "ReloadOne": ["重载单个插件"],
+ "ReloadPlugins": ["重载全部插件"],
+ "ListLoadedPlugins": ["已加载插件列表"],
+ "ListDisabledPlugins": ["已禁用插件列表"],
+ "IsPluginDisabled": ["查插件是否被禁用"],
+ "DisablePlugin": ["禁用插件"],
+ "EnablePlugin": ["启用插件"],
+ "RemovePlugin": ["卸载插件", "删除插件"],
+
+ "GetPerson": ["查人物"],
+ "GetTrait": ["查特征"],
+ "GetRelations": ["查关系"],
+ "GetNetwork": ["查关系网"],
+ "ListPersons": ["列出人物"],
+ "CurrentSource": ["当前模型来源"],
+ "ListSources": ["列出模型来源"],
+ "SetSource": ["切换模型"],
+ "DataDir": ["数据目录"],
+ "GetCore": ["读核心配置"],
+ "SetCore": ["写核心配置"],
+ "GetPlugin": ["读插件配置"],
+ "SetPlugin": ["写插件配置"],
+ "ListCore": ["列出核心配置"],
+ "ListPlugin": ["列出插件配置"],
+
+ "CapText": ["文本能力"],
+ "CapFile": ["文件能力"],
+ "CapImage": ["图片能力"],
+ "CapAudio": ["音频能力"],
+ "CapStructured": ["结构化能力"],
+ "SDKVersion": ["SDK 版本"],
+ "ValidContextPolicy": ["校验裁剪策略"],
+ "ValidRecallPolicy": ["校验召回策略"]
+ }
+}