# tidal

**Repository Path**: Clark_Liu/tidal

## Basic Information

- **Project Name**: tidal
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-05
- **Last Updated**: 2026-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# 🌊 Tidal · 跟随潮汐

### *不预测，只跟随。*

**一套帮你建立、验证并执行完整交易系统的量化工具。**

</div>

---

> 潮水从不问明天涨向何方。
> 它只是顺着月亮的引力，一寸一寸地来，又一寸一寸地退。
> 真正的赢家不与大海赌方向——他只在潮起时上船，潮落时离岸。
>
> **这，就是"跟随潮汐"四个字的全部含义：不预测顶底，只顺势进退。**
> 它是趋势跟踪的哲学，也是这套系统的灵魂——与它服务的交易者所信奉的
> "知行合一、非红即绿、信号驱动、纪律第一"，是同一片海。

---

## 🪨 关于这个名字，与这一刻

Tidal 诞生于 2026 年 7 月 5 日。

在此之前，它只是另一个项目里的一个分支——一次"把焊死的策略从框架里剥离出来"的解耦实验，
寄居在一个叫 `six_signal` 的仓库中，用着一个从别处借来的临时代号 `Claw`。

而今天，它长成了自己。

回测引擎跑通了，数据层稳固了，界面立起来了，第一个"别人的策略"（帝纳波利）成功接了进来——
它证明了自己不再是"某一套策略的脚手架"，而是**一个策略无关的、可以承载任何交易思想的产品**。
于是我们为它单独开辟了一个仓库、起了一个真正属于它的名字，让它与过去彻底分家，独立启航。

**这是一个里程碑。** 从"一个分支里的想法"，到"一个有名字、有边界、有方向的产品"，
中间隔着的不是几行代码，而是一次定位的跃迁。记住这一刻——
**潮水第一次，以自己的名字涌起。**

---

## 🧭 它是什么

Tidal 是一个**策略无关**的 A 股量化回测与交易决策辅助系统。

它不替你决定"买什么"——那是你的交易思想该做的事。
它给你的是一套**脚手架**：让你把自己的交易策略接进来，用真实历史数据反复回测验证，
再辅助你完成每日的复盘与次日的交易计划。

一句话：**Tidal 帮不擅长写代码的交易者，把脑中零散的直觉，搭成一套结构完整、可被验证的交易系统。**

一套完整的交易系统包含九个元素——
**择时 · 选股 · 买入 · 建仓 · 持仓 · 止盈 · 止损 · 仓位管理 · 复盘与计划**。
Tidal 让你像搭积木一样把它们组合起来，缺哪块补哪块，换哪块试哪块。

## 🎯 四条不可动摇的信条

| 信条 | 含义 |
|:---|:---|
| **策略无关是生命线** | 框架永不焊死任何一套策略。六层趋势、帝纳波利只是参考实现，你的策略同样能接进来。 |
| **独立可活** | 核心（回测/策略/数据）不依赖 AI 也能完整运转。AI 是可选的增强外挂，不是心脏。 |
| **面向小白** | 有界面、配置傻瓜化。不会写代码的交易者，也能用起来。 |
| **先验证，再实盘** | 任何想法先在历史里跑一遍。系统是决策的辅助与检验，不是替你冲锋的机器人。 |

## ⚙️ 现在它能做什么

- **回测引擎**　全链路：数据 → 策略决策 → 撮合 → 成本 → 绩效。T+1、涨跌停、停牌、滑点/佣金/印花/过户全建模。
- **两种回测**　*固定回测*（给定股票池）与*动态选股回测*（每日全市场自选股 + 择时，向量化预计算绕过性能墙，带进度条与可中断停止）。
- **数据层**　本地 Parquet 存储 + 通达信 tqcenter 数据源 + 数据同步页；官方交易日历校验。
- **WebUI**　固定/动态回测页（含成分股下钻）、数据同步页、策略管理页、配置页；深浅双皮肤。
- **两套参考策略**
  - *六层趋势（SixLayer）*：非红即绿、白色信号入场、5-3-2 建仓、移动止损。
  - *帝纳波利（DiNapoli）*：DMA 置换均线判向、斐波那契回撤 A/B/C 三买点、COP/OP/XOP 分批止盈、风险倒推仓位。

## 🌅 它正在走向哪里

下一座灯塔：**接入 AI Agent**，让 Tidal 自带一层"可选的智能驾驶舱"——
由大模型驱动，能自主调用数据与策略能力，辅助完成复盘、选股与交易计划。

但灯塔再亮，也照着同一条信条：
**车必须能手动开，自动驾驶只是选装。** 没有 API Key 的用户，依然能用它回测、能看它的每一个客观结论。
AI 让潮水看得更远，却永远不是让它涌动的那轮月亮。

---

## 🚀 快速开始

```powershell
# Python 解释器（本机专用绝对路径；系统 PATH 里的 python 是空壳假货）
$env:PYEXE = "C:/Users/Administrator/.workbuddy/binaries/python/versions/3.13.12/python.exe"

# 跑测试（必须 cd 到项目根、且限定 tests）
cd D:\Tidal
Invoke-Expression "$env:PYEXE -m pytest tests -q"

# 命令行回测
Invoke-Expression "$env:PYEXE run_backtest.py 601609"

# 启动 WebUI（浏览器访问 http://127.0.0.1:8000/）
webui\start_backtest.bat
```

## 📚 文档地图

| 文档 | 用途 |
|:---|:---|
| `docs/★Tidal入口_先读这份_2026-07-05.md` | **接手第一份**：项目身份、与实盘的分家、下一步方向。 |
| `docs/交接说明_NEW_SESSION_START_HERE.md` | 完整技术现状 / 历史进度 / 已踩的坑（措辞停留在旧时代，内容仍有效）。 |
| `docs/策略接入规范.md` | 如何把你自己的策略接进来。 |

## 🗄️ 数据源

- **主力**：通达信 tqcenter（需本机运行通达信客户端；安装路径在 `data/config.json` 的 `data_source.tdx_root` 配置，换机只改配置不改代码）。
- **增强（可选）**：通达信远程 MCP —— 研报、公告、宏观、自然语言选股。失效不影响主流程。

---

<div align="center">

*Tidal 由 `six_signal` 仓库的框架-策略解耦分支独立而来，*
*现为独立产品仓库，与实盘脚本永久分家，独立启航。*

**2026.07.05 — 潮水，以自己的名字涌起。**

</div>