feat: initialize ts-anomaly-td project skeleton

2026-06-11 15:31:16 +08:00
commit 1c1233bddd
8 changed files with 740 additions and 0 deletions
@@ -0,0 +1,47 @@
+# ts-anomaly-td
+
+TDengine 时序异常分析 CLI 工具——通过 TDengine 内置 TDgpt SQL 函数跑通异常检测、预测与 GT 对比可视化。
+
+## 安装
+
+```bash
+uv sync
+```
+
+## CLI 用法
+
+```bash
+# 注入数据
+python -m ts_anomaly_td inject --csv data/finance_001.csv --stable finance_001
+
+# 批量检测（6 算法多路跑）
+python -m ts_anomaly_td detect-batch --stable finance_001 --output render/
+
+# 预测式异常
+python -m ts_anomaly_td forecast-anomaly --stable finance_001 --output render/
+
+# 端到端
+python -m ts_anomaly_td e2e --data-dir data --output-dir render --log-dir logs/
+```
+
+## E2E 步骤
+
+```bash
+# 1. 拉容器
+docker compose up -d
+# 等健康检查通过（约 30s）
+
+# 2. 跑 E2E
+uv run python -m ts_anomaly_td e2e --data-dir data --output-dir render --log-dir logs/
+
+# 3. 停止容器
+docker compose down
+```
+
+## License
+
+Apache-2.0。运行 E2E 时需链接 AGPL-3.0 的 TDengine 服务，请遵守对应条款。
+
+## 仓库
+
+Gitea: https://git.tekmine.net/charles/ts-anomaly-td