华鑫证券选股宝

概述

Token 设置（必须先执行）

• scripts/.env 保存华鑫专属 token，默认值为空：TOKEN=。
• 首次使用或 token 为空时，必须引导用户访问 skills.cfsc.com.cn 注册并获取专属 token；未获取 token 前不得调用服务。
• 用户提供 token 后，先写入 scripts/.env，再调用服务。token 仅用于服务请求，不写入报告、记忆或最终回复。

示例引导与欢迎词

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

1. 帮我筛选PE<30，ROE>15%的科技成长股
2. 请筛选近期开启上涨趋势且成交活跃的股票

v2.0.2 更新说明

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

选股宝

华鑫证券 · AI 选股工具。支持热点选股、资讯选股、条件选股等各类方式，用户提供选股条件后调用选股服务，并按选股模板生成可下载的 HTML 选股报告。

当前版本

• Skill 版本：v2.0.2
• 出品方：华鑫证券
• 选股服务默认 hxtp：xuanguskill
• WorkBuddy 默认提示词：帮我筛选PE<30，ROE>15%的科技成长股

收到空输入时，使用上述默认提示词执行。

合规输出显示契约

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

长响应处理

选股服务原始响应必须先完整写入本地 JSON 文件，再从文件解析；不得依赖聊天窗口或工具预览中的截断文本。只有完整 JSON 解析成功后才允许渲染报告。

强制数据边界

1. 报告所有内容必须直接来自选股服务接口响应，包括筛选条件摘要、统计卡片、股票行和关键发现。不得使用搜索引擎、新闻网页或其他外部内容补充、改写或推断。
2. 本 Skill 不查询、不使用实时行情数据：不得打开行情网页、搜索实时价格/涨跌幅，也不得进行交易时段判断；报告仅使用选股服务响应。
3. 选股服务请求最长等待 20 分钟。若接口超时、失败、无法解析或 20 分钟内未生成，停止流程并原样返回：选股服务接口故障，请稍后尝试。 不得用外部资料替代服务结果。
4. 缺失的服务字段使用 —，不得编造；列表字段缺失时使用空数组，确保模板可渲染。

合规提示与服务版本

• 服务返回“技能版本过低”“版本过低”或英文等价提示时，停止报告解析，并引导用户前往华鑫技能广场更新技能；保留服务原始提示，不用其他内容替代。
• 用户询问投资建议或服务用量超限时，默认话术保持不变，并在话术后追加完整 Markdown 权限链接 [点击进入华鑫证券官网开通权限](https://skills.cfsc.com.cn/#/authority?skill_token={token})；不渲染内嵌名片。
• 服务未返回 JSON 时，停止后续报告解析与渲染，按照服务返回的原文直接向用户反馈；不得包装、改写或用其他内容替代（版本过低提示除外，仅追加技能广场更新引导）。

服务版本检查（必须执行）

每次成功调用后读取响应顶层或响应内容中可解析出的 skill_version，与当前 v2.0.2 按语义版本比较（忽略开头的 v）。若服务版本高于当前版本，在交付报告前明确提示用户 Skill 需要升级；仍可在数据完整且安全时生成本次报告。服务未返回版本时不猜测、不提示。若服务明确返回技能版本过低或版本过低提示，必须引导用户前往华鑫技能广场更新技能。

工作流

1. 解析用户的选股条件；收到空输入时使用默认提示词。发送给服务的 skill_content.content 必须是用户原始完整问题，除空输入按技能默认提示词执行外，不得改写、摘要、翻译、补充或拼接任何内容。
2. 读取 assets/stock_screening_report_template.html 和 references/template-guide.md，严格按说明填充模板字段；股票表格为 11 列，使用行业 PE 分位、近 3 个月涨幅和最多 3 个核心概念标签，不再包含机构评级、数据来源表格与页脚脚注。
3. 调用 scripts/relay_request.py。POST JSON 必须严格为 {"skill_code":"HXSK10003","skill_content":{"content":<完整请求内容>},"skill_version":"v2.0.2","request_id":""或当前平台名称,"skill_token":<专属token>}。request_id 可以为空；安装或运行平台提供 PLATFORM_NAME 时自动使用该值，OpenClaw 运行环境自动使用 openclaw，也可通过 --request-id 或 REQUEST_ID 设置为其他平台名称；默认 URL 为 https://xaiapigateway.azure-api.cn/hxgw/api/skill/v1/invoke；
4. 不执行任何实时行情查询、网页搜索或交易时段判断。
5. 仅用服务响应填充模板变量；HTML 变量按模板说明处理，缺失值填 —。
6. 使用 scripts/render_report.py 渲染，展开 stock_rows、findings 循环并阻止模板残留；脚本同时负责兼容旧字段输入、把核心概念转换为纯标签卡片（最多 3 个）、拦截已废弃的数据来源表与页脚脚注结构，并校验页眉字标为内联 data URI。
7. 输出 <YYYYMMDD>_选股报告.html 并交付，说明数据来自选股服务；不输出服务凭据。
8. 若服务版本过低，最终回复先引导用户前往华鑫技能广场更新技能；若服务版本高于当前版本，最终回复先明确提示升级，再交付报告。

质量要求

• 报告必须包含筛选逻辑（卡片外部下方附提示小字）、统计概览、股票表格、关键发现和免责申明；不包含数据来源表格，也不包含页脚脚注（服务不会返回数据来源或脚注信息，不得自行补充）。
• 股票表格固定 11 列；字段不完整时使用 —，不得错位；列顺序固定为：股票名称、代码、行业、PE、行业 PE 分位、PB、股息率、ROE、市值(亿)、近3个月涨幅、核心概念。
• stock_rows、findings 必须是数组，没有数据时使用空数组。
• 「核心概念」为纯标签卡片：只显示概念名称，不带描述文字，最多 3 个。
• 页眉品牌 logo 固定使用横版字标，已作为 base64 data URI 直接内联在 assets/stock_screening_report_template.html 里，与其余华鑫技能模板使用同一份字标（55,855 字节 PNG），渲染脚本不再读取 assets/*.png；报告因此不依赖技能目录内的图片文件（技能包上传时图片会被删除）。assets/logo.png（方形）仅用于技能卡片 iconSource，不得用于报告页眉。
• 不可替用户下单或承诺收益；报告保留模板中的免责申明。

脚本用法

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

Windows（WorkBuddy 桌面端）注意（2026-09-23 实测）：

• 用受管 Python 绝对路径执行，如

C:/Users/abc/.workbuddy/binaries/python/versions/<版本>/python.exe；Git Bash 里没有 python3。

• --content-file 等路径必须用工作区绝对路径（C:/Users/abc/WorkBuddy/<会话>/req.txt）；

Git Bash 的 /tmp 会被 Python 解析成不存在的 tmp...，直接 FileNotFoundError。

• 服务响应通常 2–5 分钟；网关约 300 秒硬上限（超时返回网关 500），超时后重试是唯一有效手段，

脚本 --timeout 建议设 320 秒以便快速失败进入重试，而不是白等 1200 秒。

• 一次成功即收工：响应 code=B0002 且 data.content 为字符串化 JSON（尾部可能附服务告警文本），

直接交给 render_report.py，无需二次请求。

请求结构

调用 scripts/relay_request.py 前必须完成 token 设置。发送的 JSON 为：

{
  "skill_code": "HXSK10003",
  "skill_content": {
    "content": "完整请求内容"
  },
  "skill_version": "v2.0.2",
  "request_id": "",
  "skill_token": "专属 token"
}