Skip to content

命名规范

  • slug: URL 片段,建议小写、短词、无空格。
  • module: 与 slug 保持一致,避免映射混乱。
  • name: 展示名称,允许中文。

关卡顺序规则

  • 核心加载按 map.json 数组索引确定等级。
  • services/verify 与核心一致:按数组顺序决定下一关,并跳过 enabled: false 的关卡。

目录约定

  • 主页静态资源:statics/main/(通过 GET / 访问)。
  • 关卡静态资源:levels/<module>/static/(通过 GET /{slug} 访问)。

响应结构建议

  • 验证接口建议返回 status 字段:
    • success:包含 tokennext_url
    • wrongerror:说明错误

JSON 编码

  • 所有配置文件使用 utf-8
  • _write_json 采用 ensure_ascii=False 保留中文。

安全建议

  • fingerprint_mode=strict 更安全但更易误伤。
  • 生产环境通过反向代理设置 x-forwarded-for
  • secret_key 变更会导致旧 token 失效,需计划化轮换。