OpenShamrock/configuration.md at 42390774bdc1f11a96234b38f90716101d7b8ecc

mirror of https://github.com/whitechi73/OpenShamrock.git synced 2024-08-14 13:12:17 +08:00

2023-10-31 14:04:06 +08:00

2.7 KiB

Raw Blame History

title	icon
应用配置	cog

::: tip 提示 Shamrock 提供了一个图形化的配置界面，可进行简单的配置操作。
大部分配置简单易于理解，我们仅仅介绍部分难于理解的配置选项。 :::

配置选项

强制平板模式

强制要 QQ 客户端以平板模式运行，让机器人于主账号登录在手机共存登录。

专业级接口

提供一些危险的接口，如签名/发包一系列不合规的操作。

::: warning 注意使用这些接口可能会导致 QQ 账号被封禁，若非必要，请不要使用。 :::

::: tip 提示除了 WebSocket 相关功能，其他功能的配置进行修改立即生效，无需重新启动QQ。不建议使用 CQ 码，因为在新一代机器人设计理念中，该操作过于落后，可能会出现许多问题。 :::

::: warning 注意被动 WebSocket 在断线之后，每隔 5 秒尝试重新连接。 :::

目录定义

内部存储目录: /storage/emulated/0 # 或 /sdcard
QQ 主目录: 内部存储目录 + /Android/data/com.tencent.mobileqq
Shamrock 主目录: QQ主目录 + /Tencent/Shamrock

配置文件

将下方 JSON 文件创建在 Shamrock 主目录 + /config.json
请确保 JSON 格式正确。

{
    "rules": {
        "group_rule": {
            "black_list": [12345678], // 如果群号是`12345678`就跳过了哦！
            "white_list": []
        },
        "private_rule": {
            "black_list": [12345678],
            "white_list": []
        }
    },
    "default_token": null,
    "active_websocket": {
        "port": 5800, // 主动WS监听的端口
        "token": "aaaa1111,bbbb1111" // 同时允许两个token可使用|或,作为分割
    },
    "passive_websocket": [
        {
            "address": "ws://xxxxxxxxx" // 这里是个例子，如果默认tk存在则使用默认token鉴权
        },
        {
            "address": "ws://aaaaaaaaa",
            "token": "aaa666" // 提供了特例化token，将不使用默认token
        }
    ],
    "allow-temp-session": false // 是否允许临时消息
}

参数名称	类型	作用	例子
default_token	string	默认token，HTTP接口/主被动WS 如果未单独定义token，则使用默认token	aaa123456

!> 记得把注释删掉哦？JSON5貌似也没有完全支持呢？

数据目录

大部分 Shamrock 的数据/缓存保存在 Shamrock 主目录
其中的日志可作为 Issue 内容，截取部分提交。

.
├── tmpfiles # 临时文件目录
│   ├── logs # 日志目录
│   │   └── xxx.log # 日志文件
├── config.json # 配置文件

2.7 KiB Raw Blame History Unescape Escape