fix: update links and comments for clarity in plugin.md

Author: Soulter

dev/star/plugin.md

@@ -640,7 +640,7 @@ async def test(self, event: AstrMessageEvent):
 
 > 当前适配情况：仅 aiocqhttp
 
-QQ 表情 ID 参考：https://bot.q.qq.com/wiki/develop/api-v2/openapi/emoji/model.html#EmojiType
+QQ 表情 ID 参考：<https://bot.q.qq.com/wiki/develop/api-v2/openapi/emoji/model.html#EmojiType>
 
 ```python
 from astrbot.api.event import filter, AstrMessageEvent
@@ -653,7 +653,6 @@ async def test(self, event: AstrMessageEvent):
 
 ![发送 QQ 表情](../../source/images/plugin/image-5.png)
 
-
 ### 控制事件传播
 
 ```python{6}
@@ -764,7 +763,6 @@ class ConfigPlugin(Star):
 
 如果您在发布不同版本时更新了 Schema，请注意，AstrBot 会递归检查 Schema 的配置项，如果发现配置文件中缺失了某个配置项，会自动添加默认值。但是 AstrBot 不会删除配置文件中**多余的**配置项，即使这个配置项在新的 Schema 中不存在（您在新的 Schema 中删除了这个配置项）。
 
-
 ### 文转图
 
 #### 基本
@@ -942,8 +940,6 @@ await empty_mention_waiter(event, session_filter=CustomFilter()) # 这里传入
 
 甚至，可以使用这个特性来让群内组队！
 
-
-
 ### AI
 
 #### 通过提供商调用 LLM
@@ -980,8 +976,8 @@ async def test(self, event: AstrMessageEvent):
 - `model`(str): 可选。用于强制指定使用的模型。默认使用这个提供商默认配置的模型。
 - `tool_calls_result`(dict): 可选。用于传入工具调用的结果。
 
-
 ::: details LLMResponse 类型定义
+
 ```py
 
 @dataclass
@@ -1078,6 +1074,7 @@ class LLMResponse:
             )
         return ret
 ```
+
 :::
 
 #### 获取其他类型的提供商
@@ -1090,7 +1087,6 @@ class LLMResponse:
 - 获取所有语音合成提供商: `self.context.get_all_tts_providers()`。
 - 获取所有嵌入提供商: `self.context.get_all_embedding_providers()`。
 
-
 ::: details STTProvider / TTSProvider / EmbeddingProvider 类型定义
 
 ```py
@@ -1158,8 +1154,8 @@ from dataclasses import dataclass, field
 
 @dataclass
 class HelloWorldTool(FunctionTool):
-    name: str = "hello_world"
-    description: str = "Say hello to the world."
+    name: str = "hello_world" # 工具名称
+    description: str = "Say hello to the world." # 工具描述
     parameters: dict = field(
         default_factory=lambda: {
             "type": "object",
@@ -1171,12 +1167,12 @@ class HelloWorldTool(FunctionTool):
             },
             "required": ["greeting"],
         }
-    )
+    ) # 工具参数定义，见 OpenAI 官网或 https://json-schema.org/understanding-json-schema/
 
     async def run(
         self,
-        event: AstrMessageEvent,
-        greeting: str,
+        event: AstrMessageEvent, # 必须包含此 event 参数在前面，用于获取上下文
+        greeting: str, # 工具参数，必须与 parameters 中定义的参数名一致
     ):
         return f"{greeting}, World!" # 也支持 mcp.types.CallToolResult 类型
 ```
@@ -1221,6 +1217,7 @@ async def get_weather(self, event: AstrMessageEvent, location: str) -> MessageEv
 
 > [!NOTE]
 > 对于装饰器注册的 llm_tool，如果需要调用 Provider.text_chat()，func_tool（ToolSet 类型） 可以通过以下方式获取：
+>
 > ```py
 > func_tool = self.context.get_llm_tool_manager() # 获取 AstrBot 的 LLM Tool Manager，包含了所有插件和 MCP 注册的 Tool
 > tool = func_tool.get_func("xxx")
@@ -1242,8 +1239,8 @@ curr_cid = await conv_mgr.get_curr_conversation_id(uid)
 conversation = await conv_mgr.get_conversation(uid, curr_cid)  # Conversation
 ```
 
-
 ::: details Conversation 类型定义
+
 ```py
 @dataclass
 class Conversation:
@@ -1267,13 +1264,13 @@ class Conversation:
     created_at: int = 0
     updated_at: int = 0
 ```
-:::
-
 
+:::
 
 **所有方法**
 
 ##### `new_conversation`
+
 - **Usage**  
   在当前会话中新建一条对话，并自动切换为该对话。
 - **Arguments**  
@@ -1286,6 +1283,7 @@ class Conversation:
   `str` – 新生成的 UUID 对话 ID
 
 ##### `switch_conversation`
+
 - **Usage**  
   将会话切换到指定的对话。
 - **Arguments**  
@@ -1295,6 +1293,7 @@ class Conversation:
   `None`
 
 ##### `delete_conversation`
+
 - **Usage**  
   删除会话中的某条对话；若 `conversation_id` 为 `None`，则删除当前对话。
 - **Arguments**  
@@ -1304,6 +1303,7 @@ class Conversation:
   `None`
 
 ##### `get_curr_conversation_id`
+
 - **Usage**  
   获取当前会话正在使用的对话 ID。
 - **Arguments**  
@@ -1312,6 +1312,7 @@ class Conversation:
   `str | None` – 当前对话 ID，不存在时返回 `None`
 
 ##### `get_conversation`
+
 - **Usage**  
   获取指定对话的完整对象；若不存在且 `create_if_not_exists=True` 则自动创建。
 - **Arguments**  
@@ -1322,6 +1323,7 @@ class Conversation:
   `Conversation | None`
 
 ##### `get_conversations`
+
 - **Usage**  
   拉取用户或平台下的全部对话列表。
 - **Arguments**  
@@ -1331,6 +1333,7 @@ class Conversation:
   `List[Conversation]`
 
 ##### `get_filtered_conversations`
+
 - **Usage**  
   分页 + 关键词搜索对话。
 - **Arguments**  
@@ -1343,6 +1346,7 @@ class Conversation:
   `tuple[list[Conversation], int]` – 对话列表与总数
 
 ##### `update_conversation`
+
 - **Usage**  
   更新对话的标题、历史记录或 persona_id。
 - **Arguments**  
@@ -1355,6 +1359,7 @@ class Conversation:
   `None`
 
 ##### `get_human_readable_context`
+
 - **Usage**  
   生成分页后的人类可读对话上下文，方便展示或调试。
 - **Arguments**  
@@ -1391,15 +1396,13 @@ persona_mgr = self.context.persona_manager
 - **Raises**
   `ValueError` – 当不存在时抛出
 
-
 ##### `get_all_personas`
 
 - **Usage**  
   一次性获取数据库中所有人格。
 - **Returns**  
   `list[Persona]` – 人格列表，可能为空
 
-
 ##### `create_persona`
 
 - **Usage**  
@@ -1414,7 +1417,6 @@ persona_mgr = self.context.persona_manager
 - **Raises**  
   `ValueError` – 若 `persona_id` 已存在
 
-
 ##### `update_persona`
 
 - **Usage**  
@@ -1429,7 +1431,6 @@ persona_mgr = self.context.persona_manager
 - **Raises**  
   `ValueError` – 若 `persona_id` 不存在
 
-
 ##### `delete_persona`
 
 - **Usage**  
@@ -1439,7 +1440,6 @@ persona_mgr = self.context.persona_manager
 - **Raises**  
   `Valueable` – 若 `persona_id` 不存在
 
-
 ##### `get_default_persona_v3`
 
 - **Usage**  
@@ -1450,7 +1450,6 @@ persona_mgr = self.context.persona_manager
 - **Returns**  
   `Personality` – v3 格式的默认人格对象
 
-
 ::: details Persona / Personality 类型定义
 
 ```py
@@ -1501,7 +1500,6 @@ class Personality(TypedDict):
 
 :::
 
-
 ### 其他
 
 #### 配置文件
@@ -1557,19 +1555,16 @@ async def helloworld(self, event: AstrMessageEvent):
 
 关于 CQHTTP API，请参考如下文档：
 
-Napcat API 文档：https://napcat.apifox.cn/
-
-Lagrange API 文档：https://lagrange-onebot.apifox.cn/
-
+Napcat API 文档：<https://napcat.apifox.cn/>
 
+Lagrange API 文档：<https://lagrange-onebot.apifox.cn/>
 
 #### 载入的所有插件
 
 ```py
 plugins = self.context.get_all_stars() # 返回 StarMetadata 包含了插件类实例、配置等等
 ```
 
-
 #### 注册一个异步任务
 
 直接在 **init**() 中使用 `asyncio.create_task()` 即可。
@@ -1588,7 +1583,6 @@ class TaskPlugin(Star):
         print("Hello")
 ```
 
-
 #### 获取加载的所有平台
 
 ```py