AdvancingTitans/hotspot-research-suite
GitHub: AdvancingTitans/hotspot-research-suite
一款基于 AI 的研究选题发现工具,帮助研究者和写作者从公开信息中快速识别有时效性且竞争较小的写作方向并生成结构化中文简报。
Stars: 1 | Forks: 0
# Hotspot Research Suite
**用于趋势发现、公开来源分析以及适配 Lark 的中文简报的 AI 研究智能体。**
Hotspot Research Suite 旨在帮助研究人员和深度写作者,在所有人撰写相同题材之前,及时发现有时效性、有证据支撑且竞争相对较小的选题。
```
pip install --upgrade hotspot-research-cli
hotspot-research setup
hotspot-research brief "中文大模型安全评测的新兴低竞争切口" --field "中文大模型安全"
```
当你需要获取选题情报、必读资料列表、趋势指标,以及一份能够发送至 Feishu/Lark 的结构化 Markdown 简报时,就可以使用它。
## 相关仓库
- [`hotspot-research-skill`](https://github.com/AdvancingTitans/hotspot-research-skill):用于长篇研究报告的独立可安装 skill。
- [`pain-miner`](https://github.com/AdvancingTitans/pain-miner):用于微型产品创意的社区痛点挖掘工具。
- [`awesome-ai-agent-research-tools`](https://github.com/AdvancingTitans/awesome-ai-agent-research-tools):所有相关工具的精选入口。
当前的默认产品是 `hotspot-research-cli`:一款专为研究人员和深度写作者设计的交互式选题情报助手。它能帮助用户发现具有时效性、有证据支撑且竞争相对较小的写作与研究选题,随后会将结构化的中文《选题情报简报》保存为 Markdown 文件。
## 组件
- `skills/last30days-safe`:源自 Hermes Agent skill 库的安全公开来源收集 skill。
- `packages/hotspot-cli`:PyPI 包 `hotspot-research-cli`。
## 安装说明
```
pip install --upgrade hotspot-research-cli
```
启动选题助手:
```
hotspot-research setup
hotspot-research run --output-dir ./briefs
```
验证已有想法:
```
hotspot-research brief "中文大模型安全评测的新兴低竞争切口" --field "中文大模型安全"
```
配置结构化 LLM 分析:
```
hotspot-research config model list
hotspot-research config model setup --provider deepseek --model deepseek/deepseek-chat
hotspot-research config lark auth --init --recommend --chat-id oc_xxxxxxxxx
```
## CLI 产出内容
默认的 `run` 流程会要求提供一个领域,接着通过 `last30days-safe` 收集近期的公开信号,提出 5-8 个具体的涌现方向,支持数字选择或自然语言追问,最后生成一份 Markdown 简报,其中包含:
- 时效性与数据信号
- 当前的研究覆盖情况
- 高潜力的研究空白
- 具体的写作/研究问题
- 标题建议
- 近期必读材料
- 风险提示
- 7 天、30 天及 30-60 天对比时间窗口的趋势指标
有关完整的 CLI 用法、架构、Pydantic 模型、缓存行为、LLM 配置以及扩展指南,请参阅 [packages/hotspot-cli/README.md](packages/hotspot-cli/README.md)。
## 来源声明
有关来源声明和参考链接,请参阅 [NOTICE.md](NOTICE.md)。
- `last30days-safe` 复制自 Hermes Agent skill 库,并保留了上游的 MIT 元数据。
- `hotspot-cli` 是为该套件在本地创建的。
## 开发
```
cd packages/hotspot-cli
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e .
PYTHONPATH=src python -m unittest discover -s tests -v
```
## 发布
本仓库包含 `scripts/push-github.zsh`,它会从以下位置读取 GitHub token:
```
~/.config/hotspot-research-suite/github_token
```
该 token 文件仅在本地保留,绝不能提交。
PyPI 发布使用 `.github/workflows/publish.yml` 中的 GitHub Actions Trusted Publishing。推送一个指定路径范围的 tag 即可进行发布:
```
git tag hotspot-research-cli/v0.2.0
scripts/push-github.zsh origin hotspot-research-cli/v0.2.0
```
标签:AI智能体, Python, 内容生成, 无后门, 自动化研究, 逆向工具