← 返回 Skills 市场
ifishcool

Dao3 Statistics

作者 冷鱼闲风 · GitHub ↗ · v0.1.0 · MIT-0
darwinlinux ✓ 安全检测通过
261
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install dao3-statistics
功能描述
当用户想按 userId 或 mapId 查询神岛平台数据时使用此技能,例如用户资料、地图详情、地图评论、粉丝/好友/关注列表、收藏/最近游玩、关键词搜索等。当用户需要“需要认证”的消息/统计数据(评论/点赞/系统消息、地图统计、玩家统计、留存、行为等)并且能够提供 神岛token 和 user-agent 时,...
使用说明 (SKILL.md)

这个技能做什么

这个技能提供一个命令行接口,用于从官方 API 获取 DAO3(神岛)平台数据。

覆盖两类能力:

  • 公开接口(无需认证)
  • 认证接口(需要 token + user-agent)

所有命令都会向 stdout 输出一个 JSON 对象。

如何运行

scripts/ 目录下运行:

python3 -m dao3_statistics --help

命令

公开接口(无需认证)

user-profile --user-id \x3Cid>

用途:通过用户 ID 获取用户个人资料。

参数:

  • --user-id \x3Cid>:用户 ID。

map-info --map-id \x3Cid>

用途:通过地图/内容 ID 获取地图详情。

参数:

  • --map-id \x3Cid>:地图(content)ID。

map-comments --content-id \x3Cid> --limit \x3Cn> --offset \x3Cn> --order-by \x3Cn> --content-type \x3Cn>

用途:获取地图/模型的评论列表。

参数:

  • --content-id \x3Cid>:内容 ID(地图/模型 ID)。
  • --limit \x3Cn>:返回数量(上游通常限制最大 100)。
  • --offset \x3Cn>:偏移量(分页用)。
  • --order-by \x3Cn>:排序方式(例如 1=创建时间倒序;4=热度等,具体以接口为准)。
  • --content-type \x3Cn>:内容类型(例如 1=地图;2=模型)。

map-release --content-id \x3Cid> --limit \x3Cn> --offset \x3Cn>

用途:获取地图发布信息。

参数:

  • --content-id \x3Cid>:地图 ID。
  • --limit \x3Cn>:返回数量。
  • --offset \x3Cn>:偏移量。

user-maps --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn>

用途:获取某个用户发布/关联的地图列表。

参数:

  • --user-id \x3Cid>:用户 ID。
  • --limit \x3Cn>:返回数量。
  • --offset \x3Cn>:偏移量。

user-models --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn>

用途:获取某个用户的模型列表。

参数:

  • --user-id \x3Cid>:用户 ID。
  • --limit \x3Cn>:返回数量。
  • --offset \x3Cn>:偏移量。

user-favorites --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn> --content-type \x3Cn>

用途:获取某个用户的收藏列表。

参数:

  • --user-id \x3Cid>:用户 ID。
  • --limit \x3Cn>:返回数量。
  • --offset \x3Cn>:偏移量。
  • --content-type \x3Cn>:收藏内容类型(例如 1=地图;2=模型)。

user-recent --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn>

用途:获取某个用户最近游玩列表。

参数:

  • --user-id \x3Cid>:用户 ID。
  • --limit \x3Cn>:返回数量。
  • --offset \x3Cn>:偏移量。

user-followers --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn>

用途:获取某个用户的粉丝列表。

参数:

  • --user-id \x3Cid>:用户 ID。
  • --limit \x3Cn>:返回数量。
  • --offset \x3Cn>:偏移量。

user-friends --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn>

用途:获取某个用户的好友列表。

参数:

  • --user-id \x3Cid>:用户 ID。
  • --limit \x3Cn>:返回数量。
  • --offset \x3Cn>:偏移量。

user-following --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn>

用途:获取某个用户的关注列表。

参数:

  • --user-id \x3Cid>:用户 ID。
  • --limit \x3Cn>:返回数量。
  • --offset \x3Cn>:偏移量。

search --keyword \x3Ckw> --limit \x3Cn> --offset \x3Cn> --order-by \x3Cn>

用途:通过关键字搜索地图/模型列表。

参数:

  • --keyword \x3Ckw>:关键词。
  • --limit \x3Cn>:返回数量。
  • --offset \x3Cn>:偏移量。
  • --order-by \x3Cn>:排序方式(例如 0=推荐/最热;1=最新;具体以接口为准)。

示例:

python3 -m dao3_statistics user-profile --user-id 83354
python3 -m dao3_statistics map-info --map-id 100131463
python3 -m dao3_statistics search --keyword "test" --limit 10 --offset 0 --order-by 0

认证接口(token + user-agent)

必须同时提供:

  • --token: DAO3 认证 token
  • --user-agent: 类浏览器的 UA 字符串

命令:

msg-comments --offset \x3Cn> --limit \x3Cn> --token \x3Ct> --user-agent \x3Cua>

用途:获取“评论消息”列表(站内消息/通知类)。

参数:

  • --offset \x3Cn>:偏移量。
  • --limit \x3Cn>:返回数量。
  • --token \x3Ct>:认证 token。
  • --user-agent \x3Cua>:UA 字符串(会同时用于 user-agentx-dao-ua 请求头)。

msg-likes --offset \x3Cn> --limit \x3Cn> --token \x3Ct> --user-agent \x3Cua>

用途:获取“点赞消息”列表。

参数:同 msg-comments

msg-sys --offset \x3Cn> --limit \x3Cn> --token \x3Ct> --user-agent \x3Cua>

用途:获取“系统消息”列表。

参数:同 msg-comments

stats-maps --start-time \x3CYYYY-MM-DD> --end-time \x3CYYYY-MM-DD> --token \x3Ct> --user-agent \x3Cua>

用途:获取当前用户的地图统计列表(按日期范围)。

参数:

  • --start-time \x3CYYYY-MM-DD>:开始日期。
  • --end-time \x3CYYYY-MM-DD>:结束日期。
  • --token \x3Ct>:认证 token。
  • --user-agent \x3Cua>:UA 字符串。

stats-player --start-time \x3CYYYY-MM-DD> --end-time \x3CYYYY-MM-DD> --map-id \x3Cid> --token \x3Ct> --user-agent \x3Cua>

用途:获取指定地图的玩家统计数据(按日期范围)。

参数:

  • --start-time \x3CYYYY-MM-DD>:开始日期。
  • --end-time \x3CYYYY-MM-DD>:结束日期。
  • --map-id \x3Cid>:地图 ID。
  • --token \x3Ct>:认证 token。
  • --user-agent \x3Cua>:UA 字符串。

stats-retention --start-time \x3CYYYY-MM-DD> --end-time \x3CYYYY-MM-DD> --map-id \x3Cid> --token \x3Ct> --user-agent \x3Cua>

用途:获取指定地图的玩家留存数据(按日期范围)。

参数:同 stats-player

stats-behavior --start-time \x3CYYYY-MM-DD> --end-time \x3CYYYY-MM-DD> --map-id \x3Cid> --token \x3Ct> --user-agent \x3Cua>

用途:获取指定地图的玩家行为分析数据(按日期范围)。

参数:同 stats-player

示例:

python3 -m dao3_statistics stats-player \
  --start-time 2025-03-29 \
  --end-time 2025-04-04 \
  --map-id 100131463 \
  --token "YOUR_TOKEN" \
  --user-agent "Mozilla/5.0 ..."

Raw 端点逃生口

如果你需要调用尚未映射为专用命令的端点:

  • raw --endpoint \x3Cpath-or-query> [--token \x3Ct> --user-agent \x3Cua>]

用途:直接请求任意上游 API 端点(适合临时验证/调试/未映射的新端点)。

参数:

  • --endpoint \x3Cpath-or-query>:以 / 开头的端点路径(可带 querystring)。
  • --token \x3Ct>--user-agent \x3Cua>:可选;如果该端点需要认证则必须同时提供。

示例:

python3 -m dao3_statistics raw --endpoint "/user/profile/83354"

输出

  • 成功:输出 API 的 JSON 响应
  • 失败:输出包含 errorendpoint 的 JSON;并可能包含 status_coderesponse

备注 / 边界情况

  • --limit 的取值最大为100。
  • 网络失败/超时会以错误 JSON 形式返回。
安全使用建议
该技能在功能与实现上自洽,但在安装/使用前请注意: - 请求会发往域名 https://code-api-pc.dao3.fun;在提供敏感 token 前确认你信任该域名/服务。 - 认证 token 与 user-agent 通过命令行参数传递,可能出现在进程列表或 shell 历史中(可被其他本地用户看到);如可能,尽量使用短期/最小权限的 token 或在隔离环境中运行。 - raw 命令允许对上游任意路径发起请求,避免用它访问你不希望暴露给上游的数据或内部管理端点。 - 因为代码随包分发,若你担心源头可信度,先在受控沙箱中审查/运行或手动阅读脚本再决定是否使用。
功能分析
Type: OpenClaw Skill Name: dao3-statistics Version: 0.1.0 The dao3-statistics skill is a legitimate tool designed to interface with the DAO3 (神岛) platform API. It provides a structured CLI to fetch public and authenticated data (user profiles, map statistics, messages) from the official domain https://code-api-pc.dao3.fun. While it requires sensitive inputs like an authentication token and user-agent for certain commands, the code (specifically api.py and client.py) correctly limits the use of these credentials to the specified API endpoint and lacks any indicators of data exfiltration, malicious execution, or obfuscation.
能力评估
Purpose & Capability
技能名/描述(从 DAO3/神岛 平台获取公开与认证数据)与实际代码和命令一致。所需二进制仅为 python3,认证端点以 token + user-agent 形式传入,符合描述。
Instruction Scope
SKILL.md 中的运行说明与脚本(python -m dao3_statistics)一一对应。脚本只进行网络请求到指定 API_BASE_URL 并将响应打印为 JSON;不会读取本地敏感路径或额外环境变量。唯一需注意的是提供的 raw 命令允许对上游域名下任意端点发起请求(这是文档化的功能)。
Install Mechanism
没有安装步骤(无 install spec),这降低了安装时的风险。但技能包包含可执行 Python 源码文件:这些文件会在运行时被执行,用户应在信任源或隔离环境下运行。
Credentials
技能不要求系统环境变量或多余凭据。认证所需的 DAO3 token 与 user-agent 仅在调用需要认证的命令时作为命令行参数提供,与功能成比例。
Persistence & Privilege
技能未声明 always:true,也不修改其他技能或全局代理配置。默认的自主调用权限未与广泛凭据或持久存在结合,因此无额外持久特权风险。
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install dao3-statistics
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /dao3-statistics 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.0
Initial release of dao3-statistics skill. - Provides a command-line tool to fetch data from the DAO3 (神岛) platform via official APIs. - Supports both unauthenticated (public) and authenticated (requires token & user-agent) endpoints. - Includes commands to query user profiles, map details, comments, favorites, stats, messages, and more. - Offers a "raw" passthrough option for unmapped API endpoints. - All command outputs are JSON objects, with error handling included.
元数据
Slug dao3-statistics
版本 0.1.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Dao3 Statistics 是什么?

当用户想按 userId 或 mapId 查询神岛平台数据时使用此技能,例如用户资料、地图详情、地图评论、粉丝/好友/关注列表、收藏/最近游玩、关键词搜索等。当用户需要“需要认证”的消息/统计数据(评论/点赞/系统消息、地图统计、玩家统计、留存、行为等)并且能够提供 神岛token 和 user-agent 时,... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 261 次。

如何安装 Dao3 Statistics?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install dao3-statistics」即可一键安装,无需额外配置。

Dao3 Statistics 是免费的吗?

是的,Dao3 Statistics 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Dao3 Statistics 支持哪些平台?

Dao3 Statistics 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(darwin, linux)。

谁开发了 Dao3 Statistics?

由 冷鱼闲风(@ifishcool)开发并维护,当前版本 v0.1.0。

💬 留言讨论