easy-stock 部署与使用教程

easy-stock 是一款面向个人投资者的 A 股行情分析与 AI 智能投研桌面应用。它聚合了行情、题材、涨停、资讯等多源数据，并通过 AI 能力帮助用户完成盘后复盘、个股分析、持仓巡检等研究工作。本教程将指导你完成从安装到配置使用的全过程。

一、核心功能概览

在开始部署前，了解 easy-stock 的核心能力有助于你理解其价值：

重要提示：本项目仅供学习、研究和信息整理使用，不构成任何投资建议。AI 输出和第三方数据可能存在延迟或错误，请独立判断并自行承担决策风险。

easy-stock 采用分层架构，各层职责清晰：

层级	核心职责
AI投研体验层	行情总览、题材趋势、个股分析、持仓巡检等用户界面
业务编排层	Go API、分析引擎、调度任务与数据源状态管理
AI Agent平台层	Hermes 负责模型调用、会话、记忆、工具路由与模型网关
数据智能层	统一市场模型、题材归因、SQLite 存储与缓存快照
外部生态层	行情数据源、内容平台、大模型服务与浏览器执行能力
桌面运行边界	Electron 生命周期、随机端口、一次性 Token 与本地资源装配

这是最简单的使用方式，无需安装 Node.js、Go 或 Python 等开发环境。

1. 下载安装包

前往 GitHub Releases 页面，根据你的操作系统下载对应的安装包或压缩包：

2. 安装并启动

下载后，双击运行安装程序，按照提示完成安装。首次启动时，应用会进行初始化并准备本地运行环境。

3. 配置大模型服务

首次使用前，你需要配置 AI 服务才能启用智能分析功能。进入 设置 → AI 服务，目前支持配置 OpenAI、DeepSeek、通义千问、Moonshot、Anthropic 以及兼容 OpenAI 协议的自定义服务。

以 DeepSeek 为例：

4. 配置内容平台登录（可选）

如需使用“大V自动复盘”功能自动抓取雪球、淘股吧等平台的文章，需要在设置中配置这些平台的登录状态，以便应用能够访问相关内容。

如果你希望进行二次开发或调试，可以从源码运行。

1. 环境准备

2. 克隆源码

1 2	git clone https://github.com/jundizhou/easy-stock.git cd easy-stock

3. 安装依赖并启动
具体的启动命令和详细配置，请参考项目根目录下的 开发者文档。通常涉及以下步骤：

# 安装前端依赖 (在 frontend 目录下)
cd frontend
npm install

# 安装后端依赖 (在 backend 目录下)
cd ../backend
go mod download

启动后端服务和前端开发服务器后，即可通过浏览器访问应用。

AI 服务是 easy-stock 智能分析功能的核心。配置好 API Key 后，以下功能将可用：

easy-stock 支持通过 Skills 扩展能力。你可以在应用内浏览、安装和启用 Skills。具体的添加与启用方法，可参考项目文档中的 Skill 添加与启用说明。