go-stock 项目研究站 · 下载与部署
go-stock 下载安装：Windows 绿色版、macOS 与源码构建全流程
本项目的分发方式是 GitHub Releases：Windows 提供绿色版 go-stock-windows-amd64.exe，macOS 提供单文件二进制（arm64 / intel / universal 三种架构），Linux 与二次开发走源码构建。官方文档说明前端资源与股票基础数据已通过 //go:embed 编译进二进制，单文件即可运行，不需要自建服务器。
exe / 单文件二进制
chmod +x
xattr -c
开始使用
依据官方 README 与 docs/RUN_MACOS.md、docs/BUILD_LINUX.md 整理的安装流程示意；非官方架构图。
三条安装路线对照
先按操作系统选路线，再看对应步骤。所有产物的官方来源都是项目 GitHub Releases 页面。
| 路线 | 适用系统 | 获取方式 | 前置条件 | 运行方式 |
|---|---|---|---|---|
| Windows 绿色版 | Windows 10 及以上（官方开发环境为 Windows 10） | Releases 下载 go-stock-windows-amd64.exe | 无（免安装）；抓取资讯默认用 Edge | 双击运行 |
| macOS 单文件 | macOS 10.13.0 及以上 | Releases 下载 macOS 单文件（或 .zip 包） | 按芯片选架构；需解除 Gatekeeper 隔离 | 终端 ./go-stock-darwin-arm64 |
| 源码构建 | Linux（Ubuntu 20.04+ / Debian 11+ 等）与其它平台二次开发 | git clone + scripts/build-linux.sh（或 Docker 构建脚本） | Go 1.21+、Node.js 18+、npm 9+、Wails v2.11.0+、GTK/WebKitGTK 开发库 | ./build/bin/linux/go-stock |
| Wails 开发模式 | Windows / macOS / Linux 开发机 | git clone 后执行 wails doctor 检查依赖，再 wails dev 启动开发模式 | 需要完整开发链：Go、Node、Wails 与系统库（GTK/WebKitGTK） | 热重载调试用，不产出可分发的发行版二进制（docs/BUILD_LINUX.md 方法三） |
| Docker 构建 | 任何装了 Docker 的平台（Windows / macOS / Linux） | scripts/docker-build-linux.sh；Windows 下为 .\scripts\docker-build-linux.sh | 需要 Docker；运行容器看界面还要转发 X11（-e DISPLAY + /tmp/.X11-unix） | 用于在非 Linux 机器上产出 Linux 版本（docs/BUILD_LINUX.md 方法二） |
| macOS .app 封装 | macOS 10.13.0 及以上 | 按 docs/RUN_MACOS.md 第八节手动创建 Contents/MacOS、写入 Info.plist、xattr -cr | 需要命令行操作；不是官方发行形态，属可选进阶步骤 | open go-stock.app；封装后工作目录变成系统只读目录，数据库写入会失败，官方建议多数用户直接用裸二进制 |
| Linux 打包分发 | Linux（Ubuntu/Debian 等） | docs/BUILD_LINUX.md「打包分发」提供 AppImage 与 deb 两种步骤 | 需要 appimagetool（AppImage）或 dpkg-deb（deb） | 产物为 go-stock.AppImage / go-stock.deb；deb 依赖 libgtk-3-0、libwebkit2gtk-4.0-37 |
| 移动端（iOS / Android） | — | 官方 Releases 未提供移动端产物 | — | README 与 docs 未提及移动端计划；本项目形态是在电脑上运行的桌面客户端 |
本项目在 Windows 与 macOS 的安装步骤
下面命令来自官方 docs/RUN_MACOS.md；Windows 绿色版无需命令行。
Windows 绿色版
1. 打开官方 Releases 页面，下载 go-stock-windows-amd64.exe；
2. 建议新建一个专属目录（如 D:\go-stock\）并把 exe 放进去，保证数据文件集中；
3. 双击运行，首次启动会创建数据目录并初始化 SQLite；
4. 进入「设置」新增 AI 模型配置后即可使用 AI 功能。
macOS 单文件
1. unzip go-stock-darwin-arm64.zip 解压；
2. chmod +x go-stock-darwin-arm64 赋执行权限；
3. xattr -c go-stock-darwin-arm64 清除隔离属性（否则 Gatekeeper 会拦截）；
4. ./go-stock-darwin-arm64 运行，首次弹窗请求通知权限时选「允许」（价格预警需要）。
~/go-stock/）并每次都从该目录启动，否则换目录会读到另一份 data/，看起来像数据丢失。macOS 三种架构怎么选
下载前先执行 uname -m 确认芯片类型。
| 架构 | 适用芯片 | uname -m 输出 | 对应文件 | 建议 |
|---|---|---|---|---|
| darwin/arm64 | Apple Silicon（M1/M2/M3/M4） | arm64 | go-stock-darwin-arm64 | 官方建议优先选择，原生性能更好 |
| darwin/amd64 | Intel（x86_64） | x86_64 | go-stock-darwin-intel | Apple Silicon 上运行需 Rosetta 2，官方不推荐 |
| darwin/universal | 通用二进制，两种芯片都可跑 | 任意 | go-stock-darwin-universal | 体积约为单架构两倍（官方文档标注约 249 MB） |
| darwin/amd64（转译运行） | Apple Silicon 上运行 Intel 版 | arm64（但实际加载的是 x86_64 二进制） | go-stock-darwin-intel | 需先安装 Rosetta（softwareupdate --install-rosetta）；官方明确「性能下降且不推荐」 |
| 三种架构的两种下载形态 | 全部芯片 | 任意 | 裸文件 go-stock-darwin-* 或压缩包 go-stock-darwin-*.zip | 官方建议下载 .zip：文档标注 arm64 压缩包约 31 MB、裸文件约 120 MB，解压后通常已带执行权限，可省去 chmod +x |
| darwin（全部架构） | macOS 10.13.0 及以上 | 任意 | — | 系统版本下限来自 build/darwin/Info.plist 的 LSMinimumSystemVersion；产物是裸 Mach-O 可执行文件，不是 .app 应用包 |
docs/RUN_MACOS.md 标注裸可执行文件约 120 MB、压缩包约 31 MB；建议下载 .zip 版本，解压后通常已带执行权限。以上体积为文档记录值，随版本更新可能变化，以 Releases 页面实际文件为准。Linux 与源码构建要求
来自官方 docs/BUILD_LINUX.md，适合需要 Linux 原生版本或做二次开发的用户。
| 依赖 | 版本要求 | 安装/说明 |
|---|---|---|
| Go | 1.21 或更高 | 官方建议从 go.dev/dl 安装，或用 gvm 管理版本 |
| Node.js / npm | 18.0+ / 9.0+ | 前端基于 Vue + Vite，构建需要 Node 环境 |
| Wails | v2.11.0 或更高 | go install github.com/wailsapp/wails/v2/cmd/wails@latest |
| 系统依赖 | libgtk-3-dev、libwebkit2gtk-4.0-dev | Ubuntu/Debian 用 apt-get，Fedora 用 dnf，Arch 用 pacman |
| 构建产物 | build/bin/linux/go-stock | 也提供 Docker 构建脚本，可在 Windows/macOS 上产出 Linux 版本 |
| WebKitGTK 运行时 | libwebkit2gtk-4.0-37 | 构建期用 -dev 包，运行期需要运行时库。官方文档说明：Linux 上提示找不到 WebView2 属正常（Linux 用的是 WebKitGTK） |
| 中文字体（可选） | fonts-wqy-zenhei / fonts-wqy-microhei | 界面显示异常时按官方「显示或字体问题」条目安装对应字体包 |
构建与运行命令
git clone 项目仓库 → cd go-stock → chmod +x scripts/build-linux.sh → 运行构建脚本 → 产物落在 build/bin/linux/
运行时文件与数据来源
本项目的定位是「数据全部保留在本地」，运行时文件路径来自官方 docs 记录。
| 路径 | 内容 | 说明 |
|---|---|---|
data/ | 数据目录 | 启动时自动创建，位于启动时的工作目录下 |
data/stock.db | SQLite 数据库（WAL 模式） | 存股票、分组、配置等；另有 -wal / -shm 文件 |
data/dict | 情绪分析分词字典 | 用于资讯/情绪分析的中文分词 |
logs/wails.log | 应用运行日志 | 排错的主要依据，报错与工具调用轨迹都记录在这里 |
memory/.vectorstore/ | 长期记忆向量库 | chromem-go 本地向量库，存放历史问答经验 |
data/stock.db-waldata/stock.db-shm | SQLite WAL 日志与共享内存文件 | 与数据库同目录（docs/RUN_MACOS.md 记录）；备份 data/ 时一并复制，单独拷 stock.db 可能丢掉未合并的写入 |
安装与运行排查表
问题描述与处理方式整理自官方 docs/RUN_MACOS.md、docs/BUILD_LINUX.md 与 README 常见说明。
| 现象 | 原因 | 处理 |
|---|---|---|
| macOS 提示「无法验证开发者」或「已损坏」 | Gatekeeper 拦截未签名二进制（项目仅 Ad-hoc 签名），并非文件损坏 | xattr -c go-stock-darwin-arm64，或到「系统设置 → 隐私与安全性」点「仍要打开」 |
permission denied / command not found | 缺少执行权限，或运行时漏了 ./ 前缀 | chmod +x 后使用 ./文件名 或绝对路径运行 |
| 运行后无窗口 / 闪退 | 架构不匹配（Rosetta 未装）、工作目录不可写、隔离属性未清 | 在终端直接运行看报错；换 arm64/universal 版本；把二进制放到可写目录 |
数据库初始化失败（db connection error） | data 目录无法创建或无写权限 | 确认启动目录可写（mkdir -p data），避免在系统只读目录运行 |
| 切换目录后数据「丢失」 | 数据库与日志绑定启动目录 | 固定从同一目录启动（官方推荐 ~/go-stock/） |
| 提示「程序已经在运行了」但找不到窗口 | 单实例锁生效，旧实例残留在后台 | pkill -f go-stock-darwin 后重新启动 |
| Linux 构建报缺 GTK/WebKit 头文件 | 缺少 libgtk-3-dev 或 libwebkit2gtk-4.0-dev | 按发行版安装对应开发库；界面字体异常时补装中文字体包 |
最新版本、更新通道与下载产物有哪些？
版本与产物按 GitHub Releases 的实际记录整理；更新通道来自官方帮助手册与 README。这一节也是本站「版本化文档」的基准：本页内容核对于 2026-09-22。
| 项目 | 记录 | 注意点 |
|---|---|---|
| 最新稳定版 | v2026.09.09.1-release（2026-09-09 发布） | 版本迭代很快，下载前以 Releases 页面为准 |
| Windows 产物 | go-stock-windows-amd64.exe（约 137.6 MB）、go-stock-windows-arm64.exe（约 128.3 MB） | README 只列了 amd64 绿色版；ARM 设备在 Releases 里同样能找到 arm64 产物 |
| macOS 产物 | darwin arm64（约 127.5 MB）、intel（约 136.6 MB）、universal（约 264.2 MB），另有 .zip 压缩包 | universal 约为单架构两倍体积，与官方文档标注一致 |
| 更新通道 | Release 稳定版 / Pre-release 预发布版 / Dev 开发版（设置 → 基础设置） | 帮助手册建议新用户选 Release |
| 自动更新 | README 记录软件内置自动更新与代理加速下载；vip0（0 元）档说明为「从 GitHub 下载」 | 网络受限时可手动到 Releases 覆盖安装，注意先备份数据目录 |
| 历史版本 | Releases 页面保留历史 tag；README 更新日志里给出过具体版本链接（如 v2025.2.16.1-alpha） | 回退到旧版前先备份 data/；旧版教程与报错口径可能与本文不同，以对应版本的官方说明为准 |
v2026.09.09.1-release），与官方文档标注的 macOS 约 120 MB / 249 MB 属同一量级。升级前建议备份 data/、skills/、memory/ 三个目录——官方文档没有提供跨版本迁移指引。data/ 目录，避免版本回退后数据库结构不兼容。常见问题
本项目支持哪些系统？
官方 README 提供 Windows 绿色版 exe 与 macOS 单文件二进制（arm64 / intel / universal），并给出 Linux 构建文档；README 也说明开发环境主要基于 Windows 10，其他平台可能未完全测试或功能受限，具体以官方仓库为准。
必须装 Python 或数据库吗？
不需要。本项目是编译好的桌面客户端，内置 SQLite 存储，前端资源与基础数据已编译进二进制；Python 相关能力是它可调用的外部 MCP 工具或独立项目时才需要。
为什么 macOS 版本体积这么大？
因为前端资源、图标、基础数据都通过 //go:embed 打进了单文件，官方文档标注裸文件约 120 MB、压缩包约 31 MB；universal 通用二进制约为单架构两倍。
可以不下载二进制、直接用网页版吗？
项目主页提供了官网入口，但主要形态是本地桌面客户端，能力（本地 SQLite、随时抓取的资讯、系统通知预警）依赖本地运行。若只想免部署查数据，可看 EasyClaw 技能路线对比页。
安装完还要做哪些配置？
至少两步：在「设置 → AI 分析配置」里新增一条模型配置（接口地址、API Key、模型名），保存后再打开 AI 助手选择该模型；需要预警推送时再配飞书或钉钉。详见大模型配置页。
出错时先看什么？
先看 logs/wails.log 里的报错行，再看上表的排查项；涉及模型请求失败的，先核对接口地址与 Key 格式（部分套餐接口需专用 Key）。