TNT-Likely/PanWatch · Python + TypeScript · MIT · 固定 commit 721b66e1
PanWatch（盯盘侠）中文实战手册：自托管 AI 盯盘与持仓研究的判断依据
这个站不是把官方 README 翻成中文，而是回答一个具体问题：把 PanWatch 装到自己机器上之后，它凭什么给出结论、什么时候会推消息给你、什么情况下它的输出不可信、成本与风险落在谁身上。所有事实取自官方仓库固定 commit 721b66e1 的文档、配置文件与源码原文，本站没有在本机安装或运行 PanWatch，因此全站不出现「实测运行」类表述。
项目来源
官方仓库 TNT-Likely/PanWatch（2026-09-29 采集）。Star 与 Fork 数会随社区活动变化，以仓库当前页面为准。
在 GitHub 查看固定版本源码PanWatch 能解决什么？盯盘重复劳动，而不是替你交易
官方 README 给出的价值主张是「把自选与持仓变成全天候 AI 投研工作台」。下表把它拆成具体麻烦，并指出本站哪一页讲清了这条麻烦对应的实现细节。
| 盯盘与持仓研究的常见麻烦 | PanWatch 的做法（官方口径） | 本站哪一页讲透 |
|---|---|---|
| 开盘前要自己看隔夜美股、新闻和技术形态 | 盘前分析 Agent，默认 cron 0 9 * * 1-5，输出今日操作策略 | 提醒推送 |
| 盘中异动靠人盯，错过就是错过 | 盘中监测 Agent，默认每 5 分钟一轮（*/5 9-15 * * 1-5），只在有事件时才分析 | 提醒推送 |
| 收盘后复盘要手工整理一整天 | 收盘复盘 Agent，默认 30 15 * * 1-5，且是三个 Agent 里默认就开着的 | 提醒推送 |
| 多个市场的自选与持仓散在不同软件里 | A 股/港股/美股统一模型，多券商账户独立管理并汇总总资产 | 交易时段 |
| 想知道「这个消息到底算不算重要」 | 行情 + 资金流 + 新闻 + 公告 + 龙虎榜等 11 类数据进同一条分析链 | 数据源 |
| 单看一个指标无法判断，想要多角度交叉验证 | 接入 TradingAgents：四类分析师 → 多空辩论 → 风控 → PM 决策 | 研究链 |
| AI 给了一堆结论，不知道能不能信 | 评级口径、后验评估与「样本不足」标记都写在代码里，可逐项复核 | 输出审计 |
| 不想把持仓数据放到别人的云盘里 | 自托管：数据落在你挂载的卷里，行情与模型配置也由你掌握 | 成本运维 |
从添加一只股票到收到结论，PanWatch 内部按什么顺序做事？
下面的顺序综合了官方快速开始、首次配置四步与调度器源码里的执行路径；每一步的默认值都写在本站对应页面。
从空盘到可复核结论：PanWatch 的八个环节
Symbol.parse）。glm-4），设置 → 通知渠道接 Telegram 等。PanWatch 有哪些能力模块，各自对应本站哪一页？
按官方仓库的模块目录与文档整理。每一项都指向本站具体页面，避免停留在功能清单。
| 能力模块 | 它做什么（官方口径） | 本站对应页面 |
|---|---|---|
| 自动化 Agent | 盘前分析 / 盘中监测 / 收盘复盘三个 workflow Agent + 一个已弃用的图像分析 capability Agent | 提醒推送 |
| 价格提醒 | 价格、涨跌幅、成交额、成交量、量比五类条件按 AND/OR 组合，含冷却、日上限与到期 | 提醒推送 |
| 行情数据层 | 11 类结构化数据（报价/K 线/资金流/事件/快讯/基本面/龙虎榜/两融/股东户数/分红/北向）+ 热门榜与指数两类特殊入口 | 数据源 |
| 交易时段与日历 | 三个市场各自的时区与时段定义；A 股用权威日历，港美股只判周末 | 交易时段 |
| 持仓与账户 | 多券商账户独立管理、汇总总资产、按短线/波段/长线设置交易风格 | 部署 |
| TradingAgents 深度分析 | 四类分析师 → 看多看空辩论 → 风控三方 → PM 决策；默认 deepseek-chat、单次约 0.05 美元 | 研究链 |
| 输出后验与评估 | 建议记录按交易日 K 线回看命中情况，5 日样本不足 20 条时标记为样本不足 | 输出审计 |
| 模拟盘 | 官方提供模拟交易账本；深度分析结论写进模拟信号的桥接默认关闭，且只处理买入方向 | 输出审计 |
| 导航级助手 | 基于自研 Agent 运行时的对话助手：工具分级暴露、写操作需审批、可暂停可恢复 | 研究链 |
| 通知与去重 | Telegram / 企业微信 / 钉钉 / 飞书 / Bark / Webhook，含内容去重、静默时段与每 Agent 独立 TTL | 提醒推送 |
| 可观测性 | 结构化日志 + trace_id + agent_runs 运行表 + 节点级进度与成本；OpenTelemetry 导出默认关闭 | 成本运维 |
| PDF 报告导出 | WeasyPrint 主引擎（需 pango/cairo 与中文字体），不可用时回退 xhtml2pdf | 部署 |
PanWatch 当前是什么状态？版本与核验快照
第三方介绍页最容易过期，所以本站把核验基准、取值与边界单独列出来。所有项目状态以官方仓库为准。
| 核验项 | 取值 | 来源与边界 |
|---|---|---|
| 仓库与默认分支 | TNT-Likely/PanWatch · main | GitHub API；固定 commit 721b66e13d85430ade0f9cf83bc8a8947cd0a21d |
| 语言构成 | Python 2,833,768 字节 · TypeScript 1,455,061 字节 · 其余 Shell/Makefile/Dockerfile/PowerShell/HTML | GitHub languages API（2026-09-29） |
| 版本口径 | 最新 Release 0.16.1；仓库根 VERSION 文件内容为 dev | Releases API + VERSION 原文；两者不是一回事 |
| 发布节奏 | 0.10.2 → 0.16.1 共 10 个 release，其中 0.15.0/0.16.0/0.16.1 集中在 2026-09-25 至 09-28 | Releases API；升级前请读 Release Notes |
| 技术栈 | FastAPI · SQLAlchemy · APScheduler · OpenAI SDK · React 18 · TypeScript · Tailwind · shadcn/ui | README.zh-CN.md 技术栈表 |
| 运行环境 | Docker 路径无需本地 Python；本地开发需 Python 3.10+ / Node.js 24.14.0 / pnpm 9.15.9 | README.zh-CN.md 与 CONTRIBUTING.zh-CN.md |
| 许可 | MIT | 仓库 LICENSE；第三方数据源与上游 TradingAgents（Apache-2.0）各自遵循其条款 |
| 本站实测状态 | 未安装、未运行 | 本站未在本机执行 PanWatch，全站不提供运行输出级证据 |
一个必须说清楚的同名项目：SERP 里出现的
windfgg/Pan1Watch 描述与主仓库几乎一致（同样自称「盯盘侠」），但它是 fork：创建于 2026-03-12、37 star、最后一次推送 2026-03-19，已经半年未更新。以 TNT-Likely/PanWatch 为准，不要照抄旧 fork 的说明。同一件事，官方资料怎么讲、本站补什么？
下表逐行说明本站与官方文档的分工，以及哪些结论仍然需要你回官方核实。
| 同一件事 | 官方资料怎么讲 | 本站补什么 |
|---|---|---|
| 一次深度分析到底跑了哪些角色 | README 写「nine-agent / 9-Agent 投研团队」，流程图文档写「四类分析师 → 多空辩论 → 风控 → PM」 | 把两处口径并列，并给出上游 v0.5.0 源码里真实的 12 个节点清单，说明「9」在仓库里没有对应名单 |
| 一次分析要花多少钱 | README 写「默认 deepseek-chat，单次约 0.05 美元」 | 补上预算上限、超预算动作、结果缓存 12 小时、超时与重试次数这些真正决定账单的参数 |
| 行情数据从哪来、坏了怎么办 | README 只列「A 股/港股/美股实时行情」 | 展开成 11 类数据 × 厂商覆盖矩阵 + 默认源优先级 + 主备降级规则 + 包内缓存 TTL |
| 提醒为什么没有推给我 | README 只列条件类型与冷却、日上限等字段名 | 给出触发门槛的判定顺序，以及「没收到消息 ≠ 规则没命中」这条最容易误判的结论 |
| 时间怎么算 | README 只写 TZ 影响调度与展示 | 补充三个市场的时段与代码正则、A 股日历来源、港美股只判周末的降级策略，以及提醒日计数按 UTC 分界 |
| AI 结论能不能信 | README 展示多 Agent 推理链与结论推送 | 给出评级来源优先级、REVIEW（待人工复核）语义、后验评估口径与 20 样本门槛 |
PanWatch 的三条官方部署路径怎么选？装完先做什么？
官方 README 给出 Docker 单容器、Docker Compose 与本地开发三条路径。本页只给选择依据，逐条命令与排错在部署页。
| 部署路径 | 适合谁 | 前置要求与注意点 | 本站对应页 |
|---|---|---|---|
| Docker 单容器 | 多数个人用户，想最快看到界面 | 已装 Docker；镜像 sunxiao0721/panwatch:latest，映射 8000:8000 与数据卷，首次启动会下载 Chromium，需要网络与数分钟 | 部署与首次跑通 |
| Docker Compose | 要固定挂载与重启策略、愿意保存一份配置文件 | 与单容器等价，只是把参数写进 docker-compose.yml；升级用 docker compose up --build -d | 部署与首次跑通 |
| 本地开发 | 要改代码、加数据源或自己写 Agent | Python 3.10+ / Node.js 24.14.0 / pnpm 9.15.9；后端 make dev-api 监听 8000，前端 make dev-web 监听 5183 | 部署与首次跑通 |
tradingagents 包是 git 直装、首次安装会拉约 115 个依赖包（约 2–5 分钟），不启用则零开销。不想维护环境？PanWatch 之外的免部署路线能做什么
如果你只想快速得到一个研究结论、不想维护常驻服务，本机 EasyClaw 技能路线是另一条选择。以下为真实对话截图，可左右切换。
什么情况下该自建 PanWatch，什么情况下不该？
自建的成本不只是装一个容器，还包括首次配置、模型费用、常驻维护与数据源不确定项。下表把选择依据摆出来。
| 你的情况 | 适合自建？ | 原因 |
|---|---|---|
| 持仓数据必须留在自己机器上 | 适合 | 自托管部署，数据写入你挂载的卷（默认 /app/data） |
| 需要一个到点就自己跑、没到阈值就不吵我的盯盘助手 | 适合 | 三个 workflow Agent 有默认 cron；提醒有冷却、日上限与静默时段 |
| 要同时盯 A 股、港股和美股 | 适合 | 三市场统一模型；但请看交易时段页的日历口径差异 |
| 希望 AI 给出多角度的第二意见，且愿意自己复核 | 适合 | TradingAgents 研究链 + 后验评估记录；复核口径见输出审计页 |
| 只想偶尔问几个数据，不想维护常驻服务 | 不建议 | 常驻调度的价值在「不用你记着」；偶尔查询用免部署技能路线更省 |
| 不接受任何模型 API 费用 | 不建议 | 代码 MIT，但 Agent 与深度分析都要调模型；本地 Ollama 可降低成本而非归零 |
| 期望「装完自动给出可交易信号」 | 不建议 | 官方定位是监控与研究：不做自动下单，深度分析结论写模拟信号默认关闭 |
| 要求覆盖期货、外汇或加密货币 | 不建议 | 三市场模型只到 A 股/港股/美股；有期货/加密需求应换项目 |
PanWatch（盯盘侠）到底是什么？
它是 TNT-Likely 开源的自托管 AI 盯盘与持仓研究台：A 股/港股/美股监控、持仓管理、自动分析、多渠道提醒，并接入 TradingAgents 做多 Agent 投资研究。仓库创建于 2026-01-23，最新 Release 为 0.16.1（2026-09-28），MIT 许可。它不是自动交易系统，也不是看盘软件；最新能力与版本以官方仓库为准。
这个站的内容是实测还是整理？
是官方仓库固定 commit 的核验结果（按 commit 取原文并比对 SHA-256），加上本站基于官方口径整理的判断与排查路径。本站没有在本机安装或运行 PanWatch，因此不会提供任何运行输出级证据。这条边界很重要：自托管项目的真实问题（首次 Chromium 下载、数据源字段未校准、时区与交易日历差异）恰恰只有真的跑过才会遇到，本站宁愿把口径和判定路径写清楚，也不用未经验证的运行结果冒充证据。
它免费吗？哪些地方要花钱？
代码是 MIT，项目本身免费。实际开销有三层：模型调用（Agent 与深度分析）、服务器与存储、以及可选的数据源与通知服务。官方默认把深度分析月度预算设成 10 美元且超预算直接拒绝执行，并提供结果缓存来控制重复花费——具体单价请以各模型厂商官网与官方配置为准，本站不复制任何报价数字。
能自动交易吗？会替我做买卖吗？
不会。官方定位是监控与研究：提醒命中只做弹窗与渠道推送；深度分析结论写进模拟盘信号的开关（emit_paper_trading_signal）默认关闭，即使打开也只处理买入方向、只写模拟信号。真实下单不在本项目范围内。
支持哪些市场？期货和加密货币可以吗？
官方模型只覆盖 A 股、港股、美股三个市场（MarketCode 只有 CN/HK/US 三个取值），期货、外汇与加密货币不在支持范围内。各市场的行情源覆盖度不同，具体见数据源页的覆盖矩阵。
支持哪些通知渠道？国内能收到吗？
官方 README 列出 Telegram、企业微信、钉钉、飞书、Bark 与自定义 Webhook，底层由 apprise 承载。国内使用 Telegram 通常需要自行配置出站代理（项目支持环境变量、.env 与界面三种代理配置方式）。各渠道的可用性与限制以官方文档和渠道自身规则为准。
为什么我配了提醒却没收到消息？
先分清两种可能：规则没命中，或命中了但没推成功。后者会写进命中记录（含失败原因），所以「没收到消息」不等于「规则没命中」。前者要按门槛顺序排查：停用、过期、非交易时段、日触发上限、冷却时间、去重与静默时段——任一道拦住都会静默跳过。完整判定顺序见提醒推送页。
它的「实时行情」是交易所级实时吗？
不是。默认数据源是免 key 的公开行情接口（腾讯、新浪、东方财富为主源），实际延迟取决于源本身。页面与提醒都建立在「轮询 + 缓存」之上：报价缓存 5 秒、提醒扫描默认每 60 秒一轮并带 20 秒抖动，因此不要把它当成逐笔级实时系统。
AI 给的建议能不能直接照着做？
不建议，也不符合官方口径。官方在深度分析里明确把无法解析的 PM 评级标为「待人工复核」，并把它降级成不触发自动交易的持有状态；后验评估在 5 日样本不足 20 条时会标记样本不足。合理用法是把它当第二意见，并按输出审计页给出的复核清单逐项检查。
和 EasyClaw 是什么关系？
没有已证实的集成关系：官方仓库与文档没有提到 EasyClaw，本机技能目录里也没有针对 PanWatch 的技能。本站对比页列的是两条并行路线：自建常驻服务，与本机免部署技能提供的研究入口。技能侧状态均为「可被发现（catalog_visible）」，本站未验证其安装与运行。
版本更新这么快，我该怎么升级？
官方两条路径不同：本地构建用 git pull 加 docker compose up --build -d；直跑镜像则重新拉取镜像并重建容器。整个 data/ 目录不属于 git 管理，所以升级前先备份数据卷，并读一遍对应 Release Notes（0.10.2 到 0.16.1 共 10 个版本）。
自托管是不是就等于数据更安全？
不等于自动安全。自托管把数据留在你自己的基础设施里，但同时也把密钥管理、主机安全、反向代理、备份、日志脱敏与公网暴露风险交回给你。官方安全政策明确第三方 AI 与行情供应商、用户自建代理不在其修复范围。具体清单见成本运维页。