_conf_schema.json

{
  "general": {
    "description": "通用设置",
    "type": "object",
    "items": {
      "command_prefixes": {
        "type": "list",
        "description": "命令触发前缀列表",
        "hint": "插件支持的命令触发前缀列表，如 ['dna']；列表含空字符串时允许无前缀触发",
        "default": [
          "dna"
        ]
      },
      "allow_mention_query": {
        "type": "bool",
        "description": "允许 AT 查询他人",
        "hint": "是否允许通过 @ 查询他人的角色信息",
        "default": true
      }
    }
  },
  "login": {
    "description": "登录设置",
    "type": "object",
    "items": {
      "url": {
        "type": "string",
        "description": "登录服务地址",
        "hint": "登录页或外置 dna-login 服务的 base URL；留空使用内置服务",
        "default": ""
      },
      "bind_host": {
        "type": "string",
        "description": "内置服务监听地址",
        "hint": "内置登录服务监听地址",
        "default": "127.0.0.1"
      },
      "port": {
        "type": "int",
        "description": "内置服务监听端口",
        "hint": "内置登录服务监听端口；0 表示由系统分配临时端口",
        "default": 6189
      },
      "transport": {
        "type": "string",
        "description": "登录接入方式",
        "hint": "登录接入方式 (local/http_poll/sse/ws)",
        "default": "local",
        "options": [
          "local",
          "http_poll",
          "sse",
          "ws"
        ]
      },
      "shared_secret": {
        "type": "string",
        "description": "外置服务共享密钥",
        "hint": "外置登录服务共享密钥；不会写入日志或用户响应",
        "default": ""
      },
      "tencent_docs": {
        "type": "bool",
        "description": "腾讯文档登录辅助",
        "hint": "是否启用腾讯文档登录辅助",
        "default": false
      },
      "qr_login": {
        "type": "bool",
        "description": "二维码登录",
        "hint": "是否将登录链接转换为二维码",
        "default": false
      },
      "forward_login": {
        "type": "bool",
        "description": "转发消息登录",
        "hint": "是否将登录链接转换为转发消息",
        "default": false
      },
      "dynamic_background": {
        "type": "bool",
        "description": "登录页动态背景",
        "hint": "是否启用内置登录页的 MP4 动态背景；关闭后使用静态背景",
        "default": true
      },
      "max_bind_count": {
        "type": "int",
        "description": "未登录用户最大绑定数",
        "hint": "未登录用户允许绑定的 UID 数量",
        "default": 2
      }
    }
  },
  "ai": {
    "description": "AI 设置",
    "type": "object",
    "items": {
      "agent_tools_enabled": {
        "type": "bool",
        "description": "Agent Tools 总开关",
        "hint": "是否注册二重螺旋 Agent Tools",
        "default": false
      }
    }
  },
  "sign_in": {
    "description": "签到设置",
    "type": "object",
    "items": {
      "community_tasks": {
        "type": "list",
        "description": "启用的社区任务",
        "hint": "启用的社区任务列表",
        "default": [
          "bbs_sign",
          "bbs_detail",
          "bbs_like",
          "bbs_share",
          "bbs_reply"
        ],
        "options": [
          "bbs_sign",
          "bbs_detail",
          "bbs_like",
          "bbs_share",
          "bbs_reply"
        ]
      },
      "default_auto_sign_enabled": {
        "type": "bool",
        "description": "首登自动签到",
        "hint": "新 UID 首次绑定时是否默认开启自动签到；用户之后可自行关闭",
        "default": true
      },
      "sign_time": {
        "type": "string",
        "description": "每日签到时间",
        "hint": "每日签到时间，格式为 HH:mm（如 00:05）",
        "default": "00:05"
      },
      "concurrency": {
        "type": "int",
        "description": "签到并发数",
        "hint": "自动签到并发数量",
        "default": 1
      },
      "concurrency_interval_seconds": {
        "type": "list",
        "description": "签到任务随机间隔",
        "hint": "自动签到任务之间的随机间隔范围（秒）",
        "default": [
          3,
          5
        ]
      },
      "private_report": {
        "type": "bool",
        "description": "私聊签到报告",
        "hint": "是否发送签到私聊报告",
        "default": false
      },
      "group_report": {
        "type": "bool",
        "description": "群聊签到报告",
        "hint": "是否发送签到群组报告",
        "default": false
      },
      "group_report_image": {
        "type": "bool",
        "description": "图片形式群报告",
        "hint": "是否以图片发送群组报告",
        "default": false
      }
    }
  },
  "notifications": {
    "description": "通知设置",
    "type": "object",
    "items": {
      "announcement_enabled": {
        "type": "bool",
        "description": "公告推送开关",
        "hint": "是否启用公告推送",
        "default": true
      },
      "announcement_check_minutes": {
        "type": "int",
        "description": "公告检查间隔",
        "hint": "公告推送检查间隔（分钟）",
        "default": 10
      },
      "secret_simple_image": {
        "type": "bool",
        "description": "简易密函图片",
        "hint": "是否使用简单密函图片",
        "default": false
      },
      "secret_push_minute": {
        "type": "int",
        "description": "密函推送分钟",
        "hint": "每小时在该分钟推送密函，默认整点",
        "default": 0
      },
      "secret_retry_interval_seconds": {
        "type": "float",
        "description": "密函数据重试间隔",
        "hint": "当前小时密函未准备好或校验失败时的重试间隔（秒）",
        "invisible": true,
        "default": 1
      }
    }
  },
  "client_updates": {
    "description": "客户端更新设置",
    "type": "object",
    "items": {
      "enabled": {
        "type": "bool",
        "description": "客户端更新推送开关",
        "hint": "是否启用客户端更新定时检查与推送",
        "default": true
      },
      "check_minutes": {
        "type": "int",
        "description": "客户端更新检查间隔",
        "hint": "客户端更新定时检查间隔（分钟），必须为正整数",
        "default": 60
      },
      "targets": {
        "type": "list",
        "description": "客户端更新目标",
        "hint": "只能选择代码 registry 中的固定 Target ID，不填写 URL、branch 或 manifest key",
        "default": [
          "cn-official-pc",
          "cn-official-android"
        ],
        "options": [
          "cn-official-pc",
          "cn-official-android",
          "cn-app-store-ios",
          "cn-bilibili-pc",
          "cn-bilibili-android",
          "cn-hykb-android",
          "global-standalone-pc",
          "global-app-store-ios"
        ]
      },
      "merge_forward": {
        "type": "bool",
        "description": "客户端更新合并转发",
        "hint": "OneBot 平台是否将同轮多目标更新合并为转发消息",
        "default": true
      }
    }
  },
  "display": {
    "description": "显示设置",
    "type": "object",
    "items": {
      "guide_providers": {
        "type": "list",
        "description": "角色攻略提供方",
        "hint": "角色攻略图提供方",
        "default": [
          "all"
        ],
        "options": [
          "all",
          "狩月庭攻略组",
          "猫冬"
        ]
      },
      "show_unowned_roles": {
        "type": "bool",
        "description": "显示未拥有角色",
        "hint": "是否在角色信息卡片中显示未拥有的角色和武器",
        "default": true
      }
    }
  },
  "network": {
    "description": "网络设置",
    "type": "object",
    "items": {
      "max_concurrent_requests": {
        "type": "int",
        "description": "短请求最大并发数",
        "hint": "限制 API、图片等短生命周期网络请求；WebSocket/SSE 不长期占用",
        "default": 4
      },
      "api_base_url": {
        "type": "string",
        "description": "API 服务地址",
        "hint": "留空使用官方 API；仅在使用兼容 API 反代服务时填写",
        "default": ""
      },
      "proxy_url": {
        "type": "string",
        "description": "App API 代理地址",
        "hint": "仅代理二重螺旋 App REST API 与官方业务 WebSocket；留空直连，不影响 GitHub、CDN、AstrBot、OneBot 或外置登录",
        "default": ""
      },
      "websocket_continue_seconds": {
        "type": "int",
        "description": "API WebSocket 保活时间",
        "hint": "API WebSocket 保活持续时间（秒），不作用于 OneBot 或外置 dna-login WebSocket",
        "default": 300
      },
      "websocket_wait_seconds": {
        "type": "int",
        "description": "API WebSocket 连接等待时间",
        "hint": "等待 API WebSocket 建立连接的时间（秒），不作用于 OneBot 或外置 dna-login WebSocket",
        "default": 5
      }
    }
  },
  "resources": {
    "description": "资源设置",
    "type": "object",
    "items": {
      "github_acceleration": {
        "type": "string",
        "description": "GitHub 资源加速模式",
        "hint": "默认直连；镜像失败会直接报告，不自动回退直连",
        "default": "off",
        "options": [
          "off",
          "edgeone",
          "hk",
          "gh_proxy",
          "dpik",
          "custom"
        ]
      },
      "custom_github_acceleration_url": {
        "type": "string",
        "description": "自定义 GitHub 加速前缀",
        "hint": "仅 custom 模式使用；填写不含 query、fragment 或凭据的 HTTP(S) 基础 URL",
        "default": ""
      },
      "image_download_timeout_seconds": {
        "type": "int",
        "description": "图片下载超时（秒）",
        "hint": "角色、武器、MOD、技能等运行时图片请求的单次 I/O 超时；默认 5 秒，避免单个异常 CDN 长时间阻塞整张卡",
        "default": 5
      },
      "image_download_max_attempts": {
        "type": "int",
        "description": "图片下载最大尝试次数",
        "hint": "运行时图片遇到网络错误、429 或 5xx 时的最大尝试次数，包含首次请求；默认 2 次",
        "default": 2
      }
    }
  },
  "cache": {
    "description": "缓存设置",
    "type": "object",
    "items": {
      "ttl_hours": {
        "type": "int",
        "description": "统一内容缓存 TTL（小时）",
        "hint": "-1 表示永久缓存；0 表示禁用持久缓存；正整数表示缓存有效小时数",
        "default": 24
      },
      "refresh_send_info_card": {
        "type": "bool",
        "description": "刷新后发送基础卡片",
        "hint": "主动刷新基础信息卡片后是否发送新的基础卡片图片",
        "default": true
      },
      "refresh_send_role_panel": {
        "type": "bool",
        "description": "刷新后发送角色面板",
        "hint": "主动刷新单个角色面板后是否发送新的角色面板图片",
        "default": true
      }
    }
  }
}