使用说明
先看今日候选，再核对数据，最后用回测和模拟验证交易纪律
这个系统适合做盘前选股、盘后复盘、策略验证和模拟成交。它不是自动下单工具，所有结果都应经过人工确认。
快速上手
打开首页，先看“今日选股”
重点看买入候选、观察池、风控/排除原因。买入候选不代表立即买入，它只是系统按当前策略池筛出的高优先级对象。
确认行情服务状态
右上角“启动行情服务”可启动本地行情接口。按钮变为“行情服务已连接”后，在线行情和扫描接口才是可用状态。
设置股票代码和日期区间
单股加载、回测、扫描当前股会读取这里的股票代码、开始日期和结束日期。日期范围越长，回测越稳定但运行更慢。
选择策略池
策略池决定扫描和回测使用的规则组合。切换策略池后，建议刷新今日选股或重新扫描，避免用旧结果判断。
功能总览
今日工作台
盘前选股入口，汇总候选、观察、排除、交易计划、市场联动和系统摘要。
交易账户
模拟成交、持仓、权益曲线、风控配置、风险趋势、优先样本、持仓年龄和行业主导趋势。
策略分析
单股分析、策略回测、策略版本、候选对比、多周期复盘、分时图、盘口五档和排行榜联动。
数据管理
历史缓存覆盖、指数缓存、全球市场上下文、缺失历史修复和任务记录。
复盘任务
盘后复盘、失效样本、跳过执行、风险复核闭环和全球市场背景补充说明。
诊断与验证
每个核心动作都对应 Agent 命令或 API 验证链路，便于自动化核对 UI 与服务端输出。
今日选股
买入候选
展示系统认为当前最值得进一步研究的股票。需要继续核对信号日期、触发策略、流动性、风控说明和建议仓位。
观察池
有一定分数或信号，但还没有达到执行条件。适合加入盯盘列表，而不是提前重仓。
风控 / 排除
展示被过滤、阻断或暂不建议交易的对象。排除原因比候选更重要，因为它能帮助避免低质量交易。
刷新
重新读取最新扫描快照、数据状态和策略池摘要。刷新不会自动重新扫描股票池。
建议：每天先看“风控 / 排除”，确认系统为什么不买，再看买入候选。这样更容易形成稳定的交易纪律。
单股分析与市场联动
分析选择
可从今日候选、股票池、龙虎榜、成交额/成交量/涨跌幅/换手率/振幅/价格异动列表选股，再联动到单股分析。
K线 / 成交量
支持日、周、月切换，并叠加 MACD、KDJ、RSI、BOLL，用于看趋势、波动和信号位置。
Minute Chart
显示最新交易日分时走势、均价线和成交量。在线分钟源异常时，优先回退本地分钟缓存。
盘口五档
不仅显示买卖五档，还汇总状态、错误分类、外盘/内盘、量比、委比、回退原因、竞价观察和主力推断。
Relative Strength
对比个股与基准指数收益，显示个股收益、基准收益、超额收益和结论，用于判断是否跑赢市场。
市场联动
页面会复用最新扫描生成强度榜、风控榜、板块热力图方案和全球市场上下文，帮助把单股判断放回市场背景里。
注意：排行榜、龙虎榜和候选列表主要是“发现入口”，最终还是要回到单股分析里确认价格、量能、盘口和风控说明。
策略版本与多周期复盘
策略版本
把当前策略池保存为候选版本，避免直接覆盖现行策略。保存后可继续做候选回测、对比和启用。
候选回测
用当前股票和日期区间测试候选版本的收益、回撤、胜率和交易笔数。
版本对比
把当前版本和候选版本放在同一只股票上对比收益、回撤和交易差异。
启用候选
把候选版本切换为当前策略池，并写入策略审计记录。
跨周期复盘
按多组持有周期批量回测多只股票，输出推荐周期、评分分解、同分提示、低样本提示和高回撤提示。
变更审计
记录版本保存与启用历史，帮助追踪策略调整原因，不把策略变化留成黑盒。
账户风控与风险复核
风险趋势摘要
汇总仓位、现金、持仓变化、活动告警、高频风险、热度来源、完整覆盖率和服务端处置建议。
风险复核动作
把需要人工确认的风控动作列出来，并支持标记已处理、待跟进、阻塞或待处理。
优先查看样本
从最近账户快照里挑出最值得先看的风险样本，避免在大量历史里平均用力。
风险热度样本
显示最近热度最高的样本，告诉你为什么某条样本排在最前、风险来自哪里、可信度如何。
持仓年龄分布
区分短持仓、观察期和老化持仓，并跟踪最长持仓天数变化，帮助识别“该走没走”的持仓。
行业主导趋势
跟踪近期主导行业、集中度、预警样本、红线样本和抬升样本，用于识别持仓是否过度集中。
数据管理
当日行情
当日数据默认走在线行情服务，不覆盖历史 SQLite 缓存，避免把盘中未完成数据写进历史库。
历史缓存
非当日历史数据使用本地 SQLite 缓存，适合回测、历史模拟和减少重复请求。
刷新数据状态
查看股票池总数、启用数量、历史完整度、覆盖率、低覆盖率告警、最新缓存日期和缺失数据情况。
覆盖率修复计划
按缺失天数和最近交易日排序，给出建议批次、预计修复后覆盖率、优先标的和可直接执行的 Agent 命令。
修复缺失历史
按股票池逐步补齐缺失历史数据。建议在网络稳定、行情服务正常时执行。
指数缓存
显示本地指数缓存、同步策略、最近同步状态和失败摘要，便于判断市场背景是否可用。
全球市场上下文
当前只把 A 股缓存作为真实可用背景；其他国际市场若显示“规划态”，仅表示预留上下文字段，不代表真实行情已接入。
关键：如果完整覆盖率很低，页面上的回测、扫描和复盘都只能视为有限样本参考，不能当成成熟生产结论。
扫描股票
扫描当前股
- 使用当前股票代码和日期区间。
- 适合验证某一只股票为什么买、卖、持有或禁止。
- 会刷新价格走势、策略信号、交易信号和扫描明细。
扫描股票池
- 使用已启用的股票池列表。
- 运行时间较长，页面会显示后台进度。
- 完成后会更新今日选股和扫描明细。
注意：股票池扫描结果是某个时间点的快照。盘中价格快速变化时，应重新扫描或至少刷新行情后再判断。
策略回测
策略池回测
使用当前策略池和当前股票代码做历史回测，输出交易次数、收益率、胜率、最大回撤和交易明细。
价格走势
显示股票价格序列，帮助观察买卖信号是否出现在趋势和波动合理的位置。
资金曲线
观察策略资金变化。比总收益更重要的是曲线是否稳定、回撤是否可承受。
策略信号 / 交易信号
策略信号是原始规则输出；交易信号是合并、过滤后的实际回测信号。
模拟炒股
运行今日模拟
按今日选股计划尝试模拟成交，生成成交或跳过记录，用于验证建议能否转化为可执行交易。
重置账户
把模拟账户恢复到初始资金状态。重置前建议先确认是否需要保留历史模拟记录。
持仓
展示当前模拟账户持有股票、成本价、最新价、市值和盈亏。
最近成交 / 跳过
成交记录用于复盘执行，跳过记录用于排查资金不足、风控阻断、仓位限制等问题。
历史模拟运行
运行历史模拟
按日期区间、初始资金和基准指数运行组合级模拟，比单股回测更接近真实组合管理。
基准
默认可使用沪深300等指数代码。基准用于计算超额收益和判断策略是否跑赢市场。
每日快照
记录每天现金、持仓市值、总资产、回撤和买卖数量，用于分析策略运行过程。
交易明细
显示历史模拟中每笔买卖、金额、盈亏和理由，是复盘策略规则的关键数据。
复盘任务
生成复盘
把当天候选、执行、跳过、风控复核和后续失效样本汇总成一份盘后复盘结果。
问题摘要
会集中展示后续转负、严重回撤、执行跳过、主要失效原因和风险处置闭环质量。
重点问题
按严重度排序，告诉你哪类失效最值得先看，而不是只堆明细表。
全球市场背景
复盘页会复用全球市场上下文，作为盘前/隔夜背景补充，不直接伪造尚未接入的国际涨跌归因。
风险纪律
执行前检查
- 信号日期是否是最新交易日。
- 股票是否通过基础过滤和流动性检查。
- 仓位是否符合账户总风险限制。
- 是否已经设置止损和退出条件。
不要机械执行
- 涨停、跌停或一字板可能无法按模型价格成交。
- 公告、停牌、解禁、减持会改变模型外风险。
- 回测收益不代表未来收益。
- 连续亏损时优先降低仓位，而不是加倍下注。
当前边界
不是自动实盘系统
当前重点是选股、回测、模拟和复盘，不直接替代券商终端下单，也没有完整的实盘订单生命周期。
数据面仍弱于成熟平台
与聚宽、米筐、掘金这类平台相比，当前还缺多资产、多品种、财务因子、tick 级、组合优化和实盘接入能力。
全球市场仍是第一版
A 股上下文可用，JP/KR/US/EU 若显示规划态或部分可用，只能当背景提示，不能当真实外盘行情模块。
低覆盖率会降低可信度
如果历史覆盖不足，系统可以继续工作，但输出代表的是有限样本条件下的参考结果，而不是稳定结论。
Agent 验证
常用等价命令
powershell -ExecutionPolicy Bypass -File tools\agent-ui.ps1 -Action dashboard-todaypowershell -ExecutionPolicy Bypass -File tools\agent-ui.ps1 -Action data-managementpowershell -ExecutionPolicy Bypass -File tools\agent-ui.ps1 -Action data-sync-history -MaxCount 20powershell -ExecutionPolicy Bypass -File tools\agent-ui.ps1 -Action paper-accountpowershell -ExecutionPolicy Bypass -File tools\agent-ui.ps1 -Action strategy-multi-period-review -Code 000001powershell -ExecutionPolicy Bypass -File tools\agent-ui.ps1 -Action layout-check
什么时候看日志
- 按钮点击后没有更新表格或摘要。
- 扫描、回测、模拟结果和预期明显不一致。
- 盘口、分时图、全球市场等数据源状态不稳定。
- 需要确认 UI 显示是否与 Agent/API 返回同口径。
常见排错
行情服务未连接
点击“启动行情服务”。如果仍失败，检查 Python 环境、依赖和网络访问。
扫描结果为空
确认股票池是否启用、日期区间是否有效、历史数据是否完整、策略池是否有启用策略。
回测被阻断
通常是基础过滤未通过，例如流动性、市值、数据质量或风险规则不满足。
页面结果和预期不同
打开“诊断日志”，查看接口请求、响应状态、扫描任务进度和错误信息。