README“为什么选择盯盘侠?”写明“自托管部署,持仓数据不经过任何第三方”;“多市场 & 多账户”列出A股、港股、美股。
PanWatch:自托管 TradingAgents 多Agent盯盘助手
给个人投资者用的自托管AI盯盘助手,把TradingAgents多Agent分析和Telegram等推送接到持仓页。
🧭 决策指南
为什么现在热: 无法从材料判断
适合,如果你
-
你要监控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: “不应视为高频交易系统、自动化实盘交易系统”
适合
我维护一个 Python 3.10+、FastAPI 后端,希望把 TradingAgents 的 Agent、LLM 调用和节点进度送到 Jaeger 或 Langfuse;PanWatch 是否有足够的追踪能力?
适合读者: 需要排查 TradingAgents 多节点延迟和 LLM 成本的 Python/FastAPI 运维开发者
适合,项目原生记录 Agent 运行与成本,并可选导出 OpenTelemetry;但外部 APM 不是默认开启,也需要你安装额外依赖。
- README 说明内建结构化日志、
trace_id、agent_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
适合
我同时管理 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
适合
我想在本地同时修改 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
适合
我主要做 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 分钟输出完整推理链”
适合
我需要在默认 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 分钟输出完整推理链”以及“节点级进度与成本”
✨ 核心亮点
-
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本地开发环境的贡献者