a-share-pro

# A-Share Pro - A 股投资监控终极版 ## 🎯 核心特性 | 特性 | 说明 | |------|------| | ✅ **轻量级** | 纯文本存储，无需数据库 | | ✅ **多数据源** | 腾讯/雪球/百度/Tushare 自动切换 | | ✅ **持久化** | 自选股/交易记录本地保存 | | ✅ **易维护** | 统一配置 + 模块化脚本 | | ✅ **无 Token 依赖** | 主要使用免费数据源 | --- ## 🚀 快速开始 ### 1️⃣ 安装 ```bash cd ~/.openclaw/workspace/skills/a-share-pro/scripts chmod +x install.sh ./install.sh ``` 会自动完成： - ✅ 创建 `~/.openclaw/a_share/` 数据目录 - ✅ 安装 Python 依赖（requests, beautifulsoup4） - ✅ 测试基本功能 --- ### 2️⃣ 添加股票 ```bash # 方式一：只输入代码（名称默认"未知"） python3 add_stock.py 600919 # 方式二：指定股票名称 python3 add_stock.py 600919 江苏银行 ``` --- ### 3️⃣ 查看自选股列表 ```bash python3 list_stocks.py ``` 输出示例： ``` 📋 你的自选股: ================================================== 序号 代码 名称 -------------------------------------------------- 1 600919 江苏银行 2 600926 杭州银行 3 159681 创业板 ETF ================================================== 共计 3 只股票 ``` --- ### 4️⃣ 获取行情汇总 ```bash python3 summarize_performance.py ``` 输出示例： ``` ====================================================================== 💼 A-Share Pro - 自选股实时行情 ====================================================================== ✅ 600919 - 江苏银行 💰 ¥10.59 +0.10 (+0.95% ) [🐧 腾讯财经] ✅ 600926 - 杭州银行 💰 ¥16.57 +0.08 (+0.49% ) [🐧 腾讯财经] ... ====================================================================== 📊 持仓概览：3 只 | 上涨:3 只 | 下跌:0 只 📉 平均涨跌幅：+1.46% 💡 整体趋势：📈 整体偏强 ====================================================================== ``` --- ## 📁 文件结构 ``` a-share-pro/ ├── SKILL.md # 主文档 ├── README.md # 使用说明 └── scripts/ ├── config.py # ⭐ 统一配置 ├── monitor.py # ⭐ 核心监控模块 │ ├── add_stock.py # 添加股票 ├── remove_stock.py # 删除股票 ├── list_stocks.py # 查看列表 ├── clear_watchlist.py # 清空列表 ├── summarize_performance.py# ⭐ 行情汇总 │ └── install.sh / uninstall.sh ``` --- ## 🔧 高级用法 ### 从命令行导入多个股票 ```bash # 批量添加 for code in 600919 600926 600025; do python3 add_stock.py $code done ``` ### 每日定时检查 ```bash # 添加到 crontab（每天收盘后 15:30） # crontab -e 30 15 * * * cd ~/.openclaw/workspace/skills/a-share-pro/scripts && python3 summarize_performance.py ``` ### 导出数据到 Excel ```python # 自定义脚本导出 import pandas as pd stocks = ['600919', '600926'] data = [] for code in stocks: from monitor import AShareMonitor monitor = AShareMonitor() quote = monitor.get_quote(code) data.append(quote) df = pd.DataFrame(data) df.to_excel('持仓报告.xlsx', index=False) ``` --- ## 📊 数据存储格式 ### watchlist.txt（自选股列表） ``` 600919|江苏银行 600926|杭州银行 159681|创业板 ETF ``` 每行格式：`代码 | 名称` --- ### transactions.txt（交易记录） ``` 2026-03-05|600919|buy|7.80|5000|备注 2026-03-01|600926|sell|8.50|1000|部分止盈 ``` 每行格式：`日期 | 代码 | 买卖 | 价格 | 数量 | 备注` --- ## 🎨 数据源优先级 系统会自动按以下顺序尝试获取数据： 1. 🐧 **腾讯财经** - 最快最稳定（首选） 2. 📱 **雪球** - 有市值/市盈率信息 3. 🔍 **百度股市通** - JSON 格式易解析 4. 📈 **Tushare** - 需要积分（备选） --- ## ❓ 常见问题 ### Q1: 如何修改配置文件？ 编辑 `scripts/config.py`： ```python WATCHLIST_FILE = "~/.openclaw/a_share/watchlist.txt" DATA_SOURCES_PRIORITY = ["tencent", "xueqiu"] # 只用腾讯和雪球 REQUEST_DELAY = 0.5 # 请求间隔改为 0.5 秒 ``` ### Q2: 如何重置自选股？ 直接编辑数据文件： ```bash nano ~/.openclaw/a_share/watchlist.txt # 手动添加/删除股票，或使用 clear_watchlist.py 清空 ``` ### Q3: 能否查询港股/美股？ 目前仅支持 A 股（沪市/深市/科创板）。如需港股/美股，建议增加 Yahoo Finance 或新浪财经接口。 --- ## 🔮 未来扩展方向 - [ ] 技术指标计算（MA/MACD/KDJ） - [ ] K 线图表绘制 - [ ] 智能提醒（突破价位推送） - [ ] 持仓盈亏计算（需要成本价） - [ ] 新闻资讯聚合 - [ ] Web 可视化界面（Streamlit） --- <div align="center"> <strong>A-Share Pro ✨</strong><br> 让 AI 成为你的得力投资助手 📈🤖 </div>