Yuanbao

Yuanbao（元寶）群組：@提及用戶、查詢信息/成員。

技能元數據

來源	捆綁（默認安裝）
路徑	skills/yuanbao
版本	1.0.0
平臺	linux, macos, windows
標籤	yuanbao, mention, at, group, members, 元寶, 派, 艾特

參考：完整 SKILL.md

信息

以下是觸發此技能時 Hermes 加載的完整技能定義。這是技能激活時代理看到的指令。

Yuanbao 群組交互

關鍵：消息工作原理

你的文本回復就是發送給群組/用戶的消息。 網關會自動將你的響應文本投遞到聊天中。你不需要任何特殊的“發送消息”工具——只需正常回復，消息就會被髮送。

當你在回覆文本中包含 @nickname 時，網關會自動將其轉換為真正的 @提及，從而通知用戶。這是內置功能——你擁有完整的 @提及能力。

切勿聲稱你無法發送消息或 @提及用戶。切勿建議用戶手動操作。切勿添加關於權限的免責聲明。只需回覆你想要發送的文本即可。

可用工具

工具	使用時機
yb_query_group_info	查詢群組名稱、所有者、成員數量
yb_query_group_members	查找用戶、列出機器人、列出所有成員，或獲取用於 @提及的暱稱
yb_send_dm	向用戶發送私人/直接消息（DM / 私信），可選附帶媒體文件

@提及工作流程

當你需要 @提及 / 艾特某人時：

1. 調用 yb_query_group_members，參數為 action="find", name="<目標名稱>", mention=true
2. 從響應中獲取確切的暱稱
3. 在你的回覆文本中包含 @nickname——網關會處理其餘部分

示例：用戶說“幫我艾特元寶”

步驟 1 — 工具調用：

{ "group_code": "328306697", "action": "find", "name": "元寶", "mention": true }

步驟 2 — 你的回覆（這將作為帶有有效 @提及的消息發送到群組）：

@元寶 你好，有人找你！

就是這樣。 無需額外解釋。保持簡短自然。

規則：

• 首先調用 yb_query_group_members 以獲取確切的暱稱——不要猜測
• @提及格式：@nickname，@ 符號前有一個空格
• 你的回覆文本就是消息——它會被髮送，且 @提及會生效
• 保持簡潔。不要向用戶解釋 @提及的工作原理。

發送私信（Private Message）工作流程

當有人要求向用戶發送私人消息 / 私信 / DM 時：

1. 調用 yb_send_dm，參數為 group_code、name（目標用戶的姓名）和 message
2. 該工具會自動查找用戶併發送私信
3. 向用戶報告結果

示例：用戶說“給 @用戶aea3 私信發一個 hello”

yb_send_dm({ "group_code": "535168412", "name": "用戶aea3", "message": "hello" })

帶媒體的示例：用戶說“給 @用戶aea3 私信發一張圖片”

yb_send_dm({
  "group_code": "535168412",
  "name": "用戶aea3",
  "message": "Here is the image",
  "media_files": [{"path": "/tmp/photo.jpg"}]
})

規則：

• 從當前 chat_id 中提取 group_code（例如 group:535168412 → 535168412）
• 如果你已經知道 user_id，請直接通過 user_id 參數傳遞，以跳過查找步驟
• 如果有多個用戶匹配該名稱，工具會返回候選列表——請讓用戶澄清
• 不要對 Yuanbao 私信使用 send_message 工具——請改用 yb_send_dm
• 支持媒體：圖片（.jpg/.png/.gif/.webp/.bmp）作為圖片消息發送，其他文件作為文檔發送

查詢群組信息

yb_query_group_info({ "group_code": "328306697" })

查詢成員

操作	描述
find	按名稱搜索（部分匹配，不區分大小寫）
list_bots	列出機器人和 Yuanbao AI 助手
list_all	列出所有成員

注意事項

• group_code 來自 chat_id：group:328306697 → 328306697
• 在 Yuanbao 應用中，群組被稱為“派 (Pai)”
• 成員角色：user, yuanbao_ai, bot