华鑫证券指数估值分析

概述

示例引导与欢迎词

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

1. 查询沪深300指数近3年的估值分析。
2. 分析中证500指数的PE、PB、股息率和ERP。
3. 查看指定指数当前估值及与其他指数的横向比较。

v2.0.2 更新说明

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

指数估值分析

华鑫证券 · AI 指数估值分析工具。根据用户指定的指数名称或代码，调用指数估值服务，展示当前估值、历史分位、历史趋势、指数点位和横向估值对比，并生成结构化 HTML 报告。

当前版本

• Skill 版本：v2.0.2
• 出品方：华鑫证券
• 服务 skill_code：HXSK10007
• 默认网关：https://xaiapigateway.azure-api.cn/hxgw/api/skill/v1/invoke
• 默认请求平台标识：其他让系统自动识别
• 报告模板：assets/index_valuation_report_template.html
• 填写说明：references/template-guide.md

支持的请求

• 查询指定指数近若干年的 PE、PB、PCF、PSR、股息率和 ERP。
• 查看当前值、当前历史分位、90/70/30/10 分位点、中位数和日度趋势。
• 对比目标指数与其他指数的 PE、PE 分位、PB、PB 分位和股息率。

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

1. 查询沪深300指数近3年的估值分析。
2. 分析中证500（000905.SH）近5年的 PE、PB 和 ERP。
3. 查看指定指数当前估值及其与其他指数的横向比较。

投资建议合规拦截

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

统一服务提示规则

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

Token 与服务请求

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

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

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

强制数据边界

1. 报告内容只能来自指数估值服务响应；不得使用搜索、行情网页、其他技能或常识补齐、改写或推断数据。
2. 不查询实时行情，不判断交易时段，不给买卖建议。
3. 原始服务响应必须先完整保存到本地 JSON 文件，再交给 scripts/render_report.py 解析；不要依赖聊天窗口中的截断内容。
4. 服务字段缺失时使用「—」；历史数组缺失时使用空数组。不能用外部数据补齐日期、指标或指数点位。
5. ERP 的 chart_price_json 按模板规则为空；PE、PB、PCF、PSR 和股息率的指数点位序列只能使用服务返回的对应数组或服务明确提供的共享指数点位序列。
6. comparison_rows 是服务返回的已渲染 HTML 行字符串，只允许作为表格行注入；不得从外部资料添加指数或指标。

工作流

1. 识别用户的指数名称/代码、回溯年限和是否需要横向比较；若没有指数，先请用户提供。
2. 先检查是否属于投资建议问题或用户主动表示额度不足；命中时走合规/用量快速路径，不调用服务。
3. 读取 scripts/.env 确认 token 存在；调用 scripts/relay_request.py，将完整原始响应写入 JSON 文件。
4. 成功响应后从原始文件检查可解析的 skill_version；若高于当前 v2.0.2，交付前明确提示需要升级。
5. 将原始 relay JSON 直接交给唯一渲染入口 scripts/render_report.py，不要另写一次性转换脚本。
6. 使用 scripts/audit_report.py 独立审核模板变量、6 个指标面板、图表数据属性、对比表列数和关键交互。
7. 输出 <YYYYMMDD>_<指数名称>指数估值分析报告.html 并交付，说明数据来自指数估值分析服务；不输出凭据。

报告结构

1. 页眉：标题、报告生成时间、数据更新时间。
2. 估值内容卡片：目标指数名称、代码和回溯年限。
3. 当前估值：PE、PB、PCF、PSR、股息率五个指标页签，每项包括当前值、当前分位、分位点卡片、色卡和趋势图。
4. ERP 风险溢价：当前值、分位点、分位区间和 ERP 趋势图。
5. 指数估值对比：指数、PE、PE分位%、PB、PB分位、股息率。
6. 模板内置免责声明和页脚。

交互与视觉规则

• 色卡整体相对上方指标卡片下移 33px（通过 .percentile-wrap 的上边距实现），避免“当前位置”标签与上方卡片重叠；“历史 / 最低”和“历史 / 最高”仍固定在色卡正左、正右外侧，垂直居中，紧凑两行显示，不占用色卡下方整行。
• 趋势图显示普通指标折线；PE、PB、PCF、PSR、股息率另显示指数点位折线，右侧轴和图例统一使用“指数点位”，ERP 不显示指数点位。
• “最高”“最低”“最新”标签使用点位错开的白底小标签，靠近数据点但不遮挡点；根据边缘位置向图内避让，并使用 confine 防止溢出画布。三类标签文字和点统一使用紫色，尤其“最新”必须为紫色。
• 色卡“当前位置”显示当前值及对应单位；估值和 ERP 的当前值、90 分位点、10 分位点、中位数卡片显示对应单位（倍或 %），当前分位点显示 %。
• 指标折线及其 markPoint 显式绑定左侧指标轴 yAxisIndex: 0，指数点位折线绑定右侧轴 yAxisIndex: 1，避免 PE 等标注落到指数点位轴。
• 对比表自动识别目标指数并使用参考报告配色的固定整行高亮：背景 #FFF3D6，悬停背景 #FFE7B0，左侧棕色强调线 #854F0B，上下边框 #D4A24C；目标识别同时支持目标名称、名称带代码、目标代码、行级 data-selected="true" / data-code / data-index-code，不要求服务返回特定 CSS class；目标指数的极高/极低数值使用参考报告中的圆角矩形徽标，悬停仅在此基础上增强，不替代目标行高亮。
• 只有目标指数与至少一个其他指数同时存在时，才判断 PE、PE 分位、PB、PB 分位是否高于所有其他指数或低于所有其他指数；其他指数不标记。
• 请求时应显式使用 --request-id workbuddy，避免服务按默认平台路由返回摘要或 No response from OpenClaw.；若首次响应只含摘要，必须在原始响应文件基础上重新请求完整可渲染 JSON，不得据摘要自行补齐数据。
• 极高/极低直接包裹数字：极高使用主题深色小圆角矩形和深主题色字体，极低使用主题浅色小圆角矩形和浅主题色字体。服务若明确判断，可在目标行单元格使用 data-abnormal="high" 或 data-abnormal="low"。

时间字段

• generated_at / report_generated_at 由渲染脚本在本地写出 HTML 前生成，表示实际生成时间。
• report_date 从本地生成时间截取日期。
• data_updated_at 使用服务返回的数据更新时间；服务的 report_date 或请求时间不能冒充报告生成时间。

脚本用法

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

版本检查

服务成功返回后，若响应顶层或 data.content 中存在可解析的 skill_version，与当前 v2.0.2 做语义版本比较（忽略开头的 v）。服务未返回版本时不猜测、不提示。若服务明确返回技能版本过低或版本过低提示，必须引导用户前往华鑫技能广场更新技能。

合规输出显示契约

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