本工具是只读客户端:只发 GET 请求获取任务列表与详情,不提交作业、不答题、不交卷、不改任何服务端状态。internal/ykt/endpoints.go 是全部接口路径的唯一来源,审阅该文件即可确认这一点。
登录态(sessionid / csrftoken)与推送凭据(飞书 webhook、邮箱授权码)不写入源码、示例配置或测试。
| 项目 | 做法 |
|---|---|
| 登录态存储 | <数据目录>/cookie.json,权限 0600 |
| 日志脱敏 | cookie 值输出为 sess***ab,不打印完整值 |
| 推送凭据 | 从环境变量读取(YKT_FEISHU_WEBHOOK / YKT_FEISHU_SECRET / YKT_EMAIL_PASSWORD),或写入本地配置文件 |
| 示例配置 | configs/*.example.yaml 中只有占位值 |
| 数据目录 | 已在 .gitignore 排除,不会误提交 cookie.json 与状态库 |
发现凭据泄露时:删除 <数据目录>/cookie.json,重新扫码登录;飞书机器人请在群设置里重置 webhook。
所有用户可配置的推送地址在发出请求前经 internal/netguard 校验:
- 仅允许
http/https - 拒绝环回、私有网段、链路本地、CGNAT、云元数据地址及其它保留地址
- DOMAIN 解析后对每个 IP 逐一校验,防 DNS 重绑定
- 飞书通道额外限制域名白名单(
open.feishu.cn/open.larksuite.com)
本地 Web 面板默认只监听 127.0.0.1。若配置为非回环地址,必须同时设置访问 token,否则拒绝启动。面板无写接口,只读展示任务、推送历史与登录态。
默认 10 分钟一轮,叠加 ±50% 抖动;请求间有全局限速(默认 300ms);429/5xx 指数退避;非活跃时段自动拉长间隔。请勿把间隔调到 1 分钟以内。
若发现安全相关问题,请通过 GitHub 仓库的 Issue 私下说明影响范围,避免在公开 Issue 中贴出可复现的攻击细节或任何真实凭据。