上市公司公告速读
公告的价值在于要素是否齐全、数字是否可回溯，不在于谁读得快。这个技能先把要素抠出来，再告诉你缺了什么。
何时使用
| 用户说法 | 是否触发 |
|---|---|
| 这份公告讲了什么 / 帮我速读一下这个公告 | 是 |
| 公告里的金额是多少 / 占营收多少 | 是 |
| 公告编号和日期在哪 | 是 |
| 这份公告缺了什么关键信息 | 是 |
| 重大合同公告一般要看什么 | 是 |
| 公告类型有哪些 | 是 |
| 这个公告利好还是利空 / 股价会怎么走 | 否（不判断行情与投资价值） |
覆盖的公告类型（十五类）
业绩预告、重大合同、对外投资、股东减持、股东增持、股权激励、关联交易、对外担保、募集资金、诉讼仲裁、停牌复牌、回购、定期报告、人事变动、风险警示。
每类都带识别关键词与必读要点，例如：重大合同看交易对手、合同金额、占营收比例、生效条件、履行期限；关联交易看关联方身份、交易金额、定价依据、审议与回避表决情况。
工作流程
- 拿正文：把公告全文存成纯文本（
.txt），保留原有分段与标点；表格类公告建议把关键表格转成文字行，避免数字被截断。 - 抽要素：
scan子命令，输出标题、公告编号、日期、公司主体、公告类型、金额（含折合元）、比例、风险提示关键词、决策程序关键词。 - 查完整性：
check子命令，逐项给出「齐备／缺失」与缺失原因，并给出缺项清单。通用必读项为人项：标题、公告编号、日期、公司主体、事项类型、风险提示；金额或数量与决策程序为条件必读项，按公告类型触发。 - 查类型要点：
types子命令，按关键词检索公告类型，拿到该类公告的必读要点清单，作为人工复核的检查表。 - 交付话术：报出抽到的关键数字（金额、比例、日期）时必须附「请回原文核对」；对缺失项只陈述事实，不做「这家公司披露不规范」之类的评价。
工具调用
python3 scripts/filing_quick_reader.py scan --input notice.txt
python3 scripts/filing_quick_reader.py check --input notice.txt --json
python3 scripts/filing_quick_reader.py types --query 减持
退出码：0 要素齐备 / 1 有缺项或未识别出公告类型 / 2 用法或读取错误。
输出规范
scan：八段式要素清单（标题、编号、日期、主体、类型、金额类信息、风险提示、决策程序）。check：必读要素表（要素、是否齐备、说明）+ 缺项清单 + 结论。types：类型名 + 识别关键词 + 必读要点。
注意事项与边界
- 只做要素抽取与完整性核对；不判断公告的利好或利空、不预测股价、不做投资评级、不给买卖建议。
- 抽取基于文本规则（正则与关键词表），识别结果需人工复核；表格型、图片型、扫描版公告可能抽不全。
- 金额统一折合为元便于比较，但公告中的币种与含税口径以原文为准，不做汇率换算。
- 公告类型可能同时命中多类，输出会全部列出，不做取舍。
- 「风险提示」缺失只说明正文未出现相关表述，不推断发行方是否存在风险。
- 不联网抓取公告；文本与准确性由用户负责。
- 公告正文含个人信息（如自然人姓名、身份证号）时，使用前请自行脱敏。
