← Back to Skills Marketplace
ifishcool

Dao3 Statistics

by 冷鱼闲风 · GitHub ↗ · v0.1.0 · MIT-0
darwinlinux ✓ Security Clean
261
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install dao3-statistics
Description
当用户想按 userId 或 mapId 查询神岛平台数据时使用此技能,例如用户资料、地图详情、地图评论、粉丝/好友/关注列表、收藏/最近游玩、关键词搜索等。当用户需要“需要认证”的消息/统计数据(评论/点赞/系统消息、地图统计、玩家统计、留存、行为等)并且能够提供 神岛token 和 user-agent 时,...
README (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 形式返回。
Usage Guidance
该技能在功能与实现上自洽,但在安装/使用前请注意: - 请求会发往域名 https://code-api-pc.dao3.fun;在提供敏感 token 前确认你信任该域名/服务。 - 认证 token 与 user-agent 通过命令行参数传递,可能出现在进程列表或 shell 历史中(可被其他本地用户看到);如可能,尽量使用短期/最小权限的 token 或在隔离环境中运行。 - raw 命令允许对上游任意路径发起请求,避免用它访问你不希望暴露给上游的数据或内部管理端点。 - 因为代码随包分发,若你担心源头可信度,先在受控沙箱中审查/运行或手动阅读脚本再决定是否使用。
Capability Analysis
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.
Capability Assessment
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,也不修改其他技能或全局代理配置。默认的自主调用权限未与广泛凭据或持久存在结合,因此无额外持久特权风险。
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install dao3-statistics
  3. After installation, invoke the skill by name or use /dao3-statistics
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug dao3-statistics
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Dao3 Statistics?

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

How do I install Dao3 Statistics?

Run "/install dao3-statistics" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Dao3 Statistics free?

Yes, Dao3 Statistics is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Dao3 Statistics support?

Dao3 Statistics is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).

Who created Dao3 Statistics?

It is built and maintained by 冷鱼闲风 (@ifishcool); the current version is v0.1.0.

💬 Comments