#常见问题

#免责声明

• 本项目仅用于个人学习、研究和技术交流。项目中对养基宝 browser-plug-api 的理解来自对公开浏览器插件网络交互的学习与反向工程分析；本项目非养基宝官方产品，与养基宝或任何第三方机构不存在从属、授权、合作或背书关系。请勿用于商业化、批量抓取、绕过限制或任何违反平台协议、法律法规的用途；因使用本项目或二次开发产生的任何责任与项目作者无关。
• 项目展示的基金、股票、指数、收益等金融数据仅用于软件功能展示和技术研究，不构成投资建议、理财推荐或收益承诺。基金/股票有风险，投资需谨慎，请自行判断并承担风险。

#ServerSelectionTimeoutError: mongo:27017

mongodb://mongo:27017 仅用于 Docker 内 app 容器。本机 ./start.sh 请使用 mongodb://localhost:27017，并先执行 ./dev-infra.sh。

#Docker 容器无法启动

检查 docker compose logs，常见为环境变量格式问题。CORS_ORIGINS 支持逗号分隔。

#浏览器插件无法加载

• 使用 Chrome / Edge / 360 极速（Chromium 内核）
• 开发：cd chrome-extension && pnpm dev，加载 dist/ 目录
• 401 时重新扫码登录

#VS Code 扩展底部 Panel 不显示

确保已重载窗口；扩展使用 onStartupFinished 在启动后注册 Panel Tab。点击左下角状态栏或命令 Fund Helper: 打开底部面板。

#JetBrains 插件

#界面白屏或一直 Loading

• 需 IDE 2024.2+ 且 JCEF 可用（Settings → 搜索 JCEF）
• 首次打开侧边栏会加载 JCEF Webview，稍等数秒
• 开发构建：在仓库根目录 pnpm install，再 pnpm --filter fund-helper-jetbrains-webview run build:webview，最后在 jetbrains-extension/ 运行 ./gradlew runIde

#底部面板关闭后无法再次打开

点击状态栏右下角的收益数字（不是悬浮区域）。请使用最新版插件（已修复 ToolWindow 可用性问题）。

#本地 Gradle 构建失败

配置 JDK 17 的 JAVA_HOME（Homebrew openjdk@17）。Gradle 不要用 IDE 自带的 JBR 25。

详见 JetBrains 插件文档。

#预估涨幅为 0

养基宝部分基金估算涨幅在 vgszzl 字段而非 gszzl，Fund Helper 已统一解析，详见 养基宝 API §7。

#想完全重来

./reset.sh && ./start.sh
# 或 Docker
docker compose --profile full down -v
docker compose --profile full up -d --build

更多细节见 项目概览 中的常见问题章节。