Equity Research Agent 的功能
Equity Research Agent 可将带日期的公开财务数据转换为英文股票研究报告，并输出可编辑的 Word 文档及匹配的 PDF。它支持美股、上海 A 股和港股，同时保留数值型关键结论，并解释盈利能力、现金转换和估值驱动因素。
该项目将数据收集、财务计算、假设审查和文档格式化分离开来。其确定性财务引擎在本地计算估值结果，而 DeepSeek 可用于质疑投资论点并提出可能的 DCF 假设。
主要功能
- 覆盖三个市场：选择美股代码、六位上海股票代码或港股代码。
- 明确的估值输入：配置增长率、利润率、税率、再投资、WACC、永续增长率、ROIC 和股权桥接假设。
- 三情景 DCF：查看乐观、基准和悲观情景，以及各情景对应的增长率、利润率、资本支出和营运资金变化。
- 可编辑的交付结果：导出 Word 报告，并在受支持的 Windows 安装环境中导出匹配的 PDF。
- 证据与溯源：保留来源快照、日期、货币、哈希值和验证摘要。
- 离线重放：无需发起 LLM 请求，即可重新计算随附的财务快照。
安装并启动工作区
你需要 Python 3.10 或更高版本。在解压后的仓库目录中创建虚拟环境，安装项目及其测试依赖，然后启动本地工作区。
python -m venv .venv
.venv/Scripts/python.exe -m pip install -e ".[test]"
.venv/Scripts/python.exe -m equity_research_agent.cli serve --port 8766
在浏览器中打开 http://127.0.0.1:8766。在 Windows 上，安装完成后也可以启动 Start Workspace.cmd。
实时收集公开数据需要联网，但不需要单独的数据 API 密钥。DeepSeek 为可选功能。如需启用，请将 .env.example 复制为 .env，并在本地添加你的密钥。凭据会保留在本地环境中。
创建基础公司报告
在工作区中选择市场和准确的证券。生成报告前，检查已加载的公司身份、报告货币、报价货币、数据覆盖范围和可用估值字段。
如需可复现的离线示例，请使用随附的 NVIDIA 冻结快照：
.venv/Scripts/python.exe -m equity_research_agent.cli company --market US --symbol NVDA --snapshot examples/nvda/company_snapshot.json --skip-pdf该命令使用已保存的公司快照，跳过模型请求，并生成 Word 报告而不尝试转换 PDF。同样的工作流也适用于其他受支持的证券，只需使用相应的市场、代码以及快照或实时公开数据输入。
配置 DCF 假设
直接在工作区中设置驱动估值的假设。可用输入包括收入增长率、经营利润率、税率、再投资、WACC、永续增长率、ROIC 以及企业价值到股权价值的桥接。情景控件可调整乐观和悲观情景下的增长率、利润率、资本支出和营运资金变化。
财务引擎使用这些经过审查的输入计算三种现金流情景。报告会展示假设、年度 FCFF 计算、折现现金流、终值再投资以及企业价值到股权价值的桥接，而不是将估值逻辑隐藏在单一目标数字之后。
与 DeepSeek 讨论假设
当你想要检验投资论点，而不只是输入假设时，可以使用讨论界面。输入问题或投资论点，也可以选择提供公开来源链接。DeepSeek 会审查检索到的证据，质疑当前观点，并提出包含区间、理由、参考资料和反驳意见的假设。
- 输入你的投资论点或估值问题。
- 如有相关公开来源链接，请添加。
- 查看建议的区间、证据和反驳意见。
- 仅选择你希望应用的建议。
- 检查本地财务引擎中由此产生的估值变化。
- 生成报告前，手动编辑任意字段。
模型负责提出和撰写；本地引擎负责计算数字。DeepSeek 默认启用高强度思考，并设置累计 100 元人民币的预算上限。界面不会自动将建议强制写入模型：是否应用始终由用户明确操作。
审阅生成的报告
完成的报告包括财务分析、DCF 可视化、计算表格、敏感性信息、来源限制以及披露的情景假设。估值页面将三种现金流情景与带日期的收盘价、股权桥接和终值假设结合在一起。
请确认报告币种和估值币种清晰明确，股票收盘价已标注日期，并且假设与您计划审阅的情景一致。对于受支持的 Windows 配置，导出 PDF 需要 Microsoft Word，以及位于 PATH 中的 Poppler pdftoppm，或设置 EQUITY_PDFTOPPM 环境变量。其他系统可以使用 --skip-pdf 创建 Word 文档。
验证安装
安装后运行仓库的公开测试套件：
.venv/Scripts/python.exe -m pytest tests -q仓库记录了 35 个公开测试，涵盖财务引擎、公司报告、布局、假设讨论、本地 HTTP 路由和预算控制。其发布验证还会检查财务重算、杜邦恒等式、货币转换、图表数值、文档一致性和数据来源。
验证可以确保计算和文档的一致性，但不能替代发行人文件核对或针对特定公司的投资研究。
高级用法和重要限制
使用冻结快照确保可复现
随附示例支持离线重放已保存的财务快照和情景。这对于测试、审阅报告布局，以及在不发起新的模型请求的情况下复现所提供的示例十分有用。
接受假设前检查证据
应结合范围、理由、参考资料和反方论据审阅 DeepSeek 的建议。通用假设需要针对具体公司进行审查，二手数据字段可能需要与发行人文件核对。
了解行业范围
对于银行、保险公司、REIT 及其他金融行业标的，公司 FCFF 功能处于禁用状态。年度余额也可能需要根据后续股息、融资和稀释情况进行更新。
目视审阅新导出文件
仓库包含对所提供报告的验证，但新的叙述内容和布局导出文件仍需单独进行目视审阅。请确认图表、计算表、币种、日期和下载文件均与所选输入一致。
结论
Equity Research Agent 提供了一条从带日期的公开事实到透明、可编辑研究的结构化路径。在本地安装后，选择受支持的证券，审阅或讨论 DCF 假设，使用确定性引擎计算情景，并检查生成的 Word 或 PDF 报告。请将输出视为有条件的研究草稿，而不是投资评级或有保证的目标价格。