跳到主要内容

功能与数据

连接器提供 10 个只读查询工具，覆盖四类数据：配装、图鉴、掉宝活动、赛季日历，外加一个站点功能目录。AI 会根据你的问题自动选择合适的工具，无需你记住工具名。

所有工具都需要先完成 OAuth 授权：未携带访问令牌的请求会直接返回 401，授权在所用 AI 客户端中完成一次即可（见《账号与安全》）。

工具总览​

工具作用权限
search_assemblies搜索公开配装授权后可用
get_assembly查看配装完整详情授权后可用（私有配装除外）
search_codex搜索图鉴条目（13 类）授权后可用
get_codex_entry查看单个图鉴条目详情授权后可用
list_drops列出 Twitch 掉宝活动授权后可用
get_drop_detail查看掉宝活动详情授权后可用
list_drop_notifications掉宝通知记录需要管理员权限
list_calendar_seasons列出日历赛季授权后可用
get_calendar_season查看赛季日历事件授权后可用
list_site_features站点功能目录授权后可用

一、配装查询​

search_assemblies —— 搜索配装​

搜索站点上公开且无密码的船只配装，支持关键字与排序。

参数说明
keyword关键字，匹配配装名称、作者用户名或昵称
sortField排序字段：updatedTime（默认）/ createdTime / likes
sortOrder排序方向：asc / desc（默认）
page / pageSize分页，每页最多 50 条，默认 10 条

示例问法：

  • 「现在有哪些高赞的船只配装？」
  • 「搜索包含『长炮』的配装」

get_assembly —— 配装详情​

按 uuid 获取单个配装的完整数据：船只、轮盘、仓库、专精配置。

参数说明
uuid配装 uuid（搜索结果中会给出）
password该配装的访问密码（如有）

私有配装仅作者本人可读。此处的 password 是配装作者自己设置的内容访问口令，与你的账户密码无关。

二、图鉴速查​

图鉴收录游戏内 13 类条目：物品（item）、船只（ship）、材料（material）、装饰（cosmetic）、货物（commoditie）、帝国技能（empireSkill）、地图地点（mapLocation）、专精（mastery）、改装（mod）、NPC、套装（set）、藏宝图（treasureMap）、终极技能（ultimate）。

search_codex —— 搜索图鉴​

按 id、名称、描述做不区分大小写的子串匹配，结果按「id 精确匹配 > 名称 > 描述」排序。

参数说明
query搜索关键字，可用中文或英文
type限定图鉴类型，如 weapon 相关请用 item；不传则搜索全部 13 类
locale名称/描述语言，如 zh_CN / en_US，默认跟随请求
limit返回条数上限，默认 20，最多 50

示例问法：

  • 「culverin1 是什么武器？属性如何？」
  • 「图鉴里有哪些藏宝图？」

get_codex_entry —— 图鉴条目详情​

按 id 获取单个条目的完整原始字段，并附带对应语言的名称与描述。

参数说明
id条目 id，例如 culverin1 / dhow
type图鉴类型；不传则自动在 13 类中查找

示例问法：

  • 「dhow 这艘船的图鉴数据」
  • 「culverin1 这类武器在哪些地图掉落？」（可配合 mapLocation 检索）

三、Twitch 掉宝​

list_drops —— 掉宝活动列表​

列出《Skull and Bones》的 Twitch 掉宝活动。

参数说明
statusactive（默认，进行中）/ upcoming / ended / all
keyword活动名称关键字
page / pageSize分页，每页最多 50 条，默认 12 条

示例问法：

  • 「现在有什么正在进行中的 Twitch 掉宝？」

get_drop_detail —— 掉宝活动详情​

按数据库 id 或 Twitch campaignId 获取单个活动，包含每个奖励与参与频道列表。

参数说明
id数据库自增 id 或 Twitch campaignId

示例问法：

  • 「这个掉宝活动有哪些奖励？要去哪些频道看？」

list_drop_notifications —— 掉宝通知记录​

读取机器人最近推送的掉宝变更通知（新活动、新奖励）。

该工具需要站点管理员（bot / dev / root）权限，普通账户调用会返回权限错误——这是预期行为，不影响其他工具使用。

四、赛季日历​

list_calendar_seasons —— 赛季列表​

列出站点日历中所有可用的赛季及其展示名称与说明，无参数。

示例问法：

  • 「日历里有哪些赛季？」

get_calendar_season —— 赛季日历​

获取某个赛季的日历事件（世界事件、商人轮换等）。

参数说明
season赛季标识，例如 crimsonWaters
year / month可选，只返回该年月发生的事件

示例问法：

  • 「crimsonWaters 赛季这个月有什么事件？」

五、站点导航​

list_site_features —— 站点功能目录​

返回站点主要页面的目录（路径、分类、多语言名称与说明），AI 可以用它告诉你「某个内容在哪个页面看」。

参数说明
query按名称、说明或路径模糊过滤
category按分类过滤：codex / assembly / map / calendar / tools / apps / account
locale名称/描述语言

示例问法：

  • 「闪耀船首网站上哪里可以看地图信息？」
  • 「这个站都有什么功能？」

数据范围与更新​

  • 配装：仅公开且未设密码的配装可被搜索到；搜索结果包含创建/更新时间、点赞数等摘要信息。
  • 图鉴：数据来自游戏解包资料，按需加载，覆盖全部 13 类条目。
  • 掉宝 / 日历：由站点后台定时同步，通常与游戏官方活动保持同步。
  • 语言：图鉴与站点目录支持多语言（简体中文 / 繁体中文 / 英文），AI 可以用 locale 参数指定，默认使用请求语言。

所有数据均为只读：连接器不能发布、修改或删除任何内容。