Windows 快速跑通 PanWatch跨平台开发环境搭建与避坑完整指南【免费下载链接】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/PanWatchPanWatch盯盘侠是一款覆盖 A股、港股、美股的 AI 盯盘助手集成 TradingAgents 多 Agent 投资决策支持持仓分析、实时提醒与自动报告。很多 Windows 用户担心「这个项目能在 Windows 上直接跑吗」答案是能——项目已针对 Windows 做了跨平台适配本文带你从零搭好 PanWatch 开发环境并逐一拆解 Windows 上最常见的几个坑。先搞懂三种运行 PanWatch 的方式方式适合谁难度Docker 一键部署只想用起来、不碰代码⭐make开发环境想二次开发、调试⭐⭐手动建 venv不想依赖 make 工具⭐⭐生产/自用部署看 Dockerfile一条命令跑起来开发环境看 MakefileWindows 下已内置适配逻辑后端入口是 server.py前端在 frontend/ 目录Windows 环境要求与安装顺序开发 PanWatch 只需三样东西顺序别乱Python 3.10安装时勾选「Add python.exe to PATH」Node.js 18前端 React 工程依赖pnpmnpm install -g pnpm一键装上验证版本python --version node --version pnpm --version避坑 1Windows 上 Python 虚拟环境在.venv\Scripts\下而 macOS/Linux 在.venv/bin/。这是新手最常踩的「激活命令报错」来源好在下面讲的make命令已自动处理无需手动激活。方式一Docker 一键部署Windows 用户最省心如果你的目标只是「把 AI 盯盘跑起来」强烈推荐 Docker Desktop 方案Windows 原生支持完全绕开 Python/Node 环境docker run -d --name panwatch -p 8000:8000 -v panwatch_data:/app/data sunxiao0721/panwatch:latest访问http://localhost:8000首次进入设置账号密码即可。⏱️避坑 2容器首次启动会自动下载 Chromium 浏览器截图功能用需等几分钟。如果不需要截图能力可加环境变量PLAYWRIGHT_SKIP_BROWSER_INSTALL1跳过启动秒变快。方式二make 一键启动开发环境克隆仓库后git clone https://gitcode.com/GitHub_Trending/pa/PanWatch cd PanWatch make dev-api # 后端自动创建 venv、装依赖监听 :8000 make dev-web # 前端自动 pnpm install监听 :5183两个终端分别执行打开http://localhost:5183即可看到界面前端会自动把/api代理到后端代理配置见 vite.config.ts。Makefile 顶部有一段 Windows 判断逻辑当检测到OSWindows_NT时自动切换为cmd.exe、python而非python3和.venv\Scripts\python.exe所以你不需要为 Windows 额外写任何变通脚本。⚙️避坑 3Linux/macOS 下环境变量写法是DEV_RELOAD1 python server.pyWindows 的 cmd 里是set DEV_RELOAD1 ...——make dev-api已经替你写好了见 Makefile所以请优先走 make而不是照抄 Linux 文档手动执行。前端开发服务器刻意用了:5183而不是 Vite 默认的:5173就是为了避免和你电脑上其他本地前端撞端口见 Makefile 的注释。Windows 常见报错速查避坑清单现象原因解决python3不是内部或外部命令Windows 只有python直接用make或改用python激活source venv/bin/activate报错路径分隔符不同Windows 应为.venv\Scripts\activate或直接用 make中文日志/依赖乱码控制台编码问题chcp 65001切到 UTF-8项目 requirements.txt 本身已保证 UTF-8 编码make命令不存在未安装 make装 Docker Desktop 方案绕开或choco install make8000/5183 端口被占用本地服务冲突换一个已占用的服务或关闭占用程序首次pip install很慢默认源网络波动换国内镜像源pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple 想确认环境没问题跑make test执行全部单测跑make doctor会做一轮数据源 / AI / 通知 / 数据库 / 磁盘的系统自检并给出修复建议定义见 Makefile。启动后5 分钟完成首次配置环境跑通后按 README 的「首次配置」流程走访问 Web 界面设置登录账号设置 → AI 服务商填入任意 OpenAI 兼容 APIOpenAI / 智谱 / DeepSeek / Ollama 均可设置 → 通知渠道添加 Telegram、企业微信或钉钉等推送渠道持仓 → 添加股票加入自选股并启用对应 Agent配置完成后在持仓页点一下 图标TradingAgents 的 9-Agent 投研团队就会接力分析技术/情绪/新闻/基本面 → 多空辩论 → 风控审查 → PM 决策书3-5 分钟输出一条完整推理链。常见问题 FAQQWindows 上能贡献代码吗A可以。make test、make doctor在 Windows 下均可直接运行Windows 适配行为还有专门的回归测试保障见 test_makefile_windows.py。Q不想用 Docker也不想装 makeA可以手动搭建python -m venv .venv创建虚拟环境.venv\Scripts\pip install -r requirements.txt装依赖再执行python server.py启动后端监听 :8000前端则cd frontend后pnpm install pnpm dev。Q项目目录结构长什么样A核心分四块——后端 Agent 在 src/modules/automation/、平台基础能力在 src/platform/、React 前端在 frontend/、行情数据源抽象在 packages/marketdata/更多细节见 CONTRIBUTING.md。小结Windows 用户跑 PanWatch 没有特殊门槛——自用选 Docker 一键部署开发用make dev-api/make dev-web双命令启动记住「虚拟环境路径、环境变量写法、UTF-8 编码」这三个坑你的跨平台开发环境就稳了。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考