把仓库数据整合成 JSON 供 bot 使用

[nullqwertyuiop]

感觉可以整一个方便 bot 读取的 JSON出来，充分利用仓库数据的话这样的结构应该可以？

{
    "id": int,  // Bot 的 QQ 号码
    "name": str,  // Bot 的名称
    "repo": list[str] | str | null,  // Bot 的开源仓库，例如 ["ProjectNu11/Project-Null", "ProjectNu11/PN-Plugins"] 或 "KadokawaR/Chitung-public"
    "num": int | null,  // Bot 的序号，用于区分同名 Bot，如 七筒#1 七筒#2
    "description": str | null,  // Bot 简介 / 功能概要
    "site": list[str] | str | null,  // Bot 帮助页、站点
    "maintainer": list[int] | list[str] | list[dict[str, int]] | null  // Bot 维护人员，如 [114514, 1919810] 或 ["田所浩二"] 或 [{"田所浩二": 114514}]
}

JSON 大概这样

[
    {
        "id": 114514,
        "name": "田所浩二",
        "repo": "HengHengHeng/AAAAA",
        "num": 1,
        "description": "一个香气扑鼻的机器人",
        "site": "https://example.com",
        "maintainer": [
            {
                "pony": 10001
            }
        ]
    },
    {
        "id": 1919810,
        "name": "田所浩二",
        "repo": "HengHengHeng/AAAAA",
        "num": 2,
        "description": "一个香气扑鼻的机器人",
        "site": "https://example.com",
        "maintainer": [
            {
                "pony": 10001
            }
        ]
    }
]

[nullqwertyuiop]

不过感觉还是考虑有所欠缺，比如多 bot 共用同账号的情况，譬如 小霖念 部分时候 AwordaProject 与 ProjectNull 同时启用
或者说多加一个 BotType/ Bot 类型？

{
    "id": int,  // Bot 的 QQ 号码
    "name": str,  // Bot 的名称
    "num": int | null,  // Bot 的序号，用于区分同名 Bot，如 七筒#1 七筒#2
    "description": str | null,  // Bot 简介 / 功能概要
    "site": list[str] | str | null,  // Bot 帮助页、站点
    "maintainer": list[int] | list[str] | list[dict[str, int]] | null,  // Bot 维护人员，如 [114514, 1919810] 或 ["田所浩二"] 或 [{"田所浩二": 114514}]
    "type": list[BotType]  // Bot 类型，详见后文
    ^^^^^^ 新增内容，同时于此级删除 "repo"
}

BotType 结构如下

{
    "name": str,
    "repo": list[str] | str | null,  // 项目的开源仓库，例如 ["ProjectNu11/Project-Null", "ProjectNu11/PN-Plugins"] 或 "KadokawaR/Chitung-public"
    "description": str | null // 项目描述
}

修改后的 JSON 示例

[
    {
        "id": 114514,
        "name": "田所浩二",
        "num": 1,
        "description": "一个香气扑鼻的机器人",
        "site": "https://example.com",
        "maintainer": [
            {
                "pony": 10001
            }
        ],
        "type": [
            {
                "name": "哼哼哼",
                "repo": "HengHengHeng/HengHengHeng",
                "description": "哼！哼！哼！"
            },
            {
                "name": "啊啊啊啊啊",
                "repo": "HengHengHeng/AAAAA",
                "description": "啊啊啊啊啊！"
            }
        ]
    },
    {
        "id": 1919810,
        "name": "田所浩二",
        "num": 2,
        "description": "一个香气扑鼻的机器人",
        "site": "https://example.com",
        "maintainer": [
            {
                "pony": 10001
            }
        ],
        "type": [
            {
                "name": "哼哼哼",
                "repo": "HengHengHeng/HengHengHeng",
                "description": "哼！哼！哼！"
            },
            {
                "name": "啊啊啊啊啊",
                "repo": "HengHengHeng/AAAAA",
                "description": "啊啊啊啊啊！"
            }
        ]
    }
]

应该就可以涵盖大部分情况了

[colour93]

我倒是认为在目前没有提供主动 API 的情况下，我们可以把 Bot程序 和 Bot账号 分为两个 JSON，每个 Bot程序 有独立的、唯一的ID，然后由 Bot账号 -> 所运行的程序 进行识别。

botProgram.json

[
    {
        "id": 1,
        "name": "哼哼哼",
        "repo": "HengHengHeng/HengHengHeng",
        "description": "哼！哼！哼！"
    },
    {
        "id": 2,
        "name": "啊啊啊啊啊",
        "repo": "HengHengHeng/AAAAA",
        "description": "啊啊啊啊啊！"
    }
]

bot.json

[
    {
        "id": 114514,
        "name": "田所浩二",
        "num": 1,
        "description": "一个香气扑鼻的机器人",
        "site": "https://example.com",
        "maintainer": [
            {
                "pony": 10001
            }
        ],
        "program": [
            "HengHengHeng/AAAAA",
            "HengHengHeng/HengHengHeng"
        ]
    },
    {
        "id": 1919810,
        "name": "田所浩二",
        "num": 2,
        "description": "一个香气扑鼻的机器人",
        "site": "https://example.com",
        "maintainer": [
            {
                "pony": 10001
            }
        ],
        "program": [
            "HengHengHeng/AAAAA"
        ]
    }
]

当然我认为 botProgram.json 中的 id 非必须，如果使用 id 索引，那么 bot.json 也可以采用这种方式

[Gintamashiichan]

这样是否有所不妥？我认为要拆成两个json才行。

[colour93]

这确实是两个json

[nullqwertyuiop]

#21 这样？

[FurryR]

凑个热闹。

// botProgram.json
;({
  'qq.qq.bot1': {
    name: '哼哼哼',
    url: 'https://github.com/HengHengHeng/HengHengHeng',
    desc: '哼！哼！哼！',
    author: '114514'
  },
  'qq.qq.bot2': {
    name: '啊啊啊啊啊',
    url: 'https://github.com/HengHengHeng/AAAAA',
    desc: '啊啊啊啊啊！',
    author: '1919810'
  }
})
// bot.json
;({
  '114514': {
    name: '田所浩二',
    desc: '一个香气扑鼻的机器人',
    url: 'https://example.com',
    author: '乐',
    use: ['qq.qq.bot1', 'qq.qq.bot2']
  },
  '1919810': {
    name: '田所浩二',
    desc: '一个香气扑鼻的机器人',
    url: 'https://example.com',
    author: '乐2',
    use: ['qq.qq.bot2']
  }
})

[nullqwertyuiop]

@colour93 93老师怎么看

[colour93]

像我这种笨比肯定是想字段名全写出来的

[FurryR]

像我这种笨比肯定是想字段名全写出来的

有点冗余？