适合，如果你

• 你想在本地用 Polars 扫描全 A 股，并把日线与分钟策略放进同一个 Screener。

  README「核心功能」与「选股与回测」写明 Polars 毫秒级扫描全 A 股、日线/分钟策略统一单池。
• 你需要同时研究 IC/IR、分层收益、净值曲线和分钟级成交明细。

  README「回测 Backtest」列出因子回测、策略回测和分钟策略回测，并包含 IC/IR、净值曲线与分钟成交明细。
• 你希望替换数据源但保持指标与回测口径不变。

  README「为什么做 TSP」和「技术架构」描述 6 类数据集能力路由矩阵与可插拔数据源。
• 你需要本地数据问答，并接受 AI_API_KEY 配置后使用 18 个只读工具。

  README「AI 对话助手」写明 18 个只读工具；「配置」写明 AI_API_KEY 留空则关闭 AI。

不适合，如果你

• 你要把它当作投资软件、看盘软件或 AI 荐股工具使用。

  README「重要说明」明确不作为投资软件或者看盘软件，也不内置 AI 荐股/涨停预测。
• 你要求稳定的官方版本发布、明确的 Release 维护节奏。

  项目元数据显示版本发布为 0 个、最新版本为 No releases；README 还称项目以个人开源维护为主。
• 你必须获得盘中即时的当日数据，但只能使用 None/Free 数据档位。

  README「快速开始」说明 None/Free 当日数据盘后 1–2 小时可用。
• 你需要 AI 助手在未配置 Key 或不支持工具调用的供应商上继续工作。

  README「AI 对话助手」说明未配置 AI Key 或使用 Codex CLI 等不支持工具调用的供应商时会 fail-closed。

前置条件

• 使用 Dev 模式时需从根目录 `.env.example` 复制 `.env`，并可配置 `TICKFLOW_API_KEY`、`AI_API_KEY` 与 `PORT=3018`。
• README 要求通过 `./dev.sh` 启动开发模式；Windows 使用 `./dev.ps1`。
• TICKFLOW_API_KEY 留空为 None 模式，README 说明该模式提供历史日 K 免费能力。
• AI_API_KEY 留空会关闭 AI；填写后启用策略生成与 AI 对话助手。
• README 将 Docker 单容器列为自托管方案，但所给材料未提供对应启动命令。

第一步命令（README 原文）

cp .env.example .env       # 按需填 TICKFLOW_API_KEY(留空 = None 模式)

要注意

• 节假日和非交易日会停止实时轮询与分钟增量，不应按工作日连续采集理解。

  README「技术架构」的交易日探针说明节假日自动停掉实时轮询与分钟增量。
• 回测虽有 SSE 流式进度，但任务运行在 spawn worker 子进程中。

  README「回测执行隔离」说明回测使用 spawn worker、持久 run ID 和锁保护的结果回传。
• 扩展数据字段按日分区快照，不能按实时字段更新来理解。

  README「分层缓存」说明扩展字段按日分区快照。
• AI 助手删除目录即可卸载，但其 AI 功能依赖 AI_API_KEY 与工具调用支持。

  README「AI 对话助手」同时说明完全解耦、删除目录即卸载，以及未配置 Key 时 fail-closed。

替代方案

• Docker Compose：不想使用 Dev 模式或本地构建流程时，可查看部署文档中的 Docker Compose 方案。

  docs/deployment.md
• GHCR 现成镜像：希望免本地构建时，README 将 GHCR 镜像列为现成部署方式。

  README「完整文档」与部署方式章节

材料未说明

• README 材料没有给出 Python、Node.js、Polars 或数据库的最低版本。
• README 材料没有给出 CPU、内存、磁盘和分钟级数据规模的最低硬件要求。
• README 材料没有给出不同数据源的完整价格、额度、覆盖范围和限流细节。
• README 材料没有给出 5,129 个 Star、44 个当日新增 Star 与 Trending 之间的直接因果证据。
• README 材料没有给出正式 Release，因此无法确认升级、回滚与版本兼容策略。