go-stock 项目研究站 · 下载与部署

go-stock 下载安装：Windows 绿色版、macOS 与源码构建全流程

本项目的分发方式是 GitHub Releases：Windows 提供绿色版 go-stock-windows-amd64.exe，macOS 提供单文件二进制（arm64 / intel / universal 三种架构），Linux 与二次开发走源码构建。官方文档说明前端资源与股票基础数据已通过 //go:embed 编译进二进制，单文件即可运行，不需要自建服务器。

前往官方 Releases 下载先看模型配置

分发：GitHub Releases免服务器：数据存本机 SQLite依据 README 与 docs（2026-09 核验）

下载产物
exe / 单文件二进制

解压赋权
chmod +x

清隔离标记
xattr -c

配模型 Key
开始使用

依据官方 README 与 docs/RUN_MACOS.md、docs/BUILD_LINUX.md 整理的安装流程示意；非官方架构图。

Routes

三条安装路线对照

先按操作系统选路线，再看对应步骤。所有产物的官方来源都是项目 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`

前往官方 Releases 下载

Steps

本项目在 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

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）

体积参考：官方 docs/RUN_MACOS.md 标注裸可执行文件约 120 MB、压缩包约 31 MB；建议下载 .zip 版本，解压后通常已带执行权限。以上体积为文档记录值，随版本更新可能变化，以 Releases 页面实际文件为准。

Build

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 版本

构建与运行命令

git clone 项目仓库 → cd go-stock → chmod +x scripts/build-linux.sh → 运行构建脚本 → 产物落在 build/bin/linux/

下一步：配置大模型

Local data

运行时文件与数据来源

本项目的定位是「数据全部保留在本地」，运行时文件路径来自官方 docs 记录。

路径	内容	说明
`data/`	数据目录	启动时自动创建，位于启动时的工作目录下
`data/stock.db`	SQLite 数据库（WAL 模式）	存股票、分组、配置等；另有 -wal / -shm 文件
`data/dict`	情绪分析分词字典	用于资讯/情绪分析的中文分词
`logs/wails.log`	应用运行日志	排错的主要依据，报错与工具调用轨迹都记录在这里
`memory/.vectorstore/`	长期记忆向量库	chromem-go 本地向量库，存放历史问答经验

数据来源与授权：项目文档记录了多个公开数据源的使用，例如财联社电报与财经日历、Tushare、东方财富（含韩国市场分时，另有 Naver 分钟线兜底）、以及用于部分行情与资金数据的通达信协议。涉及 Tushare 等需要账号/积分的数据源时，请按各平台条款自行配置；具体接口与授权范围以官方 docs 为准。

Troubleshooting

安装与运行排查表

问题描述与处理方式整理自官方 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`	按发行版安装对应开发库；界面字体异常时补装中文字体包

装好后：看 AI 智能体用法对比 EasyClaw 技能路线

FAQ

常见问题

本项目支持哪些系统？

官方 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）。