核心用法
stock-realtime-brief 是面向A股市场的专业级投研助手，采用命令行交互与Agent调用双模式。核心入口为 run_brief.py，支持七大运行模式：
| 模式 | 命令示例 | 用途 |
|:---|:---|:---|
| 持仓简报 | `portfolio` | 盘前/盘中持仓全景扫描 |
| 单股深度 | `single 600519` | 技术面+基本面深度分析 |
| 多股对比 | `multi 300757,688498` | 横向评分排序 |
| 智能选股 | `pick all/business/money` | 五大策略×12维评分 |
| 板块强度 | `sectors` | 行业资金流向 |
| 盯盘Agent | `watch start/check` | 价格触发自动QQ推送 |
| 风险收益比 | `rr [现价] [三档目标] [三档止损]` | 量化仓位决策 |
| 纪律检查 | `check 600519` | 融资/仓位/情绪综合体检 |
数据层采用腾讯财经优先的冗余架构，规避AKShare实时接口超时风险；历史K线通过AKShare获取60日复权数据。v3.0后区分盘中实时模式（量价/资金/盘口为核心）与盘后研究模式（多周期/业绩/估值），避免时间维度错位导致的建议失效。
显著优点
1. 硬规则嵌入：三档止损（预警线/风控线/清仓线）自动根据仓位权重、融资状态、盈亏情况动态调整，非主观建议
2. 机会成本框架：独创"好公司≠好股票"象限模型，强制识别"机会成本贼"（业绩好但走势弱于持仓均值的标的），避免资金沉淀
3. 时效性强制校验：v3.1起建立数据新鲜度铁律——1年以上消息默认price-in，1月内消息才作为新信号，防止历史利空误杀（如误判天岳减持、新莱立案等案例修复）
4. 融资安全闭环：担保比例实时计算+150%强平红线+条件单强制提示，从工具层面拦截杠杆失控
5. 自动化基建：systemd定时器每日18:00主动推送+价格触发QQ通知，实现"人不在场但规则在场"
潜在局限
- 市场限定：仅支持A股（沪/深/科创/创业板），港美股/期货/ETF需外接其他skill
- 数据依赖：实时行情虽有多源冗余，但极端行情下（如2025年10月8日系统堵塞）仍可能出现秒级延迟
- 不直接荐股：智能选股输出为"综合评分+标签"，需用户二次决策；明确拒绝"今天买什么"类请求
- 基本面浅层：单股模式仅提供PE/PB/市值快照，深度财务分析需用户主动追问
- 情绪量化粗糙：板块情绪、资金情绪依赖量价 proxy，未接入Level2逐笔或舆情NLP评分
适合人群
- 有融资账户的主动投资者：需要担保比例监控+硬止损规则强制落地
- 多票持仓难以实时盯盘者：依赖定时简报+条件单模板+自动预警
- 左侧交易习惯者：通过"机会成本贼"检查清单，纠偏"死扛好公司"行为
- 量化型散户：接受命令行交互，愿意用规则替代盘感
常规风险
| 风险类型 | 具体表现 | 缓解机制 |
|:---|:---|:---|
| 杠杆爆仓 | 担保比例跌破150%未及时处理 | 自动计算+红色警报+强制条件单提示 |
| 消息滞后误杀 | 1年前利空被误判为新信号 | 时效性强制过滤+日期提取校验 |
| 技术信号失效 | 放量突破后假突破 | 三档分仓+回撤即减仓，非全仓押注 |
| 系统依赖 | 腾讯接口故障+本地AKShare超时 | 15秒超时自动降级+本地缓存K线 |
| 过度交易 | 盘中频繁触发买卖建议 | 默认模式为盘后研究，盘中模式需显式触发 |
版本演进
- v4.0：All-in-One整合，新增智能选股、盯盘Agent、纪律守护三大模块
- v3.1：建立数据时效性铁律（第一重要原则）
- v3.0：盘中/盘后双模式架构，避免时间维度错位
- v2.6：七维分析（基本面/估值/情绪/资金/题材/风险事件/技术）