Appearance
命名规范
slug: URL 片段,建议小写、短词、无空格。module: 与slug保持一致,避免映射混乱。name: 展示名称,允许中文。
关卡顺序规则
- 核心加载按
map.json数组索引确定等级。 services/verify与核心一致:按数组顺序决定下一关,并跳过enabled: false的关卡。
目录约定
- 主页静态资源:
statics/main/(通过GET /访问)。 - 关卡静态资源:
levels/<module>/static/(通过GET /{slug}访问)。
响应结构建议
- 验证接口建议返回
status字段:success:包含token与next_urlwrong或error:说明错误
JSON 编码
- 所有配置文件使用
utf-8。 _write_json采用ensure_ascii=False保留中文。
安全建议
fingerprint_mode=strict更安全但更易误伤。- 生产环境通过反向代理设置
x-forwarded-for。 secret_key变更会导致旧 token 失效,需计划化轮换。