📈 给普通股民也能上手的 A 股辅助决策工具：帮你每天找股票、看持仓、做回测、生成交易计划。
🙌 不要求你会编程，不要求你懂量化，只要跟着步骤操作，就能快速用起来。

如果你属于下面任意一种，这个工具就适合你：

• 👀 平时手动看盘、选股，但觉得太花时间
• 🧠 想减少“凭感觉买卖”，希望有一套明确规则
• 📊 想知道一个策略过去表现如何，但不会写量化代码
• 🗂️ 想每天快速得到“今日可关注股票”和“持仓复核建议”
• 🪜 想要一个能逐步进阶的工具：先命令行用，再慢慢用图形界面

这个工具现在已经可以帮你完成：

• ✅ 自动选股：从 A 股市场中筛出符合规则的候选股
• ✅ 每日交易计划：自动生成“今天重点看什么、当前持仓怎么复核”
• ✅ 历史回测：看看策略过去一段时间收益、回撤、胜率如何
• ✅ 持仓管理：保存你当前持仓，方便每天复核
• ✅ 结果导出：把候选股、交易记录、净值曲线导出成 CSV
• ✅ 可视化查看：通过 Web UI 查看回测结果和指标

一句话理解：

🛠️ 它不是替你自动下单，而是把你每天手工做的“翻股票、记持仓、做复盘”流程尽量自动化。

因为你不需要先学编程，只需要先会这 3 个命令：

ashare-strategy screen
ashare-strategy plan --output-dir daily_plan
ashare-strategy backtest --mode rolling --export-report-dir reports

它们分别对应：

• screen：🔎 今天有哪些股票符合规则
• plan：📝 今天该重点看什么、持仓要不要复核
• backtest：📉 这套方法过去效果如何

git clone git@github.com:lbbit/ashare-strategy-tool.git
cd ashare-strategy-tool
python -m venv .venv
source .venv/bin/activate
pip install -e .[dev]

如果你是普通用户，不想看源码，也可以直接去 Release 页面下载 Windows 打包版本：

• 📦 下载发布版本

如果你使用的是源码安装版：

ashare-strategy screen

如果你使用的是 Windows 打包版：

.\ashare-strategy.exe screen

ashare-strategy plan --output-dir daily_plan

运行后会生成：

• summary.csv：📋 今天计划摘要
• buy_candidates.csv：🛒 今日可关注买入候选
• hold_positions.csv：💼 当前持仓
• sell_review.csv：🚨 今日待复核卖出清单

如果你想先看看策略历史效果，再运行：

ashare-strategy backtest --mode rolling --export-report-dir reports

如果你是第一次用，建议按下面顺序：

1. screen：先看候选股输出长什么样
2. save-sample-positions：生成一个示例持仓
3. positions：看持仓格式
4. plan：生成每日计划
5. backtest：看历史效果
6. ui：打开图形界面

• 板块筛选
• 个股筛选
• 买卖规则模拟
• 持仓持久化
• 逐日滚动回测
• 年化收益 / 回撤 / 夏普 / 胜率 / 盈亏比
• 报告导出
• 每日交易计划导出
• Windows 自动打包发布

ashare-strategy screen
ashare-strategy plan --output-dir daily_plan
ashare-strategy positions
ashare-strategy save-sample-positions
ashare-strategy backtest --mode rolling --export-report-dir reports
ashare-strategy ui

• 当前不直接连接券商自动下单
• 当前更适合“辅助决策 + 模拟复盘 + 持仓管理”
• akshare 免费源在真实网络环境下可能不稳定，不建议再把它当成唯一主链路
• 当前更推荐把 tinyshare 作为稳定模式来运行：优先使用日线、指数和交易日历能力，牺牲一部分“全市场板块扫描”，换取更高可用性

• 👶 新手详细使用说明
• 🗺️ 开发计划
• 📌 功能状态
• 🤖 AI 开发说明
• 📝 Release 说明
• 🛰️ 数据源调研与适配计划

• GitHub Release 页面提供源码包和 Windows 打包版
• Windows 打包版已内置默认配置文件，解压后可直接运行 ashare-strategy.exe screen
• Tag 发布后会自动触发 Windows x86_64 打包上传
• 如果自动上传失败，可手动补传 zip 附件

• 只想看信号：用 screen
• 想做日常复盘：用 plan
• 想验证策略过去是否有效：用 backtest
• 不想总看命令行：用 ui

❤️ 如果你愿意，这个工具可以把“手工选股”变成“半自动执行流程”。

运行 ashare-strategy init-workspace 后，通常会得到：

• 示例持仓
• reports/ 报告目录
• daily_plan/ 计划目录
• custom_strategy.yaml 配置副本
• README.txt 使用说明文件

现在支持三种模板：

• beginner：新手默认推荐
• conservative：偏稳健
• aggressive：偏激进

例如：

ashare-strategy screen --template conservative
ashare-strategy backtest --template aggressive --output json

• 默认免费体验仍可使用 akshare，但它更适合作为“免费增强源”，不再建议作为唯一稳定主链路

• 若你购买的是 Tinyshare 授权码，推荐优先使用 provider: tushare + data_source.tushare_sdk: tinyshare

• 当前 Tinyshare 模式已新增轻量稳定筛选路径：不再强依赖 AkShare 的板块/实时行情接口，而是优先依赖更稳定的日线能力

• 新增 doctor-data 命令，可快速检查当前数据源是否可认证、核心接口是否可访问、是否只能回退缓存。

• screen / backtest / plan 已支持 --offline，可在网络不稳定时尝试仅使用本地缓存。

• 这些命令失败时会自动附带数据源诊断提示，帮助判断是网络、认证、权限还是缓存问题。

• init-workspace 现在会正确读取打包内置的默认配置文件，不再要求你手动准备 config/default_strategy.yaml

• ui 在 Windows 打包版中已改为使用内置 Streamlit 启动脚本，避免出现 No such option: -m

• 如果 screen 因网络/代理失败，建议先运行 doctor-data，或尝试带缓存的 --offline 模式

• 新增 ashare-strategy version 命令，可快速查看当前版本。

• Windows 发布 zip 现已带版本号，便于区分不同构建包。

如果你购买的是 Tinyshare 授权码，不要继续直接用默认 akshare 配置。 应改为：

data_source:
  provider: tushare
  tushare_sdk: tinyshare
  tushare_token: "你的授权码"

然后通过 --config your_config.yaml 或在工作区里维护自己的配置文件来运行。

在当前版本里，更推荐你把 Tinyshare 理解成“稳定模式”：

• ✅ 更适合 doctor-data
• ✅ 更适合 screen 的轻量筛选
• ✅ 更适合 backtest / plan / positions
• ⚠️ 当前不追求和 AkShare 一样的全市场板块扫描能力

如果你的目标是“先把工具用起来”，优先选 Tinyshare。 如果你的目标是“补充更多板块/概念信息”，再额外尝试 AkShare。