PRISM-INSIGHT
由13+个专业AI代理协作的开源股票分析与交易系统，自动侦测异动股、生成分析师级报告并执行交易。
证据显示：密钥通过环境变量/secrets.yaml管理并有测试断言配置文件无内联密钥（敏感数据处理2分）；依赖有精确版本钉扎与注释理由、CI含许可证合规检查（依赖安全2分）；THIRD_PARTY_NOTICES.md与许可证合规作业支持来源归属（2分）。扣分点：系统默认执行真实券商下单、Telegram广播与外部API抓取，未见任何文件展示下单前的用户确认门槛或权限边界说明；回滚/恢复仅有测试文件名（runner_recovery、broker_recovery）佐证而无代码，均只给1分；数据流向（哪些数据发往OpenAI/Perplexity/Firecrawl）未在文件中说明。
文档与CI相互一致，测试矩阵覆盖Python 3.10–3.12，离线安全回归测试组织严密（自一致性2分）。扣分点：核心依赖mcp-agent来自作者自己的fork（钉扎到commit），且upstream PR未合并、requirements中留有TODO，上游可用性存在明显悬置（1分）；失败处理仅见JSON修复、KRX断路器等零散注释，未见系统性错误信息规范（1分）。
面向KR/US双市场，提供quickstart、demo.py、Docker与多语言报告，受众与场景覆盖充分（2分）；环境适配有CI矩阵与Docker支持（2分）。扣分点：能力边界除投资建议免责与『figures are diagnostic』外未见明确说明，交易agent在何种条件下拒绝执行未被文件展示（1分）；激增股触发算法在未提供的TRIGGER_BATCH_ALGORITHMS.md中，本次证据无法核实触发精度（1分）。
文档索引清晰、五语言README、安装说明详尽（架构与安装各2分）；demo/示例/视频充分（2分）；免责声明和对业绩图『非可实现回测』的诚实标注支持已知局限（2分）；AGPL-3.0全文+商业双许可与CLA、赞助、维护联系人支持许可与维护责任（各2分）。扣分点：配置存在legacy/native双格式过渡态，命名有迁移包袱（1分）；README提及v1.16.7–v2.18版本演进但未提供CHANGELOG文件（1分）。
输出形态多样（PDF、Telegram、Dashboard、移动App），可用性较好（2分）；13-agent多角色分析与自反馈交易日志提供差异化价值（2分）。扣分点：运营成本约$310/月自述但用户侧的API费用（OpenAI为主）与收益/成本权衡未量化，业绩数字（+244.63%）无法在本仓库内核实（成本效益1分）。
README明确区分诊断性统计与可实现收益、声明无历史回填，事实与推断分离做得较好（2分）。扣分点：核心业绩与胜率声称只指向外部dashboard链接，仓库内无原始数据或可复现脚本（可追溯1分）；跨来源仅外部站点，本仓库证据无法交叉验证（1分）。
- 系统支持真实券商自动下单，本次静态审查未见下单前强制用户确认机制的代码证据，请在启用自动交易前自行审查交易执行路径并从小额开始。
- 默认模式会向Telegram频道广播并向OpenAI、Perplexity、Firecrawl等外部服务发送市场数据，敏感策略与持仓信息的外泄面请自行评估。
- 核心依赖mcp-agent来自作者私有fork（钉扎commit、上游PR未合并），长期可维护性与安全更新存在不确定性。
- README中的累计收益率与胜率为运营方自报、指向外部dashboard，本仓库内无法核实，且官方已标注其非时权组合收益，请勿据此决策。
- 商业SaaS使用需另行购买商业许可，AGPL-3.0义务（含网络服务源码披露）请自行确认合规。
这个 Agent 能做什么，适合哪些场景？
PRISM-INSIGHT 是 dragon1086 在 GitHub 上开源（AGPL-3.0）的AI股票分析与交易系统，覆盖韩国 KOSPI/KOSDAQ 和美国 NYSE/NASDAQ 市场。其核心是一套多代理工作流：13个以上专业代理分为宏观、分析、策略、沟通、交易、咨询六个团队，协作完成异动股侦测、技术/财务/行业/新闻/市场分析、投资策略综合与买卖决策。系统通过多个 MCP 服务器获取数据（韩股用 kospi_kosdaq 服务器，美股用 yahoo-finance-mcp 和 sec-edgar-mcp），AI 模型默认使用 OpenAI GPT-5，并支持通过 Codex OAuth Proxy 直接使用 ChatGPT Plus/Pro 订阅而无需API密钥。输出包括多语言PDF分析报告、Telegram 实时推送、交易模拟与通过韩国投资证券API的实盘自动交易，配套公开实盘仪表盘（analysis.stocksimulation.kr）和 iOS/Android 移动应用。该系统适合愿意自建运行环境、承担API成本并自行核验交易风险的量化/研究型用户。
系统按早/盘模式运行 stock_analysis_orchestrator.py（美股为 prism-us/us_stock_analysis_orchestrator.py）：先侦测成交量/价格异动股生成观察名单，然后由6个分析代理（技术、财务、行业、新闻、市场）并行分析，策略代理综合投资策略，交易代理做出买卖决策并记录交易日志，交易日志的触发胜率会反馈影响后续买入决策（自我改进闭环）。数据读取依赖 MCP 服务器：KRX 数据（kospi_kosdaq）、网页抓取（firecrawl）、网络搜索（perplexity）、模拟交易数据库（sqlite）、美股行情（yahoo-finance-mcp）和 SEC 文件/内部人交易（sec-edgar-mcp）。产出包括分析师级PDF报告（Playwright/Chromium 渲染）、Telegram 多语言频道广播，以及通过韩国投资证券API的真实下单执行。可选用 ADANOS_API_KEY 补充美股新闻的社会情绪数据。另提供 Stance 策略排行榜：注册日起实时记录策略决策，禁止历史回填，按收益率、最大回撤、平均仓位和记录率排名。
- 韩国散户投资者想要每日自动接收 KOSPI/KOSDAQ 异动股的AI分析报告并推送到 Telegram，而不自行盯盘。
- 美股研究者在只有 OpenAI API key 的情况下用 60 秒快速上手：./quickstart.sh 生成苹果（AAPL）等个股的PDF分析报告。
- ChatGPT Plus/Pro 订阅者没有API预算，通过 Codex OAuth Proxy（PRISM_OPENAI_AUTH_MODE=chatgpt_oauth）用订阅额度跑完整分析流水线。
- 量化或系统交易开发者想把自己的策略接入 Stance 排行榜，用 Codex CLI/Cursor/Claude Code 粘贴一条指令完成注册与集成，在63个交易日和20笔已平仓交易后进入正式排名。
- 希望通过韩国投资证券API进行自动化实盘交易的用户，在配置 mcp_agent.secrets.yaml 与 KRX 凭证后启用真实执行。
- 多语言内容运营者利用内置翻译代理生成英/日/中/西语报告，通过对应 Telegram 频道分发。
这个 Agent 有哪些优点和局限？
- 覆盖从异动侦测、多代理分析、交易模拟到真实下单执行的完整端到端流程，而非单一报告工具。
- 双市场支持（KRX 与 NYSE/NASDAQ），美股数据来自 yahoo-finance-mcp 和 sec-edgar-mcp（含SEC文件与内部人交易）。
- 提供 ChatGPT Plus/Pro 订阅的 Codex OAuth 路径，可零API账单运行完整分析。
- 交易日志反馈闭环（胜率追踪自动影响未来买入决策）和公开实盘仪表盘提供可核验的运行记录。
- 拥有iOS/Android应用、五语种Telegram频道和 Stance 无回填策略排行榜等配套生态。
- 运行依赖明确列出的付费外部服务：OpenAI API 约$235/月，Anthropic、Firecrawl、Perplexity 及服务器合计约$310/月。
- 韩股实盘执行绑定韩国投资证券API及KRX/Kakao凭证，非韩国用户在该环节需要适配。
- 核心分析深度绑定 OpenAI GPT-5；Claude 仅作为可选兼容工作流，迁移到其他模型缺乏明确文档。
- README 中的业绩数据（韩股累计+244.63%）为诊断性统计：累计收益为逐笔交易收益率之和，非时间加权组合收益，也非可实现的回测结果。
- 完整安装涉及 Python、Node.js MCP 构建、Playwright、多份 YAML 配置和 KRX 凭证，部署成本不低。
如何安装或部署这个 Agent？
快速体验（美股，仅需 OpenAI API key）：
git clone https://github.com/dragon1086/prism-insight.git
cd prism-insight
./quickstart.sh YOUR_OPENAI_API_KEY或用 Docker：
export OPENAI_API_KEY=sk-your-key-here
docker compose -f docker-compose.quickstart.yml up --build -d
docker exec -it prism-quickstart python3 demo.py NVDA完整安装（Python）：
pip install -r requirements.txt
python3 -m playwright install chromiumcd perplexity-ask && npm install && npm run build && cd ..
cp mcp_agent.config.yaml.example mcp_agent.config.yaml
cp mcp_agent.secrets.yaml.example mcp_agent.secrets.yaml# 在 secrets 中填入 OpenAI API key，config 中填 KRX 凭证（Kakao 账户）
可选：Perplexity API key 用于新闻分析；ADANOS_API_KEY 用于美股新闻情绪增强。详细指南见 docs/SETUP.md。
如何使用这个 Agent？
运行分析：
python stock_analysis_orchestrator.py --mode morning --no-telegram美股：
python prism-us/us_stock_analysis_orchestrator.py --mode morning --no-telegram
python prism-us/us_stock_analysis_orchestrator.py --mode morning --language en单股快速演示：python3 demo.py MSFT / NVDA / TSLA --language ko
使用 ChatGPT 订阅：先运行 python -m cores.chatgpt_proxy.oauth_login 完成浏览器登录，再以 PRISM_OPENAI_AUTH_MODE=chatgpt_oauth 运行编排器。
生产部署推荐 docker compose up -d。启用 Telegram 推送需配置频道；实盘交易需韩国投资证券API凭证。生成的PDF报告保存在 prism-us/pdf_reports/（美股）或对应输出目录。查看实盘效果可访问 https://analysis.stocksimulation.kr/。
这个 Agent 与同类方案有什么区别？
源材料未命名直接竞品，仅将其定位为面向投资者的AI助手（与赞助商面向专业人士的 WrksAI 相对）。没有足够信息与其他交易/分析系统做事实性对比。