华鑫证券ETF联接基金查询器

概述

示例引导与欢迎词

• 用户成功配置 token 后，立即输出：token已配置成功，现在可以问我：{random_question}。将 {random_question} 随机替换为 _skillhub_meta.json 的 examples_zh 列表中的任意一个问题。
• 用户询问本技能用途、功能，或表示不知道该问什么时，不调用服务，随机选择一个 examples_zh 问题回复，引导用户直接提问。
• 在技能说明中展示以下示例问题，并将其作为可直接复制使用的提问入口：

1. 查询中证500指数对应的ETF及其联接基金。
2. 查询沪深300指数对应的ETF联接基金，并展示份额类别和费率详情。
3. 查询指定指数的ETF联接基金，直接比较基金规模、申购费、赎回费和管理费。

v2.0.2 更新说明

• 新增 token 配置后的随机示例欢迎词与用途引导，并统一升级服务请求与文档版本至 v2.0.2。

ETF联接基金

华鑫证券 · AI ETF联接基金查询工具。根据用户指定的指数，先查询该指数对应的 ETF，再查询这些 ETF 的联接基金，展示份额类别、基金规模、申购费、赎回费、管理费、托管费和销售服务费，并生成结构化 HTML 报告。

当前版本

• Skill 版本：v2.0.2
• 出品方：华鑫证券
• 服务 skill_code：HXSK10008
• 默认网关：https://xaiapigateway.azure-api.cn/hxgw/api/skill/v1/invoke
• 默认请求平台标识：其他让系统自动识别
• 技能目录包含同风格的 10 列联接基金模板、费率详情交互和独立审计脚本。

支持的请求

• 查询某个指数对应的 ETF 及其联接基金。
• 查询指定指数的联接基金，并按份额类别展示费率。
• 比较联接基金规模、管理费、托管费、销售服务费以及申购/赎回费详情。

用户未提供指数时，提示其输入指数名称或代码，例如：

1. 查询中证500指数对应的ETF及其联接基金。
2. 查询沪深300指数对应的ETF联接基金，并展示份额类别和费率详情。
3. 查询科创50指数对应的ETF联接基金，比较不同份额类别的费率。

投资建议合规拦截

本技能只做数据查询和结构化展示，不回答买入、卖出、推荐、目标价、仓位或其他个性化投资建议。若用户的问题包含投资决策意图，停止正常查询流程，按原投资建议默认话术回复，并在后面追加链接：点击进入华鑫Skill平台：感谢您的信任！为保障您的权益，投资建议需由持牌投顾依据您的风险承受能力提供。此处不便直接答复，建议您添加我的企业名片，由专业投顾一对一为您服务，将为您提供合规、个性化的资产配置建议。

统一服务提示规则

• 服务返回“技能版本过低”“版本过低”或英文等价提示时，停止报告解析，并引导用户前往华鑫技能广场更新技能；保留服务原始提示。
• 发送给服务的 skill_content.content 必须是用户原始完整问题，不得改写、摘要、翻译、补充或拼接。
• 投资建议和用量超限场景保留原默认文字，仅追加华鑫Skill平台链接；不渲染内嵌名片。

Token 与服务请求

• scripts/.env 保存华鑫专属 token，token 不写入报告、记忆或最终回复。
• token 为空时，引导用户访问 skills.cfsc.com.cn 注册并获取专属 token；未获取 token 前不得请求服务。
• 请求必须由 scripts/relay_request.py 发起，固定字段为：

{
  "skill_code": "HXSK10008",
  "skill_content": {"content": "完整查询请求"},
  "skill_version": "v2.0.2",
  "request_id": "workbuddy",
  "skill_token": "专属 token"
}

• 服务请求可能需要较长时间。调用前告知用户预计需要等待完整报告生成。
• 接口超时、失败、无法解析时，原样返回：ETF联接基金服务接口故障，请稍后尝试。
• 若返回用量超限、额度耗尽、次数达到上限或 rate limit，立即回复原用量默认话术：如果您需要继续使用华鑫skill，请点击按钮联系工作人员开通相关权限。，并在后面追加链接：点击进入华鑫Skill平台。不重试、不生成报告、不渲染内嵌名片。

强制数据边界

1. 报告内容只能来自 ETF 联接基金服务响应；不得通过搜索、行情网页、其他技能或常识补齐数据。
2. 缺失单值字段填「—」，缺失数组使用空数组。
3. 不查询实时行情，不判断交易时段，不给买卖建议。
4. 原始服务响应必须先完整保存到本地文件，再交给 scripts/render_report.py 解析；不要依赖聊天窗口中的截断内容。
5. 若历史 TXT 导出中费率 HTML 属性引号未转义，渲染脚本会兼容修复；修复只用于解析，不改变报告数据语义。
6. 服务返回字符串费率但未单独返回 subscription_fee_detail / redemption_fee_detail 时，渲染脚本必须用对应费率原文作为展开内容，禁止因详情字段缺失而显示「—」。
7. 服务可能返回结构化的 subscription_fee 对象：{"normal":"...", "huaxin":"..."}，且同时把 subscription_fee_is_string 标为 false。此时必须以 JSON 值类型为准，不得按标志位直接输出对象字符串；申购费单元格显示「查看详情+」，详情框内分两行展示「正常申购费」和「折后申购费（华鑫）」，后者使用 fee-discount-text。
8. 服务返回的份额说明字段为 class + title + content：class 提供类别标签，title 渲染为加粗标题，content 渲染为普通说明文本。渲染脚本必须转换成模板示例的 <p><span class="tag ...">类别</span><strong>标题</strong>：说明</p>，模板仅渲染白名单字段 content_html；同时兼容旧版 title + content 及完整 HTML 数据。

工作流

1. 识别用户的指数名称或代码，确认用户要求的是数据查询而非投资建议。
2. 读取 assets/etf_linked_fund_report_template.html 和 references/template-guide.md。
3. 读取 scripts/.env，确认 token 存在；调用 scripts/relay_request.py，将完整原始响应写入 JSON 文件。
4. 使用唯一渲染入口 scripts/render_report.py：

python3 scripts/relay_request.py --content-file request.txt --output relay.json
python3 scripts/render_report.py --template assets/etf_linked_fund_report_template.html --data relay.json --output report.html
python3 scripts/audit_report.py --report report.html

• relay_request.py 的 --output 必须是当前工作目录内的相对路径；脚本只允许写入当前工作目录，拒绝写入目录之外的路径，也不会把响应写到系统目录或其他任意位置。

1. 渲染脚本生成本地 generated_at，服务时间写入 data_updated_at，展开联接基金和份额说明循环，并阻止模板占位符残留。
2. 用 scripts/audit_report.py 独立审核 10 列表头、每行单元格数量、费率交互、份额说明段落和免责声明。
3. 输出 <YYYYMMDD>_ETF联接基金查询报告.html，说明数据来自 ETF 联接基金服务，不输出凭据。

报告结构

1. 页眉：标题、报告生成时间、数据更新时间。
2. 目标指数卡片：目标指数名称/代码、跟踪 ETF 数量、联接基金数、份额类别摘要；保留原目标卡片悬停效果。
3. 联接明细：固定 10 列：
   • 代码（服务返回字段 code）
   • ETF联接基金名称
   • ETF名称
   • 份额类别
   • 基金规模(亿)
   • 申购费%
   • 赎回费%
   • 管理费%
   • 托管费%
   • 销售服务费%
4. 份额类别说明：保留类似关键发现的段落卡片。
5. 免责声明：与基准技能模板保持一致。

费率展示规则

• 如果申购费或赎回费是独立数值，直接显示数值，例如 0.00% 或 1.50%。
• 如果对应字段是字符串明细，单元格显示 查看详情+，点击后展开当前完整详情框；若服务未提供对应 *_detail 字段，必须回退显示费率字段原文，不得显示「—」。
• 正常费率和华鑫折后费率共用一个详情框，通过 fee-detail-line 分行。
• 折扣明细标签固定为 折后申购费（华鑫） 或 折后赎回费（华鑫）；其后费率文本使用 fee-discount-text，显示为红色加粗。
• 详情框背景、边框、字体、字号和行距沿用既定模板，不随数据改变。

版本检查

服务成功返回后，若响应中存在可解析的 skill_version，与当前 v2.0.2 比较；服务版本过低时，引导用户前往华鑫技能广场更新技能；服务版本高于当前版本时，在交付报告前明确提示用户需要升级。服务未返回版本时不猜测、不提示。若服务明确返回技能版本过低或版本过低提示，必须引导用户前往华鑫技能广场更新技能。

合规输出显示契约

• 合规分支必须把完整默认话术和完整 Markdown 权限链接写入 reply；不得只输出链接、摘要、占位符或被截断的片段。
• final_reply 与 reply 必须完全一致；宿主必须逐字显示 reply 或 final_reply 的完整内容，不得二次改写、截断或只展示 trigger。
• 权限链接中的 skill_token 必须使用本次实际 token，并进行 URL 参数编码；不得输出字面量 {token}、空 token 或示例 token。