καιρός — 关键时刻，恰当时机
Crypto futures anomaly alert system. 确定性的链上门槛数据监控。
Go 单体仓库：cmd/ 入口 + internal/ 实现。
Exchange WebSocket ──→ 价格/成交量/OI/资金费率检测器
↓
CoinGlass API ──→ 多空比/爆仓检测器 ──→ 共振评分器 ──→ Telegram
六维异动 + Z-score 动态阈值 + 多维度共振聚合。
Push a version tag (v*) or run the Release workflow on GitHub Actions — assets are published to GitHub Releases.
# 1. Open https://github.com/ArchdevilForge/kairos/releases/latest
# 2. Download kairos-<version>-linux-amd64.tar.gz (Windows: .zip)
tar xzf kairos-*-linux-amd64.tar.gz
cd kairos-*-linux-amd64
export TELEGRAM_BOT_TOKEN=...
export TELEGRAM_CHAT_ID=...
./kairosd --config config/config.yaml.exampleEach archive contains kairosd, kairos-alert, kairos-backtest, and config/config.yaml.example.
To cut a release from your machine:
git tag v0.1.0
git push origin v0.1.0make check # build + vet + golangci-lint + test -race
# Realtime watcher
TELEGRAM_BOT_TOKEN=xxx TELEGRAM_CHAT_ID=xxx go run ./cmd/kairosd --config config/config.yaml
# One-shot scanner
go run ./cmd/kairos-alert --config config/config.yaml --dry-run
# Backtest
go run ./cmd/kairos-backtest --symbol BTC/USDT --start 2024-01-01 --end 2024-06-01cmd/ CLI 入口（kairosd、kairos-alert、kairos-backtest）
internal/ 业务实现（detector、scanner、engine、exchange…）
tests/ 跨包等价性测试
config/ 运行时配置示例
docs/ 架构与策略文档
deploy/ 部署相关
| 维度 | 来源 | 检测方式 |
|---|---|---|
price_velocity |
WebSocket | Z-score / 多窗口滑动 |
volume_spike |
WebSocket | Z-score / 滚动基线 |
open_interest_change |
REST | Z-score / 变化率 |
funding_rate_anomaly |
REST | Z-score / 绝对值 |
long_short_ratio |
CoinGlass | 绝对阈值 + Z-score + 变化速度 |
liquidation |
CoinGlass | 金额阈值 + Z-score + 多空主导判定 |
resonance |
聚合 | 信号质量分 ≥55（基于 Z-score 极端度 + 维度共振 + 方向一致性） |
Scanner 输出 watch/prepare/trade_candidate 状态、评分、入场区间、止损、目标、风险回报比。
export TELEGRAM_BOT_TOKEN="..."
export TELEGRAM_CHAT_ID="..."可选:
export KAIROS_ALERT_MIN_STATE=prepare
export KAIROS_ALERT_LIMIT=5顺势而为 · 敬畏市场 · 严格止损 · 人工决策
MIT