Justice Plutus

📈 本地 A 股智能研报生成器

本地运行 A 股分析管道,自动生成 Markdown/JSON 双格式研报,支持数据预检与通知开关

收藏
7.8k
安装
2.1k
版本
2.0.3
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

JusticePlutus 是一个面向 A 股市场的本地化分析工具,通过命令行触发对指定股票代码(6 位数字)的自动化研究流程。用户可通过自然语言指令(如 "analyze stock" 或 "dry run")触发两种模式:

  • 完整分析模式:调用 OpenAI API 生成深度研报,输出包含个股分析(.md + .json)、当日汇总(summary.md/summary.json)及运行元数据(run_meta.json),默认关闭通知,可在配置信道后启用。
  • 数据预检模式:通过 --dry-run 参数仅验证数据可用性,不消耗 API 额度,适合盘前快速检查。

所有报告按日期归档至 reports/YYYY-MM-DD/ 目录,便于历史回溯与版本管理。

显著优点

1. 本地化与隐私优先:完全本地运行,不依赖 GitHub Actions 或云端 CI,敏感持仓数据不出境。
2. 结构化输出:Markdown 便于人工阅读,JSON 便于程序化处理,满足量化交易系统的数据对接需求。

3. 灵活触发:支持逗号分隔多股批量分析,通过自然语言短语即可激活,降低使用门槛。

4. 成本可控--dry-run 模式零 API 成本预检,--no-notify 默认静默运行,避免误触发扣费。

潜在缺点与局限性

  • 环境依赖:需本地安装 Python 并维护 justice_plutus 模块,对非技术用户配置门槛较高。
  • API 成本约束:深度分析依赖 OPENAI_API_KEY,高频运行或大盘批量扫描可能产生显著 token 费用。
  • A 股专属:仅支持 6 位 A 股代码,港股、美股、基金等其他资产类别无法直接分析。
  • 无实时行情:技能本身不披露行情数据源,若底层数据延迟或缺失,分析质量将受影响。
  • 通知配置复杂:如需启用通知,需额外配置信道参数,文档未明确说明具体支持的渠道(邮件/钉钉/企业微信等)。

适合人群

  • 量化研究员与算法交易员:需要结构化 JSON 输出对接自动化交易系统。
  • 技术型个人投资者:具备 Python 环境,希望本地化运行、避免 SaaS 订阅费用。
  • 合规敏感机构:对数据出境有严格限制,需完全离线的 A 股研究工具。

常规风险

| 风险类别 | 说明 |
|---------|------|
| API 密钥泄露 | `OPENAI_API_KEY` 需配置在本地环境变量,存在被意外提交至 Git 的历史风险,建议配合 `.env` 与 gitignore 管理。 |
| 投资决策依赖 | 研报内容由 LLM 生成,可能存在幻觉或滞后信息,不可替代专业投研判断,需人工复核。 |
| 数据质量风险 | 技能不验证底层行情数据的实时性与准确性,极端行情下可能出现数据缺失导致误判。 |
| 供应链安全 | 依赖 `justice_plutus` Python 包,需从可信源安装,警惕 typosquatting 或恶意依赖注入。 |
| 财务支持可持续性 | 项目通过支付宝/微信个人收款码捐赠维持开发,长期维护力度存疑,生产环境需评估 fork 自维护可行性。 |

Justice Plutus 内容

references文件夹
scripts文件夹
手动下载zip · 1.9 kB
overview.mdtext/markdown
请选择文件