跳到主要内容

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