Gangtise 文件列表

在 Gangtise 文件中心按不同文档类型（报告、公告、纪要等）检索，返回文件 ID 以及关键元数据/摘要，并提供按类型与 ID 下载完整文件的辅助。当你需要在“找哪些文件（先定位）”的阶段进行定位/筛选，并可能进一步下载核验时，务必使用本技能。检索结果基于系统匹配与字段归纳，强调专业性、准确性与覆盖全面；如需深入阅读与引用具体论点/段落内容，再优先选择 `gangtise-kb`。

搜索

概览

该技能会查询 Gangtise 文件中心，检索多种文档类型，例如研究报告、公司公告、会议纪要、首席观点与投研日程（路演、调研、线下策略会、论坛）等。它会返回文件 ID，并附带关键元数据与简短摘要；这些命中结果基于检索匹配与字段归纳，强调专业性、准确性与覆盖全面，同时提供按“类型 + ID”下载完整文件的方法。注意：由于 API 限制，大多数结果最多限制为 100 条；多数情况下建议将结果数量限制在 10 条以内。

使用场景：

• 你需要按类型、日期、证券或其他元数据来定位、筛选或整理文档。
• 你想先构建一个候选文档列表（例如某只股票的近期报告、某段时间内的全部公告）。
• 你计划下载完整文件并在本技能之外处理（例如后续解析或单独阅读）。

与其他技能的区别：

• 当你主要关心的是文本内容本身（用于总结、问答、抽取论点等），并且不需要浏览长文件列表时，优先使用 gangtise-kb。

（中文说明：gangtise-file 更像"文件目录/索引"，解决"有哪些文件、ID 是什么、按条件筛一批出来"的问题；真正看内容、抽段落建议用 gangtise-kb。）

各文档类型的主脚本用于执行检索并返回文件列表；部分参数提供枚举值脚本（如行业、机构等），调用前可先执行对应脚本获取可选值。无枚举值接口的参数（如关键词、证券、日期等）会由后端智能匹配，直接传入用户意图相关文本即可。证券代码需传入标准格式（如 000001.SZ）。

所有脚本都具有 -d / --download 布尔型参数，用于判断在检索后自动下载对应文件至本地。一般来说用户不需要这个参数，除非用户明确要求下载文件。

所有脚本都具有-sd和-ed参数，使用时注意今天的年份和日期！

调用对应脚本前，请先查看对应脚本的调用指导文档，了解更多参数的含义和使用方法。

1. 从研究报告检索

按关键词、证券、日期、券商、行业、研报类别、语义标签、评级/评级变动、页数范围、来源类型等条件检索研究报告。

重要说明：试用账号只能查询一个月内的研报（以接口权限校验为准）。

示例（关键词"比亚迪"，限定时间范围与数量）：

python3 scripts/report.py -k 比亚迪 -sd 2026-01-01 -ed 2026-12-31 -l 20

行业、机构枚举值可通过 scripts/get_industries.py、scripts/get_institutions.py 获取。详见 研究报告调用指导。

2. 外资研报检索

按关键词、证券、日期、券商、行业、区域、研报类别、语义标签、评级/评级变动、页数范围等条件检索外资研报列表。境外证券代码格式如 UBER.N。重要说明：试用账号只能查询一个月内的外资研报（以接口权限校验为准）。

示例（关键词 + 时间范围）：

python3 scripts/foreign_report.py -k 自动驾驶 -sd 2026-02-01 -ed 2026-03-30 -l 20

行业、券商、区域枚举值可通过 scripts/get_industries.py、scripts/get_institutions.py、scripts/get_regions.py 获取。详见 外资研报调用指导。

3. 从公司公告检索

按证券、关键词、日期等条件检索公司公告。

示例（证券 + 关键词 + 时间）：

python3 scripts/announcement.py --securities 000858.SZ -k 业绩 -sd 2026-01-01 -ed 2026-12-31

详见 公司公告调用指导。

4. 从会议纪要检索

按关键词、证券、机构、行业、来源类型、会议类别/市场/参会人角色等条件检索会议纪要。

示例（关键词 + 会议类别）：

python3 scripts/summary.py -k 锂电 --category_list earningsCall -l 20

行业、机构枚举值可通过 scripts/get_industries.py、scripts/get_institutions.py 获取。详见 会议纪要调用指导。

5. 首席观点列表检索

按关键词、证券、券商、研究方向、首席分析师、概念、投研标签、来源类型等条件检索首席观点列表。

示例（关键词 + 标签 + 来源）：

python3 scripts/opinion.py -k 半导体 --llm_tags strongRcmd --source_types realTime -l 20

券商枚举值可通过 scripts/get_institutions.py 获取。研究方向名称（宏观、策略、固收、金工、海外等）见 scripts/utils.py 中 RESEARCH_AREA_MAP。详见 首席观点调用指导。

6. 投研日程（路演 / 调研 / 线下策略会 / 论坛）

示例（路演 + 关键词 + 时间）：

python3 scripts/investment_calendar.py -t roadshow -k 策略会 -sd 2026-02-01 -ed 2026-03-30 -l 20

机构枚举见 scripts/get_institutions.py；研究方向中文名见 scripts/utils.py 中 RESEARCH_AREA_MAP。详见 投研日程调用指导。

7. 获取枚举值

获取行业、机构的枚举值列表，用于为上述检索脚本提供参数可选值。

python3 scripts/get_industries.py
python3 scripts/get_institutions.py
python3 scripts/get_regions.py

8. 下载文件

根据文件 ID 与文件类型下载完整文件至本地。

示例（下载文件）：

python3 scripts/get_file.py --file-id 1234567890 --file-type "研究报告"