mirror of
https://github.com/ZhuLinsen/daily_stock_analysis
synced 2026-09-20 10:53:33 +08:00
docs: add beginner client setup guide (#1333)
This commit is contained in:
mumu
@@ -22,6 +22,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
|
||||
- [新功能] 新增 Finnhub / AlphaVantage 美股数据源适配器，扩展美股日线 failover 链至 Finnhub(P2) -> AlphaVantage(P3) -> Yfinance(P4) -> Longbridge(P5)。
|
||||
- [修复] AlphaVantage 适配器在 newest-first 原始数据下 pct_chg 计算错误：改为先按日期升序排序再计算涨跌幅。
|
||||
- [修复] 美股日线路由未包含 Finnhub / AlphaVantage：扩展 `get_daily_data()` 美股分支的 source_order 以覆盖新增数据源。
|
||||
- [文档] 新增小白客户端安装与配置指南，说明桌面客户端下载、基础模型配置、新闻源配置和常见问题。
|
||||
|
||||
## [3.17.1] - 2026-05-16
|
||||
|
||||
|
||||
@@ -7,7 +7,7 @@
|
||||
| 我想要 | 先看 | 继续看 |
|
||||
| --- | --- | --- |
|
||||
| 快速了解项目能做什么 | [README](../README.md) | [完整配置与部署指南](full-guide.md) |
|
||||
| 第一次把项目跑起来 | [README](../README.md) | [完整配置与部署指南](full-guide.md) |
|
||||
| 第一次把项目跑起来 | [小白客户端安装与配置](beginner-client-setup.md) | [完整配置与部署指南](full-guide.md) |
|
||||
| 配置大模型渠道 | [LLM 配置指南](LLM_CONFIG_GUIDE.md) | [LLM 服务商配置指南](llm-providers.md) |
|
||||
| 配置推送通知 | [通知能力基线](notifications.md) | [完整配置与部署指南](full-guide.md) |
|
||||
| 部署到服务器或云平台 | [部署指南](DEPLOY.md) | [云端 WebUI 部署](deploy-webui-cloud.md)、[Zeabur 部署](docker/zeabur-deployment.md) |
|
||||
@@ -20,6 +20,7 @@
|
||||
| 文档 | 内容 |
|
||||
| --- | --- |
|
||||
| [README](../README.md) | 项目定位、核心能力、快速开始、推送效果 |
|
||||
| [小白客户端安装与配置](beginner-client-setup.md) | 面向不会代码用户的客户端下载、Anspire Open / AIHubMix 模型配置、新闻源配置和常见问题 |
|
||||
| [完整配置与部署指南](full-guide.md) | 环境准备、运行方式、配置说明、部署路径和常见问题 |
|
||||
| [FAQ](FAQ.md) | 常见配置、模型、通知、部署和运行问题 |
|
||||
| [更新日志](CHANGELOG.md) | 版本变化、能力调整和迁移说明 |
|
||||
|
||||
129
docs/beginner-client-setup.md
Normal file
129
docs/beginner-client-setup.md
Normal file
@@ -0,0 +1,129 @@
|
||||
# 小白客户端安装与配置指南
|
||||
|
||||
这份文档写给不会代码、只想下载客户端直接用的用户。目标很简单：下载客户端，填一个模型服务密钥（Key），填股票代码，然后生成第一份分析报告。
|
||||
|
||||
> 本项目生成的是辅助分析报告，不构成投资建议。真实交易请自行判断风险。
|
||||
|
||||
## 先准备
|
||||
|
||||
1. Windows 或 macOS 电脑。
|
||||
2. 一个模型服务密钥（Key），推荐从下面任选一个：
|
||||
- [Anspire Open](https://open.anspire.cn/?share_code=QFBC0FYC)：支持全球主流模型，一个 Key 可同时用于模型和新闻搜索，第一次配置最省事。
|
||||
- [AIHubMix](https://aihubmix.com/?aff=CfMq)：支持全球主流模型，适合想在一个平台切换多种模型的用户。
|
||||
3. 想分析的股票代码，例如 `600519,hk00700,AAPL`。
|
||||
|
||||
## 1. 下载客户端
|
||||
|
||||
打开发布页：
|
||||
|
||||
<https://github.com/ZhuLinsen/daily_stock_analysis/releases/latest>
|
||||
|
||||
在页面下方 `Assets`（附件）里下载：
|
||||
|
||||
| 电脑 | 下载哪个 |
|
||||
| --- | --- |
|
||||
| Windows | `daily-stock-analysis-windows-installer-<版本号>.exe` |
|
||||
| Windows 不想安装 | `daily-stock-analysis-windows-noinstall-<版本号>.zip` |
|
||||
| macOS Apple 芯片 | `daily-stock-analysis-macos-arm64-<版本号>.dmg` |
|
||||
| macOS Intel 芯片 | `daily-stock-analysis-macos-x64-<版本号>.dmg` |
|
||||
|
||||
不用下载 `latest.yml`、`*.blockmap`，它们不是客户端安装包。
|
||||
|
||||
不知道 Mac 是哪种芯片：点击左上角苹果图标 -> 关于本机，看到 M1/M2/M3/M4 就选 `arm64`，看到 Intel 就选 `x64`。
|
||||
|
||||
## 2. 安装并打开
|
||||
|
||||
- Windows 安装包：双击 `.exe`，按提示安装，安装目录用默认位置即可。
|
||||
- Windows 免安装包：解压 `.zip`，双击 `Daily Stock Analysis.exe`。
|
||||
- macOS：双击 `.dmg`，把应用拖到 `Applications`。如果提示来自未验证开发者，在系统设置的隐私与安全性里允许打开。
|
||||
|
||||
macOS 用户升级前建议先在客户端设置里导出一次配置备份。
|
||||
|
||||
## 3. 配置 AI 模型
|
||||
|
||||
打开客户端，进入：
|
||||
|
||||
`系统设置 -> AI 模型`
|
||||
|
||||
只选下面一个方案即可。
|
||||
|
||||
> 重要：每次改完设置后，都要点击页面上的保存按钮；看到保存成功提示后，再切换页面或回到首页。
|
||||
|
||||
### 方案 A：Anspire Open
|
||||
|
||||
1. 打开 [Anspire Open](https://open.anspire.cn/?share_code=QFBC0FYC)，注册 / 登录后创建 API Key。
|
||||
2. 回到客户端，在快速添加渠道里选择 `Anspire Open`。
|
||||
3. 粘贴 API Key。
|
||||
4. 模型名选择控制台里已开通的模型；不确定就先选控制台推荐或轻量模型。
|
||||
5. 点击保存；看到保存成功后，再点击测试连接。
|
||||
|
||||
### 方案 B：AIHubMix
|
||||
|
||||
1. 打开 [AIHubMix](https://aihubmix.com/?aff=CfMq)，注册 / 登录后创建 API Key。
|
||||
2. 回到客户端，在快速添加渠道里选择 `AIHubmix（聚合平台）`。
|
||||
3. 粘贴 API Key。
|
||||
4. 模型名选择控制台里已开通的模型；不确定就先选控制台推荐模型。
|
||||
5. 点击保存；看到保存成功后，再点击测试连接。
|
||||
|
||||
看到测试成功，就继续下一步。
|
||||
|
||||
## 4. 填写自选股
|
||||
|
||||
进入：
|
||||
|
||||
`系统设置 -> 基础设置`
|
||||
|
||||
找到 `自选股列表`，填写：
|
||||
|
||||
`600519,hk00700,AAPL`
|
||||
|
||||
多个股票用英文逗号隔开。常见写法：
|
||||
|
||||
- A 股：`600519`、`300750`、`000001`
|
||||
- 港股：`hk00700`、`hk09988`
|
||||
- 美股：`AAPL`、`TSLA`、`NVDA`
|
||||
|
||||
填完点击保存，看到保存成功后再回首页。
|
||||
|
||||
## 5. 建议配置新闻源
|
||||
|
||||
新闻源不是必填，但建议配置。它会影响近期新闻、公告、事件驱动、热点题材和风险提示。
|
||||
|
||||
进入：
|
||||
|
||||
`系统设置 -> 数据源`
|
||||
|
||||
按你的模型服务选择：
|
||||
|
||||
1. 用 Anspire Open：找到 `Anspire API Keys`，填入同一个 Anspire Key，保存成功后即可。
|
||||
2. 用 AIHubMix：建议再申请 [SerpAPI](https://serpapi.com/baidu-search-api?utm_source=github_daily_stock_analysis) 或 [Tavily](https://tavily.com/) 的 Key，填到 `SerpAPI API Keys` 或 `Tavily API Keys`，保存成功后即可。
|
||||
|
||||
想先试用也可以跳过新闻源，客户端仍然能生成基础分析。
|
||||
|
||||
## 6. 开始分析
|
||||
|
||||
回到首页：
|
||||
|
||||
1. 输入股票代码，例如 `600519`。
|
||||
2. 点击分析。
|
||||
3. 等任务从排队、分析中变成分析完成。
|
||||
4. 在历史记录里查看报告。
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 下载页面里文件很多，该下哪个？
|
||||
|
||||
普通 Windows 用户下载 `.exe` 安装包。不要下载 `latest.yml` 或 `*.blockmap`。
|
||||
|
||||
### API Key 填了还是不能用？
|
||||
|
||||
检查这几项：
|
||||
|
||||
1. Key 是否复制完整，没有多余空格。
|
||||
2. 平台账号是否有余额或额度。
|
||||
3. 当前模型是否已开通。
|
||||
4. 测试连接里是否提示模型不存在、权限不足或余额不足。
|
||||
|
||||
### 配置乱了怎么办？
|
||||
|
||||
在客户端设置里导出配置备份。出问题时可以导入之前的备份，或者只保留这三项重新配置：AI 模型、自选股、新闻源。
|
||||
Reference in New Issue
Block a user