招股书（小律同学AI）
0. 技能定位与合规边界
本技能是官方公开披露法律文档的检索、下载与阅读辅助工具。招股书（ Prospectus ）与上市申请文件（含港交所聆讯后资料集 PHIP ）是监管机构公开披露的正式文件；本技能只帮助用户找到、下载和阅读这些文件本身。
- 数据来源全部为证监会、上交所、深交所、北交所、港交所披露易等官方公开披露渠道；本技能不自产任何数据。
- 本技能不提供证券行情、股价信息、审核进展播报、行业投资筛选、投资咨询或任何金融信息服务；输出不构成投资建议，也不构成正式法律意见。
- 回答只围绕"文件"展开：找到什么文件、哪个版本、何时披露、官方链接在哪里、正文说了什么。
1. Agent 默认如何检索招股书
用户只需自然语言提出问题。日常任务只使用稳定入口 scripts/prospectus_cli.py query，按公司名称或股份代号检索官方披露文件；不要要求用户设置缓存目录或阅读数据文件；也不要直接运行 legacy 脚本 fetch_ipo.py / fetch_hk_ipo.py（仅为内部库）。
脚本定位：以技能目录为工作目录，使用相对路径 scripts/prospectus_cli.py；环境变量 XIAOLV_SKILLS_DIR 指向技能安装根目录时，路径为 $XIAOLV_SKILLS_DIR/xiaolv-ipo-prospectus/scripts/prospectus_cli.py（Windows PowerShell 用 Join-Path 拼接）。
# 检索某家公司的官方招股书 / 上市申请文件
python scripts/prospectus_cli.py query --market a --name "公司全称"
# 港股优先使用股份代号
python scripts/prospectus_cli.py query --market hk --code 9988
用户要求下载、正文摘要或关键信息抽取时，才加 --download --extract。港股只有名称时须使用港交所名称、繁体名称或简称；名称或简称命中多个发行人时，不得自动选择第一个。
company 为兼容命令（与 query --name / --code 等价），日常任务优先使用 query。
2. 检索某家公司的招股书
- A 股：使用公司全称；简称可能不唯一时先消歧。
- 港股：优先使用股份代号；只有名称时须使用港交所名称、繁体名称或简称，并在多候选时等待用户选择。
needs_disambiguation：展示候选公司、代码/板块和日期，等待用户确认。manual_action_required：说明可能仅有 AP/PHIP 等资料，需人工确认，不能虚构正式招股书。
下载后只引用返回的官方文件 URL、文件路径和 SHA-256。扫描版需要 OCR 时才加 --ocr；正文摘要不能仅依据封面。
3. 如何根据 CLI 结果回答用户
先读取 status、warnings 和 errors，再组织回答。回答围绕披露文件组织，至少说明：发行人法定名称、市场/板块、文件类型（招股说明书 / 上市申请文件 / PHIP 等）、文件版本与披露日期、数据截止日期、官方链接，以及下载文件的大小和 SHA-256。official_project_url 可引用；official_url_kind=project 是项目页，document 是官方文件，source_endpoint 只是官方来源端点，不能称为该公司的独立项目页。
不要主动播报或跟踪发行人的审核进展、不要对发行人的投资价值作任何评价或排序；用户追问审核或投资问题时，说明本技能仅提供公开披露文件的检索与阅读辅助，引导其查阅官方披露渠道。完整字段契约见 references/output-schema.md。
4. 检索失败时怎么办
not_found：说明检索范围和可能原因，不编造文件。partial：逐条呈现 warnings/errors，说明缺口；普通 warning 本身不表示查询失败。error：报告结构化错误码和可执行重试建议；网络错误仅有限重试，不绕过官方域名限制。
4.1 命令怎么写
先判断宿主 Shell 再按其语法书写，不要混用：
- Windows（PowerShell 5.1+）：不使用 Bash 风格的
&&/||；独立命令用换行或;；有前后依赖时检查$LASTEXITCODE。 - macOS / Linux（bash / zsh）：可用
&&/||；有前后依赖时检查$?。
脚本一律使用相对路径 scripts/prospectus_cli.py（技能目录为工作目录），或按上述 XIAOLV_SKILLS_DIR 规则拼接绝对路径。完整示例见 references/cli.md。
4.2 无法提取 AES 加密招股书时怎么办
若错误包含 cryptography>=3.1 is required for AES、AES 或 pypdf 无法解密，说明"PDF 已下载，文本提取失败"，不要说文件不存在。使用执行 CLI 的同一 Python 解释器检查 cryptography；缺失或版本不兼容属于应用依赖缺陷，不得在用户环境自行安装。保留文件路径和原始错误，不形成基于 PDF 正文的结论。
5. 部署或排障时如何检查 Skill
仅在部署、维护或排障时运行：
python scripts/prospectus_cli.py health
python scripts/prospectus_cli.py validate-data
需要验证实时端点时再运行 health --online。CLI 参数、发布维护和环境变量见 references/cli.md。
6. 数据保存在哪里
下载文件和运行结果保存在当前用户缓存目录：Windows 为 %LOCALAPPDATA%/xiaolv-ipo-prospectus，macOS 为 ~/Library/Caches/xiaolv-ipo-prospectus，Linux 为 ~/.cache/xiaolv-ipo-prospectus。默认目录不可写时会回退到系统临时目录；FETCH_PROSPECTUS_CACHE_DIR 可覆盖位置（该变量名为历史沿用，与技能标识前缀不同，保留以保证兼容）。Skill 目录不写入日常运行数据；静态规则在 references/，随包 fallback 在 data/。
版权与免责声明
本技能由小律同学AI 提供，版权归广东小律同学人工智能科技有限公司所有。输出为公开披露资料的检索结果与机器辅助摘要，仅供参考，不构成正式法律意见，也不构成任何投资建议；涉及重大权益处置时，请结合案情咨询执业律师。招股书等文件的著作权归披露主体及相关权利人所有，本技能仅提供官方公开渠道的检索与下载辅助，请用户遵循官方渠道的使用条款。
