PanWatch:自托管 TradingAgents 多Agent盯盘助手
给个人投资者用的自托管AI盯盘助手,把TradingAgents多Agent分析和Telegram等推送接到持仓页。
GitHub TNT-Likely/PanWatch 更新 2026-09-24 分支 main 星标 1.5K 分叉 297
Python TypeScript TradingAgents A股/港股/美股 Docker FastAPI Telegram

🧭 决策指南

适合,如果你

  • 你要监控A股、港股、美股,并希望持仓数据留在自托管环境。
    README“为什么选择盯盘侠?”写明“自托管部署,持仓数据不经过任何第三方”;“多市场 & 多账户”列出A股、港股、美股。
  • 你希望在持仓页调用TradingAgents 9-Agent流程,而不是只看MA、MACD等指标。
    README“深度分析:TradingAgents 多 Agent 决策”写明4类分析师、看多看空辩论、风控审查与PM整合决策。
  • 你需要3-5分钟内生成推理链,并推送到Telegram、微信或钉钉。
    README“深度分析”写明“3-5分钟输出完整推理链”,并列出Telegram / 微信 / 钉钉。
  • 你能运行Docker,并接受默认deepseek-chat约$0.05的单次分析成本。
    README“快速开始”提供Docker命令;“深度分析”写明默认deepseek-chat、单次约$0.05。

不适合,如果你

  • 你需要README明确保证行情数据源、延迟或数据准确率。
    README列出A股、港股、美股实时行情,但没有说明具体行情数据源、延迟或准确率。
  • 你不允许首次启动联网下载Chromium,且不能关闭Playwright浏览器安装。
    README说明Chromium首次启动自动下载,可能需要几分钟且需要网络;仅在不需要截图时可设置PLAYWRIGHT_SKIP_BROWSER_INSTALL=1。
  • 你只接受本地模型且不愿在“设置 → AI服务商”配置兼容API。
    README“首次配置”要求设置OpenAI兼容API,并列出OpenAI、智谱、DeepSeek、Ollama等服务商。
  • 你需要自动执行买卖交易,而不仅是监控、分析、提醒和持仓管理。
    README“核心功能”描述实时监控、持仓管理、智能分析、价格提醒和通知,没有说明自动下单或交易执行。

前置条件

  • Docker;README“快速开始”提供sunxiao0721/panwatch:latest镜像。
  • 首次配置需要OpenAI兼容API,支持OpenAI / 智谱 / DeepSeek / Ollama等。
  • 需要通知时,在“设置 → 通知渠道”添加Telegram或其他推送渠道。
  • 本地开发环境要求Python 3.10+ / Node.js 18+ / pnpm。
  • 若启用OTel,需要安装requirements-otel.txt并设置OTEL_EXPORTER_OTLP_ENDPOINT。

第一步命令(README 原文)

docker run -d \
  --name panwatch \
  -p 8000:8000 \
  -v panwatch_data:/app/data \
  sunxiao0721/panwatch:latest

要注意

  • 首次容器启动会把Chromium安装到/app/data/playwright,挂载卷需可写且网络可达。
    README“快速开始”说明Chromium安装到默认/app/data/playwright,首次启动可能需要几分钟且需要网络。
  • 想跳过Chromium时只能关闭截图等浏览器能力,需设置PLAYWRIGHT_SKIP_BROWSER_INSTALL=1。
    README“快速开始”明确说明该变量适用于不需要截图等浏览器能力的场景。
  • 本地前端监听5183而不是Vite默认5173,并代理API到127.0.0.1:8000。
    README“本地开发”明确写出前端dev server为http://localhost:5183并代理到127.0.0.1:8000。
  • OTel默认关闭,只有安装可选依赖并配置OTEL_EXPORTER_OTLP_ENDPOINT才导出trace。
    README“OTel导出(可选,默认关闭)”及“开启三步”给出依赖安装和端点配置要求。

材料未说明

  • README没有列出A股、港股、美股的具体行情数据供应商、API限制和延迟指标。
  • README没有给出并发Agent运行数量、单实例可管理账户数或股票数上限。
  • README没有说明TradingAgents 9-Agent分析在不同模型供应商下的质量差异。
  • README没有说明Telegram、微信、钉钉等通知渠道的失败重试、限流和消息保留策略。
  • README没有说明认证机制之外的安全细节,例如CSRF、防暴力破解和敏感配置加密。
  • README没有说明Docker镜像的资源需求、CPU、内存或磁盘最低配置。
  • README没有说明项目是否支持自动下单、券商交易接口或回测。

💡 深度解析

6
不适合 我需要针对 A 股、港股和美股做毫秒级信号响应、自动券商下单,并同步真实成交、现金、费用和融资融券数据;PanWatch 能作为实盘交易系统吗?
适合读者: 需要实盘自动下单、毫秒级响应和券商成交同步的量化交易开发者

不适合,因为 README 将项目定位为监控、分析、提醒和模拟盘工具,而不是高频或自动化实盘交易系统。

  • 项目核心流程是行情监控、持仓管理、AI 分析和 IM 推送;深度分析一条完整推理链需要 3–5 分钟,明显不符合毫秒级响应要求。
  • README 明确提供“模拟盘、净值曲线 + 绩效”,但项目洞察进一步指出这不代表具备实盘交易执行、滑点处理或完整合规能力。
  • 多账户功能强调独立管理和汇总展示,并没有承诺同步所有券商的真实成交、现金、费用、融资融券和公司行动数据。
  • 规则提醒可以组合价格、涨跌幅、成交额和量比条件,但提醒触发不等于订单路由、风控校验或成交回报。README 也没有提供券商下单接口或交易执行模块。
  • 功能一览: “模拟盘 · 净值曲线 + 绩效”
  • 深度分析: “3-5 分钟输出完整推理链”
  • 多市场 & 多账户: “支持多券商账户独立管理,汇总展示总资产”
  • 项目洞察 usage_limitations: “不应视为高频交易系统、自动化实盘交易系统”
材料未说明:README 未说明是否存在任何券商下单适配器、订单状态回报或实盘交易 API。;README 未说明实时行情的端到端延迟、滑点模型、交易所级风控和合规支持。
适合 我维护一个 Python 3.10+、FastAPI 后端,希望把 TradingAgents 的 Agent、LLM 调用和节点进度送到 Jaeger 或 Langfuse;PanWatch 是否有足够的追踪能力?
适合读者: 需要排查 TradingAgents 多节点延迟和 LLM 成本的 Python/FastAPI 运维开发者

适合,项目原生记录 Agent 运行与成本,并可选导出 OpenTelemetry;但外部 APM 不是默认开启,也需要你安装额外依赖。

  • README 说明内建结构化日志、trace_idagent_runs 运行表、TradingAgents 节点级进度和成本记录,不依赖外部组件即可查看应用内运行状态。
  • 可选 OTel 会把一次 Agent 运行作为 root span,把单次 LLM 调用作为 gen_ai 子 span,并把 TradingAgents 节点映射为子 span。
  • README 明确支持 Jaeger、Tempo 和 Langfuse 等 OTLP 入口,且默认关闭,不配置 endpoint 时不会改变现有行为。
  • 你需要安装 requirements-otel.txt 并设置 OTEL_EXPORTER_OTLP_ENDPOINT;README 没有说明高并发下的采样、保留周期、敏感提示词脱敏或 OTel 导出失败后的补偿机制。
  • OTel 导出: “结构化日志 trace_id 贯穿 / agent_runs 运行表 / TradingAgents 节点级进度与成本”
  • OTel 导出: “Agent 一次运行 → root span”“单次 LLM 调用 → gen_ai 子 span”
  • OTel 导出: “默认完全关闭”与“可选依赖 requirements-otel.txt”
pip install -r requirements-otel.txt
材料未说明:README 未说明高并发 Agent 运行时的 OTel 采样策略、数据保留策略和导出失败重试机制。;README 未说明提示词、新闻内容和持仓字段在外部 APM 中的脱敏规则。
适合 我同时管理 A 股、港股和美股持仓,希望用 Docker 部署,并且不让持仓数据经过第三方平台;PanWatch 是否适合?
适合读者: 熟悉 Docker、希望把 A 股/港股/美股持仓留在自有服务器上的个人投资者

适合,前提是你愿意自行维护容器、数据卷和访问安全。

  • README 将项目定位为“自托管 AI 盯盘助手”,并明确写有“数据私有——自托管部署,持仓数据不经过任何第三方”。
  • 它覆盖 A 股、港股、美股实时行情,并支持多券商账户独立管理和总资产汇总,符合你的多市场持仓约束。
  • Docker 启动命令把 panwatch_data 挂载到 /app/data;配置、持仓和运行数据依赖这个持久化卷,不能只映射端口。
  • 自托管不等于自动安全:JWT 密钥、登录密码、服务器端口和 API 密钥仍由你保护。README 没有说明完整的备份、升级回滚、HTTPS 配置和券商账户自动同步范围,因此这些能力不能默认视为具备。
  • 为什么选择盯盘侠: “数据私有 — 自托管部署,持仓数据不经过任何第三方”
  • 核心功能: “覆盖市场:A 股、港股、美股实时行情”与“支持多券商账户独立管理”
  • 快速开始:`-v panwatch_data:/app/data`
docker run -d \
  --name panwatch \
  -p 8000:8000 \
  -v panwatch_data:/app/data \
  sunxiao0721/panwatch:latest
材料未说明:README 未说明具体支持哪些券商接口,以及真实成交、现金、费用、融资融券和公司行动是否能自动同步。;README 未提供正式的备份、灾难恢复和 HTTPS 部署方案。
适合 我想在本地同时修改 FastAPI 后端和 React 18/TypeScript 前端,并使用项目规定的 Node.js 18+、pnpm 和 8000/5183 端口;PanWatch 的开发环境是否适合我?
适合读者: 同时维护 React 18/TypeScript 前端与 Python 3.10+ 后端的开源贡献者

适合,README 已给出前后端分离的本地启动方式和端口约定,适合同时开发 API 与 Web 界面。

  • 环境要求明确为 Python 3.10+、Node.js 18+ 和 pnpm;后端技术栈是 FastAPI、SQLAlchemy、APScheduler、OpenAI SDK,前端是 React 18、TypeScript、Tailwind CSS 和 shadcn/ui。
  • 推荐的 make dev-api 会自动创建 venv、安装依赖并监听 8000;make dev-web 会自动执行 pnpm install 并监听 5183。
  • 前端开发服务器把 /api 代理到 127.0.0.1:8000,因此本地联调不需要额外拼接 API 地址。
  • README 没有给出测试覆盖率、前端组件测试、数据库迁移流程或贡献分支的 CI 门槛;如果你要做较大改动,这些工程约束需要另行确认。
  • 本地开发: “Python 3.10+ / Node.js 18+ / pnpm”
  • 本地开发:`make dev-api` 与 `make dev-web`
  • 本地开发: “前端 dev server 跑在 http://localhost:5183,并把 /api 代理到 127.0.0.1:8000”
  • 技术栈:后端 FastAPI,前端 React 18 / TypeScript
make dev-api
材料未说明:README 未说明自动化测试命令、测试覆盖率要求和数据库迁移工具。;README 未说明前端构建、API 变更和 PR 合并所需的 CI 检查。
适合 我主要做 A 股和港股中短线交易,不能全天盯盘,希望按 RSI、KDJ、MACD 共振以及价格条件触发 Telegram 或企业微信提醒;这个项目适合我的工作流吗?
适合读者: 无法全天盯盘、需要 Telegram 或企业微信提醒的中短线投资者

适合,尤其适合作为监控和提醒层,而不是秒级交易执行系统。

  • 项目覆盖 A 股和港股,并提供盘前分析、盘中监测、盘后日报和新闻速递,能对应你无法全天盯盘的约束。
  • 技术指标包含 RSI、KDJ、MACD、MA、布林带、量比和量价关系;盘中监测明确支持 RSI/KDJ/MACD 共振提醒。
  • 价格提醒支持价格、涨跌幅、成交额、量比的 AND/OR 组合,并可设置交易时段、冷却时间、日触发上限和到期时间,适合控制通知噪声。
  • Telegram、企业微信、钉钉、飞书、Bark 和自定义 Webhook 都有列出。但多 Agent 分析需要 3–5 分钟,且行情和通知受数据源、网络和第三方接口影响,不适合秒级策略。
  • 核心功能: “盘中监测”“交易时段实时”以及“RSI/KDJ/MACD 共振时推送提醒”
  • 价格提醒:支持价格、涨跌幅、成交额、量比条件组合,以及冷却时间和日触发上限
  • 全渠道通知:Telegram / 企业微信 / 钉钉 / 飞书 / Bark / 自定义 Webhook
  • 深度分析: “3-5 分钟输出完整推理链”
材料未说明:README 未说明各行情数据源的具体刷新频率、港股交易时段覆盖和断线重试策略。;README 未保证 Telegram、企业微信或其他通知渠道的送达时延和可用性。
适合 我需要在默认 DeepSeek、OpenAI 兼容服务和本地 Ollama 之间切换,并关注每次 3–5 分钟多 Agent 分析的成本;PanWatch 能满足吗?
适合读者: 想在云端模型与本地 Ollama 之间切换的 AI 实验开发者

适合,因为项目同时提供兼容接口、多 Agent 流程和调用成本可观测性,但模型效果与实际费用仍取决于你配置的服务。

  • README 的首次配置支持 OpenAI、智谱、DeepSeek、Ollama 等 OpenAI 兼容 API,默认模型为 deepseek-chat
  • 分析链路包含技术、情绪、新闻、基本面分析师,随后进行看多看空辩论、风控审查和 PM 整合;一次完整推理链约需 3–5 分钟。
  • README 给出的单次成本约为 $0.05,并在应用内记录 trace_id、Agent 运行、节点级进度与成本,便于观察消耗。
  • 但 README 没有给出 Ollama 的最低硬件、具体模型兼容矩阵或各服务商的实际价格,因此不能仅凭项目说明预测本地模型质量和月度账单。
  • 首次配置: “支持 OpenAI / 智谱 / DeepSeek / Ollama 等”
  • 深度分析: “默认 deepseek-chat,单次 ~$0.05”
  • 深度分析与 OTel 导出: “3-5 分钟输出完整推理链”以及“节点级进度与成本”
材料未说明:README 未说明 Ollama 所需的 CPU、GPU、内存、模型大小和并发限制。;README 未说明不同模型服务商的具体计费规则、上下文限制和兼容性差异。

✨ 核心亮点

  • TradingAgents 9-Agent完成投研决策链
  • 3-5分钟输出完整推理链并推送
  • Docker部署,5分钟完成基础配置
  • 覆盖A股、港股、美股实时行情
  • 默认deepseek-chat,单次约$0.05

🔧 工程化

  • 持仓页触发4类分析师、辩论、风控与PM决策
  • FastAPI后端管理多账户、Agent调度与行情分析
  • Telegram、微信、钉钉等渠道同步结论
  • Docker镜像包含Playwright运行依赖

⚠️ 风险

  • 首次启动会下载Chromium,可能耗时数分钟且需联网
  • AI分析默认deepseek-chat,单次成本约$0.05
  • README未说明行情数据源与实时性保障
  • 启用OTel需额外安装requirements-otel.txt

👥 适合谁?

  • 需要自托管A股、港股、美股监控的个人投资者
  • 使用Docker并希望接入TradingAgents的开发者
  • 需要Telegram、企业微信或钉钉告警的团队
  • 需要FastAPI与React 18本地开发环境的贡献者