ShanedevPro/argus-reputation-intelligence

# Argus 声誉智能 Argus 声誉智能是一个开源的事件型声誉研究系统。它帮助团队将公开事件背景和聚焦于微博的证据转化为结构化的中文研究报告，以供审查。 Argus 声誉智能是一个开源的事件型声誉研究系统，用于把公开事件线索和微博样本证据整理成可审阅的中文研究报告。 ## 产品预览 / 产品预览  Argus 将具体的公共事件转化为研究计划，准备公开的微博证据，运行多引擎分析链路，并生成可供分析师审查的中文高管简报。 Argus 将具体公共事件转化为研究计划，整理公开微博证据，运行多引擎分析链路，并生成可审阅的中文高管简报，便于分析师核查。 [观看工作台演示](assets/demo/argus-curated-live-demo.mp4) 视频重点展示分析师工作台：输入事件、查看研究计划、选择画像、启动分析，并到达报告就绪状态。最终报告本身通过下方已脱敏的样例产出进行展示。 视频重点展示分析工作台：输入事件、查看研究计划、选择画像、启动分析，并到达报告完成入口。最终报告内容通过下方已脱敏样例产出展示。 ### 样例产出 / 样例产出 - [艺人/公众人物报告：王鹤棣画像](sample_reports/wang-hedi-artist-profile/report.html)：高管简报、证据边界、声誉风险界定及行动建议。 - [企业公关报告：小米 SU7 回应](sample_reports/xiaomi-su7-enterprise-pr/report.html)：事件界定、事实分级、风险议题、情感证据及回应建议。 ## 项目能力 / 项目能力 - 引导分析师从信息录入到确认的研究计划。 - 使用可配置的公开网络搜索和基于 TikHub 的微博数据准备。 - 运行恢复后的 BettaFish 多引擎链路：Query、Media、Insight、Forum 和 Report。 - 生成 HTML、Markdown 和 PDF 报告。 - 包含针对艺人/公众人物和企业公关场景的脱敏样例报告。 - 引导分析师从事件录入进入确认后的研究计划。 - 支持可配置的公开网页搜索，以及基于 TikHub 的微博数据准备路径。 - 运行恢复后的 BettaFish 多引擎链路：事实核验、传播观察、舆情洞察、研判主持和报告生成。 - 产出 HTML、Markdown 和 PDF 报告。 - 内置已脱敏的明星/公众人物与企业公关样例报告。 ## 适用场景 / 适用场景 Argus 专为具体的公共事件设计，而非宽泛的品牌监测。优质的输入通常包含受影响的主体、特定的议题或争议，以及一个时间窗口。 Argus 面向具体公共事件分析，而不是泛泛的品牌监控。较好的输入通常包含：受影响主体、具体议题或争议、时间窗口。 示例： - 艺人/公众人物在病毒式传播的争议后的声誉审查。 - 企业在产品、服务、安全或传播事件后的公关审查。 - 为分析师审查起草有据可查的中文报告。 示例： - 明星或公众人物争议后的声誉复盘。 - 企业在产品、服务、安全或沟通事件后的公关研判。 - 为分析师生成带证据边界的中文报告初稿。 ## 仓库结构 / 仓库结构 - `apps/argus-saas/`：Next.js / Vercel AI SDK 聊天前端。 - `app.py`：Flask 后端 API 和工作流入口。 - `downstream/weibo_data/` 和 `utils/weibo_data_prep.py`：微博数据准备路径。 - `QueryEngine/`、`MediaEngine/`、`InsightEngine/`、`ForumEngine/`、`ReportEngine/`：分析和报告链路。 - `sample_reports/`：已脱敏的 HTML、Markdown 和 PDF 示例。 - `.env.example`：本地配置模板。 ## 快速开始 / 快速开始 后端： ``` python3.11 -m venv .venv .venv/bin/python -m pip install -U pip .venv/bin/python -m pip install -r requirements.txt ``` 前端： ``` cd apps/argus-saas pnpm install ``` 配置环境变量： ``` cp .env.example .env ``` 添加你自己的 OpenAI 兼容模型服务商密钥、搜索服务商密钥、数据库 URL，如果需要实时的微博数据准备，请添加 TikHub 密钥。切勿提交 `.env`。 配置环境变量： ``` cp .env.example .env ``` 按需填入你自己的 OpenAI-compatible 模型服务、搜索服务、数据库和 TikHub 配置。不要提交 `.env`。 运行本地检查： ``` PYTHONPATH="$(pwd)/ReportEngine/utils:${PYTHONPATH:-}" TMPDIR=/tmp TMP=/tmp TEMP=/tmp .venv/bin/python -m pytest -q ``` ``` cd apps/argus-saas TMPDIR=/tmp TMP=/tmp TEMP=/tmp pnpm exec tsc --noEmit ``` ## 配置说明 / 配置说明 Argus 保留了一些旧的环境变量名，包括 `BETTAFISH_BACKEND_URL`，因为经过改造的前端和 demo 脚本的部分内容出于兼容性原因仍在使用这些名称。在本仓库中，请将它们视为 Argus 后端设置。 Argus 保留了少量历史环境变量名，例如 `BETTAFISH_BACKEND_URL`。这是为了兼容改造后的前端和本地 demo 脚本；在本仓库中可以把它们理解为 Argus backend 配置。 本仓库不包含服务商密钥、原始抓取数据、运行时数据库、日志或本地报告输出目录。 本仓库不包含 provider key、原始爬取数据、运行时数据库、日志或本地报告输出目录。 ## 样例报告 / 样例报告 请在 `sample_reports/` 中查看已脱敏的输出示例： - `wang-hedi-artist-profile/` - `xiaomi-su7-enterprise-pr/` 每个样例都包含 HTML、Markdown 和 PDF 输出。它们展示了报告结构和产品行为，不代表完整的舆情覆盖范围。 `sample_reports/` 中包含已脱敏的样例输出： - `wang-hedi-artist-profile/` - `xiaomi-su7-enterprise-pr/` 每个样例包含 HTML、Markdown 和 PDF。它们用于展示报告结构和产品行为，不代表完整舆情覆盖。 ## 项目来源 / 项目来源 Argus 衍生自上游 BettaFish 项目，并保留了其 GPLv2 许可证基础。多引擎舆情分析架构的主要部分改编自 BettaFish。有关归属和第三方说明，请参阅 `NOTICE.md`。 Argus 派生自上游 BettaFish 项目，并保留 GPLv2 许可证基础。多引擎舆情分析架构的重要部分来自 BettaFish 的改造。归属和第三方说明见 `NOTICE.md`。 ## 安全 / 安全 请勿提交 API 密钥、`.env` 文件、服务商原始响应、抓取输出、运行时数据库、日志、缓存或本地私有路径。请参阅 `SECURITY.md`。 不要提交 API key、`.env`、原始 provider 响应、爬取结果、运行时数据库、日志、缓存或本地私有路径。详见 `SECURITY.md`。 ## 许可证 / 许可证 本项目基于 GPLv2 发布。上游 BettaFish 的归属说明保留在 `NOTICE.md` 中。 本项目以 GPLv2 发布，并在 `NOTICE.md` 中保留 BettaFish 上游归属说明。

标签：声誉管理, 安全规则引擎, 数据情报, 社交媒体分析, 自动化报告, 舆情分析, 逆向工具