PanWatch 升级指南：AI盯盘工具如何从旧版本平滑升到最新版，数据一条不丢

【免费下载链接】PanWatchPanWatch — AI stock monitoring for A-shares, HK & US markets, powered by TradingAgents. Portfolio insights, real-time alerts & automated reports.｜盯盘侠：覆盖 A股/港股/美股的 AI 盯盘、持仓分析、实时提醒与自动报告。项目地址: https://gitcode.com/GitHub_Trending/pa/PanWatch

如果你正在使用PanWatch（盯盘侠）做 A股/港股/美股 的 AI 盯盘、持仓分析和实时提醒，这篇升级教程会告诉你：如何把旧版本平滑升级到最新版，且持仓、提醒规则、分析历史一条数据都不丢。PanWatch 内置了版本化数据库迁移和自动备份机制，升级只需要三步。

一、先看懂：为什么升级不会丢数据

很多用户担心升级会把本地数据清空。PanWatch 的设计让这件事变得很安全：

1. 数据全部存放在独立数据卷

PanWatch 的所有业务数据（数据库、日志、缓存）都写在data/目录里，核心是那个 SQLite 数据库文件。核心逻辑见 src/platform/persistence/database.py：

• 数据库默认落在data/panwatch.db；
• 开启 WAL 模式和外键约束，读写更稳；
• 并发写入有 5 秒超时保护，避免"卡死"。

Docker 部署时这个目录对应挂载的panwatch_data卷。只要升级时继续挂载同一个卷，历史数据就原封不动。

2. 内置自动迁移引擎，启动即完成升级

数据库结构升级由 src/platform/persistence/migrations.py 里的版本化迁移系统负责，机制很可靠：

• 每条迁移都有版本号 + 校验和（checksum），记录在schema_migrations表中；
• 已执行且校验一致的迁移会自动跳过，重复启动不会重复执行；
• 迁移采用"缺列才补、缺表才建"的幂等写法，新旧版本混跑也安全；
• 历史数据还会被自动回填到新结构（例如把旧版选股建议平滑迁移成新版策略信号），你看到的都是迁移后的完整数据；
• 执行迁移前会自动生成带时间戳的数据库备份（panwatch.db.bak.时间戳），见 src/platform/persistence/database.py#L179-L194。

简单说：你只管换版本，数据库结构 PanWatch 自己会升级，还自带保险丝。

二、三步完成 Docker 升级（最快方法）

前提：你的旧版本已经通过 Docker 部署（docker run或 Docker Compose），数据卷名为panwatch_data。

第 1 步：停止旧容器

docker stop panwatch

第 2 步：拉取最新镜像

docker pull sunxiao0721/panwatch:latest

第 3 步：用同一数据卷重新启动

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

打开http://localhost:8000即可。后端端口固定为8000（约定见 Makefile），升级后不会改端口、不会丢配置。

💡 小贴士：PanWatch 内置了版本更新检测（src/modules/administration/update_checker.py），页面会自动提示你是否有新版可用，15 分钟刷新一次，无需自己盯着版本。

源码部署的用户

如果你是从源码运行的，只需更新代码到最新提交，然后重启服务即可。依赖如有变化，重新执行make setup-backend（见 Makefile）。数据库迁移逻辑和 Docker 版本完全相同，启动时自动执行。

三、升级后如何验证：3 个动作确认一切正常

1. 跑一次系统自检

PanWatch 自带doctor自检命令，覆盖数据库、磁盘、调度器、数据源、AI 模型、通知渠道六类检查，并直接给出中文修复建议：

make doctor

全部 ✅ 即代表升级环境健康。实现见 src/modules/administration/doctor.py，也可通过 src/modules/administration/selfcheck.py 的 Web 端自检使用。

2. 检查持仓与组合页

登录后打开"投资组合"页，确认账户、持仓、收益曲线都还在：

3. 检查提醒规则页

价格提醒规则、触发记录都存放在数据库里，升级后应完整可见：

🎉 如果这两页数据都在，说明迁移顺利完成，AI 盯盘、自动报告等全部功能继续可用。

四、常见升级问题 FAQ

Q1：迁移会不会把数据改坏？不会。每次迁移前自动备份数据库文件；迁移按"缺什么补什么"执行，且每条迁移有校验和防重复执行。真出异常时，用同目录下的panwatch.db.bak.*备份文件覆盖回原文件即可恢复。

Q2：升级后界面变了、某些旧 Agent 不见了？这是正常的功能演进——迁移脚本会自动给历史 Agent 打上类型快照和"已替代"标记（见 src/platform/persistence/migrations.py#L134-L176），旧的分析历史仍然保留可查，不会消失。

Q3：升级后端口变了，打不开页面？PanWatch 后端固定使用8000端口（Docker 与本地开发一致，专门为存量用户避免升级困惑），请确认docker run时-p 8000:8000未变。

Q4：如何确认当前是不是最新版？登录页面查看更新提示即可，版本检测模块会展示最新语义化版本号；本地版本记录在 VERSION 文件中。

五、升级后值得体验的新功能

版本平滑升上来之后，别急着关掉页面，这些功能正是升级的回报：

• AI 选股机会池：多策略信号每日自动扫描，给出买入/观望建议；
• 技术分析视图：K 线叠加指标与 AI 解读；
• AI 盯盘 Agent：盘前展望、盘中监控、收盘复盘自动执行并推送报告。

总结

记住三句话：数据在卷里、迁移自动跑、自检兜底验。按上面的流程操作，PanWatch 从旧版本升到最新版全程无感，AI 盯盘、持仓分析和实时提醒无缝继续。

【免费下载链接】PanWatchPanWatch — AI stock monitoring for A-shares, HK & US markets, powered by TradingAgents. Portfolio insights, real-time alerts & automated reports.｜盯盘侠：覆盖 A股/港股/美股的 AI 盯盘、持仓分析、实时提醒与自动报告。项目地址: https://gitcode.com/GitHub_Trending/pa/PanWatch