The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Stock Sentinel listing page.
美股投资进攻/防守信号判断与示警工具：四维数据驱动信号 + 公开 Track Record + 开放 API/MCP。
股哨兵不做选股建议，只回答"现在是进攻时机还是防守时机"：
覆盖范围仅限美股（不含房产）。
四维信号全部自动数据驱动（管理员可手动覆盖），每日美东 21:00 cron 合成最终信号（盘后财报、电话会报道、当日收盘价均已就绪，避开 FRED 凌晨维护窗口；北京时间次日 9:00/10:00）。
离散事件型指标在公布当天即生效（不必等 21:00）：①FOMC 决议——Fed 官网美东 14:00 发布后系统直接读声明文本并重算货币维与档位；②BLS/BEA 惯例的 08:30 月度发布（失业率/萨姆/PCE/联邦月度支出/半导体产出）——系统在美东 08:35、10:05、14:05 检测参考期是否前移，前移即重算受影响维度。连续行情型指标（WTI 油价、信用利差、收益率曲线、日频 EPU）按设计保持 21:00 采样：它们时刻在变，盘中实时化会让历史序列的采样点从固定时点漂移成"最后一次访问的时刻"，破坏可比性与回测口径（详见 backend/utils/event-refresh.js 文件头）。两类即时刷新都只就地更新既有快照、绝不新增采样点，且只允许升档方向。
| 信号位 | 数据来源 | 判定规则 |
|---|---|---|
| AI供需（长线主线） | 现金流三件套，沿产业链资金流向：OpenRouter 模型调用量（需求侧）→ SEC EDGAR 云厂商资本开支（投资侧）→ FRED IPG3344S 半导体产出同比（供给侧） | 调用量 28日均vs前28日均 >+3% 宽松 / <−3% 收紧；capex 滚动4季同比 >+10% 宽松 / <0% 收紧，另有单季侦察兵规则（最新单季同比<0 拦截宽松；连续两季<0 直接收紧，比 TTM 提前 1-2 个季度）；半导体产出同比 >+5% 宽松 / <0% 收紧。三件套共识：任一环节收缩→收紧（供过于求预警），全链向上→宽松，其余中性 |
| 货币政策 | Fed 官方 FOMC 声明（决议当日即时）+ FRED DFEDTARU 利率 + WALCL 资产负债表（核心PCE/Trimmed PCE/失业率仅参考展示） | 按最近一次 FOMC 决议方向判定：加息（含渐进25bp）→收紧并保持到下次决议；降息或按兵不动→宽松。单次调整 ≥50bp（不论方向）触发应对式调整锁强制全面防守。QT 只拦截宽松评级不单票定罪（回测实证 QT 年份市场多数上涨）。决议当晚即生效：Fed 官网美东 14:00 发布声明后直接读声明文本（fetch-fed-rate.js 解析目标区间与动词），不等 FRED 日更序列（后者次一工作日才见新台阶，此前会造成决议当晚"持平/方向反了"）；FRED 台阶落地后自动切回序列口径 |
| 财政政策 | FRED MTSO133FMS 联邦月度支出 | "大市场小政府"原则：滚动12月实际（PCE平减）支出同比扩大 >5%→收紧（政府变大），收缩 >5%→宽松（政府瘦身）。用支出不用赤字：减税型赤字不应判收紧 |
| 行政政策 | FRED EPUTRADE（月度贸易专项）+ USEPUINDXD（日频EPU 7日均线）+ WTI 油价（战争冲击实时代理，期货优先） | 油价30天涨跌 ≥±20% 事件层优先：飙升且 EPU 高位且油价处高位（高于近2年中位，低位反弹不判战争冲击）→收紧；暴跌且 EPU 未高位→宽松。否则 EPU 双源10年百分位 >80→收紧，<50→宽松，双源一致才定档 |
全局叠加（防守分级）：
SAHMREALTIME ≥0.5）与应对式调整锁（利率单次 ≥50bp）强制全面防守；解锁 = 利率降至 ≤0.25%（零利率区间无条件解锁），或锁龄满60天且触发条件已消失时出现 <50bp 小幅调整。可信度工程：数据管道四层韧性（114号，2026-07-25）——①每日更新定在美东 21:00（盘后财报/电话会报道/当日收盘价就绪，避开 FRED 凌晨维护窗口，上午发布的失业率/萨姆/PCE 当晚入判定）；②FRED 瞬时故障（超时/429/5xx）自动退避重试；③参考指标组级 stale-keep——故障日整组沿用上一快照（值+数据参考期一起，参考期如实显示旧日期，不伪造新鲜度）；④新鲜度看门狗——指标参考期超预算（月度100天/日频10天）自动运维告警，防 stale-keep 静默掩盖序列停更；⑤快照补更新（118号，2026-07-31）——快照过点未生成（定时任务被错过/中途失败）时，小时级看门狗与前端访问都会自动触发后台补跑（30分钟冷却+互斥防打爆，绝不提前跑——美东21:45前期望的是昨日快照，不生成数据不完整的早产快照），前端显示补更新横幅并在新快照落库后自动刷新。信号级：单维度数据源故障时沿用上一次有效判定（stale-keep，前端标灰"数据延迟"），不降级为中性，避免故障日误发"解除防守"警报。行情多层回退（moomoo OpenD→Yahoo→Tiingo→TwelveData），EDGAR 数据带新鲜度校验与错季对齐。指引检测双护栏（115号，2026-07-30）——web 检索只采信财报发布后的报道（财报前预览稿/分析师预期不是管理层指引）；会计政策变更致指引名义数字变化但实际投资计划不变时按实际计划判（不误触发下修事件）。
示警：档位变化 / 任一维度转收紧 / 泡沫预警 / 锁触发与解除时，通过 Resend 邮件提醒订阅用户；进/出全面防守另发 S5 执行指令邮件（仅管理员）。
历史回测报告见 docs/backtest-report.md（6 场危机 5 场触发全面防守，2026 美伊战争未达 15% 危机线由减仓分级应对；2008 年精确到顶部前 11 天。数字为 2026-07-30 快照，以报告与实时接口为准）。S5 执行手册见 docs/s5-execution-playbook.md。
任何 AI 客户端或第三方开发者都可以调用信号系统：
| 通道 | 位置 | 说明 |
|---|---|---|
| 开放 REST API | /v1/*（OpenAPI 规范） | X-API-Key 鉴权；免key试用 25次/日/IP，free 250/日，pro 10000/日（pro 与订阅有效期挂钩，到期自动按 free 计）；密钥在管理后台签发并可绑定归属用户 |
| MCP Server | mcp/ | Claude Desktop/Cursor 等一行配置接入，6个工具（当前信号/历史/产业链/个股/回测/日报） |
| Claude Skill | skills/stock-sentinel/ | 教 AI 正确理解四维框架与解读规范 |
| AI 日报 | /v1/daily-report | 每日 cron 后 LLM 自动生成中英双语信号解读（经 OpenRouter，可配 AI_REPORT_MODEL） |
| 公开 Track Record | 网站 /track-record | 每日信号档位不可篡改存档 + 回测成绩，供任何人验证 |
| 发现层（SEO/GEO，125号） | llms.txt / robots.txt / sitemap.xml（网站根）、GET /v1/openapi.yaml（API 自发现）、首页 meta/OG/JSON-LD | 让搜索引擎与 AI Agent 自动发现全部调用通道；首页对未登录访客开放只读（个人化功能仍需登录） |
所有输出均附免责声明：仅供研究参考，不构成投资建议。
后台管理（/admin，仅管理员）：信号覆盖 / 锁应急清除 / 密钥签发 / 用户管理与API用量监控
（注册与订阅状态、剩余时间与配额、按用户端点统计与30天调用明细、全站功能热度——资源投放依据），
详见 docs/admin-guide.md。
npm test 实跑为准）在 backend/.env 中配置：
信号体系已过七轮专家复查与多轮方法论审查（判定逻辑 v2、防守分级、收益率曲线否决、趋势再入场、降档迟滞、capex 单季侦察兵与指引下修事件 N3、信用利差进攻否决均已实证定案），全量测试用例全过，每日云端自动运行并公开存档。capex 指引自动检测为双源（EDGAR 新闻稿 + web 检索电话会/媒体），财报后单公司 capex 快报（单季/TTM 额度同比、本财年/未来指引）自动入档。第七轮系统性审查（116号，2026-07-30）修复了 FOMC 决议日货币维闪变、N3 事件绕过降档迟滞、邮件发送库错误语义（失败被计成功）、双实例重复群发与备份互踩等 30 余处，详见 docs/systematic-review-2026-07-30.md。
后续迭代：付费订阅墙的实际启用、移动端原生 App/小程序、Google OAuth 登录接入。