README

盯盘侠 PanWatch — 自托管 AI 盯盘助手


  English | 简体中文 | 日本語



  管理 A 股、港股和美股持仓，监控行情与提醒，并通过 TradingAgents 进行深度分析。自托管部署，可接入你选择的 OpenAI 兼容服务商或 Ollama 本地模型。



  功能一览 · 核心功能 · 快速开始 · 详细说明 · 支持项目 · 参与贡献



  
  
  
  
  



  
    
      
      
      
    
  


!盯盘侠 PanWatch · TradingAgents 深度分析演示

 🧠 持仓页点一下 → TradingAgents 9-Agent 投研团队接力分析 → 看多看空辩论 → 风控审查 → PM 决策书,3-5 分钟一条完整推理链,结论直推到你的 IM。


❤️ 赞助商

| Logo | 简介 |
| --- | --- |
|  | 88API Token 聚合平台🧠 聚合 GPT、Claude、Gemini、Grok、DeepSeek、Kimi、GLM 等语言与编程模型；🎨 图片模型：GPT-Image、Gemini、Grok 等；🎬 视频模型：Seedance、Veo、MiniMax H3、Kling、Grok 等；🎙️ 语音能力：Whisper、TTS 等。从文案、出图、改图，到视频生成与配音🎁新用户注册送体验额度，可以检测模型能力。站内有人工客服值守！👉香港正规企业运营 稳定供应 全绿满血 不降智 提供发票立即注册 → |



 📸 功能一览

| 持仓 · 多账户汇总 | 机会页 · AI 评分选股 |
|:---:|:---:|
| !持仓管理 | !机会页 AI 评分 |
| 模拟盘 · 净值曲线 + 绩效 | 个股深度详情 |
| !模拟盘 | !个股详情 |
| 技术指标共振 · 一眼 MACD/RSI/KDJ | 价格提醒 · 条件组合触发 |
| !技术指标 | !价格提醒 |


移动端截图

 

 📱 支持 PWA，移动端可「添加到主屏幕」当原生 App 用。



 💡 如果盯盘侠对你有帮助，点右上角 ⭐ Star 支持一下 —— 这是对开源项目最好的鼓励，也能让更多人发现它。

 核心功能

| 能力 | 可以做什么 |
|---|---|
| 持仓管理 | 管理多个券商账户，查看持仓和盈亏，设置交易风格。 |
| AI 投研 | 由技术、情绪、新闻、基本面分析进入看多看空辩论、风控审查和投资组合经理决策。 |
| 定时 Agent | 按已配置的周期，在对应市场交易日执行盘前、盘中和盘后工作流。 |
| 价格提醒 | 用 AND / OR 组合条件，设置冷却时间、日上限、到期时间和通知渠道。 |
| 机会发现 | 查看排序后的候选及其入场位、目标价和风险信息。 |
| 模拟盘 | 模拟按信号建仓和平仓，查看净值和绩效。 |
| 消息推送 | 通过 Telegram、企业微信、钉钉、飞书、Bark 或 Webhook 接收报告和提醒。 |
| 移动端 | 将 PWA 添加到主屏幕，在手机上使用同一套工作台。 |

A 股、港股和美股的股票与场内 ETF 共用搜索、自选、持仓、价格提醒、行情和 K 线流程。可按代码或名称搜索，例如 510300、159915、02800、SPY。标的类型会随自选保存；数据源名称未标明 ETF 的基金，可在选中后将类型设为 ETF。

ETF 深度分析使用基金上下文，不套用上市公司的财报。基金成分、净值、费用和跟踪误差暂未接入结构化数据。模拟盘沿用既有市场规则与成本模型，尚未模拟 ETF 专属 T+0 例外和费率。

 快速开始

bash
docker run -d \
  --name panwatch \
  --restart unless-stopped \
  -e TZ=Asia/Shanghai \
  -p 8000:8000 \
  -v panwatch_data:/app/data \
  sunxiao0721/panwatch:latest


访问 http://localhost:8000，创建登录账号。

通过 TZ 指定后台调度与通知静默时段的时区，例如 -e TZ=UTC 或
-e TZ=America/New_York。镜像默认使用 Asia/Shanghai，不会自动读取宿主机时区。
页面时间展示与提醒到期输入采用浏览器时区。时区规则


首次配置

1. 访问 Web 界面，设置登录账号
2. 首次登录自动进入主流程，按自选、行情、AI、首次分析顺序完成；必做步骤不可跳过，可以暂停续接。随时从引导中心重新进入，中心还提供机会、模拟盘、助手、日常任务和数据源路线，各自保存进度，完成后可重走。直接点击高亮控件：主流程核验真实保存或测试结果，探索路线记录你确认已了解的提示
3. 主流程中，在设置 → AI 服务商配置服务、选择默认模型并测试连接，再主动生成首次分析；这会使用模型额度，结果在页面展示
4. 可选配置价格提醒和测试通知渠道。引导支持稍后处理和恢复，换浏览器或重启服务后保留进度；模型或渠道配置变更后需要重新测试
5. 基础流程跑通后，再配置定时 Agent 或体验 TradingAgents 深度分析，它们独立于首次分析设置




Docker Compose

yaml
services:
  panwatch:
    image: sunxiao0721/panwatch:latest
    container_name: panwatch
    environment:
      TZ: "Asia/Shanghai"
    ports:
      - "8000:8000"
    volumes:
      - panwatch_data:/app/data
    restart: unless-stopped

volumes:
  panwatch_data:


bash
docker compose up -d


修改 environment.TZ 为所需 IANA 时区，再执行 docker compose up -d 重建容器。
修改前核对已有 cron 和静默时段：同样的 09:00 将对应不同时间点。保留数据卷。




首次启动与浏览器安装

镜像已包含 Playwright 的系统依赖。用于截图的 Chromium 无头浏览器会在首次启动时下载到挂载卷（默认 /app/data/playwright），需要网络可达，可能耗时几分钟。

不需要截图等浏览器能力时，可设置 PLAYWRIGHT_SKIP_BROWSER_INSTALL=1 跳过安装。



 详细说明


定时 Agent 与深度分析

| Agent | 用途 |
|---|---|
| 盘前分析 | 综合隔夜走势、新闻和技术形态，形成操作计划。 |
| 盘中监测 | 在开市时监控行情异动与技术信号。 |
| 盘后日报 | 复盘当日交易，为下个交易日准备计划