Windows 缺少 WebView2 运行库
Windows 版基于 Wails 构建，界面依赖微软 WebView2 运行时（Win10/11 通常已内置）。官方 README 与 docs 未记载该依赖；若启动时提示缺少运行库，可从微软官方渠道安装 Evergreen Runtime。这条属通用环境说明，不是官方文档内容。
go-stock 项目研究站 · 报错与排查
go-stock 常见报错排查：数据不刷新、AI 不响应、预警收不到
这个客户端的故障大多不是崩溃，而是「某个功能静默不工作」：菜单不显示、数据停在旧值、图片按钮是灰的、预警不推送。原因通常是开关没开、Key 没填、不在交易时段，或者权限不够。本页把所有已知现象按「现象 → 原因 → 处理 → 出处」列成表，并在最后给出官方文档没写到的环境类坑。
看现象
数据/界面/AI/推送
数据/界面/AI/推送
查开关
总开关与菜单项
总开关与菜单项
看日志
logs/wails.log
logs/wails.log
核对时段与来源
再决定是否提交 issue
再决定是否提交 issue
依据官方帮助手册「常见问题与故障排除」章节整理的自查顺序示意；不是官方故障流程图。
Data & UI
go-stock 数据与界面类问题怎么排查？
下面这些现象来自官方帮助手册的常见问题章节与安装文档，按「先排除时段、再排除开关、最后看日志」的顺序处理最省时间。
| 现象 | 常见原因 | 处理步骤 | 出处 |
|---|---|---|---|
| 行情数据不更新 | 不在交易时段；网络异常；基础信息未初始化 | ① 确认当前是否交易时间（休市期间部分数据不刷新）；② 检查网络；③ 重启软件；④ 在设置中启用「启动时更新基础信息」 | 帮助手册 §十一 |
| K 线数据为空 / 图表一直加载 | 代码写法不对；非交易时段；抓取用的浏览器不可用 | ① 港美股代码要带后缀（00700.HK、AAPL.US）；② 换交易时段再看；③ 设置里检查「浏览器安装路径」（留空默认用 Edge）；④ 查看 logs/wails.log 的报错行 | 帮助手册 §四/§十 |
| 自选股列表空了 | 换了启动目录，数据目录随之改变 | 固定从同一目录启动（官方推荐把程序放在固定目录）；本机数据库是 data/stock.db | 帮助手册 §二 |
| 基金自选 / AI 智能体菜单不显示 | 这两个菜单需要在后台配置中启用后才会出现 | 在后台配置中启用对应功能，再重启软件；AI 智能体还要求「AI 诊股总开关」已开且模型已配置 | 帮助手册 §六/§七/§十一 |
| 多周期 K 线点了没反应或提示权限不足 | 该功能需要 VIP2；美股 gb_ 前缀不支持 | 到「关于」页确认当前赞助等级，在设置里输入赞助码升级；确认标的是不是美股 | 帮助手册 §四/§十一 |
| 浮动 AI 助手用不了 | 浮动助手需要 VIP2 及以上 | 确认赞助等级；该助手的对话历史保存在本地，升级后可直接使用 | 帮助手册 §八/§十一 |
| 数据库初始化失败 | data 目录不可写或启动目录只读 | 把程序放到可写目录（例如用户目录下的固定文件夹）后重新启动；必要时手动创建 data/ 目录 | 安装页排错表（依据 docs/RUN_MACOS.md、docs/BUILD_LINUX.md） |
| macOS 提示「已损坏」或无法打开 | Gatekeeper 拦截未签名二进制，不是文件损坏 | 执行 xattr -c 文件名 清除隔离属性，或在「系统设置 → 隐私与安全性」点「仍要打开」 | docs/RUN_MACOS.md |
先做这一步：任何「没有数据」的问题，先确认两件事——当前是不是交易时段、这个功能是不是需要额外凭证（见下一页自检清单）。顺序错了会在错误的方向查很久。
AI & alerts
go-stock AI 与推送类问题怎么排查？
AI 相关故障的绝大多数原因是「开关没开」或「模型不支持该能力」，而不是模型本身出问题。
| 现象 | 常见原因 | 处理步骤 | 出处 |
|---|---|---|---|
| AI 分析不工作 / 没有返回 | 总开关未开、API Key 未填、网络或代理问题 | ① 检查设置中「AI 诊股总开关」；② 检查 AI 模型配置里的接口地址与 API Key；③ 检查网络；④ 用代理时确认代理配置正确 | 帮助手册 §十一 |
| 分析过程中提示超时 | 单次运行预算与 timeout 配置不匹配 | README 记录 Agent 已取消固定运行时间上限、改为按问题复杂度估算预算；超时提示会引导调整 timeOut 配置（设置里 Timeout 最小 60 秒） | README 更新日志（2026.08.25） |
| 长时间对话后回答变短、像忘了前文 | 触发了对话摘要中间件（官方阈值 120k token / 80 消息） | 属设计行为：超阈值自动摘要历史，原始对话转存 logs/agent_transcript.md；需要完整上下文时新开对话并附关键数据 | 帮助手册 §七 |
| 截图问股按钮是灰的 | 该模型配置未打开「视觉理解」 | 在 AI 模型服务配置里编辑该条配置，打开「视觉理解」开关并绑定支持视觉的模型（GLM-4V、Qwen-VL、GPT-4o、Claude、Gemini 等） | docs/AI对话与视觉理解功能说明.md |
| 发图片后回复「图片已被忽略」 | 当前模型是纯文本模型（官方举例 deepseek-chat） | 切换到已开启视觉理解的多模态配置；图片格式限 JPEG/PNG/GIF/WebP，单张 ≤ 8MB、最多 10 张 | docs/AI对话与视觉理解功能说明.md |
| 收不到价格预警 | 通知开关未开、Webhook 未填、不在交易时段 | ① 成本设置里填了涨跌提醒或股价提醒；② 设置里开启「本地推送」或配置钉钉推送；③ 确认软件在交易时段运行 | 帮助手册 §十一 |
| AI 推荐股票预警不推送 | 该条记录的预警开关未开、数据库缺字段、渠道未配 | ① 在「股票推荐记录」里打开该条的预警开关；② 确认数据库已含 enable_alert 字段；③ 开启钉钉推送并填写机器人 Webhook；④ 授予系统通知权限 | docs/预警功能说明.md |
| MCP 工具没被调用 | 服务器未启用 / 未测试连接；提问里没有触发信号 | ① 在 MCP 服务页点「测试连接」同步工具清单并确认「启用」已开；② 提问中带上服务器名或工具关键词（官方列出的信号词含 mcp、工具、调用、发送、通知、消息、服务器、webhook、api、钉钉、飞书等）；③ DeepAgents 模式下需模型先执行 tool_search | docs/MCP_GUIDE.md |
| 导入的技能不生效 | SKILL.md 缺失或 frontmatter 写错；AI 自动选用仅 DeepAgents 模式支持 | ① 确认技能目录下有 SKILL.md；② frontmatter 只写 name、description 且值为字符串；③ 用 / 手动唤起（斜杠指令在所有 Agent 模式可用） | docs/SKILL_GUIDE.md |
| 提示词广场 / 问答广场打不开 | 广场地址配置错误，或社区服务端不可用 | 检查设置里的「提示词广场地址」（官方默认 http://go-stock.sparkmemory.top:1918/api）；该地址指向项目社区服务，可用性不由本机决定 | 帮助手册 §十一 |
一条通用规则：凡是「某个能力没反应」，先确认它需要什么凭证或权限——问财类功能要问财 API 密钥、业绩点评要东财 AI 密钥、部分东财数据要
qgqp_b_id、知识库要一个支持 embedding 的模型。凭证缺失时的表现通常是静默不可用，而不是弹窗报错。Self-check
go-stock 设置项自检清单（10 项）
出问题时按这张表从上往下过一遍，能覆盖绝大多数「功能静默不工作」的情况。位置与状态均来自官方帮助手册与快速开始指南。
| 检查项 | 位置 | 正确状态 / 建议值 | 影响的功能 |
|---|---|---|---|
| AI 诊股总开关 | 设置 → AI 设置 | 已开启（开启后才会展开全部 AI 配置） | 所有 AI 分析与智能体 |
| AI 模型配置 | 设置 → AI 分析配置 → 前往管理 | 至少一条：接口地址 + 令牌 ApiKey + 模型名称 + Timeout ≥ 60 秒 | AI 分析、AI 智能体、浮动助手 |
| 视觉理解开关 | AI 模型配置 → 编辑该条配置 | 需要图片分析时打开，并绑定多模态模型 | 截图问股、K 线图分析 |
| AI 智能体菜单 | 后台配置 | 已启用（默认不显示） | AI 智能体页面 |
| AI 智能体功能开关 | 设置 | 默认关闭（README 记录因使用体验）按需开启 | 智能体相关入口 |
| 基金自选菜单 | 后台配置 | 已启用（默认不显示） | 基金自选页面 |
| 通知设置 | 设置 → 通知设置 | 本地推送或钉钉推送已开启；钉钉需填 Webhook 并点「发送测试通知」验证 | 价格预警、计划预警 |
| 数据刷新间隔 | 设置 → 基础设置 | 默认 1 秒；不建议改得比数据源更新节奏更小 | 行情与列表刷新频率 |
| 启动时更新基础信息 | 设置 → 基础设置 | 开启（首次使用建议开启） | 股票基础数据完整性 |
| 浏览器安装路径 | 设置 → 基础设置 | 留空则使用 Edge；指定 Chrome/Edge 路径可解决抓取异常 | 新闻资讯抓取 |
需要自备凭证的清单（官方文档记录）：问财 API 密钥 → 问财选股/行情查询/研报搜索；东财 AI 密钥 → 个股业绩点评；东财唯一标识
qgqp_b_id（浏览器 F12 从 Cookie 取）→ 部分东财数据；飞书 App ID/Secret → 飞书通知；钉钉机器人 Webhook → 钉钉通知；一个支持 embedding 的模型 → 知识库与长期记忆。Logs
go-stock 日志在哪、求助时给什么信息？
官方把主要排错依据放在运行目录的日志文件里；提交 issue 时附上日志片段比描述「用不了」有效得多。
| 文件 / 入口 | 内容 | 看什么 |
|---|---|---|
logs/wails.log | 应用运行日志 | 报错行、工具调用轨迹、启动阶段失败原因 |
logs/agent_transcript.md | 触发摘要后的原始对话转存 | 长对话中上下文丢失前后的完整内容 |
info.log | 应用信息日志 | 视觉相关排查可搜 vision: 下发 N 张图片 |
| 前端错误上报 | 页面错误自动发送给后端（window.onerror 机制） | 界面异常时可在日志里找到对应的前端报错 |
memory/.vectorstore/ | 长期记忆与知识库的本地向量库（chromem-go） | 知识库问答或长期记忆检索异常时，确认该目录与对应 collection 是否存在；官方记录的清理方式是删掉对应 collection 数据后重启 |
| GitHub Issues / 项目社区 / QQ 交流群 | 官方 README 记录的反馈渠道 | 反馈时附版本号、更新通道、复现步骤与日志片段；本站是第三方项目研究站，不提供该项目的技术支持 |
版本与通道
「关于」页的版本号与当前更新通道（Release / Pre-release / Dev）。同一问题在不同通道表现可能不同。
复现步骤
从哪一步开始不行：点的是哪个菜单、输入了什么代码或问题、当时是否交易时段。
日志片段
贴
logs/wails.log里同一时间段的报错行，而不是整份日志。环境信息
操作系统与版本、数据源相关凭证是否已配置（不必贴出 Key 本身）、用的是哪个模型与平台。
官方反馈渠道（README 记录）：GitHub Issues、项目社区、QQ 交流群；一对一技术支持需要赞助（README 列出单次与长期支持的价格）。本站是第三方项目研究站，不提供该项目的技术支持。
Gaps
go-stock 官方文档没写、但实际会撞到的四个坑
以下四条不在官方 README/docs 的排错清单里，属于环境与使用习惯层面的经验；每条都写清了判断依据，方便你自己验证。
换个目录启动，数据像「丢了」
数据库与日志路径相对启动目录：官方文档记录数据库是运行目录下的 data/stock.db。从桌面双击、从终端启动、或换了文件夹，读到的可能不是同一份 data/。固定目录是唯一的解法。
升级前没有迁移说明
官方文档没有给出「跨版本升级」的数据迁移指引（软件内置的是自动更新能力）。稳妥做法：升级前手动备份 data/、skills/、memory/ 三个目录，出问题可直接回退。
版本口径不一致，教程容易对不上
项目文档自身存在版本差：帮助手册自注「最后更新于 2026.05」，其中记录 AI 数据工具 80+、Agent 3 种模式；README（2026.08）已写 150+ 工具与 DeepAgents 模式。看到数字不一致时，以更新的 README 与软件内实际界面为准。
FAQ
常见问题
go-stock 打不开、双击没反应怎么办？
先分清是「没有窗口」还是「启动即退出」：到程序目录用终端/命令行直接运行同目录的二进制，报错会打印在控制台；再看 logs/wails.log。常见原因是 data 目录不可写、架构不匹配（macOS 选错 arm64/intel）、隔离属性未清除。官方排错步骤见 docs/RUN_MACOS.md 与 docs/BUILD_LINUX.md。
升级或换电脑后，自选股和配置会丢吗？
数据都在这台机器的运行目录里（data/stock.db 与配置库），随目录走、不随账号同步。官方文档没有提供云端同步或一键迁移说明，因此换机或升级前请手动备份 data/、skills/、memory/ 目录。
有网络，但某些数据一直取不到，是 bug 吗？
很多情况是「缺少凭证」而不是网络问题：问财相关功能要问财 API 密钥、个股业绩点评要东财 AI 密钥、部分东财数据要 qgqp_b_id；另外部分刷新只在交易时段执行。按本页自检清单逐项确认，比反复重启有效。
AI 回答里的价格和我看到的不一样，要怀疑软件出错吗？
先核对时间戳与代码写法：分时每 10 秒刷新、指数每 3 秒刷新，AI 取数时刻与你看界面的时刻不同；港美股代码需带 .HK/.US 后缀。若仍不同，用对话里的工具调用信息回溯调用的工具与参数，再与「数据来源与口径」页的核对清单逐条排查。
日志文件里有 Key 或隐私吗？截图发出去安全吗？
日志可能包含接口地址、工具调用参数与错误堆栈，建议先自己过一遍再发；涉及凭证的地方请打码。公开反馈时不要贴完整的 API Key、Webhook 地址与账户信息。
我怎么知道某个功能是 VIP 才有的？
官方文档明确标注需要 VIP2 的有：多周期 K 线、浮动 AI 助手、交易日志的 K 线叠加（该模块本身是 Beta）。技能广场里的 VIP 专属技能另需开通 VIP 才能下载。其余功能按 README 的赞助说明为 vip0（0 元）档全部功能。